@sixb/core 0.1.20 → 0.1.22

package/dist/agents/approvals.d.ts

@@ -0,0 +1,210 @@
+import { type Principal } from "../auth";
+import type { Broker } from "../broker";
+import type { AgentApprovalCall, AgentApprovalMode, AgentApprovalRecord, AgentRunRecord, AgentStorage } from "../storage/agents";
+import type { AgentApprovalDecider, AgentApprovalExecutor } from "./approval-executor";
+import type { AgentApprovalCallSummary, AgentApprovalOutcomePart } from "./message";
+/** How long a held call waits for its requester. */
+export declare const AGENT_APPROVAL_TTL_MS: number;
+/** What a call does, as far as approval modes tell calls apart. */
+export type AgentApprovalCallEffect = {
+    readonly kind: "action";
+    readonly effect: "ontology" | "external";
+} | {
+    readonly kind: "workflow";
+};
+/**
+ * Where a user's mode in a thread comes from: their choice there, their default, or neither. A
+ * sub-agent's thread has no mode of its own to choose: `run`, its latest run's, copied from the turn
+ * it works under.
+ */
+export type AgentApprovalModeSource = "thread" | "default" | "fallback" | "run";
+export interface ResolvedAgentApprovalMode {
+    readonly approvalMode: AgentApprovalMode;
+    readonly approvalModeSource: AgentApprovalModeSource;
+}
+/** Whether a turn with this mode runs the call without asking. */
+export declare function approvalModeAllows(mode: AgentApprovalMode, call: AgentApprovalCallEffect): boolean;
+/** The least the requester has to allow for this call to run without asking. */
+export declare function leastApprovalModeAllowing(call: AgentApprovalCallEffect): AgentApprovalMode;
+/** A mode a caller asked for, refused as a request error when it is not one. */
+export declare function assertAgentApprovalMode(value: unknown): AgentApprovalMode;
+/** A user's mode in a thread: their choice there, then their default, then the fallback. */
+export declare function resolveAgentApprovalMode(agents: AgentStorage, input: {
+    readonly projectId: string;
+    readonly principal: Principal;
+    /** Omitted for a thread the turn creates. */
+    readonly threadId?: string;
+}): Promise<ResolvedAgentApprovalMode>;
+/** The requester's default, or the fallback when they chose none. */
+export declare function defaultAgentApprovalMode(agents: AgentStorage, input: {
+    readonly projectId: string;
+    readonly principal: Principal;
+}): Promise<ResolvedAgentApprovalMode>;
+/** The mode a run's calls are held by. A run admitted before approval modes has none: `auto`. */
+export declare function agentRunApprovalMode(run: AgentRunRecord): AgentApprovalMode;
+/** What became of a call the Agent made through the gateway. */
+export type AgentApprovalHold = 
+/** The run's mode lets it run, or its requester approved it already. */
+{
+    readonly kind: "pass";
+}
+/** It waits for its requester: the route must not run it. */
+ | {
+    readonly kind: "held";
+    readonly approval: AgentApprovalRecord;
+} | {
+    readonly kind: "denied";
+    readonly approval: AgentApprovalRecord;
+}
+/** The call's run id already names another call in the thread. */
+ | {
+    readonly kind: "conflict";
+    readonly approval: AgentApprovalRecord;
+};
+/**
+ * Hold a call the run's mode does not run, until whoever asked for the turn decides on it. A
+ * child's call waits for the turn that spawned it. Asking again with the same run id finds the same
+ * approval: an approved call passes, as its route returns the run the decision started.
+ */
+export declare function holdAgentApprovalCall(agents: AgentStorage, input: {
+    readonly projectId: string;
+    /** The running conversation turn or child that makes the call. */
+    readonly run: AgentRunRecord;
+    /** The run's requester; absent when auth is disabled. */
+    readonly requestedBy?: Principal;
+    /** Prepared as it would run. */
+    readonly call: AgentApprovalCall;
+    readonly now?: Date;
+}): Promise<AgentApprovalHold>;
+/** The call as the model asked for it, without its params. */
+export declare function approvalCallSummary(call: AgentApprovalCall): AgentApprovalCallSummary;
+/** A call a child made that waits for its turn's requester. */
+export interface AgentChildApprovalAwaiting {
+    readonly approvalId: string;
+    readonly call: AgentApprovalCallSummary;
+}
+/**
+ * The calls each of a turn's children made that still wait for the turn's requester: they are
+ * held on the turn, and name the child that asked.
+ */
+export declare function listChildApprovalsAwaiting(agents: AgentStorage, input: {
+    readonly projectId: string;
+    readonly parentRunId: string;
+    readonly childRunIds: readonly string[];
+}): Promise<ReadonlyMap<string, readonly AgentChildApprovalAwaiting[]>>;
+/**
+ * In the transaction that admits a thread's next message: set its pending approvals aside, and
+ * return one part per approval that left `pending` and no message reported yet, for the message to
+ * carry. An approved call reports once it ran.
+ */
+export declare function reportAgentApprovals(agents: AgentStorage, input: {
+    readonly projectId: string;
+    readonly threadId: string;
+    readonly messageId: string;
+}): Promise<{
+    readonly parts: readonly AgentApprovalOutcomePart[];
+    /** The approvals this message set aside, to announce once it is admitted. */
+    readonly superseded: readonly AgentApprovalRecord[];
+}>;
+/** Whether the turn paused on held calls: it succeeded, waiting for its requester's decisions. */
+export declare function isAwaitingApprovalRun(run: AgentRunRecord | null | undefined): boolean;
+/**
+ * Whether the child paused on its held calls: it succeeded before it was done. It continues once
+ * they are decided and its turn resumes, unless a new message sets them aside, one expires or the
+ * turn is stopped.
+ */
+export declare function isPausedSubagentRun(run: AgentRunRecord | null | undefined): boolean;
+/**
+ * How long a process keeps an approved call it took to run. Longer than an Action's 30-second
+ * limit, so a claim still held is a call still running; a claim older than this was lost in a crash.
+ */
+export declare const AGENT_APPROVAL_EXECUTION_LEASE_MS: number;
+/** Where a paused turn stands, from the calls it held. */
+export type AgentTurnReadiness = 
+/** Every call was decided, every approved one ran, and none was reported yet. */
+"ready"
+/** A call still waits for its decision, or an approved one has not run yet. */
+ | "waiting"
+/**
+ * It never resumes: a call was set aside, cancelled or expired, the turn was stopped, or it
+ * resumed already. The thread's next message reports what is left.
+ */
+ | "closed";
+export declare function turnResumeReadiness(approvals: readonly AgentApprovalRecord[]): AgentTurnReadiness;
+/**
+ * Whether a conversation turn pauses after a step on the calls it holds. Its own call pauses it
+ * after the step that made it. A child's waits for the children still at work: the turn's end
+ * would cancel them, and a child that holds a call pauses by itself.
+ */
+export declare function turnPausesOnHeldCalls(agents: AgentStorage, run: {
+    readonly projectId: string;
+    readonly id: string;
+}): Promise<boolean>;
+/** Whether any child of the turn is queued or running. */
+export declare function hasActiveChildren(agents: AgentStorage, run: {
+    readonly projectId: string;
+    readonly id: string;
+}): Promise<boolean>;
+/** The calls a conversation turn held, its children's included. */
+export declare function listTurnApprovals(agents: AgentStorage, input: {
+    readonly projectId: string;
+    readonly runId: string;
+}): Promise<readonly AgentApprovalRecord[]>;
+/**
+ * The mode a resumed turn runs with: the paused turn's, raised only by "Always allow" on one of its
+ * own calls, and lowered to the requester's choice in the thread when that is stricter. A user who
+ * tightens the mode while a turn waits gets it at the resume; a looser choice never reaches it.
+ */
+export declare function resumedApprovalMode(paused: AgentApprovalMode, approvals: readonly AgentApprovalRecord[], 
+/** The requester's own choice in the thread, `null` when they made none. */
+chosen: AgentApprovalMode | null): AgentApprovalMode;
+/**
+ * Stop a paused turn from resuming: its calls still waiting are cancelled, and the decided ones are
+ * reported by the thread's next message. Returns how many calls it stopped; none means the turn had
+ * nothing left to resume on.
+ */
+export declare function stopAgentTurn(agents: AgentStorage, broker: Broker, turn: {
+    readonly projectId: string;
+    readonly threadId: string;
+    readonly id: string;
+}): Promise<number>;
+/** Announce changed approvals on the activity feed. Clients learn it best-effort. */
+export declare function announceAgentApprovals(broker: Broker, approvals: readonly AgentApprovalRecord[]): Promise<void>;
+/**
+ * Mark and return, as message parts, the thread's approvals that left `pending` and no message
+ * reported yet. An approved call reports once it ran: one still running when this message is
+ * admitted stays for a later one.
+ */
+export declare function reportSettledAgentApprovals(agents: AgentStorage, input: {
+    readonly projectId: string;
+    readonly threadId: string;
+    readonly messageId: string;
+    /** A resume: the approvals of a stopped turn stay for the next message. */
+    readonly resuming?: boolean;
+}): Promise<readonly AgentApprovalOutcomePart[]>;
+/** A sub-agent that made a call: its run, its key, and whether it paused on its calls. */
+export interface AgentApprovalCallerRun {
+    readonly runId: string;
+    readonly key: string;
+    readonly paused: boolean;
+}
+/** The sub-agents that made some of these calls, by run id. A turn's own calls have none. */
+export declare function agentApprovalCallers(agents: AgentStorage, projectId: string, approvals: readonly AgentApprovalRecord[]): Promise<ReadonlyMap<string, AgentApprovalCallerRun>>;
+/**
+ * Decide on a held call as `decidedBy`, who must be who asked for the turn: the call runs with their
+ * rights. Only the decision that approves it runs it, as the run that made it and with the deciding
+ * request's authority, and records its outcome. Approving again never starts it: it returns the
+ * outcome, waiting for the run this process is making, or reading the call's run.
+ */
+export declare function decideAgentApproval(agents: AgentStorage, executor: AgentApprovalExecutor, input: {
+    readonly approval: AgentApprovalRecord;
+    readonly decision: "approved" | "denied";
+    readonly decidedBy: Principal;
+    /** The deciding request: an approved call runs with its authority. */
+    readonly decider: AgentApprovalDecider;
+    /** "Always allow": the mode the requester raises the turn's calls to with this approval. */
+    readonly raisedMode?: AgentApprovalMode;
+    /** Where the decision is announced; the executor announces the call's outcome. */
+    readonly broker: Broker;
+}): Promise<AgentApprovalRecord>;
+//# sourceMappingURL=approvals.d.ts.map

package/dist/agents/approvals.d.ts.map

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

package/dist/agents/authority.d.ts

@@ -43,6 +43,16 @@ export declare function resolveAgentExecutionAuthorization(input: {
     readonly identity: AgentExecutionIdentity;
     readonly context: AuthorizationContext;
 }>;
+/**
+ * Whether a user may talk to the Agent now, through the groups they belong to and the project's
+ * roles: who is added to a conversation, or named to the model as taking part in it.
+ */
+export declare function userCanRunAgent(input: {
+    readonly auth: AuthStorage;
+    readonly projectId: string;
+    readonly userId: string;
+    readonly security: SecurityDefinitionCatalog;
+}): Promise<boolean>;
 /** Revalidate the durable user authority inherited by a conversational or child Agent. */
 export declare function resolveInheritedAgentExecutionAuthorization(input: {
     readonly auth: AuthStorage | undefined;

package/dist/agents/authority.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../src/agents/authority.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAG5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EAAE,KAAK,iBAAiB,EAA4B,MAAM,+BAA+B,CAAA;AAChG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,KAAK,EAEV,WAAW,EACX,mCAAmC,EACnC,oBAAoB,EAGrB,MAAM,iBAAiB,CAAA;AAIxB,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAEjC;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,yBAAyB,EACnC,aAAa,EAAE,2BAA2B,GACzC,iBAAiB,GAAG,SAAS,CAI/B;AAYD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,qBAAqB,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAA;IACvF,QAAQ,CAAC,gBAAgB,EAAE,SAAS,mCAAmC,EAAE,CAAA;CAC1E;AAED,iGAAiG;AACjG,wBAAsB,mCAAmC,CAAC,KAAK,EAAE;IAC/D,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqClC;AAuFD,8FAA8F;AAC9F,wBAAsB,kCAAkC,CAAC,KAAK,EAAE;IAC9D,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAA;CAC7C,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC,CAwCjG;AAED,0FAA0F;AAC1F,wBAAsB,2CAA2C,CAAC,KAAK,EAAE;IACvE,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAA;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CACpB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CA6BvC"}
+{"version":3,"file":"authority.d.ts","sourceRoot":"","sources":["../../src/agents/authority.ts"],"names":[],"mappings":"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"}

package/dist/agents/builders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/agents/builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,2BAA2B,EAM5B,MAAM,SAAS,CAAA;AAOhB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EACxD,IAAI,EAAE,KAAK,GACV,2BAA2B,CAAC,KAAK,CAAC,CAwBpC"}
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/agents/builders.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,2BAA2B,EAO5B,MAAM,SAAS,CAAA;AAOhB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,CAAC,KAAK,SAAS,MAAM,EACxD,IAAI,EAAE,KAAK,GACV,2BAA2B,CAAC,KAAK,CAAC,CAwBpC"}

package/dist/agents/cancel.d.ts

@@ -0,0 +1,23 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import { type AgentRunRecord, type AgentStorage, type ConversationAgentRunRecord } from "../storage/agents";
+/**
+ * Stop a turn. A queued turn ends here, before any worker starts it. A running turn receives the
+ * stop signal its worker obeys, so it is still running when this returns. A turn paused on held
+ * calls is returned as it ended, `awaiting_approval`, and never resumes: its waiting calls are
+ * cancelled. Who may stop it is the caller's decision.
+ */
+export declare function cancelAgentRun(runtime: SixbRuntimeContext, run: ConversationAgentRunRecord): Promise<ConversationAgentRunRecord>;
+/**
+ * Cancel a queued run before any worker starts it. The worker may have started it after the
+ * caller's read but before `finishQueued` locked it: then the run comes back as it is now, for the
+ * caller to stop as a running one. A retained control record is safe even if the worker has not
+ * attached its cancel subscription yet.
+ */
+export declare function cancelQueuedRun(runtime: SixbRuntimeContext, storage: AgentStorage, run: AgentRunRecord): Promise<{
+    readonly cancelled: true;
+    readonly run: AgentRunRecord;
+} | {
+    readonly cancelled: false;
+    readonly run: AgentRunRecord | null;
+}>;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/agents/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/agents/cancel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,0BAA0B,EAChC,MAAM,mBAAmB,CAAA;AAK1B;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,0BAA0B,GAC9B,OAAO,CAAC,0BAA0B,CAAC,CAwCrC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,cAAc,GAClB,OAAO,CACN;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,CACrE,CAeA"}

package/dist/agents/child-question.d.ts

@@ -0,0 +1,18 @@
+import type { AgentRunRecord } from "../storage/agents";
+import type { AgentMessage } from "./message";
+/** A question a sub-agent asked its parent: the id of its mail and what it asks. */
+export interface AgentChildQuestion {
+    readonly id: string;
+    readonly text: string;
+}
+/**
+ * Whether the child paused on its question when its turn ended: it continues once a later turn of
+ * the conversation answers it under its key.
+ */
+export declare function isAwaitingAnswerRun(run: AgentRunRecord | null | undefined): boolean;
+/**
+ * The question a run's messages paused on: its `ask_parent` call whose answer was deferred to a
+ * later turn, which names the question's id.
+ */
+export declare function deferredChildQuestion(messages: readonly Pick<AgentMessage, "parts">[]): AgentChildQuestion | undefined;
+//# sourceMappingURL=child-question.d.ts.map

package/dist/agents/child-question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-question.d.ts","sourceRoot":"","sources":["../../src/agents/child-question.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,oFAAoF;AACpF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAInF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,SAAS,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,GAC/C,kBAAkB,GAAG,SAAS,CAmBhC"}

package/dist/agents/children.d.ts

@@ -0,0 +1,99 @@
+import type { SixbFailure } from "../errors/types";
+import type { LanguageModelRef, LanguageModelTier } from "../models";
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { AgentRunFailureCode, AgentRunFinishReason, AgentRunRecord, AgentRunStatus, AgentThreadRecord, SubagentRunFile, SubagentRunRecord, SubagentRunResult } from "../storage/agents";
+import type { AiCostSummary } from "../storage/ai-cost";
+import type { AiModelCallUsage } from "../storage/ai-usage";
+import { type AgentChildQuestion } from "./child-question";
+import type { AgentReasoning } from "./types";
+/** What a child waits for before it goes on. */
+export type AgentChildAwaiting = {
+    /** Its calls still waiting for the turn's requester, filed on the turn that ran it. */
+    readonly type: "approval";
+    readonly approvalIds: readonly string[];
+} | {
+    /** Its calls were decided: it continues once its turn resumes. */
+    readonly type: "resume";
+} | {
+    /**
+     * It paused on the question it asked its parent when the parent's turn ended: a later turn of
+     * the conversation answers it, and it continues with the answer.
+     */
+    readonly type: "answer";
+    readonly question: AgentChildQuestion;
+};
+/**
+ * Why a paused child never continues. On its calls: a new message set them aside, one expired, or
+ * its turn was stopped, its requester leaving among the reasons. On its question: the Agent spawned
+ * another child under its key, which a later answer would reach instead.
+ */
+export type AgentChildEndReason = "superseded" | "expired" | "stopped" | "replaced";
+/** One run of a child: the one spawned, or one that continued it. */
+export interface AgentChildRunView {
+    readonly id: string;
+    /** The turn the run worked under: the one that spawned the child, or one that went on with it. */
+    readonly parentRunId: string;
+    readonly status: AgentRunStatus;
+    readonly finishReason?: AgentRunFinishReason;
+    readonly error?: SixbFailure<AgentRunFailureCode>;
+    readonly modelId?: string;
+    readonly attempt: number;
+    readonly createdAt: Date;
+    readonly startedAt?: Date;
+    readonly completedAt?: Date;
+    /** What it answered, and the files it wrote under `out/`. */
+    readonly result?: SubagentRunResult;
+    /** Its own model calls and those of what it ran. */
+    readonly usage?: AiModelCallUsage;
+    readonly cost?: AiCostSummary;
+}
+/** A child of a conversation, its thread, with every run it took. */
+export interface AgentChildView {
+    /** Its first run's id: the one `spawn_agent` answered with. */
+    readonly id: string;
+    /** Its own thread, whose messages are what it did. */
+    readonly threadId: string;
+    readonly projectId: string;
+    /** The turn that spawned it. */
+    readonly spawnedBy: string;
+    readonly key: string;
+    readonly task: string;
+    readonly model: LanguageModelRef;
+    readonly tier?: LanguageModelTier;
+    readonly reasoning?: AgentReasoning;
+    /** What its parent handed it, by path in its sandbox. */
+    readonly handedFiles: readonly SubagentRunFile[];
+    /** Its latest run's. */
+    readonly status: AgentRunStatus;
+    readonly finishReason?: AgentRunFinishReason;
+    readonly error?: SixbFailure<AgentRunFailureCode>;
+    /** Set while its latest run paused, until it continues. */
+    readonly awaiting?: AgentChildAwaiting;
+    /** Set when its latest run paused and it will not continue. */
+    readonly ended?: {
+        readonly reason: AgentChildEndReason;
+    };
+    /** Its run at work, which streams; `null` when none is. */
+    readonly activeRunId: string | null;
+    readonly createdAt: Date;
+    /** Its latest run's, once that ended. */
+    readonly completedAt?: Date;
+    /** Every run of it. */
+    readonly usage?: AiModelCallUsage;
+    readonly cost?: AiCostSummary;
+    /** Oldest first: the run spawned, then each that continued it. */
+    readonly runs: readonly AgentChildRunView[];
+}
+/** A conversation's children, oldest first: all of them, or those one of its turns spawned. */
+export declare function listAgentChildren(runtime: SixbRuntimeContext, conversation: AgentThreadRecord, options?: {
+    readonly spawnedBy?: string;
+}): Promise<readonly AgentChildView[]>;
+/** The child that works in `thread`, a sub-agent's thread of `conversation`. */
+export declare function readAgentChild(runtime: SixbRuntimeContext, conversation: AgentThreadRecord, thread: AgentThreadRecord): Promise<AgentChildView | null>;
+/**
+ * Stop a child's run at work. A queued one is cancelled here; a running one receives the stop signal
+ * its worker obeys, so it is still running when this returns. Who may stop it is the caller's
+ * decision.
+ */
+export declare function cancelAgentChildRun(runtime: SixbRuntimeContext, run: SubagentRunRecord): Promise<AgentRunRecord>;
+//# sourceMappingURL=children.d.ts.map

package/dist/agents/children.d.ts.map

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

package/dist/agents/context/index.js

@@ -7,7 +7,7 @@ import {
   agentContext2,
   agentContextIdentity2,
   agentContextFingerprint2
-} from "../../chunk-pfp1txq2.js";
+} from "../../chunk-sgx82nnt.js";
 export {
   MAX_AGENT_APP_STATE_ENTRY_BYTES2 as MAX_AGENT_APP_STATE_ENTRY_BYTES,
   MAX_AGENT_APP_STATE_TOTAL_BYTES2 as MAX_AGENT_APP_STATE_TOTAL_BYTES,

package/dist/agents/context-compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-compaction.d.ts","sourceRoot":"","sources":["../../src/agents/context-compaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAA;AAE/D,eAAO,MAAM,+BAA+B,EAAG,CAAU,CAAA;AAYzD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,+BAA+B,CAAA;CAClE;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACxD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;CACtC;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC,GAAG,OAAO,CAEV;AAED,6FAA6F;AAC7F,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,yBAAyB,CAkB3B;AAED,kEAAkE;AAClE,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,yBAAyB,CAO3B;AAED,oGAAoG;AACpG,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC,GAAG,8BAA8B,GAAG,IAAI,CA2BxC;AAED,2FAA2F;AAC3F,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAahG"}
+{"version":3,"file":"context-compaction.d.ts","sourceRoot":"","sources":["../../src/agents/context-compaction.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAIjE,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,WAAW,CAAA;AAE/D,eAAO,MAAM,+BAA+B,EAAG,CAAU,CAAA;AAYzD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,+BAA+B,CAAA;CAClE;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAC3D,QAAQ,CAAC,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACxD,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;CACtC;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CACnC,GAAG,OAAO,CAEV;AAED,6FAA6F;AAC7F,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,yBAAyB,CAkB3B;AAED,kEAAkE;AAClE,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,YAAY,EAAE,GAChC,yBAAyB,CAO3B;AAED,oGAAoG;AACpG,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC,GAAG,8BAA8B,GAAG,IAAI,CA2BxC;AAED,2FAA2F;AAC3F,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAahG"}

package/dist/agents/errors.d.ts

@@ -20,7 +20,9 @@ export declare class AgentToolResultValidationError extends Error {
     readonly name = "AgentToolResultValidationError";
     constructor(toolName: string, reason: string, options?: ErrorOptions);
 }
-export type AgentRequestErrorCode = "agent_selector_removed" | "agent_not_found" | "model_not_found" | "invalid_model_selection" | "invalid_locale" | "invalid_message" | "run_not_found" | "run_not_retryable" | "thread_not_found" | "active_run_exists" | "authority_not_inheritable" | "invalid_context" | "invalid_attachment" | "storage_unavailable" | "sandbox_not_configured" | "invalid_sandbox_params" | "sandbox_execution_unavailable";
+export type AgentRequestErrorCode = "agent_selector_removed" | "agent_not_found" | "model_not_found" | "invalid_model_selection" | "invalid_locale" | "invalid_message" | "run_not_found" | "run_not_retryable" | "thread_not_found"
+/** A conversation's write on a sub-agent's thread: a message, a fork, a participant, a mode. */
+ | "thread_not_conversation" | "active_run_exists" | "authority_not_inheritable" | "invalid_context" | "invalid_attachment" | "storage_unavailable" | "sandbox_not_configured" | "invalid_sandbox_params" | "sandbox_execution_unavailable" | "invalid_participant" | "not_thread_owner" | "not_run_requester" | "run_not_active" | "invalid_approval_mode" | "approval_not_found" | "approval_not_pending" | "approval_expired";
 /**
  * Raised by {@link requestAgentRun} (the trigger). Callers branch on `code` rather than message text
  * — e.g. the HTTP layer maps `active_run_exists` to 409 and `agent_not_found` to 404.
@@ -30,4 +32,14 @@ export declare class AgentRequestError extends Error {
     readonly name = "AgentRequestError";
     constructor(code: AgentRequestErrorCode, message: string);
 }
+export type AgentMemoryErrorCode = "invalid_repo" | "invalid_save" | "not_allowed" | "storage_unavailable";
+/**
+ * Raised by `sixb.agent.memory`. Callers branch on `code`; the message says what to change, so the
+ * HTTP layer can hand it to the Agent as it is.
+ */
+export declare class AgentMemoryError extends Error {
+    readonly code: AgentMemoryErrorCode;
+    readonly name = "AgentMemoryError";
+    constructor(code: AgentMemoryErrorCode, message: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/dist/agents/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED,kFAAkF;AAClF,qBAAa,8BAA+B,SAAQ,KAAK;IAIrD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,oCAAmC;gBAGrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,MAAM,MAAM,qBAAqB,GAC7B,wBAAwB,GACxB,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,2BAA2B,GAC3B,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,+BAA+B,CAAA;AAEnC;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAyB;CAC/C;AAED,kFAAkF;AAClF,qBAAa,8BAA+B,SAAQ,KAAK;IAIrD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,oCAAmC;gBAGrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,YAAY;CAIzB;AAED,MAAM,MAAM,qBAAqB,GAC7B,wBAAwB,GACxB,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,mBAAmB,GACnB,kBAAkB;AACpB,gGAAgG;GAC9F,yBAAyB,GACzB,mBAAmB,GACnB,2BAA2B,GAC3B,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,wBAAwB,GACxB,wBAAwB,GACxB,+BAA+B,GAC/B,qBAAqB,GACrB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,uBAAuB,GACvB,oBAAoB,GACpB,sBAAsB,GACtB,kBAAkB,CAAA;AAEtB;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAIxC,QAAQ,CAAC,IAAI,EAAE,qBAAqB;IAHtC,QAAQ,CAAC,IAAI,uBAAsB;gBAGxB,IAAI,EAAE,qBAAqB,EACpC,OAAO,EAAE,MAAM;CAIlB;AAED,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,cAAc,GACd,aAAa,GACb,qBAAqB,CAAA;AAEzB;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAIvC,QAAQ,CAAC,IAAI,EAAE,oBAAoB;IAHrC,QAAQ,CAAC,IAAI,sBAAqB;gBAGvB,IAAI,EAAE,oBAAoB,EACnC,OAAO,EAAE,MAAM;CAIlB"}