@ryanstark24/sfgraph-server 1.1.0

package/dist/__tests__/context-cache.test.d.ts

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

package/dist/__tests__/context-cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-cache.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context-cache.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/context-cache.test.js

@@ -0,0 +1,77 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { SqliteGraphStore, SqliteSnapshotStore } from "@ryanstark24/sfgraph-core";
+import { SfgraphError, asOrgId } from "@ryanstark24/sfgraph-shared";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { _contextCacheSize, closeAllContexts, getToolContext, setToolContextFactory, } from "../context.js";
+let workDir;
+const factoryCallCount = { n: 0 };
+beforeEach(() => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-ctxcache-"));
+    factoryCallCount.n = 0;
+    setToolContextFactory(async ({ orgId }) => {
+        factoryCallCount.n += 1;
+        const id = orgId ?? "default";
+        const dbPath = path.join(workDir, `${id}.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 ctx = { graphStore, snapshotStore, orgId: asOrgId(id) };
+        return ctx;
+    });
+});
+afterEach(async () => {
+    await closeAllContexts();
+    setToolContextFactory(null);
+    rmSync(workDir, { recursive: true, force: true });
+});
+describe("getToolContext cache", () => {
+    it("returns the same context object across two calls for the same orgId", async () => {
+        const a = await getToolContext({ orgId: "myorg" });
+        const b = await getToolContext({ orgId: "myorg" });
+        expect(b).toBe(a);
+        expect(factoryCallCount.n).toBe(1);
+    });
+    it("closeAllContexts releases the cached store; next call rebuilds", async () => {
+        const a = await getToolContext({ orgId: "myorg" });
+        await closeAllContexts();
+        const b = await getToolContext({ orgId: "myorg" });
+        expect(b).not.toBe(a);
+        expect(factoryCallCount.n).toBe(2);
+    });
+    it("rejects malformed org identifiers with SfgraphError before invoking factory", async () => {
+        await expect(getToolContext({ orgId: "../escape" })).rejects.toBeInstanceOf(SfgraphError);
+        await expect(getToolContext({ orgId: "/abs/path" })).rejects.toBeInstanceOf(SfgraphError);
+        await expect(getToolContext({ orgId: "foo\x00bar" })).rejects.toBeInstanceOf(SfgraphError);
+        expect(factoryCallCount.n).toBe(0); // factory never reached
+    });
+    // P1 audit pass 2: cache eviction
+    it("evicts the oldest entry once the bounded cache fills (cap=8)", async () => {
+        // Insert 9 distinct contexts; the first must be evicted.
+        for (let i = 0; i < 9; i++) {
+            await getToolContext({ orgId: `org${i}` });
+        }
+        expect(_contextCacheSize()).toBeLessThanOrEqual(8);
+        expect(factoryCallCount.n).toBe(9);
+        // org0 should have been evicted; fetching again rebuilds.
+        await getToolContext({ orgId: "org0" });
+        expect(factoryCallCount.n).toBe(10);
+    });
+    it("idempotent close on the graph store does not throw on double-close", async () => {
+        const ctx = await getToolContext({ orgId: "doubleclose" });
+        const store = ctx.graphStore;
+        await store.close();
+        // second close must be a no-op
+        await store.close();
+    });
+});
+//# sourceMappingURL=context-cache.test.js.map

package/dist/__tests__/context-cache.test.js.map

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

package/dist/__tests__/context-default-factory.test.d.ts

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

package/dist/__tests__/context-default-factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-default-factory.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context-default-factory.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/context-default-factory.test.js

@@ -0,0 +1,89 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+/**
+ * Cover the default factory's alias-classification + unknown-alias rejection
+ * paths added in the P1 audit pass. Tests bypass the test-factory swap so we
+ * exercise the real `defaultFactory` against a tempdir-backed `getSfgraphPaths`.
+ */
+let workDir;
+beforeEach(() => {
+    workDir = mkdtempSync(path.join(tmpdir(), "sfg-default-factory-"));
+});
+afterEach(() => {
+    rmSync(workDir, { recursive: true, force: true });
+    vi.restoreAllMocks();
+    vi.resetModules();
+});
+async function stubPaths() {
+    vi.doMock("@ryanstark24/sfgraph-shared", async () => {
+        const actual = await vi.importActual("@ryanstark24/sfgraph-shared");
+        return {
+            ...actual,
+            getSfgraphPaths: () => ({
+                data: workDir,
+                cache: workDir,
+                log: workDir,
+                config: workDir,
+                temp: workDir,
+            }),
+        };
+    });
+}
+async function stubCore(resolveImpl) {
+    vi.doMock("@ryanstark24/sfgraph-core", async () => {
+        const actual = await vi.importActual("@ryanstark24/sfgraph-core");
+        return {
+            ...actual,
+            resolveOrg: resolveImpl ??
+                (async (alias) => {
+                    throw new Error(`unknown alias: ${alias}`);
+                }),
+        };
+    });
+}
+describe("default factory: alias classification (P1 regex fix)", () => {
+    it("rejects unknown alias rather than creating empty <alias>.sqlite", async () => {
+        await stubPaths();
+        await stubCore();
+        const { getToolContext, setToolContextFactory } = await import("../context.js");
+        // Force null so default factory is picked up.
+        setToolContextFactory(null);
+        await expect(getToolContext({ orgId: "MyUnknownAlias" })).rejects.toThrow(/unknown org identifier/);
+    });
+    it("treats a 15-char alias (not starting with 00D) as an alias, not an orgId", async () => {
+        // The pre-P1 logic mistakenly classified any 15-char string as an orgId
+        // by length alone. With the 00D-prefixed regex, this must be treated as
+        // an alias and hit the alias-resolution path (which will fail here).
+        await stubPaths();
+        await stubCore();
+        const { getToolContext, setToolContextFactory } = await import("../context.js");
+        setToolContextFactory(null);
+        // 15 chars, not starting with 00D — must NOT be classified as an orgId.
+        await expect(getToolContext({ orgId: "MyOrgAliasIs15c" })).rejects.toThrow(/unknown org identifier/);
+    });
+    it("accepts a real 18-char SF orgId (00D-prefixed) and opens a store", async () => {
+        await stubPaths();
+        await stubCore();
+        const { getToolContext, closeAllContexts, setToolContextFactory } = await import("../context.js");
+        setToolContextFactory(null);
+        const ctx = await getToolContext({ orgId: "00DXX0000001abcEAA" });
+        expect(String(ctx.orgId)).toBe("00DXX0000001abcEAA");
+        await closeAllContexts();
+    });
+    it("falls back to sf-CLI resolution when alias isn't in any existing DB", async () => {
+        await stubPaths();
+        await stubCore(async (alias) => {
+            if (alias === "newlyAuthed")
+                return { orgId: "00DZZ0000009xyzEAA" };
+            throw new Error("unknown");
+        });
+        const { getToolContext, closeAllContexts, setToolContextFactory } = await import("../context.js");
+        setToolContextFactory(null);
+        const ctx = await getToolContext({ orgId: "newlyAuthed" });
+        expect(String(ctx.orgId)).toBe("00DZZ0000009xyzEAA");
+        await closeAllContexts();
+    });
+});
+//# sourceMappingURL=context-default-factory.test.js.map

package/dist/__tests__/context-default-factory.test.js.map

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

package/dist/__tests__/network-egress.test.d.ts

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

package/dist/__tests__/network-egress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-egress.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/network-egress.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/network-egress.test.js

@@ -0,0 +1,33 @@
+import dns from "node:dns";
+import { describe, expect, it } from "vitest";
+const ALLOW = new Set(["localhost", "127.0.0.1", "::1"]);
+describe("network egress (mcp-server)", () => {
+    it("constructing the SfgraphMcpServer triggers no external DNS", async () => {
+        const lookups = [];
+        const originalLookup = dns.lookup;
+        const originalPromisesLookup = dns.promises.lookup;
+        dns.lookup = (hostname, ...rest) => {
+            lookups.push(hostname);
+            const cb = typeof rest[rest.length - 1] === "function" ? rest[rest.length - 1] : null;
+            if (cb)
+                cb(null, "127.0.0.1", 4);
+            return undefined;
+        };
+        dns.promises.lookup = async (hostname) => {
+            lookups.push(hostname);
+            return { address: "127.0.0.1", family: 4 };
+        };
+        try {
+            const mod = await import("../index.js");
+            const s = new mod.SfgraphMcpServer();
+            s.registerDefaults();
+        }
+        finally {
+            dns.lookup = originalLookup;
+            dns.promises.lookup = originalPromisesLookup;
+        }
+        const violations = lookups.filter((h) => !ALLOW.has(h));
+        expect(violations).toEqual([]);
+    });
+});
+//# sourceMappingURL=network-egress.test.js.map

package/dist/__tests__/network-egress.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-egress.test.js","sourceRoot":"","sources":["../../src/__tests__/network-egress.test.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;AAEzD,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC;QAClC,MAAM,sBAAsB,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClD,GAAW,CAAC,MAAM,GAAG,CAAC,QAAgB,EAAE,GAAG,IAAW,EAAE,EAAE;YACzD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACtF,IAAI,EAAE;gBAAE,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YACjC,OAAO,SAAgB,CAAC;QAC1B,CAAC,CAAC;QACD,GAAG,CAAC,QAAgB,CAAC,MAAM,GAAG,KAAK,EAAE,QAAgB,EAAE,EAAE;YACxD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC7C,CAAC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACxC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACrC,CAAC,CAAC,gBAAgB,EAAE,CAAC;QACvB,CAAC;gBAAS,CAAC;YACR,GAAW,CAAC,MAAM,GAAG,cAAc,CAAC;YACpC,GAAG,CAAC,QAAgB,CAAC,MAAM,GAAG,sBAAsB,CAAC;QACxD,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/shutdown.test.d.ts

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

package/dist/__tests__/shutdown.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/shutdown.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/shutdown.test.js

@@ -0,0 +1,78 @@
+import { EventEmitter } from "node:events";
+import { describe, expect, it, vi } from "vitest";
+import { installShutdownHandlers } from "../shutdown.js";
+describe("installShutdownHandlers", () => {
+    it("fires onShutdown on SIGTERM", async () => {
+        const signals = new EventEmitter();
+        const stdin = new EventEmitter();
+        const onShutdown = vi.fn(async () => { });
+        installShutdownHandlers({
+            onShutdown,
+            signalEmitter: signals,
+            stdinEmitter: stdin,
+            exit: () => { },
+        });
+        signals.emit("SIGTERM");
+        await new Promise((r) => setImmediate(r));
+        expect(onShutdown).toHaveBeenCalledTimes(1);
+    });
+    it("fires onShutdown on SIGINT", async () => {
+        const signals = new EventEmitter();
+        const stdin = new EventEmitter();
+        const onShutdown = vi.fn(async () => { });
+        installShutdownHandlers({
+            onShutdown,
+            signalEmitter: signals,
+            stdinEmitter: stdin,
+            exit: () => { },
+        });
+        signals.emit("SIGINT");
+        await new Promise((r) => setImmediate(r));
+        expect(onShutdown).toHaveBeenCalledTimes(1);
+    });
+    it("is idempotent on second signal", async () => {
+        const signals = new EventEmitter();
+        const stdin = new EventEmitter();
+        const onShutdown = vi.fn(async () => { });
+        installShutdownHandlers({
+            onShutdown,
+            signalEmitter: signals,
+            stdinEmitter: stdin,
+            exit: () => { },
+        });
+        signals.emit("SIGTERM");
+        signals.emit("SIGTERM");
+        await new Promise((r) => setImmediate(r));
+        expect(onShutdown).toHaveBeenCalledTimes(1);
+    });
+    it("fires on stdin end", async () => {
+        const signals = new EventEmitter();
+        const stdin = new EventEmitter();
+        const onShutdown = vi.fn(async () => { });
+        installShutdownHandlers({
+            onShutdown,
+            signalEmitter: signals,
+            stdinEmitter: stdin,
+            exit: () => { },
+        });
+        stdin.emit("end");
+        await new Promise((r) => setImmediate(r));
+        expect(onShutdown).toHaveBeenCalled();
+    });
+    it("watchdog calls exit(1) if shutdown hangs", async () => {
+        const signals = new EventEmitter();
+        const stdin = new EventEmitter();
+        const exit = vi.fn();
+        installShutdownHandlers({
+            onShutdown: () => new Promise(() => { }),
+            watchdogMs: 10,
+            signalEmitter: signals,
+            stdinEmitter: stdin,
+            exit,
+        });
+        signals.emit("SIGTERM");
+        await new Promise((r) => setTimeout(r, 30));
+        expect(exit).toHaveBeenCalledWith(1);
+    });
+});
+//# sourceMappingURL=shutdown.test.js.map

package/dist/__tests__/shutdown.test.js.map

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

package/dist/__tests__/tool-registry.test.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/tool-registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/tool-registry.test.js

@@ -0,0 +1,21 @@
+import { describe, expect, it } from "vitest";
+import { ToolRegistry } from "../tool-registry.js";
+import { pingTool } from "../tools/ping.js";
+describe("ToolRegistry", () => {
+    it("registers and lists tools", () => {
+        const r = new ToolRegistry();
+        r.register(pingTool.name, pingTool.handler, pingTool.schema);
+        expect(r.list().map((t) => t.name)).toEqual(["ping"]);
+    });
+    it("throws on duplicate register", () => {
+        const r = new ToolRegistry();
+        r.register("x", async () => ({}), { description: "x" });
+        expect(() => r.register("x", async () => ({}), { description: "x" })).toThrow();
+    });
+    it("ping returns ok+ts", async () => {
+        const r = await pingTool.handler({});
+        expect(r["ok"]).toBe(true);
+        expect(typeof r["ts"]).toBe("number");
+    });
+});
+//# sourceMappingURL=tool-registry.test.js.map

package/dist/__tests__/tool-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.test.js","sourceRoot":"","sources":["../../src/__tests__/tool-registry.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,CAAC,GAAG,IAAI,YAAY,EAAE,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,CAAC,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/zod-schema.test.d.ts

@@ -0,0 +1,2 @@
+import "../tools/index.js";
+//# sourceMappingURL=zod-schema.test.d.ts.map

package/dist/__tests__/zod-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/zod-schema.test.ts"],"names":[],"mappings":"AAEA,OAAO,mBAAmB,CAAC"}

package/dist/__tests__/zod-schema.test.js

@@ -0,0 +1,15 @@
+import { describe, expect, it } from "vitest";
+import { defaultRegistry } from "../tool-registry.js";
+import "../tools/index.js";
+describe("registered tool schemas", () => {
+    it("each tool has a valid JSON Schema-shape inputSchema", () => {
+        const tools = defaultRegistry.list();
+        expect(tools.length).toBeGreaterThanOrEqual(19);
+        for (const t of tools) {
+            expect(t.schema.inputSchema, `tool ${t.name} missing inputSchema`).toBeDefined();
+            const s = t.schema.inputSchema;
+            expect(typeof s.type === "string", `tool ${t.name} schema missing type`).toBe(true);
+        }
+    });
+});
+//# sourceMappingURL=zod-schema.test.js.map

package/dist/__tests__/zod-schema.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-schema.test.js","sourceRoot":"","sources":["../../src/__tests__/zod-schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,mBAAmB,CAAC;AAE3B,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,WAAW,EAAE,CAAC;YACjF,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,WAAsC,CAAC;YAC1D,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,QAAQ,CAAC,CAAC,IAAI,sBAAsB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtF,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+export declare function runMcpServer(): Promise<void>;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAIA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CASlD"}

package/dist/bin.js

@@ -0,0 +1,14 @@
+import { closeAllContexts } from "./context.js";
+import { SfgraphMcpServer } from "./server.js";
+import { installShutdownHandlers } from "./shutdown.js";
+export async function runMcpServer() {
+    const server = new SfgraphMcpServer();
+    server.registerDefaults();
+    installShutdownHandlers({
+        onShutdown: async () => {
+            await closeAllContexts();
+        },
+    });
+    await server.startStdio();
+}
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAC1B,uBAAuB,CAAC;QACtB,UAAU,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,gBAAgB,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;AAC5B,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,29 @@
+import { type GraphStore, type SnapshotStore } from "@ryanstark24/sfgraph-core";
+import { type OrgId } from "@ryanstark24/sfgraph-shared";
+export interface ToolContext {
+    graphStore: GraphStore;
+    snapshotStore: SnapshotStore;
+    orgId: OrgId;
+    /** Raw SQLite handle for cached analysis-table reads (optional). */
+    db?: unknown;
+}
+export type ToolContextFactory = (opts: {
+    orgId?: string;
+}) => Promise<ToolContext>;
+export declare function setToolContextFactory(fn: ToolContextFactory | null): void;
+/**
+ * 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 declare function getToolContext(opts?: {
+    orgId?: string;
+}): Promise<ToolContext>;
+/**
+ * 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 declare function closeAllContexts(): Promise<void>;
+/** Exposed for tests so they can assert the cache bound. */
+export declare function _contextCacheSize(): number;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAqB,MAAM,2BAA2B,CAAC;AACnG,OAAO,EAEL,KAAK,KAAK,EAMX,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,oEAAoE;IACpE,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AA+CpF,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAIzE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBxF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED,4DAA4D;AAC5D,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}