@sixb/core 0.1.20 → 0.1.22

package/dist/agents/execution.d.ts

@@ -1,53 +1,219 @@
+import { type UserPrincipal } from "../auth";
 import type { AuthorizablePrincipal, ExecutionContext } from "../execution";
-import type { ModelCatalog } from "../models";
+import type { DecisionModelsRuntime, ModelCatalog } from "../models";
 import type { SixbDependencies } from "../runtime/sixb";
 import type { SixbRuntimeContext } from "../runtime/types";
-import type { AgentThreadRecord, ConversationAgentRunRecord, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult } from "../storage/agents";
+import type { SecurityDefinitionCatalog } from "../security";
+import type { AgentApprovalMode, AgentApprovalRecord, ConversationAgentRunRecord, ListAgentApprovalsInput, ListAgentApprovalsResult, ListAgentRunsInput, ListAgentRunsResult, ListAgentThreadsInput, ListAgentThreadsResult, SubagentRunRecord } from "../storage/agents";
 import type { AiCostSummary } from "../storage/ai-cost";
 import type { AiModelCallUsage } from "../storage/ai-usage";
+import { type ResolvedAgentApprovalMode } from "./approvals";
+import { type AgentChildView } from "./children";
+import { type AgentMemoryRuntime } from "./memory-execution";
+import { type AgentThreadParticipantInput } from "./participants";
 import { type RequestAgentRunInput, type RequestAgentRunResult } from "./request";
+import { type AgentThreadView } from "./thread-access";
 import type { AgentDescriptor } from "./types";
 export type ExecutionAgentRequestInput = Omit<RequestAgentRunInput, "principal">;
-export type ListExecutionAgentThreadsInput = Omit<ListAgentThreadsInput, "projectId" | "ownerPrincipal">;
+export type ListExecutionAgentThreadsInput = Omit<ListAgentThreadsInput, "projectId" | "ownerPrincipal" | "participantPrincipal"> & {
+    /** The threads other users added the caller to, instead of the caller's own. */
+    readonly sharedWithMe?: boolean;
+};
+export interface ListAgentThreadViewsResult extends Omit<ListAgentThreadsResult, "threads"> {
+    readonly threads: readonly AgentThreadView[];
+}
 export type CreateExecutionAgentThreadInput<TParams extends Record<string, unknown> = Record<string, unknown>> = {
     readonly id?: string;
     readonly title?: string;
     readonly sandbox?: TParams;
 };
 export type AgentThreadsRuntime<TParams extends Record<string, unknown> = Record<string, unknown>> = {
-    /** Start fresh after uncertain recovery; never deletes the previous sandbox. */
+    /** Start fresh after uncertain recovery; never deletes the previous sandbox. Owner only. */
     recreateSandbox(threadId: string, input: {
         readonly expectedSandboxName: string;
-    }): Promise<AgentThreadRecord>;
-    create(input: CreateExecutionAgentThreadInput<TParams>): Promise<AgentThreadRecord>;
-    getById(threadId: string): Promise<AgentThreadRecord | null>;
-    list(input?: ListExecutionAgentThreadsInput): Promise<ListAgentThreadsResult>;
+    }): Promise<AgentThreadView>;
+    create(input: CreateExecutionAgentThreadInput<TParams>): Promise<AgentThreadView>;
+    /**
+     * Copy a thread of the caller's, or one shared with them, into a new one the caller owns alone,
+     * with a new sandbox. A turn still running is not copied.
+     */
+    fork(threadId: string): Promise<AgentThreadView>;
+    /** A thread the caller owns or takes part in. */
+    getById(threadId: string): Promise<AgentThreadView | null>;
+    /** The caller's own threads, or with `sharedWithMe` the ones other users added it to. */
+    list(input?: ListExecutionAgentThreadsInput): Promise<ListAgentThreadViewsResult>;
+    /**
+     * The sub-agents a conversation's turns spawned, oldest first, each the thread it works in with
+     * every run it took; `null` when the caller cannot read the conversation. `runId` keeps those
+     * one turn spawned. A sub-agent is visible exactly when its conversation is.
+     */
+    listChildren(threadId: string, input?: ListAgentChildrenInput): Promise<AgentChildListResult | null>;
+    /** The sub-agent that works in a thread, read as `listChildren` lists it. */
+    getChild(threadId: string): Promise<AgentChildView | null>;
+    /** Who else reads the conversation and talks in it. */
+    readonly participants: AgentThreadParticipantsRuntime;
+    /**
+     * The caller's mode in a thread they read, and where it comes from: their choice there, else
+     * their default, else the fallback.
+     */
+    getApprovalMode(threadId: string): Promise<ResolvedAgentApprovalMode | null>;
+    /**
+     * Choose the caller's own mode for their next turns in a thread; `null` follows their default
+     * again. Others keep theirs.
+     */
+    setApprovalMode(threadId: string, mode: AgentApprovalMode | null): Promise<ResolvedAgentApprovalMode>;
 };
+/**
+ * The calls the Agent held for approval. Whoever reads a thread reads its approvals; only whoever
+ * asked for the turn decides, since the call runs with their rights.
+ */
+export interface AgentApprovalsRuntime {
+    /**
+     * A thread's approvals, oldest first; without `threadId`, the caller's own in the threads they
+     * can open.
+     */
+    list(input?: ListExecutionAgentApprovalsInput): Promise<ListAgentApprovalsResult>;
+    getById(approvalId: string): Promise<AgentApprovalRecord | null>;
+    /**
+     * Approve or deny a pending call. An approved call runs now, and the approval comes back with its
+     * outcome. Once every call the turn held is decided, the turn resumes: `run` is the turn that
+     * continues it, and the model reads how each call ended. `always` also sets the caller's mode in
+     * the thread to the least that runs such a call without asking, and approves the turn's other
+     * calls that mode runs.
+     */
+    decide(approvalId: string, input: DecideExecutionAgentApprovalInput): Promise<AgentApprovalDecision>;
+}
+export interface AgentApprovalDecision {
+    readonly approval: AgentApprovalRecord;
+    /** The turn that resumed the paused one, when this decision was its last. */
+    readonly run?: ConversationAgentRunView;
+    /**
+     * Present when the paused turn could not resume: the decision and the call's outcome stand.
+     * `retrying`: Sixb resumes it once it can, for example when an AI limit resets; otherwise the
+     * thread's next message tells the model how its calls ended.
+     */
+    readonly resume?: {
+        readonly status: "refused";
+        readonly code: string;
+        readonly message: string;
+        readonly retrying: boolean;
+    };
+}
+export type ListExecutionAgentApprovalsInput = Omit<ListAgentApprovalsInput, "projectId" | "requestedBy" | "reported">;
+export interface DecideExecutionAgentApprovalInput {
+    readonly decision: "approve" | "deny";
+    readonly always?: boolean;
+}
+/** The caller's own Agent settings. */
+export interface AgentPreferences {
+    /** The mode of the caller's turns in threads where they chose none. */
+    readonly approvalMode: AgentApprovalMode;
+    /** `fallback` until the caller chooses a default. */
+    readonly approvalModeSource: "default" | "fallback";
+}
+export interface AgentPreferencesRuntime {
+    get(): Promise<AgentPreferences>;
+    update(input: {
+        readonly approvalMode?: AgentApprovalMode;
+    }): Promise<AgentPreferences>;
+}
+/**
+ * Participants read the whole conversation, its files and its live stream, and send messages that
+ * run with their own rights. Nothing checks what they may see: the conversation holds what the
+ * Agent read with the rights of whoever asked.
+ */
+export interface AgentThreadParticipantsRuntime {
+    /**
+     * Add active users of the project, by id or by email; only the thread's owner can. Someone
+     * already taking part keeps when and by whom they were added. Returns the thread with every
+     * participant.
+     */
+    add(threadId: string, users: readonly AgentThreadParticipantInput[]): Promise<AgentThreadView>;
+    /**
+     * The owner removes anyone; a participant removes only themself, to leave. Removing someone who
+     * does not take part changes nothing.
+     */
+    remove(threadId: string, user: UserPrincipal): Promise<void>;
+}
+/**
+ * Any user's conversation, read-only, for a caller with `can.observe(agent.threads)`. Nothing here
+ * checks who owns or takes part in a thread, and nothing writes: those stay on `threads` and `runs`.
+ */
+export interface ObservedAgentThreadsRuntime {
+    /** Throws an `AuthorizationError` without `can.observe(agent.threads)`. */
+    getById(threadId: string): Promise<AgentThreadView | null>;
+    /** The thread's conversation runs; `null` when the thread does not exist. */
+    listRuns(threadId: string, input?: Omit<ListAgentRunsInput, "projectId" | "threadId">): Promise<AgentRunListResult | null>;
+    /** The sub-agents the thread's turns spawned; `null` when the thread is not a conversation. */
+    listChildren(threadId: string, input?: ListAgentChildrenInput): Promise<AgentChildListResult | null>;
+    /** The sub-agent that works in a thread; `null` when it is not a sub-agent's. */
+    getChild(threadId: string): Promise<AgentChildView | null>;
+}
 export interface AgentRunsRuntime {
     request(input: ExecutionAgentRequestInput): Promise<ExecutionAgentRunResult>;
+    /**
+     * Retry a failed or interrupted turn; only whoever asked for it can, as it runs with their rights.
+     * A sub-agent's run is never retried: its turn decides whether to spawn it again.
+     */
     retry(runId: string): Promise<ExecutionAgentRunResult>;
+    /**
+     * Stop a turn; whoever asked for it, or the thread's owner, can. A queued turn is cancelled when
+     * this returns; a running one is still running, with the stop signal sent to its worker. A turn
+     * paused for approval stays as it ended, with its held calls cancelled: it never resumes. A
+     * sub-agent's run stops as its turn would: whoever asked for that turn, or the conversation's
+     * owner, can, and its parent's `wait_agent` reads that it was stopped.
+     */
+    cancel(runId: string): Promise<AgentRunView>;
+    /** A turn, or a sub-agent's run, read through its thread. */
     getById(runId: string): Promise<AgentRunView | null>;
+    /** A conversation's turns, or the runs of a sub-agent's thread. */
     listForThread(threadId: string, input?: Omit<ListAgentRunsInput, "projectId" | "threadId">): Promise<AgentRunListResult | null>;
 }
-/** Execution-facing run view with provenance resolved from the immutable execution ledger. */
-export interface AgentRunView extends ConversationAgentRunRecord {
+export interface ListAgentChildrenInput {
+    /** Only those this turn of the conversation spawned. */
+    readonly runId?: string;
+}
+export interface AgentChildListResult {
+    /** Oldest first. */
+    readonly children: readonly AgentChildView[];
+}
+/**
+ * Execution-facing run view with provenance resolved from the immutable execution ledger: a
+ * conversation turn, or a sub-agent's run.
+ */
+export type AgentRunView = ConversationAgentRunView | SubagentRunView;
+/** A conversation turn's view: what a request, a retry or a resume returns. */
+export type ConversationAgentRunView = ConversationAgentRunRecord & AgentRunViewFields;
+/** A sub-agent's run, read through its thread. */
+export type SubagentRunView = SubagentRunRecord & AgentRunViewFields;
+interface AgentRunViewFields {
     readonly requestedBy?: AuthorizablePrincipal;
-    /** Derived from the model-call ledger; never persisted on the Agent run row. */
+    /**
+     * Derived from the model-call ledger; never persisted on the Agent run row. Covers the turn and
+     * everything below its execution: its children and what its tools ran, including what a workflow
+     * it started spends after the turn ends, as Activity counts it.
+     */
     readonly usage?: AiModelCallUsage;
-    /** Preferred valuation; omitted when there are no calls or cost storage is unavailable. */
+    /** Preferred valuation of the same calls; omitted without calls or cost storage. */
     readonly cost?: AiCostSummary;
 }
 export interface AgentRunListResult extends Omit<ListAgentRunsResult, "runs"> {
     readonly runs: readonly AgentRunView[];
 }
 export interface ExecutionAgentRunResult extends Omit<RequestAgentRunResult, "run"> {
-    readonly run: AgentRunView;
+    readonly run: ConversationAgentRunView;
 }
 export type AgentRuntime<TParams extends Record<string, unknown> = Record<string, unknown>> = {
     /** Null when no language models are configured or the caller cannot run the Agent. */
     get(): AgentDescriptor | null;
     readonly threads: AgentThreadsRuntime<TParams>;
     readonly runs: AgentRunsRuntime;
+    /** Other users' conversations, read-only, with `can.observe(agent.threads)`. */
+    readonly observed: ObservedAgentThreadsRuntime;
+    readonly memory: AgentMemoryRuntime;
+    readonly approvals: AgentApprovalsRuntime;
+    readonly preferences: AgentPreferencesRuntime;
 };
-export declare function createAgentRuntime<TParams extends Record<string, unknown> = Record<string, unknown>>(runtime: SixbRuntimeContext, execution: ExecutionContext, models?: ModelCatalog, sandbox?: SixbDependencies["sandbox"]): AgentRuntime<TParams>;
+export declare function createAgentRuntime<TParams extends Record<string, unknown> = Record<string, unknown>>(runtime: SixbRuntimeContext, execution: ExecutionContext, models: ModelCatalog | undefined, decision: DecisionModelsRuntime, sandbox: SixbDependencies["sandbox"] | undefined, security: SecurityDefinitionCatalog): AgentRuntime<TParams>;
+export {};
 //# sourceMappingURL=execution.d.ts.map

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

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

package/dist/agents/fork.d.ts

@@ -0,0 +1,16 @@
+import type { Principal } from "../auth";
+import type { SixbDependencies } from "../runtime/sixb";
+import type { SixbRuntimeContext } from "../runtime/types";
+import { type AgentThreadRecord } from "../storage/agents";
+/**
+ * Copy a thread of the caller's, or one shared with them, into a new thread the caller owns alone.
+ *
+ * The caller has already checked that `source` is visible. A workspace binding is checked again
+ * against the project's current sandbox definition, and the fork gets a sandbox of its own.
+ */
+export declare function forkAgentThread(runtime: SixbRuntimeContext, input: {
+    readonly source: AgentThreadRecord;
+    readonly ownerPrincipal: Principal;
+    readonly sandbox?: SixbDependencies["sandbox"];
+}): Promise<AgentThreadRecord>;
+//# sourceMappingURL=fork.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/agents/fork.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAQ7E;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE;IACL,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAA;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;CAC/C,GACA,OAAO,CAAC,iBAAiB,CAAC,CA8D5B"}

package/dist/agents/ids.d.ts

@@ -9,11 +9,18 @@ export declare function createAgentThreadSandboxName(projectId: string, threadId
 export declare function createAgentRunId(): string;
 /** One stable child identity per parent-selected spawn key. */
 export declare function createSubagentRunId(parentRunId: string, spawnKey: string): string;
+/**
+ * The thread a child works in, named after the turn that spawned it and its key. It shares its
+ * first run's digest: migration `subagent-threads` names the threads of earlier children so.
+ */
+export declare function createSubagentThreadId(spawningRunId: string, spawnKey: string): string;
 /** Stable execution identity paired with a deterministic child run. */
 export declare function createSubagentExecutionId(runId: string): string;
 export declare function createAgentMessageId(): string;
 /** One deterministic context-checkpoint identity per conversational run. */
 export declare function agentContextCheckpointId(runId: string): string;
+/** A checkpoint copied into a fork; the source's checkpoint keeps its run-derived id. */
+export declare function createCopiedAgentContextCheckpointId(): string;
 /** A queue delivery's fencing token for writes to an `agent_runs` record. */
 export declare function createAgentRunExecutionToken(): string;
 //# sourceMappingURL=ids.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/agents/ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOjF;AAED,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/agents/ids.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtF;AAMD,uEAAuE;AACvE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,yFAAyF;AACzF,wBAAgB,oCAAoC,IAAI,MAAM,CAE7D;AAED,6EAA6E;AAC7E,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}

package/dist/agents/index.d.ts

@@ -1,11 +1,19 @@
 export type { PropertyClearance } from "../objects/property-clearance";
+export { captureSandboxEnv, sandboxCredentialIssue, staticSandboxRecipe, } from "../sandboxes/configuration";
 export type { AgentFileDataProjection, AgentFileDataResolverInput, AgentToolResultFileResolverInput, ToModelMessagesOptions, } from "./adapters";
 export { toModelMessages } from "./adapters";
 export type { AgentApiGatewayCapabilityInput, AgentApiRoute } from "./api-gateway";
-export { AGENT_API_GATEWAY_PREFIX, AGENT_API_ROUTES, createAgentApiGatewayCapability, isAllowedAgentApiRequest, isValidAgentApiGatewayCapability, } from "./api-gateway";
+export { AGENT_API_GATEWAY_PREFIX, AGENT_API_ROUTES, createAgentApiGatewayCapability, findAgentApiRoute, isAllowedAgentApiRequest, isValidAgentApiGatewayCapability, } from "./api-gateway";
+export type { AgentApprovalResume } from "./approval-continuation";
+export { resumeDecidedAgentTurn } from "./approval-continuation";
+export { getAgentApprovalExecutor } from "./approval-executor";
+export type { AgentApprovalCallerRun, AgentApprovalHold, AgentChildApprovalAwaiting, } from "./approvals";
+export { AGENT_APPROVAL_EXECUTION_LEASE_MS, agentApprovalCallers, agentRunApprovalMode, announceAgentApprovals, approvalCallSummary, hasActiveChildren, holdAgentApprovalCall, isAwaitingApprovalRun, isPausedSubagentRun, listChildApprovalsAwaiting, listTurnApprovals, stopAgentTurn, turnPausesOnHeldCalls, turnResumeReadiness, } from "./approvals";
 export type { AgentExecutionAuthorization, AgentExecutionIdentity } from "./authority";
-export { agentServiceAccountId, ensureManagedAgentExecutionIdentity, resolveAgentExecutionAuthorization, resolveAgentPropertyClearance, resolveInheritedAgentExecutionAuthorization, } from "./authority";
+export { agentServiceAccountId, ensureManagedAgentExecutionIdentity, resolveAgentExecutionAuthorization, resolveAgentPropertyClearance, resolveInheritedAgentExecutionAuthorization, userCanRunAgent, } from "./authority";
 export { defineAgentTool } from "./builders";
+export type { AgentChildQuestion } from "./child-question";
+export { deferredChildQuestion, isAwaitingAnswerRun } from "./child-question";
 export type { AgentContextEntryInput, AgentContextInput, AgentContextOrigin, AgentContextPart, } from "./context/entries";
 export { agentContext, agentContextFingerprint, agentContextIdentity, MAX_AGENT_APP_STATE_ENTRY_BYTES, MAX_AGENT_APP_STATE_TOTAL_BYTES, MAX_AGENT_CONTEXT_ENTRIES, normalizeAgentContextEntries, } from "./context/entries";
 export type { AgentContextCompactionBoundary, AgentContextEstimateTool, AgentContextTokenEstimate, EstimateAgentContextRequestTokensInput, } from "./context-compaction";
@@ -15,20 +23,24 @@ export { resolveAgentContextParts } from "./context-resolution";
 export type { AgentRunDispatchFailure, DispatchedAgentRun, DispatchQueuedAgentRunsInput, DispatchQueuedAgentRunsResult, } from "./dispatch";
 export { agentRunQueueJobId, dispatchQueuedAgentRuns, dispatchQueuedSubagentRuns, subagentRunQueueJobId, workflowAgentNodeQueueJobId, } from "./dispatch";
 export { AgentDefinitionError, AgentRequestError, type AgentRequestErrorCode, AgentToolPublicError, AgentToolResultValidationError, } from "./errors";
-export { agentContextCheckpointId, createAgentMessageId, createAgentRunExecutionToken, createAgentRunId, createAgentThreadId, createAgentThreadSandboxName, createSubagentExecutionId, createSubagentRunId, } from "./ids";
-export { AGENT_MESSAGE_CONTENT_VERSION, type AgentContinuationPart, type AgentFilePart, type AgentMessage, type AgentMessagePart, type AgentMessagePartType, type AgentMessageRole, type AgentProviderStatePart, type AgentReasoningPart, type AgentStepStartPart, type AgentTextPart, type AgentToolCallPart, type AgentToolCallState, } from "./message";
-export type { ModelLoopResult, PrepareModelStepInput, PrepareModelStepResult, RunModelLoopInput, } from "./model-loop";
+export { agentContextCheckpointId, createAgentMessageId, createAgentRunExecutionToken, createAgentRunId, createAgentThreadId, createAgentThreadSandboxName, createSubagentExecutionId, createSubagentRunId, createSubagentThreadId, } from "./ids";
+export { AGENT_MESSAGE_CONTENT_VERSION, type AgentApprovalCaller, type AgentApprovalCallSummary, type AgentApprovalOutcomePart, type AgentContinuationPart, type AgentFilePart, type AgentMailPart, type AgentMessage, type AgentMessagePart, type AgentMessagePartType, type AgentMessageRole, type AgentProviderStatePart, type AgentReasoningPart, type AgentStepStartPart, type AgentTextPart, type AgentToolCallPart, type AgentToolCallState, } from "./message";
+export type { ModelLoopResult, PausableModelLoopResult, PrepareModelStepInput, PrepareModelStepResult, RunModelLoopInput, } from "./model-loop";
 export { runModelLoop } from "./model-loop";
 export { agent } from "./reference";
 export { isRetryableAgentRun, type RequestAgentRunInput, type RequestAgentRunResult, requestAgentRun, retryAgentRun, } from "./request";
+export type { AgentRunExecutionScope, AgentRunScopeAuthority, AgentRunScopeErrorCode, AgentRunScopeHost, } from "./run-scope";
+export { AgentRunScopeError, resolveAgentRunExecutionScope } from "./run-scope";
 export type { AgentDefinitions, AgentDefinitionsInput, AgentProjectFile, AgentSkillCatalog, AgentSkillDefinition, } from "./skills";
-export type { AgentCompactionFailureCode, AgentRunControlStreamId, AgentRunFailure, AgentRunFinishedEvent, AgentRunStreamEvent, AgentRunStreamId, } from "./streams/protocol";
-export { AGENT_COMPACTION_FAILURE_CODES, AGENT_RUN_CANCEL_RECORD, AGENT_RUN_STREAM_SCHEMA_VERSION, agentRunControlStreamDefinition, agentRunControlStreamId, agentRunFinishedEvent, agentRunStreamDefinition, agentRunStreamId, agentRunStreamIdempotencyKey, DEFAULT_AGENT_RUN_STREAM_RETENTION, isAgentRunStreamEvent, publishAgentRunCancel, publishAgentRunFinished, subscribeAgentRunCancel, } from "./streams/protocol";
+export type { AgentCompactionFailureCode, AgentMail, AgentRunControlStreamId, AgentRunFailure, AgentRunFinishedEvent, AgentRunStreamEvent, AgentRunStreamId, ReceivedAgentMail, } from "./streams/protocol";
+export { AGENT_COMPACTION_FAILURE_CODES, AGENT_RUN_CANCEL_RECORD, AGENT_RUN_STREAM_SCHEMA_VERSION, agentRunControlStreamDefinition, agentRunControlStreamId, agentRunFinishedEvent, agentRunInboxStreamId, agentRunStreamDefinition, agentRunStreamId, agentRunStreamIdempotencyKey, agentThreadInboxStreamId, DEFAULT_AGENT_RUN_STREAM_RETENTION, isAgentRunStreamEvent, isKnownAgentMailKind, publishAgentMail, publishAgentRunCancel, publishAgentRunFinished, readAgentMail, subscribeAgentInbox, subscribeAgentMail, subscribeAgentRunCancel, } from "./streams/protocol";
+export { listSubagentThreadRuns } from "./subagent-runs";
+export { assertConversationThread, conversationThreadId } from "./thread-access";
 export type { AgentThreadModelContextMessage, ProjectAgentThreadModelContextInput, } from "./thread-context-projection";
 export { projectAgentThreadModelContext } from "./thread-context-projection";
 export type { AgentToolCatalog } from "./tool-catalog";
 export { isAgentToolResult } from "./tool-result";
-export type { AgentDescriptor, AgentReasoning, AgentReference, AgentToolArtifact, AgentToolArtifactPutInput, AgentToolArtifacts, AgentToolAttachments, AgentToolContent, AgentToolDefinition, AgentToolDescriptionBuilder, AgentToolFileContent, AgentToolHandler, AgentToolHandlerResult, AgentToolInputBuilder, AgentToolInputSchema, AgentToolResult, AgentToolRunBuilder, AgentToolRunContext, AgentToolRunInfo, AgentToolRuntimeFacade, AgentToolTextContent, AgentUsageReference, InferAgentToolInput, InferAgentToolInputSchema, } from "./types";
+export type { AgentDescriptor, AgentMemoryReference, AgentReasoning, AgentReference, AgentThreadsReference, AgentToolAttachments, AgentToolContent, AgentToolDefinition, AgentToolDescriptionBuilder, AgentToolFile, AgentToolFileContent, AgentToolFilePutInput, AgentToolFiles, AgentToolHandler, AgentToolHandlerResult, AgentToolInputBuilder, AgentToolInputSchema, AgentToolResult, AgentToolRunBuilder, AgentToolRunContext, AgentToolRunInfo, AgentToolRuntimeFacade, AgentToolTextContent, AgentUsageReference, InferAgentToolInput, InferAgentToolInputSchema, InferAgentToolOutput, } from "./types";
 export { AGENT_REASONING_LEVELS } from "./types";
 export { AGENT_RESERVED_TOOL_NAMES, isAgentToolDefinition, validateAndNormalizeAgentToolInput, } from "./validation";
 //# sourceMappingURL=index.d.ts.map

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

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