@ryanstark24/sfgraph-server 1.1.0

package/dist/context.js

@@ -0,0 +1,202 @@
+import { existsSync, readdirSync } from "node:fs";
+import path from "node:path";
+import { loadBetterSqlite3 } from "@ryanstark24/sfgraph-core";
+import { ErrorCode, SfgraphError, asOrgId, getSfgraphPaths, safeOrgDbPath, validateOrgIdentifier, } from "@ryanstark24/sfgraph-shared";
+let factory = null;
+/**
+ * Per-orgId cache so we reuse stores across tool calls. Bounded to
+ * `CONTEXT_CACHE_MAX` entries — when full, the oldest entry is evicted
+ * and its store is closed. Prevents unbounded file-handle / memory growth
+ * when an agent rotates through many orgs.
+ */
+const CONTEXT_CACHE_MAX = 8;
+const contextCache = new Map();
+/**
+ * Salesforce Organization IDs start with the `00D` key-prefix and are
+ * 15 or 18 chars total. We use this regex (rather than naked string length)
+ * to decide whether a user-supplied identifier is an orgId or an alias —
+ * a 15/18-char alias would otherwise be misclassified.
+ */
+const SF_ORG_ID_RE = /^00D[A-Za-z0-9]{12}([A-Za-z0-9]{3})?$/;
+function isSalesforceOrgId(s) {
+    return SF_ORG_ID_RE.test(s);
+}
+async function closeStoreQuietly(ctx) {
+    try {
+        await ctx.graphStore.close?.();
+    }
+    catch {
+        // best-effort
+    }
+}
+function rememberInCache(key, ctx) {
+    // Evict oldest if full. Map preserves insertion order so the first key is
+    // the oldest. fire-and-forget close — eviction must be synchronous w.r.t.
+    // the cache state.
+    while (contextCache.size >= CONTEXT_CACHE_MAX) {
+        const oldestKey = contextCache.keys().next().value;
+        if (oldestKey === undefined)
+            break;
+        const oldest = contextCache.get(oldestKey);
+        contextCache.delete(oldestKey);
+        if (oldest)
+            void closeStoreQuietly(oldest);
+    }
+    contextCache.set(key, ctx);
+}
+export function setToolContextFactory(fn) {
+    factory = fn;
+    // Tests swap factories — clear cache so they don't see stale stores.
+    contextCache.clear();
+}
+/**
+ * Resolve a `ToolContext` for the given org. Validates the identifier,
+ * caches the result by canonical orgId so repeated tool calls reuse the
+ * same open stores instead of opening fresh handles each time.
+ */
+export async function getToolContext(opts = {}) {
+    if (!factory) {
+        factory = defaultFactory;
+    }
+    const rawKey = opts.orgId ?? "default";
+    // Always validate the user-supplied identifier at the entry point — even
+    // when a test factory is installed — so security checks aren't bypassed.
+    validateOrgIdentifier(rawKey);
+    const cached = contextCache.get(rawKey);
+    if (cached)
+        return cached;
+    const ctx = await factory(opts);
+    // Cache by the raw key so repeated calls with the same alias / id reuse
+    // the same store. The factory's own canonical-orgId resolution is still
+    // applied inside ctx.orgId.
+    rememberInCache(rawKey, ctx);
+    return ctx;
+}
+/**
+ * Close every cached store and clear the cache. Wired into shutdown handlers
+ * so file handles aren't leaked when the MCP server exits. Idempotent.
+ */
+export async function closeAllContexts() {
+    const entries = [...contextCache.values()];
+    contextCache.clear();
+    for (const ctx of entries) {
+        await closeStoreQuietly(ctx);
+    }
+}
+/** Exposed for tests so they can assert the cache bound. */
+export function _contextCacheSize() {
+    return contextCache.size;
+}
+/**
+ * Resolve an alias to the canonical orgId by scanning local `<orgId>.sqlite`
+ * files for an `_sfgraph_orgs` row with `alias = ?`. Returns the orgId if
+ * found, else `null`. Doing this BEFORE we build the DB path keeps the
+ * on-disk file keyed by orgId (not by the user-supplied alias).
+ */
+async function resolveAliasToOrgId(dataDir, alias) {
+    if (!existsSync(dataDir))
+        return null;
+    let files = [];
+    try {
+        files = readdirSync(dataDir).filter((f) => f.endsWith(".sqlite") && !f.startsWith("backups"));
+    }
+    catch {
+        return null;
+    }
+    const { createRequire } = await import("node:module");
+    const nodeRequire = createRequire(import.meta.url);
+    let Database;
+    try {
+        Database = loadBetterSqlite3(nodeRequire);
+    }
+    catch {
+        return null;
+    }
+    const Ctor = Database;
+    for (const f of files) {
+        const candidate = f.replace(/\.sqlite$/, "");
+        if (!isSalesforceOrgId(candidate)) {
+            continue; // skip files whose name isn't a real orgId
+        }
+        const dbPath = path.join(dataDir, f);
+        try {
+            const db = new Ctor(dbPath, { readonly: true, fileMustExist: true });
+            try {
+                const row = db.prepare("SELECT id FROM _sfgraph_orgs WHERE alias = ?").get(alias);
+                if (row?.id)
+                    return row.id;
+            }
+            finally {
+                db.close();
+            }
+        }
+        catch {
+            // ignore unreadable / non-sfgraph dbs
+        }
+    }
+    return null;
+}
+/**
+ * Try to resolve an alias to an orgId via the `sf` CLI's authenticated
+ * orgs. Used as a fallback so a freshly-authenticated alias that has never
+ * been ingested still works without silently creating an empty DB keyed by
+ * the alias string.
+ */
+async function resolveAliasViaSfCli(alias) {
+    try {
+        const core = await import("@ryanstark24/sfgraph-core");
+        const resolved = await core.resolveOrg(alias);
+        if (resolved?.orgId && isSalesforceOrgId(String(resolved.orgId))) {
+            return String(resolved.orgId);
+        }
+    }
+    catch {
+        /* alias not known to sf CLI */
+    }
+    return null;
+}
+async function defaultFactory(opts) {
+    const orgIdOrAlias = opts.orgId ?? "default";
+    // Hard-fail on malformed input BEFORE any path joinery.
+    validateOrgIdentifier(orgIdOrAlias);
+    const paths = getSfgraphPaths();
+    // Resolve alias -> orgId up-front so the on-disk file is always
+    // <dataDir>/<orgId>.sqlite, not <dataDir>/<alias>.sqlite.
+    let resolvedOrgId = orgIdOrAlias;
+    if (isSalesforceOrgId(orgIdOrAlias)) {
+        resolvedOrgId = orgIdOrAlias;
+    }
+    else {
+        const fromLocal = await resolveAliasToOrgId(paths.data, orgIdOrAlias);
+        if (fromLocal) {
+            validateOrgIdentifier(fromLocal);
+            resolvedOrgId = fromLocal;
+        }
+        else {
+            const fromSf = await resolveAliasViaSfCli(orgIdOrAlias);
+            if (fromSf) {
+                validateOrgIdentifier(fromSf);
+                resolvedOrgId = fromSf;
+            }
+            else {
+                // Unknown alias: no existing ingested DB and no sf-CLI binding. Reject
+                // rather than silently creating an empty `<alias>.sqlite`.
+                throw new SfgraphError(ErrorCode.E_INVALID_ORG_IDENTIFIER, `unknown org identifier '${orgIdOrAlias}': not a Salesforce 15/18-char orgId, no existing sfgraph DB has this alias, and the sf CLI does not recognise it. Run 'sf org login web --alias ${orgIdOrAlias}' and then 'sfgraph ingest --org ${orgIdOrAlias}' first.`);
+            }
+        }
+    }
+    const dbPath = safeOrgDbPath(paths.data, resolvedOrgId);
+    const { SqliteGraphStore, SqliteSnapshotStore } = await import("@ryanstark24/sfgraph-core");
+    const graphStore = new SqliteGraphStore({ dbPath });
+    await graphStore.init();
+    const snapshotStore = new SqliteSnapshotStore({
+        dbPath,
+        db: graphStore.db,
+        skipMigrations: true,
+    });
+    await snapshotStore.init();
+    const db = graphStore.db;
+    const ctx = { graphStore, snapshotStore, orgId: asOrgId(resolvedOrgId), db };
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { SfgraphMcpServer } from "./server.js";
+export { ToolRegistry } from "./tool-registry.js";
+export type { ToolHandler, ToolSchema, RegisteredTool } from "./tool-registry.js";
+export { installShutdownHandlers } from "./shutdown.js";
+export type { ShutdownOpts, Disposer } from "./shutdown.js";
+export { pingTool } from "./tools/ping.js";
+export { runMcpServer } from "./bin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { SfgraphMcpServer } from "./server.js";
+export { ToolRegistry } from "./tool-registry.js";
+export { installShutdownHandlers } from "./shutdown.js";
+export { pingTool } from "./tools/ping.js";
+export { runMcpServer } from "./bin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,31 @@
+import { ToolRegistry } from "./tool-registry.js";
+export interface SfgraphMcpServerOpts {
+    registry?: ToolRegistry;
+}
+export declare class SfgraphMcpServer {
+    readonly registry: ToolRegistry;
+    constructor(opts?: SfgraphMcpServerOpts);
+    registerDefaults(): void;
+    /**
+     * Side-effect import every tool module so they register on defaultRegistry,
+     * then copy missing tools into this.registry.
+     */
+    loadAllTools(): Promise<void>;
+    /**
+     * Start the stdio MCP server. Lazy-imports the SDK so tests/CLI work without
+     * forcing the SDK load when not needed.
+     */
+    startStdio(): Promise<void>;
+    /**
+     * Public dispatcher used by stdio handler and tests. Returns MCP-shape response.
+     */
+    dispatch(name: string, args: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+        isError?: boolean;
+        _meta?: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,oBAAoB,CAAC;AAGnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;gBAEpB,IAAI,GAAE,oBAAyB;IAI3C,gBAAgB,IAAI,IAAI;IAMxB;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IASnC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BjC;;OAEG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;CAoCH"}

package/dist/server.js

@@ -0,0 +1,91 @@
+import { ToolRegistry, defaultRegistry } from "./tool-registry.js";
+import { pingTool } from "./tools/ping.js";
+export class SfgraphMcpServer {
+    registry;
+    constructor(opts = {}) {
+        this.registry = opts.registry ?? new ToolRegistry();
+    }
+    registerDefaults() {
+        if (!this.registry.get("ping")) {
+            this.registry.register(pingTool.name, pingTool.handler, pingTool.schema);
+        }
+    }
+    /**
+     * Side-effect import every tool module so they register on defaultRegistry,
+     * then copy missing tools into this.registry.
+     */
+    async loadAllTools() {
+        await import("./tools/index.js");
+        for (const t of defaultRegistry.list()) {
+            if (!this.registry.get(t.name)) {
+                this.registry.register(t.name, t.handler, t.schema);
+            }
+        }
+    }
+    /**
+     * Start the stdio MCP server. Lazy-imports the SDK so tests/CLI work without
+     * forcing the SDK load when not needed.
+     */
+    async startStdio() {
+        await this.loadAllTools();
+        const sdk = await import("@modelcontextprotocol/sdk/server/index.js");
+        const stdioMod = await import("@modelcontextprotocol/sdk/server/stdio.js");
+        const typesMod = await import("@modelcontextprotocol/sdk/types.js");
+        const server = new sdk.Server({ name: "sfgraph", version: "0.0.0" }, { capabilities: { tools: {} } });
+        server.setRequestHandler(typesMod.ListToolsRequestSchema, async () => ({
+            tools: this.registry.list().map((t) => ({
+                name: t.name,
+                description: t.schema.description,
+                inputSchema: t.schema.inputSchema ?? { type: "object" },
+            })),
+        }));
+        server.setRequestHandler(typesMod.CallToolRequestSchema, async (req) => {
+            const params = req
+                .params;
+            return this.dispatch(params.name, params.arguments ?? {});
+        });
+        const transport = new stdioMod.StdioServerTransport();
+        await server.connect(transport);
+    }
+    /**
+     * Public dispatcher used by stdio handler and tests. Returns MCP-shape response.
+     */
+    async dispatch(name, args) {
+        const tool = this.registry.get(name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `unknown tool ${name}` }],
+                isError: true,
+                _meta: { code: "UNKNOWN_TOOL" },
+            };
+        }
+        try {
+            const result = (await tool.handler(args));
+            const text = typeof result.markdown === "string" ? result.markdown : JSON.stringify(result);
+            return {
+                content: [{ type: "text", text }],
+                _meta: {
+                    summary: result.summary,
+                    data: result.data,
+                    follow_up_tools: result.follow_up_tools,
+                },
+            };
+        }
+        catch (err) {
+            const e = err;
+            if (e?.name === "ZodError") {
+                return {
+                    content: [{ type: "text", text: `invalid input: ${JSON.stringify(e.issues)}` }],
+                    isError: true,
+                    _meta: { code: "INVALID_INPUT", issues: e.issues },
+                };
+            }
+            return {
+                content: [{ type: "text", text: `error: ${e?.message ?? String(err)}` }],
+                isError: true,
+                _meta: { code: "TOOL_ERROR" },
+            };
+        }
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/shutdown.d.ts

@@ -0,0 +1,10 @@
+export interface ShutdownOpts {
+    onShutdown: () => Promise<void> | void;
+    watchdogMs?: number;
+    signalEmitter?: NodeJS.EventEmitter;
+    stdinEmitter?: NodeJS.EventEmitter;
+    exit?: (code: number) => void;
+}
+export type Disposer = () => void;
+export declare function installShutdownHandlers(opts: ShutdownOpts): Disposer;
+//# sourceMappingURL=shutdown.d.ts.map

package/dist/shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,QAAQ,CA+CpE"}

package/dist/shutdown.js

@@ -0,0 +1,43 @@
+export function installShutdownHandlers(opts) {
+    const { onShutdown, watchdogMs = 3000, signalEmitter = process, stdinEmitter = process.stdin, exit = (code) => process.exit(code), } = opts;
+    let fired = false;
+    let watchdog;
+    const trigger = (_reason) => {
+        if (fired)
+            return;
+        fired = true;
+        watchdog = setTimeout(() => exit(1), watchdogMs);
+        // Don't keep event loop alive solely for the watchdog
+        if (typeof watchdog.unref === "function")
+            watchdog.unref();
+        Promise.resolve()
+            .then(() => onShutdown())
+            .catch(() => { })
+            .finally(() => {
+            if (watchdog)
+                clearTimeout(watchdog);
+            // Force exit after a brief tick so the stdio MCP transport can flush
+            // any final response and pending console writes can drain. Without
+            // this, a lingering jsforce HTTP agent or sqlite handle could keep
+            // the loop alive — user has to ^C twice to actually quit.
+            setTimeout(() => exit(0), 50).unref();
+        });
+    };
+    const onSigint = () => trigger("SIGINT");
+    const onSigterm = () => trigger("SIGTERM");
+    const onStdinEnd = () => trigger("stdin-end");
+    const onStdinClose = () => trigger("stdin-close");
+    signalEmitter.on("SIGINT", onSigint);
+    signalEmitter.on("SIGTERM", onSigterm);
+    stdinEmitter.on("end", onStdinEnd);
+    stdinEmitter.on("close", onStdinClose);
+    return () => {
+        signalEmitter.off("SIGINT", onSigint);
+        signalEmitter.off("SIGTERM", onSigterm);
+        stdinEmitter.off("end", onStdinEnd);
+        stdinEmitter.off("close", onStdinClose);
+        if (watchdog)
+            clearTimeout(watchdog);
+    };
+}
+//# sourceMappingURL=shutdown.js.map

package/dist/shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.js","sourceRoot":"","sources":["../src/shutdown.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,uBAAuB,CAAC,IAAkB;IACxD,MAAM,EACJ,UAAU,EACV,UAAU,GAAG,IAAI,EACjB,aAAa,GAAG,OAAO,EACvB,YAAY,GAAG,OAAO,CAAC,KAAK,EAC5B,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GACpC,GAAG,IAAI,CAAC;IACT,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,QAAoC,CAAC;IAEzC,MAAM,OAAO,GAAG,CAAC,OAAe,EAAQ,EAAE;QACxC,IAAI,KAAK;YAAE,OAAO;QAClB,KAAK,GAAG,IAAI,CAAC;QACb,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACjD,sDAAsD;QACtD,IAAI,OAAQ,QAAgB,CAAC,KAAK,KAAK,UAAU;YAAG,QAAgB,CAAC,KAAK,EAAE,CAAC;QAC7E,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC;aACxB,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aACf,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,QAAQ;gBAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;YACrC,qEAAqE;YACrE,mEAAmE;YACnE,mEAAmE;YACnE,0DAA0D;YAC1D,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,GAAS,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,GAAS,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IAExD,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEvC,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACtC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACxC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACpC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACxC,IAAI,QAAQ;YAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC;AACJ,CAAC"}

package/dist/tool-registry.d.ts

@@ -0,0 +1,31 @@
+export interface ToolHandlerResult {
+    [key: string]: unknown;
+}
+export type ToolHandler = (input: Record<string, unknown>) => Promise<ToolHandlerResult>;
+export interface ToolSchema {
+    description: string;
+    inputSchema?: Record<string, unknown>;
+}
+export interface RegisteredTool {
+    name: string;
+    handler: ToolHandler;
+    schema: ToolSchema;
+}
+export declare class ToolRegistry {
+    private readonly tools;
+    register(name: string, handler: ToolHandler, schema: ToolSchema): void;
+    get(name: string): RegisteredTool | undefined;
+    list(): RegisteredTool[];
+    clear(): void;
+}
+/**
+ * Global default registry. `defineTool` registers here on side-effect import.
+ */
+export declare const defaultRegistry: ToolRegistry;
+export declare function registerTool(spec: {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    execute: ToolHandler;
+}): void;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEzF,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAOtE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,IAAI,IAAI,cAAc,EAAE;IAIxB,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,cAAqB,CAAC;AAElD,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,WAAW,CAAC;CACtB,GAAG,IAAI,CAKP"}

package/dist/tool-registry.js

@@ -0,0 +1,29 @@
+export class ToolRegistry {
+    tools = new Map();
+    register(name, handler, schema) {
+        if (this.tools.has(name)) {
+            throw new Error(`tool '${name}' already registered`);
+        }
+        this.tools.set(name, { name, handler, schema });
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Array.from(this.tools.values());
+    }
+    clear() {
+        this.tools.clear();
+    }
+}
+/**
+ * Global default registry. `defineTool` registers here on side-effect import.
+ */
+export const defaultRegistry = new ToolRegistry();
+export function registerTool(spec) {
+    defaultRegistry.register(spec.name, spec.execute, {
+        description: spec.description,
+        inputSchema: spec.inputSchema,
+    });
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE3D,QAAQ,CAAC,IAAY,EAAE,OAAoB,EAAE,MAAkB;QAC7D,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,sBAAsB,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,YAAY,EAAE,CAAC;AAElD,MAAM,UAAU,YAAY,CAAC,IAK5B;IACC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;QAChD,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/__tests__/_fixture.d.ts

@@ -0,0 +1,29 @@
+import { REL_TYPES } from "@ryanstark24/sfgraph-core";
+import { type OrgId } from "@ryanstark24/sfgraph-shared";
+import { type ToolContext } from "../../context.js";
+export interface Fixture {
+    ctx: ToolContext;
+    orgId: OrgId;
+    workDir: string;
+    addNode: (n: {
+        qualifiedName: string;
+        label: string;
+        attributes?: Record<string, unknown>;
+        sourceHash?: string;
+        firstSeenAt?: number;
+        lastSeenAt?: number;
+        lastModifiedAt?: number;
+    }) => void;
+    addEdge: (e: {
+        srcQualifiedName: string;
+        dstQualifiedName: string;
+        relType: string;
+        attributes?: Record<string, unknown>;
+        firstSeenAt?: number;
+        lastSeenAt?: number;
+    }) => void;
+    cleanup: () => Promise<void>;
+}
+export declare function createFixture(orgIdStr?: string): Promise<Fixture>;
+export { REL_TYPES };
+//# sourceMappingURL=_fixture.d.ts.map

package/dist/tools/__tests__/_fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_fixture.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/_fixture.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,SAAS,EAGV,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,KAAK,KAAK,EAAsC,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,KAAK,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,WAAW,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,CAAC,EAAE;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,KAAK,IAAI,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,EAAE;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,KAAK,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,wBAAsB,aAAa,CAAC,QAAQ,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAoDvE;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/tools/__tests__/_fixture.js

@@ -0,0 +1,59 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { REL_TYPES, SqliteGraphStore, SqliteSnapshotStore, } from "@ryanstark24/sfgraph-core";
+import { asOrgId, asQualifiedName, asSha256 } from "@ryanstark24/sfgraph-shared";
+import { setToolContextFactory } from "../../context.js";
+export async function createFixture(orgIdStr = "org1") {
+    const workDir = mkdtempSync(path.join(tmpdir(), "sfg-tool-"));
+    const dbPath = path.join(workDir, "g.sqlite");
+    const graphStore = new SqliteGraphStore({ dbPath, backupDir: path.join(workDir, "bkp") });
+    await graphStore.init();
+    const snapshotStore = new SqliteSnapshotStore({
+        dbPath,
+        db: graphStore.db,
+        skipMigrations: true,
+    });
+    await snapshotStore.init();
+    const orgId = asOrgId(orgIdStr);
+    const ctx = { graphStore, snapshotStore, orgId };
+    setToolContextFactory(async () => ctx);
+    const fix = {
+        ctx,
+        orgId,
+        workDir,
+        addNode(n) {
+            const fact = {
+                orgId,
+                qualifiedName: asQualifiedName(n.qualifiedName),
+                label: n.label,
+                attributes: n.attributes ?? {},
+                sourceHash: asSha256(n.sourceHash ?? `h-${n.qualifiedName}`),
+                firstSeenAt: n.firstSeenAt ?? 1,
+                lastSeenAt: n.lastSeenAt ?? 1,
+                lastModifiedAt: n.lastModifiedAt ?? Date.now(),
+            };
+            graphStore.mergeNodes([fact]);
+        },
+        addEdge(e) {
+            const fact = {
+                orgId,
+                srcQualifiedName: asQualifiedName(e.srcQualifiedName),
+                dstQualifiedName: asQualifiedName(e.dstQualifiedName),
+                relType: e.relType,
+                attributes: e.attributes ?? {},
+                firstSeenAt: e.firstSeenAt ?? 1,
+                lastSeenAt: e.lastSeenAt ?? 1,
+            };
+            graphStore.mergeEdges([fact]);
+        },
+        async cleanup() {
+            setToolContextFactory(null);
+            await graphStore.close();
+            rmSync(workDir, { recursive: true, force: true });
+        },
+    };
+    return fix;
+}
+export { REL_TYPES };
+//# sourceMappingURL=_fixture.js.map

package/dist/tools/__tests__/_fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_fixture.js","sourceRoot":"","sources":["../../../src/tools/__tests__/_fixture.ts"],"names":[],"mappings":"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"}

package/dist/tools/__tests__/_runner.d.ts

@@ -0,0 +1,10 @@
+import { defaultRegistry } from "../../tool-registry.js";
+import "../index.js";
+export declare function callTool(name: string, args: Record<string, unknown>): Promise<{
+    summary: string;
+    markdown: string;
+    data: unknown;
+    follow_up_tools?: string[];
+}>;
+export { defaultRegistry };
+//# sourceMappingURL=_runner.d.ts.map

package/dist/tools/__tests__/_runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_runner.d.ts","sourceRoot":"","sources":["../../../src/tools/__tests__/_runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,aAAa,CAAC;AAErB,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC,CAUD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/tools/__tests__/_runner.js

@@ -0,0 +1,12 @@
+import { defaultRegistry } from "../../tool-registry.js";
+// Side-effect load all tools.
+import "../index.js";
+export async function callTool(name, args) {
+    const tool = defaultRegistry.get(name);
+    if (!tool)
+        throw new Error(`tool not registered: ${name}`);
+    const r = (await tool.handler(args));
+    return r;
+}
+export { defaultRegistry };
+//# sourceMappingURL=_runner.js.map

package/dist/tools/__tests__/_runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_runner.js","sourceRoot":"","sources":["../../../src/tools/__tests__/_runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,8BAA8B;AAC9B,OAAO,aAAa,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,IAA6B;IAO7B,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAKlC,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/tools/__tests__/analyze_field.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analyze_field.test.d.ts.map