@seanhogg/builderforce-memory-mcp 2026.6.27 → 2026.6.30
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/dist/bin/http.d.ts +2 -0
- package/dist/bin/http.d.ts.map +1 -1
- package/dist/bin/http.js +6 -0
- package/dist/bin/http.js.map +1 -1
- package/dist/bin/stdio.d.ts +3 -0
- package/dist/bin/stdio.d.ts.map +1 -1
- package/dist/bin/stdio.js +10 -1
- package/dist/bin/stdio.js.map +1 -1
- package/dist/tools.d.ts +7 -0
- package/dist/tools.d.ts.map +1 -1
- package/dist/tools.js +69 -0
- package/dist/tools.js.map +1 -1
- package/package.json +8 -6
- package/src/bin/http.ts +6 -0
- package/src/bin/stdio.ts +10 -1
- package/src/tools.ts +103 -0
package/dist/bin/http.d.ts
CHANGED
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
* BUILDERFORCE_MEMORY_TOKEN Bearer token required on every request (recommended).
|
|
10
10
|
* BUILDERFORCE_MEMORY_DB IndexedDB database name.
|
|
11
11
|
* BUILDERFORCE_MEMORY_READONLY '1' to disable remember/forget tools.
|
|
12
|
+
* BUILDERFORCE_GATEWAY_URL Gateway base URL (default https://api.builderforce.ai).
|
|
13
|
+
* BUILDERFORCE_API_KEY `bfk_*` tenant key. When set, exposes the cost tools.
|
|
12
14
|
*/
|
|
13
15
|
export {};
|
|
14
16
|
//# sourceMappingURL=http.d.ts.map
|
package/dist/bin/http.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/bin/http.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/bin/http.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}
|
package/dist/bin/http.js
CHANGED
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
* BUILDERFORCE_MEMORY_TOKEN Bearer token required on every request (recommended).
|
|
10
10
|
* BUILDERFORCE_MEMORY_DB IndexedDB database name.
|
|
11
11
|
* BUILDERFORCE_MEMORY_READONLY '1' to disable remember/forget tools.
|
|
12
|
+
* BUILDERFORCE_GATEWAY_URL Gateway base URL (default https://api.builderforce.ai).
|
|
13
|
+
* BUILDERFORCE_API_KEY `bfk_*` tenant key. When set, exposes the cost tools.
|
|
12
14
|
*/
|
|
13
15
|
import http from "node:http";
|
|
14
16
|
import { createLocalMemoryStoreBackend } from "../backends/memory-store.js";
|
|
@@ -19,6 +21,10 @@ const backend = await createLocalMemoryStoreBackend({
|
|
|
19
21
|
const handler = createMemoryHttpHandler(backend, {
|
|
20
22
|
authToken: process.env["BUILDERFORCE_MEMORY_TOKEN"],
|
|
21
23
|
writable: process.env["BUILDERFORCE_MEMORY_READONLY"] !== "1",
|
|
24
|
+
// Optional gateway-backed cost tools (token_usage, model_efficiency). Only
|
|
25
|
+
// exposed when an API key is present; URL defaults to the public gateway.
|
|
26
|
+
gatewayUrl: process.env["BUILDERFORCE_GATEWAY_URL"] ?? "https://api.builderforce.ai",
|
|
27
|
+
gatewayApiKey: process.env["BUILDERFORCE_API_KEY"],
|
|
22
28
|
});
|
|
23
29
|
const port = Number(process.env["PORT"] ?? 8787);
|
|
24
30
|
http.createServer((req, res) => {
|
package/dist/bin/http.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/bin/http.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/bin/http.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC;IAChD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,OAAO,GAAG,uBAAuB,CAAC,OAAO,EAAE;IAC7C,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IACnD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,KAAK,GAAG;IAC7D,2EAA2E;IAC3E,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,6BAA6B;IACpF,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;AAEjD,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IAC3B,KAAK,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,IAAI,CAAC,GAAG,CAAC,WAAW;YAAE,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACjF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gDAAgD,IAAI,IAAI,CAAC,CAAC;AACnF,CAAC,CAAC,CAAC"}
|
package/dist/bin/stdio.d.ts
CHANGED
|
@@ -9,6 +9,9 @@
|
|
|
9
9
|
* persists across process restarts — REQUIRED for an
|
|
10
10
|
* MCP client that respawns this server each session
|
|
11
11
|
* (otherwise fake-indexeddb loses everything on exit).
|
|
12
|
+
* BUILDERFORCE_GATEWAY_URL Gateway base URL (default https://api.builderforce.ai).
|
|
13
|
+
* BUILDERFORCE_API_KEY `bfk_*` tenant key. When set, exposes the cost tools
|
|
14
|
+
* (token_usage, model_efficiency).
|
|
12
15
|
*
|
|
13
16
|
* Recall is lexical (Jaccard) here — this headless binary does not stand up the
|
|
14
17
|
* SSM runtime/GPU. For SSM-embedding recall, embed the package in-process and
|
package/dist/bin/stdio.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/bin/stdio.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/bin/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG"}
|
package/dist/bin/stdio.js
CHANGED
|
@@ -9,6 +9,9 @@
|
|
|
9
9
|
* persists across process restarts — REQUIRED for an
|
|
10
10
|
* MCP client that respawns this server each session
|
|
11
11
|
* (otherwise fake-indexeddb loses everything on exit).
|
|
12
|
+
* BUILDERFORCE_GATEWAY_URL Gateway base URL (default https://api.builderforce.ai).
|
|
13
|
+
* BUILDERFORCE_API_KEY `bfk_*` tenant key. When set, exposes the cost tools
|
|
14
|
+
* (token_usage, model_efficiency).
|
|
12
15
|
*
|
|
13
16
|
* Recall is lexical (Jaccard) here — this headless binary does not stand up the
|
|
14
17
|
* SSM runtime/GPU. For SSM-embedding recall, embed the package in-process and
|
|
@@ -20,5 +23,11 @@ const backend = await createLocalMemoryStoreBackend({
|
|
|
20
23
|
dbName: process.env["BUILDERFORCE_MEMORY_DB"],
|
|
21
24
|
persistFile: process.env["BUILDERFORCE_MEMORY_FILE"],
|
|
22
25
|
});
|
|
23
|
-
await runStdio(backend, {
|
|
26
|
+
await runStdio(backend, {
|
|
27
|
+
writable: process.env["BUILDERFORCE_MEMORY_READONLY"] !== "1",
|
|
28
|
+
// Optional gateway-backed cost tools (token_usage, model_efficiency). Only
|
|
29
|
+
// exposed when an API key is present; URL defaults to the public gateway.
|
|
30
|
+
gatewayUrl: process.env["BUILDERFORCE_GATEWAY_URL"] ?? "https://api.builderforce.ai",
|
|
31
|
+
gatewayApiKey: process.env["BUILDERFORCE_API_KEY"],
|
|
32
|
+
});
|
|
24
33
|
//# sourceMappingURL=stdio.js.map
|
package/dist/bin/stdio.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/bin/stdio.ts"],"names":[],"mappings":";AACA
|
|
1
|
+
{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/bin/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,OAAO,GAAG,MAAM,6BAA6B,CAAC;IAChD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IAC7C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,QAAQ,CAAC,OAAO,EAAE;IACpB,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,KAAK,GAAG;IAC7D,2EAA2E;IAC3E,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,6BAA6B;IACpF,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;CACrD,CAAC,CAAC"}
|
package/dist/tools.d.ts
CHANGED
|
@@ -38,6 +38,13 @@ export interface MemoryToolsOptions {
|
|
|
38
38
|
maxContentChars?: number;
|
|
39
39
|
/** Expose write tools (remember/forget). Default true; forced false if the backend is read-only. */
|
|
40
40
|
writable?: boolean;
|
|
41
|
+
/**
|
|
42
|
+
* BuilderForce gateway base URL (e.g. https://api.builderforce.ai). When set
|
|
43
|
+
* together with {@link gatewayApiKey}, the cost/efficiency tools are exposed.
|
|
44
|
+
*/
|
|
45
|
+
gatewayUrl?: string;
|
|
46
|
+
/** A `bfk_*` tenant API key. Required (with {@link gatewayUrl}) for cost tools. */
|
|
47
|
+
gatewayApiKey?: string;
|
|
41
48
|
}
|
|
42
49
|
/**
|
|
43
50
|
* Builds the memory tool set bound to `backend`. Write tools are included only
|
package/dist/tools.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,cAAc,CAAC;AAE7D,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,kBAAkB;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,cAAc,CAAC;AAE7D,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,kBAAkB;IAC/B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oGAAoG;IACpG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AA4BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,GAAE,kBAAuB,GAAG,UAAU,EAAE,CAkJpG"}
|
package/dist/tools.js
CHANGED
|
@@ -181,6 +181,75 @@ export function buildMemoryTools(backend, opts = {}) {
|
|
|
181
181
|
},
|
|
182
182
|
});
|
|
183
183
|
}
|
|
184
|
+
// Gateway-backed cost tools — only when BOTH a gateway URL and key are
|
|
185
|
+
// present, so memory-only deployments are unchanged.
|
|
186
|
+
if (opts.gatewayUrl && opts.gatewayApiKey) {
|
|
187
|
+
appendGatewayCostTools(tools, opts.gatewayUrl.replace(/\/+$/, ""), opts.gatewayApiKey);
|
|
188
|
+
}
|
|
184
189
|
return tools;
|
|
185
190
|
}
|
|
191
|
+
async function gatewayGet(gatewayUrl, path, apiKey) {
|
|
192
|
+
const res = await fetch(`${gatewayUrl}${path}`, {
|
|
193
|
+
headers: { authorization: `Bearer ${apiKey}` },
|
|
194
|
+
});
|
|
195
|
+
if (!res.ok)
|
|
196
|
+
throw new Error(`gateway ${path} → HTTP ${res.status}`);
|
|
197
|
+
return (await res.json());
|
|
198
|
+
}
|
|
199
|
+
function appendGatewayCostTools(tools, gatewayUrl, apiKey) {
|
|
200
|
+
tools.push({
|
|
201
|
+
name: "token_usage",
|
|
202
|
+
description: "Current token spend + budget for the workspace (today).",
|
|
203
|
+
inputSchema: {},
|
|
204
|
+
handler: async () => {
|
|
205
|
+
try {
|
|
206
|
+
const s = await gatewayGet(gatewayUrl, "/llm/v1/builder-insights", apiKey);
|
|
207
|
+
const lines = [
|
|
208
|
+
`Token usage (${s.windowLabel ?? "today"}):`,
|
|
209
|
+
`• Tokens: ${(s.todayTokens ?? 0).toLocaleString()}`,
|
|
210
|
+
`• Cost: $${(s.todayCostUsd ?? 0).toFixed(2)}`,
|
|
211
|
+
`• % of daily cap: ${s.pctOfDailyCap == null
|
|
212
|
+
? "no cap"
|
|
213
|
+
: `${s.pctOfDailyCap}%${s.dailyCapTokens ? ` of ${s.dailyCapTokens.toLocaleString()}` : ""}`}`,
|
|
214
|
+
`• Top model: ${s.topModel ? `${s.topModel.model} (${s.topModel.tokens.toLocaleString()} tok)` : "—"}`,
|
|
215
|
+
];
|
|
216
|
+
if (s.costPerMergedPrUsd != null)
|
|
217
|
+
lines.push(`• Cost / merged PR: $${s.costPerMergedPrUsd.toFixed(2)}`);
|
|
218
|
+
if (s.tip)
|
|
219
|
+
lines.push(`• Tip: ${s.tip}`);
|
|
220
|
+
return ok(lines.join("\n"));
|
|
221
|
+
}
|
|
222
|
+
catch (err) {
|
|
223
|
+
return fail(`token_usage failed: ${String(err)}`);
|
|
224
|
+
}
|
|
225
|
+
},
|
|
226
|
+
});
|
|
227
|
+
tools.push({
|
|
228
|
+
name: "model_efficiency",
|
|
229
|
+
description: "Which models performed best/cheapest for this workspace's recent work.",
|
|
230
|
+
inputSchema: {},
|
|
231
|
+
handler: async () => {
|
|
232
|
+
try {
|
|
233
|
+
const a = await gatewayGet(gatewayUrl, "/llm/v1/model-analytics", apiKey);
|
|
234
|
+
const groups = a.byAction ?? [];
|
|
235
|
+
if (groups.length === 0)
|
|
236
|
+
return ok("No model efficiency data yet for this workspace.");
|
|
237
|
+
const out = ["Model efficiency by action type (best first):"];
|
|
238
|
+
for (const g of groups) {
|
|
239
|
+
out.push(`\n${g.label ?? g.actionType ?? "action"}:`);
|
|
240
|
+
for (const m of (g.models ?? []).slice(0, 3)) {
|
|
241
|
+
const cost = m.avgCostMillicents != null ? ` $${(m.avgCostMillicents / 100_000).toFixed(4)}/call` : "";
|
|
242
|
+
const merge = m.mergeRate != null ? ` merge=${Math.round(m.mergeRate * 100)}%` : "";
|
|
243
|
+
const score = m.avgScore != null ? ` score=${m.avgScore}` : "";
|
|
244
|
+
out.push(` • ${m.model}${score}${merge}${cost} (n=${m.samples ?? 0})`);
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
return ok(out.join("\n"));
|
|
248
|
+
}
|
|
249
|
+
catch (err) {
|
|
250
|
+
return fail(`model_efficiency failed: ${String(err)}`);
|
|
251
|
+
}
|
|
252
|
+
},
|
|
253
|
+
});
|
|
254
|
+
}
|
|
186
255
|
//# sourceMappingURL=tools.js.map
|
package/dist/tools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@seanhogg/builderforce-memory-mcp",
|
|
3
|
-
"version": "2026.6.
|
|
3
|
+
"version": "2026.6.30",
|
|
4
4
|
"description": "BuilderForce Agent Memory — MCP transport. Exposes @seanhogg/builderforce-memory to any MCP client (Claude Agent SDK in-process, stdio, or HTTP) over a pluggable MemoryBackend, with token-saving fetch-on-demand recall.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
},
|
|
51
51
|
"peerDependencies": {
|
|
52
52
|
"@anthropic-ai/claude-agent-sdk": ">=0.1.0",
|
|
53
|
-
"@seanhogg/builderforce-memory": "^2026.6.
|
|
53
|
+
"@seanhogg/builderforce-memory": "^2026.6.29",
|
|
54
54
|
"fake-indexeddb": "^6.0.0"
|
|
55
55
|
},
|
|
56
56
|
"peerDependenciesMeta": {
|
|
@@ -71,8 +71,9 @@
|
|
|
71
71
|
"@typescript-eslint/parser": "^7.0.0",
|
|
72
72
|
"eslint": "^8.57.0",
|
|
73
73
|
"fake-indexeddb": "^6.0.0",
|
|
74
|
-
"typescript": "^
|
|
75
|
-
"@
|
|
74
|
+
"typescript": "^6.0.3",
|
|
75
|
+
"@typescript/native-preview": "7.0.0-dev.20260627.2",
|
|
76
|
+
"@seanhogg/builderforce-memory": "2026.6.30"
|
|
76
77
|
},
|
|
77
78
|
"engines": {
|
|
78
79
|
"node": ">=18.0.0"
|
|
@@ -82,7 +83,8 @@
|
|
|
82
83
|
},
|
|
83
84
|
"scripts": {
|
|
84
85
|
"build": "tsc",
|
|
85
|
-
"test": "tsc && node --test tests/install.test.mjs",
|
|
86
|
-
"lint": "eslint src/"
|
|
86
|
+
"test": "tsc && node --test tests/install.test.mjs tests/tools.test.mjs",
|
|
87
|
+
"lint": "eslint src/",
|
|
88
|
+
"typecheck:native": "tsgo --noEmit"
|
|
87
89
|
}
|
|
88
90
|
}
|
package/src/bin/http.ts
CHANGED
|
@@ -9,6 +9,8 @@
|
|
|
9
9
|
* BUILDERFORCE_MEMORY_TOKEN Bearer token required on every request (recommended).
|
|
10
10
|
* BUILDERFORCE_MEMORY_DB IndexedDB database name.
|
|
11
11
|
* BUILDERFORCE_MEMORY_READONLY '1' to disable remember/forget tools.
|
|
12
|
+
* BUILDERFORCE_GATEWAY_URL Gateway base URL (default https://api.builderforce.ai).
|
|
13
|
+
* BUILDERFORCE_API_KEY `bfk_*` tenant key. When set, exposes the cost tools.
|
|
12
14
|
*/
|
|
13
15
|
|
|
14
16
|
import http from "node:http";
|
|
@@ -22,6 +24,10 @@ const backend = await createLocalMemoryStoreBackend({
|
|
|
22
24
|
const handler = createMemoryHttpHandler(backend, {
|
|
23
25
|
authToken: process.env["BUILDERFORCE_MEMORY_TOKEN"],
|
|
24
26
|
writable: process.env["BUILDERFORCE_MEMORY_READONLY"] !== "1",
|
|
27
|
+
// Optional gateway-backed cost tools (token_usage, model_efficiency). Only
|
|
28
|
+
// exposed when an API key is present; URL defaults to the public gateway.
|
|
29
|
+
gatewayUrl: process.env["BUILDERFORCE_GATEWAY_URL"] ?? "https://api.builderforce.ai",
|
|
30
|
+
gatewayApiKey: process.env["BUILDERFORCE_API_KEY"],
|
|
25
31
|
});
|
|
26
32
|
|
|
27
33
|
const port = Number(process.env["PORT"] ?? 8787);
|
package/src/bin/stdio.ts
CHANGED
|
@@ -9,6 +9,9 @@
|
|
|
9
9
|
* persists across process restarts — REQUIRED for an
|
|
10
10
|
* MCP client that respawns this server each session
|
|
11
11
|
* (otherwise fake-indexeddb loses everything on exit).
|
|
12
|
+
* BUILDERFORCE_GATEWAY_URL Gateway base URL (default https://api.builderforce.ai).
|
|
13
|
+
* BUILDERFORCE_API_KEY `bfk_*` tenant key. When set, exposes the cost tools
|
|
14
|
+
* (token_usage, model_efficiency).
|
|
12
15
|
*
|
|
13
16
|
* Recall is lexical (Jaccard) here — this headless binary does not stand up the
|
|
14
17
|
* SSM runtime/GPU. For SSM-embedding recall, embed the package in-process and
|
|
@@ -23,4 +26,10 @@ const backend = await createLocalMemoryStoreBackend({
|
|
|
23
26
|
persistFile: process.env["BUILDERFORCE_MEMORY_FILE"],
|
|
24
27
|
});
|
|
25
28
|
|
|
26
|
-
await runStdio(backend, {
|
|
29
|
+
await runStdio(backend, {
|
|
30
|
+
writable: process.env["BUILDERFORCE_MEMORY_READONLY"] !== "1",
|
|
31
|
+
// Optional gateway-backed cost tools (token_usage, model_efficiency). Only
|
|
32
|
+
// exposed when an API key is present; URL defaults to the public gateway.
|
|
33
|
+
gatewayUrl: process.env["BUILDERFORCE_GATEWAY_URL"] ?? "https://api.builderforce.ai",
|
|
34
|
+
gatewayApiKey: process.env["BUILDERFORCE_API_KEY"],
|
|
35
|
+
});
|
package/src/tools.ts
CHANGED
|
@@ -39,6 +39,13 @@ export interface MemoryToolsOptions {
|
|
|
39
39
|
maxContentChars?: number;
|
|
40
40
|
/** Expose write tools (remember/forget). Default true; forced false if the backend is read-only. */
|
|
41
41
|
writable?: boolean;
|
|
42
|
+
/**
|
|
43
|
+
* BuilderForce gateway base URL (e.g. https://api.builderforce.ai). When set
|
|
44
|
+
* together with {@link gatewayApiKey}, the cost/efficiency tools are exposed.
|
|
45
|
+
*/
|
|
46
|
+
gatewayUrl?: string;
|
|
47
|
+
/** A `bfk_*` tenant API key. Required (with {@link gatewayUrl}) for cost tools. */
|
|
48
|
+
gatewayApiKey?: string;
|
|
42
49
|
}
|
|
43
50
|
|
|
44
51
|
const DEFAULT_MAX_RESULTS = 5;
|
|
@@ -210,5 +217,101 @@ export function buildMemoryTools(backend: MemoryBackend, opts: MemoryToolsOption
|
|
|
210
217
|
});
|
|
211
218
|
}
|
|
212
219
|
|
|
220
|
+
// Gateway-backed cost tools — only when BOTH a gateway URL and key are
|
|
221
|
+
// present, so memory-only deployments are unchanged.
|
|
222
|
+
if (opts.gatewayUrl && opts.gatewayApiKey) {
|
|
223
|
+
appendGatewayCostTools(tools, opts.gatewayUrl.replace(/\/+$/, ""), opts.gatewayApiKey);
|
|
224
|
+
}
|
|
225
|
+
|
|
213
226
|
return tools;
|
|
214
227
|
}
|
|
228
|
+
|
|
229
|
+
/** Snapshot shape returned by GET /llm/v1/builder-insights. */
|
|
230
|
+
interface BuilderInsightsSnapshot {
|
|
231
|
+
windowLabel?: string;
|
|
232
|
+
todayTokens?: number;
|
|
233
|
+
todayCostUsd?: number;
|
|
234
|
+
dailyCapTokens?: number | null;
|
|
235
|
+
pctOfDailyCap?: number | null;
|
|
236
|
+
topModel?: { model: string; tokens: number } | null;
|
|
237
|
+
costPerMergedPrUsd?: number | null;
|
|
238
|
+
tip?: string | null;
|
|
239
|
+
}
|
|
240
|
+
|
|
241
|
+
/** Ranking shape returned by GET /llm/v1/model-analytics. */
|
|
242
|
+
interface ModelAnalytics {
|
|
243
|
+
byAction?: Array<{
|
|
244
|
+
actionType?: string;
|
|
245
|
+
label?: string;
|
|
246
|
+
models?: Array<{
|
|
247
|
+
model: string;
|
|
248
|
+
samples?: number;
|
|
249
|
+
avgScore?: number;
|
|
250
|
+
mergeRate?: number;
|
|
251
|
+
avgCostMillicents?: number;
|
|
252
|
+
}>;
|
|
253
|
+
}>;
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
async function gatewayGet<T>(gatewayUrl: string, path: string, apiKey: string): Promise<T> {
|
|
257
|
+
const res = await fetch(`${gatewayUrl}${path}`, {
|
|
258
|
+
headers: { authorization: `Bearer ${apiKey}` },
|
|
259
|
+
});
|
|
260
|
+
if (!res.ok) throw new Error(`gateway ${path} → HTTP ${res.status}`);
|
|
261
|
+
return (await res.json()) as T;
|
|
262
|
+
}
|
|
263
|
+
|
|
264
|
+
function appendGatewayCostTools(tools: MemoryTool[], gatewayUrl: string, apiKey: string): void {
|
|
265
|
+
tools.push({
|
|
266
|
+
name: "token_usage",
|
|
267
|
+
description: "Current token spend + budget for the workspace (today).",
|
|
268
|
+
inputSchema: {},
|
|
269
|
+
handler: async () => {
|
|
270
|
+
try {
|
|
271
|
+
const s = await gatewayGet<BuilderInsightsSnapshot>(gatewayUrl, "/llm/v1/builder-insights", apiKey);
|
|
272
|
+
const lines = [
|
|
273
|
+
`Token usage (${s.windowLabel ?? "today"}):`,
|
|
274
|
+
`• Tokens: ${(s.todayTokens ?? 0).toLocaleString()}`,
|
|
275
|
+
`• Cost: $${(s.todayCostUsd ?? 0).toFixed(2)}`,
|
|
276
|
+
`• % of daily cap: ${
|
|
277
|
+
s.pctOfDailyCap == null
|
|
278
|
+
? "no cap"
|
|
279
|
+
: `${s.pctOfDailyCap}%${s.dailyCapTokens ? ` of ${s.dailyCapTokens.toLocaleString()}` : ""}`
|
|
280
|
+
}`,
|
|
281
|
+
`• Top model: ${s.topModel ? `${s.topModel.model} (${s.topModel.tokens.toLocaleString()} tok)` : "—"}`,
|
|
282
|
+
];
|
|
283
|
+
if (s.costPerMergedPrUsd != null) lines.push(`• Cost / merged PR: $${s.costPerMergedPrUsd.toFixed(2)}`);
|
|
284
|
+
if (s.tip) lines.push(`• Tip: ${s.tip}`);
|
|
285
|
+
return ok(lines.join("\n"));
|
|
286
|
+
} catch (err) {
|
|
287
|
+
return fail(`token_usage failed: ${String(err)}`);
|
|
288
|
+
}
|
|
289
|
+
},
|
|
290
|
+
});
|
|
291
|
+
|
|
292
|
+
tools.push({
|
|
293
|
+
name: "model_efficiency",
|
|
294
|
+
description: "Which models performed best/cheapest for this workspace's recent work.",
|
|
295
|
+
inputSchema: {},
|
|
296
|
+
handler: async () => {
|
|
297
|
+
try {
|
|
298
|
+
const a = await gatewayGet<ModelAnalytics>(gatewayUrl, "/llm/v1/model-analytics", apiKey);
|
|
299
|
+
const groups = a.byAction ?? [];
|
|
300
|
+
if (groups.length === 0) return ok("No model efficiency data yet for this workspace.");
|
|
301
|
+
const out: string[] = ["Model efficiency by action type (best first):"];
|
|
302
|
+
for (const g of groups) {
|
|
303
|
+
out.push(`\n${g.label ?? g.actionType ?? "action"}:`);
|
|
304
|
+
for (const m of (g.models ?? []).slice(0, 3)) {
|
|
305
|
+
const cost = m.avgCostMillicents != null ? ` $${(m.avgCostMillicents / 100_000).toFixed(4)}/call` : "";
|
|
306
|
+
const merge = m.mergeRate != null ? ` merge=${Math.round(m.mergeRate * 100)}%` : "";
|
|
307
|
+
const score = m.avgScore != null ? ` score=${m.avgScore}` : "";
|
|
308
|
+
out.push(` • ${m.model}${score}${merge}${cost} (n=${m.samples ?? 0})`);
|
|
309
|
+
}
|
|
310
|
+
}
|
|
311
|
+
return ok(out.join("\n"));
|
|
312
|
+
} catch (err) {
|
|
313
|
+
return fail(`model_efficiency failed: ${String(err)}`);
|
|
314
|
+
}
|
|
315
|
+
},
|
|
316
|
+
});
|
|
317
|
+
}
|