@tabai/sdk 0.2.0

package/dist/mcp/settings.js

@@ -0,0 +1,160 @@
+/**
+ * Where the MCP server gets its settings, and the order it prefers them in.
+ *
+ * Three sources, most specific first:
+ *
+ * 1. the options handed to {@link resolveTabMcpSettings}, which is what a test
+ *    and an embedding host use;
+ * 2. `tab.config.{ts,mts,mjs,js,cjs}`, discovered by walking up from the working
+ *    directory -- the mechanism this package already has for consumer
+ *    configuration, so the MCP surface adds no second one;
+ * 3. the environment, which is what the `mcpServers` stanza `tab connect` writes
+ *    actually carries.
+ *
+ * Every environment variable read here is already declared in the tracked
+ * `.env.example` contract. That is not incidental: the repository's environment
+ * gate extracts every `process.env` read in the tree and fails the build when
+ * one has no declaration, so a new name would be a new line in a contract this
+ * surface has no business changing. The RPC endpoint is `MONAD_RPC_URL`, in the
+ * stanza and here.
+ *
+ * ## No key is a setting
+ *
+ * Nothing in this module reads a private key and nothing returns one. The
+ * settlement signing key is read from the environment at the moment a Settlement
+ * is signed, by the strategy that signs it, and never travels through a config
+ * file or an MCP client's `mcpServers` stanza. That is what makes `tab connect`
+ * safe to run against a file the client software rewrites.
+ *
+ * Requirements: 25.3, 25.5, 28.6
+ */
+import { isAddress } from "../_shared/index.js";
+import { loadTabConfig } from "../payments/config.js";
+import { defaultLogger } from "../logger.js";
+/** The public Monad Testnet explorer, used when nothing names one. */
+export const DEFAULT_EXPLORER_URL = "https://testnet.monadvision.com";
+/** Monad Testnet, used when nothing names a chain. */
+export const DEFAULT_CHAIN_ID = 10143;
+const trimmed = (value) => {
+    const text = value?.trim();
+    return text === undefined || text === "" ? undefined : text;
+};
+/**
+ * The registry read API the environment names.
+ *
+ * `NEXT_PUBLIC_REGISTRY_API_URL` is the deployment's own name for this value and
+ * is already in the environment contract, so it is what is read. When only
+ * `REGISTRY_PORT` is set the read API is taken to be local, which is exactly the
+ * developer case and saves a second variable that would say the same thing.
+ */
+const registryUrlFromEnv = (env) => {
+    const declared = trimmed(env["NEXT_PUBLIC_REGISTRY_API_URL"]);
+    if (declared !== undefined)
+        return { url: declared, source: "env NEXT_PUBLIC_REGISTRY_API_URL" };
+    const port = trimmed(env["REGISTRY_PORT"]);
+    if (port !== undefined && /^[0-9]{1,5}$/.test(port)) {
+        return { url: `http://127.0.0.1:${port}`, source: "env REGISTRY_PORT" };
+    }
+    return undefined;
+};
+/** Keeps the first entry for each serviceId, so a more specific source wins. */
+function mergeServices(...groups) {
+    const byId = new Map();
+    for (const group of groups) {
+        for (const entry of group) {
+            if (typeof entry?.serviceId !== "string" || typeof entry?.endpoint !== "string")
+                continue;
+            const key = entry.serviceId.toLowerCase();
+            if (!byId.has(key))
+                byId.set(key, { ...entry, serviceId: key });
+        }
+    }
+    return [...byId.values()];
+}
+/**
+ * Resolves the settings, loading `tab.config` unless one was handed in.
+ *
+ * Never fails. A config file that cannot be imported is logged and skipped
+ * rather than taking the server down: the tools each report their own missing
+ * settings by name, which is a better message than a startup failure that names
+ * a file the caller may not have known existed.
+ */
+export async function resolveTabMcpSettings(options = {}) {
+    const env = options.env ?? process.env;
+    const logger = options.logger ?? defaultLogger;
+    const sources = {};
+    let config = {};
+    if (options.config === undefined) {
+        const loaded = await loadTabConfig({
+            ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
+            registry: false,
+            logger,
+        });
+        if (loaded.ok) {
+            config = loaded.value.config;
+            if (loaded.value.path !== undefined)
+                sources["config"] = loaded.value.path;
+        }
+        else {
+            logger.warn("tab config could not be loaded; continuing without it", {
+                code: loaded.error.code,
+                message: loaded.error.message,
+            });
+        }
+    }
+    else if (options.config !== false) {
+        config = options.config;
+        sources["config"] = "supplied";
+    }
+    const pick = (key, explicit, fromConfig, fromEnv) => {
+        if (trimmed(explicit) !== undefined) {
+            sources[key] = "options";
+            return trimmed(explicit);
+        }
+        if (trimmed(fromConfig) !== undefined) {
+            sources[key] = "tab.config";
+            return trimmed(fromConfig);
+        }
+        if (fromEnv !== undefined) {
+            sources[key] = fromEnv.source;
+            return fromEnv.value;
+        }
+        return undefined;
+    };
+    const rawAgent = pick("agent", options.agent, config.agent, undefined);
+    const agent = rawAgent !== undefined && isAddress(rawAgent) ? rawAgent.toLowerCase() : undefined;
+    if (rawAgent !== undefined && agent === undefined) {
+        logger.warn("the configured agent is not a 20-byte address and was ignored", { agent: rawAgent });
+        delete sources["agent"];
+    }
+    const envRegistry = registryUrlFromEnv(env);
+    const registryUrl = pick("registryUrl", options.registryUrl, config.registryUrl, envRegistry === undefined ? undefined : { value: envRegistry.url, source: envRegistry.source });
+    const envRpc = trimmed(env["MONAD_RPC_URL"]);
+    const rpcUrl = pick("rpcUrl", options.rpcUrl, undefined, envRpc === undefined ? undefined : { value: envRpc, source: "env MONAD_RPC_URL" });
+    const envChain = trimmed(env["MONAD_CHAIN_ID"]);
+    const chainIdText = pick("chainId", options.chainId === undefined ? undefined : String(options.chainId), undefined, envChain === undefined ? undefined : { value: envChain, source: "env MONAD_CHAIN_ID" });
+    const chainId = chainIdText !== undefined && /^[0-9]+$/.test(chainIdText) ? Number(chainIdText) : DEFAULT_CHAIN_ID;
+    const envExplorer = trimmed(env["MONAD_EXPLORER_URL"]);
+    const explorerUrl = pick("explorerUrl", options.explorerUrl, undefined, envExplorer === undefined ? undefined : { value: envExplorer, source: "env MONAD_EXPLORER_URL" }) ?? DEFAULT_EXPLORER_URL;
+    const services = mergeServices(options.services ?? [], config.services ?? []);
+    if (services.length > 0)
+        sources["services"] = options.services === undefined ? "tab.config" : "options";
+    const strategyId = trimmed(options.strategyId);
+    if (strategyId !== undefined)
+        sources["strategyId"] = "options";
+    const x402 = options.x402 ?? (typeof config.x402 === "function" ? config.x402 : undefined);
+    if (x402 !== undefined)
+        sources["x402"] = options.x402 === undefined ? "tab.config" : "options";
+    return {
+        agent,
+        registryUrl,
+        rpcUrl,
+        chainId,
+        explorerUrl,
+        services,
+        strategyId,
+        x402,
+        sources,
+    };
+}
+//# sourceMappingURL=settings.js.map

package/dist/mcp/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/mcp/settings.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Where the MCP server gets its settings, and the order it prefers them in.\n *\n * Three sources, most specific first:\n *\n * 1. the options handed to {@link resolveTabMcpSettings}, which is what a test\n *    and an embedding host use;\n * 2. `tab.config.{ts,mts,mjs,js,cjs}`, discovered by walking up from the working\n *    directory -- the mechanism this package already has for consumer\n *    configuration, so the MCP surface adds no second one;\n * 3. the environment, which is what the `mcpServers` stanza `tab connect` writes\n *    actually carries.\n *\n * Every environment variable read here is already declared in the tracked\n * `.env.example` contract. That is not incidental: the repository's environment\n * gate extracts every `process.env` read in the tree and fails the build when\n * one has no declaration, so a new name would be a new line in a contract this\n * surface has no business changing. The RPC endpoint is `MONAD_RPC_URL`, in the\n * stanza and here.\n *\n * ## No key is a setting\n *\n * Nothing in this module reads a private key and nothing returns one. The\n * settlement signing key is read from the environment at the moment a Settlement\n * is signed, by the strategy that signs it, and never travels through a config\n * file or an MCP client's `mcpServers` stanza. That is what makes `tab connect`\n * safe to run against a file the client software rewrites.\n *\n * Requirements: 25.3, 25.5, 28.6\n */\n\nimport type { Address } from \"../_shared/index.js\";\nimport { isAddress } from \"../_shared/index.js\";\n\nimport type { TabServiceEntry } from \"../payments/config.js\";\nimport { loadTabConfig, type TabConfig } from \"../payments/config.js\";\nimport { defaultLogger, type Logger } from \"../logger.js\";\nimport type { X402SignerFactory } from \"../x402/client.js\";\n\n/** The settings every tool reads. Each field is resolved or explicitly absent. */\nexport interface TabMcpSettings {\n  /** Whose Open Tab a metered call lands on. Undefined until one is configured. */\n  readonly agent: Address | undefined;\n  /** Absolute base URL of the registry read API, or undefined when none is configured. */\n  readonly registryUrl: string | undefined;\n  /** The Monad JSON-RPC endpoint, used by `doctor` and by nothing that signs. */\n  readonly rpcUrl: string | undefined;\n  /** The EVM chain id every Asset is named against: 143 for Mainnet, 10143 for Testnet. */\n  readonly chainId: number;\n  /** Where a Monad transaction is linked. Always resolved; a default is fine for a link. */\n  readonly explorerUrl: string;\n  /** The endpoint directory, keyed by lower-case serviceId. */\n  readonly services: readonly TabServiceEntry[];\n  /** Which strategy `tab_settle` settles through when the call names none. */\n  readonly strategyId: string | undefined;\n  /**\n   * The x402 signer factory, for `tab_call`'s prepaid fallback. Never called\n   * while settings are resolved; only when a refused call carries an offer.\n   */\n  readonly x402: X402SignerFactory | undefined;\n  /** Where each setting came from, so `doctor` can print it. */\n  readonly sources: Readonly<Record<string, string>>;\n}\n\n/** Explicit settings, which beat both the config file and the environment. */\nexport interface TabMcpSettingsOptions {\n  readonly agent?: string;\n  readonly chainId?: number;\n  readonly registryUrl?: string;\n  readonly rpcUrl?: string;\n  readonly explorerUrl?: string;\n  readonly services?: readonly TabServiceEntry[];\n  readonly strategyId?: string;\n  readonly x402?: X402SignerFactory;\n  /** Where the `tab.config` walk starts. Defaults to the working directory. */\n  readonly cwd?: string;\n  /** `false` skips config discovery entirely, which is what a hermetic test wants. */\n  readonly config?: TabConfig | false;\n  readonly env?: NodeJS.ProcessEnv;\n  readonly logger?: Logger;\n}\n\n/** The public Monad Testnet explorer, used when nothing names one. */\nexport const DEFAULT_EXPLORER_URL = \"https://testnet.monadvision.com\";\n\n/** Monad Testnet, used when nothing names a chain. */\nexport const DEFAULT_CHAIN_ID = 10143;\n\nconst trimmed = (value: string | undefined): string | undefined => {\n  const text = value?.trim();\n  return text === undefined || text === \"\" ? undefined : text;\n};\n\n/**\n * The registry read API the environment names.\n *\n * `NEXT_PUBLIC_REGISTRY_API_URL` is the deployment's own name for this value and\n * is already in the environment contract, so it is what is read. When only\n * `REGISTRY_PORT` is set the read API is taken to be local, which is exactly the\n * developer case and saves a second variable that would say the same thing.\n */\nconst registryUrlFromEnv = (env: NodeJS.ProcessEnv): { url: string; source: string } | undefined => {\n  const declared = trimmed(env[\"NEXT_PUBLIC_REGISTRY_API_URL\"]);\n  if (declared !== undefined) return { url: declared, source: \"env NEXT_PUBLIC_REGISTRY_API_URL\" };\n  const port = trimmed(env[\"REGISTRY_PORT\"]);\n  if (port !== undefined && /^[0-9]{1,5}$/.test(port)) {\n    return { url: `http://127.0.0.1:${port}`, source: \"env REGISTRY_PORT\" };\n  }\n  return undefined;\n};\n\n/** Keeps the first entry for each serviceId, so a more specific source wins. */\nfunction mergeServices(...groups: readonly (readonly TabServiceEntry[])[]): readonly TabServiceEntry[] {\n  const byId = new Map<string, TabServiceEntry>();\n  for (const group of groups) {\n    for (const entry of group) {\n      if (typeof entry?.serviceId !== \"string\" || typeof entry?.endpoint !== \"string\") continue;\n      const key = entry.serviceId.toLowerCase();\n      if (!byId.has(key)) byId.set(key, { ...entry, serviceId: key });\n    }\n  }\n  return [...byId.values()];\n}\n\n/**\n * Resolves the settings, loading `tab.config` unless one was handed in.\n *\n * Never fails. A config file that cannot be imported is logged and skipped\n * rather than taking the server down: the tools each report their own missing\n * settings by name, which is a better message than a startup failure that names\n * a file the caller may not have known existed.\n */\nexport async function resolveTabMcpSettings(\n  options: TabMcpSettingsOptions = {},\n): Promise<TabMcpSettings> {\n  const env = options.env ?? process.env;\n  const logger = options.logger ?? defaultLogger;\n  const sources: Record<string, string> = {};\n\n  let config: TabConfig = {};\n  if (options.config === undefined) {\n    const loaded = await loadTabConfig({\n      ...(options.cwd === undefined ? {} : { cwd: options.cwd }),\n      registry: false,\n      logger,\n    });\n    if (loaded.ok) {\n      config = loaded.value.config;\n      if (loaded.value.path !== undefined) sources[\"config\"] = loaded.value.path;\n    } else {\n      logger.warn(\"tab config could not be loaded; continuing without it\", {\n        code: loaded.error.code,\n        message: loaded.error.message,\n      });\n    }\n  } else if (options.config !== false) {\n    config = options.config;\n    sources[\"config\"] = \"supplied\";\n  }\n\n  const pick = (\n    key: string,\n    explicit: string | undefined,\n    fromConfig: string | undefined,\n    fromEnv: { value: string; source: string } | undefined,\n  ): string | undefined => {\n    if (trimmed(explicit) !== undefined) {\n      sources[key] = \"options\";\n      return trimmed(explicit);\n    }\n    if (trimmed(fromConfig) !== undefined) {\n      sources[key] = \"tab.config\";\n      return trimmed(fromConfig);\n    }\n    if (fromEnv !== undefined) {\n      sources[key] = fromEnv.source;\n      return fromEnv.value;\n    }\n    return undefined;\n  };\n\n  const rawAgent = pick(\"agent\", options.agent, config.agent, undefined);\n  const agent = rawAgent !== undefined && isAddress(rawAgent) ? (rawAgent.toLowerCase() as Address) : undefined;\n  if (rawAgent !== undefined && agent === undefined) {\n    logger.warn(\"the configured agent is not a 20-byte address and was ignored\", { agent: rawAgent });\n    delete sources[\"agent\"];\n  }\n\n  const envRegistry = registryUrlFromEnv(env);\n  const registryUrl = pick(\n    \"registryUrl\",\n    options.registryUrl,\n    config.registryUrl,\n    envRegistry === undefined ? undefined : { value: envRegistry.url, source: envRegistry.source },\n  );\n\n  const envRpc = trimmed(env[\"MONAD_RPC_URL\"]);\n  const rpcUrl = pick(\n    \"rpcUrl\",\n    options.rpcUrl,\n    undefined,\n    envRpc === undefined ? undefined : { value: envRpc, source: \"env MONAD_RPC_URL\" },\n  );\n\n  const envChain = trimmed(env[\"MONAD_CHAIN_ID\"]);\n  const chainIdText = pick(\n    \"chainId\",\n    options.chainId === undefined ? undefined : String(options.chainId),\n    undefined,\n    envChain === undefined ? undefined : { value: envChain, source: \"env MONAD_CHAIN_ID\" },\n  );\n  const chainId = chainIdText !== undefined && /^[0-9]+$/.test(chainIdText) ? Number(chainIdText) : DEFAULT_CHAIN_ID;\n\n  const envExplorer = trimmed(env[\"MONAD_EXPLORER_URL\"]);\n  const explorerUrl =\n    pick(\n      \"explorerUrl\",\n      options.explorerUrl,\n      undefined,\n      envExplorer === undefined ? undefined : { value: envExplorer, source: \"env MONAD_EXPLORER_URL\" },\n    ) ?? DEFAULT_EXPLORER_URL;\n\n  const services = mergeServices(options.services ?? [], config.services ?? []);\n  if (services.length > 0) sources[\"services\"] = options.services === undefined ? \"tab.config\" : \"options\";\n\n  const strategyId = trimmed(options.strategyId);\n  if (strategyId !== undefined) sources[\"strategyId\"] = \"options\";\n\n  const x402 = options.x402 ?? (typeof config.x402 === \"function\" ? config.x402 : undefined);\n  if (x402 !== undefined) sources[\"x402\"] = options.x402 === undefined ? \"tab.config\" : \"options\";\n\n  return {\n    agent,\n    registryUrl,\n    rpcUrl,\n    chainId,\n    explorerUrl,\n    services,\n    strategyId,\n    x402,\n    sources,\n  };\n}\n"]}

package/dist/mcp/toolset.d.ts

@@ -0,0 +1,231 @@
+/**
+ * The four Tab tools, as functions.
+ *
+ * The MCP protocol wiring lives next door in `server.ts`. This file is the
+ * behaviour, and it is separate so the tools can be exercised without a
+ * transport: every test in `test/mcp-tools.test.mjs` calls these directly, which
+ * is what lets task 16.3 validate every output against its declared schema
+ * without standing a server up.
+ *
+ * ## Nothing here throws, including into the transport
+ *
+ * A tool that throws over stdio does not produce a bad answer, it produces no
+ * answer: the MCP client sees a protocol error, the model sees nothing it can
+ * reason about, and a long-running server can lose its transport to one
+ * malformed argument. So every entry point below returns a value that validates
+ * against the tool's declared output schema, on every path, including the paths
+ * where the work failed. A failure is `error: { category, code, message }` in
+ * the payload, and for `tab_call` and `tab_settle` it is `ok: false` beside it.
+ *
+ * `LIMIT_EXCEEDED` is the case that earns the discipline. An Agent out of
+ * headroom is not an error in the Agent, the Service, or the call -- it is the
+ * credit facility working. The tool answers `ok: false` with
+ * `requiredBaseUnits` and `headroomBaseUnits` both filled in, so the model can
+ * settle the difference and call again instead of retrying into the same wall.
+ * (R21.5)
+ *
+ * ## Every input is validated against the schema that was published
+ *
+ * Not a hand-written check that resembles it. {@link applyJsonDefaults} fills in
+ * the declared defaults and {@link validateJsonValue} enforces the same document
+ * `tools/list` served, so a `limit` of 500 is refused with the same bound the
+ * model was shown.
+ *
+ * Requirements: 21.5, 25.1, 25.2, 25.3, 25.4
+ */
+import type { Result, TabError } from "../_shared/index.js";
+import { type Tab402Fetch, type Tab402Response } from "../http/client-402.js";
+import { type Logger } from "../logger.js";
+import { type StrategyRegistry } from "../payments/registry.js";
+import { type RegistryFetch, type RegistryReadClient } from "./registry-client.js";
+import { type HubFetch } from "../x402/hub.js";
+import type { TabMcpSettings } from "./settings.js";
+/** The error block every output can carry. */
+export interface TabToolError {
+    readonly category: TabError["category"];
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly requiredBaseUnits?: string;
+    readonly headroomBaseUnits?: string;
+}
+export interface DiscoveredAsset {
+    readonly chainId: number;
+    readonly address: string;
+    readonly symbol: string | null;
+    readonly decimals: number | null;
+    readonly collectionAddress: string | null;
+    readonly curatedAsset: boolean;
+}
+export interface DiscoveredTool {
+    readonly tool: string;
+    readonly toolName: string | null;
+    readonly asset: string;
+    readonly priceBaseUnits: string;
+}
+export interface DiscoveredBond {
+    readonly asset: string;
+    readonly stakedBaseUnits: string;
+    readonly freeBaseUnits: string;
+}
+export interface DiscoveredHubEndpoint {
+    readonly endpoint: string;
+    readonly name: string | null;
+    readonly description: string | null;
+    readonly priceType: string;
+    readonly priceUsd: string | null;
+    readonly priceBaseUnits: string | null;
+    readonly networks: readonly string[];
+}
+/** The API Hub provider a Service fronts, with its endpoints as the Service's tools. */
+export interface DiscoveredHub {
+    readonly provider: string;
+    readonly prefix: string;
+    readonly endpoints: readonly DiscoveredHubEndpoint[];
+    readonly total: number;
+    /** Present when the manifest could not be read; `endpoints` is then empty. */
+    readonly error?: TabToolError;
+}
+export interface DiscoveredService {
+    readonly serviceId: string;
+    readonly name: string | null;
+    readonly endpoint: string | null;
+    readonly tier: "curated" | "permissionless" | "unknown";
+    readonly settlementWindowSeconds: number;
+    readonly assets: readonly DiscoveredAsset[];
+    readonly tools: readonly DiscoveredTool[];
+    readonly bonds: readonly DiscoveredBond[];
+    readonly pendingChange: {
+        readonly changeId: string;
+        readonly kind: string | null;
+        readonly etaIso: string | null;
+    } | null;
+    readonly hub?: DiscoveredHub;
+}
+export interface TabDiscoverOutput {
+    readonly services: readonly DiscoveredService[];
+    readonly error?: TabToolError;
+}
+/** The prepaid receipt a call carries when x402 paid for it instead of the Open Tab. */
+export interface TabCallX402Block {
+    readonly txHash: string;
+    readonly network: string;
+    readonly amountBaseUnits: string;
+    readonly asset: string;
+    readonly payTo: string;
+    readonly payer: string;
+    readonly explorerUrl: string | null;
+}
+export interface TabCallOutput {
+    readonly ok: boolean;
+    readonly result?: unknown;
+    readonly charge?: {
+        readonly amountBaseUnits: string;
+        readonly asset: string;
+        readonly tool: string;
+    };
+    readonly tab?: {
+        readonly openTabBaseUnits: string;
+        readonly headroomBaseUnits: string;
+        readonly creditLimitBaseUnits?: string;
+        readonly asset: string;
+        readonly settlementDueIso?: string | null;
+    };
+    readonly x402?: TabCallX402Block;
+    readonly error?: TabToolError;
+}
+export interface TabStatusOutput {
+    readonly agent: string;
+    /**
+     * The Monad block every figure here is as at, from the index that served them.
+     *
+     * A Settlement in a later block is not yet reflected; the index reaches it
+     * within a few blocks. Null when the index has never ticked or the read failed.
+     */
+    readonly indexedBlock: number | null;
+    readonly perAsset: readonly {
+        readonly asset: string;
+        readonly creditLimitBaseUnits: string | null;
+        readonly openTabBaseUnits: string;
+        readonly prepaidBaseUnits: string | null;
+        readonly headroomBaseUnits: string | null;
+        readonly delinquent: boolean;
+        readonly tabs: readonly {
+            readonly tabId: string | null;
+            readonly serviceId: string;
+            readonly openBaseUnits: string;
+            readonly dueIso: string | null;
+        }[];
+    }[];
+    readonly settlements?: readonly {
+        readonly settlementId: string;
+        readonly txHash: string;
+        readonly serviceId: string;
+        readonly asset: string;
+        readonly amountBaseUnits: string;
+        readonly appliedBaseUnits: string;
+        readonly prepaidBaseUnits: string;
+        readonly explorerUrl: string | null;
+    }[];
+    readonly error?: TabToolError;
+}
+export interface TabSettleOutput {
+    readonly ok: boolean;
+    readonly dryRun: boolean;
+    readonly txHash?: string | null;
+    readonly chainId?: number | null;
+    readonly amountBaseUnits: string;
+    readonly settlementId?: string | null;
+    readonly appliedBaseUnits?: string | null;
+    readonly prepaidBaseUnits?: string | null;
+    readonly explorerUrl?: string | null;
+    readonly error?: TabToolError;
+}
+export interface TabToolsetOptions {
+    readonly settings: TabMcpSettings;
+    /** Overrides the client built from `settings.registryUrl`. A test hands in a stub. */
+    readonly registry?: RegistryReadClient;
+    /** The `fetch` `tab_call` sends Service requests with. Defaults to the host's. */
+    readonly fetchImpl?: Tab402Fetch<Tab402Response>;
+    /**
+     * The `fetch` the registry read client uses, when one is built from settings.
+     *
+     * Separate from {@link TabToolsetOptions.fetchImpl} because the two talk to
+     * different things: one to a third party's Service, one to the read API. A
+     * test that stubs a Service should not silently start answering registry
+     * reads too.
+     */
+    readonly registryFetch?: RegistryFetch;
+    /** The `fetch` `tab_discover` reads API Hub manifests with. Defaults to the host's. */
+    readonly hubFetch?: HubFetch;
+    /**
+     * Where `tab_settle` resolves a strategy.
+     *
+     * Absent, the module-level registry is used, and `tab_settle` fills it from
+     * `tab.config` the first time it is called. See {@link TabToolset.settle} for
+     * why that load is deferred rather than done at startup.
+     */
+    readonly strategies?: StrategyRegistry;
+    /** Where the deferred `tab.config` load walks from. Defaults to the working directory. */
+    readonly cwd?: string;
+    readonly logger?: Logger;
+    readonly now?: () => number;
+    /**
+     * The environment the Asset table is read from: on Testnet `MOCK_USDC_ADDRESS`
+     * names the token this deployment settles in. Defaults to the process
+     * environment; a test passes its own so a machine's configuration cannot
+     * change a result.
+     */
+    readonly env?: NodeJS.ProcessEnv;
+}
+/** The four tools, plus a dispatcher the MCP server calls by name. */
+export interface TabToolset {
+    discover(input: unknown): Promise<TabDiscoverOutput>;
+    call(input: unknown): Promise<TabCallOutput>;
+    status(input: unknown): Promise<TabStatusOutput>;
+    settle(input: unknown): Promise<TabSettleOutput>;
+    /** Dispatches by MCP tool name. `NOT_FOUND` for a name this package does not declare. */
+    invoke(name: string, input: unknown): Promise<Result<unknown>>;
+}
+export declare function createTabToolset(options: TabToolsetOptions): TabToolset;
+//# sourceMappingURL=toolset.d.ts.map

package/dist/mcp/toolset.d.ts.map

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