@tangle-network/agent-runtime 0.128.0 → 0.131.0

package/dist/index-DLM0W1h1.d.ts

@@ -1,545 +0,0 @@
-import { _ as RunAgentTaskOptions, b as RuntimeSessionStore, g as OpenAIChatToolChoice, h as OpenAIChatTool, i as AgentExecutionBackend, l as AgentTaskRunResult, m as OpenAIChatResponseFormat, n as AgentBackendContext, p as KnowledgeReadinessDecision, r as AgentBackendInput, v as RunAgentTaskStreamOptions, x as RuntimeStreamEvent, y as RuntimeSession } from "./types-C9j4qg6l.js";
-import { i as SurfaceImprovementEdit } from "./improvement-adapter-D5gwwoXQ.js";
-import { o as ImprovementProposalSource } from "./types-zWfqDjeL.js";
-import { Yr as StructuralRolloutPolicy, df as ConfigError } from "./index-BhZhQw77.js";
-import "./types-DnNGJ5Gz.js";
-import { hn as RuntimeTelemetryOptions } from "./environment-provider-CUFsyymu.js";
-import { f as runLocalHarness, o as LocalHarness, w as ToolLoopChat } from "./local-harness-BIajef4A.js";
-import "./index-B3bHsVLw.js";
-import "./index-Efjb3nrQ.js";
-import { H as CandidateGenerator, L as Verifier, a as ImproveCandidateValidationInput, j as ReadonlyAgentProfile, p as ImproveMethodFactory, t as Redactor } from "./redact-PQzmE1Jn.js";
-import "./index-BhuzfG2r.js";
-import "./loop-runner-bin-Ckp_9tmD.js";
-import "./openai-tools-B68JaOCx.js";
-import { ControlBudget as ControlBudget$1, ControlDecision as ControlDecision$1, ControlEvalResult, ControlEvalResult as ControlEvalResult$1, ControlRunResult as ControlRunResult$1, ControlStep as ControlStep$1, DataAcquisitionPlan as DataAcquisitionPlan$1, KnowledgeReadinessReport, KnowledgeReadinessReport as KnowledgeReadinessReport$1, KnowledgeRequirement as KnowledgeRequirement$1, ProposalFinding, RunRecord, RunRecord as RunRecord$1 } from "@tangle-network/agent-eval";
-import { GepaOptimizationMethodConfig, SkillOptOptimizationMethodConfig } from "@tangle-network/agent-eval/campaign";
-import { AgentProfile as AgentProfile$1 } from "@tangle-network/agent-interface";
-import { MutableSurface, Scenario as Scenario$1, SelfImproveOptions } from "@tangle-network/agent-eval/contract";
-//#region src/backends.d.ts
-/** Wrap any custom async-iterable stream into a typed `AgentExecutionBackend`. @stable */
-declare function createIterableBackend<TInput extends AgentBackendInput>(options: {
-  kind: string;
-  start?: AgentExecutionBackend<TInput>['start'];
-  resume?: AgentExecutionBackend<TInput>['resume'];
-  stream: AgentExecutionBackend<TInput>['stream'];
-  stop?: AgentExecutionBackend<TInput>['stop'];
-}): AgentExecutionBackend<TInput>;
-/** Build an `AgentExecutionBackend` backed by a sandbox/sidecar `streamPrompt` call. @stable */
-declare function createSandboxPromptBackend<TBox, TInput extends AgentBackendInput = AgentBackendInput>(options: {
-  kind?: string;
-  getBox(input: TInput, context: Omit<AgentBackendContext, 'session'>): Promise<TBox> | TBox;
-  streamPrompt(box: TBox, message: string, context: AgentBackendContext): AsyncIterable<unknown>;
-  mapEvent?: (event: unknown, context: AgentBackendContext) => RuntimeStreamEvent | undefined;
-  getSessionId?: (box: TBox, input: TInput) => string | undefined;
-}): AgentExecutionBackend<TInput>;
-/** @stable */
-/**
- * Retry policy for transient transport errors (rate limits, upstream
- * timeouts). Defaults to 5 attempts with exponential backoff starting at
- * 1s, ±25% jitter, capped at 30s. Set `maxAttempts: 1` to disable retries.
- *
- * Retried status codes:
- *   - 408 Request Timeout
- *   - 425 Too Early
- *   - 429 Too Many Requests
- *   - 500 / 502 / 503 / 504 — upstream transient failures
- *
- * Hard failures (401, 403, 4xx other than the above) propagate immediately.
- */
-interface BackendRetryPolicy {
-  /** Total attempts including the first try. Default 5. */
-  maxAttempts?: number;
-  /** Initial backoff in ms before the second attempt. Default 1000. */
-  initialBackoffMs?: number;
-  /** Hard ceiling on backoff in ms. Default 30000. */
-  maxBackoffMs?: number;
-  /** Jitter fraction in [0, 1]. Default 0.25 (±25%). */
-  jitter?: number;
-  /** Status codes that trigger a retry. Default: 408, 425, 429, 500, 502, 503, 504. */
-  retryStatuses?: ReadonlyArray<number>;
-  /**
-   * Per-attempt wall-clock deadline in ms. If a single fetch attempt does
-   * not return headers within this window the attempt is aborted and
-   * retried. Default 120000 (2 min). Without this a hung upstream blocks
-   * the attempt indefinitely — observed in production as a 15-minute
-   * `fetch failed` that burned an entire eval persona. Set to 0 to disable.
-   */
-  requestTimeoutMs?: number;
-}
-/**
- *
- * OpenAI-compat streaming backend. Routes `runAgentTaskStream` through any
- * `POST /chat/completions` endpoint that speaks OpenAI's SSE protocol —
- * Tangle Router, OpenAI direct, OpenRouter, Groq, DeepSeek, Together. The
- * router also fronts Anthropic models in Anthropic-native SSE shape; this
- * backend handles both.
- *
- * ### Tool calls
- *
- * Pass `tools` (and optionally `toolChoice`) to forward an OpenAI Chat
- * Completions `tools[]` array on every request. Streamed `tool_call` chunks
- * are buffered until the model finalizes them (either `finish_reason:
- * 'tool_calls'` for OpenAI shape or a `content_block_stop` for Anthropic
- * `tool_use` blocks proxied through the router), then emitted as a single
- * `tool_call` RuntimeStreamEvent with the assembled `args`.
- *
- * The backend does NOT execute tools — it surfaces calls for the caller's
- * own dispatcher (typically the product's MCP / sandbox runtime) to fulfill
- * and feed back as a subsequent `messages` turn. This keeps the transport
- * thin and lets the agent host own tool dispatch policy.
- *
- * ### Fail-loud errors
- *
- * Non-success HTTP responses (4xx/5xx) and exhausted retry budgets throw
- * `BackendTransportError` from inside the `stream()` generator. The runtime
- * catches the throw, yields a `backend_error` with a typed `error` field
- * (`kind`, `status`, truncated `body`) and a terminal `final` event with
- * `status: 'failed'` carrying the same detail. Consumers MUST map
- * `final.error` onto their `RunRecord.error` — silently treating an empty
- * `finalText` as "agent produced nothing" hides credit exhaustion, auth
- * failure, and upstream outages.
- *
- * @stable
- */
-declare function createOpenAICompatibleBackend<TInput extends AgentBackendInput = AgentBackendInput>(options: {
-  apiKey: string;
-  baseUrl: string;
-  model: string;
-  kind?: string;
-  /**
-   * OpenAI Chat Completions `tools[]` definitions surfaced to the model on
-   * every request. Omit to send a tool-free request (existing behavior).
-   * The runtime makes no assumption about the dispatcher — calls stream out
-   * as `tool_call` events and the caller is responsible for executing them
-   * and feeding `tool_result` messages back on a follow-up turn.
-   */
-  tools?: ReadonlyArray<OpenAIChatTool>;
-  /**
-   * OpenAI Chat Completions `tool_choice`. Default `undefined` (request
-   * omits the field; provider falls back to its own default — typically
-   * `'auto'`).
-   */
-  toolChoice?: OpenAIChatToolChoice;
-  /**
-   * OpenAI Chat Completions `response_format`. Omit for provider default text.
-   */
-  responseFormat?: OpenAIChatResponseFormat;
-  /** OpenAI Chat Completions `temperature`. Omit for provider default. */
-  temperature?: number;
-  /** Maximum completion tokens, sent as OpenAI-compatible `max_tokens`. Omit for provider default. */
-  maxTokens?: number;
-  fetchImpl?: typeof fetch;
-  retry?: BackendRetryPolicy;
-}): AgentExecutionBackend<TInput>;
-//#endregion
-//#region src/improvement/build-prompts.d.ts
-/** Evidence supplied to a generated tool or MCP build instruction. */
-interface BuildPromptFindingsInput {
-  findings: ReadonlyArray<ProposalFinding>;
-}
-/** Render findings as the ranked-evidence block every build prompt ends with. */
-declare function findingLines(findings: ReadonlyArray<ProposalFinding>): string[];
-/** Build the starting instruction for a coder agent tasked with implementing a new tool. */
-declare function toolBuildPrompt(args: BuildPromptFindingsInput): string;
-/** Build the starting instruction for a coder agent tasked with implementing a new MCP server. */
-declare function mcpBuildPrompt(args: BuildPromptFindingsInput): string;
-//#endregion
-//#region src/improvement/driver-loop-generator.d.ts
-interface DriverLoopGeneratorOptions {
-  /** The driver-LLM seam — ONE inference turn over the conversation + tool specs (the canonical
-   *  `ToolLoopChat`, same seam as `driverAgent`): `routerBrain(cfg)` in production, a scripted
-   *  mock in tests. */
-  brain: ToolLoopChat;
-  /** Local coding harness the driver's worker sessions run in the worktree. Default `claude-code`. */
-  harness?: LocalHarness;
-  /** Per-worker-session wall-clock timeout (ms). Default = `runLocalHarness` default (5m). */
-  timeoutMs?: number;
-  /** Build the driver's task briefing (domain framing + method + findings) — the same senior
-   *  prompt the worker path uses (`toolBuildPrompt` / `mcpBuildPrompt`). The driver reads it and
-   *  folds what each worker needs into its instruction. Default `defaultBuildPrompt`. */
-  buildPrompt?: (args: {
-    findings: ReadonlyArray<ProposalFinding>;
-  }) => string;
-  /** Verify the worktree (the intrinsic check). Exposed to the driver as `run_verifier` AND
-   *  re-run by code as the final keep/discard gate. Omitted ⇒ the final gate is dirty-tree only
-   *  (legacy `agenticGenerator` behavior sans verifier). */
-  verify?: Verifier;
-  /** Max driver inference turns. Default `max(8, 2 + maxShots * 3)` — room for one
-   *  observe/rate/decide cycle per worker session plus orientation. */
-  maxTurns?: number;
-  /** The research seam (adopt-not-build): when set, the driver gets a
-   *  `research{query}` tool + the `researchDriverNote` doctrine, so it can
-   *  discover an EXISTING external MCP instead of building one. Wire a real
-   *  web/search backend here — none is provisioned by default (the build
-   *  harness has no live web access yet; flagged). */
-  research?: (query: string) => Promise<string>;
-  /** Test seam — inject the harness runner (defaults to `runLocalHarness`). */
-  runHarness?: typeof runLocalHarness;
-  /** Test seam — inject the worktree diff reader (defaults to `git diff` in the worktree). */
-  readDiff?: (worktreePath: string) => string;
-  /** Test seam — inject the changed-paths reader (defaults to `git status --porcelain`). */
-  changedPaths?: (worktreePath: string) => string[];
-}
-/** Driver→worker `CandidateGenerator`: an LLM driver on the canonical tool-loop authors, observes, rates, and steers coding-harness sessions in the worktree until the verifier passes or the session budget is spent. */
-declare function driverLoopGenerator(opts: DriverLoopGeneratorOptions): CandidateGenerator;
-//#endregion
-//#region src/improvement/mcp-serve-verifier.d.ts
-interface McpServeSpec {
-  /** Command that starts the built MCP server in the worktree (stdio transport). */
-  command: string;
-  args?: string[];
-  /** Extra env for the server process (merged over `process.env`). */
-  env?: Record<string, string>;
-  /** Handshake timeout (ms). Default 30s. */
-  timeoutMs?: number;
-  /** Minimum tools the server must expose to pass. Default 1. */
-  minTools?: number;
-}
-/** Build a `Verifier` that boots a generated MCP server over stdio and checks it exposes tools. */
-declare function mcpServeVerifier(spec: McpServeSpec): Verifier;
-//#endregion
-//#region src/improvement/official-optimizers.d.ts
-/** Runtime context appended to an official optimizer's own configuration. */
-interface OfficialOptimizerContextOptions {
-  /** Context supplied to the optimizer before Runtime appends the profile surface and findings. */
-  background?: string;
-  /** Include current trace or analyst findings in the optimizer background. Default true. */
-  includeFindings?: boolean;
-  /** Reject oversized serialized findings before starting Python. Default 50,000 characters. */
-  maxFindingsChars?: number;
-  /**
-   * Redact caller-supplied context and descriptors before they leave Runtime.
-   * The built-in redactor is the default. Pass `false` only for public data
-   * that has already been reviewed.
-   */
-  redact?: Redactor | false;
-  /** Authorize one exact candidate containing structurally sensitive fields.
-   * The callback must return true for every accepted baseline and candidate. */
-  authorizeSensitiveCandidate?: (input: OfficialSensitiveCandidateInput) => boolean;
-}
-interface OfficialSensitiveCandidateInput extends ImproveCandidateValidationInput {
-  sensitivePaths: readonly string[];
-}
-/** Official GEPA configuration plus bounded Runtime findings context. */
-type OfficialGepaOptions<TScenario extends {
-  id: string;
-  kind: string;
-}, TArtifact = unknown> = Omit<GepaOptimizationMethodConfig<TScenario, TArtifact>, 'background' | 'evaluationId'> & OfficialOptimizerContextOptions;
-/** Official SkillOpt configuration plus bounded Runtime findings context. */
-type OfficialSkillOptOptions<TScenario extends {
-  id: string;
-  kind: string;
-}, TArtifact = unknown> = Omit<SkillOptOptimizationMethodConfig<TScenario, TArtifact>, 'background' | 'evaluationId'> & OfficialOptimizerContextOptions;
-/** Missing optional Python dependencies for an official optimizer. */
-declare class OfficialOptimizerUnavailableError extends ConfigError {
-  readonly optimizer: 'gepa' | 'skillopt';
-  constructor(optimizer: 'gepa' | 'skillopt', cause: unknown);
-}
-/**
- * Build a complete method backed by GEPA's official Optimize Anything API.
- *
- * The recipe is passed through unchanged. Use `engine`, `sequential`,
- * `adaptive-sequential`, `best-of`, `vote`, or `omni` explicitly.
- */
-declare function officialGepa<TScenario extends {
-  id: string;
-  kind: string;
-}, TArtifact = unknown>(options: OfficialGepaOptions<TScenario, TArtifact>): ImproveMethodFactory<TScenario, TArtifact>;
-/** Build a complete method backed by Microsoft's official SkillOpt trainer. */
-declare function officialSkillOpt<TScenario extends {
-  id: string;
-  kind: string;
-}, TArtifact = unknown>(options: OfficialSkillOptOptions<TScenario, TArtifact>): ImproveMethodFactory<TScenario, TArtifact>;
-//#endregion
-//#region src/improvement/optimizer-prompt.d.ts
-/**
- * The senior scientific-method optimizer doctrine — the ONE substantial prompt
- * core shared by every builder/author surface (tool build, MCP build, codebase
- * improvement, strategy authoring) and by the driver that steers build workers
- * (`driverLoopGenerator`).
- *
- * Seeded from the proven senior prompts rather than invented: GEPA's
- * `REFLECTION_SYSTEM` (localize → diagnose → minimal generalizable fix →
- * preserve what works), the /evolve loop (one hypothesis with a mechanism and a
- * falsifiable prediction; attack the largest measured gap first), /pursue (one
- * coherent change set, no partial scaffolding), and the self-improving-loop /
- * supervisor doctrine (a keep is decided by a real check, never by the author;
- * observe → rate → decide). Generalized from "mutate a prompt string" to
- * "build a code surface a held-out measurement will grade".
- */
-/**
- * The shared method block every build/author prompt embeds. Domain framing
- * (what a tool/MCP/codebase-edit deliverable looks like) wraps around it; this
- * is the process itself.
- */
-declare const optimizerMethod: string;
-/**
- * The driver's stance for `driverLoopGenerator` — the build-domain instance of
- * the supervisor doctrine (observe → rate → decide; refine / re-scope /
- * decompose; the check decides delivery, never the driver's prose).
- */
-declare const buildDriverSystem: string;
-/**
- * The driver's ADOPT-not-build doctrine, appended to `buildDriverSystem` when
- * a `research` tool is wired into the loop (`DriverLoopGeneratorOptions.
- * research`). Kept separate so a driver WITHOUT the tool is never told to
- * call a tool it does not have.
- */
-declare const researchDriverNote: string;
-/**
- * The senior authoring process for `authorStrategy` — the same method, shaped
- * to the strategy contract (author-blind, conserved budget, one module out).
- */
-declare const strategyAuthorMethod: string;
-//#endregion
-//#region src/improvement/raw-trace-distiller.d.ts
-interface RawTraceDistillerOptions {
-  /** Anchor the emitted paths at this run root instead of the generation `runDir`
-   *  the loop passes in. Normally unset — each call points at that generation's
-   *  own directory (`input.runDir`). Pass an absolute path when you construct the
-   *  producer ahead of the loop and want a fixed anchor (e.g. a test fixture). */
-  runDir?: string;
-  /** Max candidates to surface trace paths for, worst-scoring first. Default 12. */
-  maxCandidates?: number;
-  /** Max failing cells to enumerate per candidate before collapsing the rest into
-   *  an "ls the candidate dir" pointer. Default 8. */
-  maxCellsPerCandidate?: number;
-  /** Max concrete file paths to list per cell (the agent can always `ls` the dir
-   *  for the rest). Default 24. */
-  maxFilesPerCell?: number;
-  /** Findings to fall back to when the generation had NO failing cells, so a
-   *  clean round never wipes the proposer's steering context. Mirrors the default
-   *  distiller's static-seed fallback. Default: a single instruction finding. */
-  fallbackFindings?: ReadonlyArray<ProposalFinding>;
-}
-/**
- * Build an `analyzeGeneration` producer that feeds the proposer RAW-TRACE
- * FILESYSTEM CONTEXT — paths into the prior generation's real run traces plus a
- * grep/cat-to-diagnose instruction — instead of a pre-summarized digest.
- *
- * Drop-in for `analyzeGeneration` on `improve({ surface: 'code' })`:
- *
- *   await improve({
- *     surface: 'code',
- *     findings: seedFindings,
- *     code: { repoRoot },
- *     runDir: '/abs/run',                 // MUST be a real path — the traces live here
- *     analyzeGeneration: rawTraceDistiller(),
- *     scenarios, judge, agent,
- *   })
- */
-declare function rawTraceDistiller<TScenario extends Scenario$1 = Scenario$1, TArtifact = unknown>(options?: RawTraceDistillerOptions): NonNullable<SelfImproveOptions<TScenario, TArtifact>['analyzeGeneration']>;
-//#endregion
-//#region src/improvement/reflective-generator.d.ts
-interface ReflectiveGeneratorOptions {
-  improvementProposalSource: ImprovementProposalSource<SurfaceImprovementEdit>;
-}
-/** Cheap no-sandbox `CandidateGenerator` (the `shots=1` setting): draft surface edits via the improvement adapter and apply them as one coherent candidate. */
-declare function reflectiveGenerator(opts: ReflectiveGeneratorOptions): CandidateGenerator;
-//#endregion
-//#region src/improvement/rollout-policy.d.ts
-/** The profile extensions namespace the policy persists under. */
-declare const ROLLOUT_POLICY_EXTENSION = "structural-rollout";
-/** Parse a serialized policy surface. Returns `undefined` for non-strings,
- * malformed JSON, or values outside the policy invariants. Unknown fields are
- * dropped; supported optional fields are preserved. */
-declare function parseRolloutPolicy(surface: MutableSurface): StructuralRolloutPolicy | undefined;
-/** Normalize an untyped policy bag (a parsed surface or a profile extension) into
- *  a full `StructuralRolloutPolicy`, defaults merged. Returns `undefined` when any
- *  present dial violates the policy invariants (mirrors `resolvePolicy`: integer
- *  k ≥ 1, repairRounds ≥ 0, testgen ≥ 0) — a corrupt config must read as "not
- *  configured", never as a fabricated recipe. */
-declare function normalizeRolloutPolicy(raw: unknown): StructuralRolloutPolicy | undefined;
-/** Stable serialization with fixed field order. */
-declare function serializeRolloutPolicy(policy: StructuralRolloutPolicy): string;
-/** Read the persisted policy off the profile. `undefined` when the profile does
- *  not opt into structural rollout. */
-declare function structuralRolloutPolicyFromProfile(profile: ReadonlyAgentProfile): StructuralRolloutPolicy | undefined;
-/** Persist a detached policy under the profile extension without mutating the input. */
-declare function applyRolloutPolicyToProfile(profile: ReadonlyAgentProfile, policy: StructuralRolloutPolicy): AgentProfile$1;
-//#endregion
-//#region src/model-resolution.d.ts
-/**
- *
- * Chat-model resolution + catalog validation — the shared primitive every
- * product chat handler needs and was, until now, hand-rolling. Lifts the
- * router `/v1/models` fetch, the fail-closed id validation, and the
- * precedence resolver out of four near-identical per-repo copies.
- *
- * Policy-free by design: callers pass their own precedence order
- * (`resolveChatModel`) and their own known-good `allowlist`
- * (`validateChatModelId`), so each product keeps its resolution policy while
- * sharing the catalog fetch, the malformed-id guard, and the fail-closed
- * admission rule. No React, no `process.env` assumption — `env` is an
- * explicit narrow record so this runs unchanged in Node and in Workers.
- *
- * @stable
- */
-/**
- * A model entry as returned by the Tangle Router `/v1/models` endpoint.
- * Intentionally minimal — only the fields resolution + validation read.
- */
-interface ModelInfo {
-  id: string;
-  name?: string;
-  description?: string;
-  /** Provider slug, when the router exposes it (`provider` or `_provider`). */
-  provider?: string;
-  _provider?: string;
-  architecture?: {
-    modality?: string;
-    input_modalities?: string[];
-    output_modalities?: string[];
-  };
-}
-/** Env keys the router base URL is resolved from. */
-interface RouterEnv {
-  TANGLE_ROUTER_URL?: string;
-  TANGLE_ROUTER_BASE_URL?: string;
-}
-/** Default Tangle Router base URL used when no env override is set. */
-declare const DEFAULT_ROUTER_BASE_URL = "https://router.tangle.tools";
-/** Resolve the router base URL from env, normalised — no trailing `/v1` or `/`. */
-declare function resolveRouterBaseUrl(env?: RouterEnv): string;
-/**
- * Fetch the model catalog from the router's `/v1/models`. Throws on a non-2xx
- * response — callers decide whether to fail open (empty catalog) or closed.
- */
-declare function getModels(routerBaseUrl?: string): Promise<ModelInfo[]>;
-/** Trim a candidate model id; `undefined` for non-strings and blanks. */
-declare function cleanModelId(value: unknown): string | undefined;
-interface ChatModelCandidate {
-  /** Stable label for telemetry — e.g. `request`, `workspace`, `env`. */
-  source: string;
-  model: string | undefined;
-}
-interface ResolvedChatModel {
-  source: string;
-  model: string;
-}
-/**
- * Resolve a chat model by precedence: the first candidate carrying a
- * non-blank model wins, else `fallback`. The caller owns the precedence
- * order, so each product keeps its own policy (request → workspace → env,
- * etc.) while the first-non-blank logic and the telemetry shape stay shared.
- */
-declare function resolveChatModel(candidates: ChatModelCandidate[], fallback: ResolvedChatModel): ResolvedChatModel;
-type ChatModelValidation = {
-  succeeded: true;
-  value: string;
-} | {
-  succeeded: false;
-  error: string;
-};
-/**
- * Validate a caller-supplied chat-model id. Rejects non-strings, malformed
- * ids, and ids absent from both the caller's `allowlist` and the live router
- * catalog. Fails closed: when the catalog cannot be fetched, an unverifiable
- * id is rejected rather than admitted — a bad model never reaches the agent.
- */
-declare function validateChatModelId(modelId: unknown, options?: {
-  /**
-   * Known-good ids that skip the catalog round trip — e.g. the product's
-   * default model plus any env-configured ids.
-   */
-  allowlist?: string[];
-  routerBaseUrl?: string;
-  /** Injectable catalog loader — overridden in tests. */
-  loadModels?: (routerBaseUrl: string) => Promise<ModelInfo[]>;
-}): Promise<ChatModelValidation>;
-//#endregion
-//#region src/readiness.d.ts
-/**
- * Map a `KnowledgeReadinessReport` to a three-state branch (`ready` / `blocked` / `caveat`) the runtime, route handlers, and UI shells all switch on.
- *
- * @stable
- */
-declare function decideKnowledgeReadiness(report: KnowledgeReadinessReport, options?: {
-  minimumScore?: number;
-}): KnowledgeReadinessDecision;
-//#endregion
-//#region src/resolve-agent-backend.d.ts
-/** The transport a chat backend runs on. */
-type AgentBackendKind = 'router' | 'tcloud' | 'cli-bridge' | 'sandbox';
-/**
- * OpenAI-compat passthrough forwarded to `createOpenAICompatibleBackend` for
- * the `router` / `tcloud` / `cli-bridge` kinds. Mirrors that factory's optional
- * inputs so a product keeps its tool advertising / capture-fetch without
- * re-implementing the backend branch.
- */
-type OpenAICompatPassthrough = Pick<Parameters<typeof createOpenAICompatibleBackend>[0], 'tools' | 'toolChoice' | 'responseFormat' | 'temperature' | 'maxTokens' | 'fetchImpl' | 'retry'>;
-interface ResolveAgentBackendOptions<TInput extends AgentBackendInput = AgentBackendInput> extends OpenAICompatPassthrough {
-  /** The chat transport to resolve. */
-  kind: AgentBackendKind;
-  /**
-   * Bearer credential for the OpenAI-compat kinds. Empty string is valid for a
-   * loopback-anonymous cli-bridge; a `router`/`tcloud` route with an empty key
-   * is a caller bug the product surfaces before calling in.
-   */
-  apiKey: string;
-  /** Base URL for the OpenAI-compat kinds. cli-bridge's is its `/v1`. */
-  baseUrl: string;
-  /** Model id sent on every request. cli-bridge rejects a request without it. */
-  model: string;
-  /** `kind` label stamped on the resolved backend + its traces. Defaults to `kind`. */
-  label?: string;
-  /**
-   * `sandbox` kind: the product's own domain backend. Required for that kind —
-   * the substrate owns no product sandbox shape, so a `sandbox` resolution with
-   * no seam is a caller bug, not a silent fallback.
-   */
-  sandboxBackend?: () => AgentExecutionBackend<TInput>;
-}
-/**
- * Resolve the `AgentExecutionBackend` for the chosen `kind`. Reuse this instead
- * of hand-rolling the `createOpenAICompatibleBackend` branch in each product.
- */
-declare function resolveAgentBackend<TInput extends AgentBackendInput = AgentBackendInput>(opts: ResolveAgentBackendOptions<TInput>): AgentExecutionBackend<TInput>;
-//#endregion
-//#region src/run.d.ts
-/** Stamp cross-cutting defaults onto adapter-projected RunRecords without
- *  overriding anything the adapter set explicitly:
- *   - `scenarioId` — the run's scenario, when the record omits one.
- *   - `failureClass` — the control layer's failure classification promoted
- *     onto the canonical cross-agent key, but ONLY when it's a real taxonomy
- *     class. This is what lets the substrate aggregate failures across every
- *     agent in one vocabulary instead of per-agent ad-hoc strings. */
-declare function applyRunRecordDefaults(records: RunRecord[], scenarioId: string, controlFailureClass: string | undefined): RunRecord[];
-/**
- * Single-shot task lifecycle for adapter-driven tasks: readiness-gated, emits the runtime lifecycle event vocabulary, session-store pluggable.
- *
- * @stable
- */
-declare function runAgentTask<TState, TAction, TActionResult, TEval extends ControlEvalResult = ControlEvalResult>(options: RunAgentTaskOptions<TState, TAction, TActionResult, TEval>): Promise<AgentTaskRunResult<TState, TAction, TActionResult, TEval>>;
-/**
- * Streaming task lifecycle: delegates execution to an `AgentExecutionBackend` (model API, sandbox, or custom iterable) and yields lifecycle events as they happen.
- *
- * @stable
- */
-declare function runAgentTaskStream<TInput extends AgentBackendInput = AgentBackendInput>(options: RunAgentTaskStreamOptions<TInput>): AsyncIterable<RuntimeStreamEvent>;
-//#endregion
-//#region src/sessions.d.ts
-/** In-memory `RuntimeSessionStore` for single-process use and tests. @stable */
-declare class InMemoryRuntimeSessionStore implements RuntimeSessionStore {
-  private readonly sessions;
-  private readonly events;
-  get(sessionId: string): RuntimeSession | undefined;
-  put(session: RuntimeSession): void;
-  appendEvent(sessionId: string, event: RuntimeStreamEvent): void;
-  listEvents(sessionId: string): RuntimeStreamEvent[];
-}
-//#endregion
-//#region src/sse.d.ts
-/** @stable */
-interface ServerSentEventOptions {
-  event?: string;
-  id?: string;
-  retry?: number;
-}
-/** Serialize a `KnowledgeReadinessReport` as a Server-Sent Event string. @stable */
-declare function readinessServerSentEvent(report: KnowledgeReadinessReport, options?: RuntimeTelemetryOptions & ServerSentEventOptions): string;
-/** Serialize a `RuntimeStreamEvent` as a Server-Sent Event string. @stable */
-declare function runtimeStreamServerSentEvent(event: RuntimeStreamEvent, options?: RuntimeTelemetryOptions & ServerSentEventOptions): string;
-//#endregion
-export { McpServeSpec as $, resolveRouterBaseUrl as A, RawTraceDistillerOptions as B, DEFAULT_ROUTER_BASE_URL as C, cleanModelId as D, RouterEnv as E, parseRolloutPolicy as F, strategyAuthorMethod as G, buildDriverSystem as H, serializeRolloutPolicy as I, OfficialOptimizerUnavailableError as J, OfficialGepaOptions as K, structuralRolloutPolicyFromProfile as L, ROLLOUT_POLICY_EXTENSION as M, applyRolloutPolicyToProfile as N, getModels as O, normalizeRolloutPolicy as P, officialSkillOpt as Q, ReflectiveGeneratorOptions as R, ChatModelValidation as S, ResolvedChatModel as T, optimizerMethod as U, rawTraceDistiller as V, researchDriverNote as W, OfficialSkillOptOptions as X, OfficialSensitiveCandidateInput as Y, officialGepa as Z, AgentBackendKind as _, ControlStep$1 as a, mcpBuildPrompt as at, decideKnowledgeReadiness as b, KnowledgeRequirement$1 as c, createIterableBackend as ct, readinessServerSentEvent as d, mcpServeVerifier as et, runtimeStreamServerSentEvent as f, runAgentTaskStream as g, runAgentTask as h, ControlRunResult$1 as i, findingLines as it, validateChatModelId as j, resolveChatModel as k, RunRecord$1 as l, createOpenAICompatibleBackend as lt, applyRunRecordDefaults as m, ControlDecision$1 as n, driverLoopGenerator as nt, DataAcquisitionPlan$1 as o, toolBuildPrompt as ot, InMemoryRuntimeSessionStore as p, OfficialOptimizerContextOptions as q, ControlEvalResult$1 as r, BuildPromptFindingsInput as rt, KnowledgeReadinessReport$1 as s, BackendRetryPolicy as st, ControlBudget$1 as t, DriverLoopGeneratorOptions as tt, ServerSentEventOptions as u, createSandboxPromptBackend as ut, ResolveAgentBackendOptions as v, ModelInfo as w, ChatModelCandidate as x, resolveAgentBackend as y, reflectiveGenerator as z };
-//# sourceMappingURL=index-DLM0W1h1.d.ts.map

package/dist/knowledge-DF63xPr4.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"knowledge-DF63xPr4.js","names":[],"sources":["../src/knowledge/activation.ts","../src/knowledge/supervised-update.ts","../src/knowledge/improvement-job.ts"],"sourcesContent":["import type {\n  AgentImprovementActivationOutcome,\n  AgentImprovementActivationResult,\n  AgentImprovementActivationTarget,\n  Sha256Digest,\n} from '@tangle-network/agent-interface'\nimport { sha256DigestSchema } from '@tangle-network/agent-interface'\nimport {\n  fromAgentCandidateKnowledgeRef,\n  type KnowledgeImprovementMutationReceipt,\n  loadKnowledgeImprovementActivationResult,\n  type PromoteKnowledgeCandidateOptions,\n  promoteKnowledgeCandidate,\n  restoreKnowledgeCandidateBaseline,\n} from '@tangle-network/agent-knowledge'\n\nimport {\n  type AgentImprovementActivationReconciliation,\n  type AgentImprovementActivationResultStore,\n  type AgentImprovementActivationTransition,\n  type AgentImprovementActivationTransitionInput,\n  createAgentImprovementActivationResult,\n} from '../intelligence/activation'\n\nexport interface CreateKnowledgeImprovementActivationExecutorOptions\n  extends Omit<PromoteKnowledgeCandidateOptions, 'root' | 'candidate'> {\n  root: string\n  identity: string\n  results: AgentImprovementActivationResultStore\n}\n\nexport interface KnowledgeImprovementActivationExecutor {\n  transition: AgentImprovementActivationTransition\n  reconcile: AgentImprovementActivationReconciliation\n}\n\n/** Apply or restore one local knowledge candidate through the shared activation contract. */\nexport function createKnowledgeImprovementActivationExecutor(\n  options: CreateKnowledgeImprovementActivationExecutorOptions,\n): KnowledgeImprovementActivationExecutor {\n  if (!options.identity.trim()) throw new Error('knowledge activation identity is required')\n  return {\n    reconcile: async (transition) => {\n      const inspected = await inspectKnowledgeActivation(options, transition)\n      return inspected.settled ? inspected.result : undefined\n    },\n    transition: async (transition) => {\n      if (transition.expired) {\n        throw new Error('knowledge write transition cannot run after authorization expires')\n      }\n      const inspected = await inspectKnowledgeActivation(options, transition)\n      if (inspected.settled) return inspected.result\n\n      const mutationOptions = {\n        root: options.root,\n        candidate: inspected.candidate,\n        activation: {\n          activation: transition.activation,\n          attemptedAt: transition.attemptedAt,\n          identity: options.identity,\n          createResult: (receipt: KnowledgeImprovementMutationReceipt) =>\n            inspected.create(\n              knowledgeMutationOutcome(receipt, inspected, transition.activation.intent),\n            ),\n        },\n        ...(options.ownerId ? { ownerId: options.ownerId } : {}),\n        ...(options.leaseTtlMs === undefined ? {} : { leaseTtlMs: options.leaseTtlMs }),\n        ...(options.now ? { now: options.now } : {}),\n        ...(options.onState ? { onState: options.onState } : {}),\n      }\n      const improvement =\n        transition.activation.intent === 'activate-candidate'\n          ? await promoteKnowledgeCandidate(mutationOptions)\n          : await restoreKnowledgeCandidateBaseline(mutationOptions)\n      if (!improvement.activationResult) {\n        throw new Error('knowledge mutation did not persist its shared activation result')\n      }\n      return options.results.putIfAbsent(improvement.activationResult)\n    },\n  }\n}\n\ntype CreateKnowledgeActivation = (\n  outcome: AgentImprovementActivationOutcome,\n) => AgentImprovementActivationResult\n\ntype InspectedKnowledgeActivation =\n  | { settled: true; result: unknown | undefined }\n  | {\n      settled: false\n      target: AgentImprovementActivationTransitionInput['targets'][number]\n      candidate: PromoteKnowledgeCandidateOptions['candidate']\n      expectedDigest: Sha256Digest\n      desiredDigest: Sha256Digest\n      create: CreateKnowledgeActivation\n    }\n\nasync function inspectKnowledgeActivation(\n  options: CreateKnowledgeImprovementActivationExecutorOptions,\n  transition: AgentImprovementActivationTransitionInput,\n): Promise<InspectedKnowledgeActivation> {\n  const stored = await options.results.load(transition.activation.digest)\n  if (stored !== undefined) return { settled: true, result: stored }\n\n  const create: CreateKnowledgeActivation = (outcome) =>\n    createAgentImprovementActivationResult(transition, {\n      completedAt: completionTime(transition, options.now),\n      outcome,\n    })\n  const store = (outcome: AgentImprovementActivationOutcome) =>\n    options.results.putIfAbsent(create(outcome))\n  if (transition.kind !== 'sealed-candidate') {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_PROFILE_TRANSITION_UNSUPPORTED',\n        message: 'The knowledge adapter accepts only sealed knowledge candidates.',\n      }),\n    }\n  }\n  const target = supportedKnowledgeTarget(transition, options.identity)\n  if (!target) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_TARGET_SET_UNSUPPORTED',\n        message: 'The knowledge adapter requires exactly one matching knowledge target.',\n      }),\n    }\n  }\n  const knowledge = transition.candidateBundle.knowledge\n  if (!knowledge) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'unsupported',\n        code: 'KNOWLEDGE_CANDIDATE_MISSING',\n        message: 'The measured candidate bundle does not contain a knowledge candidate.',\n      }),\n    }\n  }\n  const candidate = fromAgentCandidateKnowledgeRef(knowledge.candidate)\n  const expectedDigest =\n    transition.activation.intent === 'activate-candidate'\n      ? knowledge.candidate.baseHash\n      : knowledge.candidate.candidateHash\n  const desiredDigest =\n    transition.activation.intent === 'activate-candidate'\n      ? knowledge.candidate.candidateHash\n      : knowledge.candidate.baseHash\n  if (target.expectedBaseDigest !== expectedDigest || target.desiredDigest !== desiredDigest) {\n    if (transition.expired) return { settled: true, result: undefined }\n    return {\n      settled: true,\n      result: await store({\n        status: 'failed',\n        code: 'KNOWLEDGE_TARGET_MISMATCH',\n        message: 'The activation target does not match the measured knowledge candidate.',\n      }),\n    }\n  }\n\n  const durable = await loadKnowledgeImprovementActivationResult({\n    root: options.root,\n    candidate,\n    activation: transition.activation,\n    identity: options.identity,\n  })\n  if (durable) {\n    return {\n      settled: true,\n      result: await options.results.putIfAbsent(durable),\n    }\n  }\n  if (transition.expired) return { settled: true, result: undefined }\n  return { settled: false, target, candidate, expectedDigest, desiredDigest, create }\n}\n\nfunction supportedKnowledgeTarget(\n  transition: AgentImprovementActivationTransitionInput,\n  identity: string,\n): AgentImprovementActivationTransitionInput['targets'][number] | undefined {\n  if (transition.targets.length !== 1) return undefined\n  const target = transition.targets[0]\n  return target.surface === 'knowledge' && target.identity === identity ? target : undefined\n}\n\nfunction knowledgeMutationOutcome(\n  receipt: KnowledgeImprovementMutationReceipt,\n  inspected: Extract<InspectedKnowledgeActivation, { settled: false }>,\n  intent: AgentImprovementActivationTransitionInput['activation']['intent'],\n): AgentImprovementActivationOutcome {\n  const expectedTarget = intent === 'activate-candidate' ? 'candidate' : 'baseline'\n  const beforeDigest = prefixedDigest(receipt.beforeHash)\n  const afterDigest = prefixedDigest(receipt.afterHash)\n  if (\n    receipt.target !== expectedTarget ||\n    receipt.changed !== (beforeDigest !== afterDigest) ||\n    (!receipt.changed && (receipt.transactionId !== null || receipt.recovered))\n  ) {\n    throw new Error('knowledge mutation returned inconsistent state evidence')\n  }\n  if (receipt.changed) {\n    if (\n      receipt.transactionId === null ||\n      beforeDigest !== inspected.expectedDigest ||\n      afterDigest !== inspected.desiredDigest\n    ) {\n      throw new Error('knowledge activation did not apply its authorized content transition')\n    }\n    return {\n      status: 'applied',\n      transactionId: receipt.transactionId,\n      targets: [\n        {\n          surface: inspected.target.surface,\n          identity: inspected.target.identity,\n          beforeDigest,\n          afterDigest,\n        },\n      ],\n    }\n  }\n  if (afterDigest === inspected.desiredDigest) {\n    return {\n      status: 'already-applied',\n      targets: [targetState(inspected.target, afterDigest)],\n    }\n  }\n  if (afterDigest === inspected.expectedDigest) {\n    throw new Error('knowledge activation did not attempt its authorized content transition')\n  }\n  return {\n    status: 'conflict',\n    targets: [targetState(inspected.target, afterDigest)],\n  }\n}\n\nfunction targetState(target: AgentImprovementActivationTarget, currentDigest: Sha256Digest) {\n  return {\n    surface: target.surface,\n    identity: target.identity,\n    currentDigest,\n  }\n}\n\nfunction prefixedDigest(hash: string): Sha256Digest {\n  return sha256DigestSchema.parse(`sha256:${hash}`)\n}\n\nfunction completionTime(\n  transition: AgentImprovementActivationTransitionInput,\n  now: (() => Date) | undefined,\n): string {\n  const completedAt = (now ?? (() => new Date()))().toISOString()\n  return Date.parse(completedAt) < Date.parse(transition.attemptedAt)\n    ? transition.attemptedAt\n    : completedAt\n}\n","import type { RagKnowledgeUpdateResult } from '@tangle-network/agent-knowledge'\nimport { researcherProfile } from '../profiles/researcher'\nimport type { DeliverableSpec } from '../runtime/supervise/completion-gate'\nimport type { ExecutorConfig } from '../runtime/supervise/runtime'\nimport { type SuperviseOptions, supervise } from '../runtime/supervise/supervise'\nimport type { SupervisorProfile } from '../runtime/supervise/supervisor-agent'\nimport type { Budget, SupervisedResult } from '../runtime/supervise/types'\n\n/** Standing prompt for a supervisor that grows a shared knowledge base through spawned researchers. */\nexport const RESEARCH_SUPERVISOR_SYSTEM_PROMPT = [\n  'You are a research supervisor. You do not answer the research question yourself.',\n  'You create and manage researcher workers that improve one shared knowledge base until it is ready.',\n  '',\n  'Each round:',\n  '1. Read the goal and the gaps the readiness check still reports.',\n  '2. Decompose the open work into independent sub-topics.',\n  '3. Spawn one researcher per sub-topic; split by sub-topic, never duplicate work.',\n  '4. Wait for researchers to settle, steer or re-spawn thin sub-topics, then stop when the check passes.',\n  '',\n  'Conserve the shared budget. Prefer a small number of well-scoped researchers over a large fanout that re-covers the same ground.',\n].join('\\n')\n\nexport interface KnowledgeReadinessCheckInput {\n  root: string\n  goal: string\n  readinessSpecs?: readonly unknown[]\n  readinessTaskId?: string\n  readiness?: unknown\n}\n\nexport type KnowledgeReadinessCheckResult =\n  | boolean\n  | {\n      ready: boolean\n      summary?: string\n      metadata?: Record<string, unknown>\n    }\n\nexport type KnowledgeReadinessCheck = (\n  input: KnowledgeReadinessCheckInput,\n) => Promise<KnowledgeReadinessCheckResult> | KnowledgeReadinessCheckResult\n\nexport interface SupervisedKnowledgeUpdateInput {\n  goal?: string\n  root?: string\n  candidateRoot?: string\n  findings?: readonly unknown[]\n  metadata?: Record<string, unknown>\n}\n\nexport interface SupervisedKnowledgeUpdateResult {\n  applied: boolean\n  summary: string\n  supervised: SupervisedResult<unknown>\n  metadata: NonNullable<RagKnowledgeUpdateResult['metadata']>\n}\n\nexport interface SupervisedKnowledgeUpdateOptions {\n  root: string\n  goal: string\n  readiness: KnowledgeReadinessCheck\n  readinessSpecs?: readonly unknown[]\n  readinessTaskId?: string\n  readinessOptions?: unknown\n  findings?: readonly unknown[]\n  metadata?: Record<string, unknown>\n  budget: Budget\n  backend?: ExecutorConfig\n  makeWorkerAgent?: SuperviseOptions['makeWorkerAgent']\n  harness?: string\n  supervisorModel?: string\n  supervisorSystemPrompt?: string\n  superviseOptions?: Partial<\n    Omit<\n      SuperviseOptions,\n      'budget' | 'backend' | 'deliverable' | 'makeWorkerAgent' | 'allowedModels'\n    >\n  >\n  allowedModels?: readonly string[]\n  runSupervised?: (\n    profile: SupervisorProfile,\n    task: unknown,\n    opts: SuperviseOptions,\n  ) => Promise<SupervisedResult<unknown>>\n}\n\nexport type SupervisedKnowledgeUpdater = (\n  input: SupervisedKnowledgeUpdateInput,\n) => Promise<SupervisedKnowledgeUpdateResult>\n\n/** Build the completion check a supervised KB update uses to stop only when the KB is ready. */\nexport function knowledgeReadinessDeliverable(\n  options: Pick<\n    SupervisedKnowledgeUpdateOptions,\n    'root' | 'goal' | 'readiness' | 'readinessSpecs' | 'readinessTaskId' | 'readinessOptions'\n  >,\n): DeliverableSpec<unknown> {\n  return {\n    describe: `knowledge base at ${options.root} is ready for: ${options.goal}`,\n    async check() {\n      const result = await options.readiness({\n        root: options.root,\n        goal: options.goal,\n        readinessSpecs: options.readinessSpecs,\n        readinessTaskId: options.readinessTaskId,\n        readiness: options.readinessOptions,\n      })\n      return typeof result === 'boolean' ? result : result.ready\n    },\n  }\n}\n\n/** Create an `improveKnowledgeBase` update callback backed by runtime supervision. */\nexport function createSupervisedKnowledgeUpdater(\n  options: SupervisedKnowledgeUpdateOptions,\n): SupervisedKnowledgeUpdater {\n  return (input) =>\n    runSupervisedKnowledgeUpdate({\n      ...options,\n      root: input.candidateRoot ?? input.root ?? options.root,\n      goal: input.goal ?? options.goal,\n      findings: input.findings ?? options.findings,\n      metadata: { ...options.metadata, ...input.metadata },\n    })\n}\n\n/** Run a runtime supervisor that updates one candidate knowledge base and stops on readiness. */\nexport async function runSupervisedKnowledgeUpdate(\n  options: SupervisedKnowledgeUpdateOptions,\n): Promise<SupervisedKnowledgeUpdateResult> {\n  const { profile: workerProfile } = researcherProfile({ harness: options.harness })\n  const baseInstructions = options.supervisorSystemPrompt ?? RESEARCH_SUPERVISOR_SYSTEM_PROMPT\n  const workerContract = workerProfile.prompt?.systemPrompt\n  const systemPrompt = workerContract\n    ? `${baseInstructions}\\n\\nEach researcher worker you spawn follows this contract:\\n${workerContract}`\n    : baseInstructions\n\n  const profile: SupervisorProfile = {\n    name: 'knowledge-research-supervisor',\n    ...(options.supervisorModel ? { model: { default: options.supervisorModel } } : {}),\n    prompt: { systemPrompt },\n  }\n  const run = options.runSupervised ?? supervise\n  const task = formatSupervisedKnowledgeTask(options)\n  const supervised = await run(profile, task, {\n    ...options.superviseOptions,\n    budget: options.budget,\n    backend: options.backend,\n    deliverable: knowledgeReadinessDeliverable(options),\n    makeWorkerAgent: options.makeWorkerAgent,\n    allowedModels: options.allowedModels,\n  })\n  return {\n    applied: supervised.kind === 'winner',\n    summary:\n      supervised.kind === 'winner'\n        ? 'research supervisor completed and the knowledge base passed readiness'\n        : `research supervisor stopped without a ready knowledge base: ${supervised.reason}`,\n    supervised,\n    metadata: {\n      supervised: true,\n      root: options.root,\n      goal: options.goal,\n      result: supervised.kind,\n    },\n  }\n}\n\n/** Format the supervisor task with the KB root, readiness requirements, current findings, and metadata. */\nexport function formatSupervisedKnowledgeTask(\n  options: Pick<\n    SupervisedKnowledgeUpdateOptions,\n    'root' | 'goal' | 'readinessSpecs' | 'readinessTaskId' | 'findings' | 'metadata'\n  >,\n): string {\n  const sections = [\n    `Goal: ${options.goal}`,\n    `Knowledge base root: ${options.root}`,\n    options.readinessTaskId ? `Readiness task id: ${options.readinessTaskId}` : undefined,\n    options.readinessSpecs?.length\n      ? `Readiness specs:\\n${JSON.stringify(options.readinessSpecs, null, 2)}`\n      : undefined,\n    options.findings?.length\n      ? `Current findings:\\n${JSON.stringify(options.findings, null, 2)}`\n      : undefined,\n    options.metadata && Object.keys(options.metadata).length > 0\n      ? `Metadata:\\n${JSON.stringify(options.metadata, null, 2)}`\n      : undefined,\n  ].filter((section): section is string => Boolean(section))\n  return `${sections.join('\\n\\n')}\\n\\nUpdate files under the knowledge base root only. Stop when the readiness check passes.`\n}\n","import { realpath } from 'node:fs/promises'\nimport {\n  type AgentCandidateBundle,\n  type AgentCandidateCapturedArtifact,\n  type AgentCandidateKnowledge,\n  agentCandidateKnowledgeSchema,\n} from '@tangle-network/agent-interface'\nimport {\n  type BuildEvalKnowledgeBundleOptions,\n  evaluateKnowledgeBaseReadiness,\n  improveKnowledgeBase,\n  type KnowledgeBaseQualityOptions,\n  type KnowledgeImprovementOptions,\n  type KnowledgeImprovementResult,\n  type KnowledgeReadinessSpec,\n  knowledgeImprovementCandidateRef,\n  toAgentCandidateKnowledgeRef,\n  withKnowledgeImprovementComparison,\n} from '@tangle-network/agent-knowledge'\nimport { sealAgentCandidateBundle } from '../candidate-execution/bundle'\nimport {\n  canonicalCandidateBytes,\n  embeddedCandidateArtifact,\n  omitTopLevelDigest,\n} from '../candidate-execution/digest'\nimport { persistCandidateOutputArtifact } from '../candidate-execution/output-artifacts'\nimport type { AgentCandidateOutputArtifactPort } from '../candidate-execution/types'\nimport { captureAgentCandidateWorkspace } from '../candidate-execution/workspace-archive'\nimport type { ExecutorConfig } from '../runtime/supervise/runtime'\nimport type { SuperviseOptions } from '../runtime/supervise/supervise'\nimport type { SupervisorProfile } from '../runtime/supervise/supervisor-agent'\nimport type { Budget, SupervisedResult } from '../runtime/supervise/types'\nimport {\n  createSupervisedKnowledgeUpdater,\n  type KnowledgeReadinessCheck,\n  type KnowledgeReadinessCheckResult,\n  type SupervisedKnowledgeUpdateOptions,\n} from './supervised-update'\n\nexport interface RunKnowledgeImprovementJobOptions\n  extends Omit<KnowledgeImprovementOptions, 'updateKnowledge'> {\n  budget: Budget\n  readinessCheck?: KnowledgeReadinessCheck\n  backend?: ExecutorConfig\n  makeWorkerAgent?: SuperviseOptions['makeWorkerAgent']\n  harness?: string\n  supervisorModel?: string\n  supervisorSystemPrompt?: string\n  superviseOptions?: Partial<\n    Omit<\n      SuperviseOptions,\n      'budget' | 'backend' | 'deliverable' | 'makeWorkerAgent' | 'allowedModels'\n    >\n  >\n  allowedModels?: readonly string[]\n  runSupervised?: (\n    profile: SupervisorProfile,\n    task: unknown,\n    opts: SuperviseOptions,\n  ) => Promise<SupervisedResult<unknown>>\n  candidateArtifacts?: AgentCandidateOutputArtifactPort\n  onMeasurement?: (measurement: KnowledgeImprovementJobMeasurement) => Promise<void> | void\n}\n\nexport interface KnowledgeImprovementJobMeasurement {\n  startedAt: string\n  finishedAt: string\n  durationMs: number\n  updateCalls: number\n  updateDurationMs: number\n  supervisedSpent: {\n    iterations: number\n    inputTokens: number\n    outputTokens: number\n    usdKnown: boolean\n    usd: number\n    ms: number\n  }\n}\n\nexport interface KnowledgeImprovementJobResult {\n  improvement: KnowledgeImprovementResult\n  knowledge?: KnowledgeImprovementCandidatePair\n  measurement: KnowledgeImprovementJobMeasurement\n  blocked: boolean\n}\n\nexport interface KnowledgeImprovementCandidatePair {\n  reference: AgentCandidateKnowledge['candidate']\n  evaluation: AgentCandidateCapturedArtifact\n  baseline: AgentCandidateKnowledge['snapshot']\n  candidate: AgentCandidateKnowledge['snapshot']\n}\n\nexport interface KnowledgeImprovementExperimentBundles {\n  baseline: AgentCandidateBundle\n  candidate: AgentCandidateBundle\n}\n\nexport interface AgentKnowledgeReadinessCheckOptions {\n  goal: string\n  readinessSpecs?: readonly KnowledgeReadinessSpec[]\n  readinessTaskId?: string\n  readiness?: Omit<BuildEvalKnowledgeBundleOptions, 'taskId' | 'index' | 'specs'>\n  strict?: boolean\n  kbQuality?: KnowledgeBaseQualityOptions\n}\n\n/** Build the default readiness check backed by `@tangle-network/agent-knowledge` validation and scoring. */\nexport function createAgentKnowledgeReadinessCheck(\n  options: AgentKnowledgeReadinessCheckOptions,\n): KnowledgeReadinessCheck {\n  return async (input): Promise<KnowledgeReadinessCheckResult> => {\n    const readiness = await evaluateKnowledgeBaseReadiness({\n      root: input.root,\n      goal: input.goal ?? options.goal,\n      readinessSpecs:\n        (input.readinessSpecs as readonly KnowledgeReadinessSpec[] | undefined) ??\n        options.readinessSpecs,\n      readinessTaskId: input.readinessTaskId ?? options.readinessTaskId,\n      readiness:\n        (input.readiness as AgentKnowledgeReadinessCheckOptions['readiness'] | undefined) ??\n        options.readiness,\n      strict: options.strict,\n      kbQuality: options.kbQuality,\n    })\n    return {\n      ready: readiness.ready,\n      summary: readiness.summary,\n      metadata: {\n        dimensions: readiness.dimensions,\n        validationOk: readiness.validation.ok,\n        kbQualityOk: readiness.kbQuality.ok,\n        blockingMissing: readiness.readiness?.report.blockingMissingRequirements.length ?? 0,\n      },\n    }\n  }\n}\n\n/** Produce a frozen KB candidate while leaving live knowledge content unchanged. */\nexport async function runKnowledgeImprovementJob(\n  options: RunKnowledgeImprovementJobOptions,\n): Promise<KnowledgeImprovementJobResult> {\n  const {\n    allowedModels,\n    backend,\n    budget,\n    candidateArtifacts,\n    harness,\n    makeWorkerAgent,\n    onMeasurement,\n    readinessCheck,\n    runSupervised,\n    supervisorModel,\n    supervisorSystemPrompt,\n    superviseOptions,\n    ...knowledgeOptions\n  } = options\n  const startedAtMs = Date.now()\n  const startedAt = new Date(startedAtMs).toISOString()\n  const supervisedSpent = emptySpent()\n  let updateCalls = 0\n  let updateDurationMs = 0\n\n  const readiness = readinessCheck ?? createAgentKnowledgeReadinessCheck(options)\n  const updateKnowledge = createSupervisedKnowledgeUpdater({\n    root: options.root,\n    goal: options.goal,\n    readiness,\n    readinessSpecs: options.readinessSpecs,\n    readinessTaskId: options.readinessTaskId,\n    readinessOptions: options.readiness,\n    budget,\n    backend,\n    makeWorkerAgent,\n    harness,\n    supervisorModel,\n    supervisorSystemPrompt,\n    superviseOptions,\n    allowedModels,\n    runSupervised,\n  } satisfies SupervisedKnowledgeUpdateOptions)\n\n  const instrumentedUpdateKnowledge: KnowledgeImprovementOptions['updateKnowledge'] = async (\n    input,\n  ) => {\n    const updateStartedAt = Date.now()\n    updateCalls += 1\n    const result = await updateKnowledge(input)\n    updateDurationMs += Date.now() - updateStartedAt\n    addSpent(supervisedSpent, result.supervised)\n    return result\n  }\n  const resolvedImprovement = await improveKnowledgeBase({\n    ...knowledgeOptions,\n    updateKnowledge: instrumentedUpdateKnowledge,\n  })\n  let knowledge: KnowledgeImprovementCandidatePair | undefined\n  if (\n    resolvedImprovement.candidate?.status === 'candidate-ready' ||\n    resolvedImprovement.candidate?.status === 'promoted'\n  ) {\n    knowledge = await freezeKnowledgeCandidatePair(\n      options.root,\n      resolvedImprovement,\n      candidateArtifacts,\n      knowledgeOptions.signal,\n    )\n  }\n  const finishedAtMs = Date.now()\n  const measurement: KnowledgeImprovementJobMeasurement = {\n    startedAt,\n    finishedAt: new Date(finishedAtMs).toISOString(),\n    durationMs: finishedAtMs - startedAtMs,\n    updateCalls,\n    updateDurationMs,\n    supervisedSpent,\n  }\n  await onMeasurement?.(measurement)\n  return {\n    improvement: resolvedImprovement,\n    ...(knowledge ? { knowledge } : {}),\n    measurement,\n    blocked: resolvedImprovement.blocked,\n  }\n}\n\n/** Attach both frozen knowledge inputs to one otherwise-identical bundle pair. */\nexport function buildKnowledgeImprovementExperimentBundles(\n  bundle: AgentCandidateBundle,\n  knowledge: KnowledgeImprovementCandidatePair,\n): KnowledgeImprovementExperimentBundles {\n  const input = omitTopLevelDigest(bundle)\n  const withSnapshot = (snapshot: AgentCandidateKnowledge['snapshot']) =>\n    agentCandidateKnowledgeSchema.parse({\n      candidate: knowledge.reference,\n      snapshot,\n      evaluation: knowledge.evaluation,\n    })\n  return Object.freeze({\n    baseline: sealAgentCandidateBundle({ ...input, knowledge: withSnapshot(knowledge.baseline) }),\n    candidate: sealAgentCandidateBundle({ ...input, knowledge: withSnapshot(knowledge.candidate) }),\n  })\n}\n\nasync function freezeKnowledgeCandidatePair(\n  root: string,\n  improvement: KnowledgeImprovementResult,\n  artifacts: AgentCandidateOutputArtifactPort | undefined,\n  signal: AbortSignal | undefined,\n): Promise<KnowledgeImprovementCandidatePair> {\n  const candidate = knowledgeImprovementCandidateRef(improvement)\n  const candidateRef = toAgentCandidateKnowledgeRef(candidate)\n  return withKnowledgeImprovementComparison({ root, candidate }, async (comparison) => {\n    const freeze = async (\n      target: 'baseline' | 'candidate',\n    ): Promise<AgentCandidateKnowledge['snapshot']> => {\n      const executionId = `knowledge-${candidate.candidateId}-${target}`\n      const captured = await captureAgentCandidateWorkspace(\n        await realpath(comparison[target].root),\n        {\n          ...(artifacts\n            ? {\n                artifactPersistence: {\n                  executionId,\n                  outputArtifacts: artifacts,\n                  ...(signal ? { signal } : {}),\n                },\n              }\n            : {}),\n        },\n      )\n      return captured.snapshot\n    }\n    const evaluation = await captureKnowledgeEvidence(\n      canonicalCandidateBytes({\n        kind: 'agent-knowledge-candidate-evaluation',\n        candidate: candidateRef,\n        metric: comparison.evaluation,\n      }),\n      'knowledge-evaluation',\n      `knowledge-${candidate.candidateId}`,\n      artifacts,\n      signal,\n    )\n    const baseline = await freeze('baseline')\n    const proposed = await freeze('candidate')\n    return Object.freeze({\n      reference: candidateRef,\n      evaluation,\n      baseline,\n      candidate: proposed,\n    })\n  })\n}\n\nasync function captureKnowledgeEvidence(\n  bytes: Uint8Array,\n  purpose: 'knowledge-evaluation',\n  executionId: string,\n  artifacts: AgentCandidateOutputArtifactPort | undefined,\n  signal: AbortSignal | undefined,\n): Promise<AgentCandidateCapturedArtifact> {\n  if (!artifacts) return embeddedCandidateArtifact(bytes)\n  return persistCandidateOutputArtifact(artifacts, {\n    executionId,\n    purpose,\n    bytes,\n    ...(signal ? { signal } : {}),\n  })\n}\n\nfunction emptySpent(): KnowledgeImprovementJobMeasurement['supervisedSpent'] {\n  return { iterations: 0, inputTokens: 0, outputTokens: 0, usdKnown: true, usd: 0, ms: 0 }\n}\n\nfunction addSpent(\n  target: KnowledgeImprovementJobMeasurement['supervisedSpent'],\n  result: SupervisedResult<unknown>,\n): void {\n  const spent = result.spentTotal\n  target.iterations += spent.iterations\n  target.inputTokens += spent.tokens.input\n  target.outputTokens += spent.tokens.output\n  target.usdKnown = target.usdKnown && spent.usdKnown !== false\n  target.usd += spent.usd\n  target.ms += spent.ms\n}\n"],"mappings":"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"}