@kernel.chat/kbot-finance 0.2.0

package/dist/verifier/model-version.js

@@ -0,0 +1,28 @@
+export function makeModelVersionPinnedRule() {
+    return {
+        id: "rule.model_version_pinned",
+        jurisdictions: ["GLOBAL"],
+        operations: ["*"],
+        evaluate(action, _context) {
+            if (action.materiality === "informational")
+                return { pass: true };
+            const inputs = action.inputs;
+            const v = inputs?.model_version;
+            if (typeof v !== "string" || v.trim().length === 0) {
+                return {
+                    pass: false,
+                    reason: {
+                        code: "MODEL_VERSION_UNPINNED",
+                        summary: "Operational/material actions must declare a pinned model_version. SR 26-02 and EU AI Act Art. 12 (record-keeping) require model lineage on every decision.",
+                        details: {
+                            required_field: "model_version",
+                            guidance: ["Fed SR 26-02", "OCC Bulletin 2026-13", "EU AI Act Art. 11-12"],
+                        },
+                    },
+                };
+            }
+            return { pass: true };
+        },
+    };
+}
+//# sourceMappingURL=model-version.js.map

package/dist/verifier/model-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-version.js","sourceRoot":"","sources":["../../src/verifier/model-version.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,EAAE,EAAE,2BAA2B;QAC/B,aAAa,EAAE,CAAC,QAAQ,CAAC;QACzB,UAAU,EAAE,CAAC,GAAG,CAAC;QACjB,QAAQ,CAAC,MAAsB,EAAE,QAAyB;YACxD,IAAI,MAAM,CAAC,WAAW,KAAK,eAAe;gBAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAqB,CAAC;YAC5C,MAAM,CAAC,GAAG,MAAM,EAAE,aAAa,CAAC;YAChC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnD,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE;wBACN,IAAI,EAAE,wBAAwB;wBAC9B,OAAO,EACL,4JAA4J;wBAC9J,OAAO,EAAE;4BACP,cAAc,EAAE,eAAe;4BAC/B,QAAQ,EAAE,CAAC,cAAc,EAAE,sBAAsB,EAAE,sBAAsB,CAAC;yBAC3E;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/verifier/position-limit.d.ts

@@ -0,0 +1,21 @@
+import type { Rule } from "./index.js";
+/**
+ * Pre-trade position-limit rule.
+ *
+ * Echoes Rule 15c3-5 (SEC Market Access Rule) — the engine must have a
+ * hard cap on order size and notional exposure per instrument before any
+ * trade reaches the venue. Failure emits an adverse-action-style reason
+ * code.
+ *
+ * Context expected shape:
+ *   state.position_limits: { [instrument_id: string]: { max_size: number; max_notional: number } }
+ *   state.current_positions: { [instrument_id: string]: { size: number; notional: number } }
+ */
+export interface PositionLimitConfig {
+    /** Max increment in size for a single action. */
+    readonly default_max_size: number;
+    /** Max notional in a single action. */
+    readonly default_max_notional: number;
+}
+export declare function makePositionLimitRule(config: PositionLimitConfig): Rule;
+//# sourceMappingURL=position-limit.d.ts.map

package/dist/verifier/position-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-limit.d.ts","sourceRoot":"","sources":["../../src/verifier/position-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA+C,MAAM,YAAY,CAAC;AAEpF;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,uCAAuC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAQD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAwCvE"}

package/dist/verifier/position-limit.js

@@ -0,0 +1,42 @@
+export function makePositionLimitRule(config) {
+    return {
+        id: "rule.position_limit",
+        jurisdictions: ["GLOBAL"],
+        operations: ["polymarket.market_make", "polymarket.trade", "alts.allocate"],
+        evaluate(action, _context) {
+            const inputs = action.inputs;
+            const size = inputs?.size ?? 0;
+            const notional = inputs?.notional ?? 0;
+            if (size > config.default_max_size) {
+                return {
+                    pass: false,
+                    reason: {
+                        code: "POSITION_SIZE_EXCEEDED",
+                        summary: `Action size ${size} exceeds max ${config.default_max_size}`,
+                        details: {
+                            max_allowed: config.default_max_size,
+                            requested: size,
+                            instrument: inputs?.instrument_id ?? null,
+                        },
+                    },
+                };
+            }
+            if (notional > config.default_max_notional) {
+                return {
+                    pass: false,
+                    reason: {
+                        code: "POSITION_NOTIONAL_EXCEEDED",
+                        summary: `Action notional ${notional} exceeds max ${config.default_max_notional}`,
+                        details: {
+                            max_allowed: config.default_max_notional,
+                            requested: notional,
+                            instrument: inputs?.instrument_id ?? null,
+                        },
+                    },
+                };
+            }
+            return { pass: true };
+        },
+    };
+}
+//# sourceMappingURL=position-limit.js.map

package/dist/verifier/position-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-limit.js","sourceRoot":"","sources":["../../src/verifier/position-limit.ts"],"names":[],"mappings":"AA4BA,MAAM,UAAU,qBAAqB,CAAC,MAA2B;IAC/D,OAAO;QACL,EAAE,EAAE,qBAAqB;QACzB,aAAa,EAAE,CAAC,QAAQ,CAAC;QACzB,UAAU,EAAE,CAAC,wBAAwB,EAAE,kBAAkB,EAAE,eAAe,CAAC;QAC3E,QAAQ,CAAC,MAAsB,EAAE,QAAyB;YACxD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAqB,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC;YAC/B,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,IAAI,CAAC,CAAC;YACvC,IAAI,IAAI,GAAG,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACnC,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE;wBACN,IAAI,EAAE,wBAAwB;wBAC9B,OAAO,EAAE,eAAe,IAAI,gBAAgB,MAAM,CAAC,gBAAgB,EAAE;wBACrE,OAAO,EAAE;4BACP,WAAW,EAAE,MAAM,CAAC,gBAAgB;4BACpC,SAAS,EAAE,IAAI;4BACf,UAAU,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;yBAC1C;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;gBAC3C,OAAO;oBACL,IAAI,EAAE,KAAK;oBACX,MAAM,EAAE;wBACN,IAAI,EAAE,4BAA4B;wBAClC,OAAO,EAAE,mBAAmB,QAAQ,gBAAgB,MAAM,CAAC,oBAAoB,EAAE;wBACjF,OAAO,EAAE;4BACP,WAAW,EAAE,MAAM,CAAC,oBAAoB;4BACxC,SAAS,EAAE,QAAQ;4BACnB,UAAU,EAAE,MAAM,EAAE,aAAa,IAAI,IAAI;yBAC1C;qBACF;iBACF,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@kernel.chat/kbot-finance",
+  "version": "0.2.0",
+  "description": "Audit-grade AI infrastructure for capital markets. Deterministic engine adapters + content-addressed envelopes + hash-chained audit log + regulatory verifier + MCP server. The AI Intelligence Layer never produces the number.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "bin": {
+    "kbot-finance": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./envelope": {
+      "import": "./dist/envelope.js",
+      "types": "./dist/envelope.d.ts"
+    },
+    "./audit-log": {
+      "import": "./dist/audit-log.js",
+      "types": "./dist/audit-log.d.ts"
+    },
+    "./verifier": {
+      "import": "./dist/verifier/index.js",
+      "types": "./dist/verifier/index.d.ts"
+    },
+    "./adapters/polymarket": {
+      "import": "./dist/adapters/polymarket/index.js",
+      "types": "./dist/adapters/polymarket/index.d.ts"
+    },
+    "./kbot-tool": {
+      "import": "./dist/kbot-tool.js",
+      "types": "./dist/kbot-tool.d.ts"
+    },
+    "./mcp-server": {
+      "import": "./dist/mcp-server.js",
+      "types": "./dist/mcp-server.d.ts"
+    },
+    "./adapters/edgar": {
+      "import": "./dist/adapters/edgar/index.js",
+      "types": "./dist/adapters/edgar/index.d.ts"
+    },
+    "./exporters/annex-iv": {
+      "import": "./dist/exporters/annex-iv.js",
+      "types": "./dist/exporters/annex-iv.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js dist/mcp-server.js 2>/dev/null || true",
+    "dev": "tsx src/index.ts",
+    "demo": "tsx src/demo.ts",
+    "mcp": "tsx src/cli.ts mcp",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:live": "vitest run --reporter=verbose test/polymarket.live.test.ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "RFC-content-addressed-mcp.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isaacsight/kernel.git",
+    "directory": "packages/kbot-finance"
+  },
+  "homepage": "https://kernel.chat",
+  "bugs": {
+    "url": "https://github.com/isaacsight/kernel/issues"
+  },
+  "author": "kernel.chat group",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "keywords": [
+    "capital-markets",
+    "ai-infrastructure",
+    "deterministic",
+    "audit",
+    "mcp",
+    "polymarket",
+    "compliance-as-code"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+}