@gea-ai/agent-sdk 0.1.261016-alpha.1 → 0.1.261019-alpha.0

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

@@ -46,7 +46,29 @@ export declare function completeAgentSessionInvocation(tx: AgentSessionTransacti
             status: "aborted" | "completed" | "failed";
             occurredAt: string;
             usage: import("ai").LanguageModelUsage | null;
+            termination?: {
+                finishReason?: "length" | "stop" | "tool_calls" | undefined;
+                provider?: {
+                    format: "openai-completions";
+                    reason: "length" | "stop" | "tool_calls";
+                } | {
+                    format: "anthropic-messages";
+                    reason: "end_turn" | "max_tokens" | "refusal" | "stop_sequence" | "tool_use";
+                } | {
+                    format: "openai-responses";
+                    reason: "completed" | "max_output_tokens";
+                } | undefined;
+                step?: number | undefined;
+                attempt?: number | undefined;
+                sessionAttemptId?: string | undefined;
+                requestId?: string | undefined;
+            } | undefined;
         }[] | undefined;
+        diagnostics?: {
+            coreReason: "awaiting_approval" | "awaiting_tool_results" | "cancelled" | "completed" | "failed" | "model_limit" | "step_limit" | "stopped";
+            maxSteps?: number | undefined;
+            maxRetries?: number | undefined;
+        } | undefined;
         attempt: number;
         completedAt: string;
         status: "aborted" | "error" | "finished" | "interrupted";
@@ -76,7 +98,29 @@ export declare function reclaimAgentSessionRun(tx: AgentSessionTransactionStorag
             status: "aborted" | "completed" | "failed";
             occurredAt: string;
             usage: import("ai").LanguageModelUsage | null;
+            termination?: {
+                finishReason?: "length" | "stop" | "tool_calls" | undefined;
+                provider?: {
+                    format: "openai-completions";
+                    reason: "length" | "stop" | "tool_calls";
+                } | {
+                    format: "anthropic-messages";
+                    reason: "end_turn" | "max_tokens" | "refusal" | "stop_sequence" | "tool_use";
+                } | {
+                    format: "openai-responses";
+                    reason: "completed" | "max_output_tokens";
+                } | undefined;
+                step?: number | undefined;
+                attempt?: number | undefined;
+                sessionAttemptId?: string | undefined;
+                requestId?: string | undefined;
+            } | undefined;
         }[] | undefined;
+        diagnostics?: {
+            coreReason: "awaiting_approval" | "awaiting_tool_results" | "cancelled" | "completed" | "failed" | "model_limit" | "step_limit" | "stopped";
+            maxSteps?: number | undefined;
+            maxRetries?: number | undefined;
+        } | undefined;
         attempt: number;
         completedAt: string;
         status: "aborted" | "error" | "finished" | "interrupted";

package/dist/agent-session-execution.js

@@ -1,3 +1,4 @@
+import { agentExecutionDiagnosticsSchema, } from "@gea-ai/contract/agent-usage";
 import { digestAgentSessionMessage } from "./agent-session-transport.js";
 import { getSessionPayload, putSessionPayload } from "./agent-session-payload.js";
 import { agentModelCallsSchema, } from "@gea-ai/contract/agent-usage";
@@ -164,6 +165,8 @@ export async function appendAgentSessionInputMessages(tx, messages, runId) {
     await advanceRevision(tx);
 }
 async function writeValues(tx, input) {
+    if (input.diagnostics !== undefined)
+        await tx.put(key(`diagnostics:${encodeURIComponent(input.runId)}:${encodeURIComponent(input.attemptId)}`), agentExecutionDiagnosticsSchema.parse(input.diagnostics));
     for (const output of input.toolOutputs ?? [])
         await putSessionPayload(tx, `tool-output:${output.id}`, output.content);
     let messageSequence = (await tx.get(key("message-sequence"))) ?? 0;
@@ -352,6 +355,7 @@ export async function completeAgentSessionInvocation(tx, input) {
         input.events.length === 0 &&
         !input.context &&
         input.modelCalls === undefined &&
+        input.diagnostics === undefined &&
         input.toolOutputs === undefined;
     const state = await getAgentSessionRunState(tx, input.runId);
     if (state?.status === "draining")
@@ -375,6 +379,7 @@ export async function completeAgentSessionInvocation(tx, input) {
         input.events.length === 0 &&
         input.context === undefined &&
         input.modelCalls === undefined &&
+        input.diagnostics === undefined &&
         input.toolOutputs === undefined &&
         input.accounting === undefined;
     // Cancelling a waiting turn closes it directly: pausing already revoked its
@@ -386,6 +391,7 @@ export async function completeAgentSessionInvocation(tx, input) {
         input.events.length === 0 &&
         !input.context &&
         input.modelCalls === undefined &&
+        input.diagnostics === undefined &&
         input.toolOutputs === undefined;
     const turn = state?.status === "terminal" &&
         waiting &&
@@ -402,7 +408,11 @@ export async function completeAgentSessionInvocation(tx, input) {
     const previousRevision = await readRevision(tx);
     await writeValues(tx, input);
     const modelCalls = await tx.get(key(`model-calls:${encodeURIComponent(input.runId)}`));
+    const diagnostics = await tx.get(key(`diagnostics:${encodeURIComponent(input.runId)}:${encodeURIComponent(input.attemptId)}`));
     const outcome = {
+        ...(diagnostics === undefined
+            ? {}
+            : { diagnostics: agentExecutionDiagnosticsSchema.parse(diagnostics) }),
         ...(modelCalls === undefined
             ? {}
             : { modelCalls: agentModelCallsSchema.parse(modelCalls) }),
@@ -918,6 +928,7 @@ export async function handleAgentSessionExecutionRequest(request, storage) {
                     input.events.length === 0 &&
                     !input.context &&
                     input.modelCalls === undefined &&
+                    input.diagnostics === undefined &&
                     input.toolOutputs === undefined;
                 const state = await getAgentSessionRunState(tx, input.runId);
                 if (state?.status === "draining")
@@ -943,6 +954,7 @@ export async function handleAgentSessionExecutionRequest(request, storage) {
                     input.events.length === 0 &&
                     input.context === undefined &&
                     input.modelCalls === undefined &&
+                    input.diagnostics === undefined &&
                     input.toolOutputs === undefined &&
                     input.accounting === undefined;
                 const turn = state?.status === "terminal" &&
@@ -960,7 +972,13 @@ export async function handleAgentSessionExecutionRequest(request, storage) {
                 const previousRevision = await readRevision(tx);
                 await writeValues(tx, stored ? { ...input, messages: [] } : input);
                 const modelCalls = await tx.get(key(`model-calls:${encodeURIComponent(input.runId)}`));
+                const diagnostics = await tx.get(key(`diagnostics:${encodeURIComponent(input.runId)}:${encodeURIComponent(input.attemptId)}`));
                 const outcome = {
+                    ...(diagnostics === undefined
+                        ? {}
+                        : {
+                            diagnostics: agentExecutionDiagnosticsSchema.parse(diagnostics),
+                        }),
                     ...(modelCalls === undefined
                         ? {}
                         : { modelCalls: agentModelCallsSchema.parse(modelCalls) }),

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

@@ -124,6 +124,7 @@ export declare function getAppServerSessionAdmission(tx: AgentSessionTransaction
         turnId: string;
         metadata?: Record<string, z.util.JSONType> | undefined;
         messages: {
+            runtimeResourceSourceRunId?: string | undefined;
             id: string;
             runId?: string | undefined;
             sender: {

package/dist/agent-session-inbox.js

@@ -342,6 +342,11 @@ function takeMessages(state, steeringOnly) {
     for (const entry of state.messages) {
         if (steeringOnly && entry.mode !== "steering")
             continue;
+        if (!steeringOnly &&
+            messages.length &&
+            entry.runtimeResourceSourceRunId !==
+                messages[0].runtimeResourceSourceRunId)
+            break;
         const size = new TextEncoder().encode(JSON.stringify(entry)).byteLength;
         const count = (typeof entry.message === "string" ? 1 : entry.message.parts.length) +
             (entry.sender.type === "agent" ? 1 : 0);

package/dist/agent-session-stale-run.d.ts

@@ -13,7 +13,29 @@ export declare function handleStaleAgentSessionRun(storage: AgentSessionStorage,
             status: "aborted" | "completed" | "failed";
             occurredAt: string;
             usage: import("ai").LanguageModelUsage | null;
+            termination?: {
+                finishReason?: "length" | "stop" | "tool_calls" | undefined;
+                provider?: {
+                    format: "openai-completions";
+                    reason: "length" | "stop" | "tool_calls";
+                } | {
+                    format: "anthropic-messages";
+                    reason: "end_turn" | "max_tokens" | "refusal" | "stop_sequence" | "tool_use";
+                } | {
+                    format: "openai-responses";
+                    reason: "completed" | "max_output_tokens";
+                } | undefined;
+                step?: number | undefined;
+                attempt?: number | undefined;
+                sessionAttemptId?: string | undefined;
+                requestId?: string | undefined;
+            } | undefined;
         }[] | undefined;
+        diagnostics?: {
+            coreReason: "awaiting_approval" | "awaiting_tool_results" | "cancelled" | "completed" | "failed" | "model_limit" | "step_limit" | "stopped";
+            maxSteps?: number | undefined;
+            maxRetries?: number | undefined;
+        } | undefined;
         attempt: number;
         completedAt: string;
         status: "aborted" | "error" | "finished" | "interrupted";

package/dist/agent-worker.d.ts

@@ -7,6 +7,7 @@ export { extractChannelReply } from "./agent-channel-api.js";
 import { type AgentInteractionPolicy } from "@gea-ai/contract";
 import type { AgentTracing } from "@gea-ai/contract/agent-tracing";
 import type { AgentContextStrategy } from "./context.js";
+import { agentInitializationFailure } from "@gea-ai/contract/agent-worker-tools";
 import { type AgentSessionInboxExecution } from "@gea-ai/contract/agent-session-inbox";
 import type { AgentWorkerToolInitialization } from "@gea-ai/contract/agent-worker-tools";
 import { type ComputerProcessOperation } from "@gea-ai/contract/computer-commands";
@@ -110,6 +111,9 @@ export type AgentApplicationDefinition = {
 type AgentStartupTiming = {
     startedAt: number;
     phases: Record<string, number>;
+    failure?: ReturnType<typeof agentInitializationFailure> & {
+        phase: string;
+    };
 };
 export declare function composeFetch<TEnvironment, TContext>(...handlers: ReadonlyArray<ComposableFetch<TEnvironment, TContext>>): (request: Request, environment: TEnvironment, context: TContext) => Promise<Response>;
 export declare function createAgentApplicationFetch<TEnvironment extends AgentFetchEnvironment = AgentFetchEnvironment, TContext = unknown>(input: {