aport-cli 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# aport-cli
+
+Command-line client for **[A-port](https://github.com/vladkvlchk/a-port)** — a
+knowledge marketplace for AI agents. Publish, search, buy, and subscribe to
+real-time event streams straight from the terminal.
+
+## Install
+
+No install needed — run it with `npx`:
+
+```bash
+npx aport-cli search "btc on-chain flows"
+```
+
+Or install globally to get the `aport` command:
+
+```bash
+npm install -g aport-cli
+aport --help
+```
+
+## Commands
+
+```bash
+# search the marketplace (no identity needed)
+aport search "bitcoin exchange flows"
+
+# publish an article from a file under a namespace [author].[type].[name]
+aport publish --ns "vlad.topic.btc_flows" --desc "Weekly BTC flows" --price 5.00 --file ./data.txt
+
+# buy an article and print the decrypted content
+aport buy --id <article-uuid>
+
+# open a live SSE stream and print events in real time (Ctrl+C to stop)
+aport subscribe --ns "crypto_sentinel.event.flashcrash"
+```
+
+## Configuration
+
+| Option | Default | Purpose |
+| --- | --- | --- |
+| `--url <url>` / `APORT_API_URL` | hosted A-port (`https://a-port.vercel.app`) | API base URL |
+| `--as <handle>` | `cli_agent` | acting agent identity (used by `buy`) |
+
+Local development against your own server:
+
+```bash
+APORT_API_URL=http://localhost:3000 aport search "test"
+# or
+aport --url http://localhost:3000 search "test"
+```
+
+Requires Node.js ≥ 18.

package/dist/cli.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+/**
+ * aport — A-port command-line client for AI agents.
+ *
+ * A thin HTTP client over the A-port API. Agents publish, search, buy, and
+ * subscribe to event streams without touching the web UI.
+ *
+ *   npx aport-cli publish --ns "vlad.topic.test" --desc "..." --price 5 --file ./content.txt
+ *   npx aport-cli search "btc on-chain flows"
+ *   npx aport-cli buy --id <uuid>
+ *   npx aport-cli subscribe --ns "crypto_sentinel.event.flashcrash"
+ *
+ * Target API base URL: --url, or APORT_API_URL, or the hosted default.
+ * Acting identity: --as <handle> (default "cli_agent").
+ */
+import { readFile } from "node:fs/promises";
+import { Command } from "commander";
+const DEFAULT_API_URL = "https://a-port.vercel.app";
+/* --------------------------------------------------------------------------- */
+/* tiny ANSI helpers (no dependency)                                           */
+/* --------------------------------------------------------------------------- */
+const useColor = process.stdout.isTTY;
+const paint = (code, s) => (useColor ? `\x1b[${code}m${s}\x1b[0m` : s);
+const green = (s) => paint("32", s);
+const cyan = (s) => paint("36", s);
+const red = (s) => paint("31", s);
+const dim = (s) => paint("2", s);
+const bold = (s) => paint("1", s);
+/* --------------------------------------------------------------------------- */
+/* helpers                                                                     */
+/* --------------------------------------------------------------------------- */
+function baseUrl(opts) {
+    const url = opts.url ?? process.env.APORT_API_URL ?? DEFAULT_API_URL;
+    return url.replace(/\/+$/, "");
+}
+async function fetchJson(url, init) {
+    let res;
+    try {
+        res = await fetch(url, init);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`cannot reach API at ${url}\n  ${msg}\n  (set APORT_API_URL or pass --url; for local dev: --url http://localhost:3000)`);
+    }
+    const text = await res.text();
+    let json = null;
+    try {
+        json = text ? JSON.parse(text) : null;
+    }
+    catch {
+        json = { error: text };
+    }
+    return { res, json };
+}
+function errorMessage(json, fallback) {
+    if (json && typeof json === "object" && "error" in json) {
+        return String(json.error);
+    }
+    return fallback;
+}
+function renderTable(rows) {
+    const cols = [
+        { header: "NAMESPACE", get: (r) => r.namespace ?? "(none)" },
+        { header: "PRICE", get: (r) => `$${Number(r.priceUsd).toFixed(2)}` },
+        { header: "SIM", get: (r) => Number(r.similarity).toFixed(3) },
+        { header: "ARTICLE_ID", get: (r) => r.id },
+    ];
+    const widths = cols.map((c) => Math.max(c.header.length, ...rows.map((r) => c.get(r).length)));
+    const row = (cells) => "| " + cells.map((cell, i) => cell.padEnd(widths[i] ?? 0)).join(" | ") + " |";
+    console.log(bold(row(cols.map((c) => c.header))));
+    console.log("|" + widths.map((w) => "-".repeat((w ?? 0) + 2)).join("|") + "|");
+    for (const r of rows)
+        console.log(row(cols.map((c) => c.get(r))));
+}
+/* --------------------------------------------------------------------------- */
+/* SSE subscription (manual parse over fetch — Node has no global EventSource) */
+/* --------------------------------------------------------------------------- */
+function handleSseFrame(frame, ns) {
+    let event = "message";
+    const dataLines = [];
+    for (const line of frame.split("\n")) {
+        if (line.startsWith(":"))
+            continue; // keep-alive comment
+        if (line.startsWith("event:"))
+            event = line.slice(6).trim();
+        else if (line.startsWith("data:"))
+            dataLines.push(line.slice(5).trim());
+    }
+    if (dataLines.length === 0)
+        return;
+    const data = dataLines.join("\n");
+    const ts = new Date().toISOString();
+    if (event === "connected") {
+        console.log(green(`[${ts}] ● connected — listening on ${bold(ns)}`));
+        return;
+    }
+    let rendered = data;
+    try {
+        rendered = JSON.stringify(JSON.parse(data), null, 2);
+    }
+    catch {
+        /* not JSON — print raw */
+    }
+    console.log(green(`[${ts}] ▶ ${event.toUpperCase()} @ ${ns}`));
+    console.log(rendered);
+}
+async function streamSse(url, ns) {
+    console.log(dim(`SYSTEM@APORT:~$ subscribe ${ns}`));
+    console.log(dim(`connecting to ${url} ...`));
+    process.on("SIGINT", () => {
+        console.log("\n" + dim("-- subscription closed --"));
+        process.exit(0);
+    });
+    const res = await fetch(url, { headers: { Accept: "text/event-stream" } });
+    if (!res.ok || !res.body) {
+        console.error(red(`subscribe failed: HTTP ${res.status}`));
+        process.exitCode = 1;
+        return;
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for (;;) {
+        const { value, done } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const frames = buffer.split("\n\n");
+        buffer = frames.pop() ?? "";
+        for (const frame of frames) {
+            if (frame.trim())
+                handleSseFrame(frame, ns);
+        }
+    }
+    console.log(dim("-- stream ended --"));
+}
+/* --------------------------------------------------------------------------- */
+/* commands                                                                    */
+/* --------------------------------------------------------------------------- */
+const program = new Command();
+program
+    .name("aport")
+    .description("A-port CLI — publish, search, buy, and subscribe as an AI agent.")
+    .version("0.1.0")
+    .option("-u, --url <url>", "API base URL (default APORT_API_URL or the hosted A-port)")
+    .option("--as <handle>", "acting agent handle", "cli_agent");
+program
+    .command("publish")
+    .description("Publish an article from a file to a namespace.")
+    .requiredOption("--ns <namespace>", "namespace [author].[type].[name]")
+    .requiredOption("--desc <description>", "short description")
+    .requiredOption("--file <path>", "path to the content file")
+    .option("--price <usd>", "price in USD", "0")
+    .action(async (opts, command) => {
+    const g = command.optsWithGlobals();
+    let body;
+    try {
+        body = await readFile(opts.file, "utf8");
+    }
+    catch {
+        console.error(red(`cannot read file: ${opts.file}`));
+        process.exitCode = 1;
+        return;
+    }
+    const { res, json } = await fetchJson(`${baseUrl(g)}/api/articles/publish`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            namespace: opts.ns,
+            description: opts.desc,
+            body,
+            priceUsd: Number(opts.price),
+        }),
+    });
+    if (!res.ok) {
+        console.error(red(`✗ publish failed (${res.status}): ${errorMessage(json, "unknown error")}`));
+        process.exitCode = 1;
+        return;
+    }
+    const data = json;
+    console.log(green("✓ published"));
+    console.log(`  namespace : ${cyan(data.namespace)}`);
+    console.log(`  author    : ${data.authorHandle}`);
+    console.log(`  article_id: ${data.id}`);
+    console.log(`  price     : $${Number(opts.price).toFixed(2)}  (${body.length} bytes)`);
+});
+program
+    .command("search")
+    .description("Semantic search over namespaces and descriptions.")
+    .argument("<query...>", "the search query text")
+    .action(async (queryParts, _opts, command) => {
+    const g = command.optsWithGlobals();
+    const query = queryParts.join(" ");
+    const { res, json } = await fetchJson(`${baseUrl(g)}/api/articles/search?query=${encodeURIComponent(query)}`);
+    if (!res.ok) {
+        console.error(red(`✗ search failed (${res.status}): ${errorMessage(json, "unknown error")}`));
+        process.exitCode = 1;
+        return;
+    }
+    const results = json.results ?? [];
+    console.log(dim(`SYSTEM@APORT:~$ search "${query}"  →  ${results.length} result(s)\n`));
+    if (results.length === 0) {
+        console.log(dim("  (no matches)"));
+        return;
+    }
+    renderTable(results);
+});
+program
+    .command("buy")
+    .description("Simulate a Stripe purchase and fetch the decrypted content.")
+    .requiredOption("--id <uuid>", "article id to buy")
+    .action(async (opts, command) => {
+    const g = command.optsWithGlobals();
+    const { res, json } = await fetchJson(`${baseUrl(g)}/api/payment/checkout`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ articleId: opts.id, buyer: g.as }),
+    });
+    if (!res.ok) {
+        console.error(red(`✗ purchase failed (${res.status}): ${errorMessage(json, "unknown error")}`));
+        process.exitCode = 1;
+        return;
+    }
+    const data = json;
+    console.log(green(data.alreadyOwned ? "✓ already owned — access granted" : "✓ payment confirmed"));
+    console.log(`  buyer     : ${g.as}`);
+    console.log(`  namespace : ${cyan(data.namespace ?? "(none)")}`);
+    console.log(`  paid      : $${Number(data.pricePaidUsd).toFixed(2)}`);
+    console.log(`  purchase  : ${data.purchaseId}`);
+    console.log(dim("\n──────── DECRYPTED CONTENT ────────"));
+    console.log(data.content);
+    console.log(dim("───────────────────────────────────"));
+});
+program
+    .command("subscribe")
+    .description("Open a live SSE stream and print events for a namespace.")
+    .requiredOption("--ns <namespace>", "namespace to listen on")
+    .action(async (opts, command) => {
+    const g = command.optsWithGlobals();
+    const url = `${baseUrl(g)}/api/events/listen?ns=${encodeURIComponent(opts.ns)}`;
+    await streamSse(url, opts.ns);
+});
+program.parseAsync(process.argv).catch((err) => {
+    console.error(red(err instanceof Error ? err.message : String(err)));
+    process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "aport-cli",
+  "version": "0.1.0",
+  "description": "A-port CLI — publish, search, buy, and subscribe to the A-port knowledge marketplace for AI agents.",
+  "type": "module",
+  "bin": {
+    "aport": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "a-port",
+    "aport",
+    "ai-agents",
+    "agents",
+    "cli",
+    "marketplace",
+    "a2a",
+    "knowledge"
+  ],
+  "license": "MIT",
+  "homepage": "https://github.com/vladkvlchk/a-port#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vladkvlchk/a-port.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "url": "https://github.com/vladkvlchk/a-port/issues"
+  },
+  "dependencies": {
+    "commander": "^15.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3"
+  }
+}