plotlink-ows 0.1.13

package/bin/plotlink-ows.js

@@ -0,0 +1,394 @@
+#!/usr/bin/env node
+// PlotLink OWS — CLI Wizard
+// Zero external dependencies — Node builtins only
+
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const { execSync, spawn } = require("child_process");
+const crypto = require("crypto");
+
+const CONFIG_DIR = path.join(require("os").homedir(), ".plotlink-ows");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+const PID_FILE = path.join(CONFIG_DIR, "server.pid");
+const PROJECT_DIR = path.dirname(__dirname);
+const ENV_FILE = path.join(CONFIG_DIR, ".env");
+const AGENT_CONFIG_FILE = path.join(CONFIG_DIR, "agent.config.json");
+
+// ── Helpers ──
+
+function ensureConfigDir() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+}
+
+function readConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+
+function writeConfig(cfg) {
+  ensureConfigDir();
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(cfg, null, 2) + "\n");
+}
+
+function writeEnvVar(key, value) {
+  const line = `${key}=${value}`;
+  if (fs.existsSync(ENV_FILE)) {
+    const content = fs.readFileSync(ENV_FILE, "utf-8");
+    const regex = new RegExp(`^${key}=.*$`, "m");
+    if (regex.test(content)) {
+      fs.writeFileSync(ENV_FILE, content.replace(regex, line));
+    } else {
+      fs.appendFileSync(ENV_FILE, `\n${line}\n`);
+    }
+  } else {
+    fs.writeFileSync(ENV_FILE, `${line}\n`);
+  }
+}
+
+function ask(rl, question) {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+
+function askSecret(question) {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    process.stdout.write(question);
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    if (stdin.setRawMode) stdin.setRawMode(true);
+    let input = "";
+    const onData = (ch) => {
+      const c = ch.toString();
+      if (c === "\n" || c === "\r") {
+        if (stdin.setRawMode) stdin.setRawMode(wasRaw);
+        stdin.removeListener("data", onData);
+        process.stdout.write("\n");
+        rl.close();
+        resolve(input);
+      } else if (c === "\u0003") {
+        process.exit(0);
+      } else if (c === "\u007F" || c === "\b") {
+        input = input.slice(0, -1);
+      } else {
+        input += c;
+        process.stdout.write("*");
+      }
+    };
+    stdin.on("data", onData);
+    stdin.resume();
+  });
+}
+
+function hashPassphrase(passphrase) {
+  return crypto.createHmac("sha256", "plotlink-ows").update(passphrase).digest("hex");
+}
+
+function log(msg) {
+  console.log(`  ${msg}`);
+}
+
+function header(msg) {
+  console.log(`\n  \x1b[1m${msg}\x1b[0m\n`);
+}
+
+function success(msg) {
+  console.log(`  \x1b[32m✓\x1b[0m ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  \x1b[33m!\x1b[0m ${msg}`);
+}
+
+function error(msg) {
+  console.log(`  \x1b[31m✗\x1b[0m ${msg}`);
+}
+
+// ── Commands ──
+
+async function cmdInit() {
+  header("PlotLink OWS — Setup Wizard");
+  log("Let's get your local writer app configured.\n");
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  // Step 1: Prerequisites
+  header("Step 1: Prerequisites");
+  const nodeVersion = process.version;
+  const major = parseInt(nodeVersion.slice(1));
+  if (major >= 20) {
+    success(`Node.js ${nodeVersion}`);
+  } else {
+    error(`Node.js ${nodeVersion} — need 20+`);
+    process.exit(1);
+  }
+
+  try {
+    require("@open-wallet-standard/core");
+    success("OWS SDK loaded (native bindings OK)");
+  } catch {
+    error("OWS SDK failed to load. Run: npm install @open-wallet-standard/core");
+    process.exit(1);
+  }
+
+  // Step 2: Passphrase
+  header("Step 2: Passphrase");
+  log("Choose a passphrase to protect your writer agent.\n");
+  const passphrase = await askSecret("  Passphrase: ");
+  const confirm = await askSecret("  Confirm:    ");
+
+  if (passphrase !== confirm) {
+    error("Passphrases don't match.");
+    rl.close();
+    process.exit(1);
+  }
+  if (passphrase.length < 8) {
+    error("Passphrase must be at least 8 characters.");
+    rl.close();
+    process.exit(1);
+  }
+
+  writeEnvVar("OWS_PASSPHRASE", passphrase);
+  success("Passphrase set");
+
+  // Step 3: LLM Provider
+  header("Step 3: LLM Provider");
+  log("1) Anthropic (recommended)");
+  log("2) OpenAI");
+  log("3) Google Gemini");
+  log("4) Local (Ollama/LM Studio)\n");
+
+  const choice = await ask(rl, "  Choose [1-4]: ");
+  const providers = {
+    "1": { id: "anthropic", name: "Anthropic", envKey: "ANTHROPIC_API_KEY", model: "claude-sonnet-4-6" },
+    "2": { id: "openai", name: "OpenAI", envKey: "OPENAI_API_KEY", model: "gpt-4.1-mini" },
+    "3": { id: "gemini", name: "Gemini", envKey: "GEMINI_API_KEY", model: "gemini-2.5-flash" },
+    "4": { id: "local", name: "Local", envKey: null, model: "llama3.2" },
+  };
+
+  const provider = providers[choice] || providers["1"];
+  let baseUrl = "";
+
+  if (provider.id === "local") {
+    baseUrl = await ask(rl, "  Base URL [http://localhost:11434]: ") || "http://localhost:11434";
+    const modelName = await ask(rl, `  Model name [${provider.model}]: `) || provider.model;
+    provider.model = modelName;
+    rl.close();
+  } else {
+    rl.close();
+    const apiKey = await askSecret(`  ${provider.name} API key: `);
+    if (apiKey) {
+      writeEnvVar(provider.envKey, apiKey);
+      success(`${provider.name} API key saved`);
+    }
+  }
+
+  success(`Provider: ${provider.name} / ${provider.model}`);
+
+  // Step 4: OWS Wallet
+  header("Step 4: OWS Wallet");
+  try {
+    const ows = require("@open-wallet-standard/core");
+    const wallets = ows.listWallets();
+    let wallet = wallets.find((w) => w.name.startsWith("plotlink-writer"));
+
+    if (!wallet) {
+      wallet = ows.createWallet("plotlink-writer", passphrase);
+      success("Wallet created");
+    } else {
+      success("Wallet already exists");
+    }
+
+    const evmAccount = wallet.accounts.find((a) => a.chainId.startsWith("eip155:"));
+    if (evmAccount) {
+      log(`  Address (Base): ${evmAccount.address}`);
+      log("");
+      log("  Fund this address with a small amount of ETH on Base");
+      log("  for gas (~$0.01 per story publish).");
+    }
+  } catch (err) {
+    warn(`Wallet creation skipped: ${err.message}`);
+    warn("You can create it later from the app's wallet setup screen.");
+  }
+
+  // Save config
+  const config = {
+    port: 7777,
+    passphrase_hash: hashPassphrase(passphrase),
+    llm: {
+      provider: provider.id,
+      model: provider.model,
+      ...(baseUrl && { baseUrl }),
+    },
+    wallet_name: "plotlink-writer",
+    created_at: new Date().toISOString(),
+  };
+  writeConfig(config);
+
+  // Also write agent.config.json for the app
+  const agentConfig = {
+    llm: {
+      activeProvider: provider.id,
+      activeModel: provider.model,
+      ...(provider.id === "local" && {
+        local: { baseUrl, model: provider.model, apiType: "ollama" },
+      }),
+      ...(provider.id !== "local" && {
+        [provider.id]: { apiKey: `env:${provider.envKey}`, model: provider.model },
+      }),
+    },
+  };
+  fs.writeFileSync(AGENT_CONFIG_FILE, JSON.stringify(agentConfig, null, 2) + "\n");
+
+  // Step 5: Done
+  header("Setup Complete!");
+  log(`LLM:    ${provider.name} / ${provider.model}`);
+  log(`Port:   ${config.port}`);
+  log(`Config: ${CONFIG_FILE}`);
+  log("");
+  log('Run \x1b[1mnpx plotlink-ows\x1b[0m to start writing!');
+  log("");
+
+  process.exit(0);
+}
+
+function cmdStart() {
+  const config = readConfig();
+  if (!config) {
+    warn("Not configured yet.");
+    log('Run \x1b[1mnpx plotlink-ows init\x1b[0m first.');
+    process.exit(1);
+  }
+
+  // Check if already running
+  if (fs.existsSync(PID_FILE)) {
+    const pid = parseInt(fs.readFileSync(PID_FILE, "utf-8"));
+    try {
+      process.kill(pid, 0);
+      log(`Already running (PID ${pid}).`);
+      log(`Open http://localhost:${config.port || 7777}`);
+      process.exit(0);
+    } catch {
+      fs.unlinkSync(PID_FILE);
+    }
+  }
+
+  // Ensure deps installed
+  if (!fs.existsSync(path.join(PROJECT_DIR, "node_modules"))) {
+    log("Installing dependencies...");
+    execSync("npm install", { cwd: PROJECT_DIR, stdio: "inherit" });
+  }
+
+  // Ensure frontend is built
+  const distDir = path.join(PROJECT_DIR, "app", "web", "dist");
+  if (!fs.existsSync(distDir)) {
+    log("Building frontend...");
+    execSync("npx vite build --config app/vite.config.ts", { cwd: PROJECT_DIR, stdio: "inherit" });
+  }
+
+  const port = config.port || 7777;
+  log(`Starting PlotLink OWS on port ${port}...`);
+
+  const server = spawn("npx", ["tsx", "app/server.ts"], {
+    cwd: PROJECT_DIR,
+    stdio: "ignore",
+    detached: true,
+    env: { ...process.env, APP_PORT: String(port) },
+  });
+  server.unref();
+
+  ensureConfigDir();
+  fs.writeFileSync(PID_FILE, String(server.pid));
+
+  // Auto-open browser
+  setTimeout(() => {
+    try {
+      const cmd = process.platform === "darwin" ? "open" : "xdg-open";
+      execSync(`${cmd} http://localhost:${port}`, { stdio: "ignore" });
+    } catch { /* ignore */ }
+  }, 2000);
+
+  success(`Server started (PID ${server.pid})`);
+  log(`Open http://localhost:${port}`);
+}
+
+function cmdStop() {
+  if (!fs.existsSync(PID_FILE)) {
+    log("Not running.");
+    return;
+  }
+
+  const pid = parseInt(fs.readFileSync(PID_FILE, "utf-8"));
+  try {
+    process.kill(pid, "SIGTERM");
+    success(`Stopped (PID ${pid})`);
+  } catch {
+    warn(`Process ${pid} not found.`);
+  }
+  fs.unlinkSync(PID_FILE);
+}
+
+function cmdStatus() {
+  const config = readConfig();
+  header("PlotLink OWS — Status");
+
+  if (!config) {
+    warn("Not configured. Run: npx plotlink-ows init");
+    return;
+  }
+
+  log(`Config:   ${CONFIG_FILE}`);
+  log(`LLM:      ${config.llm?.provider || "—"} / ${config.llm?.model || "—"}`);
+  log(`Port:     ${config.port || 7777}`);
+
+  // Wallet
+  try {
+    const ows = require("@open-wallet-standard/core");
+    const wallets = ows.listWallets();
+    const wallet = wallets.find((w) => w.name.startsWith("plotlink-writer"));
+    if (wallet) {
+      const evmAccount = wallet.accounts.find((a) => a.chainId.startsWith("eip155:"));
+      log(`Wallet:   ${evmAccount?.address || "no EVM address"}`);
+    } else {
+      log("Wallet:   not created");
+    }
+  } catch {
+    log("Wallet:   OWS SDK not available");
+  }
+
+  // Server status
+  if (fs.existsSync(PID_FILE)) {
+    const pid = parseInt(fs.readFileSync(PID_FILE, "utf-8"));
+    try {
+      process.kill(pid, 0);
+      log(`Server:   \x1b[32mrunning\x1b[0m (PID ${pid})`);
+    } catch {
+      log("Server:   stopped");
+      fs.unlinkSync(PID_FILE);
+    }
+  } else {
+    log("Server:   stopped");
+  }
+  log("");
+}
+
+// ── Router ──
+
+const cmd = process.argv[2];
+switch (cmd) {
+  case "init":
+    cmdInit();
+    break;
+  case "stop":
+    cmdStop();
+    break;
+  case "status":
+    cmdStatus();
+    break;
+  default:
+    cmdStart();
+    break;
+}

package/lib/ows/index.ts

@@ -0,0 +1,3 @@
+export type { AccountInfo, WalletInfo, SignResult, SendResult, ApiKeyResult, SpendingPolicy } from "./types";
+export { createAgentWallet, getAgentWallet, listAgentWallets, deleteAgentWallet, getBaseAddress, signAgentMessage, signAgentTransaction, signAndSendAgent } from "./wallet";
+export { createSpendingPolicy, listPolicies, getPolicy, deletePolicyById, createAgentApiKey, listAgentApiKeys, revokeAgentApiKey } from "./policy";

package/lib/ows/policy.ts

@@ -0,0 +1,68 @@
+import {
+  createPolicy as sdkCreatePolicy,
+  listPolicies as sdkListPolicies,
+  getPolicy as sdkGetPolicy,
+  deletePolicy as sdkDeletePolicy,
+  createApiKey as sdkCreateApiKey,
+  listApiKeys as sdkListApiKeys,
+  revokeApiKey as sdkRevokeApiKey,
+} from "@open-wallet-standard/core";
+import type { ApiKeyResult } from "./types";
+
+const vaultPath = process.env.OWS_VAULT_PATH || undefined;
+const defaultChain = process.env.OWS_DEFAULT_POLICY_CHAIN || "eip155:8453";
+const defaultSpendCap = process.env.OWS_DEFAULT_POLICY_SPEND_CAP || "10";
+
+/** Create a spending policy for an agent wallet. */
+export function createSpendingPolicy(opts: {
+  name: string;
+  maxSpend?: string;
+  chain?: string;
+  tokenAddress?: string;
+  expiresAt?: string;
+}): void {
+  const policy = {
+    name: opts.name,
+    chain: opts.chain || defaultChain,
+    max_spend: opts.maxSpend || defaultSpendCap,
+    ...(opts.tokenAddress && { token_address: opts.tokenAddress }),
+    ...(opts.expiresAt && { expires_at: opts.expiresAt }),
+  };
+  sdkCreatePolicy(JSON.stringify(policy), vaultPath);
+}
+
+/** List all registered policies. */
+export function listPolicies(): unknown[] {
+  return sdkListPolicies(vaultPath);
+}
+
+/** Get a single policy by ID. */
+export function getPolicy(id: string): unknown {
+  return sdkGetPolicy(id, vaultPath);
+}
+
+/** Delete a policy by ID. */
+export function deletePolicyById(id: string): void {
+  sdkDeletePolicy(id, vaultPath);
+}
+
+/** Create an API key for agent access to wallets. */
+export function createAgentApiKey(
+  name: string,
+  walletIds: string[],
+  policyIds: string[],
+  passphrase: string,
+  expiresAt?: string,
+): ApiKeyResult {
+  return sdkCreateApiKey(name, walletIds, policyIds, passphrase, expiresAt, vaultPath);
+}
+
+/** List all API keys (tokens are never returned). */
+export function listAgentApiKeys(): unknown[] {
+  return sdkListApiKeys(vaultPath);
+}
+
+/** Revoke an API key by ID. */
+export function revokeAgentApiKey(id: string): void {
+  sdkRevokeApiKey(id, vaultPath);
+}

package/lib/ows/types.ts

@@ -0,0 +1,14 @@
+import type { AccountInfo, WalletInfo, SignResult, SendResult, ApiKeyResult } from "@open-wallet-standard/core";
+
+// Re-export SDK types
+export type { AccountInfo, WalletInfo, SignResult, SendResult, ApiKeyResult };
+
+/** Policy definition for OWS spending policies */
+export interface SpendingPolicy {
+  id?: string;
+  name: string;
+  chain: string;
+  max_spend: string;
+  token_address?: string;
+  expires_at?: string;
+}

package/lib/ows/wallet.ts

@@ -0,0 +1,70 @@
+import {
+  createWallet as sdkCreateWallet,
+  getWallet as sdkGetWallet,
+  listWallets as sdkListWallets,
+  deleteWallet as sdkDeleteWallet,
+  signMessage as sdkSignMessage,
+  signTransaction as sdkSignTransaction,
+  signAndSend as sdkSignAndSend,
+} from "@open-wallet-standard/core";
+import type { WalletInfo, SignResult, SendResult } from "./types";
+
+const vaultPath = process.env.OWS_VAULT_PATH || undefined;
+
+/** Create a new OWS wallet and return its info. */
+export function createAgentWallet(name: string, passphrase?: string): WalletInfo {
+  return sdkCreateWallet(name, passphrase, undefined, vaultPath);
+}
+
+/** Get a wallet by name or ID. */
+export function getAgentWallet(nameOrId: string): WalletInfo {
+  return sdkGetWallet(nameOrId, vaultPath);
+}
+
+/** List all wallets in the vault. */
+export function listAgentWallets(): WalletInfo[] {
+  return sdkListWallets(vaultPath);
+}
+
+/** Delete a wallet by name or ID. */
+export function deleteAgentWallet(nameOrId: string): void {
+  sdkDeleteWallet(nameOrId, vaultPath);
+}
+
+/** Extract the EVM address from a wallet's accounts (same address on all EVM chains including Base). */
+export function getBaseAddress(wallet: WalletInfo): string | undefined {
+  return wallet.accounts.find(
+    (a) => a.chainId.startsWith("eip155:"),
+  )?.address;
+}
+
+/** Sign a message with a wallet. */
+export function signAgentMessage(
+  wallet: string,
+  message: string,
+  passphrase?: string,
+): SignResult {
+  const chain = process.env.OWS_DEFAULT_POLICY_CHAIN || "eip155:8453";
+  return sdkSignMessage(wallet, chain, message, passphrase, undefined, undefined, vaultPath);
+}
+
+/** Sign a transaction with a wallet. */
+export function signAgentTransaction(
+  wallet: string,
+  txHex: string,
+  passphrase?: string,
+): SignResult {
+  const chain = process.env.OWS_DEFAULT_POLICY_CHAIN || "eip155:8453";
+  return sdkSignTransaction(wallet, chain, txHex, passphrase, undefined, vaultPath);
+}
+
+/** Sign and broadcast a transaction. */
+export function signAndSendAgent(
+  wallet: string,
+  txHex: string,
+  passphrase?: string,
+  rpcUrl?: string,
+): SendResult {
+  const chain = process.env.OWS_DEFAULT_POLICY_CHAIN || "eip155:8453";
+  return sdkSignAndSend(wallet, chain, txHex, passphrase, undefined, rpcUrl, vaultPath);
+}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "plotlink-ows",
+  "version": "0.1.13",
+  "bin": {
+    "plotlink-ows": "./bin/plotlink-ows.js"
+  },
+  "files": [
+    "bin/",
+    "app/",
+    "lib/ows/",
+    "packages/",
+    "public/",
+    "scripts/"
+  ],
+  "workspaces": [
+    "packages/*"
+  ],
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:e2e": "playwright test",
+    "app:dev": "concurrently \"tsx watch app/server.ts\" \"vite --config app/vite.config.ts\"",
+    "app:build": "vite build --config app/vite.config.ts",
+    "app:start": "tsx app/server.ts",
+    "prisma:local": "prisma generate --schema app/prisma/schema.prisma && prisma db push --schema app/prisma/schema.prisma"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.1009.0",
+    "@farcaster/miniapp-node": "^0.1.13",
+    "@farcaster/miniapp-sdk": "^0.3.0",
+    "@farcaster/miniapp-wagmi-connector": "^2.0.0",
+    "@hono/node-server": "^1.19.12",
+    "@hono/node-ws": "^1.3.0",
+    "@open-wallet-standard/core": "^1.2.4",
+    "@prisma/client": "^6.19.3",
+    "@rainbow-me/rainbowkit": "^2.2.10",
+    "@supabase/supabase-js": "^2.99.1",
+    "@tanstack/react-query": "^5.90.21",
+    "@vercel/analytics": "^2.0.1",
+    "dotenv": "^17.4.0",
+    "hono": "^4.12.10",
+    "next": "16.1.6",
+    "ox": "^0.14.8",
+    "prisma": "^6.19.3",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-markdown": "^10.1.0",
+    "rehype-sanitize": "^6.0.0",
+    "remark-breaks": "^4.0.0",
+    "remark-gfm": "^4.0.1",
+    "tailwindcss": "^4",
+    "tsx": "^4.21.0",
+    "viem": "^2.47.2",
+    "vite": "^6.4.1",
+    "@vitejs/plugin-react": "^4.7.0",
+    "@tailwindcss/vite": "^4.2.2",
+    "wagmi": "^2.19.5"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.2",
+    "@tailwindcss/postcss": "^4",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "concurrently": "^9.2.1",
+    "eslint": "^9",
+    "eslint-config-next": "16.1.6",
+    "jsdom": "^27.0.1",
+    "typescript": "^5",
+    "vitest": "^3.2.4"
+  }
+}

package/packages/cli/node_modules/commander/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2011 TJ Holowaychuk <tj@vision-media.ca>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.