treeship-cli 0.1.0

package/bin/treeship.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { attestCommand } from '../commands/attest.js';
+import { verifyCommand } from '../commands/verify.js';
+import { whoamiCommand } from '../commands/whoami.js';
+import { configCommand } from '../commands/config.js';
+
+program
+  .name('treeship')
+  .description('Treeship CLI - Cryptographic attestations for AI agents')
+  .version('0.1.0');
+
+program.addCommand(attestCommand);
+program.addCommand(verifyCommand);
+program.addCommand(whoamiCommand);
+program.addCommand(configCommand);
+
+program.parse();

package/commands/attest.js

@@ -0,0 +1,55 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { TreeshipClient } from '../lib/client.js';
+import { getDefaultAgent } from '../lib/config.js';
+
+export const attestCommand = new Command('attest')
+  .description('Create a cryptographic attestation for an agent action')
+  .requiredOption('--action <text>', 'Description of the action being attested')
+  .requiredOption('--inputs-hash <hash>', 'SHA256 hash of the inputs')
+  .option('--agent <slug>', 'Agent slug (or set TREESHIP_AGENT)')
+  .option('--json', 'Output as JSON')
+  .option('--quiet', 'Output only the verification URL')
+  .action(async (opts) => {
+    try {
+      const agentSlug = opts.agent ?? getDefaultAgent();
+      
+      if (!agentSlug) {
+        console.error(chalk.red('✗ Agent slug required. Use --agent or set TREESHIP_AGENT'));
+        process.exit(1);
+      }
+
+      const client = new TreeshipClient();
+      const result = await client.attest({
+        agentSlug,
+        action: opts.action,
+        inputsHash: opts.inputsHash,
+      });
+
+      if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else if (opts.quiet) {
+        console.log(result.public_url);
+      } else {
+        console.log('');
+        console.log(chalk.green('✓ Attestation created'));
+        console.log('');
+        console.log(chalk.dim('  ID        ') + result.attestation_id);
+        console.log(chalk.dim('  Agent     ') + result.agent_slug);
+        console.log(chalk.dim('  Action    ') + result.action);
+        console.log(chalk.dim('  Hash      ') + result.payload_hash.slice(0, 16) + '...');
+        console.log(chalk.dim('  Signature ') + result.signature.slice(0, 24) + '...');
+        console.log('');
+        console.log(chalk.dim('  Verify    ') + chalk.cyan.underline(result.public_url));
+        console.log(chalk.dim('  CLI       ') + chalk.dim(result.verify_command));
+        console.log('');
+      }
+    } catch (err) {
+      if (opts.json) {
+        console.log(JSON.stringify({ error: err.message }));
+      } else {
+        console.error(chalk.red('✗ ' + err.message));
+      }
+      process.exit(1);
+    }
+  });

package/commands/config.js

@@ -0,0 +1,42 @@
+import { Command } from 'commander';
+import { getConfig } from '../lib/config.js';
+
+export const configCommand = new Command('config')
+  .description('Manage CLI configuration');
+
+configCommand
+  .command('set <key> <value>')
+  .description('Set a configuration value')
+  .action((key, value) => {
+    const config = getConfig();
+    const normalizedKey = key.replace(/-/g, '_');
+    config.set(normalizedKey, value);
+    console.log(`✓ Set ${key} = ${value}`);
+  });
+
+configCommand
+  .command('get <key>')
+  .description('Get a configuration value')
+  .action((key) => {
+    const config = getConfig();
+    const normalizedKey = key.replace(/-/g, '_');
+    const value = config.get(normalizedKey);
+    console.log(value ?? '(not set)');
+  });
+
+configCommand
+  .command('list')
+  .description('List all configuration values')
+  .action(() => {
+    const config = getConfig();
+    console.log(JSON.stringify(config.store, null, 2));
+  });
+
+configCommand
+  .command('reset')
+  .description('Reset all configuration')
+  .action(() => {
+    const config = getConfig();
+    config.clear();
+    console.log('✓ Configuration reset');
+  });

package/commands/verify.js

@@ -0,0 +1,57 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { TreeshipClient } from '../lib/client.js';
+
+export const verifyCommand = new Command('verify')
+  .description('Verify an attestation by ID')
+  .argument('<attestation-id>', 'The attestation ID to verify')
+  .option('--json', 'Output as JSON')
+  .option('--quiet', 'Output only valid/invalid')
+  .action(async (attestationId, opts) => {
+    try {
+      const client = new TreeshipClient();
+      const result = await client.verify(attestationId);
+
+      if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else if (opts.quiet) {
+        console.log(result.valid ? 'valid' : 'invalid');
+        process.exit(result.valid ? 0 : 1);
+      } else {
+        console.log('');
+        if (result.valid) {
+          console.log(chalk.green('✓ Attestation verified'));
+        } else {
+          console.log(chalk.red('✗ Attestation INVALID'));
+        }
+        console.log('');
+        console.log(chalk.dim('  ID        ') + result.attestation_id);
+        console.log(chalk.dim('  Agent     ') + result.agent_slug);
+        console.log(chalk.dim('  Action    ') + result.action);
+        console.log(chalk.dim('  Time      ') + result.timestamp);
+        console.log(chalk.dim('  Hash      ') + result.payload_hash.slice(0, 16) + '...');
+        console.log(chalk.dim('  Key ID    ') + result.key_id);
+        console.log('');
+        
+        if (result.has_zk_proof) {
+          console.log(chalk.blue('⬡ ZK Proof attached'));
+        }
+        
+        console.log(chalk.dim('  Independent verification:'));
+        console.log(chalk.dim('    1. ') + result.independent_verification.curl_pubkey);
+        console.log(chalk.dim('    2. Save payload: ') + chalk.dim('echo \'' + result.independent_verification.recreate_payload.slice(0, 40) + '...\' > payload.txt'));
+        console.log('');
+        
+        if (!result.valid) {
+          process.exit(1);
+        }
+      }
+    } catch (err) {
+      if (opts.json) {
+        console.log(JSON.stringify({ error: err.message, valid: false }));
+      } else {
+        console.error(chalk.red('✗ ' + err.message));
+      }
+      process.exit(1);
+    }
+  });

package/commands/whoami.js

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getConfig, getApiUrl, getApiKey, getDefaultAgent } from '../lib/config.js';
+
+export const whoamiCommand = new Command('whoami')
+  .description('Show current configuration and status')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const apiUrl = getApiUrl();
+    const apiKey = getApiKey();
+    const agent = getDefaultAgent();
+
+    if (opts.json) {
+      console.log(JSON.stringify({
+        api_url: apiUrl,
+        api_key_set: !!apiKey,
+        default_agent: agent || null,
+      }, null, 2));
+    } else {
+      console.log('');
+      console.log(chalk.bold('Treeship CLI'));
+      console.log('');
+      console.log(chalk.dim('  API URL   ') + apiUrl);
+      console.log(chalk.dim('  API Key   ') + (apiKey ? chalk.green('set') : chalk.red('not set')));
+      console.log(chalk.dim('  Agent     ') + (agent || chalk.dim('not set')));
+      
+      if (agent) {
+        console.log('');
+        console.log(chalk.dim('  Feed      ') + chalk.cyan.underline(`https://treeship.dev/verify/${agent}`));
+      }
+      console.log('');
+    }
+  });

package/lib/client.js

@@ -0,0 +1,74 @@
+import { getApiUrl, getApiKey } from './config.js';
+
+export class TreeshipClient {
+  constructor(options = {}) {
+    this.apiUrl = options.apiUrl ?? getApiUrl();
+    this.apiKey = options.apiKey ?? getApiKey();
+  }
+
+  async attest({ agentSlug, action, inputsHash, metadata }) {
+    if (!this.apiKey) {
+      throw new Error('TREESHIP_API_KEY not set. Run: export TREESHIP_API_KEY=your-key');
+    }
+
+    const res = await fetch(`${this.apiUrl}/v1/attest`, {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${this.apiKey}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        agent_slug: agentSlug,
+        action,
+        inputs_hash: inputsHash,
+        metadata,
+      }),
+    });
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Attestation failed (${res.status}): ${text}`);
+    }
+
+    return res.json();
+  }
+
+  async verify(attestationId) {
+    const res = await fetch(`${this.apiUrl}/v1/verify/${attestationId}`);
+
+    if (!res.ok) {
+      if (res.status === 404) {
+        throw new Error(`Attestation not found: ${attestationId}`);
+      }
+      const text = await res.text();
+      throw new Error(`Verification failed (${res.status}): ${text}`);
+    }
+
+    return res.json();
+  }
+
+  async getAgent(slug) {
+    const res = await fetch(`${this.apiUrl}/v1/agent/${slug}`);
+
+    if (!res.ok) {
+      if (res.status === 404) {
+        throw new Error(`Agent not found: ${slug}`);
+      }
+      const text = await res.text();
+      throw new Error(`Failed to get agent (${res.status}): ${text}`);
+    }
+
+    return res.json();
+  }
+
+  async getPubkey() {
+    const res = await fetch(`${this.apiUrl}/v1/pubkey`);
+
+    if (!res.ok) {
+      const text = await res.text();
+      throw new Error(`Failed to get pubkey (${res.status}): ${text}`);
+    }
+
+    return res.json();
+  }
+}

package/lib/config.js

@@ -0,0 +1,25 @@
+import Conf from 'conf';
+
+let _config;
+
+export function getConfig() {
+  if (!_config) {
+    _config = new Conf({ projectName: '@treeship/cli' });
+  }
+  return _config;
+}
+
+export function getApiUrl() {
+  const config = getConfig();
+  return config.get('api_url') ?? process.env.TREESHIP_API_URL ?? 'https://api.treeship.dev';
+}
+
+export function getApiKey() {
+  const config = getConfig();
+  return config.get('api_key') ?? process.env.TREESHIP_API_KEY ?? '';
+}
+
+export function getDefaultAgent() {
+  const config = getConfig();
+  return config.get('default_agent') ?? process.env.TREESHIP_AGENT ?? '';
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "treeship-cli",
+  "version": "0.1.0",
+  "description": "CLI for Treeship - cryptographic attestations for AI agents",
+  "type": "module",
+  "bin": {
+    "treeship": "./bin/treeship.js"
+  },
+  "scripts": {
+    "test": "node --test tests/*.test.js"
+  },
+  "keywords": [
+    "treeship",
+    "attestation",
+    "ai",
+    "agents",
+    "cryptography",
+    "verification"
+  ],
+  "author": "Treeship",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/treeship-dev/treeship.git"
+  },
+  "homepage": "https://treeship.dev",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "conf": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}