@sixb/core 0.1.20 → 0.1.22

package/dist/agents/index.js

@@ -8,6 +8,7 @@ import {
   createAgentApiGatewayCapability2,
   isValidAgentApiGatewayCapability2,
   isAllowedAgentApiRequest2,
+  findAgentApiRoute2,
   AGENT_RESERVED_TOOL_NAMES2,
   isAgentToolDefinition2,
   validateAndNormalizeAgentToolInput2,
@@ -20,18 +21,30 @@ import {
   serializeAgentMessagesForSummary2,
   agent2,
   projectAgentThreadModelContext2
-} from "../chunk-tpn40322.js";
-import"../chunk-1k89ecfr.js";
-import"../chunk-1sr8ryzk.js";
+} from "../chunk-vpgwq5nf.js";
+import"../chunk-661ezhks.js";
 import {
-  createAgentThreadId2,
-  createAgentThreadSandboxName2,
-  createAgentRunId2,
-  createSubagentRunId2,
-  createSubagentExecutionId2,
-  createAgentMessageId2,
-  agentContextCheckpointId2,
-  createAgentRunExecutionToken2,
+  resumeDecidedAgentTurn2,
+  agentRunApprovalMode2,
+  holdAgentApprovalCall2,
+  approvalCallSummary2,
+  listChildApprovalsAwaiting2,
+  isAwaitingApprovalRun2,
+  isPausedSubagentRun2,
+  AGENT_APPROVAL_EXECUTION_LEASE_MS2,
+  turnResumeReadiness2,
+  turnPausesOnHeldCalls2,
+  hasActiveChildren2,
+  listTurnApprovals2,
+  stopAgentTurn2,
+  announceAgentApprovals2,
+  agentApprovalCallers2,
+  AgentRunScopeError2,
+  resolveAgentRunExecutionScope2,
+  getAgentApprovalExecutor2,
+  isAwaitingAnswerRun2,
+  deferredChildQuestion2,
+  listSubagentThreadRuns2,
   resolveAgentContextParts2,
   agentRunQueueJobId2,
   subagentRunQueueJobId2,
@@ -42,68 +55,33 @@ import {
   isRetryableAgentRun2,
   retryAgentRun2,
   runModelLoop2
-} from "../chunk-6c6sn0bh.js";
-import"../chunk-xfs8x8m9.js";
-import"../chunk-tg2cw67r.js";
-import"../chunk-fkgc1wt8.js";
-import"../chunk-4vyr1j8f.js";
-import"../chunk-hjzdd750.js";
-import"../chunk-mfs23znk.js";
-import"../chunk-1zq2p6g0.js";
-import"../chunk-99nd4rc1.js";
-import"../chunk-vyf9kfqf.js";
-import"../chunk-bx9q3cwv.js";
-import"../chunk-yevzdx4y.js";
-import"../chunk-9dmt152s.js";
-import {
-  AGENT_MESSAGE_CONTENT_VERSION2
-} from "../chunk-n33z5bjw.js";
-import"../chunk-9ybhtmg4.js";
-import"../chunk-br3k6qbf.js";
-import"../chunk-jmfet9r4.js";
-import"../chunk-qf954wje.js";
-import {
-  resolveAgentPropertyClearance2,
-  ensureManagedAgentExecutionIdentity2,
-  resolveAgentExecutionAuthorization2,
-  resolveInheritedAgentExecutionAuthorization2
-} from "../chunk-rrzt8jdy.js";
-import"../chunk-tw03bsmb.js";
-import"../chunk-9w055r5b.js";
-import"../chunk-s16apyk9.js";
-import"../chunk-hn2r7z41.js";
-import"../chunk-h89wz928.js";
-import"../chunk-pbcbn83d.js";
-import"../chunk-qczk96d9.js";
-import"../chunk-mmagke4x.js";
-import"../chunk-b38szspf.js";
-import"../chunk-a40ad1ft.js";
+} from "../chunk-7gr4j2eq.js";
+import"../chunk-6p0pastb.js";
+import"../chunk-02bzjgnt.js";
 import {
-  AGENT_REASONING_LEVELS2
-} from "../chunk-s54c868q.js";
-import"../chunk-ere85b8y.js";
-import"../chunk-rj69qcrd.js";
-import"../chunk-4as3wt1c.js";
-import"../chunk-29yx306f.js";
-import"../chunk-pqajwytd.js";
-import"../chunk-d09tj99x.js";
+  sandboxCredentialIssue2,
+  staticSandboxRecipe2,
+  captureSandboxEnv2
+} from "../chunk-d2m879s4.js";
+import"../chunk-0phpbbvm.js";
+import"../chunk-h33shhq6.js";
+import"../chunk-2626mh4m.js";
 import"../chunk-3qms4nax.js";
-import"../chunk-7n440zgt.js";
-import"../chunk-m427qgq0.js";
-import"../chunk-fa02jy15.js";
-import"../chunk-7t429e3f.js";
-import"../chunk-3zxk45er.js";
+import"../chunk-7mc2wkre.js";
+import"../chunk-hyesv9dv.js";
+import"../chunk-07kkp2e1.js";
+import"../chunk-fp2kq35z.js";
+import"../chunk-2gjj5dx3.js";
+import"../chunk-dp0cdtj2.js";
 import"../chunk-5a4a52tq.js";
-import"../chunk-t7x8dmn0.js";
-import"../chunk-way52z4h.js";
-import"../chunk-0yh890a4.js";
-import"../chunk-gc4ntf7d.js";
-import"../chunk-gfdh9kqa.js";
+import"../chunk-6y0mkhex.js";
+import"../chunk-1t6k1avb.js";
+import"../chunk-c844dkwd.js";
+import"../chunk-m427qgq0.js";
+import"../chunk-48jezz3j.js";
+import"../chunk-npcr0228.js";
+import"../chunk-8ncg20rd.js";
 import {
-  AgentDefinitionError2,
-  AgentToolPublicError2,
-  AgentToolResultValidationError2,
-  AgentRequestError2,
   MAX_AGENT_CONTEXT_ENTRIES2,
   MAX_AGENT_APP_STATE_ENTRY_BYTES2,
   MAX_AGENT_APP_STATE_TOTAL_BYTES2,
@@ -111,7 +89,7 @@ import {
   agentContextIdentity2,
   agentContextFingerprint2,
   normalizeAgentContextEntries2
-} from "../chunk-pfp1txq2.js";
+} from "../chunk-sgx82nnt.js";
 import {
   AGENT_RUN_STREAM_SCHEMA_VERSION2,
   DEFAULT_AGENT_RUN_STREAM_RETENTION2,
@@ -122,29 +100,102 @@ import {
   agentRunControlStreamDefinition2,
   publishAgentRunCancel2,
   subscribeAgentRunCancel2,
+  agentThreadInboxStreamId2,
+  agentRunInboxStreamId2,
+  isKnownAgentMailKind2,
+  publishAgentMail2,
+  subscribeAgentMail2,
+  subscribeAgentInbox2,
+  readAgentMail2,
   AGENT_COMPACTION_FAILURE_CODES2,
   agentRunFinishedEvent2,
   isAgentRunStreamEvent2,
   agentRunStreamIdempotencyKey2,
   publishAgentRunFinished2
-} from "../chunk-5e43w60z.js";
-import"../chunk-vpq4shxz.js";
-import"../chunk-c85m1hyj.js";
-import"../chunk-v9xd5wzd.js";
-import"../chunk-es1gxsbf.js";
-import"../chunk-hcbyfxbe.js";
+} from "../chunk-r6szek0x.js";
+import {
+  assertConversationThread2,
+  conversationThreadId2
+} from "../chunk-qhqgp4jf.js";
+import"../chunk-7z5p905k.js";
+import"../chunk-efmm01gj.js";
+import {
+  AGENT_MESSAGE_CONTENT_VERSION2
+} from "../chunk-ezne9wc9.js";
+import"../chunk-qf954wje.js";
+import {
+  resolveAgentPropertyClearance2,
+  ensureManagedAgentExecutionIdentity2,
+  resolveAgentExecutionAuthorization2,
+  userCanRunAgent2,
+  resolveInheritedAgentExecutionAuthorization2
+} from "../chunk-6rrtzea3.js";
+import"../chunk-fe8zwt8b.js";
+import"../chunk-hqsp2sx4.js";
+import"../chunk-2adz0h75.js";
+import"../chunk-mmagke4x.js";
+import"../chunk-g663fahq.js";
+import"../chunk-hn2r7z41.js";
+import"../chunk-fm62y49k.js";
+import"../chunk-jmfet9r4.js";
+import {
+  createAgentThreadId2,
+  createAgentThreadSandboxName2,
+  createAgentRunId2,
+  createSubagentRunId2,
+  createSubagentThreadId2,
+  createSubagentExecutionId2,
+  createAgentMessageId2,
+  agentContextCheckpointId2,
+  createAgentRunExecutionToken2,
+  AGENT_REASONING_LEVELS2
+} from "../chunk-nydf3dbe.js";
+import"../chunk-0xmt5p5y.js";
+import"../chunk-pgrf64hp.js";
+import"../chunk-4ymrcdbm.js";
+import"../chunk-eptrvnby.js";
+import"../chunk-hwarjrgf.js";
+import"../chunk-h89wz928.js";
+import"../chunk-x0v3jd47.js";
+import"../chunk-c0vk1djt.js";
+import"../chunk-mbsbxarb.js";
+import"../chunk-cswhawa2.js";
+import"../chunk-tdxfsg1c.js";
+import"../chunk-pdt5cw8z.js";
+import"../chunk-h3pbv7n8.js";
+import"../chunk-6n69k945.js";
+import"../chunk-cdk3egjj.js";
+import"../chunk-bab05bhg.js";
+import"../chunk-zrvhsq7f.js";
+import"../chunk-73v685wb.js";
+import"../chunk-5grk14e5.js";
 import {
   agentServiceAccountId2
-} from "../chunk-d0bqz29d.js";
-import"../chunk-v4jbb3rs.js";
-import"../chunk-hvsb78a1.js";
-import"../chunk-gsjm1wms.js";
-import"../chunk-jhm3zsa7.js";
-import"../chunk-8mx7qw3y.js";
-import"../chunk-z3y5kg1x.js";
+} from "../chunk-yc9ners4.js";
+import"../chunk-rap5w0x0.js";
+import"../chunk-65pyhyas.js";
+import"../chunk-4y26vs3v.js";
+import"../chunk-vhbw5sqm.js";
+import"../chunk-cwdzcv37.js";
+import"../chunk-gfdh9kqa.js";
+import {
+  AgentDefinitionError2,
+  AgentToolPublicError2,
+  AgentToolResultValidationError2,
+  AgentRequestError2
+} from "../chunk-9wr3yajk.js";
+import"../chunk-zbc929zg.js";
+import"../chunk-6eqsgvxk.js";
+import"../chunk-qx00vjrj.js";
+import"../chunk-a3faa34j.js";
+import"../chunk-wkv3h3q7.js";
+import"../chunk-waqk73p1.js";
+import"../chunk-3fqxbn31.js";
+import"../chunk-hz5d43gn.js";
 export {
   AGENT_API_GATEWAY_PREFIX2 as AGENT_API_GATEWAY_PREFIX,
   AGENT_API_ROUTES2 as AGENT_API_ROUTES,
+  AGENT_APPROVAL_EXECUTION_LEASE_MS2 as AGENT_APPROVAL_EXECUTION_LEASE_MS,
   AGENT_COMPACTION_FAILURE_CODES2 as AGENT_COMPACTION_FAILURE_CODES,
   AGENT_CONTEXT_ESTIMATOR_VERSION2 as AGENT_CONTEXT_ESTIMATOR_VERSION,
   AGENT_MESSAGE_CONTENT_VERSION2 as AGENT_MESSAGE_CONTENT_VERSION,
@@ -154,6 +205,7 @@ export {
   AGENT_RUN_STREAM_SCHEMA_VERSION2 as AGENT_RUN_STREAM_SCHEMA_VERSION,
   AgentDefinitionError2 as AgentDefinitionError,
   AgentRequestError2 as AgentRequestError,
+  AgentRunScopeError2 as AgentRunScopeError,
   AgentToolPublicError2 as AgentToolPublicError,
   AgentToolResultValidationError2 as AgentToolResultValidationError,
   DEFAULT_AGENT_RUN_STREAM_RETENTION2 as DEFAULT_AGENT_RUN_STREAM_RETENTION,
@@ -161,18 +213,27 @@ export {
   MAX_AGENT_APP_STATE_TOTAL_BYTES2 as MAX_AGENT_APP_STATE_TOTAL_BYTES,
   MAX_AGENT_CONTEXT_ENTRIES2 as MAX_AGENT_CONTEXT_ENTRIES,
   agent2 as agent,
+  agentApprovalCallers2 as agentApprovalCallers,
   agentContext2 as agentContext,
   agentContextCheckpointId2 as agentContextCheckpointId,
   agentContextFingerprint2 as agentContextFingerprint,
   agentContextIdentity2 as agentContextIdentity,
+  agentRunApprovalMode2 as agentRunApprovalMode,
   agentRunControlStreamDefinition2 as agentRunControlStreamDefinition,
   agentRunControlStreamId2 as agentRunControlStreamId,
   agentRunFinishedEvent2 as agentRunFinishedEvent,
+  agentRunInboxStreamId2 as agentRunInboxStreamId,
   agentRunQueueJobId2 as agentRunQueueJobId,
   agentRunStreamDefinition2 as agentRunStreamDefinition,
   agentRunStreamId2 as agentRunStreamId,
   agentRunStreamIdempotencyKey2 as agentRunStreamIdempotencyKey,
   agentServiceAccountId2 as agentServiceAccountId,
+  agentThreadInboxStreamId2 as agentThreadInboxStreamId,
+  announceAgentApprovals2 as announceAgentApprovals,
+  approvalCallSummary2 as approvalCallSummary,
+  assertConversationThread2 as assertConversationThread,
+  captureSandboxEnv2 as captureSandboxEnv,
+  conversationThreadId2 as conversationThreadId,
   createAgentApiGatewayCapability2 as createAgentApiGatewayCapability,
   createAgentMessageId2 as createAgentMessageId,
   createAgentRunExecutionToken2 as createAgentRunExecutionToken,
@@ -181,38 +242,63 @@ export {
   createAgentThreadSandboxName2 as createAgentThreadSandboxName,
   createSubagentExecutionId2 as createSubagentExecutionId,
   createSubagentRunId2 as createSubagentRunId,
+  createSubagentThreadId2 as createSubagentThreadId,
+  deferredChildQuestion2 as deferredChildQuestion,
   defineAgentTool2 as defineAgentTool,
   dispatchQueuedAgentRuns2 as dispatchQueuedAgentRuns,
   dispatchQueuedSubagentRuns2 as dispatchQueuedSubagentRuns,
   ensureManagedAgentExecutionIdentity2 as ensureManagedAgentExecutionIdentity,
   estimateAgentContextMessagesTokens2 as estimateAgentContextMessagesTokens,
   estimateAgentContextRequestTokens2 as estimateAgentContextRequestTokens,
+  findAgentApiRoute2 as findAgentApiRoute,
+  getAgentApprovalExecutor2 as getAgentApprovalExecutor,
+  hasActiveChildren2 as hasActiveChildren,
+  holdAgentApprovalCall2 as holdAgentApprovalCall,
   isAgentRunStreamEvent2 as isAgentRunStreamEvent,
   isAgentToolDefinition2 as isAgentToolDefinition,
   isAgentToolResult2 as isAgentToolResult,
   isAllowedAgentApiRequest2 as isAllowedAgentApiRequest,
+  isAwaitingAnswerRun2 as isAwaitingAnswerRun,
+  isAwaitingApprovalRun2 as isAwaitingApprovalRun,
+  isKnownAgentMailKind2 as isKnownAgentMailKind,
+  isPausedSubagentRun2 as isPausedSubagentRun,
   isRetryableAgentRun2 as isRetryableAgentRun,
   isValidAgentApiGatewayCapability2 as isValidAgentApiGatewayCapability,
+  listChildApprovalsAwaiting2 as listChildApprovalsAwaiting,
+  listSubagentThreadRuns2 as listSubagentThreadRuns,
+  listTurnApprovals2 as listTurnApprovals,
   normalizeAgentContextEntries2 as normalizeAgentContextEntries,
   projectAgentThreadModelContext2 as projectAgentThreadModelContext,
+  publishAgentMail2 as publishAgentMail,
   publishAgentRunCancel2 as publishAgentRunCancel,
   publishAgentRunFinished2 as publishAgentRunFinished,
+  readAgentMail2 as readAgentMail,
   requestAgentRun2 as requestAgentRun,
   resolveAgentContextParts2 as resolveAgentContextParts,
   resolveAgentExecutionAuthorization2 as resolveAgentExecutionAuthorization,
   resolveAgentPropertyClearance2 as resolveAgentPropertyClearance,
+  resolveAgentRunExecutionScope2 as resolveAgentRunExecutionScope,
   resolveInheritedAgentExecutionAuthorization2 as resolveInheritedAgentExecutionAuthorization,
+  resumeDecidedAgentTurn2 as resumeDecidedAgentTurn,
   retryAgentRun2 as retryAgentRun,
   runModelLoop2 as runModelLoop,
+  sandboxCredentialIssue2 as sandboxCredentialIssue,
   selectAgentContextCompactionBoundary2 as selectAgentContextCompactionBoundary,
   serializeAgentContextForModel2 as serializeAgentContextForModel,
   serializeAgentMessagesForSummary2 as serializeAgentMessagesForSummary,
   shouldCompactAgentContext2 as shouldCompactAgentContext,
+  staticSandboxRecipe2 as staticSandboxRecipe,
+  stopAgentTurn2 as stopAgentTurn,
   subagentRunQueueJobId2 as subagentRunQueueJobId,
+  subscribeAgentInbox2 as subscribeAgentInbox,
+  subscribeAgentMail2 as subscribeAgentMail,
   subscribeAgentRunCancel2 as subscribeAgentRunCancel,
   toModelMessages2 as toModelMessages,
+  turnPausesOnHeldCalls2 as turnPausesOnHeldCalls,
+  turnResumeReadiness2 as turnResumeReadiness,
+  userCanRunAgent2 as userCanRunAgent,
   validateAndNormalizeAgentToolInput2 as validateAndNormalizeAgentToolInput,
   workflowAgentNodeQueueJobId2 as workflowAgentNodeQueueJobId
 };
 
-//# debugId=8EA243F52514D9F564756E2164756E21
+//# debugId=126F0BAF3A5D002264756E2164756E21

package/dist/agents/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "8EA243F52514D9F564756E2164756E21",
+  "debugId": "126F0BAF3A5D002264756E2164756E21",
   "names": []
 }

package/dist/agents/memory-execution.d.ts

@@ -0,0 +1,57 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { AgentMemoryChange, AgentMemoryFile, ListAgentMemoryRevisionsResult } from "../storage/agents";
+import { type AgentMemoryLinkWarning, type AgentMemoryRepoName } from "./memory";
+/** A memory repo as the caller sees it. */
+export interface AgentMemoryRepoView {
+    readonly repo: AgentMemoryRepoName;
+    /** 0 before the first save. */
+    readonly revision: number;
+    /** Ordered by path. */
+    readonly files: readonly AgentMemoryFile[];
+}
+export interface SaveAgentMemoryRuntimeInput {
+    /** The revision the changes were made against. */
+    readonly baseRevision: number;
+    /** What was learned, as the revision's entry in the repo's history. */
+    readonly message: string;
+    /** `contents: null` deletes the file. */
+    readonly changes: readonly AgentMemoryChange[];
+    /** The conversation the save came from, `/agents/<threadId>`. */
+    readonly source?: string;
+}
+export type SaveAgentMemoryRuntimeResult = {
+    readonly saved: true;
+    readonly revision: number;
+    /** Links in the saved repo that point at no file. */
+    readonly warnings: readonly AgentMemoryLinkWarning[];
+} | {
+    readonly saved: false;
+    /** The repo's latest revision. */
+    readonly revision: number;
+    /** Files in `changes` that another save changed after `baseRevision`, as they are now. */
+    readonly conflicts: readonly AgentMemoryChange[];
+};
+/**
+ * The Agent's memory: `user` is the caller's own; `project` is built up by everyone who can run the
+ * Agent, who all read and save it, and deleted only with `can.manage(agent.memory)`.
+ */
+export interface AgentMemoryRuntime {
+    /**
+     * With `asOf`, the repo at the latest revision saved by then; with `revision`, as that revision
+     * left it.
+     */
+    get(repo: AgentMemoryRepoName, options?: {
+        readonly asOf?: Date;
+        readonly revision?: number;
+    }): Promise<AgentMemoryRepoView>;
+    save(repo: AgentMemoryRepoName, input: SaveAgentMemoryRuntimeInput): Promise<SaveAgentMemoryRuntimeResult>;
+    /** Newest first. */
+    listRevisions(repo: AgentMemoryRepoName, input?: {
+        readonly limit?: number;
+        readonly offset?: number;
+    }): Promise<ListAgentMemoryRevisionsResult>;
+    /** Deletes the repo with its history. */
+    delete(repo: AgentMemoryRepoName): Promise<void>;
+}
+export declare function createAgentMemoryRuntime(runtime: SixbRuntimeContext): AgentMemoryRuntime;
+//# sourceMappingURL=memory-execution.d.ts.map

package/dist/agents/memory-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-execution.d.ts","sourceRoot":"","sources":["../../src/agents/memory-execution.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EAEf,8BAA8B,EAC/B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EAIzB,MAAM,UAAU,CAAA;AAEjB,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;IAClC,+BAA+B;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,2BAA2B;IAC1C,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC9C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,MAAM,4BAA4B,GACpC;IACE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACrD,GACD;IACE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,0FAA0F;IAC1F,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAA;CACjD,CAAA;AAEL;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,GAAG,CACD,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7D,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC/B,IAAI,CACF,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,4BAA4B,CAAC,CAAA;IACxC,oBAAoB;IACpB,aAAa,CACX,IAAI,EAAE,mBAAmB,EACzB,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5D,OAAO,CAAC,8BAA8B,CAAC,CAAA;IAC1C,yCAAyC;IACzC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD;AAID,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAuGxF"}

package/dist/agents/memory.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent memory repos: a folder of linked Markdown files with `MEMORY.md` as the entry point, in the
+ * Agent Memory Repo format. These rules decide what a save may contain before it reaches storage.
+ */
+import type { Principal } from "../auth";
+import type { AgentMemoryChange, AgentMemoryFile } from "../storage/agents";
+/** The two repos a conversation reaches: its user's own, and the one the project shares. */
+export type AgentMemoryRepoName = "user" | "project";
+export declare const AGENT_MEMORY_REPO_NAMES: readonly AgentMemoryRepoName[];
+/** The file every repo starts from, and the one rendered into every conversation's prompt. */
+export declare const AGENT_MEMORY_ENTRY = "MEMORY.md";
+export declare const AGENT_MEMORY_LIMITS: {
+    /** `MEMORY.md` is part of every prompt. */
+    readonly entryBytes: number;
+    readonly fileBytes: number;
+    readonly repoBytes: number;
+    readonly pathLength: 256;
+    readonly messageLength: 500;
+};
+/** A link to a path that is not in the repo, found in one of its Markdown files. */
+export interface AgentMemoryLinkWarning {
+    /** The file the link is in. */
+    readonly path: string;
+    readonly link: string;
+}
+/**
+ * The storage id of a repo: `user:<userId>` or `project`. A caller with no user of its own keeps
+ * its memory as `system:<id>`: a project without auth, or app code running as the system, which
+ * then reads a repo no signed-in user's conversation does.
+ */
+export declare function agentMemoryRepoId(repo: AgentMemoryRepoName, owner: Principal | null): string;
+export declare function parseAgentMemoryRepoName(value: string): AgentMemoryRepoName;
+/** Why a path cannot hold a memory file, or `null` when it can. */
+export declare function agentMemoryPathProblem(path: string): string | null;
+/**
+ * Apply `changes` to the repo's current files and check the result, so a save is rejected with
+ * an error the Agent can act on. Returns the repo as the save leaves it.
+ */
+export declare function applyAgentMemoryChanges(current: readonly AgentMemoryFile[], message: string, changes: readonly AgentMemoryChange[]): AgentMemoryFile[];
+/**
+ * Links in the repo's Markdown files that point at no file. A `[[target]]` names a path from the
+ * repo root, with `.md` left out and any other extension kept.
+ */
+export declare function findBrokenAgentMemoryLinks(files: readonly AgentMemoryFile[]): AgentMemoryLinkWarning[];
+/** The distinct `[[link]]` targets in a Markdown file, in the order they first appear. */
+export declare function agentMemoryLinks(contents: string): string[];
+/** The file a link names: `.md` is added unless its last segment already has an extension. */
+export declare function agentMemoryLinkPath(link: string): string;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/agents/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAG3E,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAA;AAEpD,eAAO,MAAM,uBAAuB,EAAE,SAAS,mBAAmB,EAAwB,CAAA;AAE1F,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,cAAc,CAAA;AAE7C,eAAO,MAAM,mBAAmB;IAC9B,2CAA2C;;;;;;CAMnC,CAAA;AAEV,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAS5F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAM3E;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAelE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,eAAe,EAAE,CAgDnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,SAAS,eAAe,EAAE,GAChC,sBAAsB,EAAE,CAY1B;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3D;AAED,8FAA8F;AAC9F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/agents/message.d.ts

@@ -1,6 +1,7 @@
 import type { FileRef } from "../blob-storage";
 import type { JsonValue } from "../json";
 import type { ProviderData } from "../models";
+import type { AgentApprovalCall, AgentApprovalOutcome, AgentApprovalStatus } from "../storage/agents/types";
 import type { AgentContextPart } from "./context/entries";
 /**
  * The agent's own, SDK-independent message. We store messages and threads — not an SDK transport —
@@ -59,6 +60,54 @@ interface AgentToolCallBase {
 export interface AgentContinuationPart {
     readonly type: "continuation";
 }
+/**
+ * How a call the Agent made in an earlier turn ended, once its requester decided on it or it was
+ * set aside. Sixb writes it at the start of the next user message; chats show no text for it.
+ */
+export interface AgentApprovalOutcomePart {
+    readonly type: "approval-outcome";
+    readonly approvalId: string;
+    readonly status: Exclude<AgentApprovalStatus, "pending">;
+    readonly call: AgentApprovalCallSummary;
+    /** What the approved call gave, when it ran. */
+    readonly outcome?: AgentApprovalOutcome;
+    /** The turn's sub-agent that made the call, when the turn did not make it itself. */
+    readonly caller?: AgentApprovalCaller;
+}
+/** A turn's sub-agent that made a call: its run, and the key it was spawned with. */
+export interface AgentApprovalCaller {
+    readonly runId: string;
+    readonly key: string;
+    /** The message resumes the turn and the sub-agent paused on its calls: it goes on. */
+    readonly continues?: true;
+}
+/** The call an approval held, as the model asked for it, without its params. */
+export type AgentApprovalCallSummary = Pick<Extract<AgentApprovalCall, {
+    readonly kind: "action";
+}>, "kind" | "actionId" | "subject"> | Pick<Extract<AgentApprovalCall, {
+    readonly kind: "workflow";
+}>, "kind" | "workflowId">;
+/**
+ * A message a sub-agent read before its next step: today, its parent steering it, or answering the
+ * question it paused on. Sixb writes it in the sub-agent's thread, where the child read it; the
+ * model reads it as data from the sender, never from the user.
+ */
+export interface AgentMailPart {
+    readonly type: "mail";
+    /** The mail's id, the same in the sender's and the reader's records. */
+    readonly id: string;
+    readonly from: "parent";
+    /** `answer`: the reply to the question it asked, `inReplyTo`. */
+    readonly kind: "message" | "answer";
+    /** The question an answer replies to. */
+    readonly inReplyTo?: string;
+    readonly text: string;
+    /**
+     * It came as the reader answered: the sender has not received that answer, so the reader writes
+     * its whole result again.
+     */
+    readonly afterAnswer?: true;
+}
 /** Ordered, hidden provider state required to replay a model response losslessly. */
 export interface AgentProviderStatePart {
     readonly type: "provider-state";
@@ -77,7 +126,7 @@ export type AgentToolCallPart = AgentToolCallBase & ({
     readonly state: "output-error";
     readonly errorText: string;
 });
-export type AgentMessagePart = AgentTextPart | AgentReasoningPart | AgentStepStartPart | AgentFilePart | AgentContextPart | AgentContinuationPart | AgentToolCallPart | AgentProviderStatePart;
+export type AgentMessagePart = AgentTextPart | AgentReasoningPart | AgentStepStartPart | AgentFilePart | AgentContextPart | AgentContinuationPart | AgentApprovalOutcomePart | AgentMailPart | AgentToolCallPart | AgentProviderStatePart;
 export type AgentMessagePartType = AgentMessagePart["type"];
 export type AgentToolCallState = AgentToolCallPart["state"];
 /** The logical agent message the adapters speak and the store persists (as columns). */

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

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

package/dist/agents/model-loop.d.ts

@@ -19,6 +19,17 @@ interface ModelLoopOptions {
     readonly onEvent?: (event: ModelUiChunk) => void | Promise<void>;
     readonly onModelCallEnd?: (event: ModelCallEndEvent) => void | Promise<void>;
     readonly onStepEnd?: (step: ModelStep) => void | Promise<void>;
+    /**
+     * Asked after each step that ran local tools, once `onStepEnd` settled: `true` ends the loop
+     * there, before the next provider call. Its tool results are the last thing the loop produced.
+     */
+    readonly pauseAfterStep?: (step: ModelStep) => boolean | Promise<boolean>;
+    /**
+     * Asked when the model answers without local tools and a step is left, once `onStepEnd` settled,
+     * with that step's index. Messages it returns follow that answer in one more step, instead of the
+     * loop ending on it.
+     */
+    readonly beforeComplete?: (step: ModelStep, stepIndex: number) => readonly ModelMessage[] | undefined | Promise<readonly ModelMessage[] | undefined>;
     readonly generateCallId?: () => string;
 }
 /** Non-text output requires a validator; unvalidated text can only inhabit types accepting string. */
@@ -47,6 +58,13 @@ export type ModelLoopResult<TOutput = string> = {
     readonly steps: readonly ModelStep[];
     readonly partialContent: readonly ModelAssistantPart[];
 };
+/** What a loop given `pauseAfterStep` returns: it may also stop after a step that ran tools. */
+export type PausableModelLoopResult<TOutput = string> = ModelLoopResult<TOutput>
+/** `pauseAfterStep` stopped the loop after the last of these steps. */
+ | {
+    readonly status: "paused";
+    readonly steps: readonly ModelStep[];
+};
 /**
  * Run a provider-neutral, streaming model/tool loop.
  *
@@ -55,6 +73,7 @@ export type ModelLoopResult<TOutput = string> = {
  * Completed steps and partial content contain validated JSON payloads and normalized provider
  * metadata. Trace adapters may project these results directly; storage owns write validation.
  */
+export declare function runModelLoop<TOutput = string>(input: RunModelLoopInput<TOutput> & Required<Pick<ModelLoopOptions, "pauseAfterStep">>): Promise<PausableModelLoopResult<TOutput>>;
 export declare function runModelLoop<TOutput = string>(input: RunModelLoopInput<TOutput>): Promise<ModelLoopResult<TOutput>>;
 export {};
 //# sourceMappingURL=model-loop.d.ts.map

package/dist/agents/model-loop.d.ts.map

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

package/dist/agents/model-routing.d.ts

@@ -0,0 +1,19 @@
+import type { DecisionModelsRuntime, LanguageModelEntry, LanguageModelTierProbabilities, ModelCatalog } from "../models";
+import type { ConversationAgentRunRecord } from "../storage/agents";
+export interface TurnModelChoice {
+    readonly model: LanguageModelEntry;
+    /** The decision model's answer; absent when it failed and the turn aimed for `standard`. */
+    readonly tierProbabilities?: LanguageModelTierProbabilities;
+}
+export interface TurnModelRouter {
+    /** The model of a turn that names none, given the thread's previous turn. */
+    choose(text: string, previous: ConversationAgentRunRecord | undefined): Promise<TurnModelChoice>;
+}
+/**
+ * With tiers, the default decision model picks the tier of each turn, so it must take the question.
+ * Checked at startup: a model that cannot would leave every turn on `standard`, warning each time.
+ */
+export declare function assertTurnModelRouting(models: ModelCatalog | undefined): void;
+/** Sixb picks the model of each turn when the project configures tiers and a decision model. */
+export declare function createTurnModelRouter(models: ModelCatalog | undefined, decision: DecisionModelsRuntime): TurnModelRouter | undefined;
+//# sourceMappingURL=model-routing.d.ts.map

package/dist/agents/model-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-routing.d.ts","sourceRoot":"","sources":["../../src/agents/model-routing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAErB,kBAAkB,EAElB,8BAA8B,EAC9B,YAAY,EACb,MAAM,WAAW,CAAA;AAKlB,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAsCnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,8BAA8B,CAAA;CAC5D;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,0BAA0B,GAAG,SAAS,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CACjG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAS7E;AAED,gGAAgG;AAChG,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,GAAG,SAAS,EAChC,QAAQ,EAAE,qBAAqB,GAC9B,eAAe,GAAG,SAAS,CAe7B"}