incur 0.0.0 → 0.0.2

package/examples/npm/cli.ts

@@ -0,0 +1,180 @@
+import { Cli, z } from 'incur'
+
+const cli = Cli.create('npm', {
+  version: '10.9.2',
+  description: 'The package manager for JavaScript.',
+  sync: {
+    suggestions: ['install react as a dependency', 'check for outdated packages', 'audit my repo'],
+  },
+})
+
+cli.command('install', {
+  description: 'Install a package',
+  args: z.object({
+    package: z.string().optional().describe('Package name to install'),
+  }),
+  options: z.object({
+    saveDev: z.boolean().optional().describe('Save as dev dependency'),
+    saveExact: z.boolean().optional().describe('Save exact version'),
+    global: z.boolean().optional().describe('Install globally'),
+  }),
+  alias: { saveDev: 'D', global: 'g', saveExact: 'E' },
+  output: z.object({
+    added: z.number().describe('Number of packages added'),
+    removed: z.number().describe('Number of packages removed'),
+    changed: z.number().describe('Number of packages changed'),
+    packages: z.number().describe('Total packages in node_modules'),
+  }),
+  examples: [
+    { args: { package: 'express' }, description: 'Install a package' },
+    {
+      args: { package: 'vitest' },
+      options: { saveDev: true },
+      description: 'Install as dev dependency',
+    },
+    { options: { global: true }, args: { package: 'tsx' }, description: 'Install globally' },
+  ],
+  run({ args }) {
+    if (!args.package) return { added: 120, removed: 0, changed: 0, packages: 450 }
+    return { added: 1, removed: 0, changed: 0, packages: 451 }
+  },
+})
+
+cli.command('info', {
+  description: 'View registry info for a package',
+  args: z.object({
+    package: z.string().describe('Package name'),
+  }),
+  output: z.object({
+    name: z.string(),
+    version: z.string().describe('Latest version'),
+    description: z.string(),
+    license: z.string(),
+    homepage: z.string(),
+  }),
+  examples: [{ args: { package: 'express' }, description: 'View info for express' }],
+  run({ args }) {
+    return {
+      name: args.package,
+      version: '4.21.2',
+      description: 'Fast, unopinionated, minimalist web framework',
+      license: 'MIT',
+      homepage: 'https://expressjs.com/',
+    }
+  },
+})
+
+cli.command('init', {
+  description: 'Create a package.json file',
+  options: z.object({
+    yes: z.boolean().describe('Skip prompts and use defaults'),
+    scope: z.string().optional().describe('Package scope'),
+  }),
+  alias: { yes: 'y' },
+  output: z.object({
+    created: z.string().describe('Path to created package.json'),
+  }),
+  examples: [{ options: { yes: true }, description: 'Create with defaults' }],
+  run() {
+    return { created: './package.json' }
+  },
+})
+
+cli.command('publish', {
+  description: 'Publish a package to the registry',
+  env: z.object({
+    NPM_TOKEN: z.string().optional().describe('Authentication token'),
+    NPM_REGISTRY: z.string().default('https://registry.npmjs.org').describe('Registry URL'),
+  }),
+  options: z.object({
+    tag: z.string().default('latest').describe('Distribution tag'),
+    access: z.enum(['public', 'restricted']).default('public').describe('Package access level'),
+    dryRun: z.boolean().describe('Report what would be published'),
+    otp: z.string().optional().describe('One-time password for 2FA'),
+  }),
+  output: z.object({
+    name: z.string(),
+    version: z.string(),
+    tag: z.string(),
+  }),
+  examples: [
+    { description: 'Publish with latest tag' },
+    { options: { tag: 'beta' }, description: 'Publish as beta' },
+    { options: { dryRun: true }, description: 'Dry run' },
+  ],
+  run({ options }) {
+    return { name: 'my-package', version: '1.0.0', tag: options.tag }
+  },
+})
+
+cli.command('run', {
+  description: 'Run a script defined in package.json',
+  args: z.object({
+    script: z.string().describe('Script name to run'),
+  }),
+  output: z.object({
+    script: z.string(),
+    exitCode: z.number(),
+  }),
+  examples: [
+    { args: { script: 'test' }, description: 'Run tests' },
+    { args: { script: 'build' }, description: 'Run build' },
+  ],
+  run({ args }) {
+    return { script: args.script, exitCode: 0 }
+  },
+})
+
+cli.command('uninstall', {
+  description: 'Remove a package',
+  args: z.object({
+    package: z.string().describe('Package name to remove'),
+  }),
+  options: z.object({
+    global: z.boolean().describe('Remove global package'),
+  }),
+  alias: { global: 'g' },
+  output: z.object({
+    removed: z.number(),
+    packages: z.number().describe('Remaining packages'),
+  }),
+  examples: [{ args: { package: 'express' }, description: 'Remove a package' }],
+  run() {
+    return { removed: 1, packages: 449 }
+  },
+})
+
+cli.command('outdated', {
+  description: 'Check for outdated packages',
+  options: z.object({
+    global: z.boolean().describe('Check global packages'),
+    long: z.boolean().describe('Show extended information'),
+  }),
+  alias: { global: 'g', long: 'l' },
+  output: z.object({
+    packages: z.array(
+      z.object({
+        name: z.string(),
+        current: z.string(),
+        wanted: z.string(),
+        latest: z.string(),
+      }),
+    ),
+  }),
+  examples: [
+    { description: 'Check for outdated packages' },
+    { options: { global: true }, description: 'Check global packages' },
+  ],
+  run() {
+    return {
+      packages: [
+        { name: 'express', current: '4.18.0', wanted: '4.21.2', latest: '4.21.2' },
+        { name: 'typescript', current: '5.3.0', wanted: '5.7.3', latest: '5.7.3' },
+      ],
+    }
+  },
+})
+
+cli.serve()
+
+export default cli

package/examples/npm/node_modules/.bin/incur.src

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../incur/src/bin.ts" "$@"
+else
+  exec node  "$basedir/../incur/src/bin.ts" "$@"
+fi

package/examples/npm/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/examples/npm/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "npm",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "npm": "node --import tsx cli.ts"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  },
+  "dependencies": {
+    "incur": "workspace:*"
+  }
+}

package/examples/npm/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "paths": {
+      "incur": ["../../src"]
+    }
+  },
+  "include": ["*.ts"]
+}

package/examples/presto/cli.ts

@@ -0,0 +1,246 @@
+import { Cli, z } from 'incur'
+
+const cli = Cli.create('presto', {
+  version: '0.4.1',
+  description: 'A command-line HTTP client with built-in MPP payment support.',
+})
+
+// query (root-level URL request) — modeled as an explicit subcommand
+cli.command('query', {
+  description: 'Make an HTTP request with optional payment',
+  args: z.object({
+    url: z.string().describe('URL to request'),
+  }),
+  options: z.object({
+    dryRun: z.boolean().optional().describe('Show what would be paid without executing'),
+    method: z.string().optional().describe('Custom request method (GET, POST, PUT, DELETE, ...)'),
+    header: z
+      .array(z.string())
+      .optional()
+      .describe("Add custom header (e.g. 'Accept: text/plain')"),
+    data: z.array(z.string()).optional().describe('POST data (use @filename or @- for stdin)'),
+    json: z.string().optional().describe('Send JSON data with Content-Type header'),
+    include: z.boolean().optional().describe('Include HTTP response headers in output'),
+    output: z.string().optional().describe('Write output to file'),
+    timeout: z.number().optional().describe('Maximum time for the request in seconds'),
+    noRedirect: z.boolean().optional().describe('Disable following redirects'),
+    network: z.string().optional().describe('Restrict to a specific network'),
+  }),
+  alias: {
+    method: 'X',
+    header: 'H',
+    data: 'd',
+    include: 'i',
+    output: 'o',
+    timeout: 'm',
+    network: 'n',
+  },
+  examples: [
+    { args: { url: 'https://api.example.com/data' }, description: 'Simple GET' },
+    {
+      args: { url: 'https://api.example.com/data' },
+      options: { method: 'POST', json: '{"key":"value"}' },
+      description: 'POST with JSON body',
+    },
+    {
+      args: { url: 'https://api.example.com/data' },
+      options: { dryRun: true },
+      description: 'Preview payment without executing',
+    },
+  ],
+  run({ error }) {
+    const loggedIn = true
+    if (!loggedIn)
+      return error({
+        code: 'NOT_AUTHENTICATED',
+        message: 'No wallet connected. Log in first.',
+        retryable: true,
+        cta: {
+          description: 'To authenticate:',
+          commands: [{ command: 'login', description: 'Sign up or log in to your Tempo wallet' }],
+        },
+      })
+    return {
+      id: 'chatcmpl-abc123',
+      object: 'chat.completion',
+      model: 'gpt-4o-mini',
+      choices: [
+        {
+          index: 0,
+          message: { role: 'assistant', content: 'Hello! How can I help you today?' },
+          finish_reason: 'stop',
+        },
+      ],
+      usage: { prompt_tokens: 8, completion_tokens: 9, total_tokens: 17 },
+    }
+  },
+})
+
+cli.command('login', {
+  description: 'Sign up or log in to your Tempo wallet',
+  run({ ok }) {
+    return ok(
+      { status: 'logged_in' },
+      {
+        cta: {
+          description: 'Next steps:',
+          commands: [
+            { command: 'whoami', description: 'Check your wallet address and balances' },
+            {
+              command: 'query',
+              args: { url: 'https://api.example.com/data' },
+              description: 'Make your first paid request',
+            },
+          ],
+        },
+      },
+    )
+  },
+})
+
+cli.command('logout', {
+  description: 'Log out and disconnect your wallet',
+  options: z.object({
+    yes: z.boolean().optional().describe('Skip confirmation prompt'),
+  }),
+  run() {
+    return { status: 'logged_out' }
+  },
+})
+
+cli.command('whoami', {
+  description: 'Show wallet address, balances, and access keys',
+  output: z.object({
+    address: z.string(),
+    balances: z.array(
+      z.object({
+        network: z.string(),
+        amount: z.string(),
+      }),
+    ),
+  }),
+  run() {
+    return {
+      address: '0x1234...abcd',
+      balances: [{ network: 'tempo', amount: '100.00 TEMPO' }],
+    }
+  },
+})
+
+// session subcommand group
+const session = Cli.create('session', { description: 'Manage payment sessions' })
+
+session.command('list', {
+  description: 'List active payment sessions',
+  options: z.object({
+    all: z.boolean().optional().describe('Show all channels: active, orphaned, and closing'),
+    orphaned: z.boolean().optional().describe('Scan on-chain for orphaned channels'),
+    closed: z.boolean().optional().describe('Show channels pending finalization'),
+    network: z.string().optional().describe('Filter by network'),
+  }),
+  run() {
+    return { sessions: [] }
+  },
+})
+
+session.command('close', {
+  description: 'Close a payment session',
+  args: z.object({
+    url: z.string().optional().describe('URL, origin, or channel ID (0x...) to close'),
+  }),
+  options: z.object({
+    all: z.boolean().optional().describe('Close all active sessions'),
+    orphaned: z.boolean().optional().describe('Close only orphaned on-chain channels'),
+    closed: z.boolean().optional().describe('Finalize channels pending close'),
+  }),
+  run({ ok }) {
+    return ok(
+      { closed: true },
+      {
+        cta: {
+          description: 'Suggested commands:',
+          commands: [
+            { command: 'session list', description: 'View remaining sessions' },
+            { command: 'whoami', description: 'Check updated balances' },
+          ],
+        },
+      },
+    )
+  },
+})
+
+session.command('recover', {
+  description: 'Recover a session from on-chain state',
+  run() {
+    return { recovered: true }
+  },
+})
+
+cli.command(session)
+
+// key subcommand group
+const key = Cli.create('key', { description: 'Manage access keys' })
+
+key.command('list', {
+  description: 'List all access keys and their spending limits',
+  run() {
+    return { keys: [] }
+  },
+})
+
+key.command('create', {
+  description: 'Create a new access key for a local wallet',
+  options: z.object({
+    name: z.string().optional().describe('Wallet name'),
+  }),
+  run() {
+    return { created: true }
+  },
+})
+
+cli.command(key)
+
+// wallet subcommand group
+const wallet = Cli.create('wallet', { description: 'Manage wallets' })
+
+wallet.command('create', {
+  description: 'Create a new wallet',
+  options: z.object({
+    name: z.string().optional().describe('Name for the wallet'),
+    passkey: z.boolean().optional().describe('Create a passkey-based wallet via browser auth'),
+  }),
+  run() {
+    return { created: true }
+  },
+})
+
+wallet.command('import', {
+  description: 'Import an existing private key as a local wallet',
+  options: z.object({
+    name: z.string().optional().describe('Name for the wallet'),
+    stdinKey: z.boolean().optional().describe('Read the private key from stdin'),
+  }),
+  run() {
+    return { imported: true }
+  },
+})
+
+wallet.command('delete', {
+  description: 'Delete a wallet',
+  args: z.object({
+    name: z.string().optional().describe('Wallet name to delete'),
+  }),
+  options: z.object({
+    passkey: z.boolean().optional().describe('Delete the passkey wallet'),
+    yes: z.boolean().optional().describe('Skip confirmation prompt'),
+  }),
+  run() {
+    return { deleted: true }
+  },
+})
+
+cli.command(wallet)
+
+cli.serve()
+
+export default cli

package/examples/presto/node_modules/.bin/incur.src

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../incur/src/bin.ts" "$@"
+else
+  exec node  "$basedir/../incur/src/bin.ts" "$@"
+fi

package/examples/presto/node_modules/.bin/tsx

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/incur/incur/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tsx/dist/cli.mjs" "$@"
+else
+  exec node  "$basedir/../tsx/dist/cli.mjs" "$@"
+fi

package/examples/presto/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "presto",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "presto": "node --import tsx cli.ts"
+  },
+  "devDependencies": {
+    "tsx": "^4.21.0"
+  },
+  "dependencies": {
+    "incur": "workspace:*"
+  }
+}

package/examples/presto/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "paths": {
+      "incur": ["../../src"]
+    }
+  },
+  "include": ["*.ts"]
+}

package/package.json

@@ -1,4 +1,55 @@
 {
+  "devDependencies": {
+    "@changesets/cli": "latest",
+    "@types/node": "latest",
+    "oxfmt": "^0.35.0",
+    "oxlint": "^1.50.0",
+    "tsx": "^4.21.0",
+    "typescript": "latest",
+    "vitest": "latest",
+    "zile": "latest"
+  },
+  "[!start-pkg]": "",
   "name": "incur",
-  "version": "0.0.0"
-}
+  "type": "module",
+  "version": "0.0.2",
+  "license": "MIT",
+  "files": [
+    "examples",
+    "dist",
+    "src",
+    "SKILL.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@toon-format/toon": "^2.1.0",
+    "yaml": "^2.8.2",
+    "zod": "^4.3.6"
+  },
+  "sideEffects": false,
+  "bin": {
+    "incur": "./dist/bin.js",
+    "incur.src": "./src/bin.ts"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "src": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "zile",
+    "changeset:publish": "zile publish:prepare && changeset publish && zile publish:post",
+    "changeset:version": "changeset version",
+    "check": "oxlint --fix --ignore-pattern package.json && oxfmt",
+    "check:types": "tsc -b",
+    "incur": "node --import tsx src/bin.ts",
+    "cli:skills": "pnpm incur skills add",
+    "dev": "zile dev",
+    "test": "vitest"
+  }
+}