agent-relay-sdk 0.2.11 → 0.2.13

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 {
@@ -1264,6 +1271,12 @@ export interface WorkspaceMergePreview {
   baseRef?: string;
   /** Human-readable reason a merge can't proceed (no work, dirty, missing). */
   reason?: string;
+  /** True when there is nothing to land: ahead=0 with a clean worktree (branch tree
+   * already in base — never diverged, or already landed via squash/cherry-pick/PR).
+   * A no-op land resolves the workspace to a terminal state instead of parking it in
+   * the steward queue (#230). Distinct from a dirty-worktree refusal, which also sets
+   * `reason` but is not a no-op. */
+  noop?: boolean;
   /** Set when the worktree path no longer exists. */
   missing?: boolean;
   /** Populated when git interrogation failed. */
@@ -1277,6 +1290,10 @@ export interface WorkspaceMergeResult {
   strategy: "pr" | "rebase-ff";
   /** True when work was landed locally (rebase-ff into base). */
   merged: boolean;
+  /** True when the land was a no-op — nothing to merge (ahead=0, clean worktree),
+   * resolved to a terminal `merged` status to clear the steward queue (#230). The
+   * worktree/branch are reclaimed too when the owner is gone (`deleteBranch`). */
+  noop?: boolean;
   /** True when a merge was prevented by conflicts. */
   conflict?: boolean;
   /** PR URL when the pr strategy opened one. */
@@ -1516,6 +1533,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;
@@ -1554,7 +1577,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";
@@ -2096,6 +2125,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[];