@gea-ai/agent-sdk 0.1.261010-alpha.0 → 0.1.261012-alpha.0

package/dist/agent-call.d.ts

@@ -1,6 +1,32 @@
+import { z } from "zod";
 import { type AgentWorkerToolInitialization } from "@gea-ai/contract/agent-worker-tools";
 import type { AgentHostBinding } from "./agent-worker.js";
 import type { StudioArtifactScope } from "@gea-ai/contract/studio-artifacts";
+/** Fresh Sessions keep the declared-target rule. A resume only needs sessionId. */
+export declare function workerAgentToolInputSchema(input: {
+    agents: NonNullable<AgentWorkerToolInitialization["agents"]>;
+    canCopy?: boolean;
+    artifactScope?: StudioArtifactScope;
+}): z.ZodObject<{
+    sessionId: z.ZodOptional<z.ZodUUID>;
+    target: z.ZodOptional<z.ZodString>;
+    message: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        parts: z.ZodArray<z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]> | z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        role: z.ZodLiteral<"user">;
+        parts: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"file">;
+            file_id: z.ZodUUID;
+        }, z.core.$strict>]>>;
+    }, z.core.$strict>]>;
+}, z.core.$strip>;
 /** The host opens a fresh Worker invocation; only its visible answer returns to the caller. */
 export declare function createWorkerAgentTool(input: {
     agents: NonNullable<AgentWorkerToolInitialization["agents"]>;
@@ -14,7 +40,7 @@ export declare function createWorkerAgentTool(input: {
     metadata?: import("@ai-sdk/provider").JSONObject;
     inputSchema: import("ai").FlexibleSchema<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -35,7 +61,7 @@ export declare function createWorkerAgentTool(input: {
     contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
     needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -60,7 +86,7 @@ export declare function createWorkerAgentTool(input: {
     onInputAvailable?: ((options: {
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -83,7 +109,7 @@ export declare function createWorkerAgentTool(input: {
         toolCallId: string;
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -145,7 +171,7 @@ export declare function createWorkerAgentTool(input: {
     }> | undefined;
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -191,7 +217,7 @@ export declare function createWorkerAgentTool(input: {
     inputExamples?: {
         input: NoInfer<{
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -219,7 +245,7 @@ export declare function createWorkerAgentTool(input: {
 } & {
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -263,7 +289,7 @@ export declare function createWorkerAgentTool(input: {
     metadata?: import("@ai-sdk/provider").JSONObject;
     inputSchema: import("ai").FlexibleSchema<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -284,7 +310,7 @@ export declare function createWorkerAgentTool(input: {
     contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
     needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -309,7 +335,7 @@ export declare function createWorkerAgentTool(input: {
     onInputAvailable?: ((options: {
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -332,7 +358,7 @@ export declare function createWorkerAgentTool(input: {
         toolCallId: string;
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -394,7 +420,7 @@ export declare function createWorkerAgentTool(input: {
     }> | undefined;
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -440,7 +466,7 @@ export declare function createWorkerAgentTool(input: {
     inputExamples?: {
         input: NoInfer<{
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -468,7 +494,7 @@ export declare function createWorkerAgentTool(input: {
 } & {
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -512,7 +538,7 @@ export declare function createWorkerAgentTool(input: {
     metadata?: import("@ai-sdk/provider").JSONObject;
     inputSchema: import("ai").FlexibleSchema<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -533,7 +559,7 @@ export declare function createWorkerAgentTool(input: {
     contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
     needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -558,7 +584,7 @@ export declare function createWorkerAgentTool(input: {
     onInputAvailable?: ((options: {
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -581,7 +607,7 @@ export declare function createWorkerAgentTool(input: {
         toolCallId: string;
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -643,7 +669,7 @@ export declare function createWorkerAgentTool(input: {
     }> | undefined;
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -693,7 +719,7 @@ export declare function createWorkerAgentTool(input: {
 } & {
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -737,7 +763,7 @@ export declare function createWorkerAgentTool(input: {
     metadata?: import("@ai-sdk/provider").JSONObject;
     inputSchema: import("ai").FlexibleSchema<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -758,7 +784,7 @@ export declare function createWorkerAgentTool(input: {
     contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
     needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -783,7 +809,7 @@ export declare function createWorkerAgentTool(input: {
     onInputAvailable?: ((options: {
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -806,7 +832,7 @@ export declare function createWorkerAgentTool(input: {
         toolCallId: string;
         input: {
             sessionId?: string | undefined;
-            target: string | undefined;
+            target?: string | undefined;
             message: string | {
                 role: "user";
                 parts: ({
@@ -868,7 +894,7 @@ export declare function createWorkerAgentTool(input: {
     }> | undefined;
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({
@@ -918,7 +944,7 @@ export declare function createWorkerAgentTool(input: {
 } & {
     execute: import("ai").ToolExecuteFunction<{
         sessionId?: string | undefined;
-        target: string | undefined;
+        target?: string | undefined;
         message: string | {
             role: "user";
             parts: ({

package/dist/agent-call.js

@@ -5,20 +5,45 @@ import { parseJsonEventStream } from "@ai-sdk/provider-utils";
 import { tool, uiMessageChunkSchema } from "ai";
 import { agentSubagentConcurrencyErrorSchema, agentRemoteAdmissionErrorSchema, agentCallInputSchema, agentCallTextMessageSchema, agentRunCallResultSchema, getAgentCallFileIds, } from "@gea-ai/contract/agent-worker-tools";
 import { captureTraceContext } from "./trace-context.js";
+/** Fresh Sessions keep the declared-target rule. A resume only needs sessionId. */
+export function workerAgentToolInputSchema(input) {
+    const message = input.artifactScope
+        ? agentCallInputSchema.shape.message
+        : agentCallTextMessageSchema;
+    const keys = new Set(input.agents.map((agent) => agent.key));
+    return z
+        .object({
+        sessionId: z.uuid().optional(),
+        target: z.string().trim().min(1).max(80).optional(),
+        message,
+    })
+        .superRefine((value, context) => {
+        if (value.sessionId)
+            return;
+        if (value.target === undefined) {
+            if (keys.size > 0 && !input.canCopy) {
+                context.addIssue({
+                    code: "custom",
+                    path: ["target"],
+                    message: "A new Session requires a declared target.",
+                });
+            }
+            return;
+        }
+        if (!keys.has(value.target)) {
+            context.addIssue({
+                code: "custom",
+                path: ["target"],
+                message: "Select a declared target for a new Session.",
+            });
+        }
+    });
+}
 /** The host opens a fresh Worker invocation; only its visible answer returns to the caller. */
 export function createWorkerAgentTool(input) {
     return tool({
-        description: `Start an Agent Run in a new or idle child Session. Use runWait with returned runIds and runCancel to cancel. Use sessionId to continue the same Session. ${input.canCopy ? "Omit target to create a copy of yourself." : "Select a declared target."} Available targets: ${JSON.stringify(input.agents)}. Supply context in message.${input.artifactScope ? " To send selected files, use a user message with file parts containing immutable Artifact file_id values. Refer to attachments by filename or order in task text; remote transfer may assign new IDs, exposed to the child in Attached Artifact metadata. IDs hardcoded in text are not rewritten." : ""}`,
-        inputSchema: agentCallInputSchema.extend({
-            target: input.agents.length
-                ? input.canCopy
-                    ? z.enum(input.agents.map((agent) => agent.key)).optional()
-                    : z.enum(input.agents.map((agent) => agent.key))
-                : z.never().optional(),
-            message: input.artifactScope
-                ? agentCallInputSchema.shape.message
-                : agentCallTextMessageSchema,
-        }),
+        description: `Start an Agent Run in a new or idle child Session. Use runWait with returned runIds and runCancel to cancel. Use sessionId to continue the same Session; target may be omitted or name the recorded Agent. ${input.canCopy ? "Omit target to create a copy of yourself." : "Select a declared target for a new Session."} Available targets: ${JSON.stringify(input.agents)}. Supply context in message.${input.artifactScope ? " To send selected files, use a user message with file parts containing immutable Artifact file_id values. Refer to attachments by filename or order in task text; remote transfer may assign new IDs, exposed to the child in Attached Artifact metadata. IDs hardcoded in text are not rewritten." : ""}`,
+        inputSchema: workerAgentToolInputSchema(input),
         execute: async (value, options) => {
             const fileIds = getAgentCallFileIds(value.message);
             const response = await input.host.fetch("/internal/agent-worker-host/v1/agents/runs", {

package/dist/agent-channel-author-runtime.d.ts

@@ -19,19 +19,6 @@ export declare function executeChannelBehavior(input: {
     environment: AgentChannelFetchEnvironment;
     signal: AbortSignal;
 }): Promise<{
-    sequence: number;
-    duplicate: boolean;
-} | {
-    state: AgentChannelJson;
-    intents: {
-        key: string;
-        payload: AgentChannelJson;
-        eventId: string;
-        operationId: string;
-    }[];
-    cursor: number;
-    idempotencyWindowMs?: number | undefined;
-} | {
     status: "sent";
     receipt?: AgentChannelJson | undefined;
 } | {
@@ -56,6 +43,19 @@ export declare function executeChannelBehavior(input: {
         message: string;
         retryable: boolean;
     };
+} | {
+    sequence: number;
+    duplicate: boolean;
+} | {
+    state: AgentChannelJson;
+    intents: {
+        key: string;
+        payload: AgentChannelJson;
+        eventId: string;
+        operationId: string;
+    }[];
+    cursor: number;
+    idempotencyWindowMs?: number | undefined;
 } | {
     events: {
         id: string;

package/dist/agent-run-host.d.ts

@@ -7,6 +7,12 @@ export type { RemoteRunFetch, RemoteRunDestination, RemoteInputFiles, RemoteFile
 export { readWorkerAgentResponse } from "./agent-call.js";
 export { streamManagedAgentSessionRun } from "./agent-session-stream.js";
 export type AgentChildRunSession = (operation: string, body: unknown, traceContext?: TraceContext) => Promise<Response>;
+/**
+ * Renders child Run updates for a parent model turn. Upstream dropped the task-era
+ * helper without a replacement; App Server adapters still need one summary shape.
+ * JSON escaping can expand each character sixfold; leave room for Run identities.
+ */
+export declare function formatAgentChildRunUpdates(runs: Pick<AgentChildRun, "id" | "sessionId" | "agentKey" | "target" | "outcome">[]): string;
 /** Invocation transport only. SDK Sessions own Run state, waits, completion and wakeups. */
 export declare class AgentRunHost {
     private readonly host;
@@ -17,6 +23,8 @@ export declare class AgentRunHost {
     private readonly shutdown;
     constructor(host: {
         session: AgentChildRunSession;
+        /** Native App Server owns Worker handles; this callback only admits the resolved target. */
+        dispatch?(run: AgentChildRun, execution?: AgentSessionInboxExecution): Promise<void>;
         /** Authorize against the root Session and return its retained child binding. */
         resolveSession?(sessionId: string): Promise<Response>;
         remoteFetch?(destination: RemoteRunDestination, path: string, init?: RequestInit): Promise<Response>;

package/dist/agent-run-host.js

@@ -5,6 +5,26 @@ import { agentChildRunSchema, agentChildSessionSchema, getAgentCallFileIds, agen
 import { readWorkerAgentResponse } from "./agent-call.js";
 export { readWorkerAgentResponse } from "./agent-call.js";
 export { streamManagedAgentSessionRun } from "./agent-session-stream.js";
+/**
+ * Renders child Run updates for a parent model turn. Upstream dropped the task-era
+ * helper without a replacement; App Server adapters still need one summary shape.
+ * JSON escaping can expand each character sixfold; leave room for Run identities.
+ */
+export function formatAgentChildRunUpdates(runs) {
+    const textLimit = Math.floor(170_000 / Math.max(1, runs.length) / 6);
+    return `Agent Run updates:\n${JSON.stringify(runs.map(({ id, sessionId, agentKey, target, outcome }) => {
+        const text = outcome?.text ?? "";
+        return {
+            runId: id,
+            sessionId,
+            agentKey,
+            ...(target ? { target } : {}),
+            status: outcome?.status ?? "working",
+            text: text.slice(0, textLimit),
+            ...(text.length > textLimit ? { textTruncated: true } : {}),
+        };
+    }))}`;
+}
 /** Invocation transport only. SDK Sessions own Run state, waits, completion and wakeups. */
 export class AgentRunHost {
     host;
@@ -131,8 +151,26 @@ export class AgentRunHost {
             ...sessionInput,
             ...(authorizedSession ? { authorizedSession } : {}),
         });
-        if (!response.ok)
+        if (!response.ok) {
+            // Bundles from before root-authorized resume use a strict children/start
+            // schema. They reject the unknown authorizedSession field as
+            // invalid_request and cannot admit a Session that is not already on
+            // their ledger. Do not invent a second admission path for them.
+            if (response.status === 400 && authorizedSession) {
+                const body = await Result.tryPromise(() => response.clone().json());
+                if (body.isOk() &&
+                    z
+                        .object({ reason: z.literal("invalid_request") })
+                        .safeParse(body.value).success) {
+                    await response.body?.cancel();
+                    return Response.json({
+                        error: "NESTED_RESUME_REQUIRES_NEW_SDK",
+                        reason: "Rebuild this Agent bundle with the current SDK before resuming a Session opened by another Agent.",
+                    }, { status: 400 });
+                }
+            }
             return response;
+        }
         const { run, scheduled } = agentChildRunStartResultSchema.parse(await response.json());
         if ((await this.host.register(run)) !== run.id)
             throw new Error("Child Run registration did not complete.");
@@ -252,8 +290,17 @@ export class AgentRunHost {
     dispatch(run, inboxExecution) {
         if (this.closed)
             throw new Error("Run dispatcher is stopping.");
-        if (this.executions.has(run.id) || run.outcome)
+        if (this.executions.has(run.id) ||
+            run.outcome ||
+            (run.cancelRequested && run.destination.type !== "remote"))
             return;
+        if (this.host.dispatch && run.destination.type !== "remote") {
+            this.track(this.host.dispatch(run, inboxExecution), {
+                runId: run.id,
+                sessionId: run.sessionId,
+            });
+            return;
+        }
         const cancellation = new AbortController();
         this.executions.set(run.id, cancellation);
         this.host.onEvent?.({

package/dist/agent-session-children.js

@@ -4,7 +4,7 @@ import { readTraceContext } from "./trace-context.js";
 import { traceContextSchema } from "@gea-ai/contract/traces";
 import { DEFAULT_MAX_CONCURRENT_SUBAGENTS, maxConcurrentSubagentsSchema, } from "@gea-ai/contract/agent-packages";
 import { AGENT_SUBAGENT_CONCURRENCY_HEADER, agentChildRunSchema, agentChildSessionSchema, agentChildRunStartInputSchema, agentChildRunDestinationSchema, agentChildRunOutcomeSchema, agentChildRunListInputSchema, } from "@gea-ai/contract/agent-worker-tools";
-import { notifyAgentSessionChildRun, scheduleAgentSessionChildRunChanges, queueAgentSessionChildRun, acceptAgentSessionChildRun, inheritedAgentSessionMetadata, } from "./agent-session-inbox.js";
+import { notifyAgentSessionChildRun, scheduleAgentSessionChildRunChanges, queueAgentSessionChildRun, acceptAgentSessionChildRun, isAgentSessionAdmissionBlocked, inheritedAgentSessionMetadata, } from "./agent-session-inbox.js";
 import { getChildRun, getChildSession, listChildRuns, putChildRun, readChildRunIndex, readChildRuns, saveChildRunIndex, } from "./agent-session-child-store.js";
 const runIdSchema = z.strictObject({ runId: z.uuid() });
 const startSchema = agentChildRunStartInputSchema.extend({
@@ -88,6 +88,8 @@ export async function handleAgentSessionChildren(request, storage) {
             }
             case "start":
             case "reserve": {
+                if (await isAgentSessionAdmissionBlocked(tx))
+                    return Response.json({ error: "session_archived" }, { status: 409 });
                 const input = startSchema.parse(value);
                 const remote = path.endsWith("/reserve");
                 const index = await readChildRunIndex(tx);

package/dist/agent-session-execution.d.ts

@@ -1,2 +1,88 @@
-import type { AgentSessionStorage } from "./agent-session.js";
+import { agentSessionExecutionCompleteSchema, agentSessionExecutionPauseSchema, agentSessionExecutionStartSchema, type AgentSessionMessage } from "@gea-ai/contract/agent-session";
+import { z } from "zod";
+import type { AgentSessionStorage, AgentSessionTransactionStorage } from "./agent-session.js";
+export declare class SessionProtocolError extends Error {
+    readonly reason: string;
+    readonly status: number;
+    constructor(reason: string, status?: number);
+}
+/** Inbox admission/consumption and its UI history commit in the same Session transaction. */
+export declare function appendAgentSessionInputMessages(tx: AgentSessionTransactionStorage, messages: AgentSessionMessage[], runId: string): Promise<void>;
+/** Shared by managed admission and inbox begin, within the same Session transaction. */
+export declare function startAgentSessionInvocation(tx: AgentSessionTransactionStorage, input: z.infer<typeof agentSessionExecutionStartSchema>): Promise<{
+    duplicate: boolean;
+    revision: number;
+    turn: {
+        packageVersionId: string;
+        requestId: string;
+        runId: string;
+        workerDeploymentId: string;
+        status: "running" | "waiting";
+        cancelRequestedAt: string | null;
+        activeStreamId: string | null;
+        attempt: number;
+        attemptId: string;
+        leaseExpiresAt: string;
+        leaseOwner: "host" | "worker";
+        nextMutationSequence: number;
+        lastMutation: {
+            digest: string;
+            revision: number;
+        } | null;
+    };
+}>;
+/** Commit a logical terminal in the caller's Session transaction. */
+export declare function completeAgentSessionInvocation(tx: AgentSessionTransactionStorage, input: z.output<typeof agentSessionExecutionCompleteSchema>): Promise<{
+    duplicate: boolean;
+    outcome: {
+        attemptId: string;
+        runId: string;
+        modelCalls?: {
+            callId: string;
+            runId: string;
+            source: "agent" | "context";
+            label?: string | undefined;
+            model: string;
+            status: "aborted" | "completed" | "failed";
+            occurredAt: string;
+            usage: import("ai").LanguageModelUsage | null;
+        }[] | undefined;
+        attempt: number;
+        completedAt: string;
+        status: "aborted" | "error" | "finished" | "interrupted";
+        revision: number;
+        accounting?: {
+            eventType: "completed" | "failed";
+            model: string;
+            provider: string;
+            pricingKey?: string | undefined;
+            resourceSnapshot: Record<string, unknown>;
+            metadata?: Record<string, unknown> | undefined;
+            usage?: import("ai").LanguageModelUsage | null | undefined;
+        } | undefined;
+    };
+}>;
+/** Park the active attempt as waiting, in the caller's Session transaction. */
+export declare function pauseAgentSessionInvocation(tx: AgentSessionTransactionStorage, input: z.output<typeof agentSessionExecutionPauseSchema>): Promise<{
+    duplicate: boolean;
+    turn: {
+        packageVersionId: string;
+        requestId: string;
+        runId: string;
+        workerDeploymentId: string;
+        status: "running" | "waiting";
+        cancelRequestedAt: string | null;
+        activeStreamId: string | null;
+        attempt: number;
+        attemptId: string;
+        leaseExpiresAt: string;
+        leaseOwner: "host" | "worker";
+        nextMutationSequence: number;
+        lastMutation: {
+            digest: string;
+            revision: number;
+        } | null;
+    };
+    revision: number;
+}>;
 export declare function handleAgentSessionExecutionRequest(request: Request, storage: AgentSessionStorage): Promise<Response>;