agentenkit 0.1.0

package/dist/core/loop.d.ts.map

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

package/dist/core/loop.js

@@ -0,0 +1,234 @@
+import { generateText, streamText } from 'ai';
+import { systemCacheMessage } from './cache.js';
+import { attributeTokens } from './usage.js';
+import { drainOrThrow } from './stream.js';
+import { publish, publishNotice } from './publish.js';
+import { HITL_PARKED } from './hitl.js';
+/** True for the sentinel a parked `requiresConfirmation` tool returns (§2.5).
+ *  It is never a real tool result and is never persisted. */
+export const isParked = (result) => typeof result === 'object' &&
+    result !== null &&
+    result[HITL_PARKED] !== undefined;
+export async function executeStep(agent, call) {
+    // Ownership rule (§3.1): user args spread FIRST, platform keys LAST. The
+    // user's stream callbacks are stripped here and re-chained by the platform
+    // (onChunk below, onFinish at finalize) so the SDK can never own them.
+    const { onChunk: _userOnChunk, onFinish: _userOnFinish, onStepFinish: userOnStepFinish, system: specSystem, ...userArgs } = agent.args;
+    // A nested run brings its own persona and must not inherit the parent's.
+    const system = call.system ?? specSystem;
+    const hoistSystem = call.cacheSystemPrompt === true && typeof system === 'string' && system.length > 0;
+    const shared = {
+        ...userArgs,
+        model: call.model,
+        // Hoisted, the system prompt leads the messages and carries the
+        // breakpoint; a fresh array each step leaves the loop's own array alone.
+        messages: hoistSystem ? [systemCacheMessage(system), ...call.messages] : call.messages,
+        tools: call.tools,
+        abortSignal: call.abortSignal,
+        maxSteps: 1, // the loop owns continuation
+        ...(hoistSystem || system === undefined ? {} : { system }),
+        // Provider-specific options (§3.1): forwarded under both the v5-native
+        // key and the v4 alias.
+        ...(call.providerOptions
+            ? {
+                providerOptions: call.providerOptions,
+                experimental_providerMetadata: call.providerOptions,
+            }
+            : {}),
+        ...(call.onChunk
+            ? { onChunk: async ({ chunk }) => { await call.onChunk(chunk); } }
+            : {}),
+        ...(userOnStepFinish
+            ? { onStepFinish: (step) => userOnStepFinish?.(step) } // user callback still fires
+            : {}),
+    };
+    if (call.kind === 'stream-text') {
+        const result = streamText(shared);
+        // streamText is lazy: drain the full stream so onChunk fires per part, and
+        // let a provider failure throw here rather than hanging on promises that
+        // never settle (see drainOrThrow).
+        await drainOrThrow(result.fullStream);
+        const [text, usage, finishReason, response, steps, meta] = await Promise.all([
+            result.text,
+            result.usage,
+            result.finishReason,
+            result.response,
+            result.steps,
+            // v4 exposes it under the experimental name; v5 drops the prefix.
+            result.providerMetadata ?? result.experimental_providerMetadata,
+        ]);
+        return {
+            text,
+            finishReason,
+            usage: usage,
+            responseMessages: (response?.messages ?? []),
+            toolResults: (steps?.at(-1)?.toolResults ?? []),
+            providerMetadata: meta,
+        };
+    }
+    const result = await generateText(shared);
+    return {
+        text: result.text,
+        finishReason: result.finishReason,
+        usage: result.usage,
+        responseMessages: (result.response?.messages ?? []),
+        toolResults: (result.steps?.at(-1)?.toolResults ?? []),
+        providerMetadata: (result.providerMetadata ??
+            result.experimental_providerMetadata),
+    };
+}
+/** Keep a recorded value small: one oversized tool result should not be able
+ *  to bloat the operational store (§2.9). Structured values are truncated by
+ *  their serialised form so the shape stays readable. */
+const cap = (text, limit) => !text ? null : text.length > limit ? `${text.slice(0, limit)}…` : text;
+function capValue(value, limit) {
+    if (value === undefined)
+        return null;
+    if (typeof value === 'string')
+        return cap(value, limit);
+    const json = JSON.stringify(value) ?? 'null';
+    return json.length <= limit ? value : `${json.slice(0, limit)}…`;
+}
+/** The platform-owned loop (§2.1, §5.6), run by the main agent and by every
+ *  nested run alike (§2.7).
+ *
+ *  One single-round-trip step per iteration. After EVERY step the produced
+ *  messages are persisted under this loop's `agentId`, so a worker that dies
+ *  mid-run resumes from the last step — and so a parked nested run can be
+ *  re-entered later instead of restarted. Every continuation decision — tool
+ *  results ready, budget spent, step ceiling, HITL park, user stop — is made
+ *  here between steps, never inside the SDK. */
+export async function runLoop(deps, agent, threadId, input, ledger) {
+    const attribution = {
+        inputTokens: 0,
+        cachedInputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+    };
+    let tokensUsed = 0;
+    let lastText = '';
+    let lastFinishReason = '';
+    let parked = false;
+    let parkedToolCallId;
+    let stepsLeft = input.maxSteps;
+    let stepsRun = 0;
+    while (stepsLeft > 0 && !input.abortSignal.aborted) {
+        stepsLeft--;
+        const stepStartedAt = Date.now();
+        let step;
+        try {
+            step = await executeStep(agent, {
+                kind: input.kind,
+                model: input.model,
+                messages: input.messages,
+                tools: input.tools,
+                providerOptions: input.providerOptions,
+                abortSignal: input.abortSignal,
+                onChunk: input.kind === 'stream-text' ? input.onChunk : undefined,
+                system: input.system,
+                cacheSystemPrompt: input.cacheSystemPrompt,
+            });
+        }
+        catch (err) {
+            if (input.abortSignal.aborted)
+                break; // user stop mid-step
+            throw err; // real failure → §2.8 redrive policy
+        }
+        // Per-step durability (§5.6): append this step's turns BEFORE the next
+        // step. A parked HITL tool result (the sentinel) is NOT a real result —
+        // it is skipped here; the resumed segment appends the user's verdict.
+        const persisted = step.responseMessages.filter((m) => {
+            if (m.role !== 'tool')
+                return true;
+            const parts = Array.isArray(m.content) ? m.content : [];
+            return !parts.some((p) => isParked(p?.result));
+        });
+        for (const m of persisted) {
+            await deps.storage.messages.append(threadId, {
+                role: m.role,
+                content: m.content,
+                agentId: input.agentId,
+            });
+        }
+        input.messages.push(...step.responseMessages);
+        // A replay boundary (§2.2). Everything this step produced is now durable
+        // history, so a reconnecting client must NOT also replay its chunks — it
+        // would render the same text twice, once from the message and once from
+        // the stream that produced it. Persisted (not a bus notice) because the
+        // snapshot needs its seq to know where durable ends and live begins.
+        await publish(deps, threadId, 'STEP_COMMITTED', {
+            index: stepsRun,
+            agentId: input.agentId,
+        });
+        // Token attribution (§4), accumulated across the segment's steps — and
+        // into the run-wide ledger the safety cap is checked against (§2.7).
+        const a = attributeTokens(step.usage, step.providerMetadata);
+        attribution.inputTokens += a.inputTokens;
+        attribution.cachedInputTokens += a.cachedInputTokens;
+        attribution.outputTokens += a.outputTokens;
+        attribution.totalTokens += a.totalTokens;
+        tokensUsed += a.totalTokens;
+        ledger.tokensUsed += a.totalTokens;
+        lastText = step.text ?? '';
+        lastFinishReason = step.finishReason;
+        stepsRun += 1;
+        // §2.9: one row per step in the platform's OWN store, plus a bus-only
+        // notice so live dashboards see it. The notice is not persisted to the
+        // caller's event log — operational history is not their data to carry.
+        const marker = {
+            runId: input.runId ?? '',
+            threadId,
+            agentId: input.agentId,
+            index: stepsRun,
+            durationMs: Date.now() - stepStartedAt,
+            finishReason: step.finishReason,
+            inputTokens: a.inputTokens,
+            cachedInputTokens: a.cachedInputTokens,
+            outputTokens: a.outputTokens,
+            totalTokens: a.totalTokens,
+            tools: (step.toolResults ?? [])
+                .map((r) => r?.toolName)
+                .filter(Boolean),
+            ...(deps.config.recordPayloads
+                ? {
+                    text: cap(step.text, deps.config.payloadCapChars),
+                    toolCalls: (step.toolResults ?? []).map((r) => ({
+                        toolName: r?.toolName,
+                        args: capValue(r?.args, deps.config.payloadCapChars),
+                        result: capValue(r?.result, deps.config.payloadCapChars),
+                    })),
+                }
+                : {}),
+        };
+        if (input.runId)
+            await deps.admin.steps.record(marker);
+        await publishNotice(deps, threadId, 'STEP_FINISHED', marker);
+        // §2.5 park: a requiresConfirmation tool returned the sentinel — the
+        // segment ends here on WAITING_FOR_INPUT (set by parkForApproval).
+        const parkedResult = (step.toolResults ?? []).find((r) => isParked(r?.result));
+        if (parkedResult) {
+            parked = true;
+            parkedToolCallId = parkedResult.result[HITL_PARKED];
+            break;
+        }
+        // Budget check BETWEEN steps (§2.1) — the step that crossed the line is
+        // kept in full; the next one never starts.
+        if (input.tokenBudget && ledger.tokensUsed >= input.tokenBudget)
+            break;
+        // 'tool-calls' → the SDK executed the step's tools; the loop feeds the
+        // results back. Anything else ('stop', 'length', …) ends the run.
+        if (step.finishReason !== 'tool-calls')
+            break;
+    }
+    return {
+        text: lastText,
+        finishReason: lastFinishReason,
+        attribution,
+        tokensUsed,
+        parked,
+        parkedToolCallId,
+        aborted: input.abortSignal.aborted,
+        steps: stepsRun,
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/core/loop.js.map

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

package/dist/core/publish.d.ts

@@ -0,0 +1,18 @@
+import type { RuntimePorts } from '../ports/runtime.js';
+import type { ExecutionState } from './types.js';
+import type { AgentEvent } from './types.js';
+/** Persist to the replayable event log, then fan out live to all subscribers
+ *  (§2.2). Seq comes from Kv.incr — monotonic per thread (§3.4). */
+export declare function publish(deps: RuntimePorts, threadId: string, type: string, payload: unknown): Promise<AgentEvent>;
+/** Publish a bus-only notice (never persisted) — e.g. HITL death notices (§2.5). */
+export declare function publishNotice(deps: RuntimePorts, threadId: string, type: string, payload: unknown): Promise<void>;
+/** Move a thread to a new state on BOTH the caller's storage and the
+ *  platform's own operational view (§2.9).
+ *
+ *  One choke point on purpose: the admin thread table is what lets a dashboard
+ *  answer "what is running right now" without reading the caller's database,
+ *  and it is only true if every transition passes through here. `model` is
+ *  looked up when not supplied, so callers that already hold the thread can
+ *  skip a read. */
+export declare function setThreadState(deps: RuntimePorts, threadId: string, state: ExecutionState, model?: string): Promise<void>;
+//# sourceMappingURL=publish.d.ts.map

package/dist/core/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/core/publish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;oEACoE;AACpE,wBAAsB,OAAO,CAC3B,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED,oFAAoF;AACpF,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;;;;;;mBAOmB;AACnB,wBAAsB,cAAc,CAClC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/core/publish.js

@@ -0,0 +1,34 @@
+/** Persist to the replayable event log, then fan out live to all subscribers
+ *  (§2.2). Seq comes from Kv.incr — monotonic per thread (§3.4). */
+export async function publish(deps, threadId, type, payload) {
+    const seq = await deps.kv.incr(`agent:seq:${threadId}`);
+    const event = { threadId, seq, type, payload, createdAt: new Date() };
+    await deps.storage.events.append(threadId, event);
+    await deps.bus.publish(threadId, event);
+    return event;
+}
+/** Publish a bus-only notice (never persisted) — e.g. HITL death notices (§2.5). */
+export async function publishNotice(deps, threadId, type, payload) {
+    await deps.bus.publish(threadId, {
+        threadId, seq: 0, type, payload, createdAt: new Date(),
+    });
+}
+/** Move a thread to a new state on BOTH the caller's storage and the
+ *  platform's own operational view (§2.9).
+ *
+ *  One choke point on purpose: the admin thread table is what lets a dashboard
+ *  answer "what is running right now" without reading the caller's database,
+ *  and it is only true if every transition passes through here. `model` is
+ *  looked up when not supplied, so callers that already hold the thread can
+ *  skip a read. */
+export async function setThreadState(deps, threadId, state, model) {
+    await deps.storage.threads.setState(threadId, state);
+    try {
+        const resolved = model ?? (await deps.storage.threads.get(threadId))?.model ?? 'unknown';
+        await deps.admin.threads.upsert({ id: threadId, state, model: resolved });
+    }
+    catch {
+        // Observability must never be able to fail a transition that succeeded.
+    }
+}
+//# sourceMappingURL=publish.js.map

package/dist/core/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/core/publish.ts"],"names":[],"mappings":"AAIA;oEACoE;AACpE,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAkB,EAClB,QAAgB,EAChB,IAAY,EACZ,OAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;IACxD,MAAM,KAAK,GAAe,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;IAClF,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAkB,EAClB,QAAgB,EAChB,IAAY,EACZ,OAAgB;IAEhB,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE;KACzC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;mBAOmB;AACnB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAkB,EAClB,QAAgB,EAChB,KAAqB,EACrB,KAAc;IAEd,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,IAAI,SAAS,CAAC;QACzF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;AACH,CAAC"}

package/dist/core/reclaim.d.ts

@@ -0,0 +1,20 @@
+import type { RuntimePorts } from '../ports/runtime.js';
+export declare function reclaimGraceAfterMs(deps: RuntimePorts): number;
+/** §2.5 orphan reclamation, the FALLBACK path.
+ *
+ *  A park schedules its own expiry on the queue (see parkForApproval), so the
+ *  deadline holds whether or not anyone is watching. This covers what a timer
+ *  cannot: threads parked before that existed, and queue adapters that drop a
+ *  delay. Callers are first-touch checks in run() and respond(), plus any
+ *  listener that wants the denial to land live in front of a user.
+ *
+ *  It no longer heals inline. It re-dispatches the run and lets the engine
+ *  resolve the park, so there is exactly ONE definition of what an expired
+ *  approval becomes — and so a thread holding several open approvals (§2.7)
+ *  is resolved as a set rather than one request at a time. Re-dispatching the
+ *  same run twice is safe: the run lock and the engine's readiness check make
+ *  the duplicate a no-op (§2.8).
+ *
+ *  Returns true iff a re-dispatch was enqueued. */
+export declare function reclaimIfOrphaned(deps: RuntimePorts, threadId: string): Promise<boolean>;
+//# sourceMappingURL=reclaim.d.ts.map

package/dist/core/reclaim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reclaim.d.ts","sourceRoot":"","sources":["../../src/core/reclaim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE9D;AAED;;;;;;;;;;;;;;;mDAemD;AACnD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgC9F"}

package/dist/core/reclaim.js

@@ -0,0 +1,56 @@
+import { currentRunId } from './keys.js';
+import { loadOpenHitls } from './hitl.js';
+// Small grace so an in-flight /respond delivery always lands first —
+// reclamation only ever sees true orphans.
+export function reclaimGraceAfterMs(deps) {
+    return deps.config.hitlTtlMs + deps.config.reclaimGraceMs;
+}
+/** §2.5 orphan reclamation, the FALLBACK path.
+ *
+ *  A park schedules its own expiry on the queue (see parkForApproval), so the
+ *  deadline holds whether or not anyone is watching. This covers what a timer
+ *  cannot: threads parked before that existed, and queue adapters that drop a
+ *  delay. Callers are first-touch checks in run() and respond(), plus any
+ *  listener that wants the denial to land live in front of a user.
+ *
+ *  It no longer heals inline. It re-dispatches the run and lets the engine
+ *  resolve the park, so there is exactly ONE definition of what an expired
+ *  approval becomes — and so a thread holding several open approvals (§2.7)
+ *  is resolved as a set rather than one request at a time. Re-dispatching the
+ *  same run twice is safe: the run lock and the engine's readiness check make
+ *  the duplicate a no-op (§2.8).
+ *
+ *  Returns true iff a re-dispatch was enqueued. */
+export async function reclaimIfOrphaned(deps, threadId) {
+    const thread = await deps.storage.threads.get(threadId);
+    if (thread?.state !== 'WAITING_FOR_INPUT')
+        return false;
+    const open = await loadOpenHitls(deps, threadId);
+    if (open.length === 0)
+        return false;
+    // Every open request must be past its window. One that is still answerable
+    // would make the resumed segment a no-op anyway (§2.7).
+    const deadline = reclaimGraceAfterMs(deps);
+    if (!open.every((p) => Date.now() - p.requestedAt >= deadline))
+        return false;
+    // Rebuild the original dispatch from the ticket persisted in the event
+    // payload; a legacy park without one falls back to the default handle.
+    const requested = await deps.storage.events.listByType(threadId, 'INPUT_REQUIRED');
+    const resume = requested.at(-1)?.payload?.resume;
+    await deps.queue.enqueue({
+        threadId,
+        // Resuming a parked run REUSES its id — it is the same run continuing,
+        // and the park's own expiry job must stay a duplicate of this one (§2.1).
+        runId: await currentRunId(deps, threadId),
+        model: resume?.model ?? thread.model,
+        ...(resume
+            ? {
+                agent: resume.agent,
+                ...(resume.tokenBudget !== undefined ? { tokenBudget: resume.tokenBudget } : {}),
+                ...(resume.providerOptions ? { providerOptions: resume.providerOptions } : {}),
+            }
+            : {}),
+    });
+    return true;
+}
+//# sourceMappingURL=reclaim.js.map

package/dist/core/reclaim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reclaim.js","sourceRoot":"","sources":["../../src/core/reclaim.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,qEAAqE;AACrE,2CAA2C;AAC3C,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;mDAemD;AACnD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAkB,EAAE,QAAgB;IAC1E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,MAAM,EAAE,KAAK,KAAK,mBAAmB;QAAE,OAAO,KAAK,CAAC;IAExD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpC,2EAA2E;IAC3E,wDAAwD;IACxD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,WAAW,IAAI,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7E,uEAAuE;IACvE,uEAAuE;IACvE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACnF,MAAM,MAAM,GAAI,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAA0C,EAAE,MAAM,CAAC;IAErF,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QACvB,QAAQ;QACR,uEAAuE;QACvE,0EAA0E;QAC1E,KAAK,EAAE,MAAM,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC;QACzC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,KAAK;QACpC,GAAG,CAAC,MAAM;YACR,CAAC,CAAC;gBACE,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChF,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/run.d.ts

@@ -0,0 +1,8 @@
+import type { RuntimePorts, RunInput, RunResult } from '../ports/runtime.js';
+import type { RegisteredAgent } from './agent.js';
+/** The §5.1 behavior: heal orphans → billing pre-check (§4) → persist the user
+ *  message → state RUNNING (hot + durable) → enqueue on the dispatch queue
+ *  (§2.8). Accepts no execution responsibility whatsoever — the queue does
+ *  the rest, and the job dispatches back to THIS handle. */
+export declare function run(deps: RuntimePorts, agent: RegisteredAgent, input: RunInput): Promise<RunResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/core/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/core/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKlD;;;4DAG4D;AAC5D,wBAAsB,GAAG,CACvB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,SAAS,CAAC,CAyGpB"}

package/dist/core/run.js

@@ -0,0 +1,102 @@
+import { reclaimIfOrphaned } from './reclaim.js';
+import { claimRun } from './keys.js';
+import { publish, setThreadState } from './publish.js';
+/** The §5.1 behavior: heal orphans → billing pre-check (§4) → persist the user
+ *  message → state RUNNING (hot + durable) → enqueue on the dispatch queue
+ *  (§2.8). Accepts no execution responsibility whatsoever — the queue does
+ *  the rest, and the job dispatches back to THIS handle. */
+export async function run(deps, agent, input) {
+    // Model resolution order (§3.1): run input → spec default → 'gpt-4o'
+    const model = input.model ?? agent.spec.model ?? 'gpt-4o';
+    let threadId = input.threadId;
+    if (!threadId) {
+        const created = await deps.storage.threads.create({ model });
+        threadId = created.id;
+    }
+    // Heal an orphaned HITL wait first (§2.5)
+    await reclaimIfOrphaned(deps, threadId);
+    const state = await deps.kv.get(`agent:state:${threadId}`);
+    if (state === 'RUNNING' || state === 'WAITING_FOR_INPUT') {
+        return { accepted: false, threadId, error: 'Thread has an active run' };
+    }
+    // Billing pre-execution check (§4) — user-injected hook
+    if (deps.config.billingPreCheck) {
+        const check = await deps.config.billingPreCheck(threadId);
+        if (!check.ok) {
+            return { accepted: false, threadId, error: check.error ?? 'Billing check failed' };
+        }
+    }
+    // Edit + resend (§5.1): the edited turn and everything it led to are
+    // dropped, then the new text is appended in its place — one thread, no
+    // forking. Only a user turn may be edited: cutting from anywhere else can
+    // strip a tool result off the assistant tool-call that produced it, and a
+    // dangling call is a conversation no provider accepts.
+    if (input.editMessageId) {
+        // Only the main agent's turns are editable — a nested run's stream is
+        // never addressed from the outside (§2.7)
+        const history = await deps.storage.messages.list(threadId, { agentId: null });
+        const target = history.find((m) => m.id === input.editMessageId);
+        if (!target)
+            return { accepted: false, threadId, error: 'Message not found' };
+        if (target.role !== 'user') {
+            return { accepted: false, threadId, error: 'Only a user message can be edited' };
+        }
+        await deps.storage.messages.deleteFrom(threadId, input.editMessageId);
+        // Other clients are showing turns that no longer exist (§2.2). The tab
+        // that made the edit truncated its own view; every other one needs telling.
+        await publish(deps, threadId, 'MESSAGES_DROPPED', { fromMessageId: input.editMessageId });
+    }
+    const userMessage = await deps.storage.messages.append(threadId, {
+        role: 'user',
+        content: input.prompt,
+    });
+    // The user's turn goes on the bus like everything else (§2.2). Without it a
+    // second client watching the same thread sees the reply stream in with no
+    // question in front of it — the sending tab had only ever added the message
+    // to its own local state.
+    await publish(deps, threadId, 'MESSAGE_APPENDED', {
+        id: userMessage.id,
+        role: userMessage.role,
+        content: userMessage.content,
+        agentId: userMessage.agentId,
+        createdAt: userMessage.createdAt,
+    });
+    // Claim the thread for THIS run before the state key is touched (§2.1). The
+    // next line overwrites whatever stop() may have just written, so the run id
+    // — not the state key — is what retires a worker still running the previous
+    // message.
+    const runId = await claimRun(deps, threadId);
+    await deps.kv.set(`agent:state:${threadId}`, 'RUNNING');
+    await setThreadState(deps, threadId, 'RUNNING', model);
+    // A durable run boundary lets reconnecting clients distinguish this turn's
+    // in-flight chunks from earlier completed turns.
+    await publish(deps, threadId, 'STATE_CHANGE', { state: 'RUNNING' });
+    // The run's durable record opens here (§2.9): a thread accumulates many runs
+    // and Thread.state only ever describes the latest, so this is the only place
+    // "what happened, how long, what did it cost" can be answered from.
+    await deps.admin.runs.start({
+        id: runId, threadId, agent: agent.name, model,
+        // What this run was asked to do (§2.9) — without it a dashboard can show
+        // that a run was slow but not what it was slow at.
+        ...(deps.config.recordPayloads
+            ? {
+                prompt: input.prompt.length > deps.config.payloadCapChars
+                    ? `${input.prompt.slice(0, deps.config.payloadCapChars)}…`
+                    : input.prompt,
+                tokenBudget: input.tokenBudget ?? null,
+                runState: input.state ?? null,
+            }
+            : {}),
+    });
+    await deps.queue.enqueue({
+        threadId, runId, model, agent: agent.name,
+        enqueuedAt: Date.now(),
+        // Persisted on the ticket so a worker — or a resume after an approval,
+        // hours later, in another process — rehydrates the same state (§2.10).
+        ...(input.state ? { state: input.state } : {}),
+        tokenBudget: input.tokenBudget,
+        providerOptions: input.providerOptions,
+    });
+    return { accepted: true, threadId, runId, state: 'RUNNING' };
+}
+//# sourceMappingURL=run.js.map

package/dist/core/run.js.map

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

package/dist/core/state.d.ts

@@ -0,0 +1,50 @@
+import type { Storage } from '../ports/storage.js';
+/** Whatever a caller needs carried through a run: tenant, user, request id,
+ *  feature flags (§2.10). The platform never reads it — it only guarantees
+ *  that everything acting on behalf of a run can see it.
+ *
+ *  Augment it to type your own fields:
+ *
+ * ```ts
+ * declare module 'agentenkit' {
+ *   interface AgentRunState { orgId: string; userId: string }
+ * }
+ * ```
+ *
+ *  Declaration merging rather than a `<TState>` type parameter, which would
+ *  otherwise have to appear on Storage, AgentCore, AgentHandle, every tool and
+ *  every subagent before it reached the one place it is read. */
+export interface AgentRunState {
+    [key: string]: unknown;
+}
+/** Passed to every domain storage call so an implementation can scope a query,
+ *  stamp a row, or route to a tenant's database (§2.10). */
+export interface StorageContext {
+    state: AgentRunState;
+    /** The run this call serves. Absent for reads outside a run — a thread
+     *  listing, for instance. */
+    runId?: string;
+}
+/** Strips the trailing StorageContext from every method of T. */
+type Bound<T> = {
+    [K in keyof T]: T[K] extends (...args: [...infer A, StorageContext]) => infer R ? (...args: A) => R : T[K] extends object ? Bound<T[K]> : T[K];
+};
+/** The Storage shape core works against: the caller's implementation with this
+ *  run's context already attached. */
+export type BoundStorage = Bound<Storage>;
+/** Attach a run's context to every storage method once, so core keeps calling
+ *  `storage.messages.append(threadId, msg)` and the implementation still
+ *  receives the state (§2.10). Threading a parameter through every call site
+ *  in the engine instead would put the plumbing in ~60 places and make it
+ *  possible to forget it in one. */
+export declare function bindStorage(storage: Storage, ctx: StorageContext): BoundStorage;
+/** Give every tool the run's state alongside the SDK's own options (§2.10).
+ *
+ *  The AI SDK calls `execute(args, { toolCallId, abortSignal, … })`; this adds
+ *  `state` to that second argument, so a tool reads it exactly where it already
+ *  reads its tool-call id. Applied to the whole toolset, not just the marked
+ *  ones — a tool that does not need approval still needs to know which tenant
+ *  it is acting for. */
+export declare function withRunState(tools: Record<string, any>, state: AgentRunState): Record<string, any>;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/core/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;;;;;;;iEAciE;AACjE,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;4DAC4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB;iCAC6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,KAAK,KAAK,CAAC,CAAC,IAAI;KACb,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,cAAc,CAAC,KAAK,MAAM,CAAC,GAC3E,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACX,CAAC,CAAC,CAAC,CAAC;CACX,CAAC;AAEF;sCACsC;AACtC,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AAE1C;;;;oCAIoC;AACpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,YAAY,CAc/E;AAED;;;;;;wBAMwB;AACxB,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,KAAK,EAAE,aAAa,GACnB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASrB"}

package/dist/core/state.js

@@ -0,0 +1,39 @@
+/** Attach a run's context to every storage method once, so core keeps calling
+ *  `storage.messages.append(threadId, msg)` and the implementation still
+ *  receives the state (§2.10). Threading a parameter through every call site
+ *  in the engine instead would put the plumbing in ~60 places and make it
+ *  possible to forget it in one. */
+export function bindStorage(storage, ctx) {
+    const out = {};
+    for (const [group, methods] of Object.entries(storage)) {
+        if (!methods || typeof methods !== 'object')
+            continue;
+        const bound = {};
+        for (const [name, fn] of Object.entries(methods)) {
+            bound[name] =
+                typeof fn === 'function'
+                    ? (...args) => fn.call(methods, ...args, ctx)
+                    : fn;
+        }
+        out[group] = bound;
+    }
+    return out;
+}
+/** Give every tool the run's state alongside the SDK's own options (§2.10).
+ *
+ *  The AI SDK calls `execute(args, { toolCallId, abortSignal, … })`; this adds
+ *  `state` to that second argument, so a tool reads it exactly where it already
+ *  reads its tool-call id. Applied to the whole toolset, not just the marked
+ *  ones — a tool that does not need approval still needs to know which tenant
+ *  it is acting for. */
+export function withRunState(tools, state) {
+    const out = {};
+    for (const [name, t] of Object.entries(tools)) {
+        out[name] =
+            typeof t?.execute === 'function'
+                ? { ...t, execute: (args, opts) => t.execute(args, { ...opts, state }) }
+                : t;
+    }
+    return out;
+}
+//# sourceMappingURL=state.js.map

package/dist/core/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/core/state.ts"],"names":[],"mappings":"AA2CA;;;;oCAIoC;AACpC,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE,GAAmB;IAC/D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,SAAS;QACtD,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,KAAK,UAAU;oBACtB,CAAC,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE,CAAE,EAAe,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC;oBACtE,CAAC,CAAC,EAAE,CAAC;QACX,CAAC;QACD,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,GAAmB,CAAC;AAC7B,CAAC;AAED;;;;;;wBAMwB;AACxB,MAAM,UAAU,YAAY,CAC1B,KAA0B,EAC1B,KAAoB;IAEpB,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC;YACP,OAAO,CAAC,EAAE,OAAO,KAAK,UAAU;gBAC9B,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,IAAa,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE;gBACzF,CAAC,CAAC,CAAC,CAAC;IACV,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}