@invaro/opentax 0.1.0

package/dist/hosted-bundle.js

@@ -0,0 +1,8 @@
+/**
+ * Entry for the self-contained hosted bundle (site /mcp route, edge-less
+ * Node runtimes). Exports the server factory plus the SDK's Web-Standard
+ * Streamable HTTP transport so the host app needs zero MCP dependencies.
+ */
+export { createServer } from "./server.js";
+export { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+//# sourceMappingURL=hosted-bundle.js.map

package/dist/hosted-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-bundle.js","sourceRoot":"","sources":["../src/hosted-bundle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,wCAAwC,EAAE,MAAM,+DAA+D,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * @invaro/opentax Streamable HTTP entry — the same tax oracle as a remote MCP
+ * connector URL (spec 2025-03-26 Streamable HTTP transport, stateless mode).
+ *
+ * Run:   opentax-mcp-http            (PORT env, default 3411)
+ * Then:  add https://<host>/mcp as a custom connector (Claude.ai, ChatGPT,
+ *        Cursor, `claude mcp add --transport http opentax <url>`).
+ *
+ * Stateless by design: every POST gets a fresh server + transport, so the
+ * process scales horizontally with no session affinity. The corpus is loaded
+ * once per process and shared (it is immutable and content-addressed).
+ */
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/http.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * @invaro/opentax Streamable HTTP entry — the same tax oracle as a remote MCP
+ * connector URL (spec 2025-03-26 Streamable HTTP transport, stateless mode).
+ *
+ * Run:   opentax-mcp-http            (PORT env, default 3411)
+ * Then:  add https://<host>/mcp as a custom connector (Claude.ai, ChatGPT,
+ *        Cursor, `claude mcp add --transport http opentax <url>`).
+ *
+ * Stateless by design: every POST gets a fresh server + transport, so the
+ * process scales horizontally with no session affinity. The corpus is loaded
+ * once per process and shared (it is immutable and content-addressed).
+ */
+import { createServer as createHttpServer } from "node:http";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer } from "./server.js";
+const PORT = Number(process.env.PORT ?? 3411);
+const PATH = process.env.MCP_PATH ?? "/mcp";
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let raw = "";
+        req.on("data", (c) => (raw += c));
+        req.on("end", () => {
+            if (!raw)
+                return resolve(undefined);
+            try {
+                resolve(JSON.parse(raw));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        req.on("error", reject);
+    });
+}
+function cors(res) {
+    res.setHeader("Access-Control-Allow-Origin", "*");
+    res.setHeader("Access-Control-Allow-Methods", "POST, GET, DELETE, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, Accept, Authorization, Mcp-Session-Id, MCP-Protocol-Version, Last-Event-ID");
+    res.setHeader("Access-Control-Expose-Headers", "Mcp-Session-Id");
+}
+const httpServer = createHttpServer(async (req, res) => {
+    cors(res);
+    const url = (req.url ?? "/").split("?")[0];
+    if (req.method === "OPTIONS") {
+        res.writeHead(204).end();
+        return;
+    }
+    if (url === "/healthz") {
+        res.writeHead(200, { "Content-Type": "application/json" }).end('{"ok":true}');
+        return;
+    }
+    if (url !== PATH) {
+        res.writeHead(404, { "Content-Type": "application/json" }).end('{"error":"not found — the MCP endpoint is ' + PATH + '"}');
+        return;
+    }
+    if (req.method !== "POST") {
+        // stateless mode: no SSE resumption stream, no sessions to DELETE
+        res.writeHead(405, { Allow: "POST, OPTIONS" }).end();
+        return;
+    }
+    try {
+        const body = await readBody(req);
+        const server = createServer();
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined, // stateless
+            enableJsonResponse: true,
+        });
+        res.on("close", () => {
+            void transport.close();
+            void server.close();
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, body);
+    }
+    catch (err) {
+        if (!res.headersSent) {
+            res.writeHead(400, { "Content-Type": "application/json" });
+        }
+        res.end(JSON.stringify({
+            jsonrpc: "2.0",
+            error: { code: -32700, message: String(err?.message ?? err) },
+            id: null,
+        }));
+    }
+});
+httpServer.listen(PORT, () => {
+    console.error(`opentax MCP (Streamable HTTP, stateless) listening on :${PORT}${PATH}`);
+});
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @invaro/opentax stdio entry — the tax oracle for AI agents over the Model
+ * Context Protocol.
+ *
+ *   claude mcp add opentax -- npx -y @invaro/opentax
+ */
+export {};
+//# 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":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * @invaro/opentax stdio entry — the tax oracle for AI agents over the Model
+ * Context Protocol.
+ *
+ *   claude mcp add opentax -- npx -y @invaro/opentax
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;AAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MCP input schema — GENERATED from the corpus fact registry.
+ *
+ * The corpus is the single source of truth: a fact added there can never be
+ * silently absent here (schema.test.ts pins a full PARTITION — every fact
+ * belongs to exactly one domain tool and, within the individual domain, to
+ * exactly one group), and tool inputs are validated STRICTLY — an unknown
+ * key is an error naming the key, never a silent strip. A confident answer
+ * computed from silently dropped facts is exactly the failure mode this
+ * engine exists to prevent.
+ *
+ * Context economy (the tiered design):
+ *  - calculate_tax advertises the INDIVIDUAL facts, nested into groups
+ *    (filing, income, retirement, credits, …) so agents fill related fields
+ *    together instead of navigating a 170-key wall.
+ *  - Business-entity, fiduciary, and dependent-determination facts live on
+ *    their own tools with flat, fully-described schemas.
+ *  - The other fact-taking tools (verify_tax_claim, find_tax_cliffs,
+ *    compare_filing_statuses) advertise one compact `facts` object param,
+ *    runtime-validated by the same strict validator over ALL domains —
+ *    identical strictness, advertised once.
+ *
+ * Every fact is optional at the schema level: the engine demands the facts
+ * the requested target actually needs and names any that are missing.
+ */
+import { z } from "zod";
+import type { TypedValueJSON } from "@invaro/opentax-core";
+export declare const corpus: import("@invaro/opentax-core").LoadedCorpus;
+export declare const money: z.ZodUnion<[z.ZodNumber, z.ZodString]>;
+export declare function domainOf(id: string): "business" | "fiduciary" | "dependent" | "individual";
+/** Individual facts, grouped for the nested calculate_tax schema. */
+export declare const INDIVIDUAL_GROUPS: Record<string, readonly string[]>;
+export declare function factIdsForDomain(domain: "business" | "fiduciary" | "dependent" | "individual"): string[];
+/** Nested individual schema advertised on calculate_tax. */
+export declare const individualNestedShape: Record<string, z.ZodTypeAny>;
+/** Flat business-entity schema advertised on calculate_business_tax. */
+export declare const businessShape: Record<string, z.ZodTypeAny>;
+/** Flat Form 1041 schema advertised on calculate_fiduciary_tax. */
+export declare const fiduciaryShape: Record<string, z.ZodTypeAny>;
+/** Flat § 152 dependent-determination schema advertised on determine_dependent. */
+export declare const dependentShape: Record<string, z.ZodTypeAny>;
+/** Flat validator over ALL facts + target/asOf — the single strict backstop. */
+export declare const FACT_SHAPE: Record<string, z.ZodTypeAny>;
+export declare const factsObjectParam: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/** Accepts grouped, flat, or mixed input; returns one flat fact record. */
+export declare function flattenFactsArg(input: Record<string, unknown>): Record<string, unknown>;
+export declare function buildFacts(args: Record<string, unknown>, defaultTarget?: string): {
+    facts: Record<string, TypedValueJSON>;
+    asOf: string;
+    target: string;
+};
+/**
+ * Strict-validate a facts input (grouped, flat, or mixed), then build engine
+ * facts. Unknown keys error by name — identical strictness on every tool.
+ */
+export declare function buildFactsValidated(factsArg: unknown, defaultTarget?: string): ReturnType<typeof buildFacts> & {
+    documentNotes: string[];
+    w2Box1Cents?: bigint;
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,eAAO,MAAM,MAAM,6CAAc,CAAC;AAElC,eAAO,MAAM,KAAK,wCAE6B,CAAC;AAmEhD,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAQ1F;AAED,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAmL/D,CAAC;AAeF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,GAC5D,MAAM,EAAE,CAEV;AAsBD,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAgB3D,CAAC;AAEL,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAQnD,CAAC;AAEL,mEAAmE;AACnE,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAKpD,CAAC;AAEL,mFAAmF;AACnF,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAQpD,CAAC;AAIL,gFAAgF;AAChF,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAMhD,CAAC;AAIL,eAAO,MAAM,gBAAgB,wCAI1B,CAAC;AAEJ,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBvF;AAID,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,aAAa,GAAE,MAAuB,GACrC;IACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB,CAmCA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG;IAAE,aAAa,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAiDnF"}