@loomcycle/client 0.10.2 → 0.10.4

package/dist/cjs/client.js

@@ -422,6 +422,47 @@ class LoomcycleClient {
     async mcpServerDef(input, opts) {
         return (0, fetch_helpers_js_1.postJSON)(this.ctx, "/v1/_mcpserverdef", 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
+     *  `source: "static-only" | "dynamic-only" | "both"` so callers can
+     *  badge / filter by origin. Static-source entries inline the
+     *  yaml-side definition body in `static_definition`; dynamic-only
+     *  entries omit it (fetch the active version's body via
+     *  `agentDef({op: "get", name})` when needed).
+     *
+     *  Wraps the v0.9.3 endpoint `GET /v1/_library/agents`. Bearer-authed.
+     *  Deterministic alphabetical sort by name.
+     *
+     *  Typical use: populate an integration's "which agent to dispatch?"
+     *  dropdown (n8n, Slack slash commands, custom workflow editors).
+     *
+     *  Raises {@link AuthError} on 401; {@link UnavailableError} on 503
+     *  (store unwired in test configurations). */
+    async listLibraryAgents(opts) {
+        return (0, fetch_helpers_js_1.jsonFetch)(this.ctx, "/v1/_library/agents", opts);
+    }
+    /** List every skill the runtime knows about — bundled skills (Approach
+     *  A) + filesystem overlay + dynamic SkillDefs merged into one
+     *  envelope per name. See {@link LoomcycleClient.listLibraryAgents}
+     *  for the source-tagging contract; the only difference is the
+     *  `static_definition` shape ({@link LibrarySkillDefinition}).
+     *
+     *  Wraps `GET /v1/_library/skills` (v0.9.3). */
+    async listLibrarySkills(opts) {
+        return (0, fetch_helpers_js_1.jsonFetch)(this.ctx, "/v1/_library/skills", opts);
+    }
+    /** List every MCP server the runtime knows about — yaml-declared
+     *  servers + dynamic MCPServerDef registrations merged into one
+     *  envelope per name. Static entries additionally inline the cached
+     *  `discovered_tools` snapshot when the pool inspector is wired
+     *  AND the pool has finished init for that server (omitted otherwise
+     *  — re-check after the pool finishes).
+     *
+     *  Wraps `GET /v1/_library/mcp-servers` (v0.9.3). */
+    async listLibraryMcpServers(opts) {
+        return (0, fetch_helpers_js_1.jsonFetch)(this.ctx, "/v1/_library/mcp-servers", opts);
+    }
     // ---- Internal helpers ----
     /** Shared SSE POST → stream-of-AgentEvent path. Used by
      *  runStreaming + continueSession.

package/dist/cjs/index.js

@@ -47,6 +47,11 @@
  *     agentDef(input): Promise<SubstrateToolResponse>
  *     skillDef(input): Promise<SubstrateToolResponse>
  *
+ *     // Library v2 enumeration (v0.10.3 — yaml+substrate merged)
+ *     listLibraryAgents(): Promise<LibraryListResponse<LibraryAgentDefinition>>
+ *     listLibrarySkills(): Promise<LibraryListResponse<LibrarySkillDefinition>>
+ *     listLibraryMcpServers(): Promise<LibraryListResponse<LibraryMcpServerDefinition>>
+ *
  *   Errors (typed subclasses of LoomcycleError; see README for the
  *   full HTTP-status → typed-error mapping table):
  *     LoomcycleError, AgentNotFoundError, SessionNotFoundError,

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, ListUsersResponse, 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, ChannelPeekResult, ChannelPublishResult, ChannelSubscribeResult, ListChannelsResponse, PeekChannelOptions, PublishChannelOptions, SubscribeChannelOptions, LibraryAgentDefinition, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, ListUsersResponse, 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,46 @@ export declare class LoomcycleClient {
     mcpServerDef(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
+     *  badge / filter by origin. Static-source entries inline the
+     *  yaml-side definition body in `static_definition`; dynamic-only
+     *  entries omit it (fetch the active version's body via
+     *  `agentDef({op: "get", name})` when needed).
+     *
+     *  Wraps the v0.9.3 endpoint `GET /v1/_library/agents`. Bearer-authed.
+     *  Deterministic alphabetical sort by name.
+     *
+     *  Typical use: populate an integration's "which agent to dispatch?"
+     *  dropdown (n8n, Slack slash commands, custom workflow editors).
+     *
+     *  Raises {@link AuthError} on 401; {@link UnavailableError} on 503
+     *  (store unwired in test configurations). */
+    listLibraryAgents(opts?: {
+        signal?: AbortSignal;
+    }): Promise<LibraryListResponse<LibraryAgentDefinition>>;
+    /** List every skill the runtime knows about — bundled skills (Approach
+     *  A) + filesystem overlay + dynamic SkillDefs merged into one
+     *  envelope per name. See {@link LoomcycleClient.listLibraryAgents}
+     *  for the source-tagging contract; the only difference is the
+     *  `static_definition` shape ({@link LibrarySkillDefinition}).
+     *
+     *  Wraps `GET /v1/_library/skills` (v0.9.3). */
+    listLibrarySkills(opts?: {
+        signal?: AbortSignal;
+    }): Promise<LibraryListResponse<LibrarySkillDefinition>>;
+    /** List every MCP server the runtime knows about — yaml-declared
+     *  servers + dynamic MCPServerDef registrations merged into one
+     *  envelope per name. Static entries additionally inline the cached
+     *  `discovered_tools` snapshot when the pool inspector is wired
+     *  AND the pool has finished init for that server (omitted otherwise
+     *  — re-check after the pool finishes).
+     *
+     *  Wraps `GET /v1/_library/mcp-servers` (v0.9.3). */
+    listLibraryMcpServers(opts?: {
+        signal?: AbortSignal;
+    }): Promise<LibraryListResponse<LibraryMcpServerDefinition>>;
     /** Shared SSE POST → stream-of-AgentEvent path. Used by
      *  runStreaming + continueSession.
      *

package/dist/client.js

@@ -419,6 +419,47 @@ export class LoomcycleClient {
     async mcpServerDef(input, opts) {
         return postJSON(this.ctx, "/v1/_mcpserverdef", 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
+     *  `source: "static-only" | "dynamic-only" | "both"` so callers can
+     *  badge / filter by origin. Static-source entries inline the
+     *  yaml-side definition body in `static_definition`; dynamic-only
+     *  entries omit it (fetch the active version's body via
+     *  `agentDef({op: "get", name})` when needed).
+     *
+     *  Wraps the v0.9.3 endpoint `GET /v1/_library/agents`. Bearer-authed.
+     *  Deterministic alphabetical sort by name.
+     *
+     *  Typical use: populate an integration's "which agent to dispatch?"
+     *  dropdown (n8n, Slack slash commands, custom workflow editors).
+     *
+     *  Raises {@link AuthError} on 401; {@link UnavailableError} on 503
+     *  (store unwired in test configurations). */
+    async listLibraryAgents(opts) {
+        return jsonFetch(this.ctx, "/v1/_library/agents", opts);
+    }
+    /** List every skill the runtime knows about — bundled skills (Approach
+     *  A) + filesystem overlay + dynamic SkillDefs merged into one
+     *  envelope per name. See {@link LoomcycleClient.listLibraryAgents}
+     *  for the source-tagging contract; the only difference is the
+     *  `static_definition` shape ({@link LibrarySkillDefinition}).
+     *
+     *  Wraps `GET /v1/_library/skills` (v0.9.3). */
+    async listLibrarySkills(opts) {
+        return jsonFetch(this.ctx, "/v1/_library/skills", opts);
+    }
+    /** List every MCP server the runtime knows about — yaml-declared
+     *  servers + dynamic MCPServerDef registrations merged into one
+     *  envelope per name. Static entries additionally inline the cached
+     *  `discovered_tools` snapshot when the pool inspector is wired
+     *  AND the pool has finished init for that server (omitted otherwise
+     *  — re-check after the pool finishes).
+     *
+     *  Wraps `GET /v1/_library/mcp-servers` (v0.9.3). */
+    async listLibraryMcpServers(opts) {
+        return jsonFetch(this.ctx, "/v1/_library/mcp-servers", opts);
+    }
     // ---- Internal helpers ----
     /** Shared SSE POST → stream-of-AgentEvent path. Used by
      *  runStreaming + continueSession.

package/dist/index.d.ts

@@ -46,6 +46,11 @@
  *     agentDef(input): Promise<SubstrateToolResponse>
  *     skillDef(input): Promise<SubstrateToolResponse>
  *
+ *     // Library v2 enumeration (v0.10.3 — yaml+substrate merged)
+ *     listLibraryAgents(): Promise<LibraryListResponse<LibraryAgentDefinition>>
+ *     listLibrarySkills(): Promise<LibraryListResponse<LibrarySkillDefinition>>
+ *     listLibraryMcpServers(): Promise<LibraryListResponse<LibraryMcpServerDefinition>>
+ *
  *   Errors (typed subclasses of LoomcycleError; see README for the
  *   full HTTP-status → typed-error mapping table):
  *     LoomcycleError, AgentNotFoundError, SessionNotFoundError,
@@ -64,5 +69,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, } 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, AgentDefRowResponse, AgentDefVerifyResult, SkillDefVerifyResult, MCPServerDefRowResponse, MCPServerDefVerifyResult, LibraryAgentDefinition, LibraryEntry, LibraryListResponse, LibraryMcpServerDefinition, LibrarySkillDefinition, } 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

@@ -46,6 +46,11 @@
  *     agentDef(input): Promise<SubstrateToolResponse>
  *     skillDef(input): Promise<SubstrateToolResponse>
  *
+ *     // Library v2 enumeration (v0.10.3 — yaml+substrate merged)
+ *     listLibraryAgents(): Promise<LibraryListResponse<LibraryAgentDefinition>>
+ *     listLibrarySkills(): Promise<LibraryListResponse<LibrarySkillDefinition>>
+ *     listLibraryMcpServers(): Promise<LibraryListResponse<LibraryMcpServerDefinition>>
+ *
  *   Errors (typed subclasses of LoomcycleError; see README for the
  *   full HTTP-status → typed-error mapping table):
  *     LoomcycleError, AgentNotFoundError, SessionNotFoundError,

package/dist/types.d.ts

@@ -811,3 +811,71 @@ export interface MCPServerDefVerifyResult {
     /** True if an active row exists for this name. */
     deployed: boolean;
 }
+/** Static-side agent definition body. Snake_case keys mirror
+ *  internal/lookup.SubstrateAgentDef so substrate-side and static-side
+ *  definitions share one renderer. Forward-compatible: unknown fields
+ *  on newer binaries flow through transparently. */
+export interface LibraryAgentDefinition {
+    provider?: string;
+    model?: string;
+    tier?: string;
+    effort?: string;
+    max_tokens?: number;
+    max_iterations?: number;
+    system_prompt?: string;
+    system_prompt_base?: string;
+    allowed_tools?: string[];
+    skills?: string[];
+    providers?: string[];
+    /** Per-tier candidate list. Server-side opaque shape — kept as
+     *  Record<string, unknown> for forward-compat. */
+    models?: Record<string, unknown>;
+    memory_scopes?: string[];
+    memory_quota_bytes?: number;
+}
+/** Static-side skill definition body. */
+export interface LibrarySkillDefinition {
+    body?: string;
+    description?: string;
+    allowed_tools?: string[];
+}
+/** Static-side MCP server definition body. Mirrors
+ *  internal/api/http.marshalStaticMCPServer (transport + url + headers
+ *  for http/streamable-http; command/args/env/pool_size for stdio;
+ *  allowed_tools narrowing; discovered_tools cached from the pool
+ *  inspector when ready). */
+export interface LibraryMcpServerDefinition {
+    transport?: "http" | "streamable-http" | "stdio";
+    url?: string;
+    headers?: Record<string, string>;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    pool_size?: number;
+    allowed_tools?: string[];
+    /** Substrate-mirror shape of the pool's PeekTools snapshot.
+     *  Omitted when the pool inspector returns nil (init pending or
+     *  failed) — re-check after pool init completes. */
+    discovered_tools?: unknown;
+}
+/** One row of the library envelope. T is the per-endpoint definition
+ *  type — LibraryAgentDefinition for /v1/_library/agents, etc. */
+export interface LibraryEntry<T = unknown> {
+    name: string;
+    source: "static-only" | "dynamic-only" | "both";
+    in_static: boolean;
+    in_substrate: boolean;
+    version_count: number;
+    active_def_id?: string;
+    latest_version?: number;
+    last_updated?: string;
+    /** Static-side definition body. Omitted when in_static is false
+     *  (dynamic-only entries have no static body — query the substrate
+     *  via AgentDef/SkillDef/MCPServerDef tools to fetch the active
+     *  version's payload). */
+    static_definition?: T;
+}
+/** Envelope returned by all three GET /v1/_library/* endpoints. */
+export interface LibraryListResponse<T = unknown> {
+    entries: LibraryEntry<T>[];
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loomcycle/client",
-  "version": "0.10.2",
-  "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 36 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 — with debug-mode synthetic open/close meta-frames + client-side parentAgentId filter), v0.9.x Channel CRUD (publishChannel + subscribeChannel + peekChannel + ackChannel — admin scope=global + per-user scope=user surfaces), v0.9.x content_sha256 (AgentDefVerifyResult + SkillDefVerifyResult types for the bundle-vs-deployed comparison workflow), v0.9.1 transcript first-cycle (SystemPromptPayload + UserInputPayload), and v0.9.x dynamic MCP server registration (mcpServerDef + MCPServerDefVerifyResult — register HTTP/Streamable-HTTP MCP servers at runtime without yaml edits). v0.10.1 — dual ESM + CommonJS distribution (additive — ESM consumers unchanged; CJS consumers like n8n's community-node loader now work).",
+  "version": "0.10.4",
+  "description": "TypeScript client for the loomcycle sidecar (HTTP+SSE). 39 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 — with debug-mode synthetic open/close meta-frames + client-side parentAgentId filter), v0.9.x Channel CRUD (publishChannel + subscribeChannel + peekChannel + ackChannel — admin scope=global + per-user scope=user surfaces), v0.9.x content_sha256 (AgentDefVerifyResult + SkillDefVerifyResult types for the bundle-vs-deployed comparison workflow), v0.9.1 transcript first-cycle (SystemPromptPayload + UserInputPayload), v0.9.x dynamic MCP server registration (mcpServerDef + MCPServerDefVerifyResult — register HTTP/Streamable-HTTP MCP servers at runtime without yaml edits), and v0.10.3 Library v2 enumeration (listLibraryAgents + listLibrarySkills + listLibraryMcpServers — typed wrappers around the v0.9.3 yaml+substrate merged endpoints for n8n + workflow-editor integrations). 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": {