@getbourdon/client 0.1.2 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -3
- package/dist/index.cjs +12 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +20 -5
- package/dist/index.d.ts +20 -5
- package/dist/index.js +12 -3
- package/dist/index.js.map +1 -1
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# @getbourdon/client
|
|
2
2
|
|
|
3
3
|
The **Bourdon L6 federation MCP client** for TypeScript/Node. Query a running
|
|
4
|
-
[Bourdon](https://bourdon.ai) L6 server — over a spawned `python -m core.l6_server`
|
|
4
|
+
[Bourdon](https://bourdon.ai) L6 server — over a spawned `python -m bourdon.core.l6_server`
|
|
5
5
|
stdio subprocess, or a long-lived Streamable-HTTP service — from any JS agent.
|
|
6
6
|
|
|
7
7
|
Wire-compatible with the Python L6 server: results are JSON-parsed from the server's
|
|
@@ -12,7 +12,7 @@ import { BourdonL6Client } from "@getbourdon/client";
|
|
|
12
12
|
|
|
13
13
|
// Spawn the Python L6 server over stdio (Python is the oracle):
|
|
14
14
|
const bourdon = new BourdonL6Client({ transport: "stdio", library: "~/agent-library" });
|
|
15
|
-
await bourdon.findEntity({ name: "
|
|
15
|
+
await bourdon.findEntity({ name: "Fabrikam" });
|
|
16
16
|
await bourdon.listRecentWork({ limit: 10 });
|
|
17
17
|
await bourdon.prepareRecognitionContext({ prompt: userMessage });
|
|
18
18
|
await bourdon.close();
|
|
@@ -22,7 +22,8 @@ const peer = new BourdonL6Client({ transport: "http", url: "https://peer/mcp", t
|
|
|
22
22
|
await peer.listAgents();
|
|
23
23
|
```
|
|
24
24
|
|
|
25
|
-
All
|
|
25
|
+
All twelve L6 tools are exposed: `queryAgentMemory`, `listRecentWork`, `findEntity`,
|
|
26
|
+
`listWorkstreams`, `listNotes`,
|
|
26
27
|
`listAgents`, `exportAgents`, `getCrossAgentSummary`, `prepareRecognitionContext`,
|
|
27
28
|
`getDeeperContext`, `compileCodexTurn`, `commitToFederation`. The server applies its own
|
|
28
29
|
per-tool `access_level` defaults (public for queries, team for recognition), so omitted
|
package/dist/index.cjs
CHANGED
|
@@ -55,7 +55,10 @@ var BourdonL6Client = class {
|
|
|
55
55
|
}
|
|
56
56
|
async connect() {
|
|
57
57
|
const transport = this.buildTransport(this.config);
|
|
58
|
-
const client = new import_client.Client(
|
|
58
|
+
const client = new import_client.Client(
|
|
59
|
+
{ name: "@getbourdon/client", version: "0.1.0" },
|
|
60
|
+
{ capabilities: {} }
|
|
61
|
+
);
|
|
59
62
|
await client.connect(transport);
|
|
60
63
|
this.client = client;
|
|
61
64
|
this.transport = transport;
|
|
@@ -63,7 +66,7 @@ var BourdonL6Client = class {
|
|
|
63
66
|
buildTransport(config) {
|
|
64
67
|
if (config.transport === "custom") return config.instance;
|
|
65
68
|
if (config.transport === "stdio") {
|
|
66
|
-
const args = [...config.args ?? ["-m", "core.l6_server"]];
|
|
69
|
+
const args = [...config.args ?? ["-m", "bourdon.core.l6_server"]];
|
|
67
70
|
if (config.library && !args.includes("--library")) {
|
|
68
71
|
args.push("--library", config.library);
|
|
69
72
|
}
|
|
@@ -99,7 +102,7 @@ var BourdonL6Client = class {
|
|
|
99
102
|
const result = await client.callTool({ name, arguments: args });
|
|
100
103
|
return parseToolResult(result);
|
|
101
104
|
}
|
|
102
|
-
// -- the
|
|
105
|
+
// -- the twelve L6 tools (typed) ---------------------------------------------
|
|
103
106
|
queryAgentMemory(args) {
|
|
104
107
|
return this.callTool("query_agent_memory", argsToRecord(args));
|
|
105
108
|
}
|
|
@@ -109,6 +112,12 @@ var BourdonL6Client = class {
|
|
|
109
112
|
findEntity(args) {
|
|
110
113
|
return this.callTool("find_entity", argsToRecord(args));
|
|
111
114
|
}
|
|
115
|
+
listWorkstreams(args = {}) {
|
|
116
|
+
return this.callTool("list_workstreams", argsToRecord(args));
|
|
117
|
+
}
|
|
118
|
+
listNotes(args = {}) {
|
|
119
|
+
return this.callTool("list_notes", argsToRecord(args));
|
|
120
|
+
}
|
|
112
121
|
listAgents() {
|
|
113
122
|
return this.callTool("list_agents", {});
|
|
114
123
|
}
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +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 core.l6_server`\n * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies\n * the ten 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 TEN tools (the plugin proxied six read 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\", \"core.l6_server\"]`. */\n args?: string[];\n /** Optional library path forwarded to L6 via `--library`. */\n library?: string;\n /** cwd for the subprocess (so `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 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 /** `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({ name: \"@getbourdon/client\", version: \"0.1.0\" }, { capabilities: {} });\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\", \"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 ten 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 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":[]}
|
|
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":[]}
|
package/dist/index.d.cts
CHANGED
|
@@ -3,13 +3,13 @@ import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
|
|
|
3
3
|
/**
|
|
4
4
|
* Bourdon L6 federation MCP client.
|
|
5
5
|
*
|
|
6
|
-
* Connects to a running Bourdon L6 server — spawned as a `python -m core.l6_server`
|
|
6
|
+
* Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`
|
|
7
7
|
* stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies
|
|
8
|
-
* the
|
|
8
|
+
* the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`
|
|
9
9
|
* client so JSON-RPC framing is not re-implemented.
|
|
10
10
|
*
|
|
11
11
|
* Lifted and extended from the proven openclaw-bourdon-plugin client:
|
|
12
|
-
* - all
|
|
12
|
+
* - all twelve tools
|
|
13
13
|
* - Streamable HTTP transport (SSE is deprecated in the SDK)
|
|
14
14
|
* - results are JSON-parsed from the server's TextContent envelope
|
|
15
15
|
* (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,
|
|
@@ -27,11 +27,11 @@ interface L6StdioConfig {
|
|
|
27
27
|
transport: "stdio";
|
|
28
28
|
/** Defaults to `python`. */
|
|
29
29
|
command?: string;
|
|
30
|
-
/** Defaults to `["-m", "core.l6_server"]`. */
|
|
30
|
+
/** Defaults to `["-m", "bourdon.core.l6_server"]`. */
|
|
31
31
|
args?: string[];
|
|
32
32
|
/** Optional library path forwarded to L6 via `--library`. */
|
|
33
33
|
library?: string;
|
|
34
|
-
/** cwd for the subprocess (so `core.l6_server` is importable when not installed). */
|
|
34
|
+
/** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */
|
|
35
35
|
cwd?: string;
|
|
36
36
|
/** Optional environment passed to the subprocess. */
|
|
37
37
|
env?: Record<string, string>;
|
|
@@ -67,6 +67,17 @@ interface ListRecentWorkArgs extends CommonToolArgs {
|
|
|
67
67
|
interface FindEntityArgs extends CommonToolArgs {
|
|
68
68
|
name: string;
|
|
69
69
|
}
|
|
70
|
+
interface ListWorkstreamsArgs extends CommonToolArgs {
|
|
71
|
+
status?: "active" | "paused" | "done" | "archived";
|
|
72
|
+
agent?: string;
|
|
73
|
+
}
|
|
74
|
+
interface ListNotesArgs extends CommonToolArgs {
|
|
75
|
+
/** ISO 8601 date or datetime. */
|
|
76
|
+
since?: string;
|
|
77
|
+
agent?: string;
|
|
78
|
+
limit?: number;
|
|
79
|
+
cursor?: string;
|
|
80
|
+
}
|
|
70
81
|
interface GetCrossAgentSummaryArgs extends CommonToolArgs {
|
|
71
82
|
project: string;
|
|
72
83
|
}
|
|
@@ -87,6 +98,8 @@ interface CommitToFederationArgs {
|
|
|
87
98
|
role_narrative?: string;
|
|
88
99
|
entities?: Record<string, unknown>[];
|
|
89
100
|
sessions?: Record<string, unknown>[];
|
|
101
|
+
workstreams?: Record<string, unknown>[];
|
|
102
|
+
notes?: Record<string, unknown>[];
|
|
90
103
|
/** `merge` (default) or `replace`. */
|
|
91
104
|
mode?: string;
|
|
92
105
|
}
|
|
@@ -112,6 +125,8 @@ declare class BourdonL6Client {
|
|
|
112
125
|
queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult>;
|
|
113
126
|
listRecentWork(args?: ListRecentWorkArgs): Promise<L6ToolResult>;
|
|
114
127
|
findEntity(args: FindEntityArgs): Promise<L6ToolResult>;
|
|
128
|
+
listWorkstreams(args?: ListWorkstreamsArgs): Promise<L6ToolResult>;
|
|
129
|
+
listNotes(args?: ListNotesArgs): Promise<L6ToolResult>;
|
|
115
130
|
listAgents(): Promise<L6ToolResult>;
|
|
116
131
|
exportAgents(): Promise<L6ToolResult>;
|
|
117
132
|
getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult>;
|
package/dist/index.d.ts
CHANGED
|
@@ -3,13 +3,13 @@ import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
|
|
|
3
3
|
/**
|
|
4
4
|
* Bourdon L6 federation MCP client.
|
|
5
5
|
*
|
|
6
|
-
* Connects to a running Bourdon L6 server — spawned as a `python -m core.l6_server`
|
|
6
|
+
* Connects to a running Bourdon L6 server — spawned as a `python -m bourdon.core.l6_server`
|
|
7
7
|
* stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies
|
|
8
|
-
* the
|
|
8
|
+
* the twelve L6 tools it exposes. Wraps the official `@modelcontextprotocol/sdk`
|
|
9
9
|
* client so JSON-RPC framing is not re-implemented.
|
|
10
10
|
*
|
|
11
11
|
* Lifted and extended from the proven openclaw-bourdon-plugin client:
|
|
12
|
-
* - all
|
|
12
|
+
* - all twelve tools
|
|
13
13
|
* - Streamable HTTP transport (SSE is deprecated in the SDK)
|
|
14
14
|
* - results are JSON-parsed from the server's TextContent envelope
|
|
15
15
|
* (the L6 server returns `{content:[{type:'text', text: JSON.stringify(payload)}]}`,
|
|
@@ -27,11 +27,11 @@ interface L6StdioConfig {
|
|
|
27
27
|
transport: "stdio";
|
|
28
28
|
/** Defaults to `python`. */
|
|
29
29
|
command?: string;
|
|
30
|
-
/** Defaults to `["-m", "core.l6_server"]`. */
|
|
30
|
+
/** Defaults to `["-m", "bourdon.core.l6_server"]`. */
|
|
31
31
|
args?: string[];
|
|
32
32
|
/** Optional library path forwarded to L6 via `--library`. */
|
|
33
33
|
library?: string;
|
|
34
|
-
/** cwd for the subprocess (so `core.l6_server` is importable when not installed). */
|
|
34
|
+
/** cwd for the subprocess (so `bourdon.core.l6_server` is importable when not installed). */
|
|
35
35
|
cwd?: string;
|
|
36
36
|
/** Optional environment passed to the subprocess. */
|
|
37
37
|
env?: Record<string, string>;
|
|
@@ -67,6 +67,17 @@ interface ListRecentWorkArgs extends CommonToolArgs {
|
|
|
67
67
|
interface FindEntityArgs extends CommonToolArgs {
|
|
68
68
|
name: string;
|
|
69
69
|
}
|
|
70
|
+
interface ListWorkstreamsArgs extends CommonToolArgs {
|
|
71
|
+
status?: "active" | "paused" | "done" | "archived";
|
|
72
|
+
agent?: string;
|
|
73
|
+
}
|
|
74
|
+
interface ListNotesArgs extends CommonToolArgs {
|
|
75
|
+
/** ISO 8601 date or datetime. */
|
|
76
|
+
since?: string;
|
|
77
|
+
agent?: string;
|
|
78
|
+
limit?: number;
|
|
79
|
+
cursor?: string;
|
|
80
|
+
}
|
|
70
81
|
interface GetCrossAgentSummaryArgs extends CommonToolArgs {
|
|
71
82
|
project: string;
|
|
72
83
|
}
|
|
@@ -87,6 +98,8 @@ interface CommitToFederationArgs {
|
|
|
87
98
|
role_narrative?: string;
|
|
88
99
|
entities?: Record<string, unknown>[];
|
|
89
100
|
sessions?: Record<string, unknown>[];
|
|
101
|
+
workstreams?: Record<string, unknown>[];
|
|
102
|
+
notes?: Record<string, unknown>[];
|
|
90
103
|
/** `merge` (default) or `replace`. */
|
|
91
104
|
mode?: string;
|
|
92
105
|
}
|
|
@@ -112,6 +125,8 @@ declare class BourdonL6Client {
|
|
|
112
125
|
queryAgentMemory(args: QueryAgentMemoryArgs): Promise<L6ToolResult>;
|
|
113
126
|
listRecentWork(args?: ListRecentWorkArgs): Promise<L6ToolResult>;
|
|
114
127
|
findEntity(args: FindEntityArgs): Promise<L6ToolResult>;
|
|
128
|
+
listWorkstreams(args?: ListWorkstreamsArgs): Promise<L6ToolResult>;
|
|
129
|
+
listNotes(args?: ListNotesArgs): Promise<L6ToolResult>;
|
|
115
130
|
listAgents(): Promise<L6ToolResult>;
|
|
116
131
|
exportAgents(): Promise<L6ToolResult>;
|
|
117
132
|
getCrossAgentSummary(args: GetCrossAgentSummaryArgs): Promise<L6ToolResult>;
|
package/dist/index.js
CHANGED
|
@@ -29,7 +29,10 @@ var BourdonL6Client = class {
|
|
|
29
29
|
}
|
|
30
30
|
async connect() {
|
|
31
31
|
const transport = this.buildTransport(this.config);
|
|
32
|
-
const client = new Client(
|
|
32
|
+
const client = new Client(
|
|
33
|
+
{ name: "@getbourdon/client", version: "0.1.0" },
|
|
34
|
+
{ capabilities: {} }
|
|
35
|
+
);
|
|
33
36
|
await client.connect(transport);
|
|
34
37
|
this.client = client;
|
|
35
38
|
this.transport = transport;
|
|
@@ -37,7 +40,7 @@ var BourdonL6Client = class {
|
|
|
37
40
|
buildTransport(config) {
|
|
38
41
|
if (config.transport === "custom") return config.instance;
|
|
39
42
|
if (config.transport === "stdio") {
|
|
40
|
-
const args = [...config.args ?? ["-m", "core.l6_server"]];
|
|
43
|
+
const args = [...config.args ?? ["-m", "bourdon.core.l6_server"]];
|
|
41
44
|
if (config.library && !args.includes("--library")) {
|
|
42
45
|
args.push("--library", config.library);
|
|
43
46
|
}
|
|
@@ -73,7 +76,7 @@ var BourdonL6Client = class {
|
|
|
73
76
|
const result = await client.callTool({ name, arguments: args });
|
|
74
77
|
return parseToolResult(result);
|
|
75
78
|
}
|
|
76
|
-
// -- the
|
|
79
|
+
// -- the twelve L6 tools (typed) ---------------------------------------------
|
|
77
80
|
queryAgentMemory(args) {
|
|
78
81
|
return this.callTool("query_agent_memory", argsToRecord(args));
|
|
79
82
|
}
|
|
@@ -83,6 +86,12 @@ var BourdonL6Client = class {
|
|
|
83
86
|
findEntity(args) {
|
|
84
87
|
return this.callTool("find_entity", argsToRecord(args));
|
|
85
88
|
}
|
|
89
|
+
listWorkstreams(args = {}) {
|
|
90
|
+
return this.callTool("list_workstreams", argsToRecord(args));
|
|
91
|
+
}
|
|
92
|
+
listNotes(args = {}) {
|
|
93
|
+
return this.callTool("list_notes", argsToRecord(args));
|
|
94
|
+
}
|
|
86
95
|
listAgents() {
|
|
87
96
|
return this.callTool("list_agents", {});
|
|
88
97
|
}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +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 core.l6_server`\n * stdio subprocess (default) or a long-lived Streamable-HTTP service — and proxies\n * the ten 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 TEN tools (the plugin proxied six read 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\", \"core.l6_server\"]`. */\n args?: string[];\n /** Optional library path forwarded to L6 via `--library`. */\n library?: string;\n /** cwd for the subprocess (so `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 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 /** `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({ name: \"@getbourdon/client\", version: \"0.1.0\" }, { capabilities: {} });\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\", \"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 ten 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 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":[]}
|
|
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":[]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@getbourdon/client",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"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.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"type": "module",
|
|
@@ -22,19 +22,19 @@
|
|
|
22
22
|
},
|
|
23
23
|
"publishConfig": {
|
|
24
24
|
"access": "public",
|
|
25
|
-
"provenance":
|
|
25
|
+
"provenance": false
|
|
26
26
|
},
|
|
27
27
|
"homepage": "https://bourdon.ai",
|
|
28
28
|
"repository": {
|
|
29
29
|
"type": "git",
|
|
30
|
-
"url": "git+https://
|
|
30
|
+
"url": "git+https://github.com/getbourdon/bourdon-js.git",
|
|
31
31
|
"directory": "packages/client"
|
|
32
32
|
},
|
|
33
|
+
"dependencies": {
|
|
34
|
+
"@modelcontextprotocol/sdk": "^1.29.0"
|
|
35
|
+
},
|
|
33
36
|
"scripts": {
|
|
34
37
|
"build": "tsup",
|
|
35
38
|
"test": "vitest run"
|
|
36
|
-
},
|
|
37
|
-
"dependencies": {
|
|
38
|
-
"@modelcontextprotocol/sdk": "^1.29.0"
|
|
39
39
|
}
|
|
40
|
-
}
|
|
40
|
+
}
|