@kindgi/agents 0.0.0-bootstrap.0 → 0.1.0

package/dist/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,62 @@
+export type AgentError = InvalidAgentError | AgentNotFoundError | AgentAlreadyRegisteredError | AgentVersionMismatchError | ConversationNotFoundError | ConversationClosedError | InvalidMessageError | PersistenceError;
+/** `defineAgent` was called with a shape that fails validation. */
+export interface InvalidAgentError {
+    readonly code: 'invalid-agent';
+    readonly message: string;
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+}
+/** A registry lookup by (id, version) missed. */
+export interface AgentNotFoundError {
+    readonly code: 'agent-not-found';
+    readonly message: string;
+    readonly agentId: string;
+    readonly version?: string;
+}
+/** Trying to register an agent that already exists at that (id, version). */
+export interface AgentAlreadyRegisteredError {
+    readonly code: 'agent-already-registered';
+    readonly message: string;
+    readonly agentId: string;
+    readonly version: string;
+}
+/**
+ * A caller resumed a conversation but supplied an agent version that
+ * doesn't match the conversation's opening agent. Agents evolve; a
+ * conversation must be resumed with the same agent version it started
+ * with.
+ */
+export interface AgentVersionMismatchError {
+    readonly code: 'agent-version-mismatch';
+    readonly message: string;
+    readonly conversationId: string;
+    readonly expectedVersion: string;
+    readonly actualVersion: string;
+}
+/** No conversation with the given id exists (for this tenant). */
+export interface ConversationNotFoundError {
+    readonly code: 'conversation-not-found';
+    readonly message: string;
+    readonly conversationId: string;
+}
+/** Attempted to append or otherwise mutate a closed conversation. */
+export interface ConversationClosedError {
+    readonly code: 'conversation-closed';
+    readonly message: string;
+    readonly conversationId: string;
+}
+/** `appendMessage` was called with malformed inputs (blank content, bad role, etc.). */
+export interface InvalidMessageError {
+    readonly code: 'invalid-message';
+    readonly message: string;
+    readonly reason: string;
+}
+/** Storage-layer error. Cause carries the underlying DB / IO failure. */
+export interface PersistenceError {
+    readonly code: 'persistence-error';
+    readonly message: string;
+    readonly cause: unknown;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAClB,iBAAiB,GACjB,kBAAkB,GAClB,2BAA2B,GAC3B,yBAAyB,GACzB,yBAAyB,GACzB,uBAAuB,GACvB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KAC1B,EAAE,CAAC;CACL;AAED,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,6EAA6E;AAC7E,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,kEAAkE;AAClE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wFAAwF;AACxF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB"}

package/dist/errors.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/dist/guardrails-gate.d.ts

@@ -0,0 +1,169 @@
+import type { ProviderRegistry, TenantPolicy } from '@kindgi/capabilities';
+import type { ComplianceProvider } from '@kindgi/compliance';
+import { type CheckRegistry, type EvaluationOutcome, type EvaluationResult, type Guardrail, type RunTrace } from '@kindgi/guardrails';
+import type { ProjectId, Result, RunId, TenantId } from '@kindgi/types';
+import type { Agent, ConversationId, ConversationMessage } from './types.js';
+/**
+ * Turn usage snapshot passed into `buildRunTrace`. Local mirror of
+ * `AgentTurnUsage` (handlers/result-shape.ts) — kept here to avoid a
+ * circular import.
+ */
+interface TurnUsageSnapshot {
+    readonly steps: number;
+    readonly promptTokens: number;
+    readonly completionTokens: number;
+    readonly totalCostUsd: number;
+    readonly durationMs: number;
+}
+/**
+ * Bindings the guardrail gate consumes. All optional — if `guardrails`
+ * is empty or `checks` is undefined, `evaluateGate` is a no-op. An
+ * agent that references a guardrail id missing from `guardrails` fails
+ * its turn with `unresolved-guardrail`.
+ */
+export interface GuardrailsBindings {
+    /** Full guardrail definitions available for this run. Indexed by id. */
+    readonly guardrails?: readonly Guardrail[];
+    /** Check registry with built-ins + any adapter-registered custom checks. */
+    readonly checks?: CheckRegistry;
+    /** Optional compliance sink — every failed check emits an evidence record. */
+    readonly compliance?: ComplianceProvider;
+    /**
+     * Provider registry for llm-judge guardrails; the judge model is
+     * routed through it under the turn's tenant policy. If absent,
+     * llm-judge guardrails error with `judge-missing`; if no provider
+     * satisfies the judge's capability, with `judge-routing-failed`.
+     */
+    readonly providerRegistry?: ProviderRegistry;
+}
+/**
+ * Materialize a `RunTrace` from an agent turn's captured state. The
+ * guardrail engine reads only the trace — it doesn't touch memory,
+ * kernel journal, or provenance directly (keeps checks pure and
+ * dependency-free).
+ */
+export declare function buildRunTrace(input: {
+    /** The kernel run of the turn. */
+    readonly runId: RunId;
+    readonly tenantId: TenantId;
+    /** Lets the engine record compliance evidence for a failed check. */
+    readonly projectId: ProjectId;
+    readonly conversationId: ConversationId;
+    /** 1-based number of this turn in the conversation. */
+    readonly turnNumber: number;
+    readonly agent: Agent;
+    /** The user message that started the turn. */
+    readonly userMessage: string;
+    /** The turn's structured input (`InvokeAgentInput.input`), when it has one. */
+    readonly stepInput?: unknown;
+    /** The parsed answer, when the agent declares `output`. */
+    readonly structuredOutput?: unknown;
+    readonly appended: readonly ConversationMessage[];
+    readonly finalResponse: ConversationMessage;
+    readonly usage: TurnUsageSnapshot;
+}): RunTrace;
+/**
+ * Filter the bound guardrail list to those referenced by the agent's
+ * `guardrails: string[]` declaration. Missing references are collected
+ * into `missing` — the caller decides whether that's fatal.
+ */
+export declare function resolveGuardrails(agent: Agent, bindings: GuardrailsBindings): {
+    readonly resolved: readonly Guardrail[];
+    readonly missing: readonly string[];
+};
+/**
+ * Evaluate every resolved guardrail against the turn's trace. Returns
+ * the raw outcomes so the caller can decide how to react — the gate
+ * doesn't halt on its own. `tenantPolicy` (the policy the turn was
+ * routed under) also governs which models llm-judge guardrails may use;
+ * `abortSignal` (the turn's) reaches every check, so a slow judge or
+ * pack check stops when the turn does.
+ */
+export declare function evaluateGate(guardrails: readonly Guardrail[], trace: RunTrace, bindings: GuardrailsBindings, tenantPolicy?: TenantPolicy, abortSignal?: AbortSignal): Promise<readonly EvaluationOutcome[]>;
+/**
+ * Sort evaluation outcomes by the failed guardrail's action. `halt` is
+ * blocking — the turn fails with `guardrail-violation`. `log-only` and
+ * `noop` are warnings; every other action (`retry`, `escalate`,
+ * `compensate`, or a custom action — actions are open strings) lands in
+ * `other`. Warnings and `other` are attached to the successful turn
+ * result under `result.violations`; the turn does not carry out those
+ * actions. Evaluation errors (a check that could not run) are collected
+ * in `errors`.
+ */
+export declare function categorizeOutcomes(outcomes: readonly EvaluationOutcome[]): {
+    readonly blocking: readonly EvaluationResult[];
+    readonly warnings: readonly EvaluationResult[];
+    readonly other: readonly EvaluationResult[];
+    readonly errors: readonly {
+        readonly guardrailId: string;
+        readonly message: string;
+    }[];
+};
+/**
+ * Message for a turn stopped by blocking violations — names each
+ * guardrail that fired, with its check's reason when it gave one:
+ *
+ *   Turn blocked by guardrail 'no-pii': Response contains an email address
+ *   Turn blocked by 2 guardrails: 'no-pii' (Response contains …); 'max-length'
+ */
+export declare function describeBlockingViolations(blocking: readonly EvaluationResult[]): string;
+/**
+ * Result of a session-gate check performed BEFORE running a turn:
+ * the HITL turn threshold (`conversationPolicy.hitl.afterTurns` or
+ * `conversationPolicy.hitlAfterTurns`).
+ */
+export type SessionGateResult = {
+    readonly kind: 'ok';
+} | {
+    readonly kind: 'hitl-required';
+    readonly reason: string;
+    readonly threshold: number;
+};
+/**
+ * Evaluate session-level gates against the conversation state before
+ * running the next turn: the HITL threshold from
+ * `conversationPolicy.hitl.afterTurns` or `conversationPolicy.hitlAfterTurns`.
+ *
+ * Overloaded call shapes:
+ *   - `evaluateSessionGate(agent, turnCount)` — reads the agent's policy
+ *     directly.
+ *   - `evaluateSessionGate({ afterTurns? }, turnCount)` — reads a
+ *     pre-resolved effective policy (the setup handler passes
+ *     `resolveEffectiveHitlPolicy` output).
+ */
+export declare function evaluateSessionGate(input: Agent | {
+    readonly afterTurns?: number;
+}, currentTurnCount: number): SessionGateResult;
+/** Discriminated error emitted when blocking guardrails fail. */
+export interface GuardrailViolationError {
+    readonly code: 'guardrail-violation';
+    readonly message: string;
+    readonly violations: readonly EvaluationResult[];
+    /** Errors from checks that couldn't even evaluate (missing check, bad config). */
+    readonly evaluationErrors: readonly {
+        readonly guardrailId: string;
+        readonly message: string;
+    }[];
+}
+/**
+ * Error shape for a turn blocked by the session HITL threshold.
+ * `approvalId` is set when the caller supplied a `bindings.hitl` sink and
+ * the enqueue succeeded — downstream code can poll or subscribe on that
+ * id. The agent turn itself does not return this code: it parks on a
+ * HITL waitpoint instead (`AgentTurnResult.status: 'suspended'`).
+ */
+export interface HitlRequiredError {
+    readonly code: 'hitl-required';
+    readonly message: string;
+    readonly threshold: number;
+    readonly approvalId?: string;
+}
+/** Emitted when the agent references guardrail IDs not in the registry. */
+export interface UnresolvedGuardrailError {
+    readonly code: 'unresolved-guardrail';
+    readonly message: string;
+    readonly guardrailIds: readonly string[];
+}
+export type GateResult<T, E> = Result<T, E>;
+export {};
+//# sourceMappingURL=guardrails-gate.d.ts.map

package/dist/guardrails-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails-gate.d.ts","sourceRoot":"","sources":["../src/guardrails-gate.ts"],"names":[],"mappings":"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"}

package/dist/guardrails-gate.js

@@ -0,0 +1,202 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { evaluateAll, } from '@kindgi/guardrails';
+/**
+ * Materialize a `RunTrace` from an agent turn's captured state. The
+ * guardrail engine reads only the trace — it doesn't touch memory,
+ * kernel journal, or provenance directly (keeps checks pure and
+ * dependency-free).
+ */
+export function buildRunTrace(input) {
+    const toolCalls = [];
+    const toolResults = [];
+    const modelCalls = [];
+    for (const msg of input.appended) {
+        if (msg.role === 'agent' && typeof msg.content === 'object' && msg.content !== null) {
+            const structured = msg.content;
+            if (structured.toolCalls !== undefined) {
+                for (const call of structured.toolCalls) {
+                    toolCalls.push({
+                        toolId: call.name,
+                        toolName: call.name,
+                        arguments: call.arguments,
+                        at: msg.createdAt,
+                    });
+                }
+            }
+        }
+        if (msg.role === 'tool' && msg.toolCall !== undefined) {
+            toolResults.push({
+                toolCallId: msg.toolCall.invocationId,
+                output: msg.content,
+                at: msg.createdAt,
+            });
+        }
+    }
+    // Approximate a model-call record for cost/latency guardrails — a
+    // more granular per-call breakdown would need an observability
+    // hook.
+    modelCalls.push({
+        providerId: 'runtime.picked',
+        model: 'runtime.picked',
+        promptTokens: input.usage.promptTokens,
+        completionTokens: input.usage.completionTokens,
+        at: input.finalResponse.createdAt,
+    });
+    const output = typeof input.finalResponse.content === 'string'
+        ? input.finalResponse.content
+        : JSON.stringify(input.finalResponse.content);
+    return {
+        runId: input.runId,
+        tenantId: input.tenantId,
+        projectId: input.projectId,
+        agentId: input.agent.id,
+        output,
+        toolCalls,
+        toolResults,
+        modelCalls,
+        mode: 'runtime',
+        userInput: input.userMessage,
+        conversationId: input.conversationId,
+        turnNumber: input.turnNumber,
+        totalCostUsd: input.usage.totalCostUsd,
+        durationMs: input.usage.durationMs,
+        attributes: {
+            steps: input.usage.steps,
+            ...(input.stepInput !== undefined && { stepInput: input.stepInput }),
+            ...(input.structuredOutput !== undefined && { structuredOutput: input.structuredOutput }),
+        },
+    };
+}
+/**
+ * Filter the bound guardrail list to those referenced by the agent's
+ * `guardrails: string[]` declaration. Missing references are collected
+ * into `missing` — the caller decides whether that's fatal.
+ */
+export function resolveGuardrails(agent, bindings) {
+    const available = new Map();
+    for (const inv of bindings.guardrails ?? [])
+        available.set(inv.id, inv);
+    const resolved = [];
+    const missing = [];
+    for (const id of agent.guardrails) {
+        const inv = available.get(id);
+        if (inv !== undefined)
+            resolved.push(inv);
+        else
+            missing.push(id);
+    }
+    return { resolved, missing };
+}
+/**
+ * Evaluate every resolved guardrail against the turn's trace. Returns
+ * the raw outcomes so the caller can decide how to react — the gate
+ * doesn't halt on its own. `tenantPolicy` (the policy the turn was
+ * routed under) also governs which models llm-judge guardrails may use;
+ * `abortSignal` (the turn's) reaches every check, so a slow judge or
+ * pack check stops when the turn does.
+ */
+export async function evaluateGate(guardrails, trace, bindings, tenantPolicy, abortSignal) {
+    if (guardrails.length === 0 || bindings.checks === undefined)
+        return [];
+    const evalBindings = {
+        ...(bindings.providerRegistry !== undefined && { providerRegistry: bindings.providerRegistry }),
+        ...(bindings.compliance !== undefined && { compliance: bindings.compliance }),
+        ...(tenantPolicy !== undefined && { tenantPolicy }),
+        ...(abortSignal !== undefined && { abortSignal }),
+    };
+    return await evaluateAll(guardrails, bindings.checks, trace, evalBindings);
+}
+/**
+ * Sort evaluation outcomes by the failed guardrail's action. `halt` is
+ * blocking — the turn fails with `guardrail-violation`. `log-only` and
+ * `noop` are warnings; every other action (`retry`, `escalate`,
+ * `compensate`, or a custom action — actions are open strings) lands in
+ * `other`. Warnings and `other` are attached to the successful turn
+ * result under `result.violations`; the turn does not carry out those
+ * actions. Evaluation errors (a check that could not run) are collected
+ * in `errors`.
+ */
+export function categorizeOutcomes(outcomes) {
+    const blocking = [];
+    const warnings = [];
+    const other = [];
+    const errors = [];
+    for (const outcome of outcomes) {
+        if (outcome.kind === 'err') {
+            errors.push({
+                guardrailId: 'guardrailId' in outcome.error && typeof outcome.error.guardrailId === 'string'
+                    ? outcome.error.guardrailId
+                    : '<unknown>',
+                message: outcome.error.message,
+            });
+            continue;
+        }
+        if (outcome.kind === 'skip')
+            continue;
+        const evalResult = outcome.value;
+        if (evalResult.result.passed)
+            continue;
+        if (evalResult.action === 'halt')
+            blocking.push(evalResult);
+        else if (evalResult.action === 'log-only' || evalResult.action === 'noop') {
+            warnings.push(evalResult);
+        }
+        else
+            other.push(evalResult);
+    }
+    return { blocking, warnings, other, errors };
+}
+/**
+ * Message for a turn stopped by blocking violations — names each
+ * guardrail that fired, with its check's reason when it gave one:
+ *
+ *   Turn blocked by guardrail 'no-pii': Response contains an email address
+ *   Turn blocked by 2 guardrails: 'no-pii' (Response contains …); 'max-length'
+ */
+export function describeBlockingViolations(blocking) {
+    const reasonOf = (v) => {
+        const reason = v.result.reason?.trim();
+        return reason === undefined || reason === '' ? undefined : reason;
+    };
+    const [only] = blocking;
+    if (blocking.length === 1 && only !== undefined) {
+        const reason = reasonOf(only);
+        return `Turn blocked by guardrail '${only.guardrailId}'${reason !== undefined ? `: ${reason}` : ''}`;
+    }
+    const named = blocking.map((v) => {
+        const reason = reasonOf(v);
+        return `'${v.guardrailId}'${reason !== undefined ? ` (${reason})` : ''}`;
+    });
+    return `Turn blocked by ${blocking.length} guardrails: ${named.join('; ')}`;
+}
+/**
+ * Evaluate session-level gates against the conversation state before
+ * running the next turn: the HITL threshold from
+ * `conversationPolicy.hitl.afterTurns` or `conversationPolicy.hitlAfterTurns`.
+ *
+ * Overloaded call shapes:
+ *   - `evaluateSessionGate(agent, turnCount)` — reads the agent's policy
+ *     directly.
+ *   - `evaluateSessionGate({ afterTurns? }, turnCount)` — reads a
+ *     pre-resolved effective policy (the setup handler passes
+ *     `resolveEffectiveHitlPolicy` output).
+ */
+export function evaluateSessionGate(input, currentTurnCount) {
+    const asAgent = input;
+    const asPolicy = input;
+    const threshold = 'conversationPolicy' in asAgent
+        ? (asAgent.conversationPolicy?.hitl?.afterTurns ?? asAgent.conversationPolicy?.hitlAfterTurns)
+        : asPolicy.afterTurns;
+    if (threshold !== undefined && currentTurnCount >= threshold) {
+        return {
+            kind: 'hitl-required',
+            reason: `Conversation reached HITL threshold: ${currentTurnCount} turns >= ${threshold}`,
+            threshold,
+        };
+    }
+    return { kind: 'ok' };
+}
+// Silence unused-type lint (GuardrailId is used by callers via type inference).
+void 0;
+//# sourceMappingURL=guardrails-gate.js.map

package/dist/guardrails-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails-gate.js","sourceRoot":"","sources":["../src/guardrails-gate.ts"],"names":[],"mappings":"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"}

package/dist/handlers/budget-check.d.ts

@@ -0,0 +1,22 @@
+import type { NodeHandler } from '@kindgi/handler';
+import type { TurnContext } from './context.js';
+/**
+ * Loop-body node #3. The final gate before `$loop-end`. Decides
+ * whether the iteration finalizes the turn based on:
+ *
+ *   - The model's `finishReason` (anything other than `tool-use` with
+ *     calls terminates).
+ *   - `agent.budget.maxSteps` — enforced against `ctx.usage.steps`.
+ *   - `agent.budget.maxCostUsd` — enforced against cumulative cost.
+ *   - Cooperative abort from `ctx.turnAbort`.
+ *   - `agent.output` — a final answer that isn't JSON matching the
+ *     schema keeps the turn going with a repair message, while repairs
+ *     (and steps) are left; after that the turn fails with
+ *     `output-schema-violation`. Skipped on a dry run.
+ *
+ * Returns the fully-shaped `AgentTurnIterationOutput` — this is the
+ * iteration's `$loop-end` output that the loop node's `outputSchema`
+ * validates against.
+ */
+export declare function buildBudgetCheckHandler(ctx: TurnContext): NodeHandler;
+//# sourceMappingURL=budget-check.d.ts.map

package/dist/handlers/budget-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-check.d.ts","sourceRoot":"","sources":["../../src/handlers/budget-check.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAInD,OAAO,KAAK,EAA4B,WAAW,EAAE,MAAM,cAAc,CAAC;AAU1E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CA8ErE"}

package/dist/handlers/budget-check.js

@@ -0,0 +1,109 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { DEFAULT_MAX_STEPS } from './constants.js';
+import { throwAgentTurnFailure } from './errors.js';
+import { DEFAULT_MAX_REPAIRS, outputChecker, repairMessage, repairsSoFar, } from './structured-output.js';
+/**
+ * Loop-body node #3. The final gate before `$loop-end`. Decides
+ * whether the iteration finalizes the turn based on:
+ *
+ *   - The model's `finishReason` (anything other than `tool-use` with
+ *     calls terminates).
+ *   - `agent.budget.maxSteps` — enforced against `ctx.usage.steps`.
+ *   - `agent.budget.maxCostUsd` — enforced against cumulative cost.
+ *   - Cooperative abort from `ctx.turnAbort`.
+ *   - `agent.output` — a final answer that isn't JSON matching the
+ *     schema keeps the turn going with a repair message, while repairs
+ *     (and steps) are left; after that the turn fails with
+ *     `output-schema-violation`. Skipped on a dry run.
+ *
+ * Returns the fully-shaped `AgentTurnIterationOutput` — this is the
+ * iteration's `$loop-end` output that the loop node's `outputSchema`
+ * validates against.
+ */
+export function buildBudgetCheckHandler(ctx) {
+    let checker;
+    return async (input, kctx) => {
+        if (ctx.turnAbort.signal.aborted) {
+            throwAgentTurnFailure({
+                code: 'agent-turn-aborted',
+                message: 'Agent turn aborted before budget-check',
+                reason: ctx.abortReason ?? 'timeout',
+            });
+        }
+        const partial = input;
+        const maxSteps = ctx.input.agent.budget?.maxSteps ?? DEFAULT_MAX_STEPS;
+        const maxCostUsd = ctx.input.agent.budget?.maxCostUsd;
+        // Cost cap is a hard failure — the caller sees `budget-exceeded`
+        // before the turn tries another iteration.
+        if (maxCostUsd !== undefined && ctx.usage.totalCostUsd > maxCostUsd) {
+            throwAgentTurnFailure({
+                code: 'budget-exceeded',
+                message: `Agent turn cost budget exceeded (limit ${maxCostUsd}, observed ${ctx.usage.totalCostUsd})`,
+                kind: 'cost',
+                limit: maxCostUsd,
+                observed: ctx.usage.totalCostUsd,
+            });
+        }
+        // Step cap — if the model still wants another tool call but we've
+        // used the allotted steps, fail the run.
+        if (partial.hasToolCalls && ctx.usage.steps >= maxSteps) {
+            throwAgentTurnFailure({
+                code: 'budget-exceeded',
+                message: `Agent turn steps budget exceeded (limit ${maxSteps}, observed ${ctx.usage.steps})`,
+                kind: 'steps',
+                limit: maxSteps,
+                observed: ctx.usage.steps,
+            });
+        }
+        // `finishedTurn` semantics: true when the model's finishReason is
+        // terminal (i.e. not a live tool-use) — the current iteration's
+        // assistant message is the final answer.
+        let finishedTurn = !partial.hasToolCalls;
+        let nextMessages = partial.nextMessages;
+        const spec = ctx.input.agent.output;
+        if (finishedTurn && spec !== undefined && !kctx.dryRun) {
+            checker ??= outputChecker(spec);
+            const repair = outputRepair(spec, checker, partial.message, partial.nextMessages, {
+                stepsLeft: ctx.usage.steps < maxSteps,
+            });
+            if (repair !== undefined) {
+                finishedTurn = false;
+                nextMessages = repair;
+            }
+        }
+        const output = {
+            finishReason: partial.finishReason,
+            message: partial.message,
+            iterationAppended: partial.iterationAppended,
+            iterationUsage: partial.iterationUsage,
+            provider: partial.provider,
+            finishedTurn,
+            nextMessages,
+        };
+        return output;
+    };
+}
+/**
+ * Check a final answer against the agent's output schema. A valid
+ * answer returns `undefined` (the turn finishes). An invalid one with
+ * repairs and steps left returns the next model call's messages: the
+ * answer, then a repair message listing what's wrong. Otherwise the
+ * turn fails with `output-schema-violation`.
+ */
+function outputRepair(spec, checker, answer, sent, budget) {
+    const checked = checker.check(answer.content);
+    if (checked.kind === 'ok')
+        return undefined;
+    const repairs = repairsSoFar(sent);
+    if (repairs < (spec.maxRepairs ?? DEFAULT_MAX_REPAIRS) && budget.stepsLeft) {
+        return [...sent, answer, repairMessage(spec, checked.errors)];
+    }
+    throwAgentTurnFailure({
+        code: 'output-schema-violation',
+        message: `The agent's answer does not match its ${spec.name ?? 'output'} schema after ${repairs} repair${repairs === 1 ? '' : 's'}: ${checked.errors.join('; ')}`,
+        errors: checked.errors,
+        attempts: repairs + 1,
+    });
+}
+//# sourceMappingURL=budget-check.js.map

package/dist/handlers/budget-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-check.js","sourceRoot":"","sources":["../../src/handlers/budget-check.ts"],"names":[],"mappings":"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"}