@getbourdon/client 0.2.3 → 0.3.0-rc.0

package/README.md

@@ -22,12 +22,15 @@ const peer = new BourdonL6Client({ transport: "http", url: "https://peer/mcp", t
 await peer.listAgents();
 ```
 
-All twelve L6 tools are exposed: `queryAgentMemory`, `listRecentWork`, `findEntity`,
+The client provides twelve typed tool wrappers: `queryAgentMemory`, `listRecentWork`, `findEntity`,
 `listWorkstreams`, `listNotes`,
 `listAgents`, `exportAgents`, `getCrossAgentSummary`, `prepareRecognitionContext`,
 `getDeeperContext`, `compileCodexTurn`, `commitToFederation`. The server applies its own
 per-tool `access_level` defaults (public for queries, team for recognition), so omitted
 args are dropped rather than defaulted client-side.
 
+For server tools without a typed wrapper, use `callTool(name, args)` with the server's
+tool name and argument object. For example, `callTool("list_memory_versions", { agent_id: "alpha-agent" })`.
+
 License: Apache-2.0 (interop client). The Bourdon engine is BUSL-1.1; the canonical
 implementation is the Python project.

package/dist/index.cjs

@@ -32,7 +32,7 @@ var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamable
 // package.json
 var package_default = {
   name: "@getbourdon/client",
-  version: "0.2.3",
+  version: "0.3.0-rc.0",
   description: "Bourdon L6 federation MCP client for TypeScript/Node \u2014 query a running Bourdon L6 server (stdio or Streamable HTTP) over @modelcontextprotocol/sdk. Python (pip install bourdon) is the oracle; this client is wire-compatible with its L6 server.",
   license: "Apache-2.0",
   type: "module",
@@ -52,7 +52,7 @@ var package_default = {
     "LICENSE"
   ],
   engines: {
-    node: ">=20"
+    node: ">=24.0.0"
   },
   publishConfig: {
     access: "public",
@@ -151,7 +151,7 @@ var BourdonL6Client = class {
     const result = await client.callTool({ name, arguments: args });
     return parseToolResult(result);
   }
-  // -- the twelve L6 tools (typed) ---------------------------------------------
+  // -- twelve typed L6 tool wrappers -------------------------------------------
   queryAgentMemory(args) {
     return this.callTool("query_agent_memory", argsToRecord(args));
   }

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/l6-client.ts","../package.json","../src/version.ts"],"sourcesContent":["export {\n  BourdonL6Client,\n  type AccessLevel,\n  type L6Config,\n  type L6StdioConfig,\n  type L6HttpConfig,\n  type L6CustomConfig,\n  type CommonToolArgs,\n  type QueryAgentMemoryArgs,\n  type ListRecentWorkArgs,\n  type FindEntityArgs,\n  type GetCrossAgentSummaryArgs,\n  type RecognitionArgs,\n  type CompileCodexTurnArgs,\n  type CommitToFederationArgs,\n  type L6ToolResult,\n} from \"./l6-client.js\";\n","/**\n * Bourdon L6 federation MCP client.\n *\n * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`\n * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies\n * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`\n * client so JSON-RPC framing is not re-implemented.\n *\n * Lifted and extended from the proven openclaw-bourdon-plugin client:\n *   - all twelve tools\n *   - Streamable HTTP transport (SSE is deprecated in the SDK)\n *   - results are JSON-parsed from the server's TextContent envelope\n *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,\n *     so a raw CallToolResult is unwrapped to the payload here)\n *   - an injectable transport (`{transport:'custom'}`) for in-memory testing\n *\n * Tool surface mirrored from bourdon/core/l6_server.py. The server applies\n * per-tool `access_level` defaults (public for queries, team for recognition),\n * so this client never hardcodes them — omitted args are dropped, not defaulted.\n */\n\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\nimport { PACKAGE_VERSION } from \"./version.js\";\n\n/** Federation visibility level. Mirrors the Python `Visibility` enum values. */\nexport type AccessLevel = \"public\" | \"team\" | \"private\";\n\nexport interface L6StdioConfig {\n  transport: \"stdio\";\n  /** Defaults to `python`. */\n  command?: string;\n  /** Defaults to `[\"-m\", \"bourdon.core.l6_server\"]`. */\n  args?: string[];\n  /** Optional library path forwarded to L6 via `--library`. */\n  library?: string;\n  /** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */\n  cwd?: string;\n  /** Optional environment passed to the subprocess. */\n  env?: Record<string, string>;\n}\n\nexport interface L6HttpConfig {\n  transport: \"http\";\n  url: string;\n  /** Bearer token sent as `Authorization: Bearer <token>` (federation peer auth). */\n  token?: string;\n}\n\n/** Inject a pre-built transport (used for in-memory testing). */\nexport interface L6CustomConfig {\n  transport: \"custom\";\n  instance: Transport;\n}\n\nexport type L6Config = L6StdioConfig | L6HttpConfig | L6CustomConfig;\n\nexport interface CommonToolArgs {\n  access_level?: AccessLevel;\n  include_private?: boolean;\n}\n\nexport interface QueryAgentMemoryArgs extends CommonToolArgs {\n  agent: string;\n  topic: string;\n}\n\nexport interface ListRecentWorkArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n  summary?: boolean;\n}\n\nexport interface FindEntityArgs extends CommonToolArgs {\n  name: string;\n}\n\nexport interface ListWorkstreamsArgs extends CommonToolArgs {\n  status?: \"active\" | \"paused\" | \"done\" | \"archived\";\n  agent?: string;\n}\n\nexport interface ListNotesArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface GetCrossAgentSummaryArgs extends CommonToolArgs {\n  project: string;\n}\n\nexport interface RecognitionArgs extends CommonToolArgs {\n  prompt: string;\n}\n\nexport interface CompileCodexTurnArgs {\n  prompt: string;\n  cwd?: string;\n  access_level?: AccessLevel;\n  max_items?: number;\n  max_chars?: number;\n}\n\nexport interface CommitToFederationArgs {\n  agent_id: string;\n  agent_type?: string;\n  instance?: string;\n  role_narrative?: string;\n  entities?: Record<string, unknown>[];\n  sessions?: Record<string, unknown>[];\n  workstreams?: Record<string, unknown>[];\n  notes?: Record<string, unknown>[];\n  /** `merge` (default) or `replace`. */\n  mode?: string;\n}\n\n/** The parsed payload returned by an L6 tool (server-defined JSON shape). */\nexport type L6ToolResult = unknown;\n\nexport class BourdonL6Client {\n  private client: Client | null = null;\n  private transport: Transport | null = null;\n  private connectPromise: Promise<void> | null = null;\n  private readonly config: L6Config;\n\n  constructor(config: L6Config) {\n    this.config = config;\n  }\n\n  /** Connect lazily on first call; subsequent calls reuse the live client. */\n  private async ensureConnected(): Promise<Client> {\n    if (this.client) return this.client;\n    if (this.connectPromise) {\n      await this.connectPromise;\n      if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n      return this.client;\n    }\n    this.connectPromise = this.connect();\n    try {\n      await this.connectPromise;\n    } finally {\n      this.connectPromise = null;\n    }\n    if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n    return this.client;\n  }\n\n  private async connect(): Promise<void> {\n    const transport = this.buildTransport(this.config);\n    const client = new Client(\n      { name: \"@getbourdon/client\", version: PACKAGE_VERSION },\n      { capabilities: {} },\n    );\n    await client.connect(transport);\n    this.client = client;\n    this.transport = transport;\n  }\n\n  private buildTransport(config: L6Config): Transport {\n    if (config.transport === \"custom\") return config.instance;\n    if (config.transport === \"stdio\") {\n      const args = [...(config.args ?? [\"-m\", \"bourdon.core.l6_server\"])];\n      if (config.library && !args.includes(\"--library\")) {\n        args.push(\"--library\", config.library);\n      }\n      return new StdioClientTransport({\n        command: config.command ?? \"python\",\n        args,\n        cwd: config.cwd,\n        env: config.env,\n      });\n    }\n    // Streamable HTTP (replaces deprecated SSE). Bearer auth via request headers.\n    const opts =\n      config.token === undefined\n        ? undefined\n        : { requestInit: { headers: { Authorization: `Bearer ${config.token}` } } };\n    return new StreamableHTTPClientTransport(new URL(config.url), opts);\n  }\n\n  /** Close the client and underlying transport. Idempotent. */\n  async close(): Promise<void> {\n    if (this.client) {\n      await this.client.close().catch(() => {\n        /* best-effort shutdown */\n      });\n      this.client = null;\n    }\n    if (this.transport) {\n      await this.transport.close?.().catch(() => {});\n      this.transport = null;\n    }\n  }\n\n  /**\n   * Generic call. Unwraps the server's TextContent JSON envelope to the payload.\n   * Prefer the typed methods below.\n   */\n  async callTool(name: string, args: Record<string, unknown> = {}): Promise<L6ToolResult> {\n    const client = await this.ensureConnected();\n    const result = await client.callTool({ name, arguments: args });\n    return parseToolResult(result);\n  }\n\n  // -- the twelve L6 tools (typed) ---------------------------------------------\n\n  queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"query_agent_memory\", argsToRecord(args));\n  }\n\n  listRecentWork(args: ListRecentWorkArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_recent_work\", argsToRecord(args));\n  }\n\n  findEntity(args: FindEntityArgs): Promise<L6ToolResult> {\n    return this.callTool(\"find_entity\", argsToRecord(args));\n  }\n\n  listWorkstreams(args: ListWorkstreamsArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_workstreams\", argsToRecord(args));\n  }\n\n  listNotes(args: ListNotesArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_notes\", argsToRecord(args));\n  }\n\n  listAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"list_agents\", {});\n  }\n\n  exportAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"export_agents\", {});\n  }\n\n  getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_cross_agent_summary\", argsToRecord(args));\n  }\n\n  prepareRecognitionContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"prepare_recognition_context\", argsToRecord(args));\n  }\n\n  getDeeperContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_deeper_context\", argsToRecord(args));\n  }\n\n  compileCodexTurn(args: CompileCodexTurnArgs): Promise<L6ToolResult> {\n    return this.callTool(\"compile_codex_turn\", argsToRecord(args));\n  }\n\n  commitToFederation(args: CommitToFederationArgs): Promise<L6ToolResult> {\n    return this.callTool(\"commit_to_federation\", argsToRecord(args));\n  }\n}\n\n/* -- internals ------------------------------------------------------------- */\n\n/**\n * Unwrap an MCP CallToolResult to the L6 payload. The L6 server JSON-stringifies\n * its payload into a single `text` content block (so cross-language peers parse\n * it with `json.loads(item.text)`); we mirror that on the read side. Falls back to\n * the raw text, then the raw result, if the envelope is unexpected.\n */\nfunction parseToolResult(result: unknown): L6ToolResult {\n  const content = (result as { content?: unknown }).content;\n  if (Array.isArray(content)) {\n    const textBlock = content.find(\n      (c): c is { type: \"text\"; text: string } =>\n        typeof c === \"object\" &&\n        c !== null &&\n        (c as { type?: unknown }).type === \"text\" &&\n        typeof (c as { text?: unknown }).text === \"string\",\n    );\n    if (textBlock) {\n      try {\n        return JSON.parse(textBlock.text);\n      } catch {\n        return textBlock.text;\n      }\n    }\n  }\n  return result;\n}\n\n/** Drop undefined fields so the server applies its own per-tool defaults. */\nfunction argsToRecord(args: object): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(args as Record<string, unknown>)) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out;\n}\n","{\n  \"name\": \"@getbourdon/client\",\n  \"version\": \"0.2.3\",\n  \"description\": \"Bourdon L6 federation MCP client for TypeScript/Node — query a running Bourdon L6 server (stdio or Streamable HTTP) over @modelcontextprotocol/sdk. Python (pip install bourdon) is the oracle; this client is wire-compatible with its L6 server.\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"LICENSE\"\n  ],\n  \"engines\": {\n    \"node\": \">=20\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"homepage\": \"https://bourdon.ai\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://gitlab.com/bourdonai/bourdon-js.git\",\n    \"directory\": \"packages/client\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"test\": \"vitest run\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.29.0\"\n  }\n}\n","import packageManifest from \"../package.json\" with { type: \"json\" };\n\n/** The version this package ships as, embedded from its own manifest at build time. */\nexport const PACKAGE_VERSION: string = packageManifest.version;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/l6-client.ts","../package.json","../src/version.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\nexport {\n  BourdonL6Client,\n  type AccessLevel,\n  type L6Config,\n  type L6StdioConfig,\n  type L6HttpConfig,\n  type L6CustomConfig,\n  type CommonToolArgs,\n  type QueryAgentMemoryArgs,\n  type ListRecentWorkArgs,\n  type FindEntityArgs,\n  type GetCrossAgentSummaryArgs,\n  type RecognitionArgs,\n  type CompileCodexTurnArgs,\n  type CommitToFederationArgs,\n  type L6ToolResult,\n} from \"./l6-client.js\";\n","// SPDX-License-Identifier: Apache-2.0\n/**\n * Bourdon L6 federation MCP client.\n *\n * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`\n * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies\n * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`\n * client so JSON-RPC framing is not re-implemented.\n *\n * Lifted and extended from the proven openclaw-bourdon-plugin client:\n *   - all twelve tools\n *   - Streamable HTTP transport (SSE is deprecated in the SDK)\n *   - results are JSON-parsed from the server's TextContent envelope\n *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,\n *     so a raw CallToolResult is unwrapped to the payload here)\n *   - an injectable transport (`{transport:'custom'}`) for in-memory testing\n *\n * Tool surface mirrored from bourdon/core/l6_server.py. The server applies\n * per-tool `access_level` defaults (public for queries, team for recognition),\n * so this client never hardcodes them — omitted args are dropped, not defaulted.\n */\n\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\nimport { PACKAGE_VERSION } from \"./version.js\";\n\n/** Federation visibility level. Mirrors the Python `Visibility` enum values. */\nexport type AccessLevel = \"public\" | \"team\" | \"private\";\n\nexport interface L6StdioConfig {\n  transport: \"stdio\";\n  /** Defaults to `python`. */\n  command?: string;\n  /** Defaults to `[\"-m\", \"bourdon.core.l6_server\"]`. */\n  args?: string[];\n  /** Optional library path forwarded to L6 via `--library`. */\n  library?: string;\n  /** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */\n  cwd?: string;\n  /** Optional environment passed to the subprocess. */\n  env?: Record<string, string>;\n}\n\nexport interface L6HttpConfig {\n  transport: \"http\";\n  url: string;\n  /** Bearer token sent as `Authorization: Bearer <token>` (federation peer auth). */\n  token?: string;\n}\n\n/** Inject a pre-built transport (used for in-memory testing). */\nexport interface L6CustomConfig {\n  transport: \"custom\";\n  instance: Transport;\n}\n\nexport type L6Config = L6StdioConfig | L6HttpConfig | L6CustomConfig;\n\nexport interface CommonToolArgs {\n  access_level?: AccessLevel;\n  include_private?: boolean;\n}\n\nexport interface QueryAgentMemoryArgs extends CommonToolArgs {\n  agent: string;\n  topic: string;\n}\n\nexport interface ListRecentWorkArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n  summary?: boolean;\n}\n\nexport interface FindEntityArgs extends CommonToolArgs {\n  name: string;\n}\n\nexport interface ListWorkstreamsArgs extends CommonToolArgs {\n  status?: \"active\" | \"paused\" | \"done\" | \"archived\";\n  agent?: string;\n}\n\nexport interface ListNotesArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface GetCrossAgentSummaryArgs extends CommonToolArgs {\n  project: string;\n}\n\nexport interface RecognitionArgs extends CommonToolArgs {\n  prompt: string;\n}\n\nexport interface CompileCodexTurnArgs {\n  prompt: string;\n  cwd?: string;\n  access_level?: AccessLevel;\n  max_items?: number;\n  max_chars?: number;\n}\n\nexport interface CommitToFederationArgs {\n  agent_id: string;\n  agent_type?: string;\n  instance?: string;\n  role_narrative?: string;\n  entities?: Record<string, unknown>[];\n  sessions?: Record<string, unknown>[];\n  workstreams?: Record<string, unknown>[];\n  notes?: Record<string, unknown>[];\n  expected_digest?: string;\n  session_id?: string;\n  transcript_ref?: string;\n  /** `merge` (default) or `replace`. */\n  mode?: \"merge\" | \"replace\";\n}\n\n/** The parsed payload returned by an L6 tool (server-defined JSON shape). */\nexport type L6ToolResult = unknown;\n\nexport class BourdonL6Client {\n  private client: Client | null = null;\n  private transport: Transport | null = null;\n  private connectPromise: Promise<void> | null = null;\n  private readonly config: L6Config;\n\n  constructor(config: L6Config) {\n    this.config = config;\n  }\n\n  /** Connect lazily on first call; subsequent calls reuse the live client. */\n  private async ensureConnected(): Promise<Client> {\n    if (this.client) return this.client;\n    if (this.connectPromise) {\n      await this.connectPromise;\n      if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n      return this.client;\n    }\n    this.connectPromise = this.connect();\n    try {\n      await this.connectPromise;\n    } finally {\n      this.connectPromise = null;\n    }\n    if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n    return this.client;\n  }\n\n  private async connect(): Promise<void> {\n    const transport = this.buildTransport(this.config);\n    const client = new Client(\n      { name: \"@getbourdon/client\", version: PACKAGE_VERSION },\n      { capabilities: {} },\n    );\n    await client.connect(transport);\n    this.client = client;\n    this.transport = transport;\n  }\n\n  private buildTransport(config: L6Config): Transport {\n    if (config.transport === \"custom\") return config.instance;\n    if (config.transport === \"stdio\") {\n      const args = [...(config.args ?? [\"-m\", \"bourdon.core.l6_server\"])];\n      if (config.library && !args.includes(\"--library\")) {\n        args.push(\"--library\", config.library);\n      }\n      return new StdioClientTransport({\n        command: config.command ?? \"python\",\n        args,\n        cwd: config.cwd,\n        env: config.env,\n      });\n    }\n    // Streamable HTTP (replaces deprecated SSE). Bearer auth via request headers.\n    const opts =\n      config.token === undefined\n        ? undefined\n        : { requestInit: { headers: { Authorization: `Bearer ${config.token}` } } };\n    return new StreamableHTTPClientTransport(new URL(config.url), opts);\n  }\n\n  /** Close the client and underlying transport. Idempotent. */\n  async close(): Promise<void> {\n    if (this.client) {\n      await this.client.close().catch(() => {\n        /* best-effort shutdown */\n      });\n      this.client = null;\n    }\n    if (this.transport) {\n      await this.transport.close?.().catch(() => {});\n      this.transport = null;\n    }\n  }\n\n  /**\n   * Generic call. Unwraps the server's TextContent JSON envelope to the payload.\n   * Prefer the typed methods below.\n   */\n  async callTool(name: string, args: Record<string, unknown> = {}): Promise<L6ToolResult> {\n    const client = await this.ensureConnected();\n    const result = await client.callTool({ name, arguments: args });\n    return parseToolResult(result);\n  }\n\n  // -- twelve typed L6 tool wrappers -------------------------------------------\n\n  queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"query_agent_memory\", argsToRecord(args));\n  }\n\n  listRecentWork(args: ListRecentWorkArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_recent_work\", argsToRecord(args));\n  }\n\n  findEntity(args: FindEntityArgs): Promise<L6ToolResult> {\n    return this.callTool(\"find_entity\", argsToRecord(args));\n  }\n\n  listWorkstreams(args: ListWorkstreamsArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_workstreams\", argsToRecord(args));\n  }\n\n  listNotes(args: ListNotesArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_notes\", argsToRecord(args));\n  }\n\n  listAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"list_agents\", {});\n  }\n\n  exportAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"export_agents\", {});\n  }\n\n  getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_cross_agent_summary\", argsToRecord(args));\n  }\n\n  prepareRecognitionContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"prepare_recognition_context\", argsToRecord(args));\n  }\n\n  getDeeperContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_deeper_context\", argsToRecord(args));\n  }\n\n  compileCodexTurn(args: CompileCodexTurnArgs): Promise<L6ToolResult> {\n    return this.callTool(\"compile_codex_turn\", argsToRecord(args));\n  }\n\n  commitToFederation(args: CommitToFederationArgs): Promise<L6ToolResult> {\n    return this.callTool(\"commit_to_federation\", argsToRecord(args));\n  }\n}\n\n/* -- internals ------------------------------------------------------------- */\n\n/**\n * Unwrap an MCP CallToolResult to the L6 payload. The L6 server JSON-stringifies\n * its payload into a single `text` content block (so cross-language peers parse\n * it with `json.loads(item.text)`); we mirror that on the read side. Falls back to\n * the raw text, then the raw result, if the envelope is unexpected.\n */\nfunction parseToolResult(result: unknown): L6ToolResult {\n  const content = (result as { content?: unknown }).content;\n  if (Array.isArray(content)) {\n    const textBlock = content.find(\n      (c): c is { type: \"text\"; text: string } =>\n        typeof c === \"object\" &&\n        c !== null &&\n        (c as { type?: unknown }).type === \"text\" &&\n        typeof (c as { text?: unknown }).text === \"string\",\n    );\n    if (textBlock) {\n      try {\n        return JSON.parse(textBlock.text);\n      } catch {\n        return textBlock.text;\n      }\n    }\n  }\n  return result;\n}\n\n/** Drop undefined fields so the server applies its own per-tool defaults. */\nfunction argsToRecord(args: object): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(args as Record<string, unknown>)) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out;\n}\n","{\n  \"name\": \"@getbourdon/client\",\n  \"version\": \"0.3.0-rc.0\",\n  \"description\": \"Bourdon L6 federation MCP client for TypeScript/Node — query a running Bourdon L6 server (stdio or Streamable HTTP) over @modelcontextprotocol/sdk. Python (pip install bourdon) is the oracle; this client is wire-compatible with its L6 server.\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"LICENSE\"\n  ],\n  \"engines\": {\n    \"node\": \">=24.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"homepage\": \"https://bourdon.ai\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://gitlab.com/bourdonai/bourdon-js.git\",\n    \"directory\": \"packages/client\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"test\": \"vitest run\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.29.0\"\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\nimport packageManifest from \"../package.json\" with { type: \"json\" };\n\n/** The version this package ships as, embedded from its own manifest at build time. */\nexport const PACKAGE_VERSION: string = packageManifest.version;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACsBA,oBAAuB;AACvB,mBAAqC;AACrC,4BAA8C;;;ACxB9C;AAAA,EACE,MAAQ;AAAA,EACR,SAAW;AAAA,EACX,aAAe;AAAA,EACf,SAAW;AAAA,EACX,MAAQ;AAAA,EACR,MAAQ;AAAA,EACR,QAAU;AAAA,EACV,OAAS;AAAA,EACT,SAAW;AAAA,IACT,KAAK;AAAA,MACH,OAAS;AAAA,MACT,QAAU;AAAA,MACV,SAAW;AAAA,IACb;AAAA,IACA,kBAAkB;AAAA,EACpB;AAAA,EACA,OAAS;AAAA,IACP;AAAA,IACA;AAAA,EACF;AAAA,EACA,SAAW;AAAA,IACT,MAAQ;AAAA,EACV;AAAA,EACA,eAAiB;AAAA,IACf,QAAU;AAAA,IACV,YAAc;AAAA,EAChB;AAAA,EACA,UAAY;AAAA,EACZ,YAAc;AAAA,IACZ,MAAQ;AAAA,IACR,KAAO;AAAA,IACP,WAAa;AAAA,EACf;AAAA,EACA,SAAW;AAAA,IACT,OAAS;AAAA,IACT,MAAQ;AAAA,EACV;AAAA,EACA,cAAgB;AAAA,IACd,6BAA6B;AAAA,EAC/B;AACF;;;ACrCO,IAAM,kBAA0B,gBAAgB;;;AFgIhD,IAAM,kBAAN,MAAsB;AAAA,EACnB,SAAwB;AAAA,EACxB,YAA8B;AAAA,EAC9B,iBAAuC;AAAA,EAC9B;AAAA,EAEjB,YAAY,QAAkB;AAC5B,SAAK,SAAS;AAAA,EAChB;AAAA;AAAA,EAGA,MAAc,kBAAmC;AAC/C,QAAI,KAAK,OAAQ,QAAO,KAAK;AAC7B,QAAI,KAAK,gBAAgB;AACvB,YAAM,KAAK;AACX,UAAI,CAAC,KAAK,OAAQ,OAAM,IAAI,MAAM,wCAAwC;AAC1E,aAAO,KAAK;AAAA,IACd;AACA,SAAK,iBAAiB,KAAK,QAAQ;AACnC,QAAI;AACF,YAAM,KAAK;AAAA,IACb,UAAE;AACA,WAAK,iBAAiB;AAAA,IACxB;AACA,QAAI,CAAC,KAAK,OAAQ,OAAM,IAAI,MAAM,wCAAwC;AAC1E,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,MAAc,UAAyB;AACrC,UAAM,YAAY,KAAK,eAAe,KAAK,MAAM;AACjD,UAAM,SAAS,IAAI;AAAA,MACjB,EAAE,MAAM,sBAAsB,SAAS,gBAAgB;AAAA,MACvD,EAAE,cAAc,CAAC,EAAE;AAAA,IACrB;AACA,UAAM,OAAO,QAAQ,SAAS;AAC9B,SAAK,SAAS;AACd,SAAK,YAAY;AAAA,EACnB;AAAA,EAEQ,eAAe,QAA6B;AAClD,QAAI,OAAO,cAAc,SAAU,QAAO,OAAO;AACjD,QAAI,OAAO,cAAc,SAAS;AAChC,YAAM,OAAO,CAAC,GAAI,OAAO,QAAQ,CAAC,MAAM,wBAAwB,CAAE;AAClE,UAAI,OAAO,WAAW,CAAC,KAAK,SAAS,WAAW,GAAG;AACjD,aAAK,KAAK,aAAa,OAAO,OAAO;AAAA,MACvC;AACA,aAAO,IAAI,kCAAqB;AAAA,QAC9B,SAAS,OAAO,WAAW;AAAA,QAC3B;AAAA,QACA,KAAK,OAAO;AAAA,QACZ,KAAK,OAAO;AAAA,MACd,CAAC;AAAA,IACH;AAEA,UAAM,OACJ,OAAO,UAAU,SACb,SACA,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,UAAU,OAAO,KAAK,GAAG,EAAE,EAAE;AAC9E,WAAO,IAAI,oDAA8B,IAAI,IAAI,OAAO,GAAG,GAAG,IAAI;AAAA,EACpE;AAAA;AAAA,EAGA,MAAM,QAAuB;AAC3B,QAAI,KAAK,QAAQ;AACf,YAAM,KAAK,OAAO,MAAM,EAAE,MAAM,MAAM;AAAA,MAEtC,CAAC;AACD,WAAK,SAAS;AAAA,IAChB;AACA,QAAI,KAAK,WAAW;AAClB,YAAM,KAAK,UAAU,QAAQ,EAAE,MAAM,MAAM;AAAA,MAAC,CAAC;AAC7C,WAAK,YAAY;AAAA,IACnB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,SAAS,MAAc,OAAgC,CAAC,GAA0B;AACtF,UAAM,SAAS,MAAM,KAAK,gBAAgB;AAC1C,UAAM,SAAS,MAAM,OAAO,SAAS,EAAE,MAAM,WAAW,KAAK,CAAC;AAC9D,WAAO,gBAAgB,MAAM;AAAA,EAC/B;AAAA;AAAA,EAIA,iBAAiB,MAAmD;AAClE,WAAO,KAAK,SAAS,sBAAsB,aAAa,IAAI,CAAC;AAAA,EAC/D;AAAA,EAEA,eAAe,OAA2B,CAAC,GAA0B;AACnE,WAAO,KAAK,SAAS,oBAAoB,aAAa,IAAI,CAAC;AAAA,EAC7D;AAAA,EAEA,WAAW,MAA6C;AACtD,WAAO,KAAK,SAAS,eAAe,aAAa,IAAI,CAAC;AAAA,EACxD;AAAA,EAEA,gBAAgB,OAA4B,CAAC,GAA0B;AACrE,WAAO,KAAK,SAAS,oBAAoB,aAAa,IAAI,CAAC;AAAA,EAC7D;AAAA,EAEA,UAAU,OAAsB,CAAC,GAA0B;AACzD,WAAO,KAAK,SAAS,cAAc,aAAa,IAAI,CAAC;AAAA,EACvD;AAAA,EAEA,aAAoC;AAClC,WAAO,KAAK,SAAS,eAAe,CAAC,CAAC;AAAA,EACxC;AAAA,EAEA,eAAsC;AACpC,WAAO,KAAK,SAAS,iBAAiB,CAAC,CAAC;AAAA,EAC1C;AAAA,EAEA,qBAAqB,MAAuD;AAC1E,WAAO,KAAK,SAAS,2BAA2B,aAAa,IAAI,CAAC;AAAA,EACpE;AAAA,EAEA,0BAA0B,MAA8C;AACtE,WAAO,KAAK,SAAS,+BAA+B,aAAa,IAAI,CAAC;AAAA,EACxE;AAAA,EAEA,iBAAiB,MAA8C;AAC7D,WAAO,KAAK,SAAS,sBAAsB,aAAa,IAAI,CAAC;AAAA,EAC/D;AAAA,EAEA,iBAAiB,MAAmD;AAClE,WAAO,KAAK,SAAS,sBAAsB,aAAa,IAAI,CAAC;AAAA,EAC/D;AAAA,EAEA,mBAAmB,MAAqD;AACtE,WAAO,KAAK,SAAS,wBAAwB,aAAa,IAAI,CAAC;AAAA,EACjE;AACF;AAUA,SAAS,gBAAgB,QAA+B;AACtD,QAAM,UAAW,OAAiC;AAClD,MAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,UAAM,YAAY,QAAQ;AAAA,MACxB,CAAC,MACC,OAAO,MAAM,YACb,MAAM,QACL,EAAyB,SAAS,UACnC,OAAQ,EAAyB,SAAS;AAAA,IAC9C;AACA,QAAI,WAAW;AACb,UAAI;AACF,eAAO,KAAK,MAAM,UAAU,IAAI;AAAA,MAClC,QAAQ;AACN,eAAO,UAAU;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAGA,SAAS,aAAa,MAAuC;AAC3D,QAAM,MAA+B,CAAC;AACtC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAA+B,GAAG;AACpE,QAAI,MAAM,OAAW,KAAI,CAAC,IAAI;AAAA,EAChC;AACA,SAAO;AACT;","names":[]}

package/dist/index.d.cts

@@ -100,8 +100,11 @@ interface CommitToFederationArgs {
     sessions?: Record<string, unknown>[];
     workstreams?: Record<string, unknown>[];
     notes?: Record<string, unknown>[];
+    expected_digest?: string;
+    session_id?: string;
+    transcript_ref?: string;
     /** `merge` (default) or `replace`. */
-    mode?: string;
+    mode?: "merge" | "replace";
 }
 /** The parsed payload returned by an L6 tool (server-defined JSON shape). */
 type L6ToolResult = unknown;

package/dist/index.js

@@ -1 +1,2 @@
+// SPDX-License-Identifier: Apache-2.0
 export { BourdonL6Client, } from "./l6-client.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/l6-client.ts","../package.json","../src/version.ts"],"sourcesContent":["/**\n * Bourdon L6 federation MCP client.\n *\n * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`\n * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies\n * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`\n * client so JSON-RPC framing is not re-implemented.\n *\n * Lifted and extended from the proven openclaw-bourdon-plugin client:\n *   - all twelve tools\n *   - Streamable HTTP transport (SSE is deprecated in the SDK)\n *   - results are JSON-parsed from the server's TextContent envelope\n *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,\n *     so a raw CallToolResult is unwrapped to the payload here)\n *   - an injectable transport (`{transport:'custom'}`) for in-memory testing\n *\n * Tool surface mirrored from bourdon/core/l6_server.py. The server applies\n * per-tool `access_level` defaults (public for queries, team for recognition),\n * so this client never hardcodes them — omitted args are dropped, not defaulted.\n */\n\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\nimport { PACKAGE_VERSION } from \"./version.js\";\n\n/** Federation visibility level. Mirrors the Python `Visibility` enum values. */\nexport type AccessLevel = \"public\" | \"team\" | \"private\";\n\nexport interface L6StdioConfig {\n  transport: \"stdio\";\n  /** Defaults to `python`. */\n  command?: string;\n  /** Defaults to `[\"-m\", \"bourdon.core.l6_server\"]`. */\n  args?: string[];\n  /** Optional library path forwarded to L6 via `--library`. */\n  library?: string;\n  /** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */\n  cwd?: string;\n  /** Optional environment passed to the subprocess. */\n  env?: Record<string, string>;\n}\n\nexport interface L6HttpConfig {\n  transport: \"http\";\n  url: string;\n  /** Bearer token sent as `Authorization: Bearer <token>` (federation peer auth). */\n  token?: string;\n}\n\n/** Inject a pre-built transport (used for in-memory testing). */\nexport interface L6CustomConfig {\n  transport: \"custom\";\n  instance: Transport;\n}\n\nexport type L6Config = L6StdioConfig | L6HttpConfig | L6CustomConfig;\n\nexport interface CommonToolArgs {\n  access_level?: AccessLevel;\n  include_private?: boolean;\n}\n\nexport interface QueryAgentMemoryArgs extends CommonToolArgs {\n  agent: string;\n  topic: string;\n}\n\nexport interface ListRecentWorkArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n  summary?: boolean;\n}\n\nexport interface FindEntityArgs extends CommonToolArgs {\n  name: string;\n}\n\nexport interface ListWorkstreamsArgs extends CommonToolArgs {\n  status?: \"active\" | \"paused\" | \"done\" | \"archived\";\n  agent?: string;\n}\n\nexport interface ListNotesArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface GetCrossAgentSummaryArgs extends CommonToolArgs {\n  project: string;\n}\n\nexport interface RecognitionArgs extends CommonToolArgs {\n  prompt: string;\n}\n\nexport interface CompileCodexTurnArgs {\n  prompt: string;\n  cwd?: string;\n  access_level?: AccessLevel;\n  max_items?: number;\n  max_chars?: number;\n}\n\nexport interface CommitToFederationArgs {\n  agent_id: string;\n  agent_type?: string;\n  instance?: string;\n  role_narrative?: string;\n  entities?: Record<string, unknown>[];\n  sessions?: Record<string, unknown>[];\n  workstreams?: Record<string, unknown>[];\n  notes?: Record<string, unknown>[];\n  /** `merge` (default) or `replace`. */\n  mode?: string;\n}\n\n/** The parsed payload returned by an L6 tool (server-defined JSON shape). */\nexport type L6ToolResult = unknown;\n\nexport class BourdonL6Client {\n  private client: Client | null = null;\n  private transport: Transport | null = null;\n  private connectPromise: Promise<void> | null = null;\n  private readonly config: L6Config;\n\n  constructor(config: L6Config) {\n    this.config = config;\n  }\n\n  /** Connect lazily on first call; subsequent calls reuse the live client. */\n  private async ensureConnected(): Promise<Client> {\n    if (this.client) return this.client;\n    if (this.connectPromise) {\n      await this.connectPromise;\n      if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n      return this.client;\n    }\n    this.connectPromise = this.connect();\n    try {\n      await this.connectPromise;\n    } finally {\n      this.connectPromise = null;\n    }\n    if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n    return this.client;\n  }\n\n  private async connect(): Promise<void> {\n    const transport = this.buildTransport(this.config);\n    const client = new Client(\n      { name: \"@getbourdon/client\", version: PACKAGE_VERSION },\n      { capabilities: {} },\n    );\n    await client.connect(transport);\n    this.client = client;\n    this.transport = transport;\n  }\n\n  private buildTransport(config: L6Config): Transport {\n    if (config.transport === \"custom\") return config.instance;\n    if (config.transport === \"stdio\") {\n      const args = [...(config.args ?? [\"-m\", \"bourdon.core.l6_server\"])];\n      if (config.library && !args.includes(\"--library\")) {\n        args.push(\"--library\", config.library);\n      }\n      return new StdioClientTransport({\n        command: config.command ?? \"python\",\n        args,\n        cwd: config.cwd,\n        env: config.env,\n      });\n    }\n    // Streamable HTTP (replaces deprecated SSE). Bearer auth via request headers.\n    const opts =\n      config.token === undefined\n        ? undefined\n        : { requestInit: { headers: { Authorization: `Bearer ${config.token}` } } };\n    return new StreamableHTTPClientTransport(new URL(config.url), opts);\n  }\n\n  /** Close the client and underlying transport. Idempotent. */\n  async close(): Promise<void> {\n    if (this.client) {\n      await this.client.close().catch(() => {\n        /* best-effort shutdown */\n      });\n      this.client = null;\n    }\n    if (this.transport) {\n      await this.transport.close?.().catch(() => {});\n      this.transport = null;\n    }\n  }\n\n  /**\n   * Generic call. Unwraps the server's TextContent JSON envelope to the payload.\n   * Prefer the typed methods below.\n   */\n  async callTool(name: string, args: Record<string, unknown> = {}): Promise<L6ToolResult> {\n    const client = await this.ensureConnected();\n    const result = await client.callTool({ name, arguments: args });\n    return parseToolResult(result);\n  }\n\n  // -- the twelve L6 tools (typed) ---------------------------------------------\n\n  queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"query_agent_memory\", argsToRecord(args));\n  }\n\n  listRecentWork(args: ListRecentWorkArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_recent_work\", argsToRecord(args));\n  }\n\n  findEntity(args: FindEntityArgs): Promise<L6ToolResult> {\n    return this.callTool(\"find_entity\", argsToRecord(args));\n  }\n\n  listWorkstreams(args: ListWorkstreamsArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_workstreams\", argsToRecord(args));\n  }\n\n  listNotes(args: ListNotesArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_notes\", argsToRecord(args));\n  }\n\n  listAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"list_agents\", {});\n  }\n\n  exportAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"export_agents\", {});\n  }\n\n  getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_cross_agent_summary\", argsToRecord(args));\n  }\n\n  prepareRecognitionContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"prepare_recognition_context\", argsToRecord(args));\n  }\n\n  getDeeperContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_deeper_context\", argsToRecord(args));\n  }\n\n  compileCodexTurn(args: CompileCodexTurnArgs): Promise<L6ToolResult> {\n    return this.callTool(\"compile_codex_turn\", argsToRecord(args));\n  }\n\n  commitToFederation(args: CommitToFederationArgs): Promise<L6ToolResult> {\n    return this.callTool(\"commit_to_federation\", argsToRecord(args));\n  }\n}\n\n/* -- internals ------------------------------------------------------------- */\n\n/**\n * Unwrap an MCP CallToolResult to the L6 payload. The L6 server JSON-stringifies\n * its payload into a single `text` content block (so cross-language peers parse\n * it with `json.loads(item.text)`); we mirror that on the read side. Falls back to\n * the raw text, then the raw result, if the envelope is unexpected.\n */\nfunction parseToolResult(result: unknown): L6ToolResult {\n  const content = (result as { content?: unknown }).content;\n  if (Array.isArray(content)) {\n    const textBlock = content.find(\n      (c): c is { type: \"text\"; text: string } =>\n        typeof c === \"object\" &&\n        c !== null &&\n        (c as { type?: unknown }).type === \"text\" &&\n        typeof (c as { text?: unknown }).text === \"string\",\n    );\n    if (textBlock) {\n      try {\n        return JSON.parse(textBlock.text);\n      } catch {\n        return textBlock.text;\n      }\n    }\n  }\n  return result;\n}\n\n/** Drop undefined fields so the server applies its own per-tool defaults. */\nfunction argsToRecord(args: object): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(args as Record<string, unknown>)) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out;\n}\n","{\n  \"name\": \"@getbourdon/client\",\n  \"version\": \"0.2.3\",\n  \"description\": \"Bourdon L6 federation MCP client for TypeScript/Node — query a running Bourdon L6 server (stdio or Streamable HTTP) over @modelcontextprotocol/sdk. Python (pip install bourdon) is the oracle; this client is wire-compatible with its L6 server.\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"LICENSE\"\n  ],\n  \"engines\": {\n    \"node\": \">=20\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"homepage\": \"https://bourdon.ai\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://gitlab.com/bourdonai/bourdon-js.git\",\n    \"directory\": \"packages/client\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"test\": \"vitest run\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.29.0\"\n  }\n}\n","import packageManifest from \"../package.json\" with { type: \"json\" };\n\n/** The version this package ships as, embedded from its own manifest at build time. */\nexport const PACKAGE_VERSION: string = packageManifest.version;\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/l6-client.ts","../package.json","../src/version.ts"],"sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n/**\n * Bourdon L6 federation MCP client.\n *\n * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`\n * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies\n * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`\n * client so JSON-RPC framing is not re-implemented.\n *\n * Lifted and extended from the proven openclaw-bourdon-plugin client:\n *   - all twelve tools\n *   - Streamable HTTP transport (SSE is deprecated in the SDK)\n *   - results are JSON-parsed from the server's TextContent envelope\n *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,\n *     so a raw CallToolResult is unwrapped to the payload here)\n *   - an injectable transport (`{transport:'custom'}`) for in-memory testing\n *\n * Tool surface mirrored from bourdon/core/l6_server.py. The server applies\n * per-tool `access_level` defaults (public for queries, team for recognition),\n * so this client never hardcodes them — omitted args are dropped, not defaulted.\n */\n\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { Transport } from \"@modelcontextprotocol/sdk/shared/transport.js\";\n\nimport { PACKAGE_VERSION } from \"./version.js\";\n\n/** Federation visibility level. Mirrors the Python `Visibility` enum values. */\nexport type AccessLevel = \"public\" | \"team\" | \"private\";\n\nexport interface L6StdioConfig {\n  transport: \"stdio\";\n  /** Defaults to `python`. */\n  command?: string;\n  /** Defaults to `[\"-m\", \"bourdon.core.l6_server\"]`. */\n  args?: string[];\n  /** Optional library path forwarded to L6 via `--library`. */\n  library?: string;\n  /** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */\n  cwd?: string;\n  /** Optional environment passed to the subprocess. */\n  env?: Record<string, string>;\n}\n\nexport interface L6HttpConfig {\n  transport: \"http\";\n  url: string;\n  /** Bearer token sent as `Authorization: Bearer <token>` (federation peer auth). */\n  token?: string;\n}\n\n/** Inject a pre-built transport (used for in-memory testing). */\nexport interface L6CustomConfig {\n  transport: \"custom\";\n  instance: Transport;\n}\n\nexport type L6Config = L6StdioConfig | L6HttpConfig | L6CustomConfig;\n\nexport interface CommonToolArgs {\n  access_level?: AccessLevel;\n  include_private?: boolean;\n}\n\nexport interface QueryAgentMemoryArgs extends CommonToolArgs {\n  agent: string;\n  topic: string;\n}\n\nexport interface ListRecentWorkArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n  summary?: boolean;\n}\n\nexport interface FindEntityArgs extends CommonToolArgs {\n  name: string;\n}\n\nexport interface ListWorkstreamsArgs extends CommonToolArgs {\n  status?: \"active\" | \"paused\" | \"done\" | \"archived\";\n  agent?: string;\n}\n\nexport interface ListNotesArgs extends CommonToolArgs {\n  /** ISO 8601 date or datetime. */\n  since?: string;\n  agent?: string;\n  limit?: number;\n  cursor?: string;\n}\n\nexport interface GetCrossAgentSummaryArgs extends CommonToolArgs {\n  project: string;\n}\n\nexport interface RecognitionArgs extends CommonToolArgs {\n  prompt: string;\n}\n\nexport interface CompileCodexTurnArgs {\n  prompt: string;\n  cwd?: string;\n  access_level?: AccessLevel;\n  max_items?: number;\n  max_chars?: number;\n}\n\nexport interface CommitToFederationArgs {\n  agent_id: string;\n  agent_type?: string;\n  instance?: string;\n  role_narrative?: string;\n  entities?: Record<string, unknown>[];\n  sessions?: Record<string, unknown>[];\n  workstreams?: Record<string, unknown>[];\n  notes?: Record<string, unknown>[];\n  expected_digest?: string;\n  session_id?: string;\n  transcript_ref?: string;\n  /** `merge` (default) or `replace`. */\n  mode?: \"merge\" | \"replace\";\n}\n\n/** The parsed payload returned by an L6 tool (server-defined JSON shape). */\nexport type L6ToolResult = unknown;\n\nexport class BourdonL6Client {\n  private client: Client | null = null;\n  private transport: Transport | null = null;\n  private connectPromise: Promise<void> | null = null;\n  private readonly config: L6Config;\n\n  constructor(config: L6Config) {\n    this.config = config;\n  }\n\n  /** Connect lazily on first call; subsequent calls reuse the live client. */\n  private async ensureConnected(): Promise<Client> {\n    if (this.client) return this.client;\n    if (this.connectPromise) {\n      await this.connectPromise;\n      if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n      return this.client;\n    }\n    this.connectPromise = this.connect();\n    try {\n      await this.connectPromise;\n    } finally {\n      this.connectPromise = null;\n    }\n    if (!this.client) throw new Error(\"Bourdon L6 client failed to initialize\");\n    return this.client;\n  }\n\n  private async connect(): Promise<void> {\n    const transport = this.buildTransport(this.config);\n    const client = new Client(\n      { name: \"@getbourdon/client\", version: PACKAGE_VERSION },\n      { capabilities: {} },\n    );\n    await client.connect(transport);\n    this.client = client;\n    this.transport = transport;\n  }\n\n  private buildTransport(config: L6Config): Transport {\n    if (config.transport === \"custom\") return config.instance;\n    if (config.transport === \"stdio\") {\n      const args = [...(config.args ?? [\"-m\", \"bourdon.core.l6_server\"])];\n      if (config.library && !args.includes(\"--library\")) {\n        args.push(\"--library\", config.library);\n      }\n      return new StdioClientTransport({\n        command: config.command ?? \"python\",\n        args,\n        cwd: config.cwd,\n        env: config.env,\n      });\n    }\n    // Streamable HTTP (replaces deprecated SSE). Bearer auth via request headers.\n    const opts =\n      config.token === undefined\n        ? undefined\n        : { requestInit: { headers: { Authorization: `Bearer ${config.token}` } } };\n    return new StreamableHTTPClientTransport(new URL(config.url), opts);\n  }\n\n  /** Close the client and underlying transport. Idempotent. */\n  async close(): Promise<void> {\n    if (this.client) {\n      await this.client.close().catch(() => {\n        /* best-effort shutdown */\n      });\n      this.client = null;\n    }\n    if (this.transport) {\n      await this.transport.close?.().catch(() => {});\n      this.transport = null;\n    }\n  }\n\n  /**\n   * Generic call. Unwraps the server's TextContent JSON envelope to the payload.\n   * Prefer the typed methods below.\n   */\n  async callTool(name: string, args: Record<string, unknown> = {}): Promise<L6ToolResult> {\n    const client = await this.ensureConnected();\n    const result = await client.callTool({ name, arguments: args });\n    return parseToolResult(result);\n  }\n\n  // -- twelve typed L6 tool wrappers -------------------------------------------\n\n  queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"query_agent_memory\", argsToRecord(args));\n  }\n\n  listRecentWork(args: ListRecentWorkArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_recent_work\", argsToRecord(args));\n  }\n\n  findEntity(args: FindEntityArgs): Promise<L6ToolResult> {\n    return this.callTool(\"find_entity\", argsToRecord(args));\n  }\n\n  listWorkstreams(args: ListWorkstreamsArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_workstreams\", argsToRecord(args));\n  }\n\n  listNotes(args: ListNotesArgs = {}): Promise<L6ToolResult> {\n    return this.callTool(\"list_notes\", argsToRecord(args));\n  }\n\n  listAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"list_agents\", {});\n  }\n\n  exportAgents(): Promise<L6ToolResult> {\n    return this.callTool(\"export_agents\", {});\n  }\n\n  getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_cross_agent_summary\", argsToRecord(args));\n  }\n\n  prepareRecognitionContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"prepare_recognition_context\", argsToRecord(args));\n  }\n\n  getDeeperContext(args: RecognitionArgs): Promise<L6ToolResult> {\n    return this.callTool(\"get_deeper_context\", argsToRecord(args));\n  }\n\n  compileCodexTurn(args: CompileCodexTurnArgs): Promise<L6ToolResult> {\n    return this.callTool(\"compile_codex_turn\", argsToRecord(args));\n  }\n\n  commitToFederation(args: CommitToFederationArgs): Promise<L6ToolResult> {\n    return this.callTool(\"commit_to_federation\", argsToRecord(args));\n  }\n}\n\n/* -- internals ------------------------------------------------------------- */\n\n/**\n * Unwrap an MCP CallToolResult to the L6 payload. The L6 server JSON-stringifies\n * its payload into a single `text` content block (so cross-language peers parse\n * it with `json.loads(item.text)`); we mirror that on the read side. Falls back to\n * the raw text, then the raw result, if the envelope is unexpected.\n */\nfunction parseToolResult(result: unknown): L6ToolResult {\n  const content = (result as { content?: unknown }).content;\n  if (Array.isArray(content)) {\n    const textBlock = content.find(\n      (c): c is { type: \"text\"; text: string } =>\n        typeof c === \"object\" &&\n        c !== null &&\n        (c as { type?: unknown }).type === \"text\" &&\n        typeof (c as { text?: unknown }).text === \"string\",\n    );\n    if (textBlock) {\n      try {\n        return JSON.parse(textBlock.text);\n      } catch {\n        return textBlock.text;\n      }\n    }\n  }\n  return result;\n}\n\n/** Drop undefined fields so the server applies its own per-tool defaults. */\nfunction argsToRecord(args: object): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(args as Record<string, unknown>)) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out;\n}\n","{\n  \"name\": \"@getbourdon/client\",\n  \"version\": \"0.3.0-rc.0\",\n  \"description\": \"Bourdon L6 federation MCP client for TypeScript/Node — query a running Bourdon L6 server (stdio or Streamable HTTP) over @modelcontextprotocol/sdk. Python (pip install bourdon) is the oracle; this client is wire-compatible with its L6 server.\",\n  \"license\": \"Apache-2.0\",\n  \"type\": \"module\",\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    },\n    \"./package.json\": \"./package.json\"\n  },\n  \"files\": [\n    \"dist\",\n    \"LICENSE\"\n  ],\n  \"engines\": {\n    \"node\": \">=24.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\",\n    \"provenance\": true\n  },\n  \"homepage\": \"https://bourdon.ai\",\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://gitlab.com/bourdonai/bourdon-js.git\",\n    \"directory\": \"packages/client\"\n  },\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"test\": \"vitest run\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.29.0\"\n  }\n}\n","// SPDX-License-Identifier: Apache-2.0\nimport packageManifest from \"../package.json\" with { type: \"json\" };\n\n/** The version this package ships as, embedded from its own manifest at build time. */\nexport const PACKAGE_VERSION: string = packageManifest.version;\n"],"mappings":"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","names":[]}

package/dist/l6-client.d.ts

@@ -98,8 +98,11 @@ export interface CommitToFederationArgs {
     sessions?: Record<string, unknown>[];
     workstreams?: Record<string, unknown>[];
     notes?: Record<string, unknown>[];
+    expected_digest?: string;
+    session_id?: string;
+    transcript_ref?: string;
     /** `merge` (default) or `replace`. */
-    mode?: string;
+    mode?: "merge" | "replace";
 }
 /** The parsed payload returned by an L6 tool (server-defined JSON shape). */
 export type L6ToolResult = unknown;

package/dist/l6-client.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
 /**
  * Bourdon L6 federation MCP client.
  *
@@ -101,7 +102,7 @@ export class BourdonL6Client {
         const result = await client.callTool({ name, arguments: args });
         return parseToolResult(result);
     }
-    // -- the twelve L6 tools (typed) ---------------------------------------------
+    // -- twelve typed L6 tool wrappers -------------------------------------------
     queryAgentMemory(args) {
         return this.callTool("query_agent_memory", argsToRecord(args));
     }

package/dist/version.js

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
 import packageManifest from "../package.json" with { type: "json" };
 /** The version this package ships as, embedded from its own manifest at build time. */
 export const PACKAGE_VERSION = packageManifest.version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getbourdon/client",
-  "version": "0.2.3",
+  "version": "0.3.0-rc.0",
   "description": "Bourdon L6 federation MCP client for TypeScript/Node — query a running Bourdon L6 server (stdio or Streamable HTTP) over @modelcontextprotocol/sdk. Python (pip install bourdon) is the oracle; this client is wire-compatible with its L6 server.",
   "license": "Apache-2.0",
   "type": "module",
@@ -20,7 +20,7 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=24.0.0"
   },
   "publishConfig": {
     "access": "public",