@manta-eu/horns/studio

name

Name

raw

unknown

Returns

BoundCall | undefined

boundedKnowledge()

boundedKnowledge(text): string

Parameters

text

string

Returns

string

briefById()

briefById(id): { audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; } | undefined

Parameters

id

string

Returns

{ audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; } | undefined

briefMessage()

briefMessage(brief): string

Parameters

brief

audience

string

checks

string[]

id

string

question

string

shapes

string[]

title

string

views

object[]

Returns

string

bucketOf()

bucketOf(key): number

Parameters

key

string

Returns

number

buildUsefulContext()

buildUsefulContext(input): UsefulContext

Parameters

input

UsefulContextInput

Returns

UsefulContext

capSummary()

capSummary(text, max?): string

Parameters

text

string

max?

number

Returns

string

cardRendering()

cardRendering(args): string

What the cards say, as the reader will get them. Values are quoted so the model judges the text itself rather than a paraphrase of it, and nothing here varies between two runs over the same data.

Parameters

args

cards

readonly RecordCard[]

maxCards?

number

variants?

readonly ZooVariant[]

Returns

string

cardsOfZoo()

cardsOfZoo(zoo): RecordCard[]

The cards a zoo will draw, or none when the view does not draw record cards.

Parameters

zoo

ShapeZoo

Returns

RecordCard[]

checkBriefViews()

checkBriefViews(args): Promise<BriefFinding[]>

Parameters

args

brief

{ audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; }

brief.audience

string

brief.checks

string[]

brief.id

string

brief.question

string

brief.shapes

string[]

brief.title

string

brief.views

object[]

horn

{ about?: string[]; actions: ({ id: string; ref: { hash: string; item: string; revision: string; }; } | { allowedClasses: string[]; allowedPredicates: string[]; confirm: true; criteria?: { ask: string; }; delete?: string; id: string; insert: string; kind: "kg-update"; label: string; params: object[]; where?: string; } | { actionShapeIri: string; confirm: true; criteria?: { ask: string; }; id: string; kind: "action-shape"; label: string; mapping: z.ZodRecord<z.ZodString, z.ZodString>; operation: "addition" | "update"; params: object[]; })[]; audience?: string; baseRevision?: number; datastoreId: string; dependencies: object[]; derivations: ({ id: string; ref: { hash: string; item: string; revision: string; }; } | { appliesTo: string; datatype: string; id: string; pattern: string; predicateIri: string; promotedRuleIri?: string; status: "query" | "staged" | "materialized"; })[]; iri: string; layout: { columns: 12; items: object[]; kind: "grid"; }; lock: { entries: object[]; lockVersion: 1; }; realm: "hiremanta-com" | "journey-travel"; revision: number; runtime: { kit: string; }; schemaVersion: 1; slug: string; style?: { accent?: "blue" | "orange" | "green" | "amber" | "pink" | "forest" | "indigo" | "red"; density?: "compact" | "comfortable"; radius?: "sharp" | "soft" | "round"; theme?: "light" | "dark"; }; summary?: string; title: string; variables: object[]; views: ({ id: string; ref: { hash: string; item: string; revision: string; }; } | { binding: { columns: object[]; derivations: string[]; kind: "select"; limit: number; params: string[]; sparql: string; } | { classIri: string; derivations: string[]; fields: object[]; kind: "lens"; limit: number; rows?: "entity" | "value"; } | { kind: "query"; limit: number; params: string[]; query: { hash: string; item: string; revision: string; }; }; emits?: object[]; id: string; render: { component: { hash: string; item: string; revision: string; }; kind: "component"; props: JSONType; } | { kind: "tsx"; reviewed?: { at: string; hash: string; }; source: string; }; title: string; })[]; }

horn.about?

string[]

horn.actions

horn.audience?

string

horn.baseRevision?

number

horn.datastoreId

string

horn.dependencies

object[]

horn.derivations

horn.iri

string

horn.layout

{ columns: 12; items: object[]; kind: "grid"; }

horn.layout.columns

12

horn.layout.items

object[]

horn.layout.kind

"grid"

horn.lock

{ entries: object[]; lockVersion: 1; }

horn.lock.entries

object[]

horn.lock.lockVersion

1

horn.realm

"hiremanta-com" | "journey-travel"

horn.revision

number

horn.runtime

{ kit: string; }

horn.runtime.kit

string

horn.schemaVersion

1

horn.slug

string

horn.style?

horn.style.accent?

horn.style.density?

"compact" | "comfortable"

horn.style.radius?

"sharp" | "soft" | "round"

horn.style.theme?

"light" | "dark"

horn.summary?

string

horn.title

string

horn.variables

object[]

horn.views

realm

"hiremanta-com" | "journey-travel"

rows?

number

select

shapes

readonly object[]

Returns

Promise<BriefFinding[]>

classesFor()

classesFor(select, shapes): Promise<ClassSummary[]>

Parameters

select

shapes

readonly object[]

Returns

Promise<ClassSummary[]>

completeWith()

completeWith(model, request, maxTokens, signal?): Promise<StudioModelResponse>

One round against the model. The loop decides what to do with the tool calls it comes back with.

Parameters

model

LanguageModel

request

StudioModelRequest

maxTokens

number

signal?

AbortSignal

Returns

Promise<StudioModelResponse>

componentApiAnswer()

componentApiAnswer(name, lookup): string

The answer to “how do I call this”: the surface’s own summary, then what the SDK declares.

The summary comes first because an emitted type can be a zod tree — accurate and slow to read — while the calling form above it is the shape to copy.

Parameters

name

string

lookup

ComponentApiLookup

Returns

string

createDryRun()

createDryRun(options): (horn, viewIds) => Promise<DryRunResult[]>

Parameters

options

DryRunOptions

Returns

(horn, viewIds) => Promise<DryRunResult[]>

createVertexAccessTokens()

createVertexAccessTokens(options): VertexAccessTokens

A cached access token, refreshed before it expires. One exchange in flight at a time.

Parameters

options

VertexAuthOptions

Returns

VertexAccessTokens

datastoreFacts()

datastoreFacts(args): Promise<{ classes: ClassSummary[]; computed: DerivedTerm[]; }>

What a turn is told about the datastore before it asks anything: the classes it holds, and what the rules work out about the ones the question is nearest to — which no shape lists, so nothing else would surface it.

Parameters

args

prompt

string

realm

"hiremanta-com" | "journey-travel"

select

shapes

readonly object[]

signal?

AbortSignal

Returns

Promise<{ classes: ClassSummary[]; computed: DerivedTerm[]; }>

describeDraftedChanges()

describeDraftedChanges(changes, where): string

The body of the pull request: what to look at, and what to do about it. A reviewer opens each zoo and decides; nothing here is a verdict, because the gate a run passes is not the judgement curated stands for.

Parameters

changes

DraftedChanges

where

datastoreId

string

realm

string

Returns

string

describeHorn()

describeHorn(realm, horn): string

Parameters

realm

"hiremanta-com" | "journey-travel"

horn

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

Returns

string

describeHornChange()

describeHornChange(before, after): HornChange

Parameters

before

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

after

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

Returns

HornChange

describeLibraryOffer()

describeLibraryOffer(offer): string

Parameters

offer

LibraryItemOffer

Returns

string

describeLockProblem()

describeLockProblem(problem): string

Parameters

problem

LockProblem

Returns

string

draftedChanges()

draftedChanges(before, after): DraftedChanges

Parameters

before

readonly object[]

after

readonly object[]

Returns

DraftedChanges

elementFingerprints()

elementFingerprints(horn): object

Parameters

horn

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

Returns

object

actions

actions: Record<string, string>

derivations

derivations: Record<string, string>

layout

layout: object

Index Signature

[k: string]: string

style

style: string

title

title: string

variables

variables: Record<string, string>

views

views: Record<string, string>

evaluateProposal()

evaluateProposal(draft, ops, deps): Promise<ProposalResult>

Parameters

draft

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

ops

deps

ProposalDeps

Returns

Promise<ProposalResult>

evaluateShapeViewOnZoo()

evaluateShapeViewOnZoo(args): (spec) => Promise<string[]>

Parameters

args

datastoreId

string

realm

"hiremanta-com" | "journey-travel"

sample?

number

select

Returns

(spec) => Promise<string[]>

fingerprint()

fingerprint(value): string

Parameters

value

unknown

Returns

string

formatFailures()

formatFailures(failures, max?): string

Parameters

failures

readonly ProposalFailure[]

max?

number

Returns

string

hasDraftedChanges()

hasDraftedChanges(changes): boolean

Parameters

changes

DraftedChanges

Returns

boolean

hintsToPrune()

hintsToPrune(stats, options?): string[]

Parameters

stats

readonly HintStats[]

options?

minLift?

number

minSessions?

number

Returns

string[]

integrationBriefById()

integrationBriefById(id): { audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; } | undefined

Parameters

id

string

Returns

{ audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; } | undefined

investigateData()

investigateData(options): Promise<string>

Parameters

options

classes?

readonly string[]

draft

draft.about?

string[]

draft.actions

draft.audience?

string

draft.baseRevision?

number

draft.datastoreId

string

draft.dependencies

object[]

draft.derivations

draft.iri

string

draft.layout

{ columns: 12; items: object[]; kind: "grid"; }

draft.layout.columns

12

draft.layout.items

object[]

draft.layout.kind

"grid"

draft.lock

{ entries: object[]; lockVersion: 1; }

draft.lock.entries

object[]

draft.lock.lockVersion

1

draft.realm

"hiremanta-com" | "journey-travel"

draft.revision

number

draft.runtime

{ kit: string; }

draft.runtime.kit

string

draft.schemaVersion

1

draft.slug

string

draft.style?

draft.style.accent?

draft.style.density?

"compact" | "comfortable"

draft.style.radius?

"sharp" | "soft" | "round"

draft.style.theme?

"light" | "dark"

draft.summary?

string

draft.title

string

draft.variables

object[]

draft.views

handlers

model

LanguageModel

onEvent?

(event) => void

Forwarded so the investigation’s own steps show up beside the turn’s, rather than as one long pause.

question

string

realm

"hiremanta-com" | "journey-travel"

signal?

AbortSignal

Returns

Promise<string>

isStudioToolName()

isStudioToolName(name): name is “list_classes” | “describe_class” | “list_computed” | “components_for_class” | “read_component_api” | “look_at_it” | “find_components” | “list_rules” | “run_sparql” | “ask_manta_for_rule” | “investigate_data” | “propose_plan” | “propose_horn_patch” | “propose_library_item” | “report_harness_issue”

Parameters

name

string

Returns

libraryOfferProblem()

libraryOfferProblem(offer, horn): ProposalFailure | undefined

Parameters

offer

LibraryItemOffer

horn

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

Returns

ProposalFailure | undefined

mergeGeneratedViews()

mergeGeneratedViews(args): object[]

Parameters

args

accepted

readonly object[]

generated

readonly object[]

installed

readonly object[]

Returns

object[]

nextRepairAction()

nextRepairAction(failedRounds, failures): RepairAction

Parameters

failedRounds

number

failures

readonly ProposalFailure[]

Returns

RepairAction

normalizePrivateKey()

normalizePrivateKey(privateKey): string

A PEM stored on one line, which importKey rejects.

Parameters

privateKey

string

Returns

string

parseImports()

parseImports(source): ParsedImport[]

Parameters

source

string

Returns

ParsedImport[]

parseToolArguments()

parseToolArguments(raw): ParsedArguments

Parameters

raw

string

Returns

ParsedArguments

parseVertexServiceAccount()

parseVertexServiceAccount(raw): VertexServiceAccount

Parameters

raw

string

Returns

VertexServiceAccount

planConformance()

planConformance(plan, horn, componentExportOf): PlanDeviation[]

Parameters

plan

actions

object[]

derivations

object[]

goal

string

openQuestions

string[]

views

object[]

horn

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

componentExportOf

(ref) => string | undefined

Returns

PlanDeviation[]

planProblems()

planProblems(plan, horn): ProposalFailure[]

Parameters

plan

actions

object[]

derivations

object[]

goal

string

openQuestions

string[]

views

object[]

horn

about?

string[]

actions

audience?

string

baseRevision?

number

datastoreId

string

dependencies

object[]

derivations

iri

string

layout

{ columns: 12; items: object[]; kind: "grid"; }

layout.columns

12

layout.items

object[]

layout.kind

"grid"

lock

{ entries: object[]; lockVersion: 1; }

lock.entries

object[]

lock.lockVersion

1

realm

"hiremanta-com" | "journey-travel"

revision

number

runtime

{ kit: string; }

runtime.kit

string

schemaVersion

1

slug

string

style?

style.accent?

style.density?

"compact" | "comfortable"

style.radius?

"sharp" | "soft" | "round"

style.theme?

"light" | "dark"

summary?

string

title

string

variables

object[]

views

Returns

rankClasses()

rankClasses(prompt, classes, realm): ClassSummary[]

Parameters

prompt

string

classes

readonly ClassSummary[]

realm

"hiremanta-com" | "journey-travel"

Returns

ClassSummary[]

readFailure()

readFailure(caught): FailureReading

Parameters

caught

unknown

Returns

FailureReading

readOnlySelect()

readOnlySelect(query, limit, realm?): string

Parameters

query

string

limit

number

realm?

"hiremanta-com" | "journey-travel"

Returns

string

renderLogFailures()

renderLogFailures(entries): ProposalFailure[]

Parameters

entries

readonly RenderLogEntry[]

Returns

reuseViolations()

reuseViolations(input): ProposalFailure[]

Parameters

input

ReuseInput

Returns

rowsAsText()

rowsAsText(results, maxRows?): string

Parameters

results

SparqlResults

maxRows?

number

Returns

string

runBrief()

runBrief(options): Promise<BriefResult>

Parameters

options

brief

{ audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; }

brief.audience

string

brief.checks

string[]

brief.id

string

brief.question

string

brief.shapes

string[]

brief.title

string

brief.views

object[]

catalog

{ catalogVersion: 1; components: object[]; source: { commit: string; package: string; repository: string; }; }

catalog.catalogVersion

1

catalog.components

object[]

catalog.source

{ commit: string; package: string; repository: string; }

catalog.source.commit

string

catalog.source.package

string

catalog.source.repository

string

componentRefs?

Readonly<Record<string, { hash: string; item: string; revision: string; }>>

datastoreId

string

library?

readonly LibraryHit[]

lookup

RevisionLookup

maxSteps?

number

model

LanguageModel

realm

"hiremanta-com" | "journey-travel"

select

shapes

readonly object[]

signal?

AbortSignal

views

readonly object[]

Returns

Promise<BriefResult>

runBriefSuite()

runBriefSuite(options): Promise<{ briefs: z.ZodRecord<z.ZodString, z.ZodObject<{ findings: z.ZodArray<z.ZodString>; finishedAt: z.ZodString; horn: z.ZodObject<{ about: z.ZodOptional<z.ZodArray<z.ZodURL>>; actions: z.ZodArray<z.ZodUnion<readonly […, …]>>; audience: z.ZodOptional<z.ZodString>; baseRevision: z.ZodOptional<z.ZodNumber>; datastoreId: z.ZodString; dependencies: z.ZodArray<z.ZodObject<{ kind: z.ZodEnum<…>; ref: z.ZodObject<…, …>; }, z.core.$strict>>; derivations: z.ZodArray<z.ZodUnion<readonly […, …]>>; iri: z.ZodURL; layout: z.ZodObject<{ columns: z.ZodLiteral<12>; items: z.ZodArray<z.ZodObject<…, …>>; kind: z.ZodLiteral<"grid">; }, z.core.$strip>; lock: z.ZodObject<{ entries: z.ZodArray<z.ZodObject<…, …>>; lockVersion: z.ZodLiteral<1>; }, z.core.$strict>; realm: z.ZodEnum<{ hiremanta-com: "hiremanta-com"; journey-travel: "journey-travel"; }>; revision: z.ZodNumber; runtime: z.ZodObject<{ kit: z.ZodString; }, z.core.$strip>; schemaVersion: z.ZodLiteral<1>; slug: z.ZodString; style: z.ZodOptional<z.ZodObject<{ accent: z.ZodOptional<…>; density: z.ZodOptional<…>; radius: z.ZodOptional<…>; theme: z.ZodOptional<…>; }, z.core.$strict>>; summary: z.ZodOptional<z.ZodString>; title: z.ZodString; variables: z.ZodArray<z.ZodObject<{ default: z.ZodOptional<…>; id: z.ZodString; label: z.ZodString; options: z.ZodOptional<…>; type: z.ZodEnum<…>; urlParam: z.ZodOptional<…>; }, z.core.$strip>>; views: z.ZodArray<z.ZodUnion<readonly […, …]>>; }, z.core.$strip>; reply: z.ZodString; status: z.ZodEnum<{ built: "built"; empty: "empty"; step-limit: "step-limit"; }>; steps: z.ZodNumber; usage: z.ZodObject<{ cachedPromptTokens: z.ZodNumber; completionTokens: z.ZodNumber; promptTokens: z.ZodNumber; }, z.core.$strip>; viewIds: z.ZodArray<z.ZodString>; }, z.core.$strip>>; datastoreId: string; realm: string; runVersion: 1; updatedAt: string; }>

Parameters

options

briefs

readonly object[]

check

(brief, horn) => Promise<string[]>

datastoreId

string

now?

() => Date

onProgress?

(progress) => void

realm

"hiremanta-com" | "journey-travel"

run

(brief) => Promise<BriefResult>

store

BriefRunStore

Returns

Promise<{ briefs: z.ZodRecord<z.ZodString, z.ZodObject<{ findings: z.ZodArray<z.ZodString>; finishedAt: z.ZodString; horn: z.ZodObject<{ about: z.ZodOptional<z.ZodArray<z.ZodURL>>; actions: z.ZodArray<z.ZodUnion<readonly […, …]>>; audience: z.ZodOptional<z.ZodString>; baseRevision: z.ZodOptional<z.ZodNumber>; datastoreId: z.ZodString; dependencies: z.ZodArray<z.ZodObject<{ kind: z.ZodEnum<…>; ref: z.ZodObject<…, …>; }, z.core.$strict>>; derivations: z.ZodArray<z.ZodUnion<readonly […, …]>>; iri: z.ZodURL; layout: z.ZodObject<{ columns: z.ZodLiteral<12>; items: z.ZodArray<z.ZodObject<…, …>>; kind: z.ZodLiteral<"grid">; }, z.core.$strip>; lock: z.ZodObject<{ entries: z.ZodArray<z.ZodObject<…, …>>; lockVersion: z.ZodLiteral<1>; }, z.core.$strict>; realm: z.ZodEnum<{ hiremanta-com: "hiremanta-com"; journey-travel: "journey-travel"; }>; revision: z.ZodNumber; runtime: z.ZodObject<{ kit: z.ZodString; }, z.core.$strip>; schemaVersion: z.ZodLiteral<1>; slug: z.ZodString; style: z.ZodOptional<z.ZodObject<{ accent: z.ZodOptional<…>; density: z.ZodOptional<…>; radius: z.ZodOptional<…>; theme: z.ZodOptional<…>; }, z.core.$strict>>; summary: z.ZodOptional<z.ZodString>; title: z.ZodString; variables: z.ZodArray<z.ZodObject<{ default: z.ZodOptional<…>; id: z.ZodString; label: z.ZodString; options: z.ZodOptional<…>; type: z.ZodEnum<…>; urlParam: z.ZodOptional<…>; }, z.core.$strip>>; views: z.ZodArray<z.ZodUnion<readonly […, …]>>; }, z.core.$strip>; reply: z.ZodString; status: z.ZodEnum<{ built: "built"; empty: "empty"; step-limit: "step-limit"; }>; steps: z.ZodNumber; usage: z.ZodObject<{ cachedPromptTokens: z.ZodNumber; completionTokens: z.ZodNumber; promptTokens: z.ZodNumber; }, z.core.$strip>; viewIds: z.ZodArray<z.ZodString>; }, z.core.$strip>>; datastoreId: string; realm: string; runVersion: 1; updatedAt: string; }>

runShapeCoverage()

runShapeCoverage(options): Promise<{ datastoreId: string; realm: "hiremanta-com" | "journey-travel"; runVersion: 1; shapes: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{ startedAt: z.ZodISODateTime; status: z.ZodLiteral<"running">; }, z.core.$strip>, z.ZodObject<{ advice: z.ZodOptional<z.ZodArray<z.ZodString>>; finishedAt: z.ZodISODateTime; rounds: z.ZodNumber; sampled: z.ZodNumber; spec: z.ZodObject<{ classCurie: z.ZodString; fields: z.ZodArray<z.ZodObject<…, …>>; record: z.ZodObject<{ badges: …; currency: …; fields: …; format: …; link: …; subtitle: …; title: …; type: …; }, z.core.$strict>; schema: z.ZodString; status: z.ZodEnum<{ curated: …; drafted: …; }>; }, z.core.$strict>; status: z.ZodLiteral<"accepted">; usage: z.ZodObject<{ cachedPromptTokens: z.ZodNumber; completionTokens: z.ZodNumber; promptTokens: z.ZodNumber; }, z.core.$strip>; }, z.core.$strip>, z.ZodObject<{ finishedAt: z.ZodISODateTime; problems: z.ZodArray<z.ZodString>; rounds: z.ZodNumber; sampled: z.ZodNumber; status: z.ZodLiteral<"gave-up">; usage: z.ZodObject<{ cachedPromptTokens: z.ZodNumber; completionTokens: z.ZodNumber; promptTokens: z.ZodNumber; }, z.core.$strip>; }, z.core.$strip>, z.ZodObject<{ finishedAt: z.ZodISODateTime; status: z.ZodLiteral<"no-data">; }, z.core.$strip>, z.ZodObject<{ error: z.ZodString; finishedAt: z.ZodISODateTime; status: z.ZodLiteral<"failed">; }, z.core.$strip>], "status">>; startedAt: string; updatedAt: string; }>

Parameters

options

advise?

boolean

Have the critic read each accepted card and say what a stranger would not understand. It costs one model call and one sampling query per accepted shape, and what it says is advice: it never changes the verdict.

capture?

(snapshot) => Promise<string | undefined>

Draws the accepted card and hands back a data URL. Absent, the critic reads the card as text instead.

criticModel?

any

The critic’s own model, when the host has one that can look at a picture. Absent uses the Studio’s.

datastoreId

string

limit?

number

maxRounds?

number

model

LanguageModel

now?

() => Date

onProgress?

(progress) => void

onTurnProgress?

(progress) => void

Each step within a shape as it happens; the script prints finished shapes and passes none.

realm

"hiremanta-com" | "journey-travel"

redo?

boolean

retryFailed?

boolean

sample?

number

select

shapes

readonly object[]

signal?

AbortSignal

store

CoverageRunStore

views

readonly object[]

wait?

(ms, signal?) => Promise<void>

Returns

Promise<{ datastoreId: string; realm: "hiremanta-com" | "journey-travel"; runVersion: 1; shapes: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{ startedAt: z.ZodISODateTime; status: z.ZodLiteral<"running">; }, z.core.$strip>, z.ZodObject<{ advice: z.ZodOptional<z.ZodArray<z.ZodString>>; finishedAt: z.ZodISODateTime; rounds: z.ZodNumber; sampled: z.ZodNumber; spec: z.ZodObject<{ classCurie: z.ZodString; fields: z.ZodArray<z.ZodObject<…, …>>; record: z.ZodObject<{ badges: …; currency: …; fields: …; format: …; link: …; subtitle: …; title: …; type: …; }, z.core.$strict>; schema: z.ZodString; status: z.ZodEnum<{ curated: …; drafted: …; }>; }, z.core.$strict>; status: z.ZodLiteral<"accepted">; usage: z.ZodObject<{ cachedPromptTokens: z.ZodNumber; completionTokens: z.ZodNumber; promptTokens: z.ZodNumber; }, z.core.$strip>; }, z.core.$strip>, z.ZodObject<{ finishedAt: z.ZodISODateTime; problems: z.ZodArray<z.ZodString>; rounds: z.ZodNumber; sampled: z.ZodNumber; status: z.ZodLiteral<"gave-up">; usage: z.ZodObject<{ cachedPromptTokens: z.ZodNumber; completionTokens: z.ZodNumber; promptTokens: z.ZodNumber; }, z.core.$strip>; }, z.core.$strip>, z.ZodObject<{ finishedAt: z.ZodISODateTime; status: z.ZodLiteral<"no-data">; }, z.core.$strip>, z.ZodObject<{ error: z.ZodString; finishedAt: z.ZodISODateTime; status: z.ZodLiteral<"failed">; }, z.core.$strip>], "status">>; startedAt: string; updatedAt: string; }>

runShapeViewTurn()

runShapeViewTurn(options): Promise<ShapeViewTurnResult>

Parameters

options

draft?

{ classCurie: string; fields: object[]; record: { badges?: string[]; currency?: string; fields: string[]; format?: "number" | "percent" | "integer" | "compact"; link?: string; subtitle?: string; title: string; type: "record"; }; schema: string; status: "drafted" | "curated"; }

The view as it stands, when someone is changing one rather than designing the first.

draft.classCurie

string

draft.fields

object[]

draft.record

{ badges?: string[]; currency?: string; fields: string[]; format?: "number" | "percent" | "integer" | "compact"; link?: string; subtitle?: string; title: string; type: "record"; }

draft.record.badges?

string[]

draft.record.currency?

string

draft.record.fields

string[]

draft.record.format?

"number" | "percent" | "integer" | "compact"

draft.record.link?

string

draft.record.subtitle?

string

draft.record.title

string

draft.record.type

"record"

draft.schema

string

draft.status

"drafted" | "curated"

evaluate?

(spec) => Promise<string[]>

fillRates?

Readonly<Record<string, number>>

history?

readonly StudioMessage[]

links?

readonly ShapeLink[]

maxRounds?

number

model

LanguageModel

notes?

ReadonlyMap<string, TermNotes>

onProgress?

(progress) => void

realm

"hiremanta-com" | "journey-travel"

request?

string

What they asked for, in their own words. Absent when the turn is the coverage runner’s.

sampled?

number

shape

{ classIri: string; namespace: string; properties: object[]; schema: string; }

shape.classIri

string

shape.namespace

string

shape.properties

object[]

shape.schema

string

signal?

AbortSignal

Returns

Promise<ShapeViewTurnResult>

runStudioTurn()

runStudioTurn(options): Promise<StudioTurnResult>

Parameters

options

StudioTurnOptions

Returns

Promise<StudioTurnResult>

sampleShapeFillRates()

sampleShapeFillRates(shape, select, sample?, signal?): Promise<{ fillRates: Record<string, number>; sampled: number; }>

Parameters

shape

classIri

string

namespace

string

properties

object[]

schema

string

select

sample?

number

signal?

AbortSignal

Returns

Promise<{ fillRates: Record<string, number>; sampled: number; }>

scoreBrief()

scoreBrief(args): BriefFinding[]

Parameters

args

brief

{ audience: string; checks: string[]; id: string; question: string; shapes: string[]; title: string; views: object[]; }

brief.audience

string

brief.checks

string[]

brief.id

string

brief.question

string

brief.shapes

string[]

brief.title

string

brief.views

object[]

horn

horn.about?

string[]

horn.actions

horn.audience?

string

horn.baseRevision?

number

horn.datastoreId

string

horn.dependencies

object[]

horn.derivations

horn.iri

string

horn.layout

{ columns: 12; items: object[]; kind: "grid"; }

horn.layout.columns

12

horn.layout.items

object[]

horn.layout.kind

"grid"

horn.lock

{ entries: object[]; lockVersion: 1; }

horn.lock.entries

object[]

horn.lock.lockVersion

1

horn.realm

"hiremanta-com" | "journey-travel"

horn.revision

number

horn.runtime

{ kit: string; }

horn.runtime.kit

string

horn.schemaVersion

1

horn.slug

string

horn.style?

horn.style.accent?

horn.style.density?

"compact" | "comfortable"

horn.style.radius?

"sharp" | "soft" | "round"

horn.style.theme?

"light" | "dark"

horn.summary?

string

horn.title

string

horn.variables

object[]

horn.views

shapes

readonly object[]

Returns

BriefFinding[]

scoreStudioOutcome()

scoreStudioOutcome(testCase, outcome): StudioScore

Parameters

testCase

datastoreId

string

expect

{ classes: string[]; computed?: string[]; minViews: number; reuseComponents: string[]; uses?: string[]; visual?: boolean; }

expect.classes

string[]

expect.computed?

string[]

expect.minViews

number

expect.reuseComponents

string[]

expect.uses?

string[]

expect.visual?

boolean

id

string

prompt

string

realm

"hiremanta-com" | "journey-travel"

outcome

StudioOutcome

Returns

StudioScore

selectHints()

selectHints(query): HintSelection

Parameters

query

HintQuery

Returns

HintSelection

selectSkills()

selectSkills(prompt, skills, max?): object[]

Parameters

prompt

string

skills

readonly object[]

max?

number

Returns

object[]

shapeViewContext()

shapeViewContext(args): string

Parameters

args

draft?

draft.classCurie

string

draft.fields

object[]

draft.record

draft.record.badges?

string[]

draft.record.currency?

string

draft.record.fields

string[]

draft.record.format?

"number" | "percent" | "integer" | "compact"

draft.record.link?

string

draft.record.subtitle?

string

draft.record.title

string

draft.record.type

"record"

draft.schema

string

draft.status

"drafted" | "curated"

fillRates?

Readonly<Record<string, number>>

links?

readonly ShapeLink[]

notes?

ReadonlyMap<string, TermNotes>

realm

"hiremanta-com" | "journey-travel"

sampled?

number

shape

{ classIri: string; namespace: string; properties: object[]; schema: string; }

shape.classIri

string

shape.namespace

string

shape.properties

object[]

shape.schema

string

Returns

string

shouldPlanFirst()

shouldPlanFirst(__namedParameters): boolean

Parameters

__namedParameters

horn

horn.about?

string[]

horn.actions

horn.audience?

string

horn.baseRevision?

number

horn.datastoreId

string

horn.dependencies

object[]

horn.derivations

horn.iri

string

horn.layout

{ columns: 12; items: object[]; kind: "grid"; }

horn.layout.columns

12

horn.layout.items

object[]

horn.layout.kind

"grid"

horn.lock

{ entries: object[]; lockVersion: 1; }

horn.lock.entries

object[]

horn.lock.lockVersion

1

horn.realm

"hiremanta-com" | "journey-travel"

horn.revision

number

horn.runtime

{ kit: string; }

horn.runtime.kit

string

horn.schemaVersion

1

horn.slug

string

horn.style?

horn.style.accent?

horn.style.density?

"compact" | "comfortable"

horn.style.radius?

"sharp" | "soft" | "round"

horn.style.theme?

"light" | "dark"

horn.summary?

string

horn.title

string

horn.variables

object[]

horn.views

prompt

string

Returns

boolean

sleep()

sleep(ms, signal?): Promise<void>

Parameters

ms

number

signal?

AbortSignal

Returns

Promise<void>

stableStringify()

stableStringify(value): string

Parameters

value

unknown

Returns

string

stageGuidance()

stageGuidance(stage): string

The bar is docs/standard.md read down to what a turn can act on. Per stage, not in the prompt.

Parameters

stage

"design" | "hydrate" | "review"

Returns

string

stageOf()

stageOf(state): "design" | "hydrate" | "review"

Parameters

state

bound

boolean

drawn

boolean

Returns

"design" | "hydrate" | "review"

studioReadHandlers()

studioReadHandlers(args): StudioToolHandlers

Parameters

args

componentApi?

ComponentApiLookup

The surfaced components’ declarations, where the build read them. Absent, the tool is not offered.

model

LanguageModel

onEvent?

(event) => void

Passed on to the investigation sub-loop, so its steps show up rather than one long pause.

realm

"hiremanta-com" | "journey-travel"

select

shapes

readonly object[]

views

readonly object[]

Returns

studioSystemPrompt()

studioSystemPrompt(options): string

Parameters

options

knowledge?

string

mode

"plan" | "build" | "investigate"

realm

"hiremanta-com" | "journey-travel"

Returns

string

studioToolDefinitions()

studioToolDefinitions(mode, without?): StudioToolDefinition[]

The tools to offer, byte-stable across turns so the model server can reuse its prompt cache.

without drops the ones this run cannot answer. A tool offered with no handler costs a step and teaches the model to distrust the list — ask_manta_for_rule needs a signed-in person, and a brief or coverage run has none. The cache is keyed on the mode and what was dropped, so each variant stays byte-stable.

Parameters

mode

"plan" | "build" | "investigate"

without?

Returns

StudioToolDefinition[]

studioWriteHandlers()

studioWriteHandlers(args): StudioToolHandlers

Parameters

args

catalog

{ catalogVersion: 1; components: object[]; source: { commit: string; package: string; repository: string; }; }

catalog.catalogVersion

1

catalog.components

object[]

catalog.source

{ commit: string; package: string; repository: string; }

catalog.source.commit

string

catalog.source.package

string

catalog.source.repository

string

componentRefs?

Readonly<Record<string, { hash: string; item: string; revision: string; }>>

The published revision of each catalog component. Absent until the catalog is published, and the reuse rule has nothing to ask for until then.

lookup

RevisionLookup

realm

"hiremanta-com" | "journey-travel"

rows?

number

select

stageRule?

RuleStager

Absent where no viewer is present — a script, a test — and the tool then says so rather than failing.

typecheck?

(source) => readonly TypeProblem[]

A compiler over a written view, where the host brought one.

Returns

summarizeBriefFindings()

summarizeBriefFindings(findings): string[]

Parameters

findings

readonly BriefFinding[]

Returns

string[]

surfaceSearchAnswer()

surfaceSearchAnswer(need, limit?): string

What the surface has for a need, in its own words.

Asked rather than listed: the palette grows with the SDK, and a turn that is told to search finds what was added after its prompt was written.

Parameters

need

string

limit?

number

Returns

string

toModelMessages()

toModelMessages(messages): ModelMessage[]

Parameters

messages

readonly StudioMessage[]

Returns

ModelMessage[]

toolCallDetail()

toolCallDetail(name, input): string | undefined

What a tool call was about, in the call’s own words.

“Querying the datastore” fifteen times says nothing about what is being looked for. This is for the person watching only: it never reaches the model, so it can be as long as a query.

Parameters

name

string

input

unknown

Returns

string | undefined

toolsForStage()

toolsForStage(stage): readonly ("list_classes" | "describe_class" | "list_computed" | "components_for_class" | "read_component_api" | "look_at_it" | "find_components" | "list_rules" | "run_sparql" | "ask_manta_for_rule" | "investigate_data" | "propose_plan" | "propose_horn_patch" | "propose_library_item" | "report_harness_issue")[]

Parameters

stage

"design" | "hydrate" | "review"

Returns

tsxViolations()

tsxViolations(input): ProposalFailure[]

Every reason this source may not be saved, most structural first.

Parameters

input

TsxInput

Returns