@opvs-ai/cli 0.1.0

package/dist/commands/tasks.js

@@ -0,0 +1,139 @@
+/**
+ * opvs tasks — task CRUD + agent convenience endpoints
+ */
+import { readFileSync } from "node:fs";
+import { loadConfig } from "../lib/config.js";
+import { createClient } from "../lib/api.js";
+import { buildUrl, printResponse, printJson } from "../lib/format.js";
+export function registerTaskCommands(program) {
+    const tasks = program.command("tasks").description("Task management");
+    tasks
+        .command("list")
+        .description("List tasks")
+        .option("--board <id>", "Board ID")
+        .option("--self", "Only tasks assigned to me")
+        .option("--status <status>", "Filter by status (pending, in_progress, review, done)")
+        .option("--priority <priority>", "Filter by priority (low, medium, high, critical)")
+        .option("--limit <n>", "Max results", "25")
+        .action(async (opts) => {
+        const cfg = loadConfig();
+        try {
+            const client = createClient();
+            if (opts.self) {
+                const params = {};
+                if (opts.status)
+                    params.status = opts.status;
+                if (opts.limit)
+                    params.limit = opts.limit;
+                const url = buildUrl("/api/v1/board/agent-api/my-tasks", params, cfg.format);
+                const res = await client.get(url);
+                await printResponse(res);
+            }
+            else if (opts.board) {
+                const params = {};
+                if (opts.status)
+                    params.status = opts.status;
+                if (opts.priority)
+                    params.priority = opts.priority;
+                if (opts.limit)
+                    params.limit = opts.limit;
+                const url = buildUrl(`/api/v1/board/boards/${opts.board}/tasks`, params, cfg.format);
+                const res = await client.get(url);
+                await printResponse(res);
+            }
+            else {
+                console.error("Specify --board <id> or --self");
+                process.exit(1);
+            }
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to list tasks"}`);
+            process.exit(1);
+        }
+    });
+    tasks
+        .command("get <id>")
+        .description("Get task details")
+        .action(async (id) => {
+        const cfg = loadConfig();
+        try {
+            const client = createClient();
+            const url = buildUrl(`/api/v1/board/tasks/${id}`, undefined, cfg.format);
+            const res = await client.get(url);
+            await printResponse(res);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to get task"}`);
+            process.exit(1);
+        }
+    });
+    tasks
+        .command("create")
+        .description("Create a new task")
+        .requiredOption("--board <id>", "Board ID")
+        .requiredOption("-t, --title <title>", "Task title")
+        .option("-d, --description <desc>", "Task description")
+        .option("--priority <priority>", "Priority (low, medium, high, critical)", "medium")
+        .option("--assign <agentId>", "Assign to agent ID")
+        .action(async (opts) => {
+        try {
+            const client = createClient();
+            const body = {
+                title: opts.title,
+                priority: opts.priority,
+            };
+            if (opts.description)
+                body.description = opts.description;
+            if (opts.assign)
+                body.assigned_to = opts.assign;
+            const res = await client.post(`/api/v1/board/boards/${opts.board}/tasks`, body);
+            const data = await res.json();
+            printJson(data);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to create task"}`);
+            process.exit(1);
+        }
+    });
+    tasks
+        .command("update <id>")
+        .description("Update a task (status, priority, result)")
+        .option("--status <status>", "New status")
+        .option("--priority <priority>", "New priority")
+        .option("--title <title>", "New title")
+        .option("--result <text>", "Result text (inline)")
+        .option("--result-file <path>", "Result text from file")
+        .action(async (id, opts) => {
+        try {
+            const client = createClient();
+            const body = {};
+            if (opts.status)
+                body.status = opts.status;
+            if (opts.priority)
+                body.priority = opts.priority;
+            if (opts.title)
+                body.title = opts.title;
+            if (opts.result)
+                body.agent_result_summary = opts.result;
+            if (opts.resultFile) {
+                body.agent_result_summary = readFileSync(opts.resultFile, "utf-8");
+            }
+            if (Object.keys(body).length === 0) {
+                console.error("Nothing to update. Provide --status, --priority, --title, --result, or --result-file");
+                process.exit(1);
+            }
+            const res = await client.patch(`/api/v1/board/tasks/${id}`, body);
+            const data = await res.json();
+            printJson(data);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to update task"}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/commands/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * @opvs/cli — Terminal access to AgentBoard + AgentDocs for AI coding agents.
+ *
+ * Usage:
+ *   opvs auth request -w <slug> -e <email>   # Get a PAT token
+ *   opvs session get --self                   # Board context
+ *   opvs tasks list --self --status pending   # My pending tasks
+ *   opvs task update <id> --status review     # Complete a task
+ *   opvs docs search "query"                  # Search docs
+ *   opvs init                                 # Print CLAUDE.md snippet
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * @opvs/cli — Terminal access to AgentBoard + AgentDocs for AI coding agents.
+ *
+ * Usage:
+ *   opvs auth request -w <slug> -e <email>   # Get a PAT token
+ *   opvs session get --self                   # Board context
+ *   opvs tasks list --self --status pending   # My pending tasks
+ *   opvs task update <id> --status review     # Complete a task
+ *   opvs docs search "query"                  # Search docs
+ *   opvs init                                 # Print CLAUDE.md snippet
+ */
+import { Command } from "commander";
+import { registerAuthCommands } from "./commands/auth.js";
+import { registerSessionCommands } from "./commands/session.js";
+import { registerBoardCommands } from "./commands/boards.js";
+import { registerTaskCommands } from "./commands/tasks.js";
+import { registerCommentCommands } from "./commands/comments.js";
+import { registerDocsCommands } from "./commands/docs.js";
+import { registerConfigCommands } from "./commands/config.js";
+const program = new Command();
+program
+    .name("opvs")
+    .description("OPVS CLI — AgentBoard + AgentDocs for AI coding agents")
+    .version("0.1.0");
+// Register all command groups
+registerAuthCommands(program);
+registerSessionCommands(program);
+registerBoardCommands(program);
+registerTaskCommands(program);
+registerCommentCommands(program);
+registerDocsCommands(program);
+registerConfigCommands(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,wDAAwD,CAAC;KACrE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,8BAA8B;AAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/lib/api.d.ts

@@ -0,0 +1,27 @@
+/**
+ * HTTP client wrapper — native fetch with token auth and error handling.
+ */
+declare class APIClient {
+    private baseUrl;
+    private token;
+    private brandId;
+    constructor();
+    private headers;
+    private request;
+    get(path: string, extraHeaders?: Record<string, string>): Promise<Response>;
+    post(path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<Response>;
+    patch(path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<Response>;
+    put(path: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<Response>;
+    delete(path: string, extraHeaders?: Record<string, string>): Promise<Response>;
+}
+/**
+ * Unauthenticated POST — used for PAT request initiation.
+ */
+export declare function apiUnauthPost(baseUrl: string, path: string, body: unknown): Promise<Response>;
+/**
+ * Unauthenticated GET with custom auth header — used for poll endpoint.
+ */
+export declare function apiUnauthGet(baseUrl: string, path: string, authHeader?: string): Promise<Response>;
+/** Create a new authenticated API client from current config. */
+export declare function createClient(): APIClient;
+export {};

package/dist/lib/api.js

@@ -0,0 +1,128 @@
+/**
+ * HTTP client wrapper — native fetch with token auth and error handling.
+ */
+import { loadConfig } from "./config.js";
+class APIClient {
+    baseUrl;
+    token;
+    brandId;
+    constructor() {
+        const config = loadConfig();
+        this.baseUrl = config.api_url.replace(/\/$/, "");
+        this.token = config.token;
+        this.brandId = config.brand_id;
+    }
+    headers(extra) {
+        const h = {
+            "Content-Type": "application/json",
+            ...extra,
+        };
+        if (this.token) {
+            h["Authorization"] = `Bearer ${this.token}`;
+        }
+        if (this.brandId) {
+            h["X-Brand-ID"] = String(this.brandId);
+        }
+        return h;
+    }
+    async request(method, path, body, extraHeaders) {
+        if (!this.token) {
+            throw { detail: "Not authenticated. Run `opvs auth request` to get a token.", status: 401 };
+        }
+        const url = `${this.baseUrl}${path}`;
+        const res = await fetch(url, {
+            method,
+            headers: this.headers(extraHeaders),
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!res.ok) {
+            let detail;
+            try {
+                const err = (await res.json());
+                if (typeof err.detail === "string") {
+                    detail = err.detail;
+                }
+                else if (Array.isArray(err.detail)) {
+                    detail = err.detail.map((d) => d.msg || JSON.stringify(d)).join("; ");
+                }
+                else {
+                    detail = res.statusText;
+                }
+            }
+            catch {
+                detail = res.statusText;
+            }
+            const error = { detail, status: res.status };
+            throw error;
+        }
+        return res;
+    }
+    async get(path, extraHeaders) {
+        return this.request("GET", path, undefined, extraHeaders);
+    }
+    async post(path, body, extraHeaders) {
+        return this.request("POST", path, body, extraHeaders);
+    }
+    async patch(path, body, extraHeaders) {
+        return this.request("PATCH", path, body, extraHeaders);
+    }
+    async put(path, body, extraHeaders) {
+        return this.request("PUT", path, body, extraHeaders);
+    }
+    async delete(path, extraHeaders) {
+        return this.request("DELETE", path, undefined, extraHeaders);
+    }
+}
+/**
+ * Unauthenticated POST — used for PAT request initiation.
+ */
+export async function apiUnauthPost(baseUrl, path, body) {
+    const url = `${baseUrl.replace(/\/$/, "")}${path}`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        let detail;
+        try {
+            const err = (await res.json());
+            detail = err.detail || res.statusText;
+        }
+        catch {
+            detail = res.statusText;
+        }
+        const error = { detail, status: res.status };
+        throw error;
+    }
+    return res;
+}
+/**
+ * Unauthenticated GET with custom auth header — used for poll endpoint.
+ */
+export async function apiUnauthGet(baseUrl, path, authHeader) {
+    const url = `${baseUrl.replace(/\/$/, "")}${path}`;
+    const headers = {};
+    if (authHeader) {
+        headers["Authorization"] = `Bearer ${authHeader}`;
+    }
+    const res = await fetch(url, { method: "GET", headers });
+    if (!res.ok) {
+        let detail;
+        try {
+            const err = (await res.json());
+            detail = err.detail || res.statusText;
+        }
+        catch {
+            detail = res.statusText;
+        }
+        const error = { detail, status: res.status };
+        throw error;
+    }
+    return res;
+}
+/** Create a new authenticated API client from current config. */
+export function createClient() {
+    return new APIClient();
+}
+//# sourceMappingURL=api.js.map

package/dist/lib/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"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"}

package/dist/lib/auth-poll.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Polling loop for PAT approval — waits for human to click approve/deny.
+ */
+export interface PollResult {
+    status: "active" | "denied" | "expired" | "timeout";
+    token?: string;
+    scopes?: string[];
+    brand_id?: number;
+    brand_name?: string;
+}
+/**
+ * Poll the PAT request status endpoint until resolved or timed out.
+ * Prints dots to stderr to show progress.
+ */
+export declare function pollForApproval(baseUrl: string, requestId: string, pollToken: string, timeoutMs?: number): Promise<PollResult>;

package/dist/lib/auth-poll.js

@@ -0,0 +1,46 @@
+/**
+ * Polling loop for PAT approval — waits for human to click approve/deny.
+ */
+import { apiUnauthGet } from "./api.js";
+const POLL_INTERVAL_MS = 3000;
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Poll the PAT request status endpoint until resolved or timed out.
+ * Prints dots to stderr to show progress.
+ */
+export async function pollForApproval(baseUrl, requestId, pollToken, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const deadline = Date.now() + timeoutMs;
+    process.stderr.write("Waiting for approval ");
+    while (Date.now() < deadline) {
+        try {
+            const res = await apiUnauthGet(baseUrl, `/api/v1/auth/pat/request/${requestId}/status`, pollToken);
+            const data = (await res.json());
+            if (data.status === "active" && data.token) {
+                process.stderr.write(" approved!\n");
+                return {
+                    status: "active",
+                    token: data.token,
+                    scopes: data.scopes,
+                    brand_id: data.brand_id,
+                    brand_name: data.brand_name,
+                };
+            }
+            if (data.status === "denied") {
+                process.stderr.write(" denied.\n");
+                return { status: "denied" };
+            }
+            if (data.status === "expired") {
+                process.stderr.write(" expired.\n");
+                return { status: "expired" };
+            }
+        }
+        catch {
+            // Network error or server error — keep polling
+        }
+        process.stderr.write(".");
+        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+    }
+    process.stderr.write(" timed out.\n");
+    return { status: "timeout" };
+}
+//# sourceMappingURL=auth-poll.js.map

package/dist/lib/auth-poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-poll.js","sourceRoot":"","sources":["../../src/lib/auth-poll.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAUtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAe,EACf,SAAiB,EACjB,SAAiB,EACjB,SAAS,GAAG,kBAAkB;IAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAE9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAC5B,OAAO,EACP,4BAA4B,SAAS,SAAS,EAC9C,SAAS,CACV,CAAC;YACF,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAsB,CAAC;YAErD,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;gBACrC,OAAO;oBACL,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;iBAC5B,CAAC;YACJ,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBACnC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC9B,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBACpC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/lib/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Config file management: ~/.opvs/config.json
+ */
+import { CLIConfig } from "../types.js";
+export declare function getConfigPath(): string;
+export declare function loadConfig(): CLIConfig;
+export declare function saveConfig(config: Partial<CLIConfig>): void;
+export declare function resetConfig(): void;

package/dist/lib/config.js

@@ -0,0 +1,39 @@
+/**
+ * Config file management: ~/.opvs/config.json
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { DEFAULT_CONFIG } from "../types.js";
+const CONFIG_DIR = join(homedir(), ".opvs");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+export function getConfigPath() {
+    return CONFIG_FILE;
+}
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    try {
+        const raw = readFileSync(CONFIG_FILE, "utf-8");
+        return { ...DEFAULT_CONFIG, ...JSON.parse(raw) };
+    }
+    catch {
+        return { ...DEFAULT_CONFIG };
+    }
+}
+export function saveConfig(config) {
+    const current = loadConfig();
+    const merged = { ...current, ...config };
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2) + "\n");
+}
+export function resetConfig() {
+    if (!existsSync(CONFIG_DIR)) {
+        mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    writeFileSync(CONFIG_FILE, JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n");
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAa,cAAc,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAA0B;IACnD,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7E,CAAC"}

package/dist/lib/fingerprint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agent type detection + system fingerprint for PAT requests.
+ */
+import type { AgentFingerprint } from "../types.js";
+/** Detect the AI agent type from environment variables. */
+export declare function detectAgentType(): string;
+/** Build a full agent fingerprint object. */
+export declare function buildFingerprint(): AgentFingerprint;

package/dist/lib/fingerprint.js

@@ -0,0 +1,32 @@
+/**
+ * Agent type detection + system fingerprint for PAT requests.
+ */
+import { hostname, platform } from "node:os";
+/** Detect the AI agent type from environment variables. */
+export function detectAgentType() {
+    if (process.env.CLAUDE_CODE)
+        return "Claude Code";
+    if (process.env.CURSOR_SESSION || process.env.CURSOR_TRACE_ID)
+        return "Cursor";
+    if (process.env.WINDSURF_SESSION)
+        return "Windsurf";
+    if (process.env.CODEX_SESSION)
+        return "Codex";
+    if (process.env.TERM_PROGRAM === "vscode")
+        return "VS Code Terminal";
+    if (process.env.TERM_PROGRAM === "iTerm.app")
+        return "iTerm";
+    return "CLI";
+}
+/** Build a full agent fingerprint object. */
+export function buildFingerprint() {
+    return {
+        agent_type: detectAgentType(),
+        hostname: hostname(),
+        cwd: process.cwd(),
+        platform: `${platform()} ${process.arch}`,
+        node_version: process.version,
+        cli_version: "0.1.0",
+    };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/lib/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/lib/fingerprint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG7C,2DAA2D;AAC3D,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW;QAAE,OAAO,aAAa,CAAC;IAClD,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO,QAAQ,CAAC;IAC/E,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB;QAAE,OAAO,UAAU,CAAC;IACpD,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,QAAQ;QAAE,OAAO,kBAAkB,CAAC;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,OAAO,CAAC;IAC7D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,UAAU,EAAE,eAAe,EAAE;QAC7B,QAAQ,EAAE,QAAQ,EAAE;QACpB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,QAAQ,EAAE,GAAG,QAAQ,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE;QACzC,YAAY,EAAE,OAAO,CAAC,OAAO;QAC7B,WAAW,EAAE,OAAO;KACrB,CAAC;AACJ,CAAC"}

package/dist/lib/format.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Output formatters.
+ *
+ * View endpoints return pre-formatted YAML/MD text — we pass that through.
+ * For JSON API responses, we format as indented JSON or a basic table.
+ */
+/** Print raw text (YAML/MD passthrough from view endpoints). */
+export declare function printRaw(text: string): void;
+/** Print a JSON response with indentation. */
+export declare function printJson(data: unknown): void;
+/** Determine the ?format= query param to append based on user preference. */
+export declare function formatParam(format: string): string;
+/** Build a URL with optional query params, merging format. */
+export declare function buildUrl(base: string, params?: Record<string, string | number | boolean | undefined>, format?: string): string;
+/**
+ * Handle a response that might be YAML/MD text or JSON.
+ * View endpoints return text/plain or text/yaml; others return JSON.
+ */
+export declare function printResponse(res: Response, preferJson?: boolean): Promise<void>;

package/dist/lib/format.js

@@ -0,0 +1,55 @@
+/**
+ * Output formatters.
+ *
+ * View endpoints return pre-formatted YAML/MD text — we pass that through.
+ * For JSON API responses, we format as indented JSON or a basic table.
+ */
+/** Print raw text (YAML/MD passthrough from view endpoints). */
+export function printRaw(text) {
+    process.stdout.write(text);
+    if (!text.endsWith("\n"))
+        process.stdout.write("\n");
+}
+/** Print a JSON response with indentation. */
+export function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+/** Determine the ?format= query param to append based on user preference. */
+export function formatParam(format) {
+    if (format === "json")
+        return "";
+    return `format=${format}`;
+}
+/** Build a URL with optional query params, merging format. */
+export function buildUrl(base, params, format) {
+    const parts = [];
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== "") {
+                parts.push(`${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+            }
+        }
+    }
+    if (format && format !== "json") {
+        parts.push(`format=${format}`);
+    }
+    if (parts.length === 0)
+        return base;
+    return `${base}?${parts.join("&")}`;
+}
+/**
+ * Handle a response that might be YAML/MD text or JSON.
+ * View endpoints return text/plain or text/yaml; others return JSON.
+ */
+export async function printResponse(res, preferJson = false) {
+    const ct = res.headers.get("content-type") || "";
+    if (preferJson || ct.includes("application/json")) {
+        const data = await res.json();
+        printJson(data);
+    }
+    else {
+        const text = await res.text();
+        printRaw(text);
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gEAAgE;AAChE,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,UAAU,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,MAA8D,EAC9D,MAAe;IAEf,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBAChC,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,GAAG,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAa,EAAE,UAAU,GAAG,KAAK;IACnE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,UAAU,IAAI,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+/** Shared TypeScript interfaces for @opvs/cli */
+export interface CLIConfig {
+    api_url: string;
+    token: string;
+    brand_id: number | null;
+    brand_name: string;
+    format: "yaml" | "json" | "md";
+}
+export declare const DEFAULT_CONFIG: CLIConfig;
+export interface PATRequestResponse {
+    request_id: string;
+    status: string;
+    poll_token: string;
+    expires_at: string;
+}
+export interface PATStatusResponse {
+    status: "pending" | "active" | "denied" | "expired";
+    token?: string;
+    scopes?: string[];
+    token_expires_at?: string;
+    brand_id?: number;
+    brand_name?: string;
+}
+export interface AgentFingerprint {
+    agent_type: string;
+    hostname: string;
+    cwd: string;
+    platform: string;
+    node_version: string;
+    cli_version: string;
+}
+export interface APIError {
+    detail: string;
+    status: number;
+}