@0xdivyanshh/tab-mcp 0.1.0

package/README.md

@@ -0,0 +1,89 @@
+# @0xdivyanshh/tab-mcp
+
+**Tier 3 · MCP server**
+
+Tab's verbs as MCP tools, so an agent in any MCP-capable runtime can transact on a tab with no
+bespoke code. Seven tools; **only `tab_spend` moves money.**
+
+## The decision the old README left open — settled
+
+It offered two options: a standalone server (this), or documentation for loading
+`@0xdivyanshh/tab-agentkit-plugin` into `@hashgraph/hedera-agent-kit-mcp`. **Shipping option 1.** Option 2 is
+the better ecosystem story and it is not the one to ship first:
+
+- It depends on **two** things that do not exist — the plugin is unwritten — plus an external
+  server accepting third-party plugins in a shape nobody here has verified.
+- It cannot be driven by a judge in one step. This can: three lines of config and Claude Desktop is
+  spending on a Hedera tab.
+- It is **additive later.** A plugin can wrap the same `@0xdivyanshh/tab-sdk` verbs whenever the Agent Kit path
+  is confirmed, and nothing here has to be undone.
+
+## Use it
+
+```jsonc
+// claude_desktop_config.json  (or any MCP client)
+{
+  "mcpServers": {
+    "tab": {
+      "command": "node",
+      "args": [
+        "--experimental-strip-types",
+        "/absolute/path/to/ethonline/packages/mcp/src/stdio.ts"
+      ],
+      "env": {
+        "TAB_GATEWAY_URL": "http://localhost:8080",
+        "TAB_ACCOUNT_ID": "0.0.10390398"
+      }
+    }
+  }
+}
+```
+
+Then ask the model things like *"what can my tab afford?"*, *"buy the forecast from this URL for at
+most 0.040000"*, or — the one worth trying — ***"why is my ceiling only 0.25?"***
+
+That last question is the point of the whole rail. It answers with the published arithmetic and the
+funding-graph evidence:
+
+```
+0.0.10385196  0%  BLOCKED
+  COMMON_FUNDER: the same account funded both this counterparty and the agent's tab
+  funded by 0.0.8812188 · tab funded by 0.0.8812188  ← SAME, which is what COMMON_FUNDER tests
+```
+
+## Tools
+
+| Tool | Moves money | What it answers |
+|---|---|---|
+| `tab_spend` | **yes** | Pay a seller, up to a cap. Returns paid / refused / failed |
+| `tab_quote` | no | Would this be allowed? Reserves nothing |
+| `tab_balance` | no | Position: balance, outstanding, holds, available, ceiling |
+| `tab_ceiling` | no | The ceiling, what bound it, and the published inputs |
+| `tab_receipts` | no | Recent ledger entries from the HCS receipt topic |
+| `tab_counterparties` | no | Independence weights and the reason for each |
+| `tab_health` | no | Gateway reachability, network, token, window |
+
+Every read tool is annotated `readOnlyHint: true`; `tab_spend` is `destructiveHint: true` and
+`idempotentHint: false`, so a client knows which one to confirm with a human.
+
+## Invariants
+
+- **A refusal is a structured RESULT, not an error.** `isError: true` makes a client surface a
+  failure and invites a model to retry — and a `CEILING_EXCEEDED` retried immediately is refused
+  again for the same reason. A refusal returns the rule, the evidence, and what to do instead,
+  because choosing different work is the correct response and the agent can only choose it if it is
+  told why. A `failed` outcome **is** an error, and hands back the hold id: infrastructure broke
+  after the decision to spend, so nobody knows whether the seller was paid, and a retry with a new
+  key would be a second payment.
+- **No key material anywhere.** `McpConfig` is a URL and a tab id; `createTab` has no parameter
+  that would accept a key, and `boundaries.json` bars this package from `@hiero-ledger/sdk`. An MCP
+  server runs on a user's machine inside a client the user did not write — the surface where a
+  leaked key would hurt most, and so the one where the constraint is enforced rather than promised.
+- **`stdout` is the protocol.** A single stray `console.log` corrupts the JSON-RPC stream and the
+  client reports a parse error rather than whatever actually went wrong. Every diagnostic goes to
+  stderr.
+- **Same verbs, same semantics as `@0xdivyanshh/tab-sdk`.** Guidance text comes from `@0xdivyanshh/tab-protocol`, not from
+  strings invented here, so an agent that learns the rail through MCP learns the same rail.
+- **Fails at startup on a missing `TAB_ACCOUNT_ID`.** A client shows a server as connected the
+  moment the process is alive, so one that starts happily and then refuses every call looks like a
+  broken rail rather than a missing variable.

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import { type Tab } from '@0xdivyanshh/tab-sdk';
+/**
+ * How the server is configured, and what it deliberately cannot be given.
+ *
+ * A URL and a tab id. There is no token, no private key, and `createTab` has no
+ * parameter that would accept one — which is the whole product claim holding at
+ * the surface most likely to be handed a credential "just for convenience".
+ * An MCP server runs on a user's machine, inside a client the user did not
+ * write, and is exactly where a key would leak.
+ */
+export interface McpConfig {
+    gatewayUrl: string;
+    tab: string;
+}
+export declare function configFromEnv(env?: NodeJS.ProcessEnv): McpConfig;
+export declare function clientFor(config: McpConfig): Tab;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9C;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,CAqB7E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,GAAG,CAehD"}

package/dist/config.js

@@ -0,0 +1,36 @@
+import { createTab } from '@0xdivyanshh/tab-sdk';
+export function configFromEnv(env = process.env) {
+    const gatewayUrl = env['TAB_GATEWAY_URL'] ?? 'http://localhost:8080';
+    const tab = env['TAB_ACCOUNT_ID'] ?? '';
+    if (!tab) {
+        /*
+         * Fail at STARTUP, not on the first tool call.
+         *
+         * An MCP client shows a server as connected the moment the process is
+         * alive, so a server that starts happily and then refuses every call looks
+         * like a broken rail rather than a missing environment variable. The error
+         * goes to stderr, which stdio transports reserve for exactly this — stdout
+         * is the JSON-RPC channel and a stray line there corrupts the stream.
+         */
+        throw new Error('TAB_ACCOUNT_ID is not set. The MCP server needs to know which tab to transact on. ' +
+            'Set it in the mcpServers entry for this server, alongside TAB_GATEWAY_URL.');
+    }
+    return { gatewayUrl, tab };
+}
+export function clientFor(config) {
+    return createTab({
+        baseUrl: config.gatewayUrl,
+        /*
+         * Patient, unlike the console's client.
+         *
+         * A spend waits on the SELLER, whose x402 facilitator runs a Mirror Node
+         * preflight plus signature verification — measured at 25-39s for an HTS
+         * token. An MCP client is a foreground tool an agent is waiting on, so
+         * giving up at 8s would abandon a payment that was about to succeed and
+         * leave the caller unable to tell a slow seller from a failed one.
+         */
+        timeoutMs: 120_000,
+        maxRetries: 1,
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,UAAU,CAAA;AAgB9C,MAAM,UAAU,aAAa,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,MAAM,UAAU,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,uBAAuB,CAAA;IACpE,MAAM,GAAG,GAAG,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAA;IAEvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT;;;;;;;;WAQG;QACH,MAAM,IAAI,KAAK,CACb,oFAAoF;YAClF,4EAA4E,CAC/E,CAAA;IACH,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAiB;IACzC,OAAO,SAAS,CAAC;QACf,OAAO,EAAE,MAAM,CAAC,UAAU;QAC1B;;;;;;;;WAQG;QACH,SAAS,EAAE,OAAO;QAClB,UAAU,EAAE,CAAC;KACd,CAAC,CAAA;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@0xdivyanshh/tab-mcp` — Tab's verbs as MCP tools.
+ *
+ * Tier 3. Depends on `@0xdivyanshh/tab-sdk` and nothing lower — `boundaries.json` allows
+ * only `money`, `protocol` and `sdk`, so this package is structurally incapable
+ * of signing, reading a database, or recomputing a ceiling. An MCP server runs
+ * on a user's machine inside a client the user did not write, which makes it the
+ * surface where a leaked key would hurt most and the constraint worth enforcing
+ * rather than promising.
+ *
+ * The binary is `src/stdio.ts`. This module exists so a host can embed the
+ * server on its own transport.
+ */
+export { clientFor, configFromEnv, type McpConfig } from './config.ts';
+export { buildServer } from './server.ts';
+//# 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;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * `@0xdivyanshh/tab-mcp` — Tab's verbs as MCP tools.
+ *
+ * Tier 3. Depends on `@0xdivyanshh/tab-sdk` and nothing lower — `boundaries.json` allows
+ * only `money`, `protocol` and `sdk`, so this package is structurally incapable
+ * of signing, reading a database, or recomputing a ceiling. An MCP server runs
+ * on a user's machine inside a client the user did not write, which makes it the
+ * surface where a leaked key would hurt most and the constraint worth enforcing
+ * rather than promising.
+ *
+ * The binary is `src/stdio.ts`. This module exists so a host can embed the
+ * server on its own transport.
+ */
+export { clientFor, configFromEnv } from "./config.js";
+export { buildServer } from "./server.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;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { toWire } from '@0xdivyanshh/tab-money';
+import type { Tab } from '@0xdivyanshh/tab-sdk';
+import type { McpConfig } from './config.ts';
+export declare function buildServer(tab: Tab, config: McpConfig): McpServer;
+/** Re-exported so a consumer can serialise an amount the way the tools expect. */
+export { toWire };
+//# 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,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAU,MAAM,EAAQ,MAAM,YAAY,CAAA;AAEjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAqD5C,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,GAAG,SAAS,CA4WlE;AAED,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/server.js

@@ -0,0 +1,343 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { format, toWire, usdc } from '@0xdivyanshh/tab-money';
+import { REFUSAL_GUIDANCE, WEIGHT_REASON_DETAIL } from '@0xdivyanshh/tab-protocol';
+import { z } from 'zod';
+/**
+ * `@0xdivyanshh/tab-mcp` — Tab's verbs as MCP tools.
+ *
+ * ## Why a standalone server, which the README left open
+ *
+ * The README offered two options: this, or documentation for loading
+ * `@0xdivyanshh/tab-agentkit-plugin` into `@hashgraph/hedera-agent-kit-mcp`. Option 2 is
+ * the better ecosystem story and it is not the one to ship first, for reasons
+ * that are about evidence rather than taste:
+ *
+ *  - It depends on TWO things that do not exist — the plugin is unwritten — and
+ *    on an external server accepting third-party plugins in a shape nobody here
+ *    has verified.
+ *  - It cannot be demonstrated by a judge in one step. This can: three lines in
+ *    a client config and Claude Desktop is spending on a Hedera tab.
+ *  - It is additive later. A plugin can wrap the same `@0xdivyanshh/tab-sdk` verbs whenever
+ *    the Agent Kit path is confirmed, and nothing here has to be undone.
+ *
+ * So: option 1, and the reason is recorded here rather than in an ADR nobody
+ * opens.
+ *
+ * ## The one invariant
+ *
+ * **A refusal is a structured result, not an error.** `isError: true` makes an
+ * MCP client surface a failure and, worse, invites a model to retry it — and a
+ * `CEILING_EXCEEDED` retried immediately is a spend that will be refused again
+ * for the same reason. A refusal comes back as content the model can read,
+ * carrying the rule, the evidence and what to do instead, because choosing
+ * different work is the correct response and the agent can only choose it if it
+ * is told why.
+ *
+ * Infrastructure failure IS an error, and the distinction is preserved from the
+ * SDK: a refusal means the rail said no, `failed` means nobody said anything
+ * and the caller does not know whether the seller was paid.
+ */
+/** Amounts cross MCP as decimal strings — `bigint` does not survive JSON. */
+const AMOUNT = z
+    .string()
+    .regex(/^\d+\.\d{6}$/, 'six decimal places, e.g. "0.040000"')
+    .describe('USDC amount as a decimal string with exactly six decimal places, e.g. "0.040000"');
+/** Every tool returns text content; structured data goes in the same string. */
+function text(body) {
+    return { content: [{ type: 'text', text: body }] };
+}
+function errorText(body) {
+    return { content: [{ type: 'text', text: body }], isError: true };
+}
+export function buildServer(tab, config) {
+    const server = new McpServer({ name: 'tab', version: '0.1.0' }, {
+        instructions: `Tab is a credit rail on Hedera for this agent's tab ${config.tab}. The agent holds no ` +
+            'key and signs nothing; the gateway pays sellers on its behalf against an earned ceiling. ' +
+            'Call quote before a batch to learn what is affordable. A refused spend is a normal, ' +
+            'expected answer that names the rule and what to do instead — read the guidance and choose ' +
+            'different work rather than retrying the same call.',
+    });
+    /* ── spend: the only verb that moves money ───────────────────────────────── */
+    server.registerTool('tab_spend', {
+        title: 'Spend from the tab',
+        description: 'Pay a seller through the tab, up to `max`. The gateway reserves a hold, pays, then ' +
+            'commits — so a crash cannot leave the tab overdrawn. Returns paid, refused or failed. ' +
+            'A REFUSED result is not an error: it names the rule that fired and what to do instead.',
+        inputSchema: {
+            url: z
+                .string()
+                .url()
+                .describe('The seller URL, including whatever the seller needs to be paid'),
+            max: AMOUNT.describe('The most this call may cost. The tab is debited what was actually settled, not this cap.'),
+            idempotencyKey: z
+                .string()
+                .min(8)
+                .max(64)
+                .optional()
+                .describe('Reuse the SAME key when retrying a failed call, or the retry may double-spend. ' +
+                'Generated automatically when omitted.'),
+        },
+        annotations: {
+            title: 'Spend from the tab',
+            // MOVES MONEY. The one tool here that is not safe to call speculatively,
+            // and the one an MCP client should confirm with a human.
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async ({ url, max, idempotencyKey }) => {
+        const result = await tab.spend({
+            tab: config.tab,
+            url,
+            max: usdc(max),
+            ...(idempotencyKey ? { idempotencyKey } : {}),
+        });
+        if (result.outcome === 'paid') {
+            return text([
+                `PAID ${format(result.amount)} USDC to ${result.seller}.`,
+                `hold ${result.holdId}` +
+                    (result.receiptSeq !== null ? ` · receipt seq ${result.receiptSeq} on HCS` : ''),
+                `took ${Math.round(result.elapsedMs / 1000)}s`,
+                '',
+                'The seller responded:',
+                typeof result.body === 'string' ? result.body : JSON.stringify(result.body, null, 2),
+            ].join('\n'));
+        }
+        if (result.outcome === 'refused') {
+            /*
+             * NOT `isError`. See the header.
+             *
+             * The guidance comes from `@0xdivyanshh/tab-protocol`, not from a string invented
+             * here — the same text the HTTP API and the console show, so an agent
+             * that learns the rail through MCP learns the same rail.
+             */
+            const evidence = result.evidence
+                ? Object.entries(result.evidence)
+                    .map(([k, v]) => `  ${k} ${v}`)
+                    .join('\n')
+                : '  (none published)';
+            return text([
+                `REFUSED — ${result.rule}`,
+                '',
+                result.reason,
+                '',
+                'Evidence:',
+                evidence,
+                '',
+                `What to do: ${result.guidance}`,
+                result.retryable
+                    ? 'This rule can clear on its own — the same call may succeed later.'
+                    : 'Retrying this exact call will be refused again for the same reason. Choose different work.',
+            ].join('\n'));
+        }
+        /*
+         * `failed` IS an error, and says the one thing that matters.
+         *
+         * Infrastructure broke AFTER the decision to spend, so nobody knows
+         * whether the seller was paid. A caller that retries MUST reuse the hold
+         * id as its idempotency key, or the retry is a second payment.
+         */
+        return errorText([
+            `FAILED — ${result.reason}`,
+            '',
+            'This is NOT a refusal. The rail did not say no; nobody said anything, and it is ' +
+                'unknown whether the seller was paid.',
+            `To retry safely, call tab_spend again with idempotencyKey "${result.holdId}" — the ` +
+                'gateway treats it as the same attempt. A new key would be a second payment.',
+            'The hold expires on its own, so the headroom is not lost permanently.',
+        ].join('\n'));
+    });
+    /* ── quote: what can I afford, reserving nothing ─────────────────────────── */
+    server.registerTool('tab_quote', {
+        title: 'Check affordability without reserving',
+        description: 'Ask whether a spend of `max` would be allowed, WITHOUT taking a hold. Use this before ' +
+            'planning a batch: a hold taken by a quote would be headroom the agent never uses.',
+        inputSchema: { max: AMOUNT },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ max }) => {
+        const q = await tab.quote({ tab: config.tab, max: usdc(max) });
+        return text([
+            q.affordable ? `AFFORDABLE — ${format(usdc(max))} is within the tab.` : 'NOT AFFORDABLE',
+            `available    ${format(q.available)}`,
+            `ceiling      ${format(q.ceiling)}`,
+            `per-call cap ${format(q.perCallCap)}`,
+            ...(q.wouldRefuse
+                ? [
+                    '',
+                    `would refuse: ${q.wouldRefuse}`,
+                    `${q.reason ?? ''}`,
+                    REFUSAL_GUIDANCE[q.wouldRefuse],
+                ]
+                : []),
+        ]
+            .filter(Boolean)
+            .join('\n'));
+    });
+    /* ── the read verbs ──────────────────────────────────────────────────────── */
+    server.registerTool('tab_balance', {
+        title: 'Tab position',
+        description: 'The tab’s current position: balance (negative means the agent owes), outstanding, ' +
+            'holds, available headroom and the ceiling in force.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const s = await tab.state(config.tab);
+        return text([
+            `tab          ${s.tab}`,
+            `balance      ${format(s.balance, { sign: 'always' })}   (negative means the agent owes)`,
+            `outstanding  ${format(s.outstanding)}`,
+            `holds        ${format(s.holds)}`,
+            `available    ${format(s.available)}`,
+            `ceiling      ${format(s.ceiling)}`,
+            `per-call cap ${format(s.perCallCap)}`,
+            `window       ${s.window} · ${s.entries} ledger entries`,
+        ].join('\n'));
+    });
+    server.registerTool('tab_ceiling', {
+        title: 'The ceiling, and the arithmetic behind it',
+        description: 'The credit ceiling in force, what bound it, and the published inputs it was computed ' +
+            'from. Use this to explain to a user WHY the tab can or cannot afford something.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const c = await tab.ceiling(config.tab);
+        if (!c.published || !c.current) {
+            return text([
+                `No ceiling published yet for ${c.tab} — normal for a tab's first minutes.`,
+                `The gateway is enforcing ${format(c.enforced)} meanwhile (the starter floor).`,
+                c.note ?? '',
+            ]
+                .filter(Boolean)
+                .join('\n'));
+        }
+        const i = c.current.inputs;
+        return text([
+            `ceiling      ${format(c.current.ceiling)}   bound by ${c.current.binding}`,
+            `enforced now ${format(c.enforced)}` +
+                (c.enforced !== c.current.ceiling
+                    ? '   (the gateway polls the topic every 15s, so this is what a spend is checked against)'
+                    : ''),
+            `cause        ${c.current.cause}`,
+            '',
+            'Published inputs:',
+            `  trailing revenue  ${format(i.revenue)}  (attested ${format(i.revenueAttested)} · unattested ${format(i.revenueUnattested)})`,
+            `  tier              ${i.tier}  ×${i.multBp / 10_000}`,
+            `  earned ramp       ${i.rampBp / 100}%`,
+            `  hard cap          ${format(i.cap)}`,
+            `  starter floor     ${format(i.floor)}`,
+            ...(i.defaulted
+                ? ['  DEFAULTED         this tab has missed a settlement, so the ceiling is zero']
+                : []),
+            '',
+            `model ${c.current.model} · HCS seq ${c.current.seq ?? '?'} · input hash ${c.current.hash}`,
+            'Anyone can recompute this from the public topic: pnpm verify-ceiling.',
+        ].join('\n'));
+    });
+    server.registerTool('tab_receipts', {
+        title: 'Recent receipts',
+        description: 'The tab’s recent ledger entries from the HCS receipt topic — holds, debits, ' +
+            'credits, refusals and settlements, newest first.',
+        inputSchema: {
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(10)
+                .describe('How many entries, newest first'),
+        },
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async ({ limit }) => {
+        const rows = await tab.receipts(config.tab);
+        const recent = rows.slice(-limit).reverse();
+        if (recent.length === 0)
+            return text('No receipts yet for this tab.');
+        return text(recent
+            .map((r) => {
+            const amount = r.amount !== undefined ? format(r.amount, { sign: 'always' }) : '—';
+            return [
+                r.leg.toUpperCase().padEnd(11),
+                amount.padStart(10),
+                (r.counterparty ?? '—').padEnd(14),
+                r.rule ?? '',
+                r.seq !== undefined ? `seq ${r.seq}` : 'unpublished',
+            ]
+                .filter(Boolean)
+                .join('  ');
+        })
+            .join('\n'));
+    });
+    server.registerTool('tab_counterparties', {
+        title: 'Who counts as independent revenue',
+        description: 'Published independence weights for the tab’s counterparties, with the reason each ' +
+            'was discounted or blocked. This is why revenue does or does not raise the ceiling.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const rows = await tab.counterparties(config.tab);
+        if (rows.length === 0)
+            return text('No weights published yet. Run the engine.');
+        return text(rows
+            .map((w) => [
+            `${w.counterparty}  ${w.bp / 100}%${w.blocking ? '  BLOCKED' : ''}`,
+            `  revenue ${format(w.revenue)} · share ${w.shareBp / 100}%`,
+            ...w.reasons.map((r) => `  ${r}: ${WEIGHT_REASON_DETAIL[r]}`),
+            ...(w.funder && w.tabFunder
+                ? [
+                    `  funded by ${w.funder} · tab funded by ${w.tabFunder}` +
+                        (w.funder === w.tabFunder
+                            ? '  ← SAME, which is what COMMON_FUNDER tests'
+                            : ''),
+                ]
+                : []),
+        ].join('\n'))
+            .join('\n\n'));
+    });
+    server.registerTool('tab_health', {
+        title: 'Is the rail up',
+        description: 'Gateway reachability, network, token and current window.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    }, async () => {
+        const h = await tab.health();
+        return text([
+            h.ok ? 'Gateway is up.' : 'Gateway responded but did not report OK.',
+            `network ${h.network} · token ${h.token} · window ${h.window}`,
+            h.demoMode ? 'DEMO MODE is on — window length is overridden for demonstration.' : '',
+            `gateway ${config.gatewayUrl} · tab ${config.tab}`,
+        ]
+            .filter(Boolean)
+            .join('\n'));
+    });
+    return server;
+}
+/** Re-exported so a consumer can serialise an amount the way the tools expect. */
+export { toWire };
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEtE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,GAAG,CAAC;KACb,MAAM,EAAE;KACR,KAAK,CAAC,cAAc,EAAE,qCAAqC,CAAC;KAC5D,QAAQ,CAAC,kFAAkF,CAAC,CAAA;AAE/F,gFAAgF;AAChF,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,CAAA;AACrF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,MAAiB;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EACjC;QACE,YAAY,EACV,uDAAuD,MAAM,CAAC,GAAG,uBAAuB;YACxF,2FAA2F;YAC3F,sFAAsF;YACtF,4FAA4F;YAC5F,oDAAoD;KACvD,CACF,CAAA;IAED,gFAAgF;IAEhF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,qFAAqF;YACrF,wFAAwF;YACxF,wFAAwF;QAC1F,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,GAAG,EAAE,MAAM,CAAC,QAAQ,CAClB,0FAA0F,CAC3F;YACD,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CACP,iFAAiF;gBAC/E,uCAAuC,CAC1C;SACJ;QACD,WAAW,EAAE;YACX,KAAK,EAAE,oBAAoB;YAC3B,yEAAyE;YACzE,yDAAyD;YACzD,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC;YAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,GAAG;YACH,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;YACd,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAA;QAEF,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,IAAI,CACT;gBACE,QAAQ,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,MAAM,CAAC,MAAM,GAAG;gBACzD,QAAQ,MAAM,CAAC,MAAM,EAAE;oBACrB,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,kBAAkB,MAAM,CAAC,UAAU,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAClF,QAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG;gBAC9C,EAAE;gBACF,uBAAuB;gBACvB,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACrF,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;QACH,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC;;;;;;eAMG;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ;gBAC9B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;qBAC5B,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;qBAC9B,IAAI,CAAC,IAAI,CAAC;gBACf,CAAC,CAAC,oBAAoB,CAAA;YACxB,OAAO,IAAI,CACT;gBACE,aAAa,MAAM,CAAC,IAAI,EAAE;gBAC1B,EAAE;gBACF,MAAM,CAAC,MAAM;gBACb,EAAE;gBACF,WAAW;gBACX,QAAQ;gBACR,EAAE;gBACF,eAAe,MAAM,CAAC,QAAQ,EAAE;gBAChC,MAAM,CAAC,SAAS;oBACd,CAAC,CAAC,mEAAmE;oBACrE,CAAC,CAAC,4FAA4F;aACjG,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;QACH,CAAC;QAED;;;;;;WAMG;QACH,OAAO,SAAS,CACd;YACE,YAAY,MAAM,CAAC,MAAM,EAAE;YAC3B,EAAE;YACF,kFAAkF;gBAChF,sCAAsC;YACxC,8DAA8D,MAAM,CAAC,MAAM,UAAU;gBACnF,6EAA6E;YAC/E,uEAAuE;SACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;IACH,CAAC,CACF,CAAA;IAED,gFAAgF;IAEhF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,uCAAuC;QAC9C,WAAW,EACT,wFAAwF;YACxF,mFAAmF;QACrF,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;QAC5B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAC9D,OAAO,IAAI,CACT;YACE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,gBAAgB;YACxF,gBAAgB,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;YACrC,gBAAgB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;YACnC,gBAAgB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE;YACtC,GAAG,CAAC,CAAC,CAAC,WAAW;gBACf,CAAC,CAAC;oBACE,EAAE;oBACF,iBAAiB,CAAC,CAAC,WAAW,EAAE;oBAChC,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE;oBACnB,gBAAgB,CAAC,CAAC,CAAC,WAAW,CAAC;iBAChC;gBACH,CAAC,CAAC,EAAE,CAAC;SACR;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;IACH,CAAC,CACF,CAAA;IAED,gFAAgF;IAEhF,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,oFAAoF;YACpF,qDAAqD;QACvD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACrC,OAAO,IAAI,CACT;YACE,gBAAgB,CAAC,CAAC,GAAG,EAAE;YACvB,gBAAgB,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,oCAAoC;YACzF,gBAAgB,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE;YACvC,gBAAgB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YACjC,gBAAgB,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE;YACrC,gBAAgB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;YACnC,gBAAgB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE;YACtC,gBAAgB,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,iBAAiB;SACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,2CAA2C;QAClD,WAAW,EACT,uFAAuF;YACvF,iFAAiF;QACnF,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,IAAI,CACT;gBACE,gCAAgC,CAAC,CAAC,GAAG,sCAAsC;gBAC3E,4BAA4B,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC;gBAC/E,CAAC,CAAC,IAAI,IAAI,EAAE;aACb;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;QACH,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;QAC1B,OAAO,IAAI,CACT;YACE,gBAAgB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE;YAC3E,gBAAgB,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE;gBAClC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO;oBAC/B,CAAC,CAAC,wFAAwF;oBAC1F,CAAC,CAAC,EAAE,CAAC;YACT,gBAAgB,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE;YACjC,EAAE;YACF,mBAAmB;YACnB,uBAAuB,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,iBAAiB,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,GAAG;YAC/H,uBAAuB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE;YACtD,uBAAuB,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG;YACxC,uBAAuB,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;YACtC,uBAAuB,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE;YACxC,GAAG,CAAC,CAAC,CAAC,SAAS;gBACb,CAAC,CAAC,CAAC,8EAA8E,CAAC;gBAClF,CAAC,CAAC,EAAE,CAAC;YACP,EAAE;YACF,SAAS,CAAC,CAAC,OAAO,CAAC,KAAK,cAAc,CAAC,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,iBAAiB,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE;YAC3F,uEAAuE;SACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,8EAA8E;YAC9E,kDAAkD;QACpD,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,gCAAgC,CAAC;SAC9C;QACD,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAA;QAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,+BAA+B,CAAC,CAAA;QACrE,OAAO,IAAI,CACT,MAAM;aACH,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;YAClF,OAAO;gBACL,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACnB,CAAC,CAAC,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,CAAC,CAAC,IAAI,IAAI,EAAE;gBACZ,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa;aACrD;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,oFAAoF;YACpF,oFAAoF;QACtF,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACjD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,2CAA2C,CAAC,CAAA;QAC/E,OAAO,IAAI,CACT,IAAI;aACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT;YACE,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;YACnE,aAAa,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,GAAG,GAAG,GAAG;YAC5D,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,SAAS;gBACzB,CAAC,CAAC;oBACE,eAAe,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC,SAAS,EAAE;wBACtD,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS;4BACvB,CAAC,CAAC,6CAA6C;4BAC/C,CAAC,CAAC,EAAE,CAAC;iBACV;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,IAAI,CAAC,IAAI,CAAC,CACb;aACA,IAAI,CAAC,MAAM,CAAC,CAChB,CAAA;IACH,CAAC,CACF,CAAA;IAED,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,0DAA0D;QACvE,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF,EACD,KAAK,IAAI,EAAE;QACT,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAA;QAC5B,OAAO,IAAI,CACT;YACE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,0CAA0C;YACpE,WAAW,CAAC,CAAC,OAAO,YAAY,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,MAAM,EAAE;YAC9D,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC,CAAC,EAAE;YACpF,WAAW,MAAM,CAAC,UAAU,UAAU,MAAM,CAAC,GAAG,EAAE;SACnD;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CACd,CAAA;IACH,CAAC,CACF,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,kFAAkF;AAClF,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/dist/stdio.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

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

package/dist/stdio.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * The stdio entry point.
+ *
+ *   TAB_GATEWAY_URL=... TAB_ACCOUNT_ID=0.0.x node --experimental-strip-types src/stdio.ts
+ *
+ * ## STDOUT IS THE PROTOCOL
+ *
+ * A stdio MCP server speaks JSON-RPC on stdout, so a single stray `console.log`
+ * anywhere in the process corrupts the stream and the client reports a parse
+ * error rather than whatever actually went wrong. Every diagnostic here goes to
+ * stderr, deliberately, and nothing else in this package prints at all.
+ *
+ * That is also why `configFromEnv` throws at startup: a server that connects and
+ * then fails every call looks like a broken rail instead of a missing variable.
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { clientFor, configFromEnv } from "./config.js";
+import { buildServer } from "./server.js";
+let config;
+try {
+    config = configFromEnv();
+}
+catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+}
+const server = buildServer(clientFor(config), config);
+process.stderr.write(`tab-mcp · gateway ${config.gatewayUrl} · tab ${config.tab}\n` +
+    'The agent holds no key and signs nothing. 7 tools; only tab_spend moves money.\n');
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=stdio.js.map

package/dist/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAkB,MAAM,aAAa,CAAA;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,IAAI,MAAiB,CAAA;AACrB,IAAI,CAAC;IACH,MAAM,GAAG,aAAa,EAAE,CAAA;AAC1B,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACnF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;AAErD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qBAAqB,MAAM,CAAC,UAAU,UAAU,MAAM,CAAC,GAAG,IAAI;IAC5D,kFAAkF,CACrF,CAAA;AAED,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@0xdivyanshh/tab-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "tab-mcp": "dist/stdio.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@0xdivyanshh/tab-money": "0.1.0",
+    "@0xdivyanshh/tab-protocol": "0.1.0",
+    "@0xdivyanshh/tab-sdk": "0.1.0",
+    "zod": "^3.25.0"
+  },
+  "description": "MCP server for Tab — give any LLM a credit line on Hedera. It holds no key.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xNerd100/Tab.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/0xNerd100/Tab#readme",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "dist/**/*.map",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}