@gea-ai/agent-sdk 0.1.261006-alpha.0 → 0.1.261008-alpha.0

package/dist/agent-call.d.ts

@@ -1,5 +1,5 @@
 import { type AgentWorkerToolInitialization } from "@gea-ai/contract/agent-worker-tools";
-import type { AgentHostBinding } from "./agent-worker";
+import type { AgentHostBinding } from "./agent-worker.js";
 import type { StudioArtifactScope } from "@gea-ai/contract/studio-artifacts";
 /** The host opens a fresh Worker invocation; only its visible answer returns to the caller. */
 export declare function createWorkerAgentTool(input: {
@@ -8,6 +8,7 @@ export declare function createWorkerAgentTool(input: {
     canCopy?: boolean;
     artifactScope?: StudioArtifactScope;
 }): ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -256,6 +257,7 @@ export declare function createWorkerAgentTool(input: {
         message: string;
     }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
 }) | ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -504,6 +506,7 @@ export declare function createWorkerAgentTool(input: {
         message: string;
     }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
 }) | ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -728,6 +731,7 @@ export declare function createWorkerAgentTool(input: {
         message: string;
     }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
 }) | ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -955,6 +959,7 @@ export declare function createWorkerAgentTool(input: {
 export declare function createWorkerRunCancelTool({ host, }: {
     host: AgentHostBinding;
 }): ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -1024,6 +1029,7 @@ export declare function createWorkerRunCancelTool({ host, }: {
         status: "abort_requested" | "not_running";
     }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
 }) | ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -1093,6 +1099,7 @@ export declare function createWorkerRunCancelTool({ host, }: {
         status: "abort_requested" | "not_running";
     }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
 }) | ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;
@@ -1155,6 +1162,7 @@ export declare function createWorkerRunCancelTool({ host, }: {
         status: "abort_requested" | "not_running";
     }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
 }) | ({
+    deferLoading?: boolean;
     title?: string;
     providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
     metadata?: import("@ai-sdk/provider").JSONObject;

package/dist/agent-channel-api.d.ts

@@ -1,4 +1,4 @@
-import type { AgentHostBinding } from "./agent-worker";
+import type { AgentHostBinding } from "./agent-worker.js";
 import type { AgentChannelRunTerminal } from "@gea-ai/contract/agent-channels";
 export declare function extractChannelReply(messageValue: unknown, responseMessageId: string): {
     messageId: string;

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

@@ -1,7 +1,7 @@
 import { type AgentChannelInvocationContext } from "@gea-ai/contract/agent-channels";
 import { type AgentChannelRuntimeCommand, type AgentChannelRuntimeStart, type AgentChannelJson } from "@gea-ai/contract/agent-channel-runtime";
-import type { AgentChannelFetchEnvironment } from "./agent-worker";
-import type { AnyDefinedChannel, ChannelCapabilities, ChannelInputContext, ChannelRouteContext, ChannelWebSocketRoute } from "./channels";
+import type { AgentChannelFetchEnvironment } from "./agent-worker.js";
+import type { AnyDefinedChannel, ChannelCapabilities, ChannelInputContext, ChannelRouteContext, ChannelWebSocketRoute } from "./channels/index.js";
 export declare function createChannelCapabilities(environment: AgentChannelFetchEnvironment, signal: AbortSignal): Promise<ChannelCapabilities>;
 export declare function createChannelInputContext(input: {
     definition: AnyDefinedChannel;

package/dist/agent-channel-receiver.d.ts

@@ -1,6 +1,6 @@
-import { type DefinedAgent } from "./index";
-import type { AgentChannelAddressStorage } from "./agent-channel-worker";
-import type { AgentChannelFetchEnvironment } from "./agent-worker";
+import { type DefinedAgent } from "./index.js";
+import type { AgentChannelAddressStorage } from "./agent-channel-worker.js";
+import type { AgentChannelFetchEnvironment } from "./agent-worker.js";
 export type AgentChannelReceiverEnvironment = AgentChannelFetchEnvironment & {
     CHANNEL: AgentChannelFetchEnvironment["CHANNEL"] & {
         connectWebSocket(url: string, options: {

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

@@ -1,4 +1,4 @@
-import type { AgentChannelAddressStorage, AgentChannelAddressEnvironment } from "./agent-channel-worker";
+import type { AgentChannelAddressStorage, AgentChannelAddressEnvironment } from "./agent-channel-worker.js";
 /** An accepted operation owns its code target; the address owns only stable session state. */
 export declare function handleCustomChannelAddressRequest(request: Request, storage: AgentChannelAddressStorage, _environment?: AgentChannelAddressEnvironment): Promise<Response>;
 /** Input execution, event projection, and delivery advance independently on durable alarms. */

package/dist/agent-computer-http.d.ts

@@ -1,7 +1,7 @@
 import { type AgentPackageSnapshot } from "@gea-ai/contract/agent-packages";
 import type { ComputerSessionInitializer } from "@gea-ai/contract/agent-computer";
-import type { AgentComputerScopeResolver } from "./index";
-import type { AgentSessionNamespace, AgentWorkerPlatformBindings, AgentWorkerSkillMount } from "./agent-worker";
+import type { AgentComputerScopeResolver } from "./index.js";
+import type { AgentSessionNamespace, AgentWorkerPlatformBindings, AgentWorkerSkillMount } from "./agent-worker.js";
 export declare function readSessionComputer(namespace: AgentSessionNamespace, chatId: string): Promise<{
     reference: {
         generation: string;

package/dist/agent-computer-scope.d.ts

@@ -1,7 +1,7 @@
 import { type AgentComputerScope, type AgentRuntimePrincipal } from "@gea-ai/contract/agent-packages";
 import type { JsonValue } from "@gea-ai/contract";
-import type { AgentComputerScopeResolver } from "./index";
-import type { AgentSessionNamespace, AgentWorkerPlatformBindings } from "./agent-worker";
+import type { AgentComputerScopeResolver } from "./index.js";
+import type { AgentSessionNamespace, AgentWorkerPlatformBindings } from "./agent-worker.js";
 export declare function resolveAgentComputerScope(input: {
     namespace: AgentSessionNamespace;
     chatId: string;

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

@@ -1,5 +1,5 @@
 import { type Computer, type ComputerSessionFactory, type ComputerCapability, type ComputerRoots, type ComputerSessionContext, type ComputerSessionInitializer } from "@gea-ai/contract/agent-computer";
-import type { AgentWorkerComputerOptions, AgentWorkerPlatformBindings, AgentWorkerSkillMount } from "./agent-worker";
+import type { AgentWorkerComputerOptions, AgentWorkerPlatformBindings, AgentWorkerSkillMount } from "./agent-worker.js";
 export declare const defaultComputerRoots: ComputerRoots;
 /** Translate the native session protocol into the developer's Computer lifecycle callback. */
 export declare function createAgentComputerSession(input: {

package/dist/agent-core-engine.d.ts

@@ -2,8 +2,8 @@ import type { AgentTracing } from "@gea-ai/contract/agent-tracing";
 import type { AgentCorePolicyContext, AgentCoreStepSettings, AgentCoreOutput } from "@gea-ai/contract/agent-core";
 import type { AgentCoreToolCall } from "@gea-ai/contract/agent-core";
 import type { AgentCoreExecutionOptions } from "@gea-ai/contract/agent-core";
-import type { AgentCoreError } from "./experimental/agent-core";
-import type { AgentToolApprovalDecision, AgentToolRuntimeSdk } from "./index";
+import type { AgentCoreError } from "./experimental/agent-core.js";
+import type { AgentToolApprovalDecision, AgentToolRuntimeSdk } from "./index.js";
 export type AgentCoreGuardrail = (input: {
     call: AgentCoreToolCall;
     sdk: Pick<AgentToolRuntimeSdk, "auth" | "env" | "environment" | "identity" | "signal" | "tracing">;

package/dist/agent-core.d.ts

@@ -1,9 +1,9 @@
-import { type AgentCoreOutputSchema } from "./agent-core-output";
-export type { AgentCoreOutputSchema } from "./agent-core-output";
-import type { AgentCoreEngine } from "./agent-core-engine";
-export type { AgentCoreEngine, AgentCoreGuardrail } from "./agent-core-engine";
+import { type AgentCoreOutputSchema } from "./agent-core-output.js";
+export type { AgentCoreOutputSchema } from "./agent-core-output.js";
+import type { AgentCoreEngine } from "./agent-core-engine.js";
+export type { AgentCoreEngine, AgentCoreGuardrail } from "./agent-core-engine.js";
 export type { AgentCorePolicyContext, AgentCoreStepSettings, } from "@gea-ai/contract/agent-core";
-export { AgentCoreError } from "./experimental/agent-core";
+export { AgentCoreError } from "./experimental/agent-core.js";
 /** Select the Rust/WASM loop for this Agent, retaining its existing Worker host. */
 export declare function agentCore(options?: Omit<AgentCoreEngine, "kind" | "module" | "maxToolConcurrency" | "output"> & {
     maxToolConcurrency?: number;

package/dist/agent-media-read.d.ts

@@ -0,0 +1,13 @@
+declare const AgentMediaReadError_base: import("better-result").TaggedErrorClass<"AgentMediaReadError", {
+    message: string;
+    operation: "download Tool output media" | "read Artifact image";
+    status?: number;
+}>;
+export declare class AgentMediaReadError extends AgentMediaReadError_base {
+}
+/** Translate Fetch failures at the Tool/model media boundary, without signed URLs. */
+export declare function readAgentMedia(request: () => Promise<Response>, operation: "download Tool output media" | "read Artifact image", signal?: AbortSignal): Promise<{
+    data: ArrayBuffer;
+    mediaType: string | null;
+}>;
+export {};

package/dist/agent-media-read.js

@@ -0,0 +1,29 @@
+import { TaggedError } from "better-result";
+export class AgentMediaReadError extends TaggedError("AgentMediaReadError")() {
+}
+/** Translate Fetch failures at the Tool/model media boundary, without signed URLs. */
+export async function readAgentMedia(request, operation, signal) {
+    try {
+        signal?.throwIfAborted();
+        const response = await request();
+        if (!response.ok)
+            throw new AgentMediaReadError({
+                operation,
+                status: response.status,
+                message: `Could not ${operation} (HTTP ${response.status}).`,
+            });
+        const data = await response.arrayBuffer();
+        return { data, mediaType: response.headers.get("content-type") };
+    }
+    catch (error) {
+        signal?.throwIfAborted();
+        if (AgentMediaReadError.is(error))
+            throw error;
+        // Fetch/body exceptions may contain credentials or signed URLs. These errors
+        // enter model feedback and traces, so retain the operation, not the raw cause.
+        throw new AgentMediaReadError({
+            operation,
+            message: `Could not ${operation} (network or response-body failure).`,
+        });
+    }
+}

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

@@ -1,11 +1,11 @@
-import { type RemoteRunDestination, type RemoteInputFiles, type RemoteFileMapping } from "./agent-remote-run";
+import { type RemoteRunDestination, type RemoteInputFiles, type RemoteFileMapping } from "./agent-remote-run.js";
 import { type AgentCallMessage, type AgentChildRun, type AgentChildRunDestination, type AgentChildRunHostEvent } from "@gea-ai/contract/agent-worker-tools";
 import type { TraceContext, TraceContinuation } from "@gea-ai/contract/traces";
 import type { AgentSessionInboxExecution } from "@gea-ai/contract/agent-session-inbox";
 import type { StudioArtifactScope, StudioArtifactInputFile } from "@gea-ai/contract/studio-artifacts";
-export type { RemoteRunFetch, RemoteRunDestination, RemoteInputFiles, RemoteFileMapping, } from "./agent-remote-run";
-export { readWorkerAgentResponse } from "./agent-call";
-export { streamManagedAgentSessionRun } from "./agent-session-stream";
+export type { RemoteRunFetch, RemoteRunDestination, RemoteInputFiles, RemoteFileMapping, } from "./agent-remote-run.js";
+export { readWorkerAgentResponse } from "./agent-call.js";
+export { streamManagedAgentSessionRun } from "./agent-session-stream.js";
 export type AgentChildRunSession = (operation: string, body: unknown, traceContext?: TraceContext) => Promise<Response>;
 /** Invocation transport only. SDK Sessions own Run state, waits, completion and wakeups. */
 export declare class AgentRunHost {

package/dist/agent-session-child-store.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { type AgentChildRun } from "@gea-ai/contract/agent-worker-tools";
-import type { AgentSessionTransactionStorage } from "./agent-session";
+import type { AgentSessionTransactionStorage } from "./agent-session.js";
 declare const indexSchema: z.ZodObject<{
     sequence: z.ZodNumber;
     activeRunIds: z.ZodArray<z.ZodUUID>;

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

@@ -1,3 +1,3 @@
-import type { AgentSessionStorage } from "./agent-session";
+import type { AgentSessionStorage } from "./agent-session.js";
 /** Admission and immutable receipts share the parent inbox's transaction. */
 export declare function handleAgentSessionChildren(request: Request, storage: AgentSessionStorage): Promise<Response | undefined>;

package/dist/agent-session-children.js

@@ -242,13 +242,16 @@ export async function handleAgentSessionChildren(request, storage) {
             }
             case "cancel-all": {
                 z.strictObject({}).parse(value);
+                let changed = false;
                 for (const run of await readChildRuns(tx)) {
-                    if (!run.outcome) {
+                    if (!run.outcome && !run.cancelRequested) {
                         run.cancelRequested = true;
                         await putChildRun(tx, run);
+                        changed = true;
                     }
                 }
-                await scheduleAgentSessionChildRunChanges(tx);
+                if (changed)
+                    await scheduleAgentSessionChildRunChanges(tx);
                 return Response.json({ stored: true });
             }
             case "cancel": {
@@ -256,11 +259,13 @@ export async function handleAgentSessionChildren(request, storage) {
                 const run = await getChildRun(tx, runId);
                 if (!run)
                     return Response.json({ error: "unknown_run" }, { status: 404 });
-                if (!run.outcome) {
+                if (!run.outcome && !run.cancelRequested) {
                     run.cancelRequested = true;
                     await putChildRun(tx, run);
+                    // Host retries repeat this command. Preserve the existing retry alarm
+                    // when cancellation intent has already been recorded.
+                    await scheduleAgentSessionChildRunChanges(tx);
                 }
-                await scheduleAgentSessionChildRunChanges(tx);
                 return Response.json({ run });
             }
             case "complete": {

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

@@ -1,4 +1,4 @@
-import type { AgentSessionTransactionStorage } from "./agent-session";
+import type { AgentSessionTransactionStorage } from "./agent-session.js";
 /** Shared by managed turns, standalone turns and inbox admission in their transaction. */
 export declare function activeComputerOperation(tx: AgentSessionTransactionStorage): Promise<{
     id: string;

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

@@ -1,2 +1,2 @@
-import type { AgentSessionStorage } from "./agent-session";
+import type { AgentSessionStorage } from "./agent-session.js";
 export declare function handleAgentSessionExecutionRequest(request: Request, storage: AgentSessionStorage): Promise<Response>;

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

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { agentSessionInboxFinishSchema } from "@gea-ai/contract/agent-session-inbox";
 import type { AgentChildRun } from "@gea-ai/contract/agent-worker-tools";
-import type { AgentSessionStorage, AgentSessionTransactionStorage } from "./agent-session";
+import type { AgentSessionStorage, AgentSessionTransactionStorage } from "./agent-session.js";
 /** Only private definitions/self copies share the owning Agent's business context. */
 export declare function inheritedAgentSessionMetadata(tx: AgentSessionTransactionStorage, destination: AgentChildRun["destination"]): Promise<Record<string, z.util.JSONType> | undefined>;
 /** Atomically supersede only an idle input wait, never a running invocation. */

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

@@ -1,4 +1,4 @@
-import type { AgentSessionTransactionStorage } from "./agent-session";
+import type { AgentSessionTransactionStorage } from "./agent-session.js";
 /** Call within the same transaction as the owning record's indexes/revision. */
 export declare function putSessionPayload(tx: AgentSessionTransactionStorage, key: string, value: unknown): Promise<void>;
 /** Legacy inline records remain readable. A partial payload is corruption, not absence. */

package/dist/agent-worker.d.ts

@@ -1,25 +1,25 @@
 import type { WorkerAI } from "@gea-ai/contract/worker-ai";
-export { createGeaAI } from "./gea-ai";
-export { extractChannelReply } from "./agent-channel-api";
+export { createGeaAI } from "./gea-ai.js";
+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";
+import type { AgentContextStrategy } from "./context.js";
 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";
 import type { AgentArtifactScopeResolver } from "@gea-ai/contract/studio-artifacts";
 import type { ComputerSessionFactory, ComputerCreateResponse, ComputerSessionInitializer } from "@gea-ai/contract/agent-computer";
 import type { AgentComputerScope } from "@gea-ai/contract/agent-packages";
-import type { AgentComputerScopeResolver } from "./index";
+import type { AgentComputerScopeResolver } from "./index.js";
 import type { ComputerOperationReceipt } from "@gea-ai/contract/agent-worker-tools";
 import { type UserModelMessage } from "ai";
 import { type AgentExecutionEnvironment, type AgentPackageSnapshot, type AgentRuntimeAuth } from "@gea-ai/contract/agent-packages";
 import { z } from "zod";
-export { AgentChannelReceiver } from "./agent-channel-receiver";
+export { AgentChannelReceiver } from "./agent-channel-receiver.js";
 import { type AgentChannelJournalAppend } from "@gea-ai/contract/agent-channel-runtime";
-import { type AgentDurableObjectNamespace, type AgentToolApprovalDecision, type AgentToolIdentity, type AgentToolRuntimeSdk, type DefinedAgent } from "./index";
-import { type AgentChannelAddressEnvironment } from "./agent-channel-worker";
-export { handleAgentChannelAddressAlarm, handleAgentChannelAddressRequest, type AgentChannelAddressEnvironment, type AgentChannelAddressStorage, type AgentChannelAddressTransactionStorage, } from "./agent-channel-worker";
+import { type AgentDurableObjectNamespace, type AgentToolApprovalDecision, type AgentToolIdentity, type AgentToolRuntimeSdk, type DefinedAgent } from "./index.js";
+import { type AgentChannelAddressEnvironment } from "./agent-channel-worker.js";
+export { handleAgentChannelAddressAlarm, handleAgentChannelAddressRequest, type AgentChannelAddressEnvironment, type AgentChannelAddressStorage, type AgentChannelAddressTransactionStorage, } from "./agent-channel-worker.js";
 export type AgentHostBinding = Partial<WorkerAI> & {
     fetch(path: string, init?: RequestInit): Promise<Response>;
 };
@@ -135,9 +135,9 @@ export type AgentToolRuntimeDefinition = {
             input: unknown;
             sdk: AgentToolRuntimeSdk;
         }): Promise<unknown>;
-        scriptRuntime?: ReturnType<typeof import("./script-tools").getScriptToolRuntime>;
+        scriptRuntime?: ReturnType<typeof import("./script-tools.js").getScriptToolRuntime>;
         inputSchema: z.ZodType;
-        toModelOutput?: import("./index").DefinedCustomTool["toModelOutput"];
+        toModelOutput?: import("./index.js").DefinedCustomTool["toModelOutput"];
     }>;
     connectors?: Record<string, {
         authorization?: {
@@ -196,7 +196,7 @@ export declare function runAgentWorkerRequest(input: {
     inboxExecution?: AgentSessionInboxExecution;
     parentRunId?: string;
     onSessionFinished?: () => Promise<void>;
-    engine?: import("./agent-core-engine").AgentEngine;
+    engine?: import("./agent-core-engine.js").AgentEngine;
     context?: false | AgentContextStrategy;
     scopeResolver?: AgentComputerScopeResolver;
     artifactScopeResolver?: "principal" | AgentArtifactScopeResolver;

package/dist/agent-worker.js

@@ -15,6 +15,7 @@ import { decodeAgentModelProxyValue, encodeAgentModelProxyValue, } from "@gea-ai
 import { createGeaAI, modelDescriptorSchema } from "./gea-ai.js";
 import { storeToolModelOutput, resolveToolArtifacts, } from "./tool-model-output.js";
 import { mcpToolModelOutput } from "./mcp-tool-output.js";
+import { AgentMediaReadError, readAgentMedia } from "./agent-media-read.js";
 export { createGeaAI } from "./gea-ai.js";
 import { mergeLlmJson, llmRuntimeRequestOptionsSchema, } from "@gea-ai/contract/llm-catalog";
 import { executeChannelAgentRun, uploadChannelInput, } from "./agent-channel-api.js";
@@ -3802,7 +3803,7 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
     const readImage = async (file) => {
         if (!artifactScope)
             throw new Error("Images require Agent Artifacts.");
-        const response = await host.fetch(`${HOST_PATH}/tools/attachments/read`, {
+        const image = await readAgentMedia(() => host.fetch(`${HOST_PATH}/tools/attachments/read`, {
             method: "POST",
             headers: { "content-type": "application/json" },
             body: JSON.stringify({
@@ -3810,16 +3811,14 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
                 ...(file.id ? { id: file.id } : { key: file.key }),
             }),
             signal: input.request.signal,
-        });
-        if (!response.ok)
-            throw new Error(`Could not read Artifact image (${response.status}).`);
-        const bytes = new Uint8Array(await response.arrayBuffer());
+        }), "read Artifact image", input.request.signal);
+        const bytes = new Uint8Array(image.data);
         if (bytes.byteLength > MAX_AGENT_ARTIFACT_IMAGE_BYTES)
             throw new Error("Prepared image exceeds the model image limit.");
         return {
             type: "file",
             data: { type: "data", data: bytes },
-            mediaType: response.headers.get("content-type") ?? file.mediaType,
+            mediaType: image.mediaType ?? file.mediaType,
         };
     };
     const addImage = async (file) => {
@@ -4115,6 +4114,12 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
     const initialPrompt = await startupTracing.withSpan("agent.startup.prompt", () => preparePrompt(withTurnImages(assembleAgentWorkerContext({ context, runtimeContext }), turnImages)));
     const modelCancellation = new AbortController();
     let failure;
+    const executionErrorText = (error, fallback = "Agent execution failed.") => {
+        const original = failure?.error ?? error;
+        return original instanceof AgentMediaReadError
+            ? original.message
+            : fallback;
+    };
     let pendingMainCall;
     let pendingMainModel = configuredModel;
     let lastStepNumber = 0;
@@ -4129,7 +4134,7 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
         // the execution's original failure before publishing that chunk.
         ownSessionOutcome({
             status: input.request.signal.aborted ? "cancelled" : "failed",
-            text: "Agent execution failed.",
+            text: executionErrorText(error),
         });
         recordExecutionFailure(error);
     };
@@ -4267,9 +4272,9 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
             // both the error and final usage from clients.
             ownSessionOutcome({
                 status: input.request.signal.aborted ? "cancelled" : "failed",
-                text: responseMessage.parts
+                text: executionErrorText(failure.error, responseMessage.parts
                     .flatMap((part) => (part.type === "text" ? [part.text] : []))
-                    .join(""),
+                    .join("")),
             });
             return;
         }
@@ -4645,7 +4650,13 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
                     throw failure.error;
             },
             async prepareModel(request) {
-                const prepared = await preparePrompt(withTurnImages(assembleAgentWorkerContext({ context, runtimeContext }), turnImages));
+                const prepared = await preparePrompt(withTurnImages(assembleAgentWorkerContext({ context, runtimeContext }), turnImages)).catch((error) => {
+                    // Core serializes host exceptions through WASM. Preserve this safe,
+                    // typed media failure before that boundary loses its identity.
+                    if (error instanceof AgentMediaReadError)
+                        fail(error);
+                    throw error;
+                });
                 const prompt = [...prepared.instructions, ...prepared.messages];
                 modelPrompt = prompt;
                 const decoratedTools = addCacheControlToToolList(request.tools.map((tool) => ({
@@ -4742,6 +4753,7 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
             async execute({ writer }) {
                 for await (const chunk of projectAgentCoreEvents(tracked, {
                     messageId,
+                    onError: executionErrorText,
                     approvals: pending?.pendingStep.approvals,
                     tools,
                     messageMetadata: {
@@ -4842,6 +4854,7 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
                 : stepCountIs(Number.POSITIVE_INFINITY),
         });
         stream = result.toUIMessageStream({
+            onError: (error) => executionErrorText(error, "An error occurred."),
             generateMessageId: () => payload.responseMessageId,
             originalMessages: payload.originalMessages,
             sendReasoning: true,
@@ -4948,7 +4961,7 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
                         !input.request.signal.aborted) {
                         events.push({
                             type: "error",
-                            errorText: "Agent execution failed.",
+                            errorText: executionErrorText(failure?.error),
                         });
                         streamedError = true;
                     }

package/dist/catalog-language-model.d.ts

@@ -1,4 +1,4 @@
-export { moveOpenAICompatibleCacheControlToMessageContent } from "./openai-compatible-cache-control";
+export { moveOpenAICompatibleCacheControlToMessageContent } from "./openai-compatible-cache-control.js";
 import { type LlmModelFormat } from "@gea-ai/contract/llm-catalog";
 import { z } from "zod";
 declare const object: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;

package/dist/channels/feishu-inbound.d.ts

@@ -1,7 +1,7 @@
 import { Result } from "better-result";
 import { z } from "zod";
-import type { ChannelInputContext } from "./index";
-import type { FeishuChannelConfiguration } from "./feishu";
+import type { ChannelInputContext } from "./index.js";
+import type { FeishuChannelConfiguration } from "./feishu.js";
 export declare const feishuSenderSchema: z.ZodObject<{
     tenantKey: z.ZodString;
     openId: z.ZodString;

package/dist/channels/feishu-output.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import type { AgentChannelEvent, AgentChannelOutboundResult, ChannelCapabilities, ChannelEventContext, AgentChannelDelivery } from "./index";
-import type { FeishuChannelOptions } from "./feishu";
+import type { AgentChannelEvent, AgentChannelOutboundResult, ChannelCapabilities, ChannelEventContext, AgentChannelDelivery } from "./index.js";
+import type { FeishuChannelOptions } from "./feishu.js";
 declare const stateSchema: z.ZodObject<{
     replies: z.ZodNumber;
     outputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{

package/dist/channels/feishu-websocket.d.ts

@@ -1,4 +1,4 @@
-import type { FeishuChannelConfiguration } from "./feishu";
-import type { ChannelReceiver, ChannelCapabilities } from "./index";
+import type { FeishuChannelConfiguration } from "./feishu.js";
+import type { ChannelReceiver, ChannelCapabilities } from "./index.js";
 /** One protocol instance per active socket; framework owns reconnection and capability lifetime. */
 export declare function createFeishuReceiver(configure: (context: ChannelCapabilities) => FeishuChannelConfiguration): ChannelReceiver;

package/dist/channels/feishu.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
-import type { AgentEnvironmentRequirement } from "../index";
-import { type ChannelCapabilities } from "./index";
-import { feishuSenderSchema } from "./feishu-inbound";
+import type { AgentEnvironmentRequirement } from "../index.js";
+import { type ChannelCapabilities } from "./index.js";
+import { feishuSenderSchema } from "./feishu-inbound.js";
 export type FeishuChannelConfiguration = {
     appId: string | undefined;
     appSecret: string | undefined;
@@ -21,7 +21,7 @@ export type FeishuChannelOptions<TEnv extends string = string> = {
     }): FeishuChannelConfiguration;
 };
 /** The built-in adapter is an ordinary public Channel definition; it has no host-specific privileges. */
-export declare function feishuChannel<TEnv extends string>(options: FeishuChannelOptions<TEnv>): import("./index").DefinedChannel<{
+export declare function feishuChannel<TEnv extends string>(options: FeishuChannelOptions<TEnv>): import("./index.js").DefinedChannel<{
     replies: number;
     outputs: Record<string, {
         messageId: string;

package/dist/channels/index.d.ts

@@ -3,9 +3,9 @@ import { z } from "zod";
 import type { AgentChannelReceiverHandshakeError } from "@gea-ai/contract/agent-channel-receivers";
 import { type AgentChannelUserIdentity, type AgentCustomChannelDefinition, type AgentChannelExecutionTarget, type AgentChannelRoute } from "@gea-ai/contract/agent-channels";
 import { type AgentChannelJson, type AgentChannelUserMessage, type AgentChannelEvent, type AgentChannelDelivery, type AgentChannelOutboundResult } from "@gea-ai/contract/agent-channel-runtime";
-import type { AgentEnvironmentRequirement } from "../index";
+import type { AgentEnvironmentRequirement } from "../index.js";
 import type { UIMessage } from "ai";
-export { httpChannel } from "../index";
+export { httpChannel } from "../index.js";
 export type { AgentChannelUserMessage, AgentChannelEvent, AgentChannelDelivery, AgentChannelOutboundResult, } from "@gea-ai/contract/agent-channel-runtime";
 export type ChannelSendOptions = {
     operationId: string;

package/dist/code-mode.d.ts

@@ -1,9 +1,9 @@
-import type { AgentToolContext } from "./index";
-import type { getScriptToolRuntime } from "./script-tools";
+import type { AgentToolContext } from "./index.js";
+import type { getScriptToolRuntime } from "./script-tools.js";
 import { type ToolSet } from "ai";
 import { z } from "zod";
 import type { AgentPackageSnapshot, AgentAllowedCallers } from "@gea-ai/contract/agent-packages";
-import { createCoreWorkerTools } from "./experimental/agent-core-worker-tools";
+import { createCoreWorkerTools } from "./experimental/agent-core-worker-tools.js";
 type CoreOptions = Parameters<typeof createCoreWorkerTools>[0];
 /** Resolve old snapshots by effective behavior; authoring only uses allowedCallers. */
 export declare function resolveToolAllowedCallers(snapshot: AgentPackageSnapshot, name: string, eligible: boolean): AgentAllowedCallers;
@@ -16,6 +16,7 @@ export declare function createCodeMode(options: CoreOptions & {
 }): Promise<{
     tools: ToolSet | {
         executeJavaScript: ({
+            deferLoading?: boolean;
             title?: string;
             providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
             metadata?: import("@ai-sdk/provider").JSONObject;
@@ -154,6 +155,7 @@ export declare function createCodeMode(options: CoreOptions & {
                 truncated: boolean;
             }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
         }) | ({
+            deferLoading?: boolean;
             title?: string;
             providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
             metadata?: import("@ai-sdk/provider").JSONObject;
@@ -292,6 +294,7 @@ export declare function createCodeMode(options: CoreOptions & {
                 truncated: boolean;
             }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
         }) | ({
+            deferLoading?: boolean;
             title?: string;
             providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
             metadata?: import("@ai-sdk/provider").JSONObject;
@@ -416,6 +419,7 @@ export declare function createCodeMode(options: CoreOptions & {
                 truncated: boolean;
             }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
         }) | ({
+            deferLoading?: boolean;
             title?: string;
             providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
             metadata?: import("@ai-sdk/provider").JSONObject;

package/dist/computer/just-bash.d.ts

@@ -1,5 +1,5 @@
 import type { WorkerComputerSession } from "@gea-ai/contract/agent-computer";
-import { type ComputerOptions, type EphemeralComputerFilesystem } from "../computer";
+import { type ComputerOptions, type EphemeralComputerFilesystem } from "../computer.js";
 export declare function justbash(input?: ComputerOptions & {
     filesystem?: EphemeralComputerFilesystem;
 }): {

package/dist/context-runtime.d.ts

@@ -1,8 +1,8 @@
 import type { WorkerAI } from "@gea-ai/contract/worker-ai";
 import { type AgentToolOutputOffload, type AgentContextDescriptor, type AgentContextUsage } from "@gea-ai/contract/agent-context";
 import type { FinishReason, LanguageModelUsage } from "ai";
-import { type AgentWorkerContextState } from "./agent-worker-context";
-import { type AgentContextRuntime, type AgentContextStrategy } from "./context";
+import { type AgentWorkerContextState } from "./agent-worker-context.js";
+import { type AgentContextRuntime, type AgentContextStrategy } from "./context.js";
 /** Owns context callback ordering and its invocation-scoped work, not a second Run. */
 export declare function createAgentContextRuntime(input: {
     strategy?: false | AgentContextStrategy;

package/dist/context.d.ts

@@ -1,5 +1,5 @@
 import { type AgentContextDescriptor, type DefaultAgentContextOptions, type AgentContextStrategy as ContextStrategy, type AgentContextRuntime as ContextRuntime, type AgentContextPrepareStepEvent as PrepareStepEvent, type AgentContextStepEndEvent as StepEndEvent, type AgentContextEndEvent as EndEvent } from "@gea-ai/contract/agent-context";
-import type { AgentDurableObjectBindings } from "./index";
+import type { AgentDurableObjectBindings } from "./index.js";
 export type { AgentAI, AgentAIOptions, DefaultAgentContextOptions, AgentContextUpdate, AgentContextUsage, } from "@gea-ai/contract/agent-context";
 export type AgentContextStrategy = ContextStrategy<AgentDurableObjectBindings>;
 export type AgentContextRuntime = ContextRuntime<AgentDurableObjectBindings>;

package/dist/evals.d.ts

@@ -1,8 +1,8 @@
 import type { AgentEvalEvidenceReference, AgentBenchmarkCaseMetadata, AgentEvalMetric } from "@gea-ai/contract";
 import { type UITools } from "ai";
 import { z } from "zod";
-import type { AgentHostBinding } from "./agent-worker";
-import type { AgentMessage, AgentMessageForTools } from "./index";
+import type { AgentHostBinding } from "./agent-worker.js";
+import type { AgentMessage, AgentMessageForTools } from "./index.js";
 type AgentEvalRuntimeMessage = AgentMessageForTools<UITools>;
 export type AgentEvalJudgeContext<TMessage extends AgentEvalRuntimeMessage = AgentMessage> = {
     caseId?: string;

package/dist/experimental/agent-core-language-model.d.ts

@@ -1,6 +1,6 @@
 import type { LanguageModelV4, LanguageModelV4Usage } from "@ai-sdk/provider";
 import { type AgentCoreProviderConfig } from "@gea-ai/contract/agent-core";
-import { type AgentRuntimeCacheControlProvider } from "../cache-control";
+import { type AgentRuntimeCacheControlProvider } from "../cache-control.js";
 export declare function toCoreLanguageModelUsage(value: unknown): LanguageModelV4Usage;
 /** AI SDK facade over a single Rust model call. No provider SDK or tool execution. */
 export declare function createAgentCoreLanguageModel(input: {

package/dist/experimental/agent-core-model.d.ts

@@ -1,4 +1,4 @@
 import type { LanguageModelV3, LanguageModelV4, LanguageModelV4CallOptions } from "@ai-sdk/provider";
-import type { AgentCoreHost } from "./agent-core";
+import type { AgentCoreHost } from "./agent-core.js";
 /** Bind an already-resolved model. Only doStream runs here; Rust owns every step. */
 export declare function createAgentCoreModel(model: LanguageModelV3 | LanguageModelV4, options?: Pick<LanguageModelV4CallOptions, "maxOutputTokens" | "temperature" | "providerOptions" | "headers" | "reasoning">): NonNullable<AgentCoreHost["model"]>;

package/dist/experimental/agent-core-tools.d.ts

@@ -1,7 +1,7 @@
 import type { AgentCoreToolCall } from "@gea-ai/contract/agent-core";
-import type { AgentToolApprovalDecision, AgentToolRuntimeSdk } from "../index";
-import type { AgentToolRuntimeDefinition } from "../agent-worker";
-import type { AgentCoreHost } from "./agent-core";
+import type { AgentToolApprovalDecision, AgentToolRuntimeSdk } from "../index.js";
+import type { AgentToolRuntimeDefinition } from "../agent-worker.js";
+import type { AgentCoreHost } from "./agent-core.js";
 /** Host policies use the existing SDK approval decisions. Core owns scheduling. */
 export declare function createAgentCoreTools(options: {
     actions: AgentToolRuntimeDefinition["actions"];

package/dist/experimental/agent-core-ui.d.ts

@@ -1,7 +1,7 @@
 import type { UIMessageChunk } from "ai";
 import type { ToolSet } from "@ai-sdk/provider-utils";
 import type { AgentCoreEvent, AgentCoreInput, AgentCoreOutcome } from "@gea-ai/contract/agent-core";
-import { type AgentCoreHost, type createAgentCore } from "./agent-core";
+import { type AgentCoreHost, type createAgentCore } from "./agent-core.js";
 /** Project facts from Core. Step completion and terminal success remain Core-owned. */
 export declare function projectAgentCoreEvents(turn: AsyncGenerator<AgentCoreEvent, AgentCoreOutcome>, options: {
     messageId: string;

package/dist/experimental/agent-core-worker-tools.d.ts

@@ -1,6 +1,6 @@
 import type { ModelMessage, ToolSet } from "ai";
-import type { AgentToolApprovalDecision } from "../index";
-import type { AgentCoreGuardrail } from "../agent-core-engine";
+import type { AgentToolApprovalDecision } from "../index.js";
+import type { AgentCoreGuardrail } from "../agent-core-engine.js";
 import { z } from "zod";
 /** Reuse the Worker-constructed tools, including Computer locks and capabilities. */
 export declare function createCoreWorkerTools(options: {

package/dist/gea-ai.d.ts

@@ -1,7 +1,7 @@
 import { type AgentModelProxyClient } from "@gea-ai/contract/agent-model-proxy";
 import { type LanguageModel } from "ai";
 import { z } from "zod";
-import type { AgentHostBinding } from "./agent-worker";
+import type { AgentHostBinding } from "./agent-worker.js";
 declare const jsonObjectSchema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
 export declare const modelDescriptorSchema: z.ZodUnion<readonly [z.ZodObject<{
     providerType: z.ZodEnum<{

package/dist/index.d.ts

@@ -1,21 +1,21 @@
 import type { ScriptSkillSource } from "@gea-ai/contract/script-execution";
-import { getScriptToolRuntime } from "./script-tools";
+import { getScriptToolRuntime } from "./script-tools.js";
 import type { AgentAllowedCallers, AgentProgrammaticToolCalling, AgentConnectorToolOverrides, AgentToolNamespace } from "@gea-ai/contract/agent-packages";
 export type { AgentAllowedCallers, AgentProgrammaticToolCalling, AgentConnectorToolOverrides, AgentToolNamespace, } from "@gea-ai/contract/agent-packages";
 import { type AgentToolOutputOffloadOptions } from "@gea-ai/contract/agent-context";
 export type { AgentToolOutputOffloadOptions } from "@gea-ai/contract/agent-context";
 import { type ModelGenerationOptions, type ModelSelection } from "@gea-ai/contract/model-options";
-export { aiSdk } from "./ai-sdk";
-export type { AgentEngine } from "./agent-core-engine";
+export { aiSdk } from "./ai-sdk.js";
+export type { AgentEngine } from "./agent-core-engine.js";
 import type { AgentTracing } from "@gea-ai/contract/agent-tracing";
 export type { AgentTracing, AgentTraceSpan, } from "@gea-ai/contract/agent-tracing";
-import { type AgentContextStrategy } from "./context";
-import { remoteAgentDeclarationSchema, type AgentReference } from "@gea-ai/contract/agent-references";
-export type { AgentContextStrategy, AgentContextRuntime, AgentContextPrepareStepEvent, AgentContextStepEndEvent, AgentContextEndEvent, } from "./context";
+import { type AgentContextStrategy } from "./context.js";
+import { workerAgentReferenceSchema, remoteAgentDeclarationSchema, type AgentReference } from "@gea-ai/contract/agent-references";
+export type { AgentContextStrategy, AgentContextRuntime, AgentContextPrepareStepEvent, AgentContextStepEndEvent, AgentContextEndEvent, } from "./context.js";
 import type { ComputerCommands } from "@gea-ai/contract/computer-commands";
 import type { AgentArtifacts, AgentArtifactScopeResolver } from "@gea-ai/contract/studio-artifacts";
 export type { AgentArtifacts, AgentArtifactScopeContext, AgentArtifactScopeResolver, StudioArtifact, StudioArtifactPage, StudioArtifactDownload, StudioArtifactScope, } from "@gea-ai/contract/studio-artifacts";
-import type { DefinedComputer } from "./computer";
+import type { DefinedComputer } from "./computer.js";
 import { agentManagedToolNames, type AgentComputerScopeResolver, type AgentConnectorAuth, type AgentConnectorDefinition, type AgentConnectorRequestInjection, type AgentConnectorRuntime, type AgentEnvironmentVariable, type AgentExecutionEnvironment, type AgentExtensionMount, type AgentPackageSnapshot, type AgentRuntimeAuth, type AgentSkill, type AgentToolIdentity, type AgentToolPermissions, GEA_AGENT_PACKAGE_SCHEMA_VERSION } from "@gea-ai/contract/agent-packages";
 import { type AgentChannelDefinition, type AgentChannelTurnPolicy } from "@gea-ai/contract/agent-channels";
 import type { MessageMetadata } from "@gea-ai/contract";
@@ -23,16 +23,16 @@ import { z } from "zod";
 import type { UIMessage, UITool, UITools, UserModelMessage } from "ai";
 import type { AgentToolModelOutput } from "@gea-ai/contract/studio-artifacts";
 export type { AgentToolModelOutput } from "@gea-ai/contract/studio-artifacts";
-import type { DefinedComputerTool } from "./computer-tools";
-export { createAgentSkillTool } from "./skill-tool";
-import { type AutoModelRequirements } from "./creative-reasoning-auto";
-import type { AnyDefinedChannel } from "./channels/index";
-export { defineChannel, GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, WS, } from "./channels/index";
+import type { DefinedComputerTool } from "./computer-tools.js";
+export { createAgentSkillTool } from "./skill-tool.js";
+import { type AutoModelRequirements } from "./creative-reasoning-auto.js";
+import type { AnyDefinedChannel } from "./channels/index.js";
+export { defineChannel, GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS, WS, } from "./channels/index.js";
 export type { AgentWorkerRouteDeclaration } from "@gea-ai/contract/agent-channels";
-export { applyPatch, bash, editFile, findFiles, listDirectory, readFile, searchText, writeFile, } from "./computer-tools";
-export type { DefineComputerToolInput, DefinedComputerTool, } from "./computer-tools";
-export type { AutoModelRequirements } from "./creative-reasoning-auto";
-export { handleAgentSessionRequest, type AgentSessionStorage, type AgentSessionTransactionStorage, } from "./agent-session";
+export { applyPatch, bash, editFile, findFiles, listDirectory, readFile, searchText, writeFile, } from "./computer-tools.js";
+export type { DefineComputerToolInput, DefinedComputerTool, } from "./computer-tools.js";
+export type { AutoModelRequirements } from "./creative-reasoning-auto.js";
+export { handleAgentSessionRequest, type AgentSessionStorage, type AgentSessionTransactionStorage, } from "./agent-session.js";
 export type AgentConnectorCapability<TOperation extends string = string> = {
     invoke(operation: TOperation, input: unknown): Promise<unknown>;
 };
@@ -439,7 +439,7 @@ export declare function agentTool(): DefinedManagedTool<"agent">;
 export interface WorkerAgentRegistry {
 }
 export type WorkerAgentSlug = keyof WorkerAgentRegistry extends never ? string : Extract<keyof WorkerAgentRegistry, string>;
-/** Explicitly makes a main Agent in the same Worker available to the owning Agent. */
+/** @deprecated Use defineRemoteAgent({ slug, description }) instead. */
 export declare function defineAgentReference<const TSlug extends WorkerAgentSlug>(input: {
     slug: TSlug;
     description: string;
@@ -448,15 +448,28 @@ export declare function defineAgentReference<const TSlug extends WorkerAgentSlug
     description: string;
     slug: TSlug;
 };
-export type DefineRemoteAgentInput = Omit<z.input<typeof remoteAgentDeclarationSchema>, "type">;
-/** Invoke a fixed Agent ID. Omitted invocationAuthority uses a protected Project key; oauth requires an existing target installation. Environment defaults to the Host environment. */
-export declare function defineRemoteAgent(input: DefineRemoteAgentInput): {
-    type: "remote";
-    agentId: string;
-    invocationAuthority?: "oauth" | "project_key" | undefined;
-    environment?: "local" | "preview" | "production" | undefined;
+export type DefineRemoteAgentInput = {
+    slug: WorkerAgentSlug;
     description: string;
+    agentId?: never;
+    environment?: never;
+    invocationAuthority?: never;
+} | (Omit<z.input<typeof remoteAgentDeclarationSchema>, "type"> & {
+    slug?: never;
+});
+/** Reference a same-Worker entry by slug, or an independently admitted Agent by ID. */
+export declare function defineRemoteAgent<const TSlug extends WorkerAgentSlug>(input: {
+    slug: TSlug;
+    description: string;
+    agentId?: never;
+    environment?: never;
+    invocationAuthority?: never;
+}): Omit<z.output<typeof workerAgentReferenceSchema>, "slug"> & {
+    slug: TSlug;
 };
+export declare function defineRemoteAgent(input: Omit<z.input<typeof remoteAgentDeclarationSchema>, "type"> & {
+    slug?: never;
+}): z.output<typeof remoteAgentDeclarationSchema>;
 /** @deprecated Enable defineAgent({ sessionTools: true }) instead. */
 export declare function chatList(): DefinedManagedTool<"chat_list">;
 /** @deprecated Enable defineAgent({ sessionTools: true }) instead. */
@@ -639,7 +652,7 @@ type AgentComputerInput = DefinedComputer | {
     };
 };
 type DefineAgentBaseInput = ModelGenerationOptions & {
-    engine?: import("./agent-core-engine").AgentEngine;
+    engine?: import("./agent-core-engine.js").AgentEngine;
     context?: false | AgentContextStrategy;
     /** Large tool results are stored in the Session and read with readToolOutput. Defaults to enabled. */
     toolOutputOffload?: boolean | AgentToolOutputOffloadOptions;
@@ -728,9 +741,9 @@ export declare function createAgentToolRuntimeDefinition(input: DefinedAgent): {
                 input: unknown;
                 sdk: AgentToolRuntimeSdk;
             }): Promise<unknown>;
-            scriptRuntime?: ReturnType<typeof import("./script-tools").getScriptToolRuntime>;
+            scriptRuntime?: ReturnType<typeof import("./script-tools.js").getScriptToolRuntime>;
             inputSchema: z.ZodType;
-            toModelOutput?: import(".").DefinedCustomTool["toModelOutput"];
+            toModelOutput?: import("./index.js").DefinedCustomTool["toModelOutput"];
         };
     };
     connectors: {
@@ -769,6 +782,6 @@ export declare function createAgentHookRuntimeDefinition(input: DefinedAgent): {
 };
 export type { AgentConnectorAuth, AgentConnectorDefinition, AgentConnectorRuntime, AgentPackageSnapshot, AgentSkill, AgentToolIdentity, AgentToolPermissions, };
 export { WORKER_AGENT_HTTP_VERSION } from "@gea-ai/contract";
-export { handleAgentSessionAlarm } from "./agent-session-inbox";
-export { executeJavaScript, executePython } from "./script-tools";
+export { handleAgentSessionAlarm } from "./agent-session-inbox.js";
+export { executeJavaScript, executePython } from "./script-tools.js";
 export type { ScriptWorkerBundle } from "@gea-ai/contract/script-execution";

package/dist/index.js

@@ -3,7 +3,7 @@ import { agentToolOutputOffloadOptionsSchema, } from "@gea-ai/contract/agent-con
 import { resolveModelOptions, } from "@gea-ai/contract/model-options";
 export { aiSdk } from "./ai-sdk.js";
 import { describeAgentContext } from "./context.js";
-import { workerAgentReferenceSchema, remoteAgentDeclarationSchema, } from "@gea-ai/contract/agent-references";
+import { workerAgentReferenceSchema, remoteAgentDeclarationSchema, remoteAgentInputSchema, } from "@gea-ai/contract/agent-references";
 import { agentConnectorAuthSchema, agentConnectorDefinitionSchema, agentConnectorGrantSchema, agentConnectorRuntimeSchema, agentEnvironmentVariableSchema, getAgentConnectorPrincipalType, agentPackageSnapshotSchema, agentSlugSchema, agentSkillSchema, agentToolSchema, GEA_AGENT_PACKAGE_SCHEMA_VERSION, } from "@gea-ai/contract/agent-packages";
 import { agentChannelKeySchema, agentChannelPathSchema, agentCustomChannelDefinitionSchema, agentHttpChannelDefinitionSchema, canonicalAgentChannelJson, } from "@gea-ai/contract/agent-channels";
 import { z } from "zod";
@@ -339,7 +339,7 @@ const agentToolConnectorAliases = Symbol("agentToolConnectorAliases");
 export function agentTool() {
     return { id: "agent", type: "managed" };
 }
-/** Explicitly makes a main Agent in the same Worker available to the owning Agent. */
+/** @deprecated Use defineRemoteAgent({ slug, description }) instead. */
 export function defineAgentReference(input) {
     const reference = workerAgentReferenceSchema.parse({
         ...input,
@@ -347,9 +347,11 @@ export function defineAgentReference(input) {
     });
     return { ...reference, slug: input.slug };
 }
-/** Invoke a fixed Agent ID. Omitted invocationAuthority uses a protected Project key; oauth requires an existing target installation. Environment defaults to the Host environment. */
 export function defineRemoteAgent(input) {
-    return remoteAgentDeclarationSchema.parse({ ...input, type: "remote" });
+    const reference = remoteAgentInputSchema.parse(input);
+    return "slug" in reference
+        ? workerAgentReferenceSchema.parse({ ...reference, type: "worker" })
+        : remoteAgentDeclarationSchema.parse({ ...reference, type: "remote" });
 }
 /** @deprecated Enable defineAgent({ sessionTools: true }) instead. */
 export function chatList() {

package/dist/script-source.d.ts

@@ -1,5 +1,5 @@
 import { type ScriptExecutionInput } from "@gea-ai/contract/script-execution";
-import type { AgentToolContext } from "./index";
+import type { AgentToolContext } from "./index.js";
 /** Resolve source in the parent; only validated code and JSON input reach the child. */
 export declare function resolveScriptSource(value: unknown, context: Pick<AgentToolContext<Record<never, never>>, "signal" | "skills"> & {
     artifacts?: {

package/dist/script-tools.d.ts

@@ -1,5 +1,5 @@
 import { scriptExecutionInputSchema, type ScriptExecutionResult, type ScriptWorkerBundle } from "@gea-ai/contract/script-execution";
-import { type DefinedCustomTool } from "./index";
+import { type DefinedCustomTool } from "./index.js";
 type ScriptRuntime = {
     bundle?: ScriptWorkerBundle;
     language: "javascript" | "python";

package/dist/tool-model-output.js

@@ -1,5 +1,6 @@
 import { convertInlineFileDataToUint8Array } from "@ai-sdk/provider-utils";
 import { z } from "zod";
+import { readAgentMedia } from "./agent-media-read.js";
 const uploadResultSchema = z.object({ id: z.uuid() });
 /** Persist only immutable references in the model context, never signed URLs or bytes. */
 export async function storeToolModelOutput(output, artifacts, signal) {
@@ -29,10 +30,8 @@ export async function storeToolModelOutput(output, artifacts, signal) {
             });
             let body;
             if (part.data.type === "url") {
-                const response = await fetch(part.data.url, { signal });
-                if (!response.ok)
-                    throw new Error(`Tool file download failed (${response.status}).`);
-                body = await response.arrayBuffer();
+                const url = part.data.url;
+                body = (await readAgentMedia(() => fetch(url, { signal }), "download Tool output media", signal)).data;
             }
             else {
                 const bytes = convertInlineFileDataToUint8Array(part.data);

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const agentSdkVersion = "0.1.261006-alpha.0";
+export declare const agentSdkVersion = "0.1.261008-alpha.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 // Generated by scripts/build-sdk-version.mjs from package.json.
-export const agentSdkVersion = "0.1.261006-alpha.0";
+export const agentSdkVersion = "0.1.261008-alpha.0";

package/dist/worker.d.ts

@@ -1,5 +1,5 @@
-import { type AgentApplicationDefinition, type AgentChannelFetchEnvironment } from "./agent-worker";
-import { type DefinedAgent } from "./index";
+import { type AgentApplicationDefinition, type AgentChannelFetchEnvironment } from "./agent-worker.js";
+import { type DefinedAgent } from "./index.js";
 /** Agents are platform execution targets, not public HTTP endpoints. */
 export declare function defineWorker<TEnvironment extends AgentChannelFetchEnvironment = AgentChannelFetchEnvironment, TContext = unknown>(input: {
     agents: Record<string, DefinedAgent>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gea-ai/agent-sdk",
-  "version": "0.1.261006-alpha.0",
+  "version": "0.1.261008-alpha.0",
   "private": false,
   "homepage": "https://musegea.com/developers",
   "license": "Apache-2.0",
@@ -113,13 +113,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "4.0.37",
-    "@ai-sdk/openai": "4.0.4",
-    "@ai-sdk/openai-compatible": "3.0.2",
-    "@ai-sdk/otel": "1.0.9",
-    "@ai-sdk/provider": "4.0.1",
-    "@ai-sdk/provider-utils": "5.0.2",
-    "@gea-ai/contract": "0.1.261006-alpha.0",
+    "@ai-sdk/anthropic": "4.0.67",
+    "@ai-sdk/openai": "4.0.79",
+    "@ai-sdk/openai-compatible": "3.0.58",
+    "@ai-sdk/otel": "1.0.119",
+    "@ai-sdk/provider": "4.0.19",
+    "@ai-sdk/provider-utils": "5.0.50",
+    "@gea-ai/contract": "0.1.261008-alpha.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/context-async-hooks": "2.10.0",
     "@opentelemetry/core": "2.10.0",
@@ -128,7 +128,7 @@
     "@opentelemetry/sdk-trace-base": "2.10.0",
     "@standard-schema/spec": "1.1.0",
     "@workflow/serde": "4.1.0",
-    "ai": "7.0.9",
+    "ai": "7.0.119",
     "better-result": "2.8.1",
     "eventsource-parser": "3.0.8",
     "just-bash": "3.0.1",
@@ -138,13 +138,12 @@
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@ai-sdk/react": "4.0.10",
+    "@ai-sdk/react": "4.0.122",
     "@types/node": "^24",
     "esbuild": "0.28.0",
     "pyodide": "0.29.3",
     "typescript": "7.0.2",
-    "vite-plus": "0.2.1",
-    "vitest": "4.1.9"
+    "vite-plus": "1.0.0"
   },
   "peerDependencies": {
     "esbuild": "^0.28.0"