@getbourdon/client 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -28,6 +28,14 @@ module.exports = __toCommonJS(index_exports);
 var import_client = require("@modelcontextprotocol/sdk/client/index.js");
 var import_stdio = require("@modelcontextprotocol/sdk/client/stdio.js");
 var import_streamableHttp = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+
+// src/version.ts
+var import_node_module = require("module");
+var import_meta = {};
+var requireFromHere = typeof __filename !== "undefined" ? (0, import_node_module.createRequire)(__filename) : (0, import_node_module.createRequire)(import_meta.url);
+var PACKAGE_VERSION = requireFromHere("@getbourdon/client/package.json").version;
+
+// src/l6-client.ts
 var BourdonL6Client = class {
   client = null;
   transport = null;
@@ -56,7 +64,7 @@ var BourdonL6Client = class {
   async connect() {
     const transport = this.buildTransport(this.config);
     const client = new import_client.Client(
-      { name: "@getbourdon/client", version: "0.1.0" },
+      { name: "@getbourdon/client", version: PACKAGE_VERSION },
       { capabilities: {} }
     );
     await client.connect(transport);

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/l6-client.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\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: \"0.1.0\" },\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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/l6-client.ts","../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","import { createRequire } from \"node:module\";\n\n/** The version this package ships as -- read from its own manifest so the\n * reported value can never drift from the registry.\n *\n * Dual-format note: in the CJS build `import.meta.url` compiles to\n * `undefined`, so the CJS global is preferred when it exists; the\n * `import.meta.url` branch only evaluates in the ESM output. */\nconst requireFromHere = typeof __filename !== \"undefined\"\n  ? createRequire(__filename)\n  : createRequire(import.meta.url);\n\nexport const PACKAGE_VERSION: string = requireFromHere(\"@getbourdon/client/package.json\").version;\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,139 +1 @@
-import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
-
-/**
- * Bourdon L6 federation MCP client.
- *
- * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`
- * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies
- * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`
- * client so JSON-RPC framing is not re-implemented.
- *
- * Lifted and extended from the proven openclaw-bourdon-plugin client:
- *   - all twelve tools
- *   - Streamable HTTP transport (SSE is deprecated in the SDK)
- *   - results are JSON-parsed from the server's TextContent envelope
- *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,
- *     so a raw CallToolResult is unwrapped to the payload here)
- *   - an injectable transport (`{transport:'custom'}`) for in-memory testing
- *
- * Tool surface mirrored from bourdon/core/l6_server.py. The server applies
- * per-tool `access_level` defaults (public for queries, team for recognition),
- * so this client never hardcodes them — omitted args are dropped, not defaulted.
- */
-
-/** Federation visibility level. Mirrors the Python `Visibility` enum values. */
-type AccessLevel = "public" | "team" | "private";
-interface L6StdioConfig {
-    transport: "stdio";
-    /** Defaults to `python`. */
-    command?: string;
-    /** Defaults to `["-m", "bourdon.core.l6_server"]`. */
-    args?: string[];
-    /** Optional library path forwarded to L6 via `--library`. */
-    library?: string;
-    /** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */
-    cwd?: string;
-    /** Optional environment passed to the subprocess. */
-    env?: Record<string, string>;
-}
-interface L6HttpConfig {
-    transport: "http";
-    url: string;
-    /** Bearer token sent as `Authorization: Bearer <token>` (federation peer auth). */
-    token?: string;
-}
-/** Inject a pre-built transport (used for in-memory testing). */
-interface L6CustomConfig {
-    transport: "custom";
-    instance: Transport;
-}
-type L6Config = L6StdioConfig | L6HttpConfig | L6CustomConfig;
-interface CommonToolArgs {
-    access_level?: AccessLevel;
-    include_private?: boolean;
-}
-interface QueryAgentMemoryArgs extends CommonToolArgs {
-    agent: string;
-    topic: string;
-}
-interface ListRecentWorkArgs extends CommonToolArgs {
-    /** ISO 8601 date or datetime. */
-    since?: string;
-    agent?: string;
-    limit?: number;
-    cursor?: string;
-    summary?: boolean;
-}
-interface FindEntityArgs extends CommonToolArgs {
-    name: string;
-}
-interface ListWorkstreamsArgs extends CommonToolArgs {
-    status?: "active" | "paused" | "done" | "archived";
-    agent?: string;
-}
-interface ListNotesArgs extends CommonToolArgs {
-    /** ISO 8601 date or datetime. */
-    since?: string;
-    agent?: string;
-    limit?: number;
-    cursor?: string;
-}
-interface GetCrossAgentSummaryArgs extends CommonToolArgs {
-    project: string;
-}
-interface RecognitionArgs extends CommonToolArgs {
-    prompt: string;
-}
-interface CompileCodexTurnArgs {
-    prompt: string;
-    cwd?: string;
-    access_level?: AccessLevel;
-    max_items?: number;
-    max_chars?: number;
-}
-interface CommitToFederationArgs {
-    agent_id: string;
-    agent_type?: string;
-    instance?: string;
-    role_narrative?: string;
-    entities?: Record<string, unknown>[];
-    sessions?: Record<string, unknown>[];
-    workstreams?: Record<string, unknown>[];
-    notes?: Record<string, unknown>[];
-    /** `merge` (default) or `replace`. */
-    mode?: string;
-}
-/** The parsed payload returned by an L6 tool (server-defined JSON shape). */
-type L6ToolResult = unknown;
-declare class BourdonL6Client {
-    private client;
-    private transport;
-    private connectPromise;
-    private readonly config;
-    constructor(config: L6Config);
-    /** Connect lazily on first call; subsequent calls reuse the live client. */
-    private ensureConnected;
-    private connect;
-    private buildTransport;
-    /** Close the client and underlying transport. Idempotent. */
-    close(): Promise<void>;
-    /**
-     * Generic call. Unwraps the server's TextContent JSON envelope to the payload.
-     * Prefer the typed methods below.
-     */
-    callTool(name: string, args?: Record<string, unknown>): Promise<L6ToolResult>;
-    queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult>;
-    listRecentWork(args?: ListRecentWorkArgs): Promise<L6ToolResult>;
-    findEntity(args: FindEntityArgs): Promise<L6ToolResult>;
-    listWorkstreams(args?: ListWorkstreamsArgs): Promise<L6ToolResult>;
-    listNotes(args?: ListNotesArgs): Promise<L6ToolResult>;
-    listAgents(): Promise<L6ToolResult>;
-    exportAgents(): Promise<L6ToolResult>;
-    getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult>;
-    prepareRecognitionContext(args: RecognitionArgs): Promise<L6ToolResult>;
-    getDeeperContext(args: RecognitionArgs): Promise<L6ToolResult>;
-    compileCodexTurn(args: CompileCodexTurnArgs): Promise<L6ToolResult>;
-    commitToFederation(args: CommitToFederationArgs): Promise<L6ToolResult>;
-}
-
-export { type AccessLevel, BourdonL6Client, type CommitToFederationArgs, type CommonToolArgs, type CompileCodexTurnArgs, type FindEntityArgs, type GetCrossAgentSummaryArgs, type L6Config, type L6CustomConfig, type L6HttpConfig, type L6StdioConfig, type L6ToolResult, type ListRecentWorkArgs, type QueryAgentMemoryArgs, type RecognitionArgs };
+export { BourdonL6Client, type AccessLevel, type L6Config, type L6StdioConfig, type L6HttpConfig, type L6CustomConfig, type CommonToolArgs, type QueryAgentMemoryArgs, type ListRecentWorkArgs, type FindEntityArgs, type GetCrossAgentSummaryArgs, type RecognitionArgs, type CompileCodexTurnArgs, type CommitToFederationArgs, type L6ToolResult, } from "./l6-client.js";

package/dist/index.js

@@ -1,143 +1 @@
-// src/l6-client.ts
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-var BourdonL6Client = class {
-  client = null;
-  transport = null;
-  connectPromise = null;
-  config;
-  constructor(config) {
-    this.config = config;
-  }
-  /** Connect lazily on first call; subsequent calls reuse the live client. */
-  async ensureConnected() {
-    if (this.client) return this.client;
-    if (this.connectPromise) {
-      await this.connectPromise;
-      if (!this.client) throw new Error("Bourdon L6 client failed to initialize");
-      return this.client;
-    }
-    this.connectPromise = this.connect();
-    try {
-      await this.connectPromise;
-    } finally {
-      this.connectPromise = null;
-    }
-    if (!this.client) throw new Error("Bourdon L6 client failed to initialize");
-    return this.client;
-  }
-  async connect() {
-    const transport = this.buildTransport(this.config);
-    const client = new Client(
-      { name: "@getbourdon/client", version: "0.1.0" },
-      { capabilities: {} }
-    );
-    await client.connect(transport);
-    this.client = client;
-    this.transport = transport;
-  }
-  buildTransport(config) {
-    if (config.transport === "custom") return config.instance;
-    if (config.transport === "stdio") {
-      const args = [...config.args ?? ["-m", "bourdon.core.l6_server"]];
-      if (config.library && !args.includes("--library")) {
-        args.push("--library", config.library);
-      }
-      return new StdioClientTransport({
-        command: config.command ?? "python",
-        args,
-        cwd: config.cwd,
-        env: config.env
-      });
-    }
-    const opts = config.token === void 0 ? void 0 : { requestInit: { headers: { Authorization: `Bearer ${config.token}` } } };
-    return new StreamableHTTPClientTransport(new URL(config.url), opts);
-  }
-  /** Close the client and underlying transport. Idempotent. */
-  async close() {
-    if (this.client) {
-      await this.client.close().catch(() => {
-      });
-      this.client = null;
-    }
-    if (this.transport) {
-      await this.transport.close?.().catch(() => {
-      });
-      this.transport = null;
-    }
-  }
-  /**
-   * Generic call. Unwraps the server's TextContent JSON envelope to the payload.
-   * Prefer the typed methods below.
-   */
-  async callTool(name, args = {}) {
-    const client = await this.ensureConnected();
-    const result = await client.callTool({ name, arguments: args });
-    return parseToolResult(result);
-  }
-  // -- the twelve L6 tools (typed) ---------------------------------------------
-  queryAgentMemory(args) {
-    return this.callTool("query_agent_memory", argsToRecord(args));
-  }
-  listRecentWork(args = {}) {
-    return this.callTool("list_recent_work", argsToRecord(args));
-  }
-  findEntity(args) {
-    return this.callTool("find_entity", argsToRecord(args));
-  }
-  listWorkstreams(args = {}) {
-    return this.callTool("list_workstreams", argsToRecord(args));
-  }
-  listNotes(args = {}) {
-    return this.callTool("list_notes", argsToRecord(args));
-  }
-  listAgents() {
-    return this.callTool("list_agents", {});
-  }
-  exportAgents() {
-    return this.callTool("export_agents", {});
-  }
-  getCrossAgentSummary(args) {
-    return this.callTool("get_cross_agent_summary", argsToRecord(args));
-  }
-  prepareRecognitionContext(args) {
-    return this.callTool("prepare_recognition_context", argsToRecord(args));
-  }
-  getDeeperContext(args) {
-    return this.callTool("get_deeper_context", argsToRecord(args));
-  }
-  compileCodexTurn(args) {
-    return this.callTool("compile_codex_turn", argsToRecord(args));
-  }
-  commitToFederation(args) {
-    return this.callTool("commit_to_federation", argsToRecord(args));
-  }
-};
-function parseToolResult(result) {
-  const content = result.content;
-  if (Array.isArray(content)) {
-    const textBlock = content.find(
-      (c) => typeof c === "object" && c !== null && c.type === "text" && typeof c.text === "string"
-    );
-    if (textBlock) {
-      try {
-        return JSON.parse(textBlock.text);
-      } catch {
-        return textBlock.text;
-      }
-    }
-  }
-  return result;
-}
-function argsToRecord(args) {
-  const out = {};
-  for (const [k, v] of Object.entries(args)) {
-    if (v !== void 0) out[k] = v;
-  }
-  return out;
-}
-export {
-  BourdonL6Client
-};
-//# sourceMappingURL=index.js.map
+export { BourdonL6Client, } from "./l6-client.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/l6-client.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\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: \"0.1.0\" },\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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/l6-client.ts","../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","import { createRequire } from \"node:module\";\n\n/** The version this package ships as -- read from its own manifest so the\n * reported value can never drift from the registry.\n *\n * Dual-format note: in the CJS build `import.meta.url` compiles to\n * `undefined`, so the CJS global is preferred when it exists; the\n * `import.meta.url` branch only evaluates in the ESM output. */\nconst requireFromHere = typeof __filename !== \"undefined\"\n  ? createRequire(__filename)\n  : createRequire(import.meta.url);\n\nexport const PACKAGE_VERSION: string = requireFromHere(\"@getbourdon/client/package.json\").version;\n"],"mappings":"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","names":[]}

package/dist/l6-client.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Bourdon L6 federation MCP client.
+ *
+ * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`
+ * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies
+ * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`
+ * client so JSON-RPC framing is not re-implemented.
+ *
+ * Lifted and extended from the proven openclaw-bourdon-plugin client:
+ *   - all twelve tools
+ *   - Streamable HTTP transport (SSE is deprecated in the SDK)
+ *   - results are JSON-parsed from the server's TextContent envelope
+ *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,
+ *     so a raw CallToolResult is unwrapped to the payload here)
+ *   - an injectable transport (`{transport:'custom'}`) for in-memory testing
+ *
+ * Tool surface mirrored from bourdon/core/l6_server.py. The server applies
+ * per-tool `access_level` defaults (public for queries, team for recognition),
+ * so this client never hardcodes them — omitted args are dropped, not defaulted.
+ */
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
+/** Federation visibility level. Mirrors the Python `Visibility` enum values. */
+export type AccessLevel = "public" | "team" | "private";
+export interface L6StdioConfig {
+    transport: "stdio";
+    /** Defaults to `python`. */
+    command?: string;
+    /** Defaults to `["-m", "bourdon.core.l6_server"]`. */
+    args?: string[];
+    /** Optional library path forwarded to L6 via `--library`. */
+    library?: string;
+    /** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */
+    cwd?: string;
+    /** Optional environment passed to the subprocess. */
+    env?: Record<string, string>;
+}
+export interface L6HttpConfig {
+    transport: "http";
+    url: string;
+    /** Bearer token sent as `Authorization: Bearer <token>` (federation peer auth). */
+    token?: string;
+}
+/** Inject a pre-built transport (used for in-memory testing). */
+export interface L6CustomConfig {
+    transport: "custom";
+    instance: Transport;
+}
+export type L6Config = L6StdioConfig | L6HttpConfig | L6CustomConfig;
+export interface CommonToolArgs {
+    access_level?: AccessLevel;
+    include_private?: boolean;
+}
+export interface QueryAgentMemoryArgs extends CommonToolArgs {
+    agent: string;
+    topic: string;
+}
+export interface ListRecentWorkArgs extends CommonToolArgs {
+    /** ISO 8601 date or datetime. */
+    since?: string;
+    agent?: string;
+    limit?: number;
+    cursor?: string;
+    summary?: boolean;
+}
+export interface FindEntityArgs extends CommonToolArgs {
+    name: string;
+}
+export interface ListWorkstreamsArgs extends CommonToolArgs {
+    status?: "active" | "paused" | "done" | "archived";
+    agent?: string;
+}
+export interface ListNotesArgs extends CommonToolArgs {
+    /** ISO 8601 date or datetime. */
+    since?: string;
+    agent?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface GetCrossAgentSummaryArgs extends CommonToolArgs {
+    project: string;
+}
+export interface RecognitionArgs extends CommonToolArgs {
+    prompt: string;
+}
+export interface CompileCodexTurnArgs {
+    prompt: string;
+    cwd?: string;
+    access_level?: AccessLevel;
+    max_items?: number;
+    max_chars?: number;
+}
+export interface CommitToFederationArgs {
+    agent_id: string;
+    agent_type?: string;
+    instance?: string;
+    role_narrative?: string;
+    entities?: Record<string, unknown>[];
+    sessions?: Record<string, unknown>[];
+    workstreams?: Record<string, unknown>[];
+    notes?: Record<string, unknown>[];
+    /** `merge` (default) or `replace`. */
+    mode?: string;
+}
+/** The parsed payload returned by an L6 tool (server-defined JSON shape). */
+export type L6ToolResult = unknown;
+export declare class BourdonL6Client {
+    private client;
+    private transport;
+    private connectPromise;
+    private readonly config;
+    constructor(config: L6Config);
+    /** Connect lazily on first call; subsequent calls reuse the live client. */
+    private ensureConnected;
+    private connect;
+    private buildTransport;
+    /** Close the client and underlying transport. Idempotent. */
+    close(): Promise<void>;
+    /**
+     * Generic call. Unwraps the server's TextContent JSON envelope to the payload.
+     * Prefer the typed methods below.
+     */
+    callTool(name: string, args?: Record<string, unknown>): Promise<L6ToolResult>;
+    queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult>;
+    listRecentWork(args?: ListRecentWorkArgs): Promise<L6ToolResult>;
+    findEntity(args: FindEntityArgs): Promise<L6ToolResult>;
+    listWorkstreams(args?: ListWorkstreamsArgs): Promise<L6ToolResult>;
+    listNotes(args?: ListNotesArgs): Promise<L6ToolResult>;
+    listAgents(): Promise<L6ToolResult>;
+    exportAgents(): Promise<L6ToolResult>;
+    getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult>;
+    prepareRecognitionContext(args: RecognitionArgs): Promise<L6ToolResult>;
+    getDeeperContext(args: RecognitionArgs): Promise<L6ToolResult>;
+    compileCodexTurn(args: CompileCodexTurnArgs): Promise<L6ToolResult>;
+    commitToFederation(args: CommitToFederationArgs): Promise<L6ToolResult>;
+}

package/dist/l6-client.js

@@ -0,0 +1,175 @@
+/**
+ * Bourdon L6 federation MCP client.
+ *
+ * Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`
+ * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies
+ * the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`
+ * client so JSON-RPC framing is not re-implemented.
+ *
+ * Lifted and extended from the proven openclaw-bourdon-plugin client:
+ *   - all twelve tools
+ *   - Streamable HTTP transport (SSE is deprecated in the SDK)
+ *   - results are JSON-parsed from the server's TextContent envelope
+ *     (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,
+ *     so a raw CallToolResult is unwrapped to the payload here)
+ *   - an injectable transport (`{transport:'custom'}`) for in-memory testing
+ *
+ * Tool surface mirrored from bourdon/core/l6_server.py. The server applies
+ * per-tool `access_level` defaults (public for queries, team for recognition),
+ * so this client never hardcodes them — omitted args are dropped, not defaulted.
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { PACKAGE_VERSION } from "./version.js";
+export class BourdonL6Client {
+    client = null;
+    transport = null;
+    connectPromise = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /** Connect lazily on first call; subsequent calls reuse the live client. */
+    async ensureConnected() {
+        if (this.client)
+            return this.client;
+        if (this.connectPromise) {
+            await this.connectPromise;
+            if (!this.client)
+                throw new Error("Bourdon L6 client failed to initialize");
+            return this.client;
+        }
+        this.connectPromise = this.connect();
+        try {
+            await this.connectPromise;
+        }
+        finally {
+            this.connectPromise = null;
+        }
+        if (!this.client)
+            throw new Error("Bourdon L6 client failed to initialize");
+        return this.client;
+    }
+    async connect() {
+        const transport = this.buildTransport(this.config);
+        const client = new Client({ name: "@getbourdon/client", version: PACKAGE_VERSION }, { capabilities: {} });
+        await client.connect(transport);
+        this.client = client;
+        this.transport = transport;
+    }
+    buildTransport(config) {
+        if (config.transport === "custom")
+            return config.instance;
+        if (config.transport === "stdio") {
+            const args = [...(config.args ?? ["-m", "bourdon.core.l6_server"])];
+            if (config.library && !args.includes("--library")) {
+                args.push("--library", config.library);
+            }
+            return new StdioClientTransport({
+                command: config.command ?? "python",
+                args,
+                cwd: config.cwd,
+                env: config.env,
+            });
+        }
+        // Streamable HTTP (replaces deprecated SSE). Bearer auth via request headers.
+        const opts = config.token === undefined
+            ? undefined
+            : { requestInit: { headers: { Authorization: `Bearer ${config.token}` } } };
+        return new StreamableHTTPClientTransport(new URL(config.url), opts);
+    }
+    /** Close the client and underlying transport. Idempotent. */
+    async close() {
+        if (this.client) {
+            await this.client.close().catch(() => {
+                /* best-effort shutdown */
+            });
+            this.client = null;
+        }
+        if (this.transport) {
+            await this.transport.close?.().catch(() => { });
+            this.transport = null;
+        }
+    }
+    /**
+     * Generic call. Unwraps the server's TextContent JSON envelope to the payload.
+     * Prefer the typed methods below.
+     */
+    async callTool(name, args = {}) {
+        const client = await this.ensureConnected();
+        const result = await client.callTool({ name, arguments: args });
+        return parseToolResult(result);
+    }
+    // -- the twelve L6 tools (typed) ---------------------------------------------
+    queryAgentMemory(args) {
+        return this.callTool("query_agent_memory", argsToRecord(args));
+    }
+    listRecentWork(args = {}) {
+        return this.callTool("list_recent_work", argsToRecord(args));
+    }
+    findEntity(args) {
+        return this.callTool("find_entity", argsToRecord(args));
+    }
+    listWorkstreams(args = {}) {
+        return this.callTool("list_workstreams", argsToRecord(args));
+    }
+    listNotes(args = {}) {
+        return this.callTool("list_notes", argsToRecord(args));
+    }
+    listAgents() {
+        return this.callTool("list_agents", {});
+    }
+    exportAgents() {
+        return this.callTool("export_agents", {});
+    }
+    getCrossAgentSummary(args) {
+        return this.callTool("get_cross_agent_summary", argsToRecord(args));
+    }
+    prepareRecognitionContext(args) {
+        return this.callTool("prepare_recognition_context", argsToRecord(args));
+    }
+    getDeeperContext(args) {
+        return this.callTool("get_deeper_context", argsToRecord(args));
+    }
+    compileCodexTurn(args) {
+        return this.callTool("compile_codex_turn", argsToRecord(args));
+    }
+    commitToFederation(args) {
+        return this.callTool("commit_to_federation", argsToRecord(args));
+    }
+}
+/* -- internals ------------------------------------------------------------- */
+/**
+ * Unwrap an MCP CallToolResult to the L6 payload. The L6 server JSON-stringifies
+ * its payload into a single `text` content block (so cross-language peers parse
+ * it with `json.loads(item.text)`); we mirror that on the read side. Falls back to
+ * the raw text, then the raw result, if the envelope is unexpected.
+ */
+function parseToolResult(result) {
+    const content = result.content;
+    if (Array.isArray(content)) {
+        const textBlock = content.find((c) => typeof c === "object" &&
+            c !== null &&
+            c.type === "text" &&
+            typeof c.text === "string");
+        if (textBlock) {
+            try {
+                return JSON.parse(textBlock.text);
+            }
+            catch {
+                return textBlock.text;
+            }
+        }
+    }
+    return result;
+}
+/** Drop undefined fields so the server applies its own per-tool defaults. */
+function argsToRecord(args) {
+    const out = {};
+    for (const [k, v] of Object.entries(args)) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const PACKAGE_VERSION: string;

package/dist/version.js

@@ -0,0 +1,11 @@
+import { createRequire } from "node:module";
+/** The version this package ships as -- read from its own manifest so the
+ * reported value can never drift from the registry.
+ *
+ * Dual-format note: in the CJS build `import.meta.url` compiles to
+ * `undefined`, so the CJS global is preferred when it exists; the
+ * `import.meta.url` branch only evaluates in the ESM output. */
+const requireFromHere = typeof __filename !== "undefined"
+    ? createRequire(__filename)
+    : createRequire(import.meta.url);
+export const PACKAGE_VERSION = requireFromHere("@getbourdon/client/package.json").version;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getbourdon/client",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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",
@@ -12,22 +12,24 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
-    }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
-    "dist"
+    "dist",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=20"
   },
   "publishConfig": {
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "homepage": "https://bourdon.ai",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/getbourdon/bourdon-js.git",
+    "url": "git+https://gitlab.com/bourdonai/bourdon-js.git",
     "directory": "packages/client"
   },
   "dependencies": {