plotlink-ows 0.1.13

package/packages/cli/node_modules/tsup/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "tsup",
+  "version": "8.5.1",
+  "description": "Bundle your TypeScript library with no config, powered by esbuild",
+  "license": "MIT",
+  "homepage": "https://tsup.egoist.dev/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/egoist/tsup.git"
+  },
+  "author": "EGOIST",
+  "files": [
+    "/assets",
+    "/dist",
+    "/schema.json"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "tsup": "dist/cli-default.js",
+    "tsup-node": "dist/cli-node.js"
+  },
+  "peerDependencies": {
+    "@microsoft/api-extractor": "^7.36.0",
+    "@swc/core": "^1",
+    "postcss": "^8.4.12",
+    "typescript": ">=4.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@microsoft/api-extractor": {
+      "optional": true
+    },
+    "@swc/core": {
+      "optional": true
+    },
+    "postcss": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "bundle-require": "^5.1.0",
+    "cac": "^6.7.14",
+    "chokidar": "^4.0.3",
+    "consola": "^3.4.0",
+    "debug": "^4.4.0",
+    "esbuild": "^0.27.0",
+    "fix-dts-default-cjs-exports": "^1.0.0",
+    "joycon": "^3.1.1",
+    "picocolors": "^1.1.1",
+    "postcss-load-config": "^6.0.1",
+    "resolve-from": "^5.0.0",
+    "rollup": "^4.34.8",
+    "source-map": "^0.7.6",
+    "sucrase": "^3.35.0",
+    "tinyexec": "^0.3.2",
+    "tinyglobby": "^0.2.11",
+    "tree-kill": "^1.2.2"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.50.0",
+    "@rollup/plugin-json": "6.1.0",
+    "@swc/core": "1.10.18",
+    "@types/debug": "4.1.12",
+    "@types/node": "22.13.4",
+    "@types/resolve": "1.20.6",
+    "bumpp": "^10.0.3",
+    "flat": "6.0.1",
+    "postcss": "8.5.2",
+    "postcss-simple-vars": "7.0.1",
+    "prettier": "3.5.1",
+    "resolve": "1.22.10",
+    "rollup-plugin-dts": "6.1.1",
+    "sass": "1.85.0",
+    "strip-json-comments": "5.0.1",
+    "svelte": "5.19.9",
+    "svelte-preprocess": "6.0.3",
+    "terser": "^5.39.0",
+    "ts-essentials": "10.0.4",
+    "tsup": "8.3.6",
+    "typescript": "5.7.3",
+    "vitest": "3.0.6",
+    "wait-for-expect": "3.0.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "pnpm run build-fast --watch",
+    "build": "tsup src/cli-*.ts src/index.ts src/rollup.ts --clean --splitting",
+    "test": "pnpm run build && pnpm run test-only",
+    "format": "prettier --write .",
+    "test-only": "vitest run",
+    "build-fast": "pnpm run build --no-dts",
+    "release": "bumpp"
+  }
+}

package/packages/cli/node_modules/tsup/schema.json

@@ -0,0 +1,362 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "tsup",
+  "version": 1.1,
+  "anyOf": [
+    {
+      "type": "object",
+      "required": ["tsup"],
+      "additionalProperties": true,
+      "properties": {
+        "tsup": {
+          "type": ["object", "array"],
+          "oneOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "$ref": "#/definitions/options"
+            },
+            {
+              "type": "array",
+              "items": {
+                "additionalProperties": false,
+                "$ref": "#/definitions/options"
+              }
+            }
+          ]
+        }
+      }
+    },
+    {
+      "type": ["object", "array"],
+      "oneOf": [
+        {
+          "type": "object",
+          "$ref": "#/definitions/options"
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/options"
+          }
+        }
+      ]
+    }
+  ],
+  "definitions": {
+    "options": {
+      "type": "object",
+      "markdownDescription": "Configuration options for [tsup](https://tsup.egoist.dev)",
+      "properties": {
+        "entry": {
+          "markdownDescription": "Files that each serve as an input to the bundling algorithm.\n\n---\nReferences:\n- [Entry Points](https://esbuild.github.io/api/#entry-points) - esbuild\n - [Multiple Entrypoints](https://tsup.egoist.dev/#multiple-entrypoints) - tsup",
+          "oneOf": [
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "type": "object"
+            }
+          ]
+        },
+        "treeshake": {
+          "markdownDescription": "By default esbuild already does treeshaking but this option allow you to perform additional treeshaking with Rollup and result in smaller bundle size.",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string",
+              "enum": ["smallest", "safest", "recommended"]
+            }
+          ]
+        },
+        "name": {
+          "type": "string",
+          "description": "Optional config name to show in CLI output"
+        },
+        "legacyOutput": {
+          "type": "boolean",
+          "description": "Output different formats to different folder instead of using different extension"
+        },
+        "target": {
+          "markdownDescription": "This sets the target environment for the generated code\n\n---\nReferences:\n- [Target](https://esbuild.github.io/api/#target) - esbuild",
+          "default": "node14",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "minify": {
+          "description": "When enabled, the generated code will be minified instead of pretty-printed.",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string",
+              "enum": ["terser"]
+            }
+          ]
+        },
+        "minifyWhitespace": {
+          "type": "boolean"
+        },
+        "minifyIdentifiers": {
+          "type": "boolean"
+        },
+        "minifySyntax": {
+          "type": "boolean"
+        },
+        "keepNames": {
+          "type": "boolean"
+        },
+        "watch": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": ["string", "boolean"]
+              }
+            }
+          ]
+        },
+        "ignoreWatch": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "onSuccess": {
+          "type": "string"
+        },
+        "jsxFactory": {
+          "type": "string"
+        },
+        "jsxFragment": {
+          "type": "string"
+        },
+        "outDir": {
+          "type": "string"
+        },
+        "format": {
+          "oneOf": [
+            {
+              "enum": ["cjs", "iife", "esm"],
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "enum": ["cjs", "iife", "esm"]
+              }
+            }
+          ]
+        },
+        "swc": {
+          "type": "object"
+        },
+        "globalName": {
+          "type": "string"
+        },
+        "env": {
+          "type": "object"
+        },
+        "define": {
+          "type": "object"
+        },
+        "dts": {
+          "markdownDescription": "This will emit `./dist/index.js` and `./dist/index.d.ts`.\n\nIf you have multiple entry files, each entry will get a corresponding `.d.ts` file. So when you only want to generate declaration file for a single entry, use `--dts <entry>` format, e.g. `--dts src/index.ts`.\n\n**Note** that `--dts` does not resolve external (aka in node_modules) types used in the `.d.ts file`, if that's somehow a requirement, try the experimental `--dts-resolve` flag instead.",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "object",
+              "properties": {
+                "entry": {
+                  "oneOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "object"
+                    },
+                    {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  ]
+                }
+              }
+            }
+          ]
+        },
+        "sourcemap": {
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "enum": ["inline"]
+            }
+          ]
+        },
+        "noExternal": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Always bundle modules matching given patterns"
+        },
+        "external": {
+          "description": "Don't bundle these modules",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "replaceNodeEnv": {
+          "type": "boolean",
+          "markdownDescription": "Replace `process.env.NODE_ENV` with `production` or `development` `production` when the bundled is minified, `development` otherwise"
+        },
+        "splitting": {
+          "type": "boolean",
+          "default": true,
+          "markdownDescription": "You may want to disable code splitting sometimes: [`#255`](https://github.com/egoist/tsup/issues/255)"
+        },
+        "clean": {
+          "description": "Clean output directory before each buil",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "silent": {
+          "type": "boolean",
+          "description": "Suppress non-error logs (excluding \"onSuccess\" process output)"
+        },
+        "skipNodeModulesBundle": {
+          "type": "boolean",
+          "description": "Skip node_modules bundling"
+        },
+        "pure": {
+          "markdownDescription": "See:\n- [Pure](https://esbuild.github.io/api/#pure) - esbuild",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        },
+        "bundle": {
+          "default": true,
+          "type": "boolean",
+          "description": "Disable bundling, default to true"
+        },
+        "inject": {
+          "markdownDescription": "This option allows you to automatically replace a global variable with an import from another file.\n\n---\nSee:\n- [Inject](https://esbuild.github.io/api/#inject) - esbuild",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "metafile": {
+          "type": "boolean",
+          "markdownDescription": "Emit esbuild metafile.\n\n---\nSee:\n- [Metafile](https://esbuild.github.io/api/#metafile) - esbuild"
+        },
+        "footer": {
+          "type": "object",
+          "properties": {
+            "js": {
+              "type": "string"
+            },
+            "css": {
+              "type": "string"
+            }
+          }
+        },
+        "banner": {
+          "type": "object",
+          "properties": {
+            "js": {
+              "type": "string"
+            },
+            "css": {
+              "type": "string"
+            }
+          }
+        },
+        "platform": {
+          "description": "Target platform",
+          "type": "string",
+          "default": "node",
+          "enum": ["node", "browser", "neutral"]
+        },
+        "config": {
+          "markdownDescription": "Disable config file with `false` or pass a custom config filename",
+          "type": ["boolean", "string"]
+        },
+        "tsconfig": {
+          "type": "string",
+          "description": " Use a custom tsconfig"
+        },
+        "injectStyle": {
+          "type": "boolean",
+          "default": false,
+          "description": "Inject CSS as style tags to document head"
+        },
+        "shims": {
+          "type": "boolean",
+          "default": false,
+          "description": "Inject cjs and esm shims if needed"
+        }
+      }
+    }
+  }
+}

package/packages/cli/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "plotlink-cli",
+  "version": "0.1.0",
+  "description": "CLI for the PlotLink protocol — create storylines, chain plots, register agents, and claim royalties.",
+  "type": "module",
+  "bin": {
+    "plotlink": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@supabase/supabase-js": "^2.49.4",
+    "commander": "^13.1.0",
+    "viem": "^2.47.2"
+  },
+  "devDependencies": {
+    "bundle-require": "^5.1.0",
+    "chokidar": "^4.0.3",
+    "consola": "^3.4.0",
+    "fix-dts-default-cjs-exports": "^1.0.0",
+    "joycon": "^3.1.1",
+    "postcss-load-config": "^6.0.1",
+    "source-map": "^0.7.6",
+    "sucrase": "^3.35.0",
+    "tree-kill": "^1.2.2",
+    "tsup": "^8.4.0",
+    "typescript": "^5"
+  },
+  "license": "MIT"
+}

package/packages/cli/src/commands/agent-register.ts

@@ -0,0 +1,77 @@
+import type { Command } from "commander";
+import type { Address } from "viem";
+import { isAddress } from "viem";
+import { buildClient } from "../sdk.js";
+
+export function registerAgentRegister(program: Command): void {
+  const agent = program
+    .command("agent")
+    .description("Agent identity commands");
+
+  agent
+    .command("register")
+    .description("Register an AI agent on the ERC-8004 registry and set its wallet")
+    .requiredOption("-n, --name <name>", "Agent display name")
+    .requiredOption("-d, --description <desc>", "Short description of the agent")
+    .requiredOption("-g, --genre <genre>", "Primary genre the agent writes in")
+    .requiredOption("-m, --model <model>", "LLM model identifier (e.g. \"Claude Opus 4\")")
+    .option("-w, --wallet <address>", "Agent wallet address (defaults to the configured wallet)")
+    .option("--skip-wallet", "Skip wallet binding step", false)
+    .action(
+      async (opts: {
+        name: string;
+        description: string;
+        genre: string;
+        model: string;
+        wallet?: string;
+        skipWallet?: boolean;
+      }) => {
+        try {
+          // Validate wallet address and key BEFORE spending gas on registration
+          let walletKey: string | undefined;
+          if (opts.wallet && !opts.skipWallet) {
+            if (!isAddress(opts.wallet)) {
+              console.error(`Invalid address: ${opts.wallet}`);
+              process.exit(1);
+            }
+            walletKey = process.env.PLOTLINK_AGENT_WALLET_KEY;
+            if (!walletKey) {
+              console.error(
+                "Error: PLOTLINK_AGENT_WALLET_KEY env var is required when --wallet is set.\n" +
+                  "Set it before running this command, or pass --skip-wallet to register without binding.",
+              );
+              process.exit(1);
+            }
+          }
+
+          const client = buildClient({ ipfs: false });
+
+          console.log(`Registering agent "${opts.name}"...`);
+          const result = await client.registerAgent(
+            opts.name,
+            opts.description,
+            opts.genre,
+            opts.model,
+          );
+
+          console.log("Agent registered!");
+          console.log(`  Agent ID:  ${result.agentId}`);
+          console.log(`  TX:        ${result.txHash}`);
+
+          if (opts.wallet && !opts.skipWallet && walletKey) {
+            const walletAddress = opts.wallet as Address;
+            console.log(`Setting agent wallet to ${walletAddress}...`);
+            const walletResult = await client.setAgentWallet(
+              result.agentId,
+              walletAddress,
+              walletKey,
+            );
+            console.log(`Agent wallet set! TX: ${walletResult.txHash}`);
+          }
+        } catch (err) {
+          console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+          process.exit(1);
+        }
+      },
+    );
+}

package/packages/cli/src/commands/chain.ts

@@ -0,0 +1,29 @@
+import { readFileSync } from "node:fs";
+import type { Command } from "commander";
+import { buildClient } from "../sdk.js";
+
+export function registerChain(program: Command): void {
+  program
+    .command("chain")
+    .description("Chain a new plot onto an existing storyline")
+    .requiredOption("-s, --storyline <id>", "Storyline ID")
+    .requiredOption("-f, --file <path>", "Path to content file (plain text)")
+    .option("-t, --title <title>", "Chapter title", "")
+    .action(async (opts: { storyline: string; file: string; title: string }) => {
+      try {
+        const content = readFileSync(opts.file, "utf-8");
+        const storylineId = BigInt(opts.storyline);
+        const client = buildClient({ ipfs: true });
+
+        console.log(`Chaining plot onto storyline ${storylineId}...`);
+        const result = await client.chainPlot(storylineId, content, opts.title);
+
+        console.log("Plot chained!");
+        console.log(`  TX:   ${result.txHash}`);
+        console.log(`  CID:  ${result.contentCid}`);
+      } catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+      }
+    });
+}

package/packages/cli/src/commands/claim.ts

@@ -0,0 +1,70 @@
+import type { Command } from "commander";
+import { type Address, erc20Abi, formatUnits, isAddress } from "viem";
+import { mcv2BondAbi } from "../sdk/index.js";
+import { buildClient } from "../sdk.js";
+
+export function registerClaim(program: Command): void {
+  program
+    .command("claim")
+    .description("Claim accumulated royalties for a storyline token")
+    .requiredOption("-a, --address <tokenAddress>", "Storyline ERC-20 token address")
+    .action(async (opts: { address: string }) => {
+      try {
+        if (!isAddress(opts.address)) {
+          console.error(`Invalid address: ${opts.address}`);
+          process.exit(1);
+        }
+        const tokenAddress = opts.address as Address;
+        const client = buildClient({ ipfs: false });
+
+        // Fetch bond data (creator = beneficiary, reserve token for display)
+        console.log("Checking royalties...");
+        const bond = await client.publicClient.readContract({
+          address: client.mcv2Bond,
+          abi: mcv2BondAbi,
+          functionName: "tokenBond",
+          args: [tokenAddress],
+        });
+        const creator = (bond as readonly unknown[])[0] as Address;
+        const reserveToken = (bond as readonly unknown[])[4] as Address;
+
+        let decimals = 18;
+        let symbol = "TOKEN";
+        try {
+          const [dec, sym] = await Promise.all([
+            client.publicClient.readContract({
+              address: reserveToken,
+              abi: erc20Abi,
+              functionName: "decimals",
+            }),
+            client.publicClient.readContract({
+              address: reserveToken,
+              abi: erc20Abi,
+              functionName: "symbol",
+            }),
+          ]);
+          decimals = dec;
+          symbol = sym;
+        } catch {
+          // Default to 18/TOKEN if calls fail
+        }
+
+        const info = await client.getRoyaltyInfo(creator, reserveToken);
+        const formatted = formatUnits(info.balance, decimals);
+        console.log(`  Unclaimed:    ${formatted} ${symbol}`);
+        console.log(`  Beneficiary:  ${creator}`);
+
+        if (info.balance === 0n) {
+          console.log("No royalties to claim.");
+          return;
+        }
+
+        console.log("Claiming royalties...");
+        const txHash = await client.claimRoyalties(reserveToken);
+        console.log(`Royalties claimed! TX: ${txHash}`);
+      } catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+      }
+    });
+}