@loomcycle/client 1.104.0 → 1.105.0

package/dist/cjs/client.js

@@ -487,11 +487,13 @@ class LoomcycleClient {
      * N parallel {@link LoomcycleClient.runStreaming} calls.
      *
      * Each spawn is a fresh run (its `sessionId` is ignored). Capped at 32 —
-     * an over-cap batch rejects with InvalidArgumentError. `mode: "detach"`
-     * (async handles) is reserved for a future release and rejected today.
+     * an over-cap batch rejects with InvalidArgumentError.
      *
-     * Blocking: resolves only when the slowest child finishes (or `timeoutMs`
-     * elapses). Mirrors POST /v1/runs:batch.
+     * Blocking by default: resolves only when the slowest child finishes (or
+     * `timeoutMs` elapses). With `mode: "detach"` it resolves once every child
+     * has started — each with `status: "running"` and its `run_id` — and the
+     * runs go on; read one with {@link LoomcycleClient.getRun}. Mirrors
+     * POST /v1/runs:batch.
      */
     async spawnRunBatch(opts) {
         const body = {
@@ -848,9 +850,11 @@ class LoomcycleClient {
         return (0, fetch_helpers_js_1.jsonFetch)(this.ctx, "/v1/_me", opts);
     }
     // ---- v0.8.17/8.18 Pause / Resume / State ----
-    /** Quiesce the runtime. Idempotent tools cancel immediately;
-     *  non-idempotent + external tools get a grace window then
-     *  force-cancel. Raises AlreadyPausingError on 409,
+    /** Quiesce the runtime: new runs are refused and each in-flight run
+     *  parks at its next iteration boundary, after the model or tool call it
+     *  is in finishes — no tool call is cancelled. Waits up to `timeoutMs`
+     *  (default 30 s, max 5 min) for runs to park; any that did not are named
+     *  in `warnings`. Raises AlreadyPausingError on 409,
      *  PauseNotConfiguredError on 503. */
     async pauseRuntime(opts) {
         const body = opts?.timeoutMs && opts.timeoutMs > 0
@@ -1501,15 +1505,21 @@ class LoomcycleClient {
     async retireTeam(defId, retired, opts) {
         return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_teamdef", { op: "retire", def_id: defId, retired }, opts);
     }
-    /** Compare a locally computed content hash against the deployed active
-     *  version (op=verify) — the drift check for a team kept in source control
-     *  and pushed to several deployments.
-     *
-     *  Never raises for an absent team: a name with no active version answers
-     *  `{deployed: false, matches: false}`, which a caller distinguishes from a
-     *  deployed version whose hash differs. */
-    async verifyTeam(name, contentSha256, opts) {
-        return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_teamdef", { op: "verify", name, content_sha256: contentSha256 }, opts);
+    async verifyTeam(name, target, opts) {
+        const body = { op: "verify", name };
+        if (typeof target === "string") {
+            body.content_sha256 = target;
+        }
+        else {
+            body.overlay = target.overlay;
+            if (target.as)
+                body.as = target.as;
+            if (target.parentDefId)
+                body.parent_def_id = target.parentDefId;
+            if (target.description)
+                body.description = target.description;
+        }
+        return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_teamdef", body, opts);
     }
     /** Hard-remove a whole team by name — all versions + the active pointer
      *  (op=delete), scoped to the caller's tenant. Teams are runtime-only, so

package/dist/client.d.ts

@@ -25,7 +25,7 @@
  */
 import { InteractiveSession } from "./interactive.js";
 import { ClientToolHost, type ConnectClientToolsOptions } from "./client-tools.js";
-import type { CredentialListResponse, CredentialMeta, CredentialScope, DirectoryInspection, DirectoryTenant, DirectoryUser, ErasureReport, ErasureResult, Agent, AgentEvent, AgentStatus, CancelAgentResult, ClientOptions, ContinueOptions, RunOverrideOptions, EffectiveConfigResponse, RetuneRunResponse, RunConfigResponse, RunPromptResponse, CreateSnapshotOptions, EnsureCodeAgentOptions, EnsureCodeAgentResult, EnsureMcpServerOptions, EnsureMcpServerResult, HealthResponse, InterruptListResponse, InterruptStatus, WalkRunsPage, AckChannelOptions, AwaitChannelsOptions, BroadcastChannelsOptions, ChannelAckResult, ChannelAwaitResult, ChannelBroadcastResult, ChannelDescriptor, ChannelPeekResult, ChannelPublishResult, ChannelPurgeResult, ChannelReleaseResult, ChannelSubscribeResult, CreateChannelOptions, ListChannelsResponse, PeekChannelOptions, PublishChannelOptions, ReleaseChannelOptions, SetMemoryEntryOptions, SetMemoryEntryResponse, SubscribeChannelOptions, UpdateChannelOptions, LibraryAgentDefinition, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, ListUsersResponse, UserRecord, CreateUserBody, UpdateUserBody, MintedUserToken, ListUserTokensResponse, RunnableAgentsResponse, LLMChatOptions, LLMChatResponse, LLMChatStreamItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, MCPServerDefVerifyResult, MemoryEmbedStatsResponse, MemoryEntriesResponse, MemoryEntryResponse, MemoryBackfillResponse, MemoryPurgeResponse, MemoryReembedResponse, MemoryScopeIDsResponse, MemoryScopesResponse, MemorySearchInput, MemorySearchResponse, PauseResult, PersistentVolumesResponse, EphemeralVolumesResponse, ResolveInterruptOptions, ResumeResult, ResolverMatrix, CompactRunResult, ReplaySessionResult, CancelTurnResult, ReviewRunResult, RunBatchOptions, RunBatchResult, RunOptions, ConfiguredRun, ConfiguredRunPatch, RunStateStreamItem, RuntimeStateResponse, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotRestoreResponse, StreamUserRunStatesOptions, SubstrateToolInput, SubstrateToolResponse, CreatedTeam, ListTeamsResponse, PromotedTeam, RetiredTeam, TeamBreakpoints, TeamDefDetail, TeamRunDetached, TeamRunTarget, TeamVerification, TeamVersionList, TeamDiagram, TeamRunResult, PathToolInput, PathToolResponse, DocumentToolInput, DocumentToolResponse, HistoryToolInput, HistoryToolResponse, TranscriptResponse, WhoamiResponse, UsageDimension, UsageReportResponse, TokenLimit, TokenLimitsResponse, ConfigResponse, SetTokenLimitRequest } from "./types.js";
+import type { CredentialListResponse, CredentialMeta, CredentialScope, DirectoryInspection, DirectoryTenant, DirectoryUser, ErasureReport, ErasureResult, Agent, AgentEvent, AgentStatus, CancelAgentResult, ClientOptions, ContinueOptions, RunOverrideOptions, EffectiveConfigResponse, RetuneRunResponse, RunConfigResponse, RunPromptResponse, CreateSnapshotOptions, EnsureCodeAgentOptions, EnsureCodeAgentResult, EnsureMcpServerOptions, EnsureMcpServerResult, HealthResponse, InterruptListResponse, InterruptStatus, WalkRunsPage, AckChannelOptions, AwaitChannelsOptions, BroadcastChannelsOptions, ChannelAckResult, ChannelAwaitResult, ChannelBroadcastResult, ChannelDescriptor, ChannelPeekResult, ChannelPublishResult, ChannelPurgeResult, ChannelReleaseResult, ChannelSubscribeResult, CreateChannelOptions, ListChannelsResponse, PeekChannelOptions, PublishChannelOptions, ReleaseChannelOptions, SetMemoryEntryOptions, SetMemoryEntryResponse, SubscribeChannelOptions, UpdateChannelOptions, LibraryAgentDefinition, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, ListUsersResponse, UserRecord, CreateUserBody, UpdateUserBody, MintedUserToken, ListUserTokensResponse, RunnableAgentsResponse, LLMChatOptions, LLMChatResponse, LLMChatStreamItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, MCPServerDefVerifyResult, MemoryEmbedStatsResponse, MemoryEntriesResponse, MemoryEntryResponse, MemoryBackfillResponse, MemoryPurgeResponse, MemoryReembedResponse, MemoryScopeIDsResponse, MemoryScopesResponse, MemorySearchInput, MemorySearchResponse, PauseResult, PersistentVolumesResponse, EphemeralVolumesResponse, ResolveInterruptOptions, ResumeResult, ResolverMatrix, CompactRunResult, ReplaySessionResult, CancelTurnResult, ReviewRunResult, RunBatchOptions, RunBatchResult, RunOptions, ConfiguredRun, ConfiguredRunPatch, RunStateStreamItem, RuntimeStateResponse, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotRestoreResponse, StreamUserRunStatesOptions, SubstrateToolInput, SubstrateToolResponse, CreatedTeam, ListTeamsResponse, PromotedTeam, RetiredTeam, TeamBreakpoints, TeamDefDetail, TeamRunDetached, TeamRunTarget, TeamVerification, TeamDraft, TeamDraftVerification, TeamVersionList, TeamDiagram, TeamRunResult, PathToolInput, PathToolResponse, DocumentToolInput, DocumentToolResponse, HistoryToolInput, HistoryToolResponse, TranscriptResponse, WhoamiResponse, UsageDimension, UsageReportResponse, TokenLimit, TokenLimitsResponse, ConfigResponse, SetTokenLimitRequest } from "./types.js";
 export declare class LoomcycleClient {
     private ctx;
     constructor(opts?: ClientOptions);
@@ -222,11 +222,13 @@ export declare class LoomcycleClient {
      * N parallel {@link LoomcycleClient.runStreaming} calls.
      *
      * Each spawn is a fresh run (its `sessionId` is ignored). Capped at 32 —
-     * an over-cap batch rejects with InvalidArgumentError. `mode: "detach"`
-     * (async handles) is reserved for a future release and rejected today.
+     * an over-cap batch rejects with InvalidArgumentError.
      *
-     * Blocking: resolves only when the slowest child finishes (or `timeoutMs`
-     * elapses). Mirrors POST /v1/runs:batch.
+     * Blocking by default: resolves only when the slowest child finishes (or
+     * `timeoutMs` elapses). With `mode: "detach"` it resolves once every child
+     * has started — each with `status: "running"` and its `run_id` — and the
+     * runs go on; read one with {@link LoomcycleClient.getRun}. Mirrors
+     * POST /v1/runs:batch.
      */
     spawnRunBatch(opts: RunBatchOptions): Promise<RunBatchResult>;
     /**
@@ -539,9 +541,11 @@ export declare class LoomcycleClient {
     whoami(opts?: {
         signal?: AbortSignal;
     }): Promise<WhoamiResponse>;
-    /** Quiesce the runtime. Idempotent tools cancel immediately;
-     *  non-idempotent + external tools get a grace window then
-     *  force-cancel. Raises AlreadyPausingError on 409,
+    /** Quiesce the runtime: new runs are refused and each in-flight run
+     *  parks at its next iteration boundary, after the model or tool call it
+     *  is in finishes — no tool call is cancelled. Waits up to `timeoutMs`
+     *  (default 30 s, max 5 min) for runs to park; any that did not are named
+     *  in `warnings`. Raises AlreadyPausingError on 409,
      *  PauseNotConfiguredError on 503. */
     pauseRuntime(opts?: {
         timeoutMs?: number;
@@ -1023,10 +1027,18 @@ export declare class LoomcycleClient {
      *
      *  Never raises for an absent team: a name with no active version answers
      *  `{deployed: false, matches: false}`, which a caller distinguishes from a
-     *  deployed version whose hash differs. */
+     *  deployed version whose hash differs.
+     *
+     *  Given a {@link TeamDraft} instead of a hash, it checks that UNSAVED team
+     *  the way `createTeam` / `forkTeam` would — every check they run, plus
+     *  what would make it unrunnable — and returns all the problems at once,
+     *  each with the JSON path at fault. Nothing is written. */
     verifyTeam(name: string, contentSha256: string, opts?: {
         signal?: AbortSignal;
     }): Promise<TeamVerification>;
+    verifyTeam(name: string, draft: TeamDraft, opts?: {
+        signal?: AbortSignal;
+    }): Promise<TeamDraftVerification>;
     /** Hard-remove a whole team by name — all versions + the active pointer
      *  (op=delete), scoped to the caller's tenant. Teams are runtime-only, so
      *  this is how an operator clears an obsolete/test team. */

package/dist/client.js

@@ -484,11 +484,13 @@ export class LoomcycleClient {
      * N parallel {@link LoomcycleClient.runStreaming} calls.
      *
      * Each spawn is a fresh run (its `sessionId` is ignored). Capped at 32 —
-     * an over-cap batch rejects with InvalidArgumentError. `mode: "detach"`
-     * (async handles) is reserved for a future release and rejected today.
+     * an over-cap batch rejects with InvalidArgumentError.
      *
-     * Blocking: resolves only when the slowest child finishes (or `timeoutMs`
-     * elapses). Mirrors POST /v1/runs:batch.
+     * Blocking by default: resolves only when the slowest child finishes (or
+     * `timeoutMs` elapses). With `mode: "detach"` it resolves once every child
+     * has started — each with `status: "running"` and its `run_id` — and the
+     * runs go on; read one with {@link LoomcycleClient.getRun}. Mirrors
+     * POST /v1/runs:batch.
      */
     async spawnRunBatch(opts) {
         const body = {
@@ -845,9 +847,11 @@ export class LoomcycleClient {
         return jsonFetch(this.ctx, "/v1/_me", opts);
     }
     // ---- v0.8.17/8.18 Pause / Resume / State ----
-    /** Quiesce the runtime. Idempotent tools cancel immediately;
-     *  non-idempotent + external tools get a grace window then
-     *  force-cancel. Raises AlreadyPausingError on 409,
+    /** Quiesce the runtime: new runs are refused and each in-flight run
+     *  parks at its next iteration boundary, after the model or tool call it
+     *  is in finishes — no tool call is cancelled. Waits up to `timeoutMs`
+     *  (default 30 s, max 5 min) for runs to park; any that did not are named
+     *  in `warnings`. Raises AlreadyPausingError on 409,
      *  PauseNotConfiguredError on 503. */
     async pauseRuntime(opts) {
         const body = opts?.timeoutMs && opts.timeoutMs > 0
@@ -1498,15 +1502,21 @@ export class LoomcycleClient {
     async retireTeam(defId, retired, opts) {
         return postJSON(this.ctx, "/v1/_teamdef", { op: "retire", def_id: defId, retired }, opts);
     }
-    /** Compare a locally computed content hash against the deployed active
-     *  version (op=verify) — the drift check for a team kept in source control
-     *  and pushed to several deployments.
-     *
-     *  Never raises for an absent team: a name with no active version answers
-     *  `{deployed: false, matches: false}`, which a caller distinguishes from a
-     *  deployed version whose hash differs. */
-    async verifyTeam(name, contentSha256, opts) {
-        return postJSON(this.ctx, "/v1/_teamdef", { op: "verify", name, content_sha256: contentSha256 }, opts);
+    async verifyTeam(name, target, opts) {
+        const body = { op: "verify", name };
+        if (typeof target === "string") {
+            body.content_sha256 = target;
+        }
+        else {
+            body.overlay = target.overlay;
+            if (target.as)
+                body.as = target.as;
+            if (target.parentDefId)
+                body.parent_def_id = target.parentDefId;
+            if (target.description)
+                body.description = target.description;
+        }
+        return postJSON(this.ctx, "/v1/_teamdef", body, opts);
     }
     /** Hard-remove a whole team by name — all versions + the active pointer
      *  (op=delete), scoped to the caller's tenant. Teams are runtime-only, so

package/dist/index.d.ts

@@ -130,5 +130,5 @@ export { InteractiveSession } from "./interactive.js";
 export type { InteractiveSessionOps } from "./interactive.js";
 export { ClientToolHost, clientToolsURL, CLIENT_TOOL_SUBPROTOCOL } from "./client-tools.js";
 export type { ClientToolSchema, ClientToolInvocation, ConnectClientToolsOptions, WebSocketLike, WebSocketCtor, } from "./client-tools.js";
-export type { AgentEvent, ClientOptions, ContinueOptions, EventType, HostWidening, ImageMediaType, ParentContext, PromptContent, PromptSegment, RetryInfo, RunOptions, SamplingOptions, CompactionOptions, ContextOptions, ToolUse, Usage, CallTiming, Agent, AgentStatus, AwaitedState, AgentUsage, RunResult, RunSpec, RunSpecTeam, ConfiguredRun, ConfiguredRunPatch, ToolChoiceOptions, OutputFormatOptions, CancelAgentResult, ListAgentsResponse, WalkRunsPage, RunBatchOptions, RunBatchResult, SpawnRunResult, CompactRunResult, DirectoryBudget, DirectoryInspection, DirectoryTenant, DirectoryUser, ErasureReport, ErasureResidue, ErasureResult, ErasureTier, CancelTurnResult, ReviewRunResult, TranscriptEvent, TranscriptResponse, HealthResponse, ListUsersResponse, UserSummary, UserRecord, CreateUserBody, UpdateUserBody, MintedUserToken, UserTokenMeta, ListUserTokensResponse, RunnableAgent, RunnableAgentsResponse, WhoamiResponse, PauseResult, ResumeResult, RuntimeStateResponse, RuntimeStateStatus, ResolverMatrix, ResolverModelStatus, ResolverProviderAvailability, CreateSnapshotOptions, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotListResponse, SnapshotRestoreResponse, MemoryEntriesResponse, MemoryEntry, MemoryEntryResponse, MemoryScopeIDsResponse, MemoryScopeIDSummary, MemoryScopeKind, MemoryScopesResponse, MemorySearchInput, MemorySource, MemoryWhen, MemoryTimeFilter, MemorySearchEntry, MemorySearchResponse, MemoryEmbedModelStats, MemoryEmbedStatsResponse, MemoryReembedConfigured, MemoryReembedResponse, MemoryBackfillResponse, MemoryPurgeResponse, InterruptListResponse, InterruptRow, InterruptStatus, ResolveInterruptOptions, ChannelHookCall, ChannelHookResult, HookFailMode, HookPhase, HookToolCall, HookToolResult, PostHookCall, PostHookResult, PreHookCall, PreHookResult, SubstrateToolInput, SubstrateToolResponse, TeamNameSummary, ListTeamsResponse, TeamDiagram, CreatedTeam, PromotedTeam, RetiredTeam, TeamDefDetail, TeamVerification, TeamVersion, TeamVersionList, TeamBreakpoints, TeamRunDetached, TeamRunResult, TeamRunTarget, PathToolInput, PathToolResponse, DocumentToolInput, DocumentToolResponse, HistoryToolInput, HistoryToolResponse, VolumeMode, PersistentVolumeEntry, PersistentVolumesResponse, EphemeralVolumeEntry, EphemeralVolumesResponse, SystemPromptPayload, UserInputPayload, ChannelDescriptor, ListChannelsResponse, RunStateEvent, RunStateStreamClose, RunStateStreamItem, RunStateStreamOpen, StreamUserRunStatesOptions, AckChannelOptions, ChannelAckResult, ChannelMessageItem, ChannelPeekResult, ChannelPublishResult, ChannelPurgeResult, ChannelReleaseResult, ChannelScope, ChannelSubscribeResult, PeekChannelOptions, PublishChannelOptions, SubscribeChannelOptions, AwaitChannelsOptions, BroadcastChannelsOptions, ChannelAwaitEntry, ChannelAwaitMode, ChannelAwaitResult, ChannelBroadcastEntry, ChannelBroadcastResult, CreateChannelOptions, ReleaseChannelOptions, UpdateChannelOptions, SetMemoryEntryOptions, SetMemoryEntryResponse, AgentDefRowResponse, AgentDefVerifyResult, SkillDefVerifyResult, EnsureMcpServerOptions, EnsureMcpServerResult, MCPServerDefRowResponse, MCPServerDefVerifyResult, AgentDefOverlay, HookEvent, InlineWebhook, HookEntry, EventHooks, ToolEntry, ToolHooksByTool, EnsureCodeAgentOptions, EnsureCodeAgentResult, LibraryAgentDefinition, LibraryEntry, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, LLMChatContent, LLMChatMessage, LLMChatOptions, LLMChatResponse, LLMChatStreamDelta, LLMChatStreamItem, LLMChatToolCall, LLMChatUsage, LLMTool, LLMEmbeddingItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, LLMEmbeddingsUsage, UsageDimension, UsageAggregate, UsageReportResponse, CapabilityInertInfo, LimitInfo, ErrorInfo, CallFormat, CallRef, HookDecisionInfo, EffectiveConfigResponse, EffectiveConfigSource, EffectiveValue, RetuneRunResponse, RunConfigRecord, SubagentHoldInfo, RunConfigResponse, RunPromptResponse, RunPromptSnapshot, PromptBlock, TokenLimit, TokenLimitsResponse, ConfigResponse, ConfigProvider, ConfigModel, ConfigSearch, ConfigInstance, SetTokenLimitRequest, CredentialScope, CredentialMeta, CredentialListResponse, } from "./types.js";
+export type { AgentEvent, ClientOptions, ContinueOptions, EventType, HostWidening, ImageMediaType, ParentContext, PromptContent, PromptSegment, RetryInfo, RunOptions, SamplingOptions, CompactionOptions, ContextOptions, ToolUse, Usage, CallTiming, Agent, AgentStatus, AwaitedState, AgentUsage, RunResult, RunSpec, RunSpecTeam, ConfiguredRun, ConfiguredRunPatch, ToolChoiceOptions, OutputFormatOptions, CancelAgentResult, ListAgentsResponse, WalkRunsPage, RunBatchOptions, RunBatchResult, SpawnRunResult, CompactRunResult, DirectoryBudget, DirectoryInspection, DirectoryTenant, DirectoryUser, ErasureReport, ErasureResidue, ErasureResult, ErasureTier, CancelTurnResult, ReviewRunResult, TranscriptEvent, TranscriptResponse, HealthResponse, ListUsersResponse, UserSummary, UserRecord, CreateUserBody, UpdateUserBody, MintedUserToken, UserTokenMeta, ListUserTokensResponse, RunnableAgent, RunnableAgentsResponse, WhoamiResponse, PauseResult, ResumeResult, RuntimeStateResponse, RuntimeStateStatus, ResolverMatrix, ResolverModelStatus, ResolverProviderAvailability, CreateSnapshotOptions, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotListResponse, SnapshotRestoreResponse, MemoryEntriesResponse, MemoryEntry, MemoryEntryResponse, MemoryScopeIDsResponse, MemoryScopeIDSummary, MemoryScopeKind, MemoryScopesResponse, MemorySearchInput, MemorySource, MemoryWhen, MemoryTimeFilter, MemorySearchEntry, MemorySearchResponse, MemoryEmbedModelStats, MemoryEmbedStatsResponse, MemoryReembedConfigured, MemoryReembedResponse, MemoryBackfillResponse, MemoryPurgeResponse, InterruptListResponse, InterruptRow, InterruptStatus, ResolveInterruptOptions, ChannelHookCall, ChannelHookResult, HookFailMode, HookPhase, HookToolCall, HookToolResult, PostHookCall, PostHookResult, PreHookCall, PreHookResult, SubstrateToolInput, SubstrateToolResponse, TeamNameSummary, ListTeamsResponse, TeamDiagram, CreatedTeam, PromotedTeam, RetiredTeam, TeamDefDetail, TeamVerification, TeamDraft, TeamDraftVerification, TeamIssue, TeamIssueKind, TeamVersion, TeamVersionList, TeamBreakpoints, TeamRunDetached, TeamRunResult, TeamRunTarget, PathToolInput, PathToolResponse, DocumentToolInput, DocumentToolResponse, HistoryToolInput, HistoryToolResponse, VolumeMode, PersistentVolumeEntry, PersistentVolumesResponse, EphemeralVolumeEntry, EphemeralVolumesResponse, SystemPromptPayload, UserInputPayload, ChannelDescriptor, ListChannelsResponse, RunStateEvent, RunStateStreamClose, RunStateStreamItem, RunStateStreamOpen, StreamUserRunStatesOptions, AckChannelOptions, ChannelAckResult, ChannelMessageItem, ChannelPeekResult, ChannelPublishResult, ChannelPurgeResult, ChannelReleaseResult, ChannelScope, ChannelSubscribeResult, PeekChannelOptions, PublishChannelOptions, SubscribeChannelOptions, AwaitChannelsOptions, BroadcastChannelsOptions, ChannelAwaitEntry, ChannelAwaitMode, ChannelAwaitResult, ChannelBroadcastEntry, ChannelBroadcastResult, CreateChannelOptions, ReleaseChannelOptions, UpdateChannelOptions, SetMemoryEntryOptions, SetMemoryEntryResponse, AgentDefRowResponse, AgentDefVerifyResult, SkillDefVerifyResult, EnsureMcpServerOptions, EnsureMcpServerResult, MCPServerDefRowResponse, MCPServerDefVerifyResult, AgentDefOverlay, HookEvent, InlineWebhook, HookEntry, EventHooks, ToolEntry, ToolHooksByTool, EnsureCodeAgentOptions, EnsureCodeAgentResult, LibraryAgentDefinition, LibraryEntry, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, LLMChatContent, LLMChatMessage, LLMChatOptions, LLMChatResponse, LLMChatStreamDelta, LLMChatStreamItem, LLMChatToolCall, LLMChatUsage, LLMTool, LLMEmbeddingItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, LLMEmbeddingsUsage, UsageDimension, UsageAggregate, UsageReportResponse, CapabilityInertInfo, LimitInfo, ErrorInfo, CallFormat, CallRef, HookDecisionInfo, EffectiveConfigResponse, EffectiveConfigSource, EffectiveValue, RetuneRunResponse, RunConfigRecord, SubagentHoldInfo, RunConfigResponse, RunPromptResponse, RunPromptSnapshot, PromptBlock, TokenLimit, TokenLimitsResponse, ConfigResponse, ConfigProvider, ConfigModel, ConfigSearch, ConfigInstance, SetTokenLimitRequest, CredentialScope, CredentialMeta, CredentialListResponse, } from "./types.js";
 export { AgentIDInUseError, AgentNotFoundError, AlreadyPausingError, AuthError, BackpressureError, NotFoundError, InvalidArgumentError, ChannelCursorRegressionError, LoomcycleError, NotPausedError, PauseNotConfiguredError, PerUserQuotaExhaustedError, SessionBusyError, SessionNotFoundError, SnapshotNotFoundError, SnapshotTooLargeError, SnapshotVersionError, SubstrateToolRefusedError, UnavailableError, } from "./errors.js";

package/dist/types.d.ts

@@ -7,7 +7,7 @@
  * `client.ts` for the input shapes (RunOptions, CreateSnapshotOptions,
  * etc.) — those are translated to snake_case in the request body.
  */
-export type EventType = "started" | "text" | "tool_call" | "tool_result" | "usage" | "done" | "error" | "retry" | "host_widened" | "session" | "agent" | "awaiting_input" | "awaiting_review" | "subagent_hold" | "steer" | "context_compaction" | "capability_inert" | "hook_decision" | "limit" | "override" | "context_recap" | "context_state" | "context_distill_declined" | "context_exhausted" | "thinking" | "turn_cancelled" | "provider_fallback" | "fallback_suppressed" | "model_downgraded" | "cache_invalidated" | "reasoning_invalidated" | "channel_publish" | "channel_delivery" | "interruption_pending" | "spawn_child_started" | "spawn_child_result" | "prompt_snapshot" | "_meta";
+export type EventType = "started" | "text" | "tool_call" | "tool_result" | "usage" | "done" | "error" | "retry" | "host_widened" | "session" | "agent" | "awaiting_input" | "awaiting_review" | "subagent_hold" | "awaiting_children" | "children_note" | "steer" | "context_compaction" | "capability_inert" | "hook_decision" | "limit" | "override" | "context_recap" | "context_state" | "context_distill_declined" | "context_exhausted" | "thinking" | "turn_cancelled" | "provider_fallback" | "fallback_suppressed" | "model_downgraded" | "cache_invalidated" | "reasoning_invalidated" | "channel_publish" | "channel_delivery" | "interruption_pending" | "spawn_child_started" | "spawn_child_result" | "spawn_child_read" | "prompt_snapshot" | "_meta";
 export interface ToolUse {
     id: string;
     name: string;
@@ -504,17 +504,36 @@ export interface TurnCancelledInfo {
     reason?: string;
     since_turn: number;
 }
-/** Payload on `spawn_child_started` / `spawn_child_result` — the two-event
- *  ledger a fan-out parent writes so an in-flight child survives a pause. */
+/** Payload on `spawn_child_started` / `spawn_child_result` /
+ *  `spawn_child_read` — the ledger a parent writes so its children survive a
+ *  pause: a fan-out's in-flight children, and its poll-mode children (`mode:
+ *  "poll"`) with how each ended and whether the parent has read it. */
 export interface SpawnChildInfo {
     tool_use_id: string;
     index: number;
     run_id?: string;
     agent?: string;
+    /** "poll" for a poll-mode child; absent for a wait-mode fan-out child. */
+    mode?: string;
+    batch_id?: string;
+    /** "team" for a team walk run in poll mode. */
+    kind?: string;
+    team?: string;
+    def_id?: string;
+    /** The child was started with notify: false / on_parent_end: "cancel". */
+    no_notify?: boolean;
+    cancel_on_parent_end?: boolean;
+    /** A poll-mode sub-agent's per-child timeout_ms, on its started row. */
+    timeout_ms?: number;
     ok?: boolean;
     output?: string;
     error?: string;
     state?: Record<string, unknown>;
+    /** A poll-mode child's final state (completed, failed, cancelled, timeout). */
+    ended?: string;
+    status?: string;
+    /** A team walk's whole answer, steps included. */
+    detail?: Record<string, unknown>;
 }
 export interface AgentEvent {
     type: EventType;
@@ -552,6 +571,18 @@ export interface AgentEvent {
      *  rule on it with {@link LoomcycleClient.reviewRun} on `subagent_run_id`)
      *  or has ended (`state` "released", with `status`). */
     subagent_hold?: SubagentHoldInfo;
+    /** Payload on `event: awaiting_children` — the background children the
+     *  run waits for before its next turn. */
+    awaiting_children?: {
+        child_run_ids?: string[];
+        since_turn?: number;
+    };
+    /** Payload on `event: children_note` — the note's text, as the model reads it,
+     * and the background children it reports. */
+    children_note?: {
+        text?: string;
+        child_run_ids?: string[];
+    };
     /** Payload on `event: steer` (RFC AI) — the operator's drained turn. On a
      *  re-attach replay, `source` is `"replay"`. Nil on all other event types. */
     user_input?: {
@@ -602,7 +633,7 @@ export interface AgentEvent {
     interruption?: InterruptionEventInfo;
     /** Payload on `turn_cancelled`. */
     turn_cancelled?: TurnCancelledInfo;
-    /** Payload on `spawn_child_started` / `spawn_child_result`. */
+    /** Payload on `spawn_child_started` / `spawn_child_result` / `spawn_child_read`. */
     spawn_child?: SpawnChildInfo;
     /** Payload on `prompt_snapshot` (transcript only). */
     prompt_snapshot?: RunPromptSnapshot;
@@ -1123,9 +1154,11 @@ export interface ClientOptions {
 /** `rejected` is a run a reviewer turned down without feedback (RFC DJ). */
 export type AgentStatus = "configured" | "running" | "completed" | "failed" | "cancelled" | "rejected";
 /** What a running run is blocked on: an open Channel subscribe, an open
- *  Interruption ask, a hold for an operator's review verdict, or an
- *  interactive run parked for the operator's next turn (`input`). */
-export type AwaitedState = "channel" | "interrupted" | "review" | "input";
+ *  Interruption ask, a hold for an operator's review verdict, an
+ *  interactive run parked for the operator's next turn (`input`), or a run
+ *  that ended its turn and waits for its background (poll-mode) children
+ *  to end (`children`). */
+export type AwaitedState = "channel" | "interrupted" | "review" | "input" | "children";
 export interface AgentUsage {
     input_tokens?: number;
     output_tokens?: number;
@@ -1162,8 +1195,9 @@ export interface Agent {
     awaited_state?: AwaitedState;
     /** The channel name (`awaited_state: "channel"`; a fan-in `Channel` await
      *  lists its channels comma-separated, bounded), interruption kind
-     *  (`awaited_state: "interrupted"`) or the agent_stop hook holding a review
-     *  (`awaited_state: "review"`) the run waits on. */
+     *  (`awaited_state: "interrupted"`), the agent_stop hook holding a review
+     *  (`awaited_state: "review"`) or the child run ids, comma-separated and
+     *  bounded (`awaited_state: "children"`) the run waits on. */
     awaited_on?: string;
     /** The replica owning the run's live cancel handle. Absent in a
      *  single-replica deployment. */
@@ -1272,7 +1306,18 @@ export interface RunSpec {
             }>;
         };
         fanout_cap?: number;
+        /** A resident child (Agent op=open), which a resume rebuilds as one. */
+        resident?: boolean;
+        /** Unix seconds a resident child was last polled or cancelled from a
+         *  replica that does not hold it; its own replica reads it before it
+         *  reaps the child as idle. */
+        addressed_at?: number;
     };
+    /** The iteration limit the run started with. Absent for a run with none
+     *  (unbounded, or an interactive run with no `max_iterations` of its own)
+     *  and for a run recorded before the field existed. Written by the server
+     *  only. */
+    iteration_limit?: number;
     /** The agent version the run started on, which a resumed run continues on:
      *  the AgentDef version its agent name resolved to (`def_id` absent for an
      *  agent with no versions — the operator's yaml or a registered agent). For
@@ -1307,6 +1352,37 @@ export interface RunSpec {
         def_id: string;
         def_tenant?: string;
     };
+    /** A code agent's time as of its last pause: the active time it had used
+     *  against `run_timeout_seconds`, the time it had spent waiting (which
+     *  never counts against that budget), and how long it had lived — waits
+     *  included, runtime pauses excluded — against the operator's lifetime
+     *  limit. A resumed run continues from it rather than starting fresh.
+     *  Absent on a run that never paused, and on every run that is not a code
+     *  agent. Written by the server only. */
+    run_clock?: {
+        active_ms: number;
+        waited_ms: number;
+        wall_ms: number;
+    };
+    /** The runtime pauses this run lived through, oldest first: when each
+     *  began (when the runtime paused) and, once it ended, when — the resume,
+     *  or the run's re-dispatch after a restore or a restart. The last has no
+     *  `until` while the pause lasts. A parent re-arming this run's
+     *  `timeout_ms` after a resume leaves them out. Past 16 the oldest are
+     *  folded into `pauses_folded`. Absent on a run that never lived through a
+     *  pause. Written by the server only. */
+    pauses?: {
+        since: string;
+        until?: string;
+    }[];
+    /** The pauses folded out of `pauses`: the time, in nanoseconds, before
+     *  `until` that the run's `timeout_ms` was stopped — its pauses and its
+     *  review holds, an overlap counted once. Absent until the run has lived
+     *  through more than 16 pauses. Written by the server only. */
+    pauses_folded?: {
+        until: string;
+        stopped_ns: number;
+    };
 }
 /** What a team walk started with (`RunSpec.team`). */
 export interface RunSpecTeam {
@@ -1330,7 +1406,10 @@ export interface RunSpecTeam {
      *  team's default is not listed, and reads from the definition version
      *  this record names. Absent when the start supplied none. */
     vars?: Record<string, string>;
-    mode: "sync" | "detach";
+    /** How the walk was started: waited for (`sync`), handed back at once and
+     *  run outside its caller (`detach`), or run as a background child of the
+     *  agent run that started it (`poll`). */
+    mode: "sync" | "detach" | "poll";
     /** The board binding; `resumed_from` names the state a persisted board
      *  resumed the walk from. */
     board?: {
@@ -1383,11 +1462,15 @@ export interface CancelAgentResult {
 export interface RunBatchOptions {
     spawns: RunOptions[];
     /** "join" (default) — block until all children settle, returning the
-     *  combined envelope. "detach" (async run handles) is reserved for a future
-     *  release and rejected by the server today. */
-    mode?: "join";
+     *  combined envelope. "detach" — resolve once every child has started:
+     *  each started child reports `status: "running"` with its `run_id`, keeps
+     *  running after the call, and is read with {@link LoomcycleClient.getRun}
+     *  and stopped with {@link LoomcycleClient.cancelAgent}; a child that could
+     *  not start is reported in its slot, as in join. */
+    mode?: "join" | "detach";
     /** Optional join deadline (ms): a child still running when it elapses is
-     *  cancelled and reported with a cancelled status in-envelope. */
+     *  cancelled and reported with a cancelled status in-envelope. Rejected
+     *  (400) with `mode: "detach"`, which does not wait. */
     timeoutMs?: number;
     signal?: AbortSignal;
 }
@@ -1697,6 +1780,7 @@ export type RuntimeStateStatus = "running" | "pausing" | "paused";
 export interface PauseResult {
     state: string;
     duration_ms: number;
+    /** Always 0: pause cancels no tool call. Kept for wire compatibility. */
     force_cancelled_count: number;
     paused_runs_count: number;
     warnings?: string[];
@@ -2253,6 +2337,72 @@ export interface TeamVerification {
     current_sha256: string;
     current_def_id: string;
     version: number;
+    /** Whether a walk could run the deployed version: false when it references
+     *  something that does not resolve (see `issues`). Absent when
+     *  `deployed: false`, or when the stored definition does not parse. */
+    runnable?: boolean;
+    /** What the deployed version references but does not contain. Present only
+     *  when there is something to report. */
+    issues?: TeamIssue[];
+}
+/** What a {@link TeamIssue} is about. A wire enum that only grows: a kind this
+ *  client does not know is still a `string`, so a new one never breaks a build. */
+export type TeamIssueKind = "name_invalid" | "parent_not_found" | "overlay_invalid" | "graph_invalid" | "size_cap" | "channel_reserved" | "channel_authority" | "acl_missing" | "channel_undeclared" | "local_channel_invalid" | "local_channel_missing" | "local_agent_invalid" | "local_agent_authority" | "local_agent_collision" | "local_agent_missing" | "local_agent_unreferenced" | "local_skill_invalid" | "local_webhook_authority" | "local_webhook_invalid" | "agent_missing" | "uncheckable" | (string & {});
+/** One problem with a team definition, from {@link LoomcycleClient.verifyTeam}.
+ *
+ *  `severity`: `refused` — a create or fork would be refused (its `detail` is
+ *  exactly the refusal); `unrunnable` — it would be stored, but a walk could not
+ *  run it; `advisory` — worth reading, stops nothing. */
+export interface TeamIssue {
+    kind: TeamIssueKind;
+    severity: "refused" | "unrunnable" | "advisory";
+    detail: string;
+    /** JSON path of the value at fault in the definition, e.g.
+     *  `states[2].handler.sink.channel` or `local.agents.reviewer`. Absent when
+     *  the problem is the definition as a whole. */
+    path?: string;
+    /** The state the problem is in, and the handler field within it. */
+    state?: string;
+    field?: string;
+    /** What the problem names. */
+    channel?: string;
+    agent?: string;
+    skill?: string;
+    side?: "publish" | "subscribe";
+    /** Set (true) on an advisory issue — the older spelling of
+     *  `severity: "advisory"`, kept for clients that read it. */
+    advisory?: boolean;
+}
+/** An unsaved team for {@link LoomcycleClient.verifyTeam} to check. */
+export interface TeamDraft {
+    /** Exactly what `createTeam` / `forkTeam` would be sent. */
+    overlay: Record<string, unknown>;
+    /** Check it as a create or as a fork. Omitted: as a save would — a fork of
+     *  the active version when the name has one, else a create. */
+    as?: "create" | "fork";
+    /** Check it as a fork of this version. */
+    parentDefId?: string;
+    /** The description the save would carry (its size is checked too). */
+    description?: string;
+}
+/** Result of {@link LoomcycleClient.verifyTeam} for a {@link TeamDraft}: every
+ *  problem a create or fork would refuse, plus what would make the stored team
+ *  unrunnable — all at once. Nothing is written. */
+export interface TeamDraftVerification extends TeamVerification {
+    /** No `refused` issue: a create or fork with this overlay would be accepted. */
+    valid: boolean;
+    /** Valid, and no `unrunnable` issue. */
+    runnable: boolean;
+    /** How the draft was checked. */
+    checked_as: "create" | "fork";
+    /** The version the fork would start from (`checked_as: "fork"`). */
+    parent_def_id?: string;
+    /** The hash the save would sign. Absent when the overlay cannot be built.
+     *  `matches` compares it with the deployed version's. */
+    content_sha256?: string;
+    /** Every problem found, refusals first in the order a save checks them;
+     *  empty when there are none. */
+    issues: TeamIssue[];
 }
 /** Result of {@link LoomcycleClient.runTeam} (op=run) — the walk trace. `status`
  *  is `"completed"` (a terminal state was reached) or `"iteration_cap"` (a
@@ -2932,7 +3082,8 @@ export interface RunStateEvent {
      *  field, so a client folding the stream holds the run's current wait. */
     awaited_state?: AwaitedState;
     /** The channel (a fan-in `Channel` await: its channels, comma-separated),
-     *  the interruption kind, or the agent_stop hook holding a review. */
+     *  the interruption kind, the agent_stop hook holding a review, or the
+     *  background child run ids (comma-separated) a run waits on. */
     awaited_on?: string;
     /** RFC3339: when a review hold ends as rejected if nobody rules on it.
      *  Absent when the wait has no deadline. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomcycle/client",
-  "version": "1.104.0",
+  "version": "1.105.0",
   "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 71 methods covering run streaming, agent metadata, pause/resume/state, resolver re-probe (resolveProbe — issue #88 operator escape hatch), operator-token admin (operatorTokenDef — RFC L OSS multi-tenant auth) + whoami (RFC L authoritative principal, v0.17.0) + tenant-scoped listUsers / listUserAgents, dynamic MCP registration (mcpServerDef + v0.18.0 typed mcpServerDefVerify + ensureMcpServer idempotent register-if-changed), snapshot lifecycle, memory admin (incl. v0.9.0 Vector Memory embed_stats + reembed AND v0.11.5 setMemoryEntry + deleteMemoryEntry), interruption resolve, hook management, v0.8.22 substrate admin (agentDef + skillDef), v0.9.x n8n Phase 0 (listChannels + streamUserRunStates), v0.9.x Channel CRUD (publishChannel + subscribeChannel + peekChannel + ackChannel), v0.11.5 Channel admin CRUD (createChannel + updateChannel + deleteChannel — runtime substrate; yaml channels refuse mutation with HTTP 409), v0.9.x content_sha256 verify, v0.9.1 transcript first-cycle, v0.9.x dynamic MCP server registration (mcpServerDef + MCPServerDefVerifyResult), v0.10.3 Library v2 enumeration (listLibraryAgents + listLibrarySkills + listLibraryMcpServers), and v0.11.0 LLM Gateway (llmChat + llmStream — direct provider routing without agent overhead; primary target is n8n's LoomCycleChatModel AI Agent sub-node and any LangChain-compatible consumer). v0.10.1 — dual ESM + CommonJS distribution (additive — ESM consumers unchanged; CJS consumers like n8n's community-node loader now work). v0.19.0 — typed inline code-js agent ingestion (AgentDefOverlay.code_body + ensureCodeAgent — register a deterministic code agent through the substrate with no host filesystem bind; RFC J). v0.20.0 — ensureMcpServer surfaces discoveredToolCount straight from create (loomcycle now auto-discovers MCP tools at ingestion); rediscover is now an explicit force-refresh. v0.21.0 — run/continue accept optional non-secret `metadata` (repo name, review policy, …) passed to the agent, symmetric with the WebHook/Schedule trigger paths. v0.22.0 — version-aligned lockstep release; no client-surface change (RFC N tenant isolation of the agent/skill/MCP/Schedule/Webhook definition plane + real op-schemas on the builtin MCP meta-tools are both server-side). v0.23.0 — version-aligned lockstep release; no client-surface change (RFCs O/P/R MCP-server hardening + thin client and the RFC Q DeepSeek tool-content fix are all server-side / MCP-transport-side). v0.24.0 — purgeChannel clears a channel's buffered messages without deleting its definition (allowed on yaml-declared channels too, unlike deleteChannel — F20); AgentDefOverlay gains channels / evaluation_scopes / interruption so a COMPLETE interactive/multi-agent agent round-trips over the substrate (F14). (Consolidates the interim 0.24/0.25 package bumps, which were never tag-published, back into lockstep with the loomcycle v0.24.0 tag.) v0.25.0 — adds the RFC S channel fan-in/fan-out client twins: awaitChannels() (wait for any/all/at_least N messages across channels, or a timeout — non-committing) + broadcastChannels() (publish one payload to N channels in one atomic-pre-flight call), the client-facing counterparts of the in-band Channel.await / Channel.broadcast tool ops (the rest of v0.25.0 — the manual-management Web UI console + Context op=time + max_fires self-retiring schedules — is server-side / in-band, no client-surface change). v0.29.1 — Usage gains optional `max_context_tokens` (the serving model's context-window ceiling, stamped by the loop from Provider.Capabilities() on each usage event) so a consumer can render a 'context used / max' gauge without a hard-coded per-model table; additive + optional, no behavior change. (Lockstep catch-up: the field landed in loomcycle v0.29.0 but the adapter publish skipped on a version mismatch; v0.29.1 realigns the package version with the release tag so it publishes.) v0.33.0 — gRPC + TS client parity for the RFC Y external fan-out and the compaction surface: spawnRunBatch() (POST /v1/runs:batch — spawn up to 32 fresh runs concurrently in one call, combined index-aligned envelope, per-child failures in-envelope) + compactRun(runId) (POST /v1/runs/{run_id}/compact — summarize a parked run's context); plus per-run sampling + compaction overrides now accepted on runStreaming / continueSession (an explicit temperature 0 is preserved as deterministic, not dropped as falsy). (The gRPC half adds the matching SpawnRunBatch / CompactRun RPCs + the sampling/compaction fields on RunRequest/ContinueRequest — server-side.) v0.34.0 — version-aligned lockstep release; no client-surface change (context-transform plugins / RFC Z Phase 1a are server-side config; the exp7 hardening pass is server-side; the R2 cross-provider thinking-model downgrade surfaces a new `model_downgraded` SSE event the generic stream passes through unchanged). v0.35.0 — RFC AH dynamic filesystem volumes: volumeDef() (POST /v1/_volumedef — op-discriminated create/get/list/delete/purge; a Volume is flat, so delete unmaps + purge RemoveAll's, no retire/promote/fork) + listVolumes() / listEphemeralVolumes() (GET /v1/_volumes[/ephemeral] — tenant-scoped; host paths redacted for non-operator callers). Tenant-confined; the runtime derives the path inside an operator-blessed dynamic_root, so callers pass name + mode, never a host path. v1.1.1 — RFC AI interactive agentic sessions: an `interactive: true` flag on runStreaming/continueSession (a run that parks at end_turn for steering) + sendRunInput(runId, text) (POST /v1/runs/{id}/input — steer a live run) + streamRunByID(runId, {fromSeq}) (GET /v1/runs/{id}/stream — re-attach by run_id; the operator's prior turns replay as `steer` events so a cold client reconstructs the whole conversation) + a high-level InteractiveSession driver (client.interactiveSession / attachInteractiveSession — events()/send()/cancel(), the adapter port of the Web UI run terminal). The AgentEvent union gains awaiting_input/steer/context_compaction frames. Version-aligned with the loomcycle v1.1.x line so the v1.1.1 tag publishes it (also carrying the previously-unpublished v0.35.0 volume surface). v1.4.0 — RFC AL Path VFS + RFC AK Document on the wire: path(input) (POST /v1/_path — a Unix-like filesystem over Memory/Volumes/Documents; resolve/ls/stat/mkdir/mv/rm) + document(input) (POST /v1/_document — chunked-graph documents; 13 ops, needs SQL Memory on the sidecar). Scope (agent/user/tenant) + tenant are resolved server-side from the authenticated principal, never the wire; an off-run scope:'user' op keys on the principal subject so it interoperates with that user's agent runs. New PathToolInput / DocumentToolInput types; responses are op-varying (unknown — narrow as needed). v1.7.0 — RFC AT image/vision input: the PromptContent union gains an `image` variant ({ type:'image'; media_type: ImageMediaType; data: base64-no-prefix }) accepted in a user segment by runStreaming / continueSession (segments pass through unchanged — no method change). The model must be vision-capable or the run errors before the call. New ImageMediaType type (image/png|jpeg|gif|webp). v1.12.1 — Path/Document browse-by-subject + the full Document op set (RFC AS/AK): path(input, opts) / document(input, opts) accept optional scopeId / tenant browse overrides sent as ?scope_id= / ?tenant= query params (server reads them from the URL, re-checks authorization; omit both to browse your own subject — byte-identical to the pre-RFC-AS request), and DocumentToolInput.op now covers all 16 backend ops (adds set_path, export_md, import_md) with the matching include_metadata / markdown fields. Additive — existing path() / document() callers are unchanged. v1.16.0 — RFC BC client-executed tools (local tool host): connectClientTools({tools,onInvoke}) opens a persistent WebSocket to /v1/client-tools, registers tools this client runs on the user's machine (browser DOM / files / shell), and answers the invoke frames loomcycle routes when an agent of your principal calls a client:<tool> — returning your reply as an ordinary tool result. Returns a ClientToolHost driver (.close() to stop; auto-reconnect); dependency-free (global WebSocket in browsers / Node 22+, or an injected WebSocketImpl like the ws package on older Node); the bearer rides the Sec-WebSocket-Protocol subprotocol (browsers can't set an Authorization header on a WebSocket). The runtime's first WebSocket surface. v1.45.0 — RFC BL P5 subject erasure: erasureReport(subject, {tenant}) (GET /v1/_erasure — what this deployment holds about one subject, in three tiers: deletable with existing primitives, subject-keyed but not deletable, and facts ABOUT the subject in scopes they do not own) + erasureExecute(subject, {dryRun, confirm, tenant}) (POST /v1/_erasure — removes tiers 1 and 2). DEFAULTS TO A DRY RUN: dryRun defaults true and a live run also requires confirm === subject. The tier-3 residue is traceable only through the subject's chats, which a live run deletes, so a report afterwards shows rows: 0 while those facts remain — the returned object is the only durable record of what was not reached; persist it. New ErasureReport / ErasureResult / ErasureTier / ErasureResidue types. v1.47.0 — RFC BV memory-view SDK: memorySearch() (POST /v1/_memory/search — off-run unified semantic search spanning k/v entries AND document-chunk bodies in one ranked list, each hit tagged kind memory|document with chunk_id on document hits) + memoryEmbedStats(scope) + reembedMemory(scope, scopeId, {dryRun,limit}) (the Vector Memory embed-admin reads the memory-view console needs; dry_run defaults true). Fact reads (list_facts + get_chunk's entity block) ride the existing document() passthrough. Additive — existing callers unchanged. v1.61.0 — RFC CJ per-run context-window override: runStreaming / continueSession accept an optional maxContextTokens (integer tokens) that wins over the agent's own max_context_tokens; omitted inherits it (which defers to the provider/driver default). Distinct from a model's output cap; primarily for local inference (Ollama num_ctx). Serialized as the snake_case max_context_tokens field on POST /v1/runs + the continuation body; additive, existing callers unchanged. v1.72.1 — the TeamDef version lifecycle: listTeamVersions(name) (op=list — every version of one team, newest first), promoteTeam(defId) (op=promote — point the active pointer, which is what a run BY NAME executes; forkTeam defaults to promote:false, so authoring and putting in force stay two steps), retireTeam(defId, retired) (op=retire — reversible and version-scoped, unlike deleteTeam) and verifyTeam(name, contentSha256) (op=verify — the drift check for a workflow kept in source control and pushed to several deployments; an absent team answers deployed:false rather than raising). The ops existed on the substrate and over HTTP; a client that could author a team could not put one in force.",
   "license": "Apache-2.0",
   "type": "module",