agent-relay-sdk 0.2.10 → 0.2.12

package/src/types.ts

@@ -16,6 +16,10 @@ export interface AgentCard {
   providerCapabilities?: ProviderCapabilities;
   context?: ContextState;
   meta?: Record<string, unknown>;
+  /** Agent id of the parent that spawned this one (set authoritatively from the child's
+   * signed runner token at registration). Absent for top-level/user/system agents. Powers
+   * spawn quotas, the `spawnedBy:` search filter, scoped shutdown, and the no-grandchild gate. */
+  spawnedBy?: string;
   lastSeen: number;
   createdAt: number;
 }
@@ -661,6 +665,9 @@ export interface RegisterAgentInput {
   providerCapabilities?: ProviderCapabilities;
   context?: ContextState;
   meta?: Record<string, unknown>;
+  /** Parent agent id. Server sets this authoritatively from the registering token's
+   * `spawnedBy`/`parentAgents` constraint; any client-supplied value is ignored. */
+  spawnedBy?: string;
 }
 
 export interface AgentSessionGuard {
@@ -1516,6 +1523,12 @@ export interface AgentProfileAssetRef {
   meta?: Record<string, unknown>;
 }
 
+export interface AgentProfileProviderOptions extends Record<string, unknown> {
+  codex?: {
+    toolOutputTokenLimit?: number | null;
+  } & Record<string, unknown>;
+}
+
 export interface AgentProfile {
   name: string;
   description?: string;
@@ -1533,6 +1546,12 @@ export interface AgentProfile {
     skills: boolean;
     plugins: boolean;
     statusLine: boolean;
+    // Inject the relay HTTP MCP endpoint into the spawned agent. Default-on for
+    // host/minimal; isolated clean-room profiles disable it like they disable
+    // plugins. Optional so existing profile literals stay valid; the gate
+    // (profileAllowsRelayFeature) treats absent as enabled and config-store
+    // resolves a concrete default at write time.
+    mcp?: boolean;
   };
   skills: AgentProfileAssetRef[];
   plugins: AgentProfileAssetRef[];
@@ -1548,7 +1567,13 @@ export interface AgentProfile {
     filesystem: AgentProfileFilesystemScope;
   };
   env: Record<string, string>;
-  providerOptions: Record<string, unknown>;
+  providerOptions: AgentProfileProviderOptions;
+  /** Spawn quota for agents granted this profile: max concurrent LIVE children they may
+   * have at once. `0`/undefined = cannot spawn (the strict default). `N` = up to N live
+   * children; a child exiting frees a slot. Drives both the minted token's `command:spawn`
+   * scope (granted iff `> 0`) and the runtime quota count. Children never inherit it
+   * (no grandchildren). */
+  maxSpawnedAgents?: number;
 }
 
 export type AgentProfileProjectionResult = "applied" | "partial" | "unsupported" | "not-applicable";
@@ -2090,6 +2115,12 @@ export interface TokenConstraints {
   agents?: string[];
   policies?: string[];
   parentAgents?: string[];
+  /** Parent agent id stamped on a child's runner token at spawn; read at registration to
+   * set the child agent card's `spawnedBy` authoritatively (the child can't forge it). */
+  spawnedBy?: string;
+  /** Spawn quota (max concurrent live children) baked into a spawn-capable agent's token,
+   * resolved from its profile's `maxSpawnedAgents`. The runtime quota check reads it here. */
+  maxSpawnedAgents?: number;
   targets?: string[];
   channels?: string[];
   orchestrators?: string[];