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

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

@@ -32,13 +32,16 @@ export declare function getChildRun(tx: AgentSessionTransactionStorage, runId: s
         packageVersionId: string;
         agentKey: string;
         definitionPath: string[];
+        invocationSourceRunId?: string | undefined;
+        invocationAgentId?: string | undefined;
+        invocationKeyId?: string | undefined;
+        invocationAuthority?: "oauth" | "project_key" | undefined;
+        invocationInstallationId?: string | undefined;
+        environment?: "preview" | "production" | undefined;
     } | {
         type: "remote";
         agentId: string;
-        url?: string | undefined;
-        auth?: {
-            bearerTokenEnv: string;
-        } | undefined;
+        invocationAuthority?: "oauth" | "project_key" | undefined;
         environment: "local" | "preview" | "production";
     };
     message: string | {
@@ -94,13 +97,16 @@ export declare function getChildSession(tx: AgentSessionTransactionStorage, sess
         packageVersionId: string;
         agentKey: string;
         definitionPath: string[];
+        invocationSourceRunId?: string | undefined;
+        invocationAgentId?: string | undefined;
+        invocationKeyId?: string | undefined;
+        invocationAuthority?: "oauth" | "project_key" | undefined;
+        invocationInstallationId?: string | undefined;
+        environment?: "preview" | "production" | undefined;
     } | {
         type: "remote";
         agentId: string;
-        url?: string | undefined;
-        auth?: {
-            bearerTokenEnv: string;
-        } | undefined;
+        invocationAuthority?: "oauth" | "project_key" | undefined;
         environment: "local" | "preview" | "production";
     };
     metadata?: Record<string, z.util.JSONType> | undefined;
@@ -120,13 +126,16 @@ export declare function readChildRuns(tx: AgentSessionTransactionStorage, refere
         packageVersionId: string;
         agentKey: string;
         definitionPath: string[];
+        invocationSourceRunId?: string | undefined;
+        invocationAgentId?: string | undefined;
+        invocationKeyId?: string | undefined;
+        invocationAuthority?: "oauth" | "project_key" | undefined;
+        invocationInstallationId?: string | undefined;
+        environment?: "preview" | "production" | undefined;
     } | {
         type: "remote";
         agentId: string;
-        url?: string | undefined;
-        auth?: {
-            bearerTokenEnv: string;
-        } | undefined;
+        invocationAuthority?: "oauth" | "project_key" | undefined;
         environment: "local" | "preview" | "production";
     };
     message: string | {
@@ -186,13 +195,16 @@ export declare function listChildRuns(tx: AgentSessionTransactionStorage, after:
             packageVersionId: string;
             agentKey: string;
             definitionPath: string[];
+            invocationSourceRunId?: string | undefined;
+            invocationAgentId?: string | undefined;
+            invocationKeyId?: string | undefined;
+            invocationAuthority?: "oauth" | "project_key" | undefined;
+            invocationInstallationId?: string | undefined;
+            environment?: "preview" | "production" | undefined;
         } | {
             type: "remote";
             agentId: string;
-            url?: string | undefined;
-            auth?: {
-                bearerTokenEnv: string;
-            } | undefined;
+            invocationAuthority?: "oauth" | "project_key" | undefined;
             environment: "local" | "preview" | "production";
         };
         message: string | {
@@ -255,13 +267,16 @@ export declare function listChildRuns(tx: AgentSessionTransactionStorage, after:
             packageVersionId: string;
             agentKey: string;
             definitionPath: string[];
+            invocationSourceRunId?: string | undefined;
+            invocationAgentId?: string | undefined;
+            invocationKeyId?: string | undefined;
+            invocationAuthority?: "oauth" | "project_key" | undefined;
+            invocationInstallationId?: string | undefined;
+            environment?: "preview" | "production" | undefined;
         } | {
             type: "remote";
             agentId: string;
-            url?: string | undefined;
-            auth?: {
-                bearerTokenEnv: string;
-            } | undefined;
+            invocationAuthority?: "oauth" | "project_key" | undefined;
             environment: "local" | "preview" | "production";
         };
         message: string | {

package/dist/agent-worker.js

@@ -3859,7 +3859,7 @@ async function executeAgentWorkerRequest(input, waitUntil, ownComputer, ownSessi
             },
         }));
         registerAgentWorkerTool(tools, "getArtifact", tool({
-            description: "Read an exact file or Artifact by id from this session or an explicitly attached input. Images are shown for this user turn; small text/JSON includes a bounded preview. All formats return a temporary downloadUrl.",
+            description: "Read an exact file or Artifact by id within your authorized scope, including outputs from other sessions and explicitly attached inputs. Images are shown for this user turn; small text/JSON includes a bounded preview. All formats return a temporary downloadUrl.",
             inputSchema: z.strictObject({ id: z.uuid() }),
             execute: async ({ id }, options) => {
                 const { artifact, downloadUrl } = (await call({

package/dist/index.d.ts

@@ -449,17 +449,13 @@ export declare function defineAgentReference<const TSlug extends WorkerAgentSlug
     slug: TSlug;
 };
 export type DefineRemoteAgentInput = Omit<z.input<typeof remoteAgentDeclarationSchema>, "type">;
-/** Invoke a fixed Agent ID. Omitted transport options inherit the Host binding;
- * auth.bearerTokenEnv names a Host-only credential for explicit remote authority. */
+/** 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;
-    url?: string | undefined;
+    invocationAuthority?: "oauth" | "project_key" | undefined;
     environment?: "local" | "preview" | "production" | undefined;
     description: string;
-    auth?: {
-        bearerTokenEnv: string;
-    } | undefined;
 };
 /** @deprecated Enable defineAgent({ sessionTools: true }) instead. */
 export declare function chatList(): DefinedManagedTool<"chat_list">;

package/dist/index.js

@@ -347,8 +347,7 @@ export function defineAgentReference(input) {
     });
     return { ...reference, slug: input.slug };
 }
-/** Invoke a fixed Agent ID. Omitted transport options inherit the Host binding;
- * auth.bearerTokenEnv names a Host-only credential for explicit remote authority. */
+/** 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" });
 }
@@ -1163,13 +1162,10 @@ export function createAgentPackageSnapshot(input) {
     for (const [name, child] of Object.entries(definition.subagents ?? {})) {
         agentSlugSchema.parse(name);
         if ("type" in child) {
-            agentReferences[name] = child;
-            if (child.type === "remote" && child.auth) {
-                environment[child.auth.bearerTokenEnv] = {
-                    ...environment[child.auth.bearerTokenEnv],
-                    secret: true,
-                };
-            }
+            agentReferences[name] =
+                child.type === "remote"
+                    ? remoteAgentDeclarationSchema.parse(child)
+                    : child;
             continue;
         }
         if (child.slug !== name)

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const agentSdkVersion = "0.1.261005-alpha.0";
+export declare const agentSdkVersion = "0.1.261006-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.261005-alpha.0";
+export const agentSdkVersion = "0.1.261006-alpha.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gea-ai/agent-sdk",
-  "version": "0.1.261005-alpha.0",
+  "version": "0.1.261006-alpha.0",
   "private": false,
   "homepage": "https://musegea.com/developers",
   "license": "Apache-2.0",
@@ -119,7 +119,7 @@
     "@ai-sdk/otel": "1.0.9",
     "@ai-sdk/provider": "4.0.1",
     "@ai-sdk/provider-utils": "5.0.2",
-    "@gea-ai/contract": "0.1.261005-alpha.0",
+    "@gea-ai/contract": "0.1.261006-alpha.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/context-async-hooks": "2.10.0",
     "@opentelemetry/core": "2.10.0",