@kernel.chat/kbot-finance 0.2.0

package/dist/governance.js

@@ -0,0 +1,73 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { canonicalize } from "./envelope.js";
+/** Compute the canonical signing input for an approval. */
+function signingInput(req, approver_id, approved_at) {
+    const payload = {
+        approved_at,
+        approver_id,
+        materiality: req.materiality,
+        request_hash: req.request_hash,
+        session_id: req.session_id,
+        summary: req.summary,
+    };
+    return canonicalize(payload);
+}
+/**
+ * Approver — issues signed approval tokens. In production this is a separate
+ * service held by compliance; for v0.1 it's an in-process module.
+ */
+export class Approver {
+    approver_id;
+    secret;
+    constructor(approver_id, secret) {
+        this.approver_id = approver_id;
+        this.secret = secret;
+    }
+    approve(request) {
+        const approved_at = new Date().toISOString();
+        const sig = createHmac("sha256", this.secret)
+            .update(signingInput(request, this.approver_id, approved_at), "utf8")
+            .digest("hex");
+        return {
+            ...request,
+            approver_id: this.approver_id,
+            approved_at,
+            signature: sig,
+        };
+    }
+}
+/**
+ * Verify an approval token. Returns true iff the signature matches and the
+ * approver is in the provided trust set.
+ */
+export function verifyApproval(token, trusted, request) {
+    // Bind every field to the request being signed off. A token cannot be
+    // replayed against a different request.
+    if (token.request_hash !== request.request_hash) {
+        return { ok: false, reason: "request_hash_mismatch" };
+    }
+    if (token.session_id !== request.session_id) {
+        return { ok: false, reason: "session_id_mismatch" };
+    }
+    if (token.materiality !== request.materiality) {
+        return { ok: false, reason: "materiality_mismatch" };
+    }
+    if (token.summary !== request.summary) {
+        return { ok: false, reason: "summary_mismatch" };
+    }
+    const secret = trusted.get(token.approver_id);
+    if (secret === undefined) {
+        return { ok: false, reason: "unknown_approver" };
+    }
+    const expected = createHmac("sha256", secret)
+        .update(signingInput(request, token.approver_id, token.approved_at), "utf8")
+        .digest("hex");
+    const a = Buffer.from(token.signature, "hex");
+    const b = Buffer.from(expected, "hex");
+    if (a.length !== b.length)
+        return { ok: false, reason: "bad_signature" };
+    if (!timingSafeEqual(a, b))
+        return { ok: false, reason: "bad_signature" };
+    return { ok: true };
+}
+//# sourceMappingURL=governance.js.map

package/dist/governance.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @kernel.chat/kbot-finance — Audit-grade AI infrastructure for capital markets.
+ *
+ * Three layers, one architecture:
+ *
+ *   1. Deterministic engine adapters — call known-good engines, never compute
+ *      the number in the AI layer. Content-addressed request envelopes guarantee
+ *      replay semantics.
+ *
+ *   2. Regulatory verifier — Norm-AI-pattern rules-as-code. Every action passes
+ *      through before the engine call. Failures emit adverse-action reason codes.
+ *
+ *   3. Hash-chained audit log — append-only, WORM-compatible, legally defensible.
+ *      Every request, verifier check, engine response, approval, and incident is
+ *      recorded with a hash linking it to the previous entry.
+ *
+ * The AI Intelligence Layer (kbot) calls into this package. The engines (Polymarket
+ * Gamma in v0.1; QuantLib, NautilusTrader, Aeron, alts-NAV in later versions) sit
+ * underneath. Regulators read the audit log.
+ *
+ * Apache 2.0. Reference implementation; not yet certified for production trading.
+ */
+export * from "./envelope.js";
+export * from "./audit-log.js";
+export * from "./governance.js";
+export * from "./verifier/index.js";
+export * as polymarket from "./adapters/polymarket/index.js";
+export * as edgar from "./adapters/edgar/index.js";
+export * from "./tools/polymarket-query.js";
+export * from "./tools/edgar-query.js";
+export * from "./exporters/annex-iv.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;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * @kernel.chat/kbot-finance — Audit-grade AI infrastructure for capital markets.
+ *
+ * Three layers, one architecture:
+ *
+ *   1. Deterministic engine adapters — call known-good engines, never compute
+ *      the number in the AI layer. Content-addressed request envelopes guarantee
+ *      replay semantics.
+ *
+ *   2. Regulatory verifier — Norm-AI-pattern rules-as-code. Every action passes
+ *      through before the engine call. Failures emit adverse-action reason codes.
+ *
+ *   3. Hash-chained audit log — append-only, WORM-compatible, legally defensible.
+ *      Every request, verifier check, engine response, approval, and incident is
+ *      recorded with a hash linking it to the previous entry.
+ *
+ * The AI Intelligence Layer (kbot) calls into this package. The engines (Polymarket
+ * Gamma in v0.1; QuantLib, NautilusTrader, Aeron, alts-NAV in later versions) sit
+ * underneath. Regulators read the audit log.
+ *
+ * Apache 2.0. Reference implementation; not yet certified for production trading.
+ */
+export * from "./envelope.js";
+export * from "./audit-log.js";
+export * from "./governance.js";
+export * from "./verifier/index.js";
+export * as polymarket from "./adapters/polymarket/index.js";
+export * as edgar from "./adapters/edgar/index.js";
+export * from "./tools/polymarket-query.js";
+export * from "./tools/edgar-query.js";
+export * from "./exporters/annex-iv.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;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,OAAO,KAAK,UAAU,MAAM,gCAAgC,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,2BAA2B,CAAC;AACnD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC"}

package/dist/kbot-tool.d.ts

@@ -0,0 +1,31 @@
+/**
+ * kbot tool registry surface for kbot-finance.
+ *
+ * Exports kbot-shaped `ToolDefinition`s so kbot can register them alongside
+ * its existing 100+ skills. Mirrors the shape kbot's own tools use
+ * (peekaboo.ts, ableton.ts, etc.): name, description, typed parameters,
+ * tier, and an async `execute()` that returns a string and never throws.
+ *
+ * To wire into kbot:
+ *
+ *   import { kbotFinanceTools } from '@kernel.chat/kbot-finance/kbot-tool'
+ *   for (const t of kbotFinanceTools) registerTool(t)
+ *
+ * Or copy this file into kbot/src/tools/polymarket.ts directly if you
+ * prefer not to add a workspace dependency for v0.1.
+ */
+export interface KbotToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, {
+        type: string;
+        description: string;
+        required?: boolean;
+        default?: unknown;
+    }>;
+    tier: "free" | "pro" | "growth" | "enterprise";
+    execute: (args: Record<string, unknown>) => Promise<string>;
+}
+export declare const kbotFinanceTools: readonly KbotToolDefinition[];
+export declare function registerKbotFinanceTools(register: (t: KbotToolDefinition) => void): void;
+//# sourceMappingURL=kbot-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kbot-tool.d.ts","sourceRoot":"","sources":["../src/kbot-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoBH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAChB,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CACF,CAAC;IACF,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAkUD,eAAO,MAAM,gBAAgB,EAAE,SAAS,kBAAkB,EAKzD,CAAC;AAEF,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GACxC,IAAI,CAEN"}

package/dist/kbot-tool.js

@@ -0,0 +1,325 @@
+/**
+ * kbot tool registry surface for kbot-finance.
+ *
+ * Exports kbot-shaped `ToolDefinition`s so kbot can register them alongside
+ * its existing 100+ skills. Mirrors the shape kbot's own tools use
+ * (peekaboo.ts, ableton.ts, etc.): name, description, typed parameters,
+ * tier, and an async `execute()` that returns a string and never throws.
+ *
+ * To wire into kbot:
+ *
+ *   import { kbotFinanceTools } from '@kernel.chat/kbot-finance/kbot-tool'
+ *   for (const t of kbotFinanceTools) registerTool(t)
+ *
+ * Or copy this file into kbot/src/tools/polymarket.ts directly if you
+ * prefer not to add a workspace dependency for v0.1.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdir } from "node:fs/promises";
+import { AppendOnlyAuditLog } from "./audit-log.js";
+import { makePositionLimitRule, makeKellyCapRule, makeRts6AlgorithmDeclaredRule, makeModelVersionPinnedRule, } from "./verifier/index.js";
+import { polymarketQuery } from "./tools/polymarket-query.js";
+import { edgarQuery } from "./tools/edgar-query.js";
+import { exportAnnexIv } from "./exporters/annex-iv.js";
+import { writeFile } from "node:fs/promises";
+// Default audit log location — one file per kbot install. Production
+// deployments override via env: KBOT_FINANCE_AUDIT_LOG=<path>.
+const DEFAULT_AUDIT_DIR = join(homedir(), ".kbot", "audit");
+const DEFAULT_AUDIT_PATH = process.env["KBOT_FINANCE_AUDIT_LOG"] ?? join(DEFAULT_AUDIT_DIR, "polymarket.jsonl");
+// Lazy audit-log singleton. The kbot CLI invokes tools as one-shot calls,
+// so we cache the open log to keep the hash chain coherent across calls
+// in the same process.
+let auditLogPromise = null;
+function getAuditLog() {
+    if (auditLogPromise === null) {
+        auditLogPromise = (async () => {
+            await mkdir(DEFAULT_AUDIT_DIR, { recursive: true });
+            return AppendOnlyAuditLog.open(DEFAULT_AUDIT_PATH);
+        })();
+    }
+    return auditLogPromise;
+}
+// Default rules. Operators can override at deploy time via env knobs.
+const POSITION_MAX_SIZE = Number(process.env["KBOT_FINANCE_MAX_SIZE"] ?? 10_000);
+const POSITION_MAX_NOTIONAL = Number(process.env["KBOT_FINANCE_MAX_NOTIONAL"] ?? 50_000);
+const KELLY_FRACTION = Number(process.env["KBOT_FINANCE_KELLY_FRACTION"] ?? 0.5);
+const KELLY_BANKROLL = Number(process.env["KBOT_FINANCE_BANKROLL"] ?? 100_000);
+function defaultRules() {
+    return [
+        makePositionLimitRule({
+            default_max_size: POSITION_MAX_SIZE,
+            default_max_notional: POSITION_MAX_NOTIONAL,
+        }),
+        makeKellyCapRule({ kelly_fraction: KELLY_FRACTION, bankroll: KELLY_BANKROLL }),
+        makeRts6AlgorithmDeclaredRule(),
+        makeModelVersionPinnedRule(),
+    ];
+}
+function nowISO() {
+    return new Date().toISOString();
+}
+function sessionId() {
+    // kbot doesn't expose a session id at tool-call time; derive a stable
+    // one from process pid + start time so all calls within one kbot run
+    // share a hash-chain root in the audit log.
+    return `kbot-${process.pid}-${Math.floor((process.uptime ?? (() => 0))())}`;
+}
+/**
+ * polymarket_query — read-only access to Polymarket markets via Gamma API,
+ * wrapped in the kbot-finance audit substrate.
+ *
+ * Every call:
+ *   1. Builds a content-addressed envelope (replay key = request_hash).
+ *   2. Runs the regulatory verifier (Kelly + position-limit rules).
+ *   3. Logs verifier check + engine request + engine response in the
+ *      hash-chained audit log at ~/.kbot/audit/polymarket.jsonl.
+ *   4. Returns normalized market data — NOT a price the AI itself computed.
+ *
+ * The AI never produces a market price. Gamma does. Replay against an
+ * indexer pinned to a block height is the v0.2 feature.
+ */
+const polymarketQueryTool = {
+    name: "polymarket_query",
+    description: "Query Polymarket prediction-market data via Gamma API, with content-addressed envelopes and a hash-chained audit log. mode=list_active for top-volume markets, mode=by_id for a specific market. AI never produces the price — Gamma does. Audit log at ~/.kbot/audit/polymarket.jsonl.",
+    parameters: {
+        mode: {
+            type: "string",
+            description: "'list_active' for top markets by 24h volume, 'by_id' for a specific market.",
+            required: true,
+        },
+        market_id: {
+            type: "string",
+            description: "Market id (required when mode='by_id').",
+        },
+        limit: {
+            type: "number",
+            description: "Max markets to return when mode='list_active'. Default 5.",
+            default: 5,
+        },
+        jurisdiction: {
+            type: "string",
+            description: "Verifier jurisdiction tag (US/EU/UK/SG/HK/UAE/GLOBAL). Default US.",
+            default: "US",
+        },
+    },
+    tier: "free",
+    async execute(args) {
+        try {
+            const mode = args["mode"];
+            if (mode !== "list_active" && mode !== "by_id") {
+                return `Error: mode must be 'list_active' or 'by_id' (got: ${String(mode)})`;
+            }
+            const market_id = typeof args["market_id"] === "string" ? args["market_id"] : undefined;
+            if (mode === "by_id" && !market_id) {
+                return "Error: market_id is required when mode='by_id'";
+            }
+            const limit = typeof args["limit"] === "number" ? args["limit"] : 5;
+            const jurisdiction = typeof args["jurisdiction"] === "string"
+                ? args["jurisdiction"]
+                : "US";
+            const auditLog = await getAuditLog();
+            const result = await polymarketQuery({
+                mode,
+                ...(market_id ? { market_id } : {}),
+                limit,
+                data_as_of: nowISO(),
+            }, {
+                auditLog,
+                rules: defaultRules(),
+                verifierContext: { session_id: sessionId(), state: {}, jurisdiction },
+            });
+            if (!result.ok) {
+                return `Error (${result.stage}): ${JSON.stringify(result.detail, null, 2)}`;
+            }
+            // Return a compact summary plus the request_hash so the caller can
+            // request a replay later. Full markets are nested under `value`.
+            const summary = {
+                request_hash: result.response.request_hash,
+                engine_version: result.response.engine_version,
+                produced_at: result.response.produced_at,
+                byte_identical_replayable: result.response.byte_identical_replayable,
+                market_count: result.response.value.markets.length,
+                markets: result.response.value.markets,
+            };
+            return JSON.stringify(summary, null, 2);
+        }
+        catch (e) {
+            return `Error: ${e.message}`;
+        }
+    },
+};
+/**
+ * audit_log_verify — verify the integrity of the kbot-finance audit log
+ * on disk. Returns "ok" or "broken at seq=N". Useful before exporting
+ * the log as regulator evidence.
+ */
+const auditLogVerifyTool = {
+    name: "audit_log_verify",
+    description: "Verify the hash-chain integrity of the kbot-finance audit log at ~/.kbot/audit/polymarket.jsonl. Returns ok or the broken sequence number.",
+    parameters: {
+        path: {
+            type: "string",
+            description: `Audit log path. Defaults to ${DEFAULT_AUDIT_PATH}.`,
+        },
+    },
+    tier: "free",
+    async execute(args) {
+        try {
+            const path = typeof args["path"] === "string" ? args["path"] : DEFAULT_AUDIT_PATH;
+            const result = await AppendOnlyAuditLog.verify(path);
+            if (result.ok) {
+                return JSON.stringify({ ok: true, path }, null, 2);
+            }
+            return JSON.stringify({ ok: false, path, broken_at_seq: result.broken_at_seq }, null, 2);
+        }
+        catch (e) {
+            return `Error: ${e.message}`;
+        }
+    },
+};
+/**
+ * edgar_query — read US SEC EDGAR filings/facts with audit-grade lineage.
+ * Filings are immutable by accession number; this is the cleanest
+ * content-addressing story available for US public-company data.
+ */
+const edgarQueryTool = {
+    name: "edgar_query",
+    description: "Query SEC EDGAR public-company filings or XBRL company facts. mode=submissions returns recent filings (with accession numbers and direct archive URLs); mode=company_facts returns the keys of XBRL facts available for the company. AI never produces the data — SEC does. Audit log at ~/.kbot/audit/polymarket.jsonl.",
+    parameters: {
+        mode: {
+            type: "string",
+            description: "'submissions' for recent filings list, 'company_facts' for XBRL fact keys.",
+            required: true,
+        },
+        cik: {
+            type: "string",
+            description: "Central Index Key — numeric, with or without leading zeros (e.g. '320193' for Apple).",
+            required: true,
+        },
+        limit: {
+            type: "number",
+            description: "Max items to return. Default 25 for filings, 50 for facts.",
+        },
+        jurisdiction: {
+            type: "string",
+            description: "Verifier jurisdiction tag. Default US.",
+            default: "US",
+        },
+    },
+    tier: "free",
+    async execute(args) {
+        try {
+            const mode = args["mode"];
+            if (mode !== "submissions" && mode !== "company_facts") {
+                return `Error: mode must be 'submissions' or 'company_facts' (got: ${String(mode)})`;
+            }
+            const cik = typeof args["cik"] === "string" ? args["cik"] : undefined;
+            if (!cik)
+                return "Error: cik is required";
+            const limit = typeof args["limit"] === "number" ? args["limit"] : undefined;
+            const jurisdiction = typeof args["jurisdiction"] === "string"
+                ? args["jurisdiction"]
+                : "US";
+            const auditLog = await getAuditLog();
+            const result = await edgarQuery({
+                mode,
+                cik,
+                ...(limit !== undefined ? { limit } : {}),
+                data_as_of: nowISO(),
+            }, {
+                auditLog,
+                rules: defaultRules(),
+                verifierContext: { session_id: sessionId(), state: {}, jurisdiction },
+            });
+            if (!result.ok) {
+                return `Error (${result.stage}): ${JSON.stringify(result.detail, null, 2)}`;
+            }
+            const summary = {
+                request_hash: result.response.request_hash,
+                engine_version: result.response.engine_version,
+                produced_at: result.response.produced_at,
+                byte_identical_replayable: result.response.byte_identical_replayable,
+                entity_name: result.response.value.entity_name,
+                result_count: result.response.value.filings?.length ??
+                    result.response.value.facts_keys?.length ??
+                    0,
+                ...(result.response.value.filings
+                    ? { filings: result.response.value.filings }
+                    : { facts_keys: result.response.value.facts_keys }),
+            };
+            return JSON.stringify(summary, null, 2);
+        }
+        catch (e) {
+            return `Error: ${e.message}`;
+        }
+    },
+};
+/**
+ * annex_iv_export — emit an EU AI Act Annex IV technical-documentation
+ * bundle from the audit log. Same artifact satisfies Fed SR 26-02
+ * technical documentation. Writes the rendered markdown to disk.
+ */
+const annexIvExportTool = {
+    name: "annex_iv_export",
+    description: "Generate an EU AI Act Annex IV technical-documentation markdown bundle from the kbot-finance audit log. Same artifact satisfies Fed SR 26-02. Pass output_path to write to disk; otherwise the rendered content is returned inline.",
+    parameters: {
+        audit_log_path: {
+            type: "string",
+            description: `Audit log path. Defaults to ${DEFAULT_AUDIT_PATH}.`,
+        },
+        output_path: {
+            type: "string",
+            description: "If set, write the bundle to this path and return only the metadata.",
+        },
+        system_name: {
+            type: "string",
+            description: "System name to record in the Annex IV header.",
+        },
+        deployer: {
+            type: "string",
+            description: "Deployer / regulated entity name to record in the Annex IV header.",
+        },
+        jurisdiction: {
+            type: "string",
+            description: "Jurisdiction filed under (EU/US/UK/SG/HK/UAE/GLOBAL). Default EU.",
+            default: "EU",
+        },
+    },
+    tier: "free",
+    async execute(args) {
+        try {
+            const audit_log_path = typeof args["audit_log_path"] === "string" ? args["audit_log_path"] : DEFAULT_AUDIT_PATH;
+            const output_path = typeof args["output_path"] === "string" ? args["output_path"] : undefined;
+            const system_name = typeof args["system_name"] === "string" ? args["system_name"] : undefined;
+            const deployer = typeof args["deployer"] === "string" ? args["deployer"] : undefined;
+            const jurisdiction = typeof args["jurisdiction"] === "string"
+                ? args["jurisdiction"]
+                : "EU";
+            const bundle = await exportAnnexIv(audit_log_path, {
+                ...(system_name ? { system_name } : {}),
+                ...(deployer ? { deployer } : {}),
+                jurisdiction,
+            });
+            if (output_path) {
+                await writeFile(output_path, bundle.content, "utf8");
+                return JSON.stringify({ ok: true, output_path, meta: bundle.meta }, null, 2);
+            }
+            return bundle.content;
+        }
+        catch (e) {
+            return `Error: ${e.message}`;
+        }
+    },
+};
+export const kbotFinanceTools = [
+    polymarketQueryTool,
+    edgarQueryTool,
+    annexIvExportTool,
+    auditLogVerifyTool,
+];
+export function registerKbotFinanceTools(register) {
+    for (const t of kbotFinanceTools)
+        register(t);
+}
+//# sourceMappingURL=kbot-tool.js.map

package/dist/kbot-tool.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * kbot-finance MCP server.
+ *
+ * Exposes the kbot-finance tools to any MCP client — Claude Code, Cursor,
+ * Claude.ai connectors, Replit Agent, kbot core, or anything else that
+ * speaks the protocol. The same content-addressed envelope + verifier +
+ * hash-chained audit log substrate that powers kbot's native tools is
+ * now available over stdio MCP.
+ *
+ * Usage:
+ *   npx @kernel.chat/kbot-finance mcp
+ *
+ * Or in an MCP client config:
+ *   {
+ *     "mcpServers": {
+ *       "kbot-finance": {
+ *         "command": "npx",
+ *         "args": ["-y", "@kernel.chat/kbot-finance", "mcp"]
+ *       }
+ *     }
+ *   }
+ */
+export declare function startMcpServer(): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA+BH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAqCpD"}

package/dist/mcp-server.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+/**
+ * kbot-finance MCP server.
+ *
+ * Exposes the kbot-finance tools to any MCP client — Claude Code, Cursor,
+ * Claude.ai connectors, Replit Agent, kbot core, or anything else that
+ * speaks the protocol. The same content-addressed envelope + verifier +
+ * hash-chained audit log substrate that powers kbot's native tools is
+ * now available over stdio MCP.
+ *
+ * Usage:
+ *   npx @kernel.chat/kbot-finance mcp
+ *
+ * Or in an MCP client config:
+ *   {
+ *     "mcpServers": {
+ *       "kbot-finance": {
+ *         "command": "npx",
+ *         "args": ["-y", "@kernel.chat/kbot-finance", "mcp"]
+ *       }
+ *     }
+ *   }
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { kbotFinanceTools } from "./kbot-tool.js";
+const SERVER_NAME = "kbot-finance";
+const SERVER_VERSION = "0.2.0";
+function paramsToJsonSchema(tool) {
+    const properties = {};
+    const required = [];
+    for (const [name, spec] of Object.entries(tool.parameters)) {
+        properties[name] = {
+            type: spec.type,
+            description: spec.description,
+        };
+        if (spec.required)
+            required.push(name);
+    }
+    return { type: "object", properties, required };
+}
+export async function startMcpServer() {
+    const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: kbotFinanceTools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: paramsToJsonSchema(t),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const tool = kbotFinanceTools.find((t) => t.name === name);
+        if (!tool) {
+            return {
+                content: [{ type: "text", text: `Error: unknown tool ${name}` }],
+                isError: true,
+            };
+        }
+        const result = await tool.execute((args ?? {}));
+        const isError = result.startsWith("Error");
+        return {
+            content: [{ type: "text", text: result }],
+            ...(isError ? { isError: true } : {}),
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // The transport keeps the process alive on stdin/stdout.
+    process.stderr.write(`${SERVER_NAME} v${SERVER_VERSION} MCP server ready on stdio — ${kbotFinanceTools.length} tools registered.\n`);
+}
+// Run when invoked as a script via `npx @kernel.chat/kbot-finance mcp`
+if (import.meta.url === `file://${process.argv[1]}`) {
+    startMcpServer().catch((e) => {
+        process.stderr.write(`mcp server fatal: ${e.message}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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