@loomcycle/client 0.20.0 → 0.22.0

package/dist/cjs/client.js

@@ -93,6 +93,10 @@ class LoomcycleClient {
             body.user_credentials = opts.userCredentials;
         if (opts.parentContext !== undefined)
             body.parent_context = opts.parentContext;
+        if (opts.metadata !== undefined)
+            body.metadata = opts.metadata;
+        if (opts.runTimeoutSeconds !== undefined)
+            body.run_timeout_seconds = opts.runTimeoutSeconds;
         yield* this.streamSSE("/v1/runs", body, opts.signal, opts.debug);
     }
     /**
@@ -133,6 +137,10 @@ class LoomcycleClient {
             body.user_credentials = opts.userCredentials;
         if (opts.parentContext !== undefined)
             body.parent_context = opts.parentContext;
+        if (opts.metadata !== undefined)
+            body.metadata = opts.metadata;
+        if (opts.runTimeoutSeconds !== undefined)
+            body.run_timeout_seconds = opts.runTimeoutSeconds;
         yield* this.streamSSE(`/v1/sessions/${encodeURIComponent(opts.sessionId)}/messages`, body, opts.signal, opts.debug);
     }
     // ---- Agent metadata ----

package/dist/client.js

@@ -90,6 +90,10 @@ export class LoomcycleClient {
             body.user_credentials = opts.userCredentials;
         if (opts.parentContext !== undefined)
             body.parent_context = opts.parentContext;
+        if (opts.metadata !== undefined)
+            body.metadata = opts.metadata;
+        if (opts.runTimeoutSeconds !== undefined)
+            body.run_timeout_seconds = opts.runTimeoutSeconds;
         yield* this.streamSSE("/v1/runs", body, opts.signal, opts.debug);
     }
     /**
@@ -130,6 +134,10 @@ export class LoomcycleClient {
             body.user_credentials = opts.userCredentials;
         if (opts.parentContext !== undefined)
             body.parent_context = opts.parentContext;
+        if (opts.metadata !== undefined)
+            body.metadata = opts.metadata;
+        if (opts.runTimeoutSeconds !== undefined)
+            body.run_timeout_seconds = opts.runTimeoutSeconds;
         yield* this.streamSSE(`/v1/sessions/${encodeURIComponent(opts.sessionId)}/messages`, body, opts.signal, opts.debug);
     }
     // ---- Agent metadata ----

package/dist/types.d.ts

@@ -148,6 +148,21 @@ export interface RunOptions {
      *  user-initiated request that spawned the whole tree. Not a secret.
      *  Omitted = no tracking context. */
     parentContext?: ParentContext;
+    /** Optional NON-SECRET structured metadata passed to the agent (repo
+     *  name, review policy, preferred skills, …) — symmetric with the
+     *  WebHook/Schedule trigger paths. As a first-party (bearer-authed)
+     *  caller this is TRUSTED: a code-js agent reads it as `input.metadata`;
+     *  an LLM agent receives it as a trusted prompt block. NOT for secrets —
+     *  use {@link RunOptions.userCredentials} for tokens. Per-call, not session
+     *  state: a continuation does not inherit it — re-send on continue(). */
+    metadata?: Record<string, unknown>;
+    /** Optional ad-hoc per-run wall-clock budget (seconds) for a CODE-JS agent,
+     *  overriding the agent's `run_timeout_seconds` and the sidecar's global
+     *  default (precedence: per-run > per-agent > global). Use it for a fan-out
+     *  orchestrator that blocks in Agent.parallel_spawn awaiting LLM children —
+     *  its budget spans that wait, so the CPU-oriented default is often too low.
+     *  Ignored by LLM agents. 0 / omitted = inherit. */
+    runTimeoutSeconds?: number;
     /** Opt-in observability: when true, the iterator emits client-
      *  synthesized `{ type: "_meta", meta_subtype: "stream_open" | "stream_close" }`
      *  events around the real event stream. `meta_reason` carries the
@@ -206,6 +221,14 @@ export interface ContinueOptions {
      *  {@link RunOptions.parentContext} — same shape; a continuation may
      *  (re)set the lineage for the new run it creates. */
     parentContext?: ParentContext;
+    /** Optional NON-SECRET structured metadata for the new run — see
+     *  {@link RunOptions.metadata}. Same shape + trust posture. NOT inherited
+     *  from the original run (metadata is a per-call input, not session state):
+     *  re-send it on the continuation to carry it forward. */
+    metadata?: Record<string, unknown>;
+    /** Optional ad-hoc per-run code-js wall-clock budget (seconds) for the
+     *  continuation's new run — see {@link RunOptions.runTimeoutSeconds}. */
+    runTimeoutSeconds?: number;
     /** Opt-in observability: see {@link RunOptions.debug}. Same shape. */
     debug?: boolean;
     signal?: AbortSignal;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loomcycle/client",
-  "version": "0.20.0",
-  "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 51 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.",
+  "version": "0.22.0",
+  "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 51 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).",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {