@tangle-network/agent-runtime 0.156.0 → 0.158.0

package/dist/substrate-AJoT4HIz.d.ts

@@ -0,0 +1,284 @@
+import { k as Validator, r as Driver, t as AgentRunSpec, w as OutputAdapter } from "./types-DpdfZoQ3.js";
+import { AgentProfile } from "@tangle-network/agent-interface";
+//#region src/profiles/coder.d.ts
+/**
+ *
+ * `CoderTask` + `coderTaskToPrompt` — the per-task DATA + pure formatter for code-modification tasks
+ * (§1.5: the system authors profiles; there is no hardcoded coder profile constant). A domain
+ * customizes the worker by authoring its own `AgentProfile` and handing it to a leaf executor
+ * (`createWorktreeCliExecutor`) or a fanout (`worktreeFanout`); "is it delivered" is a
+ * `DeliverableSpec` (`patchDelivered`), not a bundled validator. This formatter renders a `CoderTask`
+ * into the per-task instruction that profile receives.
+ *
+ * @experimental
+ */
+/** @experimental The per-task inputs `coderTaskToPrompt` renders + the worktree gate enforces. */
+interface CoderTask {
+  /** What the agent must accomplish. Free-form prose. */
+  goal: string;
+  /** Absolute path inside the sandbox where the repo lives. */
+  repoRoot: string;
+  /** Default `main`. The branch the agent diffs against. */
+  baseBranch?: string;
+  /** Default `pnpm test --run`. */
+  testCmd?: string;
+  /** Default `pnpm typecheck`. */
+  typecheckCmd?: string;
+  /** Files the agent may inspect for context. Surfaced verbatim in the prompt. */
+  contextFiles?: string[];
+  /**
+   * Paths the agent must not touch. The mechanical gate hard-fails on any match.
+   * Use glob-free literal path prefixes for unambiguous enforcement.
+   */
+  forbiddenPaths?: string[];
+  /** Default 400. Hard cap; the gate hard-fails when exceeded. */
+  maxDiffLines?: number;
+}
+/** Render a `CoderTask` into the per-task instruction handed to the coder profile. @experimental */
+declare function coderTaskToPrompt(task: CoderTask): string;
+//#endregion
+//#region src/profiles/researcher.d.ts
+/** Source families a researcher profile may prefer for a task. One owner: the delegation
+ *  vocabulary (`DelegateResearchArgs.sources`) re-exports this type rather than restating it.
+ *  @experimental */
+type ResearchSource = 'web' | 'corpus' | 'twitter' | 'github' | 'docs';
+/** Task contract for a source-grounded research agent. @experimental */
+interface ResearchTask {
+  /** The research question to answer. */
+  question: string;
+  /** Bound: e.g. "audience for cpg-founder ICP". */
+  scope?: string;
+  /** Multi-tenant scope (customer-id, workspace-id). Validator enforces. */
+  knowledgeNamespace: string;
+  sources?: ResearchSource[];
+  recencyWindow?: {
+    since?: Date;
+    until?: Date;
+  };
+  maxItems?: number;
+  /** Per-item minimum confidence in [0, 1]. Validator scores recall vs this. */
+  minConfidence?: number;
+}
+/**
+ * Knowledge item emitted by the researcher.
+ *
+ * Profile-local type. When agent-knowledge promotes `KnowledgeClaim` →
+ * top-level `KnowledgeItem` substrate-wide, these fields collapse 1:1.
+ *
+ * @experimental
+ */
+interface KnowledgeItem {
+  id: string;
+  /** Multi-tenant scope. MUST equal `task.knowledgeNamespace`. */
+  namespace: string;
+  /** The factual claim, in the researcher's words. */
+  claim: string;
+  /** Provenance — at least one entry required. */
+  evidence: Array<{
+    source: string;
+    quote?: string;
+    url?: string;
+    capturedAt: number;
+  }>;
+  /** Researcher's self-reported confidence in [0, 1]. */
+  confidence: number;
+  /** Prior item ids this supersedes (chain). */
+  supersedes?: string[];
+  /** Set if the agent is retracting an earlier item. Unix ms. */
+  retractedAt?: number;
+  authoredBy: {
+    kind: 'human' | 'agent';
+    id: string;
+  };
+}
+/**
+ * A proposed write to the knowledge base. The profile does NOT apply
+ * these — the caller decides.
+ *
+ * @experimental
+ */
+type KnowledgeUpdate = {
+  kind: 'insert';
+  namespace: string;
+  item: KnowledgeItem;
+} | {
+  kind: 'supersede';
+  namespace: string;
+  previousId: string;
+  item: KnowledgeItem;
+} | {
+  kind: 'retract';
+  namespace: string;
+  itemId: string;
+  reason: string;
+};
+/**
+ * Researcher output. Required fields are typed; optional fields preserve
+ * the agent's free-form intelligence (`notes`, `raw`). The validator
+ * enforces the typed minimum.
+ *
+ * @experimental
+ */
+interface ResearchOutput {
+  items: KnowledgeItem[];
+  citations: Array<{
+    url: string;
+    quote: string;
+    confidence: number;
+  }>;
+  proposedWrites: KnowledgeUpdate[];
+  gaps?: string[];
+  notes?: string;
+  /** Anything the agent emitted beyond the typed fields. */
+  raw?: unknown;
+}
+/** Options for the source-grounded researcher profile preset. @experimental */
+interface ResearcherProfileOptions {
+  /** Caller-owned exact harness/provider/model identity. */
+  profile: AgentProfile;
+  /** Custom system prompt replacement. Default = built-in researcher preset. */
+  systemPrompt?: string;
+  /** Stable name for `AgentRunSpec.name`. Default = `profile.name`. */
+  name?: string;
+  /**
+   * Default 0.7. Minimum (citations with quote) / items ratio for `valid=true`.
+   * Below this floor, citation_density scores < 1 and the item set is gated.
+   */
+  citationDensityMin?: number;
+}
+/** Build a source-grounded researcher profile with output parsing and validation. @experimental */
+declare function researcherProfile(options: ResearcherProfileOptions & {
+  task?: ResearchTask;
+}): {
+  profile: AgentProfile;
+  taskToPrompt: (task: ResearchTask) => string;
+  output: OutputAdapter<ResearchOutput>;
+  validator: Validator<ResearchOutput>;
+  agentRunSpec: AgentRunSpec<ResearchTask>;
+};
+/** @experimental */
+interface MultiHarnessResearcherFanoutOptions {
+  /** Exact execution profiles, one per parallel researcher. */
+  profiles: ReadonlyArray<AgentProfile>;
+  /** Default citation density floor for the shared validator. */
+  citationDensityMin?: number;
+  /** Optional task — narrows the validator's namespace check. */
+  task?: ResearchTask;
+}
+/**
+ * Build a fanout topology over multiple harnesses. The kernel round-robins
+ * `agentRuns` across the N parallel iterations and the `FanoutVote` driver
+ * picks the highest-scoring valid output.
+ *
+ * @experimental
+ */
+declare function multiHarnessResearcherFanout(options: MultiHarnessResearcherFanoutOptions): {
+  agentRuns: AgentRunSpec<ResearchTask>[];
+  output: OutputAdapter<ResearchOutput>;
+  validator: Validator<ResearchOutput>;
+  driver: Driver<ResearchTask, ResearchOutput, 'done'>;
+};
+/**
+ * Build a validator that closes over a specific `ResearchTask`'s constraints.
+ *
+ * Checks in order:
+ *   1. Items must be non-empty.
+ *   2. Every item carries `evidence.length >= 1`.
+ *   3. Every item + proposedWrite is scoped to `task.knowledgeNamespace`
+ *      (hard-fail on any namespace mismatch — defence in depth for the
+ *      multi-tenant invariant).
+ *   4. Citation density (citations with quote / items) >= floor.
+ *
+ * Aggregate score:
+ *   0.4 · citation_density
+ * + 0.2 · source_diversity (distinct sources / max(items, 1))
+ * + 0.2 · recency_match (mean fraction within `recencyWindow`)
+ * + 0.2 · (1 − gaps/maxGaps), maxGaps = max(items, 1)
+ *
+ * @experimental
+ */
+declare function createResearcherValidator(task: ResearchTask, config?: {
+  citationDensityMin?: number;
+  namespaceCheck?: boolean;
+}): Validator<ResearchOutput>;
+//#endregion
+//#region src/profiles/ui-auditor/substrate.d.ts
+/**
+ *
+ * UI audit finding shapes — the unit of evidence a contributor can act on.
+ *
+ * A finding describes a single, actionable UI problem: lens, severity,
+ * route, observation, impact, suggested fix, and screenshot evidence.
+ * Findings are produced by the auditor profile, persisted by the issue
+ * writer as self-contained GitHub-issue Markdown, and surfaced over MCP.
+ *
+ * The shapes are deliberately constraining — the validator + writer
+ * hard-fail on missing screenshot evidence, missing lens, missing title.
+ *
+ * @experimental
+ */
+/**
+ * Canonical audit lenses. Each lens scopes a finding to a single class of
+ * problem so a single audit pass can iterate them without pile-on findings
+ * under a generic label.
+ */
+type UiLens = 'consistency' | 'hierarchy' | 'layout' | 'ux-flow' | 'duplication' | 'accessibility' | 'responsive' | 'states' | 'content' | 'interaction' | 'performance-perceived' | 'other';
+/** Frozen tuple of lenses for validation + iteration. */
+declare const UI_LENSES: readonly UiLens[];
+/**
+ * Severity scale.
+ *   - `critical` — blocks a core task or is an accessibility blocker.
+ *   - `high`     — confusing, broken-looking, or noticeable friction.
+ *   - `med`      — visible polish issue, would be caught in code review.
+ *   - `low`      — nitpick worth fixing eventually.
+ */
+type UiFindingSeverity = 'low' | 'med' | 'high' | 'critical';
+/** Frozen severity tuple, ordered worst → least bad for sort/report. */
+declare const UI_FINDING_SEVERITIES: readonly UiFindingSeverity[];
+/** Pointer to a screenshot referenced by a finding (workspace-relative path). */
+interface UiFindingScreenshot {
+  path: string;
+  viewport?: string;
+  label?: string;
+}
+/**
+ * A single UI audit finding — the unit of work a contributor can act on.
+ *
+ * Every field except the documented optionals is required. The auditor
+ * validator + writer hard-fail on missing screenshot evidence, missing
+ * lens, missing title, etc.
+ */
+interface UiFinding {
+  /** Monotonic id assigned by the writer when persisting. Optional in-transit. */
+  id?: number;
+  title: string;
+  lens: UiLens;
+  severity: UiFindingSeverity;
+  /** Logical route the finding was observed on (e.g. `home`, `checkout-step-2`). */
+  route: string;
+  /** Fully qualified URL the finding was observed at. */
+  url?: string;
+  /** Viewport string the offending capture was taken at (e.g. `1280x800`). */
+  viewport?: string;
+  /** CSS selector pinning the offending element, when one can be identified. */
+  selector?: string;
+  /** 1–3 sentences describing what the screenshot shows that is wrong. */
+  observation: string;
+  /** Who is affected and how. */
+  impact: string;
+  /** A specific change a contributor could apply without asking back. */
+  suggestedFix: string;
+  /** Optional explicit reproduction steps. Writer synthesizes from route/url/selector when omitted. */
+  reproSteps?: string;
+  /** Free-form tags. */
+  tags?: readonly string[];
+  /** Screenshot references — must be non-empty for actionable findings. */
+  screenshots: readonly UiFindingScreenshot[];
+  /** Cross-references to similar findings already on file, by id. */
+  similarTo?: readonly number[];
+  /** ISO-8601 creation timestamp set by the writer when persisted. */
+  createdAt?: string;
+}
+//#endregion
+export { CoderTask as _, UiFindingSeverity as a, KnowledgeUpdate as c, ResearchSource as d, ResearchTask as f, researcherProfile as g, multiHarnessResearcherFanout as h, UiFindingScreenshot as i, MultiHarnessResearcherFanoutOptions as l, createResearcherValidator as m, UI_LENSES as n, UiLens as o, ResearcherProfileOptions as p, UiFinding as r, KnowledgeItem as s, UI_FINDING_SEVERITIES as t, ResearchOutput as u, coderTaskToPrompt as v };
+//# sourceMappingURL=substrate-AJoT4HIz.d.ts.map

package/dist/{supervise-BVE0XAJa.js → supervise-CqwjiXlX.js}

@@ -1,11 +1,11 @@
 import { C as runtimeOwnedScopeOwnerRuntime, S as runtimeOwnedPendingExecutorMaterialization, b as runtimeOwnedExecutorMaterialization, d as providerAttemptEvidence, f as recordRuntimeOwnedDriveHarnessProviderEvidence, i as attestRuntimeOwnedScopeOwner, s as inheritRuntimeOwnedExecutorAttestation, v as runtimeOwnedDriveHarnessProviderEvidence, x as runtimeOwnedExecutorProviderEvidence, y as runtimeOwnedExecutorExecutionBinding } from "./materialization-Ct3I4wu3.js";
 import { f as RuntimeRunStateError, i as ConfigError, m as ValidationError, o as NotFoundError, r as BackendTransportError, t as AgentEvalError$1 } from "./errors-CDZ8XsVj.js";
 import { n as detachedSnapshot, t as detachedFrozen } from "./snapshot-CTAf4uuA.js";
-import { b as workerTraceAnalysisStore, i as InMemorySpawnJournal, n as FileSpawnJournal, r as InMemoryResultBlobStore, t as FileResultBlobStore, x as contentAddress, y as parseWorkerToolTraceArtifact } from "./spawn-journal-duo0EkOp.js";
+import { b as workerTraceAnalysisStore, i as InMemorySpawnJournal, n as FileSpawnJournal, r as InMemoryResultBlobStore, t as FileResultBlobStore, x as contentAddress, y as parseWorkerToolTraceArtifact } from "./spawn-journal-oewq1g2h.js";
 import { _ as unmeteredSpend, r as chargedTokens, u as promptCacheTokenClasses } from "./util-D6ZEuBMi.js";
 import { i as writeAllBytes, n as parseCommittedJsonLines, r as prepareJsonlAppend, t as isNoEntError } from "./jsonl-file-CDfsCI5s.js";
 import { a as concreteProfileModel, c as profileModelExecutionSettings, d as agentHarness, f as harnessRunsAgent, n as assertModelAllowed, o as enforceTokenLimits, r as assertProfileModelsAllowed, s as profileBridgeWireModel, t as assertExecutableAgentProfile } from "./model-policy-Sw4ywhtL.js";
-import { B as createExecutorRegistry, D as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, F as bridgeRuntimeAttachmentsKey, I as bridgeStopSignalKey, L as captureReusableExecutorConfig, Lt as generateSpanId, M as bindReusableExecutorExecutionId, N as bridgeAdmissionRead, O as teardownExecutor, P as bridgeModelRouteRefusal, Pt as createOtelExporter, St as runBrainLoop, U as WORKER_TRACE_PROPAGATION, V as snapshotExecutorConfig, Vt as toOtelAttributes, _n as unsupportedProfileDimensions, a as pickBestDelivered, an as assertProfileMaterialization, c as driverChild, cn as fullProfileMaterialization, d as deriveNodeExecutionIdentity, dn as promptModelProfileMaterialization, dt as isLiveNodeStatus, f as meterRuntimeOwnedAccounting, ft as isTerminalNodeStatus, h as scopeOwnerExecutorNodeContext, hn as renderUnsupported, j as spendFromUsageEvents, jt as buildLoopSpanNodes, k as assertValidBudget, l as withDriverExecutor, ln as profileMaterializationAxes$1, m as recordScopeOwnerMaterialization, n as createSupervisor, nt as createInbox, o as runFinalizer, on as controlProfileMaterialization, p as meterRuntimeOwnedProviderAttempt, r as bestDelivered, s as runTree, sn as defineProfileMaterializationContract, st as createPeerMailbox, t as createRootHandle, un as promptControlProfileMaterialization, w as freeSlots, xt as routerBrain, yn as worktreeCliProfileMaterialization, z as createExecutor } from "./supervisor-BmXD0WCJ.js";
+import { B as createExecutorRegistry, D as DEFAULT_SUCCESSFUL_SHUTDOWN_MS, F as bridgeRuntimeAttachmentsKey, I as bridgeStopSignalKey, L as captureReusableExecutorConfig, Lt as generateSpanId, M as bindReusableExecutorExecutionId, N as bridgeAdmissionRead, O as teardownExecutor, P as bridgeModelRouteRefusal, Pt as createOtelExporter, St as runBrainLoop, U as WORKER_TRACE_PROPAGATION, V as snapshotExecutorConfig, Vt as toOtelAttributes, _n as unsupportedProfileDimensions, a as pickBestDelivered, an as assertProfileMaterialization, c as driverChild, cn as fullProfileMaterialization, d as deriveNodeExecutionIdentity, dn as promptModelProfileMaterialization, dt as isLiveNodeStatus, f as meterRuntimeOwnedAccounting, ft as isTerminalNodeStatus, h as scopeOwnerExecutorNodeContext, hn as renderUnsupported, j as spendFromUsageEvents, jt as buildLoopSpanNodes, k as assertValidBudget, l as withDriverExecutor, ln as profileMaterializationAxes$1, m as recordScopeOwnerMaterialization, n as createSupervisor, nt as createInbox, o as runFinalizer, on as controlProfileMaterialization, p as meterRuntimeOwnedProviderAttempt, r as bestDelivered, s as runTree, sn as defineProfileMaterializationContract, st as createPeerMailbox, t as createRootHandle, un as promptControlProfileMaterialization, w as freeSlots, xt as routerBrain, yn as worktreeCliProfileMaterialization, z as createExecutor } from "./supervisor-ZlQy5Fwl.js";
 import { t as composeRuntimeHooks } from "./runtime-hooks-tXpAarhW.js";
 import { C as writeWorkerCancellation, S as writeRunCancellation, a as readRunCancelRequest, c as readWorkerCancellation, o as readRunCancellation, s as readWorkerCancelRequests } from "./run-layout-C2jgwsCq.js";
 import { t as createStdioToolServer } from "./tool-server-DEmLr9YY.js";
@@ -7189,4 +7189,4 @@ function rootProviderModelEvidenceFromExecution(evidence) {
 //#endregion
 export { hashIdempotencyInput as $, DELEGATION_HISTORY_INPUT_SCHEMA as A, gateOnDeliverable as At, DELEGATE_FEEDBACK_DESCRIPTION as B, createMcpServer as C, bestSoFar as Ct, createDelegationStatusHandler as D, createInMemoryRunContext as Dt, DELEGATION_STATUS_TOOL_NAME as E, createFileRunContext as Et, DELEGATE_UI_AUDIT_DESCRIPTION as F, normalizeAnalyzeOnSettle as Ft, DELEGATE_DESCRIPTION as G, DELEGATE_FEEDBACK_TOOL_NAME as H, DELEGATE_UI_AUDIT_INPUT_SCHEMA as I, questionEscalationTargets as It, createDelegateHandler as J, DELEGATE_INPUT_SCHEMA as K, DELEGATE_UI_AUDIT_TOOL_NAME as L, createEventBus as Lt, createDelegationHistoryHandler as M, DEFAULT_AWAIT_EVENT_TIMEOUT_MS as Mt, validateDelegationHistoryArgs as N, canonicalFindingEvent as Nt, validateDelegationStatusArgs as O, FileCoordinationLog as Ot, delegationProfiles as P, createCoordinationTools as Pt, DelegationTaskQueue as Q, createDelegateUiAuditHandler as R, defaultToolDetectors as Rt, createInProcessTransport as S, areaUnderCurve as St, DELEGATION_STATUS_INPUT_SCHEMA as T, renderAnytimeTable as Tt, createDelegateFeedbackHandler as U, DELEGATE_FEEDBACK_INPUT_SCHEMA as V, validateDelegateFeedbackArgs as W, defaultDelegateBudget as X, validateDelegateArgs as Y, delegate as Z, promptHandle as _, createProgressTracker as _t, assertCoordinationBinding as a, createDelegationTraceCollector as at, classifyDriverFailure as b, sampleFromSettled as bt, supervisorAgentWithTestBrain as c, FileDelegationStore as ct, delegatesWorkerBriefPrompt as d, eventToSnapshot as dt, DELEGATION_TRACE_MAX_BYTES as et, dumbContinuationFailPrompt as f, driverAgent as ft, naiveContinuationPrompt as g, anyOf as gt, kernelPromptRegistry as h, allWorkersStalled as ht, workerFromBackend as i, composeLoopTraceEmitters as it, DELEGATION_HISTORY_TOOL_NAME as j, mapExecutorResult as jt, DELEGATION_HISTORY_DESCRIPTION as k, createSupervisorSpanRecorder as kt, analyzesFindingsReportPrompt as l, InMemoryDelegationStore as lt, formatPromptHandle as m, allOf as mt, supervise as n, buildDelegationTraceSpans as nt, resolveSupervisorProfile as o, DelegationPersistenceError as ot, dumbContinuationPassPrompt as p, finalizeBestDelivered as pt, DELEGATE_TOOL_NAME as q, superviseWithTestBrain as r, capDelegationTrace as rt, supervisorAgent as s, DelegationStateCorruptError as st, DEFAULT_AUTHORED_PROFILE_SECURITY_POLICY as t, DELEGATION_TRACE_MAX_SPANS as tt, createPromptRegistry as u, InMemoryFeedbackStore as ut, supervisorPolicyPrompt as v, noProgressFor as vt, DELEGATION_STATUS_DESCRIPTION as w, plateauLength as wt, serveCoordinationMcp as x, anytimeReport as xt, DriverAttemptsExhaustedError as y, plateau as yt, validateDelegateUiAuditArgs as z, watchTrace as zt };
 
-//# sourceMappingURL=supervise-BVE0XAJa.js.map
+//# sourceMappingURL=supervise-CqwjiXlX.js.map