@arp-protocol/cli 0.0.1 → 0.0.4

package/dist/chunks/{commands-dnk10vze.js → commands-t5a0w785.js}

@@ -15,6 +15,19 @@ import {
 } from "node:fs";
 import { dirname, join as join2 } from "node:path";
 
+// ../../packages/protocol/src/share-offer.ts
+var SHARE_OFFER = {
+  question: "Share this machine's skill failures as public lines?",
+  sends: `When a skill fails here, one public line on Intuition testnet: the skill's public address, its category when known, "failed" and a closed reason (missing-key, missing-program, missing-file).`,
+  signer: "Each line is signed by this machine's own ARP address, created on the first send: it is public and the same on every line, so this machine's lines can be told apart from others' and linked together.",
+  never: "Never your prompts, your files, your paths, your code or your keys.",
+  service: "Sending goes through ARP's sponsoring service, which is not online yet: until it is, nothing is sent and `arp share send` says so.",
+  later: "Off by default. Change it any time with `arp share on` or `arp share off`."
+};
+function shareOfferLines() {
+  return [SHARE_OFFER.sends, SHARE_OFFER.signer, SHARE_OFFER.never, SHARE_OFFER.service, SHARE_OFFER.later];
+}
+
 // src/install/targets.ts
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
@@ -51,11 +64,23 @@ function withMcpServer(config, name, entry) {
 var CLAUDE_HOOKS = {
   shape: "nested",
   events: [
-    { name: "PostToolUse", matcher: "*" },
-    { name: "PostToolUseFailure", matcher: "*" }
+    { name: "PostToolUse", matcher: "^(?!Skill$)" },
+    { name: "PostToolUse", matcher: "Skill", sync: true, timeout: 5 },
+    { name: "PostToolUseFailure", matcher: "*", sync: true },
+    { name: "PreToolUse", matcher: "Bash", sync: true, timeout: 15, if: "Bash(*skills*)" },
+    { name: "Stop", sync: true, timeout: 10 }
   ],
-  entry: (command) => ({ type: "command", command, async: true, timeout: 10 })
+  entry: (command, event) => ({
+    type: "command",
+    command,
+    ...event.if === undefined ? {} : { if: event.if },
+    ...event.sync === true ? {} : { async: true },
+    timeout: event.timeout ?? 10
+  })
 };
+function eventNames(spec) {
+  return [...new Set(spec.events.map((event) => event.name))];
+}
 function isOurs(hook, marker) {
   return isRecord(hook) && typeof hook.command === "string" && hook.command.includes(marker);
 }
@@ -85,16 +110,18 @@ function ours(list, spec, marker) {
 }
 function withHooks(settings, spec, command, marker) {
   const hooks = isRecord(settings.hooks) ? { ...settings.hooks } : {};
-  for (const event of spec.events) {
-    const kept = strip(hooks[event.name], spec, marker);
+  for (const name of eventNames(spec)) {
+    const kept = strip(hooks[name], spec, marker);
     if (command !== null) {
-      const entry = spec.entry(command);
-      kept.push(spec.shape === "flat" ? entry : { ...event.matcher === undefined ? {} : { matcher: event.matcher }, hooks: [entry] });
+      for (const event of spec.events.filter((row) => row.name === name)) {
+        const entry = spec.entry(command, event);
+        kept.push(spec.shape === "flat" ? entry : { ...event.matcher === undefined ? {} : { matcher: event.matcher }, hooks: [entry] });
+      }
     }
     if (kept.length > 0)
-      hooks[event.name] = kept;
+      hooks[name] = kept;
     else
-      delete hooks[event.name];
+      delete hooks[name];
   }
   const next = { ...settings, hooks };
   if (Object.keys(hooks).length === 0) {
@@ -110,16 +137,19 @@ function hooksOf(settings, spec, marker) {
   if (!isRecord(settings.hooks))
     return {};
   const out = {};
-  for (const event of spec.events) {
-    const found = ours(settings.hooks[event.name], spec, marker);
+  for (const name of eventNames(spec)) {
+    const found = ours(settings.hooks[name], spec, marker);
     if (found.length > 0)
-      out[event.name] = found;
+      out[name] = found;
   }
   return out;
 }
 function hasHooks(settings, spec, marker) {
   const found = hooksOf(settings, spec, marker);
-  return spec.events.every((event) => (event.name in found));
+  return eventNames(spec).every((name) => {
+    const list = found[name];
+    return Array.isArray(list) && list.length >= spec.events.filter((row) => row.name === name).length;
+  });
 }
 var TOML_BEGIN = "# >>> arp — managed by `arp init`, removed by `arp uninstall` >>>";
 var TOML_END = "# <<< arp <<<";
@@ -327,8 +357,17 @@ function claudeMcpSteps(env, commands, project, remove, allowCli) {
     jsonStep(files.mcp, (config) => withMcpServer(config, SERVER_NAME, remove ? null : mcpEntry(commands.mcp, false)), remove ? "mcpServers.arp removed" : `mcpServers.arp → ${commands.mcp.command} ${commands.mcp.args.join(" ")}`, (config) => serversOf(config)[SERVER_NAME])
   ];
 }
+function waitedLabel(event) {
+  if (event.sync !== true)
+    return "";
+  if (event.if !== undefined)
+    return " (waited on, Bash skills installs only)";
+  if (event.matcher !== undefined && event.matcher !== "*")
+    return ` (waited on, ${event.matcher} calls only)`;
+  return " (waited on)";
+}
 function claudeHookStep(env, commands, project, remove) {
-  return jsonStep(claudeFiles(env, project).settings, (settings) => withHooks(settings, CLAUDE_HOOKS, remove ? null : commands.hook, commands.hookFile), remove ? "hooks: arp removed from PostToolUse and PostToolUseFailure" : "hooks: arp on PostToolUse and PostToolUseFailure, async", (settings) => hooksOf(settings, CLAUDE_HOOKS, commands.hookFile));
+  return jsonStep(claudeFiles(env, project).settings, (settings) => withHooks(settings, CLAUDE_HOOKS, remove ? null : commands.hook, commands.hookFile), remove ? `hooks: arp removed from ${eventNames(CLAUDE_HOOKS).join(", ")}` : `hooks: arp on ${CLAUDE_HOOKS.events.map((event) => `${event.name}${waitedLabel(event)}`).join(", ")}`, (settings) => hooksOf(settings, CLAUDE_HOOKS, commands.hookFile));
 }
 var CLAUDE_HOOKS_SEEN_FROM = [2, 1, 316];
 function claudeVersionCheck(env) {
@@ -361,7 +400,7 @@ function claudeChecks(env, commands, project) {
       viaCli || SERVER_NAME in servers
     ],
     [
-      `hook on PostToolUse and PostToolUseFailure (${files.settings})`,
+      `hook on ${eventNames(CLAUDE_HOOKS).join(", ")} (${files.settings})`,
       !(settings instanceof Error) && hasHooks(settings, CLAUDE_HOOKS, commands.hookFile)
     ],
     ...claudeVersionCheck(env)
@@ -424,7 +463,7 @@ function noHook(path, spec, commands) {
   return removal.kind === "file" && removal.before !== removal.after ? removal : NO_HOOK;
 }
 function hookStep(path, spec, commands, remove) {
-  return jsonStep(path, (settings) => withHooks(settings, spec, remove ? null : commands.hook, commands.hookFile), remove ? `hooks: arp removed (${spec.events.map((e) => e.name).join(", ")})` : `hooks: arp on ${spec.events.map((e) => e.name).join(", ")}${commands.capture ? ", capturing" : ""}`, (settings) => hooksOf(settings, spec, commands.hookFile));
+  return jsonStep(path, (settings) => withHooks(settings, spec, remove ? null : commands.hook, commands.hookFile), remove ? `hooks: arp removed (${eventNames(spec).join(", ")})` : `hooks: arp on ${eventNames(spec).join(", ")}${commands.capture ? ", capturing" : ""}`, (settings) => hooksOf(settings, spec, commands.hookFile));
 }
 function jsonMcpRuntime(options) {
   const { id, name, dir, file, typed, binary, hook } = options;
@@ -558,6 +597,7 @@ function parseFlags(args) {
     print: false,
     capture: false,
     sponsored: false,
+    share: null,
     force: false,
     runtimes: null
   };
@@ -579,6 +619,10 @@ function parseFlags(args) {
       flags.sponsored = true;
     else if (arg === "--force")
       flags.force = true;
+    else if (arg === "--share")
+      flags.share = true;
+    else if (arg === "--no-share")
+      flags.share = false;
     else if (arg === "--runtime") {
       const list = (args[i + 1] ?? "").split(",").filter((name) => name.length > 0);
       i += 1;
@@ -733,7 +777,34 @@ async function init(env, flags, cliPath) {
   if (installsHook(runtimes, flags.capture)) {
     plan.push({ runtime: "hook", steps: [hookFileStep(env, commands, false)] });
   }
-  return change(env, flags, plan, "Install");
+  const code = await change(env, flags, plan, "Install");
+  if ((code === EXIT.ok || code === EXIT.partly) && !flags.dryRun)
+    await offerSharing(env, flags);
+  return code;
+}
+async function offerSharing(env, flags) {
+  const home = env.arpHome ?? join2(env.home, ".arp");
+  const file = join2(home, "sharing.json");
+  const save = (on) => {
+    mkdirSync(home, { recursive: true });
+    writeFileSync(file, `${JSON.stringify({ failures: on })}
+`);
+  };
+  if (flags.share !== null) {
+    save(flags.share);
+    env.out(`Sharing ${flags.share ? "on" : "off"}. ${SHARE_OFFER.later}`);
+    return;
+  }
+  if (existsSync2(file))
+    return;
+  if (flags.yes || flags.noInput || !env.interactive) {
+    env.out(`Sharing is off. ${SHARE_OFFER.later}`);
+    return;
+  }
+  env.out("");
+  for (const line of shareOfferLines())
+    env.out(line);
+  save(await env.ask(SHARE_OFFER.question));
 }
 async function uninstall(env, flags, cliPath) {
   const commands = commandsFor(env, cliPath);

package/dist/chunks/{env-s4585w6j.js → env-n5ac8d1z.js}

@@ -20,6 +20,7 @@ function which(command) {
 function processEnv(dist, version) {
   return {
     home: homedir(),
+    arpHome: process.env["ARP_HOME"]?.trim() || join(homedir(), ".arp"),
     cwd: process.cwd(),
     which,
     run: (argv, stdin, timeoutMs = 15000) => {

package/dist/chunks/{index-3a3ssef1.js → index-jrs2shcc.js}

@@ -20,11 +20,11 @@ import {
   refuseMovedState,
   serveFetch,
   stateFile
-} from "./cli-tyey74p3.js";
+} from "./cli-n4qagybd.js";
 import {
   ERC8004_REGISTRY
-} from "./cli-v446mw5v.js";
-import"./cli-0hqxver6.js";
+} from "./cli-fbwpcfvp.js";
+import"./cli-mhzh9z8k.js";
 import"./cli-d3dy7cxe.js";
 import"./cli-3kbbwfbp.js";
 import"./cli-g5zvr10v.js";

package/dist/chunks/line-kvm1ew55.js

@@ -0,0 +1,215 @@
+#!/usr/bin/env node
+import {
+  agentFor,
+  chainId,
+  domainWalk,
+  domainWords,
+  loopConfig,
+  sponsorApproval,
+  writeLine
+} from "./cli-8m56jsfx.js";
+import"./cli-7c393v47.js";
+import"./cli-00qp1sj2.js";
+import"./cli-n4qagybd.js";
+import {
+  USAGE_REASONS,
+  X402_DEFAULT_NETWORKS,
+  chainIdOfNetwork,
+  isCategoryIn,
+  isExactEndpointUrl,
+  isTransactionAbsent,
+  isUsageOutcome,
+  isUsageReason,
+  needShapeProblem,
+  normaliseCategoryLabel,
+  readDomainTree,
+  redactEndpointUrl,
+  resolveDomain,
+  transfersIn,
+  x402NetworksFrom,
+  x402Reading
+} from "./cli-wer26exb.js";
+import"./cli-zehr6kdx.js";
+import"./cli-0gsbnq5w.js";
+import"./cli-fbwpcfvp.js";
+import"./cli-mhzh9z8k.js";
+import"./cli-d3dy7cxe.js";
+import"./cli-3kbbwfbp.js";
+import"./cli-g5zvr10v.js";
+
+// ../mcp/src/line.ts
+function lineNetworks(env = process.env) {
+  return x402NetworksFrom(X402_DEFAULT_NETWORKS, env);
+}
+function lineFromArgs(args, env = process.env) {
+  if (args.parent === undefined !== (args.why === undefined))
+    return new Error("--parent and --why go together");
+  if (args.paymentTx === undefined !== (args.network === undefined))
+    return new Error("--payment-tx and --network go together");
+  if (args.network !== undefined && chainIdOfNetwork(args.network) === null) {
+    return new Error("--network is a CAIP-2 EVM network, such as eip155:8453 for Base");
+  }
+  if (args.network !== undefined) {
+    let networks;
+    try {
+      networks = lineNetworks(env);
+    } catch (error) {
+      return error instanceof Error ? error : new Error(String(error));
+    }
+    if (!networks.has(args.network))
+      return new Error(`--network must be one of ${[...networks.keys()].join(", ")}`);
+  }
+  if (args.paymentTx !== undefined && !/^0x[0-9a-fA-F]{64}$/.test(args.paymentTx))
+    return new Error("--payment-tx is a 32-byte transaction hash");
+  const terms = termsFromArgs(args);
+  if (terms instanceof Error)
+    return terms;
+  if (args.reason === "no-delivery" && args.paymentTx === undefined) {
+    return new Error("--reason no-delivery means paid, nothing received: it takes --payment-tx and --network");
+  }
+  let toolUrl = args.toolUrl;
+  if (args.paymentTx !== undefined) {
+    if (!isExactEndpointUrl(args.toolUrl)) {
+      return new Error("with --payment-tx, --tool is the exact URL you paid, scheme included, as you called it");
+    }
+    try {
+      toolUrl = redactEndpointUrl(args.toolUrl);
+    } catch (error) {
+      return error instanceof Error ? error : new Error(String(error));
+    }
+  }
+  if (args.parent !== undefined && args.domain === undefined)
+    return new Error("--parent and --why add a --domain");
+  if (args.why !== undefined && args.why.trim() === "")
+    return new Error("--why says why no category fits");
+  if (!isUsageOutcome(args.outcome))
+    return new Error("--outcome must be worked or failed");
+  if (args.reason !== undefined && !isUsageReason(args.reason)) {
+    return new Error(`--reason must be one of ${USAGE_REASONS.join(", ")}`);
+  }
+  if (args.reason !== undefined && args.outcome !== "failed")
+    return new Error("a reason only follows --outcome failed");
+  if (args.needs !== undefined && args.outcome !== "failed")
+    return new Error("--needs follows --outcome failed; a worked line takes --with");
+  if (args.with !== undefined && args.outcome !== "worked")
+    return new Error("--with follows --outcome worked; a failure takes --needs");
+  const need = args.needs ?? args.with;
+  if (need !== undefined) {
+    const problem = needShapeProblem({ need, outcome: args.outcome, reason: args.reason ?? "" });
+    if (problem !== null)
+      return new Error(problem);
+    if (args.paymentTx !== undefined)
+      return new Error("--needs and --with name a skill's word; a paid endpoint has no SKILL.md");
+  }
+  return {
+    toolUrl,
+    outcome: args.outcome,
+    ...args.domain === undefined ? {} : { domain: args.domain },
+    ...args.reason === undefined ? {} : { reason: args.reason },
+    ...args.parent === undefined || args.why === undefined ? {} : { newDomain: { parent: args.parent, why: args.why.trim() } },
+    ...args.paymentTx === undefined || args.network === undefined ? {} : { payment: { network: args.network, txHash: args.paymentTx.toLowerCase() } },
+    ...terms === null ? {} : { terms },
+    ...need === undefined ? {} : { need }
+  };
+}
+var TERMS_FLAGS = ["--pay-to", "--asset", "--price", "--terms-at"];
+function termsFromArgs(args) {
+  const given = [args.payTo, args.asset, args.price, args.termsAt];
+  if (args.paymentTx === undefined) {
+    return given.every((value) => value === undefined) ? null : new Error(`${TERMS_FLAGS.join(", ")} follow --payment-tx`);
+  }
+  if (given.some((value) => value === undefined)) {
+    return new Error(`with --payment-tx, name the terms the 402 gave and you paid against: ${TERMS_FLAGS.join(" ")}`);
+  }
+  const { payTo, asset, price, termsAt } = args;
+  if (!/^0x[0-9a-fA-F]{40}$/.test(payTo))
+    return new Error("--pay-to is the 402's payTo address");
+  if (!/^0x[0-9a-fA-F]{40}$/.test(asset))
+    return new Error("--asset is the 402's asset address");
+  if (!/^[1-9][0-9]{0,77}$/.test(price))
+    return new Error("--price is the 402's amount, a positive integer in the asset's smallest unit");
+  const receivedAt = /^[0-9]+$/.test(termsAt) ? Number(termsAt) : Math.floor(Date.parse(termsAt) / 1000);
+  if (!Number.isSafeInteger(receivedAt) || receivedAt <= 0)
+    return new Error("--terms-at is when the 402 was received: unix seconds or ISO 8601");
+  if (receivedAt > Math.floor(Date.now() / 1000) + 300)
+    return new Error("--terms-at is in the future");
+  return { payTo, asset, price, receivedAt };
+}
+function matchesTerms(payment, terms) {
+  return payment.transfers.some((transfer) => transfer.payTo.toLowerCase() === terms.payTo.toLowerCase() && transfer.asset.toLowerCase() === terms.asset.toLowerCase() && BigInt(transfer.amount) >= BigInt(terms.price));
+}
+async function readLinePayment(input, reading) {
+  if (input.payment === undefined)
+    return null;
+  const { network, txHash } = input.payment;
+  const assets = reading.policy.get(network)?.assets ?? [];
+  const reads = reading.readsFor(network);
+  let receipt;
+  try {
+    receipt = await reads.getTransactionReceipt({ hash: txHash });
+  } catch (error) {
+    if (isTransactionAbsent(error))
+      throw new Error(`transaction ${txHash} not found on ${network}`);
+    throw new Error(`${network} could not be read: ${error instanceof Error ? error.message.split(`
+`)[0] : String(error)}`);
+  }
+  if (receipt.status !== "success")
+    throw new Error(`the payment ${txHash} reverted on ${network}`);
+  const transfers = transfersIn(receipt.logs, assets);
+  if (transfers.length === 0)
+    throw new Error(`${txHash} on ${network} moves no accepted asset (${assets.join(", ")})`);
+  return { network, txHash, transfers: transfers.map((transfer) => ({ ...transfer, amount: transfer.amount.toString() })) };
+}
+async function writeLineChecked(steps, input) {
+  let line = input;
+  let payment = null;
+  if (input.payment !== undefined) {
+    if (!isExactEndpointUrl(input.toolUrl))
+      throw new Error(`${input.toolUrl} is not the exact http(s) URL that was paid`);
+    if (steps.payments === undefined)
+      throw new Error("this build reads no payment network");
+    payment = await readLinePayment(input, steps.payments);
+    if (input.terms === undefined)
+      throw new Error("a line with a payment names the terms it paid against");
+    if (payment !== null && !matchesTerms(payment, input.terms)) {
+      throw new Error(`no transfer in ${input.payment.txHash} pays ${input.terms.payTo} at least ${input.terms.price} of ${input.terms.asset}: check --pay-to, --asset and --price`);
+    }
+  }
+  if (input.domain !== undefined) {
+    const domain = normaliseCategoryLabel(input.domain);
+    const resolved = await steps.isCategory(domain) ? null : await steps.resolve?.(domain);
+    if (resolved === null || resolved?.status === "node") {
+      const { newDomain: _unused, ...rest } = input;
+      line = { ...rest, domain: resolved?.status === "node" ? resolved.label : domain };
+    } else if (input.newDomain === undefined) {
+      const closest = resolved?.status === "unknown" && resolved.suggestions.length > 0 ? ` Closest: ${resolved.suggestions.join(", ")}.` : "";
+      throw new Error(`"${input.domain}" is not a category under tool.${closest} Pick one, or add it with --parent <category> --why <reason>`);
+    } else {
+      const parent = normaliseCategoryLabel(input.newDomain.parent);
+      if (!await steps.isCategory(parent))
+        throw new Error(`--parent "${input.newDomain.parent}" is not a category under tool`);
+      line = { ...input, domain, newDomain: { parent, why: input.newDomain.why } };
+    }
+  }
+  await sponsorApproval(steps.config);
+  const written = await (steps.write ?? writeLine)(steps.config, steps.agent(), line);
+  return payment === null ? written : { ...written, payment };
+}
+async function writeLineHere(input) {
+  if (chainId !== 13579)
+    throw new Error("a line is written on testnet 13579 only for now");
+  return writeLineChecked({
+    config: loopConfig(),
+    isCategory: async (label) => isCategoryIn(await readDomainTree(domainWalk()))(label),
+    resolve: async (word) => resolveDomain(word, domainWords(await readDomainTree(domainWalk()))),
+    agent: agentFor,
+    payments: x402Reading(lineNetworks(), process.env)
+  }, input);
+}
+export {
+  writeLineHere,
+  writeLineChecked,
+  readLinePayment,
+  lineNetworks,
+  lineFromArgs
+};

package/dist/chunks/{node-init-4v2m2vj0.js → node-init-amedveja.js}

@@ -1,20 +1,21 @@
 #!/usr/bin/env node
 import {
   resolveNodeKey
-} from "./cli-zpft011j.js";
-import"./cli-tyey74p3.js";
+} from "./cli-64fx73kx.js";
+import"./cli-n4qagybd.js";
 import {
   asEndpointBinding,
   endpointBindingDocument,
   normaliseEndpoint,
   parseAgentRegistry,
   validateHandshakeRequest
-} from "./cli-74hv4etk.js";
-import"./cli-c8568g4c.js";
-import"./cli-v446mw5v.js";
+} from "./cli-wer26exb.js";
+import"./cli-zehr6kdx.js";
+import"./cli-0gsbnq5w.js";
+import"./cli-fbwpcfvp.js";
 import {
   isHex
-} from "./cli-0hqxver6.js";
+} from "./cli-mhzh9z8k.js";
 import"./cli-d3dy7cxe.js";
 import"./cli-3kbbwfbp.js";
 import"./cli-g5zvr10v.js";

package/dist/chunks/{node-0ydee9hy.js → node-x35ncwhq.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   resolveNodeKey
-} from "./cli-zpft011j.js";
+} from "./cli-64fx73kx.js";
 import {
   appendJsonLine,
   bigintSafe,
@@ -9,7 +9,7 @@ import {
   readJsonLines,
   serveFetch,
   stateFile
-} from "./cli-tyey74p3.js";
+} from "./cli-n4qagybd.js";
 import {
   HIRE_RECEIPT_VERSION,
   createPublicClient,
@@ -18,15 +18,16 @@ import {
   normaliseEndpoint,
   parseEther,
   signHireReceipt
-} from "./cli-74hv4etk.js";
-import"./cli-c8568g4c.js";
+} from "./cli-wer26exb.js";
+import"./cli-zehr6kdx.js";
+import"./cli-0gsbnq5w.js";
 import {
   ERC8004_REGISTRY
-} from "./cli-v446mw5v.js";
+} from "./cli-fbwpcfvp.js";
 import {
   formatEther,
   isAddress
-} from "./cli-0hqxver6.js";
+} from "./cli-mhzh9z8k.js";
 import"./cli-d3dy7cxe.js";
 import"./cli-3kbbwfbp.js";
 import"./cli-g5zvr10v.js";