@toon-protocol/views 0.2.0

package/dist/server/apps-server.js

@@ -0,0 +1,163 @@
+/**
+ * Registers the TOON apps surface on an MCP server: the single `ui://toon/app`
+ * UI resource plus the tools the agent uses to drive a generative user journey.
+ *
+ * The journey loop:
+ *   1. agent → `toon_atoms`  (discover the atom vocabulary)
+ *   2. agent → `toon_render(spec)`  (compose a ViewSpec; rides back as the tool
+ *      result, and the tool's `_meta.ui.resourceUri` makes the host render the
+ *      app bundle with it)
+ *   3. iframe → `toon_query(filter)`  (free reads, fed into atoms)
+ *   4. iframe → `toon_publish_unsigned` / `toon_upload_media`  (writes)
+ *   5. iframe → updateModelContext → agent composes the next ViewSpec
+ *
+ * ViewSpecs are model-authored → validated here (server side) before they are
+ * echoed back, in addition to the iframe runtime's own validation.
+ */
+import { z } from 'zod';
+import { registerAppResource, registerAppTool, RESOURCE_MIME_TYPE, } from '@modelcontextprotocol/ext-apps/server';
+import { ATOM_CATALOG, CATALOG_ATOM_IDS } from '../catalog.js';
+import { EXAMPLE_VIEWSPECS } from '../examples.js';
+import { validateViewSpec } from '../spec.js';
+import {} from '../types.js';
+import { APP_RESOURCE_URI, ATOMS_TOOL, OPEN_CHANNEL_TOOL, PUBLISH_TOOL, QUERY_TOOL, RENDER_TOOL, STATUS_TOOL, SWAP_TOOL, UPLOAD_TOOL, WRITE_TOOLS, } from '../tool-names.js';
+import {} from './backend.js';
+function result(text, structuredContent) {
+    return {
+        content: [{ type: 'text', text }],
+        ...(structuredContent ? { structuredContent } : {}),
+    };
+}
+function errorResult(text) {
+    return { content: [{ type: 'text', text }], isError: true };
+}
+/** Register the `ui://toon/app` resource + the generative-UI tools. */
+export function registerToonApps(server, opts) {
+    const connect = opts.cspDomains?.connect ?? ['https://arweave.net'];
+    const resource = opts.cspDomains?.resource ?? ['https://arweave.net'];
+    registerAppResource(server, 'TOON', APP_RESOURCE_URI, {
+        mimeType: RESOURCE_MIME_TYPE,
+        _meta: { ui: { csp: { connectDomains: connect, resourceDomains: resource } } },
+    }, (uri) => ({
+        contents: [{ uri: uri.href, mimeType: RESOURCE_MIME_TYPE, text: opts.appHtml }],
+    }));
+    // toon_atoms — the vocabulary the agent composes with.
+    server.registerTool(ATOMS_TOOL, {
+        description: 'List the atom vocabulary (ids, kinds rendered, props, write actions) plus ' +
+            'example ViewSpecs, for composing a view to pass to ' + RENDER_TOOL + '.',
+        inputSchema: {},
+    }, () => {
+        const atomsPayload = { atoms: ATOM_CATALOG, examples: EXAMPLE_VIEWSPECS };
+        return result(JSON.stringify(atomsPayload, null, 2), atomsPayload);
+    });
+    // toon_render — agent composes a ViewSpec; it rides back as the tool result and
+    // the host renders the app bundle (via _meta.ui.resourceUri) with it.
+    registerAppTool(server, RENDER_TOOL, {
+        description: 'Render an agent-authored ViewSpec (a tree of atoms with data binds and ' +
+            'write actions) as the in-host UI. Use ' + ATOMS_TOOL + ' to learn the vocabulary.',
+        inputSchema: { spec: z.unknown() },
+        _meta: { ui: { resourceUri: APP_RESOURCE_URI } },
+    }, (args) => {
+        const check = validateViewSpec(args.spec, {
+            allowedAtoms: CATALOG_ATOM_IDS,
+            allowedTools: WRITE_TOOLS,
+        });
+        if (!check.ok) {
+            return errorResult(`Invalid ViewSpec:\n- ${check.errors.join('\n- ')}`);
+        }
+        return result(`Rendering view${check.spec.title ? `: ${check.spec.title}` : ''}.`, {
+            viewSpec: check.spec,
+        });
+    });
+    // toon_query — free reads resolved from the backend.
+    server.registerTool(QUERY_TOOL, {
+        description: 'Free read: resolve a NIP-01 filter to matching events.',
+        inputSchema: { filter: z.record(z.unknown()) },
+    }, async (args) => {
+        const events = await opts.backend.query(args.filter);
+        return result(`${events.length} event(s).`, { events });
+    });
+    // toon_status — free read: the current pay-to-write fee + settlement chain.
+    // The confirm UX pulls the fee from here (never hardcoded); when the real
+    // daemon backend (#16) is wired, the same UI shows the live fee/chain.
+    server.registerTool(STATUS_TOOL, {
+        description: 'Free read: report the current pay-to-write fee (feePerEvent) and ' +
+            'settlement chain. Used by the confirm UX to show the fee being paid.',
+        inputSchema: {},
+    }, async () => {
+        const status = await opts.backend.status();
+        return result(`Fee ${status.feePerEvent}${status.asset ? ` ${status.asset}` : ''} per event on ${status.settlementChain}.`, { ...status });
+    });
+    // toon_publish_unsigned — write (the daemon/back-end signs; the UI never does).
+    server.registerTool(PUBLISH_TOOL, {
+        description: 'Pay-to-write: supply only { kind, content, tags } — the backend signs ' +
+            'with the held key and publishes. UI actions target this tool.',
+        inputSchema: {
+            kind: z.number(),
+            content: z.string().optional(),
+            tags: z.array(z.array(z.string())).optional(),
+        },
+    }, async (args) => {
+        const res = await opts.backend.publish(args);
+        return result(`Published event ${res.eventId}.`, { ...res });
+    });
+    // toon_upload_media — spendy two-step write (upload → publish referencing it).
+    server.registerTool(UPLOAD_TOOL, {
+        description: 'Spendy: upload base64 media to Arweave then publish a referencing event ' +
+            '(default kind:1063; 20 picture, 21/22 video, 1 note w/ imeta).',
+        inputSchema: {
+            dataBase64: z.string(),
+            mime: z.string().optional(),
+            kind: z.number().optional(),
+            caption: z.string().optional(),
+            tags: z.array(z.array(z.string())).optional(),
+        },
+    }, async (args) => {
+        const res = await opts.backend.uploadMedia(args);
+        return result(`Uploaded + published media at ${res.url}.`, { ...res });
+    });
+    // toon_open_channel — pre-open a payment channel (daemon signs/settles).
+    server.registerTool(OPEN_CHANNEL_TOOL, {
+        description: 'Pre-open a payment channel (optionally toward a specific destination). ' +
+            'The backend signs/settles; the UI never holds keys. Returns { channelId }.',
+        inputSchema: { destination: z.string().optional() },
+    }, async (args) => {
+        const res = await opts.backend.openChannel(args);
+        return result(`Opened channel ${res.channelId}.`, { ...res });
+    });
+    // toon_swap — spendy cross-asset swap (daemon signs the source claim,
+    // returns the signed target-chain claim + settlement metadata).
+    server.registerTool(SWAP_TOOL, {
+        description: 'Spendy: run a cross-asset swap via a mill peer. The backend signs the ' +
+            'source-asset claim against the open channel and returns the signed ' +
+            'target-chain claim(s) + settlement metadata. UI actions target this tool.',
+        inputSchema: {
+            destination: z.string(),
+            amount: z.string(),
+            millPubkey: z.string(),
+            pair: z.object({
+                from: z.object({
+                    assetCode: z.string(),
+                    assetScale: z.number(),
+                    chain: z.string(),
+                }),
+                to: z.object({
+                    assetCode: z.string(),
+                    assetScale: z.number(),
+                    chain: z.string(),
+                }),
+                rate: z.string(),
+                minAmount: z.string().optional(),
+                maxAmount: z.string().optional(),
+            }),
+            chainRecipient: z.string(),
+            packetCount: z.number().optional(),
+        },
+    }, async (args) => {
+        const res = await opts.backend.swap(args);
+        return result(res.accepted
+            ? `Swap ${res.state}: ${res.cumulativeSource} → ${res.cumulativeTarget} (${res.packetsAccepted} packet(s)).`
+            : `Swap ${res.state}${res.message ? `: ${res.message}` : ''}.`, { ...res });
+    });
+}
+//# sourceMappingURL=apps-server.js.map

package/dist/server/apps-server.js.map

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

package/dist/server/backend.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Pluggable read/write backends for the TOON apps MCP server.
+ *
+ * The apps server (atoms + ViewSpec rendering) depends only on these
+ * interfaces. The {@link ./fake-backend FakeBackend} satisfies them with a
+ * seeded relay + in-memory writes (good enough while core/sdk are in flux); the
+ * real `@toon-protocol/client-mcp` daemon will satisfy them with live BTP writes
+ * and relay reads.
+ */
+import { type NostrEvent, type NostrFilter } from '../types.js';
+/** Free-read side: resolve a NIP-01 filter to matching events. */
+export interface AppReadBackend {
+    query(filter: NostrFilter): Promise<NostrEvent[]>;
+}
+/**
+ * Read-only pay-to-write status. The confirm UX shows the live fee + settlement
+ * chain pulled from here (never hardcoded). A structural subset of the daemon's
+ * `StatusResponse` — only the fields the UI needs. The `FakeBackend` returns a
+ * deterministic stub; the real `DaemonAppBackend` (#16) maps the live daemon
+ * `feePerEvent` / `settlementChain`, with no atom/ViewSpec change.
+ */
+export interface AppStatus {
+    /** Per-event fee in base (micro) units, as a decimal string. */
+    feePerEvent: string;
+    /** The chain family a paid write settles on (e.g. `'base'`, `'evm'`). */
+    settlementChain: string;
+    /** Optional human-readable asset code for the fee (e.g. `'USDC'`). */
+    asset?: string;
+}
+/** Read-only status side: report the current fee + settlement chain. */
+export interface AppStatusBackend {
+    status(): Promise<AppStatus>;
+}
+export interface PublishResult {
+    eventId: string;
+    channelId?: string;
+    nonce?: number;
+}
+export interface UploadResult extends PublishResult {
+    url: string;
+    txId: string;
+}
+/** Pay-to-write side: sign+publish an event shell; upload+publish media. */
+export interface AppWriteBackend {
+    publish(req: {
+        kind: number;
+        content?: string;
+        tags?: string[][];
+    }): Promise<PublishResult>;
+    uploadMedia(req: {
+        dataBase64: string;
+        mime?: string;
+        kind?: number;
+        caption?: string;
+        tags?: string[][];
+    }): Promise<UploadResult>;
+}
+/** Swap pair (source → target asset), mirroring `@toon-protocol/core`'s `SwapPair`. */
+export interface SwapPair {
+    /** Source asset. */
+    from: {
+        assetCode: string;
+        assetScale: number;
+        chain: string;
+    };
+    /** Target asset. */
+    to: {
+        assetCode: string;
+        assetScale: number;
+        chain: string;
+    };
+    /** Exchange rate as a decimal string (target units per source unit). */
+    rate: string;
+    /** Minimum swap amount per packet in source micro-units. */
+    minAmount?: string;
+    /** Maximum swap amount per packet in source micro-units. */
+    maxAmount?: string;
+}
+/** Parameters for a cross-asset swap (subset of the daemon's `SwapRequest`). */
+export interface SwapRequest {
+    /** Mill peer ILP destination (e.g. `g.townhouse.mill`). */
+    destination: string;
+    /** Total source-asset amount to swap, in source micro-units (decimal string). */
+    amount: string;
+    /** Mill's 64-char lowercase hex Nostr pubkey (NIP-59 gift-wrap recipient). */
+    millPubkey: string;
+    /** The swap pair to execute. */
+    pair: SwapPair;
+    /** Sender's payout address on `pair.to.chain`. */
+    chainRecipient: string;
+    /** Split the swap into N equal packets (default 1). */
+    packetCount?: number;
+}
+/** One accumulated, decrypted claim harvested from a single swap packet. */
+export interface SwapClaim {
+    /** Source-asset amount sent for this packet (micro-units, decimal). */
+    sourceAmount: string;
+    /** Target-asset amount claimed (micro-units, decimal). */
+    targetAmount: string;
+    /** Decrypted signed target-chain claim bytes, base64. */
+    claim: string;
+    /** Target-chain channel id (real on-chain id, or a dev placeholder). */
+    channelId?: string;
+    /** Sender's payout address echoed by the mill. */
+    recipient?: string;
+    /** Mill's on-chain signer address. */
+    millSignerAddress?: string;
+    /** Mill-side claim id. */
+    claimId?: string;
+    /** Balance-proof nonce on the target channel (decimal). */
+    nonce?: string;
+    /** Cumulative transferred on the target channel (micro-units, decimal). */
+    cumulativeAmount?: string;
+}
+/** Result of a swap (subset of the daemon's `SwapResponse`). */
+export interface SwapResponse {
+    /** True when at least one packet FULFILLed with a usable claim. */
+    accepted: boolean;
+    /** Number of packets the mill FULFILLed. */
+    packetsAccepted: number;
+    /** Per-packet accumulated claims (settlement metadata + signed claim). */
+    claims: SwapClaim[];
+    /** Total source sent across accepted packets (micro-units, decimal). */
+    cumulativeSource: string;
+    /** Total target received across accepted packets (micro-units, decimal). */
+    cumulativeTarget: string;
+    /** Final stream state. */
+    state: 'completed' | 'failed' | 'stopped';
+    /** First rejection code from the mill, if any (e.g. `F99`). */
+    code?: string;
+    /** First rejection message, if any. */
+    message?: string;
+}
+/**
+ * DeFi side: pre-open a payment channel and run a swap. The UI only *calls*
+ * these tools — all signing/settlement happens daemon-side.
+ */
+export interface AppDefiBackend {
+    openChannel(req: {
+        destination?: string;
+    }): Promise<{
+        channelId: string;
+    }>;
+    swap(req: SwapRequest): Promise<SwapResponse>;
+}
+export interface AppBackend extends AppReadBackend, AppWriteBackend, AppDefiBackend, AppStatusBackend {
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/server/backend.d.ts.map

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

package/dist/server/backend.js

@@ -0,0 +1,11 @@
+/**
+ * Pluggable read/write backends for the TOON apps MCP server.
+ *
+ * The apps server (atoms + ViewSpec rendering) depends only on these
+ * interfaces. The {@link ./fake-backend FakeBackend} satisfies them with a
+ * seeded relay + in-memory writes (good enough while core/sdk are in flux); the
+ * real `@toon-protocol/client-mcp` daemon will satisfy them with live BTP writes
+ * and relay reads.
+ */
+import {} from '../types.js';
+//# sourceMappingURL=backend.js.map

package/dist/server/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../src/server/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAqC,MAAM,aAAa,CAAC"}

package/dist/server/daemon-backend.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Real, daemon-backed {@link AppBackend} for the TOON apps surface.
+ *
+ * Reads resolve over the free Nostr relay side (`query`); writes go through the
+ * `toon-clientd` control plane (`publish-unsigned` / `upload-media`), where the
+ * daemon holds the chain key and signs + pays. **No key material ever reaches
+ * the iframe** — the UI only supplies an unsigned event shell or raw bytes.
+ *
+ * To avoid a dependency cycle (`@toon-protocol/client-mcp` imports
+ * `@toon-protocol/views`), this file does NOT import client-mcp. Instead it
+ * depends on a minimal structural control port, {@link DaemonControl}, which the
+ * client-mcp `ControlClient` satisfies structurally.
+ */
+import { type NostrEvent, type NostrFilter } from '../types.js';
+import { type AppBackend, type AppStatus, type PublishResult, type SwapRequest, type SwapResponse, type UploadResult } from './backend.js';
+/** One-shot free read: subscribe the filter(s), wait briefly, return matches. */
+export interface DaemonQueryRequest {
+    filters: NostrFilter | NostrFilter[];
+    timeoutMs?: number;
+}
+export interface DaemonQueryResponse {
+    events: NostrEvent[];
+}
+/** Build, sign (daemon-held key), and pay-to-write an event from a shell. */
+export interface DaemonPublishUnsignedRequest {
+    kind: number;
+    content?: string;
+    tags?: string[][];
+}
+export interface DaemonPublishResponse {
+    eventId: string;
+    channelId: string;
+    nonce: number;
+}
+/** Upload bytes to Arweave (blob DVM), then sign+publish a referencing event. */
+export interface DaemonUploadMediaRequest {
+    dataBase64: string;
+    mime?: string;
+    kind?: number;
+    caption?: string;
+    tags?: string[][];
+}
+export interface DaemonUploadMediaResponse extends DaemonPublishResponse {
+    url: string;
+    txId: string;
+}
+/**
+ * Read-only pay-to-write status from the daemon. A structural subset of the
+ * client-mcp `StatusResponse` — only the fields the confirm UX needs. The
+ * fetch-based control in {@link ./daemon-main daemon-main.ts} maps the daemon's
+ * `/status` response onto this shape.
+ */
+export interface DaemonStatusResponse {
+    feePerEvent: string;
+    settlementChain: string;
+    asset?: string;
+}
+/**
+ * Minimal structural control-plane port the {@link DaemonAppBackend} needs.
+ *
+ * Intentionally a structural subset of the client-mcp `ControlClient`: that
+ * class satisfies this interface without `views` importing client-mcp (which
+ * would form a cycle). Extra response fields (e.g. `data` on a publish) are
+ * tolerated — only the fields mapped below are read.
+ */
+export interface DaemonControl {
+    status(): Promise<DaemonStatusResponse>;
+    query(body: DaemonQueryRequest): Promise<DaemonQueryResponse>;
+    publishUnsigned(body: DaemonPublishUnsignedRequest): Promise<DaemonPublishResponse>;
+    uploadMedia(body: DaemonUploadMediaRequest): Promise<DaemonUploadMediaResponse>;
+    openChannel(body: {
+        destination?: string;
+    }): Promise<{
+        channelId: string;
+    }>;
+    swap(body: SwapRequest): Promise<SwapResponse>;
+}
+/**
+ * `AppBackend` implemented over the live daemon control plane. Construct it with
+ * a `DaemonControl` (the client-mcp `ControlClient` fits) and hand it to
+ * {@link ../apps-server.registerToonApps registerToonApps}.
+ */
+export declare class DaemonAppBackend implements AppBackend {
+    private readonly control;
+    constructor(control: DaemonControl);
+    /** Read-only fee/chain — no payment. Maps the daemon status onto `AppStatus`. */
+    status(): Promise<AppStatus>;
+    /** Free read — no payment. Maps `QueryResponse.events` → `NostrEvent[]`. */
+    query(filter: NostrFilter): Promise<NostrEvent[]>;
+    /** Pay-to-write. The daemon signs with the held key; the iframe holds none. */
+    publish(req: {
+        kind: number;
+        content?: string;
+        tags?: string[][];
+    }): Promise<PublishResult>;
+    /** Two-step spendy write: Arweave upload (DVM) then sign+publish reference. */
+    uploadMedia(req: {
+        dataBase64: string;
+        mime?: string;
+        kind?: number;
+        caption?: string;
+        tags?: string[][];
+    }): Promise<UploadResult>;
+    /** Pre-open a payment channel. Daemon-side; no key material in the iframe. */
+    openChannel(req: {
+        destination?: string;
+    }): Promise<{
+        channelId: string;
+    }>;
+    /** Run a cross-asset swap. All signing/settlement happens daemon-side. */
+    swap(req: SwapRequest): Promise<SwapResponse>;
+}
+//# sourceMappingURL=daemon-backend.d.ts.map

package/dist/server/daemon-backend.d.ts.map

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

package/dist/server/daemon-backend.js

@@ -0,0 +1,79 @@
+/**
+ * Real, daemon-backed {@link AppBackend} for the TOON apps surface.
+ *
+ * Reads resolve over the free Nostr relay side (`query`); writes go through the
+ * `toon-clientd` control plane (`publish-unsigned` / `upload-media`), where the
+ * daemon holds the chain key and signs + pays. **No key material ever reaches
+ * the iframe** — the UI only supplies an unsigned event shell or raw bytes.
+ *
+ * To avoid a dependency cycle (`@toon-protocol/client-mcp` imports
+ * `@toon-protocol/views`), this file does NOT import client-mcp. Instead it
+ * depends on a minimal structural control port, {@link DaemonControl}, which the
+ * client-mcp `ControlClient` satisfies structurally.
+ */
+import {} from '../types.js';
+import {} from './backend.js';
+/**
+ * `AppBackend` implemented over the live daemon control plane. Construct it with
+ * a `DaemonControl` (the client-mcp `ControlClient` fits) and hand it to
+ * {@link ../apps-server.registerToonApps registerToonApps}.
+ */
+export class DaemonAppBackend {
+    control;
+    constructor(control) {
+        this.control = control;
+    }
+    /** Read-only fee/chain — no payment. Maps the daemon status onto `AppStatus`. */
+    async status() {
+        const res = await this.control.status();
+        return {
+            feePerEvent: res.feePerEvent,
+            settlementChain: res.settlementChain,
+            ...(res.asset ? { asset: res.asset } : {}),
+        };
+    }
+    /** Free read — no payment. Maps `QueryResponse.events` → `NostrEvent[]`. */
+    async query(filter) {
+        const res = await this.control.query({ filters: filter });
+        return res.events;
+    }
+    /** Pay-to-write. The daemon signs with the held key; the iframe holds none. */
+    async publish(req) {
+        const res = await this.control.publishUnsigned({
+            kind: req.kind,
+            content: req.content,
+            tags: req.tags,
+        });
+        return {
+            eventId: res.eventId,
+            channelId: res.channelId,
+            nonce: res.nonce,
+        };
+    }
+    /** Two-step spendy write: Arweave upload (DVM) then sign+publish reference. */
+    async uploadMedia(req) {
+        const res = await this.control.uploadMedia({
+            dataBase64: req.dataBase64,
+            mime: req.mime,
+            kind: req.kind,
+            caption: req.caption,
+            tags: req.tags,
+        });
+        return {
+            eventId: res.eventId,
+            channelId: res.channelId,
+            nonce: res.nonce,
+            url: res.url,
+            txId: res.txId,
+        };
+    }
+    /** Pre-open a payment channel. Daemon-side; no key material in the iframe. */
+    async openChannel(req) {
+        return this.control.openChannel(req);
+    }
+    /** Run a cross-asset swap. All signing/settlement happens daemon-side. */
+    async swap(req) {
+        return this.control.swap(req);
+    }
+}
+//# sourceMappingURL=daemon-backend.js.map

package/dist/server/daemon-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-backend.js","sourceRoot":"","sources":["../../src/server/daemon-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAqC,MAAM,aAAa,CAAC;AAChE,OAAO,EAON,MAAM,cAAc,CAAC;AAwEtB;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IACE;IAA7B,YAA6B,OAAsB;QAAtB,YAAO,GAAP,OAAO,CAAe;IAAG,CAAC;IAEvD,iFAAiF;IACjF,KAAK,CAAC,MAAM;QACV,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO;YACL,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,KAAK,CAAC,KAAK,CAAC,MAAmB;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,OAAO,CAAC,GAIb;QACC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;YAC7C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,WAAW,CAAC,GAMjB;QACC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YACzC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,IAAI,EAAE,GAAG,CAAC,IAAI;SACf,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,WAAW,CAAC,GAA6B;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,IAAI,CAAC,GAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/server/daemon-main.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * Real TOON apps MCP server (stdio) — the daemon-backed counterpart to
+ * {@link ./fake-main fake-main.ts}.
+ *
+ * Reads resolve over the free Nostr relay side and writes go through the
+ * always-on `toon-clientd` control plane: this entrypoint wires a
+ * {@link DaemonAppBackend} (over a tiny fetch-based {@link DaemonControl}) into
+ * {@link ./apps-server.registerToonApps registerToonApps}. No chain keys ever
+ * live in this process or the iframe — the daemon holds the key and signs+pays.
+ *
+ *   pnpm --filter @toon-protocol/views build
+ *   node packages/views/dist/server/daemon-main.js   # toon-clientd must be up
+ *
+ * Then connect it as an MCP server (e.g. `claude mcp add toon -- node …/daemon-main.js`).
+ *
+ * The daemon URL is resolved the same way `client-mcp/src/mcp.ts` does — from
+ * `TOON_CLIENT_HTTP_PORT` or the config file's `httpPort`, default 8787. To keep
+ * `@toon-protocol/views` free of a dependency cycle on `@toon-protocol/client-mcp`
+ * (which imports views), this entrypoint speaks the control plane over `fetch`
+ * directly rather than importing the client-mcp `ControlClient` — the structural
+ * `DaemonControl` port is all `DaemonAppBackend` needs.
+ */
+export {};
+//# sourceMappingURL=daemon-main.d.ts.map

package/dist/server/daemon-main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-main.d.ts","sourceRoot":"","sources":["../../src/server/daemon-main.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG"}