@loomcycle/client 0.11.4 → 0.12.7

package/dist/cjs/client.js

@@ -89,6 +89,8 @@ class LoomcycleClient {
             body.user_tier = opts.userTier;
         if (opts.userBearer !== undefined)
             body.user_bearer = opts.userBearer;
+        if (opts.userCredentials !== undefined)
+            body.user_credentials = opts.userCredentials;
         yield* this.streamSSE("/v1/runs", body, opts.signal, opts.debug);
     }
     /**
@@ -125,6 +127,8 @@ class LoomcycleClient {
             body.user_tier = opts.userTier;
         if (opts.userBearer !== undefined)
             body.user_bearer = opts.userBearer;
+        if (opts.userCredentials !== undefined)
+            body.user_credentials = opts.userCredentials;
         yield* this.streamSSE(`/v1/sessions/${encodeURIComponent(opts.sessionId)}/messages`, body, opts.signal, opts.debug);
     }
     // ---- Agent metadata ----
@@ -422,6 +426,38 @@ class LoomcycleClient {
     async mcpServerDef(input, opts) {
         return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_mcpserverdef", input, opts);
     }
+    /** Invoke the v1.x RFC E ScheduleDef substrate tool over HTTP.
+     *  Author + fork + retire scheduled-run definitions at runtime.
+     *  Mirror of {@link LoomcycleClient.agentDef} for schedules — the
+     *  primary use case is JobEmber-style "fork a yaml template
+     *  per-user with their bearer + tier cron" workflows.
+     *
+     *  Operator-admin-only: this endpoint requires the bearer token.
+     *
+     *  Op-discriminated input: `{op: "create" | "fork" | "get" |
+     *  "list" | "retire", ...}`. Note that ScheduleDef has 5 ops
+     *  (no separate `promote` — forks auto-promote by default per
+     *  RFC E's worked example; no `verify` — no content_sha256 in
+     *  v1.x).
+     *
+     *  Sharp edges (substrate refuses these):
+     *  - Name colliding with a static cfg.ScheduledRuns entry is
+     *    refused on `create` (yaml is ground truth; use `fork` to
+     *    derive a new version).
+     *  - Fork against a template with `required_credentials` must
+     *    supply all keys in `user_credentials` — loud-fail at fork
+     *    time rather than silent ingestion-time failure when the
+     *    sweeper fires.
+     *  - Cron syntax is validated server-side; invalid expressions
+     *    refuse with a parse error.
+     *
+     *  Raises {@link SubstrateToolRefusedError} on tool-level refusals
+     *  (static-name collision, missing required credential, invalid
+     *  cron, etc.); {@link InvalidArgumentError} on 400 (malformed
+     *  JSON); {@link AuthError} on 401. */
+    async scheduleDef(input, opts) {
+        return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_scheduledef", input, opts);
+    }
     // ---- v0.10.3 Library v2 enumeration (read-only, merged yaml+substrate) ----
     /** List every agent the runtime knows about — yaml-static + dynamic
      *  AgentDefs merged into one envelope per name. Each entry carries
@@ -707,6 +743,78 @@ class LoomcycleClient {
         const path = channelOpPath(channel, opts.scope, opts.userId, "ack");
         return (0, fetch_helpers_js_1.postJSON)(this.ctx, path, { cursor: opts.cursor }, { signal: opts.signal });
     }
+    // ---- v0.11.5 Channel admin CRUD ----
+    //
+    // Three bearer-authed ops that mutate the runtime-substrate
+    // channel registry. yaml-declared channels are immutable from
+    // this surface — the server refuses with HTTP 409 + wire `code`
+    // `channel_yaml_immutable`. The TS adapter surfaces that as a
+    // {@link LoomcycleError} with status 409.
+    /** Create a new runtime-substrate channel. Refuses with HTTP 409
+     *  when the name matches a yaml-declared channel (code
+     *  `channel_yaml_immutable`) or an existing runtime channel
+     *  (code `channel_name_in_use`). */
+    async createChannel(opts) {
+        const body = { name: opts.name };
+        if (opts.description !== undefined)
+            body.description = opts.description;
+        if (opts.scope !== undefined)
+            body.scope = opts.scope;
+        if (opts.semantic !== undefined)
+            body.semantic = opts.semantic;
+        if (opts.default_ttl !== undefined)
+            body.default_ttl = opts.default_ttl;
+        if (opts.max_messages !== undefined)
+            body.max_messages = opts.max_messages;
+        if (opts.publisher !== undefined)
+            body.publisher = opts.publisher;
+        if (opts.period !== undefined)
+            body.period = opts.period;
+        return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_channels", body, {
+            signal: opts.signal,
+        });
+    }
+    /** Partially update a runtime-substrate channel. Nil-valued fields
+     *  in `opts` leave the corresponding attribute unchanged. Refuses
+     *  yaml-declared channels with HTTP 409. */
+    async updateChannel(name, opts) {
+        const body = {};
+        if (opts.description !== undefined)
+            body.description = opts.description;
+        if (opts.default_ttl !== undefined)
+            body.default_ttl = opts.default_ttl;
+        if (opts.max_messages !== undefined)
+            body.max_messages = opts.max_messages;
+        if (opts.semantic !== undefined)
+            body.semantic = opts.semantic;
+        return (0, fetch_helpers_js_1.patchJSON)(this.ctx, `/v1/_channels/${encodeURIComponent(name)}`, body, { signal: opts.signal });
+    }
+    /** Delete a runtime-substrate channel + cascade its persisted
+     *  messages + cursors. yaml-declared channels refuse with HTTP 409.
+     *  Idempotent: deleting a non-existent runtime channel returns a
+     *  {@link NotFoundError} so the caller can distinguish that case. */
+    async deleteChannel(name, opts) {
+        return (0, fetch_helpers_js_1.deleteRequest)(this.ctx, `/v1/_channels/${encodeURIComponent(name)}`, opts);
+    }
+    // ---- v0.11.5 Memory entry admin CRUD ----
+    /** Idempotently upsert one memory entry by full (scope, scope_id,
+     *  key) identifier. PUT semantics — re-writes overwrite the value.
+     *  Optional embed flag triggers a synchronous embed via the
+     *  operator-configured embedder. */
+    async setMemoryEntry(scope, scopeID, key, opts) {
+        const body = { value: opts.value };
+        if (opts.embed !== undefined)
+            body.embed = opts.embed;
+        if (opts.ttl_seconds !== undefined)
+            body.ttl_seconds = opts.ttl_seconds;
+        return (0, fetch_helpers_js_1.putJSON)(this.ctx, `/v1/_memory/scopes/${encodeURIComponent(scope)}/${encodeURIComponent(scopeID)}/keys/${encodeURIComponent(key)}`, body, { signal: opts.signal });
+    }
+    /** Delete one memory entry by (scope, scope_id, key). Idempotent:
+     *  deleting a missing row is a non-error per the in-band Memory
+     *  tool's semantics — both surfaces return 204. */
+    async deleteMemoryEntry(scope, scopeID, key, opts) {
+        return (0, fetch_helpers_js_1.deleteRequest)(this.ctx, `/v1/_memory/scopes/${encodeURIComponent(scope)}/${encodeURIComponent(scopeID)}/keys/${encodeURIComponent(key)}`, opts);
+    }
     /** Subscribe to run state transitions for one user_id via SSE.
      *  Yields one `{ kind: "open", ... }` item first (confirms the
      *  connection is live), then one `{ kind: "event", ... }` per

package/dist/cjs/fetch-helpers.js

@@ -14,6 +14,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.authHeaders = authHeaders;
 exports.jsonFetch = jsonFetch;
 exports.postJSON = postJSON;
+exports.putJSON = putJSON;
+exports.patchJSON = patchJSON;
 exports.deleteRequest = deleteRequest;
 exports.raiseFromResponse = raiseFromResponse;
 const errors_js_1 = require("./errors.js");
@@ -65,6 +67,51 @@ async function postJSON(ctx, path, body, opts) {
         return null;
     return (await resp.json());
 }
+/** putJSON sends a JSON-encoded body via PUT and unwraps the
+ *  response. Idempotent — REST-canonical verb for "create or
+ *  overwrite by full identifier." */
+async function putJSON(ctx, path, body, opts) {
+    const headers = authHeaders(ctx);
+    let bodyStr;
+    if (body !== undefined) {
+        headers["Content-Type"] = "application/json";
+        bodyStr = JSON.stringify(body);
+    }
+    const resp = await ctx.fetchImpl(ctx.baseUrl + path, {
+        method: "PUT",
+        headers,
+        body: bodyStr,
+        signal: opts?.signal,
+    });
+    if (!resp.ok) {
+        await raiseFromResponse(resp);
+    }
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
+/** patchJSON sends a JSON-encoded body via PATCH and unwraps the
+ *  response. For partial-update endpoints. */
+async function patchJSON(ctx, path, body, opts) {
+    const headers = authHeaders(ctx);
+    let bodyStr;
+    if (body !== undefined) {
+        headers["Content-Type"] = "application/json";
+        bodyStr = JSON.stringify(body);
+    }
+    const resp = await ctx.fetchImpl(ctx.baseUrl + path, {
+        method: "PATCH",
+        headers,
+        body: bodyStr,
+        signal: opts?.signal,
+    });
+    if (!resp.ok) {
+        await raiseFromResponse(resp);
+    }
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
 /** deleteRequest sends a DELETE and tolerates 204/200/404-with-
  *  idempotent-semantics per the loomcycle wire contract. */
 async function deleteRequest(ctx, path, opts) {

package/dist/cjs/index.js

@@ -43,9 +43,11 @@
  *     listRunInterrupts(runId, opts?): Promise<InterruptListResponse>
  *     resolveInterrupt(runId, interruptId, opts): Promise<unknown>
  *
- *     // Substrate admin (v0.8.22)
+ *     // Substrate admin (v0.8.22; mcpServerDef v0.9.x; scheduleDef v1.x)
  *     agentDef(input): Promise<SubstrateToolResponse>
  *     skillDef(input): Promise<SubstrateToolResponse>
+ *     mcpServerDef(input): Promise<SubstrateToolResponse>
+ *     scheduleDef(input): Promise<SubstrateToolResponse>
  *
  *     // Library v2 enumeration (v0.10.3 — yaml+substrate merged)
  *     listLibraryAgents(): Promise<LibraryListResponse<LibraryAgentDefinition>>

package/dist/client.d.ts

@@ -23,7 +23,7 @@
  * via fetch-helpers.ts:raiseFromResponse — see README.md for the
  * full mapping table.
  */
-import type { Agent, AgentEvent, AgentStatus, CancelAgentResult, ClientOptions, ContinueOptions, CreateSnapshotOptions, HealthResponse, Hook, InterruptListResponse, InterruptStatus, AckChannelOptions, ChannelAckResult, ChannelPeekResult, ChannelPublishResult, ChannelSubscribeResult, ListChannelsResponse, PeekChannelOptions, PublishChannelOptions, SubscribeChannelOptions, LibraryAgentDefinition, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, ListUsersResponse, LLMChatOptions, LLMChatResponse, LLMChatStreamItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, MemoryEntriesResponse, MemoryEntryResponse, MemoryScopeIDsResponse, MemoryScopesResponse, PauseResult, RegisterHookOptions, RegisterHookResponse, ResolveInterruptOptions, ResumeResult, RunOptions, RunStateStreamItem, RuntimeStateResponse, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotRestoreResponse, StreamUserRunStatesOptions, SubstrateToolInput, SubstrateToolResponse, TranscriptResponse } from "./types.js";
+import type { Agent, AgentEvent, AgentStatus, CancelAgentResult, ClientOptions, ContinueOptions, CreateSnapshotOptions, HealthResponse, Hook, InterruptListResponse, InterruptStatus, AckChannelOptions, ChannelAckResult, ChannelDescriptor, ChannelPeekResult, ChannelPublishResult, ChannelSubscribeResult, CreateChannelOptions, ListChannelsResponse, PeekChannelOptions, PublishChannelOptions, SetMemoryEntryOptions, SetMemoryEntryResponse, SubscribeChannelOptions, UpdateChannelOptions, LibraryAgentDefinition, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, ListUsersResponse, LLMChatOptions, LLMChatResponse, LLMChatStreamItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, MemoryEntriesResponse, MemoryEntryResponse, MemoryScopeIDsResponse, MemoryScopesResponse, PauseResult, RegisterHookOptions, RegisterHookResponse, ResolveInterruptOptions, ResumeResult, RunOptions, RunStateStreamItem, RuntimeStateResponse, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotRestoreResponse, StreamUserRunStatesOptions, SubstrateToolInput, SubstrateToolResponse, TranscriptResponse } from "./types.js";
 export declare class LoomcycleClient {
     private ctx;
     constructor(opts?: ClientOptions);
@@ -289,6 +289,38 @@ export declare class LoomcycleClient {
     mcpServerDef(input: SubstrateToolInput, opts?: {
         signal?: AbortSignal;
     }): Promise<SubstrateToolResponse>;
+    /** Invoke the v1.x RFC E ScheduleDef substrate tool over HTTP.
+     *  Author + fork + retire scheduled-run definitions at runtime.
+     *  Mirror of {@link LoomcycleClient.agentDef} for schedules — the
+     *  primary use case is JobEmber-style "fork a yaml template
+     *  per-user with their bearer + tier cron" workflows.
+     *
+     *  Operator-admin-only: this endpoint requires the bearer token.
+     *
+     *  Op-discriminated input: `{op: "create" | "fork" | "get" |
+     *  "list" | "retire", ...}`. Note that ScheduleDef has 5 ops
+     *  (no separate `promote` — forks auto-promote by default per
+     *  RFC E's worked example; no `verify` — no content_sha256 in
+     *  v1.x).
+     *
+     *  Sharp edges (substrate refuses these):
+     *  - Name colliding with a static cfg.ScheduledRuns entry is
+     *    refused on `create` (yaml is ground truth; use `fork` to
+     *    derive a new version).
+     *  - Fork against a template with `required_credentials` must
+     *    supply all keys in `user_credentials` — loud-fail at fork
+     *    time rather than silent ingestion-time failure when the
+     *    sweeper fires.
+     *  - Cron syntax is validated server-side; invalid expressions
+     *    refuse with a parse error.
+     *
+     *  Raises {@link SubstrateToolRefusedError} on tool-level refusals
+     *  (static-name collision, missing required credential, invalid
+     *  cron, etc.); {@link InvalidArgumentError} on 400 (malformed
+     *  JSON); {@link AuthError} on 401. */
+    scheduleDef(input: SubstrateToolInput, opts?: {
+        signal?: AbortSignal;
+    }): Promise<SubstrateToolResponse>;
     /** List every agent the runtime knows about — yaml-static + dynamic
      *  AgentDefs merged into one envelope per name. Each entry carries
      *  `source: "static-only" | "dynamic-only" | "both"` so callers can
@@ -425,6 +457,33 @@ export declare class LoomcycleClient {
      *  raise a {@link ConflictError} (HTTP 409, code
      *  `channel_cursor_regression`). */
     ackChannel(channel: string, opts: AckChannelOptions): Promise<ChannelAckResult>;
+    /** Create a new runtime-substrate channel. Refuses with HTTP 409
+     *  when the name matches a yaml-declared channel (code
+     *  `channel_yaml_immutable`) or an existing runtime channel
+     *  (code `channel_name_in_use`). */
+    createChannel(opts: CreateChannelOptions): Promise<ChannelDescriptor>;
+    /** Partially update a runtime-substrate channel. Nil-valued fields
+     *  in `opts` leave the corresponding attribute unchanged. Refuses
+     *  yaml-declared channels with HTTP 409. */
+    updateChannel(name: string, opts: UpdateChannelOptions): Promise<ChannelDescriptor>;
+    /** Delete a runtime-substrate channel + cascade its persisted
+     *  messages + cursors. yaml-declared channels refuse with HTTP 409.
+     *  Idempotent: deleting a non-existent runtime channel returns a
+     *  {@link NotFoundError} so the caller can distinguish that case. */
+    deleteChannel(name: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** Idempotently upsert one memory entry by full (scope, scope_id,
+     *  key) identifier. PUT semantics — re-writes overwrite the value.
+     *  Optional embed flag triggers a synchronous embed via the
+     *  operator-configured embedder. */
+    setMemoryEntry(scope: string, scopeID: string, key: string, opts: SetMemoryEntryOptions): Promise<SetMemoryEntryResponse>;
+    /** Delete one memory entry by (scope, scope_id, key). Idempotent:
+     *  deleting a missing row is a non-error per the in-band Memory
+     *  tool's semantics — both surfaces return 204. */
+    deleteMemoryEntry(scope: string, scopeID: string, key: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
     /** Subscribe to run state transitions for one user_id via SSE.
      *  Yields one `{ kind: "open", ... }` item first (confirms the
      *  connection is live), then one `{ kind: "event", ... }` per

package/dist/client.js

@@ -23,7 +23,7 @@
  * via fetch-helpers.ts:raiseFromResponse — see README.md for the
  * full mapping table.
  */
-import { authHeaders, deleteRequest, jsonFetch, postJSON, raiseFromResponse, } from "./fetch-helpers.js";
+import { authHeaders, deleteRequest, jsonFetch, patchJSON, postJSON, putJSON, raiseFromResponse, } from "./fetch-helpers.js";
 import { parseSSE } from "./stream.js";
 export class LoomcycleClient {
     ctx;
@@ -86,6 +86,8 @@ export class LoomcycleClient {
             body.user_tier = opts.userTier;
         if (opts.userBearer !== undefined)
             body.user_bearer = opts.userBearer;
+        if (opts.userCredentials !== undefined)
+            body.user_credentials = opts.userCredentials;
         yield* this.streamSSE("/v1/runs", body, opts.signal, opts.debug);
     }
     /**
@@ -122,6 +124,8 @@ export class LoomcycleClient {
             body.user_tier = opts.userTier;
         if (opts.userBearer !== undefined)
             body.user_bearer = opts.userBearer;
+        if (opts.userCredentials !== undefined)
+            body.user_credentials = opts.userCredentials;
         yield* this.streamSSE(`/v1/sessions/${encodeURIComponent(opts.sessionId)}/messages`, body, opts.signal, opts.debug);
     }
     // ---- Agent metadata ----
@@ -419,6 +423,38 @@ export class LoomcycleClient {
     async mcpServerDef(input, opts) {
         return postJSON(this.ctx, "/v1/_mcpserverdef", input, opts);
     }
+    /** Invoke the v1.x RFC E ScheduleDef substrate tool over HTTP.
+     *  Author + fork + retire scheduled-run definitions at runtime.
+     *  Mirror of {@link LoomcycleClient.agentDef} for schedules — the
+     *  primary use case is JobEmber-style "fork a yaml template
+     *  per-user with their bearer + tier cron" workflows.
+     *
+     *  Operator-admin-only: this endpoint requires the bearer token.
+     *
+     *  Op-discriminated input: `{op: "create" | "fork" | "get" |
+     *  "list" | "retire", ...}`. Note that ScheduleDef has 5 ops
+     *  (no separate `promote` — forks auto-promote by default per
+     *  RFC E's worked example; no `verify` — no content_sha256 in
+     *  v1.x).
+     *
+     *  Sharp edges (substrate refuses these):
+     *  - Name colliding with a static cfg.ScheduledRuns entry is
+     *    refused on `create` (yaml is ground truth; use `fork` to
+     *    derive a new version).
+     *  - Fork against a template with `required_credentials` must
+     *    supply all keys in `user_credentials` — loud-fail at fork
+     *    time rather than silent ingestion-time failure when the
+     *    sweeper fires.
+     *  - Cron syntax is validated server-side; invalid expressions
+     *    refuse with a parse error.
+     *
+     *  Raises {@link SubstrateToolRefusedError} on tool-level refusals
+     *  (static-name collision, missing required credential, invalid
+     *  cron, etc.); {@link InvalidArgumentError} on 400 (malformed
+     *  JSON); {@link AuthError} on 401. */
+    async scheduleDef(input, opts) {
+        return postJSON(this.ctx, "/v1/_scheduledef", input, opts);
+    }
     // ---- v0.10.3 Library v2 enumeration (read-only, merged yaml+substrate) ----
     /** List every agent the runtime knows about — yaml-static + dynamic
      *  AgentDefs merged into one envelope per name. Each entry carries
@@ -704,6 +740,78 @@ export class LoomcycleClient {
         const path = channelOpPath(channel, opts.scope, opts.userId, "ack");
         return postJSON(this.ctx, path, { cursor: opts.cursor }, { signal: opts.signal });
     }
+    // ---- v0.11.5 Channel admin CRUD ----
+    //
+    // Three bearer-authed ops that mutate the runtime-substrate
+    // channel registry. yaml-declared channels are immutable from
+    // this surface — the server refuses with HTTP 409 + wire `code`
+    // `channel_yaml_immutable`. The TS adapter surfaces that as a
+    // {@link LoomcycleError} with status 409.
+    /** Create a new runtime-substrate channel. Refuses with HTTP 409
+     *  when the name matches a yaml-declared channel (code
+     *  `channel_yaml_immutable`) or an existing runtime channel
+     *  (code `channel_name_in_use`). */
+    async createChannel(opts) {
+        const body = { name: opts.name };
+        if (opts.description !== undefined)
+            body.description = opts.description;
+        if (opts.scope !== undefined)
+            body.scope = opts.scope;
+        if (opts.semantic !== undefined)
+            body.semantic = opts.semantic;
+        if (opts.default_ttl !== undefined)
+            body.default_ttl = opts.default_ttl;
+        if (opts.max_messages !== undefined)
+            body.max_messages = opts.max_messages;
+        if (opts.publisher !== undefined)
+            body.publisher = opts.publisher;
+        if (opts.period !== undefined)
+            body.period = opts.period;
+        return postJSON(this.ctx, "/v1/_channels", body, {
+            signal: opts.signal,
+        });
+    }
+    /** Partially update a runtime-substrate channel. Nil-valued fields
+     *  in `opts` leave the corresponding attribute unchanged. Refuses
+     *  yaml-declared channels with HTTP 409. */
+    async updateChannel(name, opts) {
+        const body = {};
+        if (opts.description !== undefined)
+            body.description = opts.description;
+        if (opts.default_ttl !== undefined)
+            body.default_ttl = opts.default_ttl;
+        if (opts.max_messages !== undefined)
+            body.max_messages = opts.max_messages;
+        if (opts.semantic !== undefined)
+            body.semantic = opts.semantic;
+        return patchJSON(this.ctx, `/v1/_channels/${encodeURIComponent(name)}`, body, { signal: opts.signal });
+    }
+    /** Delete a runtime-substrate channel + cascade its persisted
+     *  messages + cursors. yaml-declared channels refuse with HTTP 409.
+     *  Idempotent: deleting a non-existent runtime channel returns a
+     *  {@link NotFoundError} so the caller can distinguish that case. */
+    async deleteChannel(name, opts) {
+        return deleteRequest(this.ctx, `/v1/_channels/${encodeURIComponent(name)}`, opts);
+    }
+    // ---- v0.11.5 Memory entry admin CRUD ----
+    /** Idempotently upsert one memory entry by full (scope, scope_id,
+     *  key) identifier. PUT semantics — re-writes overwrite the value.
+     *  Optional embed flag triggers a synchronous embed via the
+     *  operator-configured embedder. */
+    async setMemoryEntry(scope, scopeID, key, opts) {
+        const body = { value: opts.value };
+        if (opts.embed !== undefined)
+            body.embed = opts.embed;
+        if (opts.ttl_seconds !== undefined)
+            body.ttl_seconds = opts.ttl_seconds;
+        return putJSON(this.ctx, `/v1/_memory/scopes/${encodeURIComponent(scope)}/${encodeURIComponent(scopeID)}/keys/${encodeURIComponent(key)}`, body, { signal: opts.signal });
+    }
+    /** Delete one memory entry by (scope, scope_id, key). Idempotent:
+     *  deleting a missing row is a non-error per the in-band Memory
+     *  tool's semantics — both surfaces return 204. */
+    async deleteMemoryEntry(scope, scopeID, key, opts) {
+        return deleteRequest(this.ctx, `/v1/_memory/scopes/${encodeURIComponent(scope)}/${encodeURIComponent(scopeID)}/keys/${encodeURIComponent(key)}`, opts);
+    }
     /** Subscribe to run state transitions for one user_id via SSE.
      *  Yields one `{ kind: "open", ... }` item first (confirms the
      *  connection is live), then one `{ kind: "event", ... }` per

package/dist/fetch-helpers.d.ts

@@ -43,6 +43,17 @@ export declare function jsonFetch<T>(ctx: _FetchContext, path: string, opts?: {
 export declare function postJSON<T>(ctx: _FetchContext, path: string, body?: unknown, opts?: {
     signal?: AbortSignal;
 }): Promise<T>;
+/** putJSON sends a JSON-encoded body via PUT and unwraps the
+ *  response. Idempotent — REST-canonical verb for "create or
+ *  overwrite by full identifier." */
+export declare function putJSON<T>(ctx: _FetchContext, path: string, body?: unknown, opts?: {
+    signal?: AbortSignal;
+}): Promise<T>;
+/** patchJSON sends a JSON-encoded body via PATCH and unwraps the
+ *  response. For partial-update endpoints. */
+export declare function patchJSON<T>(ctx: _FetchContext, path: string, body?: unknown, opts?: {
+    signal?: AbortSignal;
+}): Promise<T>;
 /** deleteRequest sends a DELETE and tolerates 204/200/404-with-
  *  idempotent-semantics per the loomcycle wire contract. */
 export declare function deleteRequest(ctx: _FetchContext, path: string, opts?: {

package/dist/fetch-helpers.js

@@ -58,6 +58,51 @@ export async function postJSON(ctx, path, body, opts) {
         return null;
     return (await resp.json());
 }
+/** putJSON sends a JSON-encoded body via PUT and unwraps the
+ *  response. Idempotent — REST-canonical verb for "create or
+ *  overwrite by full identifier." */
+export async function putJSON(ctx, path, body, opts) {
+    const headers = authHeaders(ctx);
+    let bodyStr;
+    if (body !== undefined) {
+        headers["Content-Type"] = "application/json";
+        bodyStr = JSON.stringify(body);
+    }
+    const resp = await ctx.fetchImpl(ctx.baseUrl + path, {
+        method: "PUT",
+        headers,
+        body: bodyStr,
+        signal: opts?.signal,
+    });
+    if (!resp.ok) {
+        await raiseFromResponse(resp);
+    }
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
+/** patchJSON sends a JSON-encoded body via PATCH and unwraps the
+ *  response. For partial-update endpoints. */
+export async function patchJSON(ctx, path, body, opts) {
+    const headers = authHeaders(ctx);
+    let bodyStr;
+    if (body !== undefined) {
+        headers["Content-Type"] = "application/json";
+        bodyStr = JSON.stringify(body);
+    }
+    const resp = await ctx.fetchImpl(ctx.baseUrl + path, {
+        method: "PATCH",
+        headers,
+        body: bodyStr,
+        signal: opts?.signal,
+    });
+    if (!resp.ok) {
+        await raiseFromResponse(resp);
+    }
+    if (resp.status === 204)
+        return null;
+    return (await resp.json());
+}
 /** deleteRequest sends a DELETE and tolerates 204/200/404-with-
  *  idempotent-semantics per the loomcycle wire contract. */
 export async function deleteRequest(ctx, path, opts) {

package/dist/index.d.ts

@@ -42,9 +42,11 @@
  *     listRunInterrupts(runId, opts?): Promise<InterruptListResponse>
  *     resolveInterrupt(runId, interruptId, opts): Promise<unknown>
  *
- *     // Substrate admin (v0.8.22)
+ *     // Substrate admin (v0.8.22; mcpServerDef v0.9.x; scheduleDef v1.x)
  *     agentDef(input): Promise<SubstrateToolResponse>
  *     skillDef(input): Promise<SubstrateToolResponse>
+ *     mcpServerDef(input): Promise<SubstrateToolResponse>
+ *     scheduleDef(input): Promise<SubstrateToolResponse>
  *
  *     // Library v2 enumeration (v0.10.3 — yaml+substrate merged)
  *     listLibraryAgents(): Promise<LibraryListResponse<LibraryAgentDefinition>>
@@ -76,5 +78,5 @@
  * See `adapters/ts/README.md` for usage examples.
  */
 export { LoomcycleClient } from "./client.js";
-export type { AgentEvent, ClientOptions, ContinueOptions, EventType, HostWidening, PromptContent, PromptSegment, RetryInfo, RunOptions, ToolUse, Usage, Agent, AgentStatus, AgentUsage, CancelAgentResult, ListAgentsResponse, TranscriptEvent, TranscriptResponse, HealthResponse, ListUsersResponse, UserSummary, PauseResult, ResumeResult, RuntimeStateResponse, RuntimeStateStatus, CreateSnapshotOptions, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotListResponse, SnapshotRestoreResponse, MemoryEntriesResponse, MemoryEntry, MemoryEntryResponse, MemoryScopeIDsResponse, MemoryScopeIDSummary, MemoryScopeKind, MemoryScopesResponse, InterruptListResponse, InterruptRow, InterruptStatus, ResolveInterruptOptions, Hook, HookFailMode, HookPhase, HookToolCall, HookToolResult, ListHooksResponse, PostHookCall, PostHookResult, PreHookCall, PreHookResult, RegisterHookOptions, RegisterHookResponse, SubstrateToolInput, SubstrateToolResponse, SystemPromptPayload, UserInputPayload, ChannelDescriptor, ListChannelsResponse, RunStateEvent, RunStateStreamClose, RunStateStreamItem, RunStateStreamOpen, StreamUserRunStatesOptions, AckChannelOptions, ChannelAckResult, ChannelMessageItem, ChannelPeekResult, ChannelPublishResult, ChannelScope, ChannelSubscribeResult, PeekChannelOptions, PublishChannelOptions, SubscribeChannelOptions, AgentDefRowResponse, AgentDefVerifyResult, SkillDefVerifyResult, MCPServerDefRowResponse, MCPServerDefVerifyResult, LibraryAgentDefinition, LibraryEntry, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, LLMChatContent, LLMChatMessage, LLMChatOptions, LLMChatResponse, LLMChatStreamDelta, LLMChatStreamItem, LLMChatToolCall, LLMChatUsage, LLMTool, LLMEmbeddingItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, LLMEmbeddingsUsage, } from "./types.js";
+export type { AgentEvent, ClientOptions, ContinueOptions, EventType, HostWidening, PromptContent, PromptSegment, RetryInfo, RunOptions, ToolUse, Usage, Agent, AgentStatus, AgentUsage, CancelAgentResult, ListAgentsResponse, TranscriptEvent, TranscriptResponse, HealthResponse, ListUsersResponse, UserSummary, PauseResult, ResumeResult, RuntimeStateResponse, RuntimeStateStatus, CreateSnapshotOptions, SnapshotCreateResponse, SnapshotDescriptor, SnapshotEnvelope, SnapshotListResponse, SnapshotRestoreResponse, MemoryEntriesResponse, MemoryEntry, MemoryEntryResponse, MemoryScopeIDsResponse, MemoryScopeIDSummary, MemoryScopeKind, MemoryScopesResponse, InterruptListResponse, InterruptRow, InterruptStatus, ResolveInterruptOptions, Hook, HookFailMode, HookPhase, HookToolCall, HookToolResult, ListHooksResponse, PostHookCall, PostHookResult, PreHookCall, PreHookResult, RegisterHookOptions, RegisterHookResponse, SubstrateToolInput, SubstrateToolResponse, SystemPromptPayload, UserInputPayload, ChannelDescriptor, ListChannelsResponse, RunStateEvent, RunStateStreamClose, RunStateStreamItem, RunStateStreamOpen, StreamUserRunStatesOptions, AckChannelOptions, ChannelAckResult, ChannelMessageItem, ChannelPeekResult, ChannelPublishResult, ChannelScope, ChannelSubscribeResult, PeekChannelOptions, PublishChannelOptions, SubscribeChannelOptions, CreateChannelOptions, UpdateChannelOptions, SetMemoryEntryOptions, SetMemoryEntryResponse, AgentDefRowResponse, AgentDefVerifyResult, SkillDefVerifyResult, MCPServerDefRowResponse, MCPServerDefVerifyResult, LibraryAgentDefinition, LibraryEntry, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, LLMChatContent, LLMChatMessage, LLMChatOptions, LLMChatResponse, LLMChatStreamDelta, LLMChatStreamItem, LLMChatToolCall, LLMChatUsage, LLMTool, LLMEmbeddingItem, LLMEmbeddingsOptions, LLMEmbeddingsResponse, LLMEmbeddingsUsage, } from "./types.js";
 export { AgentIDInUseError, AgentNotFoundError, AlreadyPausingError, AuthError, BackpressureError, HookNotFoundError, NotFoundError, InvalidArgumentError, ChannelCursorRegressionError, LoomcycleError, NotPausedError, PauseNotConfiguredError, PerUserQuotaExhaustedError, SessionBusyError, SessionNotFoundError, SnapshotNotFoundError, SnapshotTooLargeError, SnapshotVersionError, SubstrateToolRefusedError, UnavailableError, } from "./errors.js";

package/dist/index.js

@@ -42,9 +42,11 @@
  *     listRunInterrupts(runId, opts?): Promise<InterruptListResponse>
  *     resolveInterrupt(runId, interruptId, opts): Promise<unknown>
  *
- *     // Substrate admin (v0.8.22)
+ *     // Substrate admin (v0.8.22; mcpServerDef v0.9.x; scheduleDef v1.x)
  *     agentDef(input): Promise<SubstrateToolResponse>
  *     skillDef(input): Promise<SubstrateToolResponse>
+ *     mcpServerDef(input): Promise<SubstrateToolResponse>
+ *     scheduleDef(input): Promise<SubstrateToolResponse>
  *
  *     // Library v2 enumeration (v0.10.3 — yaml+substrate merged)
  *     listLibraryAgents(): Promise<LibraryListResponse<LibraryAgentDefinition>>

package/dist/types.d.ts

@@ -130,6 +130,15 @@ export interface RunOptions {
      *  (static-bearer setups unaffected). Sub-agents inherit identically.
      *  Never persisted; never logged in full. */
     userBearer?: string;
+    /** Per-tool named credentials map (v1.x RFC F). Per-MCP-server bearers
+     *  keyed by operator-chosen name (convention: the `mcp_servers.<name>`
+     *  yaml key). Substituted into MCP HTTP header values containing
+     *  `${run.credentials.<name>}` at outbound request-build time. Keys
+     *  match `[a-zA-Z0-9_-]{1,64}`; values arbitrary strings. Sub-agents
+     *  inherit the whole map. Coexists with `userBearer` — the legacy
+     *  field auto-promotes to `userCredentials.default` for back-compat
+     *  with v0.8.x flows. Never persisted; never logged. */
+    userCredentials?: Record<string, string>;
     /** 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
@@ -166,6 +175,10 @@ export interface ContinueOptions {
      *  so different continuations in the same session may carry
      *  different end-user tokens. */
     userBearer?: string;
+    /** Per-tool named credentials map (v1.x RFC F). See
+     *  {@link RunOptions.userCredentials} for the full shape — same
+     *  semantics, supplied per-continuation rather than per-fresh-run. */
+    userCredentials?: Record<string, string>;
     /** Opt-in observability: see {@link RunOptions.debug}. Same shape. */
     debug?: boolean;
     signal?: AbortSignal;
@@ -192,6 +205,7 @@ export interface AgentUsage {
     cache_creation_tokens?: number;
     cache_read_tokens?: number;
     model?: string;
+    provider?: string;
 }
 export interface Agent {
     agent_id: string;
@@ -555,6 +569,7 @@ export interface PostHookResult {
  *  {@link LoomcycleClient.listChannels}. */
 export interface ChannelDescriptor {
     name: string;
+    description?: string;
     scope?: string;
     semantic?: string;
     publisher?: string;
@@ -565,6 +580,10 @@ export interface ChannelDescriptor {
     /** RFC3339 — empty when count == 0. */
     oldest_visible_at?: string;
     newest_visible_at?: string;
+    /** v0.11.5: "yaml" (operator yaml — immutable from this surface),
+     *  "runtime" (substrate — CRUD-mutable), "orphan" (no declaration,
+     *  only orphan messages). */
+    source?: "yaml" | "runtime" | "orphan" | string;
 }
 /** Response shape for {@link LoomcycleClient.listChannels}. */
 export interface ListChannelsResponse {
@@ -656,6 +675,63 @@ export interface AckChannelOptions {
 export interface ChannelAckResult {
     ok: boolean;
 }
+/** Options for {@link LoomcycleClient.createChannel}. Operator-yaml
+ *  channels are immutable from this surface; the server returns
+ *  HTTP 409 `channel_yaml_immutable` when `name` matches a yaml-
+ *  declared channel. */
+export interface CreateChannelOptions {
+    name: string;
+    description?: string;
+    /** "global" | "agent" | "user". Defaults to "global" if omitted. */
+    scope?: string;
+    /** "queue" | "topic". Defaults to "queue" if omitted. */
+    semantic?: string;
+    /** Seconds; 0 = no TTL. */
+    default_ttl?: number;
+    /** 0 = unbounded. */
+    max_messages?: number;
+    /** Free-form attribution; not enforced by the substrate. */
+    publisher?: string;
+    /** Free-form retention hint; not enforced by the substrate. */
+    period?: string;
+    signal?: AbortSignal;
+}
+/** Options for {@link LoomcycleClient.updateChannel}. Nil fields
+ *  leave the corresponding channel attribute unchanged. */
+export interface UpdateChannelOptions {
+    description?: string;
+    default_ttl?: number;
+    max_messages?: number;
+    /** "queue" | "topic" */
+    semantic?: string;
+    signal?: AbortSignal;
+}
+/** Options for {@link LoomcycleClient.setMemoryEntry}. `value` is
+ *  opaque JSON. Setting `embed: true` triggers a synchronous embed
+ *  via the operator-configured embedder; the returned `embedded`
+ *  flag + optional `embed_warning` report whether the embedding
+ *  landed. */
+export interface SetMemoryEntryOptions {
+    value: unknown;
+    /** When true, also compute + store the embedding (requires
+     *  memory.embedder yaml + a vector-capable store backend). */
+    embed?: boolean;
+    /** Optional TTL in seconds; <= 0 means "no expiry". */
+    ttl_seconds?: number;
+    signal?: AbortSignal;
+}
+/** Response shape for {@link LoomcycleClient.setMemoryEntry}. */
+export interface SetMemoryEntryResponse {
+    scope: string;
+    scope_id: string;
+    key: string;
+    /** true when the embedding was computed AND stored. */
+    embedded: boolean;
+    /** Non-empty when embed was requested but failed (transient
+     *  error, embedder unconfigured, vector backend not available).
+     *  The k/v row still landed. */
+    embed_warning?: string;
+}
 /** One run state transition emitted by
  *  {@link LoomcycleClient.streamUserRunStates}. The TS field is RFC3339. */
 export interface RunStateEvent {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loomcycle/client",
-  "version": "0.11.4",
-  "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 41 methods covering run streaming, agent metadata, pause/resume/state, snapshot lifecycle, memory admin (incl. v0.9.0 Vector Memory embed_stats + reembed), 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.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).",
+  "version": "0.12.7",
+  "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 46 methods covering run streaming, agent metadata, pause/resume/state, 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).",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {