@toon-protocol/client-mcp 0.1.0 → 0.2.0

package/dist/daemon.js

@@ -4,7 +4,7 @@ import {
   ClientRunner,
   registerRoutes,
   scaffoldFirstRun
-} from "./chunk-3NAWISI5.js";
+} from "./chunk-L6F2B3GX.js";
 import {
   ControlClient,
   ToonClient,
@@ -17,9 +17,9 @@ import {
   resolveConfig,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-5KFXUT5Q.js";
+} from "./chunk-NP35YO5O.js";
 import "./chunk-32QD72IL.js";
-import "./chunk-FSS45ZX3.js";
+import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";
 import "./chunk-VA7XC4FD.js";
 import "./chunk-SKQTKZIH.js";

package/dist/{ed25519-2QVPINLS.js → ed25519-2LFQXLYS.js}

@@ -3,25 +3,29 @@ import {
   ED25519_TORSION_SUBGROUP,
   _map_to_curve_elligator2_curve25519,
   ed25519,
+  ed25519_FROST,
   ed25519_hasher,
   ed25519ctx,
   ed25519ph,
   ristretto255,
+  ristretto255_FROST,
   ristretto255_hasher,
   ristretto255_oprf,
   x25519
-} from "./chunk-FSS45ZX3.js";
+} from "./chunk-DLYE6U2Z.js";
 import "./chunk-F22GNSF6.js";
 export {
   ED25519_TORSION_SUBGROUP,
   _map_to_curve_elligator2_curve25519,
   ed25519,
+  ed25519_FROST,
   ed25519_hasher,
   ed25519ctx,
   ed25519ph,
   ristretto255,
+  ristretto255_FROST,
   ristretto255_hasher,
   ristretto255_oprf,
   x25519
 };
-//# sourceMappingURL=ed25519-2QVPINLS.js.map
+//# sourceMappingURL=ed25519-2LFQXLYS.js.map

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import { NostrEvent } from 'nostr-tools/pure';
+import { NostrEvent, EventTemplate } from 'nostr-tools/pure';
 import { SwapPair } from '@toon-protocol/core';
 import { ToonClientConfig } from '@toon-protocol/client';
 import { FastifyInstance } from 'fastify';
+import { ViewSpec } from '@toon-protocol/views';
 
 /**
  * Shared request/response contract for the `toon-clientd` localhost control
@@ -90,6 +91,58 @@ interface PublishResponse {
     /** Channel nonce after this publish (advances by one per paid write). */
     nonce: number;
 }
+/**
+ * `POST /publish-unsigned` — build, SIGN (with the daemon-held key), and
+ * pay-to-write a Nostr event. The caller (a UI/agent) supplies only the event
+ * shell — it never holds the private key. For replaceable kinds (0 profile,
+ * 3 follow list) the daemon merges the latest known event's tags before signing.
+ */
+interface PublishUnsignedRequest {
+    /** Event kind to publish (integer, 0–65535). */
+    kind: number;
+    /** Event content (default ''). */
+    content?: string;
+    /** Event tags (array of string arrays). */
+    tags?: string[][];
+    /** ILP destination override (default: the configured apex/town address). */
+    destination?: string;
+    /** Fee override in base units. Defaults to the daemon's configured fee. */
+    fee?: string;
+    /** Which apex (BTP write target) to publish through (default: config-seeded). */
+    btpUrl?: string;
+}
+/**
+ * `POST /upload-media` — two-step spendy write: upload bytes to Arweave via the
+ * kind:5094 blob-storage DVM, then sign+publish a media event referencing the
+ * resulting Arweave URL. Single-packet only (large media is out of scope; see
+ * `requestBlobStorage`).
+ */
+interface UploadMediaRequest {
+    /** Base64-encoded media bytes. */
+    dataBase64: string;
+    /** MIME type (default 'application/octet-stream'). */
+    mime?: string;
+    /**
+     * Kind of the media event to publish referencing the upload. Default 1063
+     * (NIP-94 file metadata). 20 = NIP-68 picture, 21/22 = NIP-71 video, 1 = note
+     * with a NIP-92 `imeta` attachment.
+     */
+    kind?: number;
+    /** Caption / content for the published media event. */
+    caption?: string;
+    /** Extra tags merged into the published media event. */
+    tags?: string[][];
+    /** Fee override in base units (applies to the upload + the publish). */
+    fee?: string;
+    /** Which apex to publish through (default: config-seeded). */
+    btpUrl?: string;
+}
+interface UploadMediaResponse extends PublishResponse {
+    /** Arweave URL the media event references. */
+    url: string;
+    /** Arweave transaction id of the uploaded blob. */
+    txId: string;
+}
 /** `POST /subscribe` — register a persistent free-read subscription. */
 interface SubscribeRequest {
     /** NIP-01 filter(s). A single object or an array of OR-ed filters. */
@@ -108,6 +161,18 @@ interface SubscribeResponse {
     /** The relays the subscription was registered on. */
     relays: string[];
 }
+/**
+ * `POST /query` — one-shot free read: subscribe the filter(s), wait briefly, and
+ * return every buffered event matching them. Used by the apps `toon_query` tool.
+ */
+interface QueryRequest {
+    filters: NostrFilter | NostrFilter[];
+    /** Bounded wait for relay delivery, ms (default 1200). */
+    timeoutMs?: number;
+}
+interface QueryResponse {
+    events: NostrEvent[];
+}
 /** `GET /events` — drain buffered events for a subscription (free read). */
 interface EventsQuery {
     /** Restrict to a single subscription id. */
@@ -211,6 +276,36 @@ interface SwapResponse {
     /** First rejection message, if any. */
     message?: string;
 }
+/**
+ * `POST /http-fetch-paid` — payment-aware HTTP GET/POST. The daemon issues the
+ * request via `ToonClient.h402Fetch`; if the origin answers `402 Payment
+ * Required` the client transparently pays over TOON and retries, returning the
+ * settled resource. The caller never holds chain keys — settlement happens
+ * inside the daemon against the open apex channel.
+ */
+interface HttpFetchPaidRequest {
+    /** Absolute URL of the resource to fetch (the origin may gate it behind 402). */
+    url: string;
+    /** HTTP method (default GET). */
+    method?: string;
+    /** Request headers as a flat string→string map. */
+    headers?: Record<string, string>;
+    /** Request body (string; sent verbatim). Typically used with POST. */
+    body?: string;
+    /** Per-request timeout, ms (passed through to the client). */
+    timeout?: number;
+}
+interface HttpFetchPaidResponse {
+    /** Final HTTP status after any 402-pay-and-retry round trip. */
+    status: number;
+    /** Response headers as a flat string→string map. */
+    headers: Record<string, string>;
+    /**
+     * Response body decoded as text. Binary bodies are returned as their decoded
+     * text for v1 (acceptable; a base64 path can be added later if needed).
+     */
+    body: string;
+}
 /** `POST /relays` — add a relay READ target (fans into all fan-out reads). */
 interface AddRelayRequest {
     /** Relay WS URL, e.g. `ws://host:7100` or a `.anyone` hidden service. */
@@ -337,13 +432,17 @@ declare class ControlClient {
     ping(): Promise<boolean>;
     status(): Promise<StatusResponse>;
     publish(body: PublishRequest): Promise<PublishResponse>;
+    publishUnsigned(body: PublishUnsignedRequest): Promise<PublishResponse>;
+    uploadMedia(body: UploadMediaRequest): Promise<UploadMediaResponse>;
     subscribe(body: SubscribeRequest): Promise<SubscribeResponse>;
+    query(body: QueryRequest): Promise<QueryResponse>;
     events(query?: EventsQuery): Promise<EventsResponse>;
     openChannel(body?: OpenChannelRequest): Promise<{
         channelId: string;
     }>;
     channels(): Promise<ChannelsResponse>;
     swap(body: SwapRequest): Promise<SwapResponse>;
+    httpFetchPaid(body: HttpFetchPaidRequest): Promise<HttpFetchPaidResponse>;
     targets(): Promise<TargetsResponse>;
     addRelay(body: AddRelayRequest): Promise<TargetsResponse>;
     removeRelay(body: RemoveRelayRequest): Promise<TargetsResponse>;
@@ -674,6 +773,28 @@ interface ToonClientLike {
         error?: string;
     }>;
     signBalanceProof(channelId: string, amount: bigint): Promise<unknown>;
+    /**
+     * Sign an unsigned event template with the daemon-held Nostr key (the key
+     * never leaves the daemon). Backs the `publish-unsigned` / `upload-media`
+     * paths so a UI/agent supplies only the event shell.
+     */
+    signEvent(template: EventTemplate): NostrEvent | Promise<NostrEvent>;
+    /**
+     * Upload bytes to Arweave via the kind:5094 blob-storage DVM (single-packet),
+     * returning the Arweave tx id. Reuses the client's claim/channel plumbing.
+     */
+    uploadBlob(params: {
+        blobData: Uint8Array;
+        contentType?: string;
+        bid?: string;
+        destination?: string;
+        ilpAmount?: bigint;
+    }): Promise<{
+        success: boolean;
+        txId?: string;
+        eventId?: string;
+        error?: string;
+    }>;
     openChannel(destination?: string): Promise<string>;
     getTrackedChannels(): string[];
     getChannelNonce(channelId: string): number;
@@ -689,6 +810,18 @@ interface ToonClientLike {
         code?: string;
         message?: string;
     }>;
+    /**
+     * Payment-aware HTTP fetch: issue the request and, on a `402 Payment
+     * Required`, transparently pay over TOON and retry, returning the settled Web
+     * `Response`. Pinned to the `ToonClient.h402Fetch` shape (issue #50).
+     */
+    h402Fetch(url: string, opts?: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: string | Uint8Array;
+        timeout?: number;
+        destination?: string;
+    }): Promise<Response>;
 }
 /** A started managed proxy: just the teardown handle the runner needs. */
 interface ManagedProxyHandle {
@@ -781,6 +914,16 @@ declare class ClientRunner {
      * every relay (and onto relays added later); with one it targets that relay.
      */
     subscribe(req: SubscribeRequest): SubscribeResponse;
+    /**
+     * One-shot free read: subscribe the given filter(s) across all relays, wait a
+     * bounded window for the relay(s) to deliver, then return every buffered event
+     * matching the filter (matched by content, not subId — so events already
+     * buffered by other subscriptions are included despite the global dedup).
+     *
+     * Backs the apps `toon_query` tool the generative-UI runtime calls to resolve
+     * a ViewSpec node's data bind.
+     */
+    query(filters: NostrFilter | NostrFilter[], timeoutMs?: number): Promise<NostrEvent[]>;
     /** Drain merged events newer than the cursor (free read), optionally scoped. */
     getEvents(query: EventsQuery): EventsResponse;
     private makeApex;
@@ -821,6 +964,26 @@ declare class ClientRunner {
     getTargets(): TargetsResponse;
     /** Pay-to-write a single event through the selected (or default) apex. */
     publish(req: PublishRequest): Promise<PublishResponse>;
+    /**
+     * Build, sign (with the daemon-held key), and pay-to-write an event. The
+     * caller supplies only the event shell; the private key never leaves the
+     * daemon. Payloads are MODEL-AUTHORED → validated server-side here (the model
+     * is not a security boundary). Replaceable kinds (0/3) merge the latest known
+     * event's tags before signing.
+     */
+    publishUnsigned(req: PublishUnsignedRequest): Promise<PublishResponse>;
+    /**
+     * Upload media to Arweave (kind:5094 blob DVM, single-packet) then sign+publish
+     * a media event referencing the resulting URL. One spendy operation, two steps,
+     * entirely server-side.
+     */
+    uploadMedia(req: UploadMediaRequest): Promise<UploadMediaResponse>;
+    /** Validate + assemble a signable event template (with replaceable merge). */
+    private buildTemplate;
+    /** Latest self-authored event of `kind` currently in the merged read buffer. */
+    private latestSelfReplaceable;
+    /** Tags for a published media event referencing an Arweave URL. */
+    private buildMediaTags;
     /** Open (or return) a payment channel on the selected (or default) apex. */
     openChannel(destination?: string, btpUrl?: string): Promise<{
         channelId: string;
@@ -829,6 +992,12 @@ declare class ClientRunner {
     getChannels(): ChannelsResponse;
     /** Swap source→target asset against a mill peer via the selected apex. */
     swap(req: SwapRequest): Promise<SwapResponse>;
+    /**
+     * Payment-aware HTTP fetch through an apex's client. The client issues the
+     * request and, on `402 Payment Required`, pays over TOON and retries; we
+     * translate the resulting Web `Response` into the wire envelope.
+     */
+    httpFetchPaid(req: HttpFetchPaidRequest): Promise<HttpFetchPaidResponse>;
     /** Graceful teardown: close every relay + stop every apex client + read proxy. */
     stop(): Promise<void>;
     private selectApex;
@@ -944,6 +1113,8 @@ interface ToolDefinition {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
+    /** MCP-apps metadata, e.g. `{ ui: { resourceUri } }` linking a UI resource. */
+    _meta?: Record<string, unknown>;
 }
 /** MCP tool-call result shape (subset of the SDK's CallToolResult). */
 interface ToolResult {
@@ -951,6 +1122,8 @@ interface ToolResult {
         type: 'text';
         text: string;
     }[];
+    /** Machine-readable payload the MCP-app iframe reads (events, ViewSpec, …). */
+    structuredContent?: Record<string, unknown>;
     isError?: boolean;
 }
 declare const TOOL_DEFINITIONS: ToolDefinition[];
@@ -962,4 +1135,51 @@ declare const TOOL_DEFINITIONS: ToolDefinition[];
  */
 declare function dispatchTool(client: ControlClient, name: string, args: Record<string, unknown>): Promise<ToolResult>;
 
-export { type AddApexRequest, type AddApexResponse, type AddRelayRequest, type ApexNegotiationConfig, type ApexTargetStatus, type ChainStatus, type ChannelInfo, type ChannelsResponse, ClientRunner, type ClientRunnerDeps, ControlApiError, ControlClient, type ControlClientOptions, DEFAULT_KEYSTORE_PASSWORD, type DaemonConfigFile, DaemonUnreachableError, type DrainResult, type ErrorResponse, type EventsQuery, type EventsResponse, type MinimalWebSocket, type NostrFilter, NotReadyError, type OpenChannelRequest, PublishRejectedError, type PublishRequest, type PublishResponse, RelaySubscription, type RelaySubscriptionOptions, type RelayTargetStatus, type RemoveApexRequest, type RemoveRelayRequest, type ResolvedDaemonConfig, type SettlementChain, type StatusResponse, type SubscribeRequest, type SubscribeResponse, type SwapClaim, type SwapRequest, type SwapResponse, TOOL_DEFINITIONS, type TargetsResponse, type ToolDefinition, type ToolResult, type ToonClientLike, type WebSocketFactory, acquireLock, configDir, defaultConfigPath, defaultKeystorePath, dispatchTool, hasConfiguredIdentity, isDaemonRunning, isProcessAlive, readConfigFile, readPid, registerRoutes, releaseLock, resolveConfig, resolveMnemonic, scaffoldFirstRun, spawnDaemonDetached, waitForReady };
+/** Accumulated per-step results keyed by step id. */
+type JourneyState = Record<string, unknown>;
+/** One step in a journey: a tool call with a ViewSpec renderer. */
+interface JourneyStep {
+    /** Unique identifier for this step within the plan. */
+    id: string;
+    /** MCP tool name to call (e.g. `toon_status`, `toon_publish_unsigned`). */
+    toolName: string;
+    /** Build the tool input from accumulated prior-step state. */
+    buildInput: (state: JourneyState) => Record<string, unknown>;
+    /** Render the step's result data as a ViewSpec panel. */
+    renderPanel: (data: unknown) => ViewSpec;
+}
+/** Ordered sequence of steps with plan metadata. */
+interface JourneyPlan {
+    id: string;
+    title: string;
+    steps: JourneyStep[];
+}
+/** Result for one executed step. */
+interface JourneyStepResult {
+    stepId: string;
+    /** Raw ToolResult from the tool call. */
+    toolResult: ToolResult;
+    /** ToolResult carrying the step's ViewSpec panel as structuredContent. */
+    panel: ToolResult;
+}
+/** Final result of a runJourney call. */
+interface JourneyResult {
+    /** True when all steps completed without error. */
+    completed: boolean;
+    /** Results for every step that ran (may be partial on error). */
+    steps: JourneyStepResult[];
+    /** Present when the run halted due to a tool error. */
+    error?: {
+        stepId: string;
+        message: string;
+    };
+}
+
+/**
+ * Run all steps in the plan sequentially against the given ControlClient.
+ * Each step's result is threaded forward into the next step's buildInput via
+ * JourneyState. Halts on the first tool error and returns a partial result.
+ */
+declare function runJourney(plan: JourneyPlan, client: ControlClient): Promise<JourneyResult>;
+
+export { type AddApexRequest, type AddApexResponse, type AddRelayRequest, type ApexNegotiationConfig, type ApexTargetStatus, type ChainStatus, type ChannelInfo, type ChannelsResponse, ClientRunner, type ClientRunnerDeps, ControlApiError, ControlClient, type ControlClientOptions, DEFAULT_KEYSTORE_PASSWORD, type DaemonConfigFile, DaemonUnreachableError, type DrainResult, type ErrorResponse, type EventsQuery, type EventsResponse, type HttpFetchPaidRequest, type HttpFetchPaidResponse, type JourneyPlan, type JourneyResult, type JourneyState, type JourneyStep, type JourneyStepResult, type MinimalWebSocket, type NostrFilter, NotReadyError, type OpenChannelRequest, PublishRejectedError, type PublishRequest, type PublishResponse, type PublishUnsignedRequest, type QueryRequest, type QueryResponse, RelaySubscription, type RelaySubscriptionOptions, type RelayTargetStatus, type RemoveApexRequest, type RemoveRelayRequest, type ResolvedDaemonConfig, type SettlementChain, type StatusResponse, type SubscribeRequest, type SubscribeResponse, type SwapClaim, type SwapRequest, type SwapResponse, TOOL_DEFINITIONS, type TargetsResponse, type ToolDefinition, type ToolResult, type ToonClientLike, type UploadMediaRequest, type UploadMediaResponse, type WebSocketFactory, acquireLock, configDir, defaultConfigPath, defaultKeystorePath, dispatchTool, hasConfiguredIdentity, isDaemonRunning, isProcessAlive, readConfigFile, readPid, registerRoutes, releaseLock, resolveConfig, resolveMnemonic, runJourney, scaffoldFirstRun, spawnDaemonDetached, waitForReady };

package/dist/index.js

@@ -8,11 +8,11 @@ import {
   hasConfiguredIdentity,
   registerRoutes,
   scaffoldFirstRun
-} from "./chunk-3NAWISI5.js";
+} from "./chunk-L6F2B3GX.js";
 import {
   TOOL_DEFINITIONS,
   dispatchTool
-} from "./chunk-ZQKYZJWT.js";
+} from "./chunk-KNQ2DKNN.js";
 import {
   ControlApiError,
   ControlClient,
@@ -30,13 +30,48 @@ import {
   resolveMnemonic,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-5KFXUT5Q.js";
+} from "./chunk-NP35YO5O.js";
 import "./chunk-32QD72IL.js";
-import "./chunk-FSS45ZX3.js";
+import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";
 import "./chunk-VA7XC4FD.js";
 import "./chunk-SKQTKZIH.js";
 import "./chunk-F22GNSF6.js";
+
+// src/journey/runner.ts
+async function runJourney(plan, client) {
+  const state = {};
+  const completedSteps = [];
+  for (const step of plan.steps) {
+    const toolResult = await dispatchTool(client, step.toolName, step.buildInput(state));
+    if (toolResult.isError) {
+      return {
+        completed: false,
+        steps: completedSteps,
+        error: { stepId: step.id, message: toolResult.content[0]?.text ?? "Tool error" }
+      };
+    }
+    const data = extractData(toolResult);
+    state[step.id] = data;
+    const viewSpec = step.renderPanel(data);
+    const panel = {
+      content: [{ type: "text", text: `Journey step: ${step.id}` }],
+      structuredContent: { viewSpec }
+    };
+    completedSteps.push({ stepId: step.id, toolResult, panel });
+  }
+  return { completed: true, steps: completedSteps };
+}
+function extractData(result) {
+  if (result.structuredContent !== void 0) return result.structuredContent;
+  const text = result.content[0]?.text;
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
 export {
   ClientRunner,
   ControlApiError,
@@ -61,6 +96,7 @@ export {
   releaseLock,
   resolveConfig,
   resolveMnemonic,
+  runJourney,
   scaffoldFirstRun,
   spawnDaemonDetached,
   waitForReady

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/journey/runner.ts"],"sourcesContent":["import { dispatchTool, type ToolResult } from '../mcp-tools.js';\nimport type { ControlClient } from '../control-client.js';\nimport type { JourneyPlan, JourneyResult, JourneyState } from './types.js';\n\n/**\n * Run all steps in the plan sequentially against the given ControlClient.\n * Each step's result is threaded forward into the next step's buildInput via\n * JourneyState. Halts on the first tool error and returns a partial result.\n */\nexport async function runJourney(\n  plan: JourneyPlan,\n  client: ControlClient\n): Promise<JourneyResult> {\n  const state: JourneyState = {};\n  const completedSteps: JourneyResult['steps'] = [];\n\n  for (const step of plan.steps) {\n    const toolResult = await dispatchTool(client, step.toolName, step.buildInput(state));\n\n    if (toolResult.isError) {\n      return {\n        completed: false,\n        steps: completedSteps,\n        error: { stepId: step.id, message: toolResult.content[0]?.text ?? 'Tool error' },\n      };\n    }\n\n    const data = extractData(toolResult);\n    state[step.id] = data;\n\n    const viewSpec = step.renderPanel(data);\n    const panel: ToolResult = {\n      content: [{ type: 'text', text: `Journey step: ${step.id}` }],\n      structuredContent: { viewSpec },\n    };\n\n    completedSteps.push({ stepId: step.id, toolResult, panel });\n  }\n\n  return { completed: true, steps: completedSteps };\n}\n\n/** Extract the data payload from a successful ToolResult for state threading. */\nfunction extractData(result: ToolResult): unknown {\n  if (result.structuredContent !== undefined) return result.structuredContent;\n  const text = result.content[0]?.text;\n  if (!text) return null;\n  try {\n    return JSON.parse(text);\n  } catch {\n    return text;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,eAAsB,WACpB,MACA,QACwB;AACxB,QAAM,QAAsB,CAAC;AAC7B,QAAM,iBAAyC,CAAC;AAEhD,aAAW,QAAQ,KAAK,OAAO;AAC7B,UAAM,aAAa,MAAM,aAAa,QAAQ,KAAK,UAAU,KAAK,WAAW,KAAK,CAAC;AAEnF,QAAI,WAAW,SAAS;AACtB,aAAO;AAAA,QACL,WAAW;AAAA,QACX,OAAO;AAAA,QACP,OAAO,EAAE,QAAQ,KAAK,IAAI,SAAS,WAAW,QAAQ,CAAC,GAAG,QAAQ,aAAa;AAAA,MACjF;AAAA,IACF;AAEA,UAAM,OAAO,YAAY,UAAU;AACnC,UAAM,KAAK,EAAE,IAAI;AAEjB,UAAM,WAAW,KAAK,YAAY,IAAI;AACtC,UAAM,QAAoB;AAAA,MACxB,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,iBAAiB,KAAK,EAAE,GAAG,CAAC;AAAA,MAC5D,mBAAmB,EAAE,SAAS;AAAA,IAChC;AAEA,mBAAe,KAAK,EAAE,QAAQ,KAAK,IAAI,YAAY,MAAM,CAAC;AAAA,EAC5D;AAEA,SAAO,EAAE,WAAW,MAAM,OAAO,eAAe;AAClD;AAGA,SAAS,YAAY,QAA6B;AAChD,MAAI,OAAO,sBAAsB,OAAW,QAAO,OAAO;AAC1D,QAAM,OAAO,OAAO,QAAQ,CAAC,GAAG;AAChC,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI;AACF,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/mcp.js

@@ -1,9 +1,10 @@
 #!/usr/bin/env node
 import { createRequire as __cr } from 'module'; const require = __cr(import.meta.url);
 import {
+  APP_RESOURCE_URI,
   TOOL_DEFINITIONS,
   dispatchTool
-} from "./chunk-ZQKYZJWT.js";
+} from "./chunk-KNQ2DKNN.js";
 import {
   ControlClient,
   defaultConfigPath,
@@ -11,21 +12,40 @@ import {
   readConfigFile,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-5KFXUT5Q.js";
+} from "./chunk-NP35YO5O.js";
 import "./chunk-32QD72IL.js";
-import "./chunk-FSS45ZX3.js";
+import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";
 import "./chunk-VA7XC4FD.js";
 import "./chunk-SKQTKZIH.js";
 import "./chunk-F22GNSF6.js";
 
 // src/mcp.ts
+import { createRequire } from "module";
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
   CallToolRequestSchema,
-  ListToolsRequestSchema
+  ListResourcesRequestSchema,
+  ListToolsRequestSchema,
+  ReadResourceRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
+var APP_MIME = "text/html;profile=mcp-app";
+function loadAppHtml() {
+  try {
+    return readFileSync(new URL("./app/index.html", import.meta.url), "utf8");
+  } catch {
+  }
+  try {
+    const req = createRequire(import.meta.url);
+    const entry = req.resolve("@toon-protocol/views");
+    return readFileSync(join(dirname(entry), "app", "index.html"), "utf8");
+  } catch {
+    return '<!doctype html><html><body><div id="root">toon app bundle missing \u2014 run `pnpm --filter @toon-protocol/views build`</div></body></html>';
+  }
+}
 function log(msg) {
   console.error(`[toon-mcp] ${msg}`);
 }
@@ -59,11 +79,25 @@ async function main() {
   void ensureDaemon(url);
   const server = new Server(
     { name: "toon-client", version: "0.1.0" },
-    { capabilities: { tools: {} } }
+    { capabilities: { tools: {}, resources: {} } }
   );
+  const appHtml = loadAppHtml();
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: TOOL_DEFINITIONS
   }));
+  server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: [
+      { uri: APP_RESOURCE_URI, name: "TOON", mimeType: APP_MIME }
+    ]
+  }));
+  server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    if (request.params.uri !== APP_RESOURCE_URI) {
+      throw new Error(`Unknown resource: ${request.params.uri}`);
+    }
+    return {
+      contents: [{ uri: APP_RESOURCE_URI, mimeType: APP_MIME, text: appHtml }]
+    };
+  });
   server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const name = request.params.name;
     const args = request.params.arguments ?? {};

package/dist/mcp.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `toon-mcp` — a thin MCP stdio server exposing the TOON client to a Claude\n * agent (Desktop or Code). It holds NO chain keys and NO long-lived\n * connections: every tool maps to an HTTP call against the always-on\n * `toon-clientd` daemon, which it auto-spawns (detached) if it is not running.\n *\n * Works on both surfaces:\n *   • Claude Desktop — `claude_desktop_config.json` mcpServers entry.\n *   • Claude Code   — `claude mcp add toon -- toon-mcp`  (or `.mcp.json`).\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n  type CallToolResult,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { ControlClient } from './control-client.js';\nimport { dispatchTool, TOOL_DEFINITIONS } from './mcp-tools.js';\nimport { defaultConfigPath, readConfigFile } from './daemon/config.js';\nimport {\n  isDaemonRunning,\n  spawnDaemonDetached,\n  waitForReady,\n} from './daemon/lifecycle.js';\n\n/** stdout carries the MCP protocol — all logging must go to stderr. */\nfunction log(msg: string): void {\n  console.error(`[toon-mcp] ${msg}`);\n}\n\n/** Resolve the daemon control-plane URL without needing the mnemonic. */\nfunction controlPlaneUrl(): string {\n  const file = readConfigFile(\n    process.env['TOON_CLIENT_CONFIG'] ?? defaultConfigPath()\n  );\n  const port = Number(\n    process.env['TOON_CLIENT_HTTP_PORT'] ?? file.httpPort ?? 8787\n  );\n  return `http://127.0.0.1:${port}`;\n}\n\n/**\n * Make sure the daemon is up: if the lock shows it running, return; otherwise\n * spawn it detached and wait until the control plane is reachable. Best-effort\n * — failures surface as readable tool errors rather than crashing the server.\n */\nasync function ensureDaemon(url: string): Promise<void> {\n  if (isDaemonRunning()) return;\n  const client = new ControlClient({ baseUrl: url });\n  if (await client.ping()) return;\n  log('daemon not running — spawning detached');\n  try {\n    const pid = spawnDaemonDetached();\n    log(`spawned toon-clientd (pid ${pid}); waiting for control plane`);\n    await waitForReady(url, 20_000);\n  } catch (err) {\n    log(\n      `failed to spawn daemon: ${err instanceof Error ? err.message : String(err)}`\n    );\n  }\n}\n\nasync function main(): Promise<void> {\n  const url = controlPlaneUrl();\n  const control = new ControlClient({ baseUrl: url });\n\n  // Kick off daemon startup; don't block server init on it (anon bootstrap is\n  // slow). Tools report \"bootstrapping — retry\" until it is ready.\n  void ensureDaemon(url);\n\n  const server = new Server(\n    { name: 'toon-client', version: '0.1.0' },\n    { capabilities: { tools: {} } }\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: TOOL_DEFINITIONS,\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const name = request.params.name;\n    const args = (request.params.arguments ?? {}) as Record<string, unknown>;\n    // If the daemon went away, try once to bring it back before dispatching.\n    if (!(await control.ping())) await ensureDaemon(url);\n    // Our ToolResult is a structural subset of CallToolResult (content + isError);\n    // the SDK's handler union also carries a task-augmented variant we never use.\n    return (await dispatchTool(control, name, args)) as CallToolResult;\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  log(`ready; proxying to ${url}`);\n}\n\nmain().catch((err) => {\n  log(err instanceof Error ? (err.stack ?? err.message) : String(err));\n  process.exitCode = 1;\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAYA,SAAS,cAAc;AACvB,SAAS,4BAA4B;AACrC;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AAWP,SAAS,IAAI,KAAmB;AAC9B,UAAQ,MAAM,cAAc,GAAG,EAAE;AACnC;AAGA,SAAS,kBAA0B;AACjC,QAAM,OAAO;AAAA,IACX,QAAQ,IAAI,oBAAoB,KAAK,kBAAkB;AAAA,EACzD;AACA,QAAM,OAAO;AAAA,IACX,QAAQ,IAAI,uBAAuB,KAAK,KAAK,YAAY;AAAA,EAC3D;AACA,SAAO,oBAAoB,IAAI;AACjC;AAOA,eAAe,aAAa,KAA4B;AACtD,MAAI,gBAAgB,EAAG;AACvB,QAAM,SAAS,IAAI,cAAc,EAAE,SAAS,IAAI,CAAC;AACjD,MAAI,MAAM,OAAO,KAAK,EAAG;AACzB,MAAI,6CAAwC;AAC5C,MAAI;AACF,UAAM,MAAM,oBAAoB;AAChC,QAAI,6BAA6B,GAAG,8BAA8B;AAClE,UAAM,aAAa,KAAK,GAAM;AAAA,EAChC,SAAS,KAAK;AACZ;AAAA,MACE,2BAA2B,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,IAC7E;AAAA,EACF;AACF;AAEA,eAAe,OAAsB;AACnC,QAAM,MAAM,gBAAgB;AAC5B,QAAM,UAAU,IAAI,cAAc,EAAE,SAAS,IAAI,CAAC;AAIlD,OAAK,aAAa,GAAG;AAErB,QAAM,SAAS,IAAI;AAAA,IACjB,EAAE,MAAM,eAAe,SAAS,QAAQ;AAAA,IACxC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,EAAE;AAAA,EAChC;AAEA,SAAO,kBAAkB,wBAAwB,aAAa;AAAA,IAC5D,OAAO;AAAA,EACT,EAAE;AAEF,SAAO,kBAAkB,uBAAuB,OAAO,YAAY;AACjE,UAAM,OAAO,QAAQ,OAAO;AAC5B,UAAM,OAAQ,QAAQ,OAAO,aAAa,CAAC;AAE3C,QAAI,CAAE,MAAM,QAAQ,KAAK,EAAI,OAAM,aAAa,GAAG;AAGnD,WAAQ,MAAM,aAAa,SAAS,MAAM,IAAI;AAAA,EAChD,CAAC;AAED,QAAM,YAAY,IAAI,qBAAqB;AAC3C,QAAM,OAAO,QAAQ,SAAS;AAC9B,MAAI,sBAAsB,GAAG,EAAE;AACjC;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,MAAI,eAAe,QAAS,IAAI,SAAS,IAAI,UAAW,OAAO,GAAG,CAAC;AACnE,UAAQ,WAAW;AACrB,CAAC;","names":[]}
+{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `toon-mcp` — a thin MCP stdio server exposing the TOON client to a Claude\n * agent (Desktop or Code). It holds NO chain keys and NO long-lived\n * connections: every tool maps to an HTTP call against the always-on\n * `toon-clientd` daemon, which it auto-spawns (detached) if it is not running.\n *\n * Works on both surfaces:\n *   • Claude Desktop — `claude_desktop_config.json` mcpServers entry.\n *   • Claude Code   — `claude mcp add toon -- toon-mcp`  (or `.mcp.json`).\n */\n\nimport { createRequire } from 'node:module';\nimport { readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListResourcesRequestSchema,\n  ListToolsRequestSchema,\n  ReadResourceRequestSchema,\n  type CallToolResult,\n} from '@modelcontextprotocol/sdk/types.js';\nimport { APP_RESOURCE_URI } from '@toon-protocol/views';\nimport { ControlClient } from './control-client.js';\nimport { dispatchTool, TOOL_DEFINITIONS } from './mcp-tools.js';\n\n/** MIME marking the bundle as an MCP-app UI resource (ext-apps profile). */\nconst APP_MIME = 'text/html;profile=mcp-app';\n\n/** Load the prebuilt single-file MCP-app bundle served as `ui://toon/app`. */\nfunction loadAppHtml(): string {\n  // 1. Prefer the copy shipped next to the built server (tsup onSuccess copies\n  //    it into dist/app). This is what a published client-mcp serves — no\n  //    dependency on the unpublished @toon-protocol/views package at runtime.\n  try {\n    return readFileSync(new URL('./app/index.html', import.meta.url), 'utf8');\n  } catch {\n    /* running from source / not yet copied — fall through to the dev resolve */\n  }\n  // 2. Dev fallback: resolve the bundle from the @toon-protocol/views workspace.\n  try {\n    const req = createRequire(import.meta.url);\n    const entry = req.resolve('@toon-protocol/views'); // …/views/dist/index.js\n    return readFileSync(join(dirname(entry), 'app', 'index.html'), 'utf8');\n  } catch {\n    return '<!doctype html><html><body><div id=\"root\">toon app bundle missing — run `pnpm --filter @toon-protocol/views build`</div></body></html>';\n  }\n}\nimport { defaultConfigPath, readConfigFile } from './daemon/config.js';\nimport {\n  isDaemonRunning,\n  spawnDaemonDetached,\n  waitForReady,\n} from './daemon/lifecycle.js';\n\n/** stdout carries the MCP protocol — all logging must go to stderr. */\nfunction log(msg: string): void {\n  console.error(`[toon-mcp] ${msg}`);\n}\n\n/** Resolve the daemon control-plane URL without needing the mnemonic. */\nfunction controlPlaneUrl(): string {\n  const file = readConfigFile(\n    process.env['TOON_CLIENT_CONFIG'] ?? defaultConfigPath()\n  );\n  const port = Number(\n    process.env['TOON_CLIENT_HTTP_PORT'] ?? file.httpPort ?? 8787\n  );\n  return `http://127.0.0.1:${port}`;\n}\n\n/**\n * Make sure the daemon is up: if the lock shows it running, return; otherwise\n * spawn it detached and wait until the control plane is reachable. Best-effort\n * — failures surface as readable tool errors rather than crashing the server.\n */\nasync function ensureDaemon(url: string): Promise<void> {\n  if (isDaemonRunning()) return;\n  const client = new ControlClient({ baseUrl: url });\n  if (await client.ping()) return;\n  log('daemon not running — spawning detached');\n  try {\n    const pid = spawnDaemonDetached();\n    log(`spawned toon-clientd (pid ${pid}); waiting for control plane`);\n    await waitForReady(url, 20_000);\n  } catch (err) {\n    log(\n      `failed to spawn daemon: ${err instanceof Error ? err.message : String(err)}`\n    );\n  }\n}\n\nasync function main(): Promise<void> {\n  const url = controlPlaneUrl();\n  const control = new ControlClient({ baseUrl: url });\n\n  // Kick off daemon startup; don't block server init on it (anon bootstrap is\n  // slow). Tools report \"bootstrapping — retry\" until it is ready.\n  void ensureDaemon(url);\n\n  const server = new Server(\n    { name: 'toon-client', version: '0.1.0' },\n    { capabilities: { tools: {}, resources: {} } }\n  );\n\n  const appHtml = loadAppHtml();\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: TOOL_DEFINITIONS,\n  }));\n\n  // The MCP-app UI resource the host renders for toon_render results.\n  server.setRequestHandler(ListResourcesRequestSchema, async () => ({\n    resources: [\n      { uri: APP_RESOURCE_URI, name: 'TOON', mimeType: APP_MIME },\n    ],\n  }));\n\n  server.setRequestHandler(ReadResourceRequestSchema, async (request) => {\n    if (request.params.uri !== APP_RESOURCE_URI) {\n      throw new Error(`Unknown resource: ${request.params.uri}`);\n    }\n    return {\n      contents: [{ uri: APP_RESOURCE_URI, mimeType: APP_MIME, text: appHtml }],\n    };\n  });\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const name = request.params.name;\n    const args = (request.params.arguments ?? {}) as Record<string, unknown>;\n    // If the daemon went away, try once to bring it back before dispatching.\n    if (!(await control.ping())) await ensureDaemon(url);\n    // Our ToolResult is a structural subset of CallToolResult (content + isError);\n    // the SDK's handler union also carries a task-augmented variant we never use.\n    return (await dispatchTool(control, name, args)) as CallToolResult;\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  log(`ready; proxying to ${url}`);\n}\n\nmain().catch((err) => {\n  log(err instanceof Error ? (err.stack ?? err.message) : String(err));\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@toon-protocol/client-mcp",
-  "version": "0.1.0",
-  "description": "Always-on local daemon + MCP server letting a Claude agent (Desktop or Code) act as a TOON Protocol client: pay-to-write publishing, free reads, channel/balance management, and mill swaps.",
+  "version": "0.2.0",
+  "description": "Always-on local daemon + MCP server letting a Claude agent (Desktop or Code) act as a TOON Protocol client: pay-to-write publishing, free reads, channel/balance management, and swaps.",
   "license": "MIT",
   "author": "Jonathan Green",
   "type": "module",
@@ -46,7 +46,8 @@
     "tsup": "^8.0.0",
     "typescript": "^5.3.0",
     "vitest": "^1.0.0",
-    "@toon-protocol/client": "0.9.2"
+    "@toon-protocol/client": "0.11.0",
+    "@toon-protocol/views": "0.1.0"
   },
   "engines": {
     "node": ">=20"