@toon-protocol/client-mcp 0.12.2 → 0.13.1

package/README.md

@@ -274,7 +274,7 @@ receive a target-chain claim.
   results**, never private keys.
 - A single-instance PID lock prevents two daemons from racing the channel nonce
   watermark (which would corrupt the payment proof).
-- The control plane binds `127.0.0.1` only (no auth layer — it never leaves
+- The control API binds `127.0.0.1` only (no auth layer — it never leaves
   loopback).
 
 ## Tests

package/dist/{chunk-XVGREVEL.js → chunk-SL7UGVOC.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from 'module'; const require = __cr(import.meta
 import {
   ControlApiError,
   DaemonUnreachableError
-} from "./chunk-AYIP46A2.js";
+} from "./chunk-UXCFHAUC.js";
 
 // ../views/dist/tool-names.js
 var PUBLISH_TOOL = "toon_publish_unsigned";
@@ -727,6 +727,7 @@ var EXAMPLE_VIEWSPECS = [
 ];
 
 // src/mcp-tools.ts
+import { basename } from "path";
 var TOOL_DEFINITIONS = [
   {
     name: "toon_status",
@@ -824,6 +825,167 @@ var TOOL_DEFINITIONS = [
       additionalProperties: false
     }
   },
+  {
+    name: "toon_git_push",
+    description: "Pay-to-write: push a local git repository to TOON (NIP-34) \u2014 uploads the object delta to Arweave via the paid store and publishes the cumulative kind:30618 refs event (+ kind:30617 announcement on first push). The daemon identity is the repo owner. TWO-STEP, PAID + IRREVERSIBLE: ALWAYS call with dry_run:true first \u2014 it plans the push without paying and returns the itemized fee table (per-object upload fees + event fees). Quote estimate.totalFee to the user and get their explicit confirmation, THEN call again with confirm:true to execute; a push without confirm:true is rejected. Uploads and events are permanent and non-refundable (they cannot be unpublished).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoPath: {
+          type: "string",
+          description: "Absolute path to the local git repository (worktree or .git dir) the daemon reads with git plumbing."
+        },
+        repoId: {
+          type: "string",
+          description: 'Repository identifier (NIP-34 `d` tag). Default: the basename of repoPath with any trailing `.git` stripped (so /repos/demo, /repos/demo/.git and /repos/demo.git all derive "demo").'
+        },
+        refspecs: {
+          type: "array",
+          items: { type: "string" },
+          description: 'Full refnames to push (e.g. ["refs/heads/main"]). Default: every local branch and tag.'
+        },
+        force: {
+          type: "boolean",
+          description: "Allow non-fast-forward updates (default false). A forced push abandons remote commits \u2014 get explicit user confirmation first."
+        },
+        relayUrls: {
+          type: "array",
+          items: { type: "string" },
+          description: "Relay URLs to read remote state from and publish to (default: the daemon's config-seeded relay)."
+        },
+        dry_run: {
+          type: "boolean",
+          description: "true \u2192 plan + price only (free, nothing is paid or published). Required first step before any real push."
+        },
+        confirm: {
+          type: "boolean",
+          description: "Must be literally true to execute the paid push \u2014 only after the user confirmed the dry_run fee quote."
+        }
+      },
+      required: ["repoPath"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "toon_git_issue",
+    description: "Pay-to-write: file a NIP-34 issue (kind:1621) against a TOON-hosted repo. One paid event publish. PAID + IRREVERSIBLE: quote the per-event fee (feePerEvent via toon_status / fee config) and confirm with the user before calling \u2014 events cannot be unpublished.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoOwnerPubkey: {
+          type: "string",
+          description: "Repository owner's Nostr pubkey (64-char hex \u2014 the author of the kind:30617 announcement)."
+        },
+        repoId: {
+          type: "string",
+          description: "Repository identifier (NIP-34 `d` tag)."
+        },
+        title: { type: "string", description: "Issue title (`subject` tag)." },
+        body: { type: "string", description: "Issue body (Markdown)." },
+        labels: {
+          type: "array",
+          items: { type: "string" },
+          description: "Labels (`t` tags)."
+        }
+      },
+      required: ["repoOwnerPubkey", "repoId", "title", "body"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "toon_git_comment",
+    description: "Pay-to-write: comment (kind:1622) on a TOON-hosted issue or patch. One paid event publish. PAID + IRREVERSIBLE: quote the per-event fee (feePerEvent via toon_status / fee config) and confirm with the user before calling \u2014 events cannot be unpublished.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoOwnerPubkey: {
+          type: "string",
+          description: "Repository owner's Nostr pubkey (64-char hex)."
+        },
+        repoId: {
+          type: "string",
+          description: "Repository identifier (NIP-34 `d` tag)."
+        },
+        rootEventId: {
+          type: "string",
+          description: "Event id of the issue or patch being commented on."
+        },
+        body: { type: "string", description: "Comment body (Markdown)." },
+        parentAuthorPubkey: {
+          type: "string",
+          description: "Pubkey of the TARGET event's author (NIP-34 `p` threading tag). Default: the repo owner."
+        },
+        marker: {
+          type: "string",
+          enum: ["root", "reply"],
+          description: "`e`-tag marker (default root: commenting directly on the issue/patch)."
+        }
+      },
+      required: ["repoOwnerPubkey", "repoId", "rootEventId", "body"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "toon_git_patch",
+    description: "Pay-to-write: submit a patch/PR (kind:1617, real `git format-patch` content) to a TOON-hosted repo. Supply EXACTLY ONE of patchText (literal format-patch output) or repoPath+range (the daemon runs format-patch locally). One paid event publish. PAID + IRREVERSIBLE: quote the per-event fee (feePerEvent via toon_status / fee config) and confirm with the user before calling \u2014 events cannot be unpublished.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoOwnerPubkey: {
+          type: "string",
+          description: "Repository owner's Nostr pubkey (64-char hex)."
+        },
+        repoId: {
+          type: "string",
+          description: "Repository identifier (NIP-34 `d` tag)."
+        },
+        title: { type: "string", description: "Patch/PR title (`subject` tag)." },
+        patchText: {
+          type: "string",
+          description: "Literal `git format-patch` output. Mutually exclusive with repoPath+range."
+        },
+        repoPath: {
+          type: "string",
+          description: "Local repository to run format-patch in. Requires range."
+        },
+        range: {
+          type: "string",
+          description: "Revision range for format-patch (`<rev>`, `<rev>..<rev>`, `<rev>...<rev>`)."
+        },
+        branch: { type: "string", description: "Branch name for the `t` tag." }
+      },
+      required: ["repoOwnerPubkey", "repoId", "title"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "toon_git_status",
+    description: "Pay-to-write: set the status of a TOON-hosted issue or patch (kind:1630-1633: open/applied/closed/draft). One paid event publish. PAID + IRREVERSIBLE: quote the per-event fee (feePerEvent via toon_status / fee config) and confirm with the user before calling \u2014 events cannot be unpublished.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repoOwnerPubkey: {
+          type: "string",
+          description: "Repository owner's Nostr pubkey (64-char hex)."
+        },
+        repoId: {
+          type: "string",
+          description: "Repository identifier (NIP-34 `d` tag)."
+        },
+        targetEventId: {
+          type: "string",
+          description: "Event id of the issue/patch whose status is being set."
+        },
+        status: {
+          type: "string",
+          enum: ["open", "applied", "closed", "draft"],
+          description: "open \u2192 kind:1630, applied \u2192 1631, closed \u2192 1632, draft \u2192 1633."
+        }
+      },
+      required: ["repoOwnerPubkey", "repoId", "targetEventId", "status"],
+      additionalProperties: false
+    }
+  },
   {
     name: "toon_atoms",
     description: "REQUIRED first call before any toon_render \u2014 returns the atom allowlist (ids + the kinds each renders, props, write actions) plus example ViewSpecs, for composing a view to pass to toon_render. Never guess atom ids or kinds; always fetch them here first. This is how you build the user a generative UI for their journey.",
@@ -1197,6 +1359,14 @@ var TOOL_ANNOTATIONS = {
   toon_publish_unsigned: PAID_WRITE,
   toon_upload: PAID_WRITE,
   toon_swap: PAID_WRITE,
+  // paid git writes (NIP-34): push uploads objects + publishes events; the
+  // single-event tools each spend one channel claim. toon_git_push with
+  // dry_run:true is a free estimate, but the tool as a whole is a paid write.
+  toon_git_push: PAID_WRITE,
+  toon_git_issue: PAID_WRITE,
+  toon_git_comment: PAID_WRITE,
+  toon_git_patch: PAID_WRITE,
+  toon_git_status: PAID_WRITE,
   // on-chain channel ops
   toon_open_channel: { ...ONCHAIN_WRITE, idempotentHint: true },
   // returns the existing channel if open
@@ -1250,6 +1420,71 @@ async function dispatchTool(client, name, args) {
         return ok(
           await client.uploadMedia(args)
         );
+      case "toon_git_push": {
+        const req = {
+          repoPath: String(args["repoPath"] ?? ""),
+          repoId: typeof args["repoId"] === "string" && args["repoId"] !== "" ? args["repoId"] : defaultRepoId(String(args["repoPath"] ?? "")),
+          ...Array.isArray(args["refspecs"]) ? { refspecs: args["refspecs"].map(String) } : {},
+          ...typeof args["force"] === "boolean" ? { force: args["force"] } : {},
+          ...Array.isArray(args["relayUrls"]) ? { relayUrls: args["relayUrls"].map(String) } : {}
+        };
+        if (args["dry_run"] === true) {
+          const plan = await client.gitEstimate(req);
+          return okStructured(
+            JSON.stringify(compactPushPlan(plan)) + `
+Quote estimate.totalFee (base units) to the user and get explicit confirmation before pushing with confirm:true \u2014 the push is permanent and non-refundable.`,
+            plan
+          );
+        }
+        if (args["confirm"] !== true) {
+          return err(
+            `Refusing to push without confirm:true. Run toon_git_push with dry_run:true first (free), quote estimate.totalFee to the user, and only after their explicit confirmation call again with confirm:true. Pushes are PAID, permanent, and non-refundable.`
+          );
+        }
+        const pushed = await client.gitPush({ ...req, confirm: true });
+        return okStructured(
+          JSON.stringify(compactPushResult(pushed)),
+          pushed
+        );
+      }
+      case "toon_git_issue":
+        return ok(
+          await client.gitIssue({
+            repoAddr: gitRepoAddr(args),
+            title: String(args["title"] ?? ""),
+            body: String(args["body"] ?? ""),
+            ...Array.isArray(args["labels"]) ? { labels: args["labels"].map(String) } : {}
+          })
+        );
+      case "toon_git_comment":
+        return ok(
+          await client.gitComment({
+            repoAddr: gitRepoAddr(args),
+            rootEventId: String(args["rootEventId"] ?? ""),
+            body: String(args["body"] ?? ""),
+            ...typeof args["parentAuthorPubkey"] === "string" ? { parentAuthorPubkey: args["parentAuthorPubkey"] } : {},
+            ...args["marker"] === "root" || args["marker"] === "reply" ? { marker: args["marker"] } : {}
+          })
+        );
+      case "toon_git_patch": {
+        const req = {
+          repoAddr: gitRepoAddr(args),
+          title: String(args["title"] ?? ""),
+          ...typeof args["patchText"] === "string" ? { patchText: args["patchText"] } : {},
+          ...typeof args["repoPath"] === "string" ? { repoPath: args["repoPath"] } : {},
+          ...typeof args["range"] === "string" ? { range: args["range"] } : {},
+          ...typeof args["branch"] === "string" ? { branch: args["branch"] } : {}
+        };
+        return ok(await client.gitPatch(req));
+      }
+      case "toon_git_status":
+        return ok(
+          await client.gitStatus({
+            repoAddr: gitRepoAddr(args),
+            targetEventId: String(args["targetEventId"] ?? ""),
+            status: String(args["status"] ?? "")
+          })
+        );
       case "toon_atoms": {
         const atomsPayload = { atoms: ATOM_CATALOG, examples: EXAMPLE_VIEWSPECS };
         return okStructured(JSON.stringify(atomsPayload, null, 2), atomsPayload);
@@ -1386,7 +1621,7 @@ async function dispatchTool(client, name, args) {
   } catch (e) {
     if (e instanceof ControlApiError && e.status === 504 && name === "toon_balances") {
       return err(
-        `${e.detail ?? e.message} \u2014 the balances control plane (:8787 GET /balances) stalled reading on-chain balances; the relay and apex are unaffected. Retry shortly.`
+        `${e.detail ?? e.message} \u2014 the balances control API (:8787 GET /balances) stalled reading on-chain balances; the relay and apex are unaffected. Retry shortly.`
       );
     }
     if (e instanceof ControlApiError && e.status === 504 && name === "toon_fund_wallet") {
@@ -1402,6 +1637,26 @@ async function dispatchTool(client, name, args) {
     if (e instanceof ControlApiError && e.status === 402) {
       return err(e.detail ?? e.message);
     }
+    if (e instanceof ControlApiError && e.message === "non_fast_forward") {
+      return err(
+        JSON.stringify({
+          error: "non_fast_forward",
+          detail: e.detail,
+          refs: e.data?.["refs"] ?? [],
+          hint: "The remote moved since the last known state. Re-run toon_git_push with dry_run:true and force:true to preview the forced update, get explicit user confirmation (a forced push abandons the remote commits), then push with force:true + confirm:true."
+        })
+      );
+    }
+    if (e instanceof ControlApiError && e.message === "oversize_objects") {
+      return err(
+        JSON.stringify({
+          error: "oversize_objects",
+          detail: e.detail,
+          objects: e.data?.["objects"] ?? [],
+          hint: "These objects exceed the 95KB single-packet upload limit \u2014 a v1 hard error (paid blob storage for larger objects is the epic #222 follow-up, toon-client#235). Remove or shrink the listed paths (e.g. git filter-repo) and re-run the estimate."
+        })
+      );
+    }
     if (e instanceof ControlApiError && e.retryable) {
       return err(
         `TOON client is still bootstrapping (the BTP session can take a few seconds) \u2014 retry shortly. (${e.message})`
@@ -1426,6 +1681,38 @@ function wrapList(key, res) {
   }
   return { [key]: [] };
 }
+function defaultRepoId(repoPath) {
+  const trimmed = repoPath.replace(/[/\\]+$/, "");
+  const base = basename(trimmed);
+  if (base === ".git") {
+    return basename(trimmed.slice(0, -".git".length).replace(/[/\\]+$/, ""));
+  }
+  return base.length > ".git".length && base.endsWith(".git") ? base.slice(0, -".git".length) : base;
+}
+function gitRepoAddr(args) {
+  return {
+    ownerPubkey: String(args["repoOwnerPubkey"] ?? ""),
+    repoId: String(args["repoId"] ?? "")
+  };
+}
+function compactPushPlan(plan) {
+  const { objects, knownShaToTxId, newRefs, ...rest } = plan;
+  return {
+    ...rest,
+    newRefCount: Object.keys(newRefs).length,
+    plannedObjectCount: objects.length,
+    knownOnArweaveCount: Object.keys(knownShaToTxId).length
+  };
+}
+function compactPushResult(res) {
+  const { uploads, arweaveMap, ...rest } = res;
+  return {
+    ...rest,
+    uploadCount: uploads.length,
+    skippedUploadCount: uploads.filter((u) => u.skipped).length,
+    arweaveMapSize: Object.keys(arweaveMap).length
+  };
+}
 function ok(data) {
   const result = {
     content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
@@ -1524,4 +1811,4 @@ export {
   TOOL_DEFINITIONS,
   dispatchTool
 };
-//# sourceMappingURL=chunk-XVGREVEL.js.map
+//# sourceMappingURL=chunk-SL7UGVOC.js.map