@agentcred-ai/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentCred Contributors
+
+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.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+declare const version = "0.0.1";
+declare function main(): Promise<void>;
+
+export { main, version };

package/dist/index.js

@@ -0,0 +1,273 @@
+#!/usr/bin/env node
+
+// src/commands/init.ts
+import { parseArgs } from "util";
+import { createIdentity, FileSystemKeyStorage } from "@agentcred-ai/sdk";
+var HELP = `agentcred init \u2014 Initialize identity with GitHub token
+
+Usage: agentcred init --token <github_token>
+
+Options:
+  --token <token>  GitHub personal access token (required)
+  --help, -h       Show this help message`;
+async function initCommand(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(HELP);
+    return;
+  }
+  const { values } = parseArgs({
+    args,
+    options: {
+      token: { type: "string" }
+    },
+    strict: false
+  });
+  const token = values.token ?? process.env["AGENTCRED_GITHUB_TOKEN"];
+  if (!token) {
+    throw new Error("GitHub token required. Use --token <token> or set AGENTCRED_GITHUB_TOKEN");
+  }
+  if (typeof token !== "string") {
+    throw new Error("Invalid token: --token flag must be provided with a value");
+  }
+  const storage = new FileSystemKeyStorage();
+  const identity = await createIdentity(token, { storage });
+  console.log(`\u2713 Identity created for @${identity.github.username}`);
+}
+
+// src/commands/sign.ts
+import { parseArgs as parseArgs2 } from "util";
+import * as fs from "fs/promises";
+import { loadIdentity, sign, FileSystemKeyStorage as FileSystemKeyStorage2 } from "@agentcred-ai/sdk";
+var HELP2 = `agentcred sign \u2014 Sign content with your AgentCred identity
+
+Usage: agentcred sign [file] [options]
+       cat file.txt | agentcred sign
+
+Options:
+  --agent <name>  Agent name (default: "default")
+  --help, -h      Show this help message
+
+If no file is given, reads from stdin.`;
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+async function signCommand(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(HELP2);
+    return;
+  }
+  const { values, positionals } = parseArgs2({
+    args,
+    options: {
+      agent: { type: "string" }
+    },
+    allowPositionals: true,
+    strict: false
+  });
+  const filePath = positionals[0];
+  let content;
+  if (filePath) {
+    content = await fs.readFile(filePath, "utf-8");
+  } else if (!process.stdin.isTTY) {
+    content = await readStdin();
+  } else {
+    throw new Error("No input provided. Pass a file argument or pipe content via stdin.");
+  }
+  const storage = new FileSystemKeyStorage2();
+  const usernames = await storage.list();
+  if (usernames.length === 0) {
+    throw new Error("No identity found. Run 'agentcred init' first.");
+  }
+  const username = usernames[0];
+  const loaded = await loadIdentity(username, { storage });
+  if (!loaded) {
+    throw new Error("No identity found. Run 'agentcred init' first.");
+  }
+  const envelope = await sign(content, {
+    privateKey: loaded.privateKey,
+    github: username
+  }, { agent: values.agent });
+  console.log(JSON.stringify(envelope, null, 2));
+}
+
+// src/commands/verify.ts
+import { parseArgs as parseArgs3 } from "util";
+import * as fs2 from "fs/promises";
+import { verify, verifyOffline } from "@agentcred-ai/sdk";
+import { importJWK } from "jose";
+var HELP3 = `agentcred verify \u2014 Verify an AgentCred envelope
+
+Usage: agentcred verify [file] [options]
+       cat envelope.json | agentcred verify
+
+Options:
+  --offline        Verify offline using a local public key
+  --key <path>     Path to public key JWK file (used with --offline)
+  --help, -h       Show this help message
+
+If no file is given, reads from stdin.`;
+async function readStdin2() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+async function verifyCommand(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(HELP3);
+    return;
+  }
+  const { values, positionals } = parseArgs3({
+    args,
+    options: {
+      offline: { type: "boolean", default: false },
+      key: { type: "string" }
+    },
+    allowPositionals: true,
+    strict: false
+  });
+  const filePath = positionals[0];
+  let input;
+  if (filePath) {
+    input = await fs2.readFile(filePath, "utf-8");
+  } else if (!process.stdin.isTTY) {
+    input = await readStdin2();
+  } else {
+    throw new Error("No input provided. Pass a file argument or pipe content via stdin.");
+  }
+  let envelope;
+  try {
+    envelope = JSON.parse(input);
+  } catch {
+    throw new Error("Invalid JSON input. Expected an AgentCred envelope.");
+  }
+  if (!envelope.agentcred?.jws) {
+    throw new Error("Invalid envelope: missing agentcred.jws field.");
+  }
+  if (values.offline) {
+    if (!values.key) {
+      throw new Error("--key <path> is required when using --offline");
+    }
+    if (typeof values.key !== "string") {
+      throw new Error("Invalid key: --key flag must be provided with a file path");
+    }
+    const keyData = await fs2.readFile(values.key, "utf-8");
+    const publicJWK = JSON.parse(keyData);
+    const publicKey = await importJWK(publicJWK, "EdDSA");
+    const result = await verifyOffline(envelope, publicKey);
+    if (result.verified) {
+      console.log(`\u2713 Verified: @${result.github?.username} (${result.agent}) at ${result.signedAt}`);
+    } else {
+      console.error(`\u2717 Verification failed: ${result.error}`);
+      process.exit(1);
+    }
+  } else {
+    const result = await verify(envelope);
+    if (result.verified) {
+      console.log(`\u2713 Verified: @${result.github?.username} (${result.agent}) at ${result.signedAt}`);
+    } else {
+      console.error(`\u2717 Verification failed: ${result.error}`);
+      process.exit(1);
+    }
+  }
+}
+
+// src/commands/whoami.ts
+import { FileSystemKeyStorage as FileSystemKeyStorage3 } from "@agentcred-ai/sdk";
+import { createHash } from "crypto";
+import * as fs3 from "fs/promises";
+import * as path from "path";
+import * as os from "os";
+var HELP4 = `agentcred whoami \u2014 Show current identity
+
+Usage: agentcred whoami
+
+Options:
+  --help, -h  Show this help message`;
+async function whoamiCommand(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(HELP4);
+    return;
+  }
+  const storage = new FileSystemKeyStorage3();
+  const usernames = await storage.list();
+  if (usernames.length === 0) {
+    throw new Error("No identity configured. Run 'agentcred init' first.");
+  }
+  const username = usernames[0];
+  const keyDir = path.join(os.homedir(), ".agentcred", "keys");
+  const keyPath = path.join(keyDir, `${username}.jwk`);
+  try {
+    const keyData = await fs3.readFile(keyPath, "utf-8");
+    const privateJWK = JSON.parse(keyData);
+    const { d: _d, ...publicPortion } = privateJWK;
+    const fingerprint = createHash("sha256").update(JSON.stringify(publicPortion)).digest("hex").slice(0, 16);
+    console.log(`You are @${username} (fingerprint: ${fingerprint})`);
+  } catch {
+    throw new Error("No identity configured. Run 'agentcred init' first.");
+  }
+}
+
+// src/index.ts
+var version = "0.0.1";
+var HELP5 = `agentcred v${version} \u2014 Human accountability badge for AI agents
+
+Usage: agentcred <command> [options]
+
+Commands:
+  init      Initialize identity with GitHub token
+  sign      Sign content (file or stdin)
+  verify    Verify an AgentCred envelope (file or stdin)
+  whoami    Show current identity
+
+Options:
+  --help, -h     Show this help message
+  --version, -v  Show version
+
+Run 'agentcred <command> --help' for command-specific help.`;
+var commands = {
+  init: initCommand,
+  sign: signCommand,
+  verify: verifyCommand,
+  whoami: whoamiCommand
+};
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+      console.log(HELP5);
+      process.exit(0);
+    }
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(version);
+    process.exit(0);
+  }
+  const commandName = args[0];
+  const commandArgs = args.slice(1);
+  const command = commands[commandName];
+  if (!command) {
+    console.error(`Unknown command: ${commandName}`);
+    console.error(`Run 'agentcred --help' for available commands.`);
+    process.exit(1);
+  }
+  try {
+    await command(commandArgs);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`\u2717 ${message}`);
+    process.exit(1);
+  }
+}
+if (!process.env["VITEST"]) {
+  main();
+}
+export {
+  main,
+  version
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@agentcred-ai/cli",
+  "version": "0.1.0",
+  "description": "CLI tool for AgentCred developer workflows",
+  "type": "module",
+  "bin": {
+    "agentcred": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "jose": "^6.1.3",
+    "@agentcred-ai/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentcred-ai/agentcred",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://agentcred.dev",
+  "bugs": {
+    "url": "https://github.com/agentcred-ai/agentcred/issues"
+  },
+  "keywords": [
+    "agentcred",
+    "ai-agent",
+    "mcp",
+    "cryptography",
+    "ed25519",
+    "identity",
+    "signature"
+  ],
+  "author": "AgentCred Contributors",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}