@gea-ai/agent-sdk 0.1.261016-alpha.0 → 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-context.js

@@ -484,59 +484,6 @@ function makeSummaryMessage(summaryText) {
         ].join("\n"),
     };
 }
-function makeFallbackSummary(chatId, error) {
-    const message = getCompactionErrorMessage(error);
-    const summaryText = [
-        "## Current Goal\n- Continue from the recent raw tail.",
-        "## User Requirements and Constraints\n- Recover older exact details from raw chat history when needed.",
-        "## Important Decisions\n- Older history was dropped after context compaction failed.",
-        "## Progress So Far\n- No reliable compact summary was produced.",
-        "## Files, Artifacts, and Paths\n### Read\n- Unknown.\n### Modified\n- Unknown.\n### Created\n- Unknown.\n### Offloaded Artifacts\n- Check the recent tail and raw history.",
-        "## Tool Results and Observations Worth Preserving\n- Unknown from failed compaction.",
-        "## Errors, Failed Attempts, and Warnings\n- Context compaction failed; details are in runtime metadata.",
-        "## Open Questions\n- Whether older raw history is still needed.",
-        "## Next Steps\n- Continue from the recent tail and recover raw history if required.",
-        "## Critical Exact Details\n- The compactable raw history remains available through chat history.",
-        `## Raw Chat Recovery\n- Chat id: \`${chatId}\`.\n- Use \`gea chat messages\` to retrieve exact raw messages.`,
-    ].join("\n\n");
-    return {
-        contextSummary: {
-            compactionError: { message, partialSummaryText: false },
-            createdAt: new Date().toISOString(),
-            rawHistoryRecovery: { chatId },
-            summaryText,
-        },
-    };
-}
-function getCompactionErrorMessage(error) {
-    return error instanceof Error && error.message.trim()
-        ? error.message.trim().slice(0, 1_000)
-        : "Unknown summarizer error";
-}
-function makePartialSummary(input) {
-    const missingHeadings = REQUIRED_SUMMARY_HEADINGS.filter((heading) => !input.summaryText.includes(heading));
-    return {
-        compactionError: {
-            message: getCompactionErrorMessage(input.error),
-            partialSummaryText: true,
-        },
-        createdAt: new Date().toISOString(),
-        rawHistoryRecovery: { chatId: input.chatId },
-        summaryText: [
-            "## Context Compaction Warning",
-            "- The summarizer stream failed after producing partial text. Verify important details against raw history.",
-            "",
-            input.summaryText.trim(),
-            "",
-            "## Raw Chat Recovery",
-            `- Chat id: \`${input.chatId}\`.`,
-            "- Use `gea chat messages` to retrieve exact raw messages if compacted details are missing.",
-        ].join("\n"),
-        ...(missingHeadings.length > 0
-            ? { validationWarning: { missingHeadings } }
-            : {}),
-    };
-}
 export { addAgentModelUsage as addAgentWorkerUsage } from "@gea-ai/contract/agent-usage";
 export async function compactAgentWorkerContext(input) {
     const options = input.options ?? defaultAgentContextOptionsSchema.parse({});
@@ -619,7 +566,6 @@ export async function compactAgentWorkerContext(input) {
             .slice(splitIndex)
             .flatMap((group) => group.messages);
         let summaryText = "";
-        let outcome = "applied";
         let summaryUsage = null;
         try {
             const summaryMessages = buildSummaryMessages({
@@ -653,6 +599,7 @@ export async function compactAgentWorkerContext(input) {
             if (completion.finishReason !== "stop") {
                 // The provider call still counts toward usage, but an incomplete
                 // summary must not replace the previous summary or active history.
+                span.recordError(new Error(`Context summarizer finished with ${completion.finishReason}.`));
                 span.setAttributes({
                     "gea.context.compaction.outcome": "rejected",
                     "gea.context.compaction.finish_reason": completion.finishReason,
@@ -681,21 +628,17 @@ export async function compactAgentWorkerContext(input) {
         }
         catch (error) {
             input.signal?.throwIfAborted();
-            outcome = summaryText.trim() ? "partial" : "fallback";
-            span.addEvent("context.compaction.recovered", {
-                "error.message": error instanceof Error ? error.message : String(error),
+            span.recordError(error instanceof Error ? error : String(error));
+            span.setAttributes({
+                "gea.context.compaction.outcome": "rejected",
+                "gea.context.messages.output_count": input.context.messages.length,
             });
-            input.context.metadata.contextSummary = summaryText.trim()
-                ? makePartialSummary({
-                    chatId: input.chatId,
-                    error,
-                    summaryText,
-                })
-                : makeFallbackSummary(input.chatId, error).contextSummary;
+            // A failed or partial summary cannot replace the original task/history.
+            return { summaryUsage, messagesUpdated };
         }
         input.context.messages = recentTail;
         span.setAttributes({
-            "gea.context.compaction.outcome": outcome,
+            "gea.context.compaction.outcome": "applied",
             "gea.context.messages.output_count": recentTail.length,
         });
         await input.persist?.();

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: {