@oxagen/cli 0.5.0 → 0.6.1

package/dist/commands/__tests__/settings.test.js

@@ -0,0 +1,83 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdtempSync, rmSync, writeFileSync, mkdirSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { settingsShow, settingsPath, settingsGet, settingsSet, settingsValidate, settingsInit, } from "../settings.js";
+import { getScopePaths } from "../../settings/index.js";
+let dir;
+let ctx;
+let out;
+let err;
+beforeEach(() => {
+    dir = mkdtempSync(join(tmpdir(), "oxagen-cmd-settings-"));
+    ctx = { cwd: dir, userSettingsPath: join(dir, "user-settings.json") };
+    out = [];
+    err = [];
+    vi.spyOn(console, "log").mockImplementation((...a) => void out.push(a.join(" ")));
+    vi.spyOn(console, "error").mockImplementation((...a) => void err.push(a.join(" ")));
+    process.exitCode = undefined;
+});
+afterEach(() => {
+    vi.restoreAllMocks();
+    rmSync(dir, { recursive: true, force: true });
+    process.exitCode = undefined;
+});
+const text = () => out.join("\n");
+describe("settings command handlers", () => {
+    it("init writes a starter file, then set + get round-trip", () => {
+        settingsInit("project", ctx);
+        expect(text()).toContain("Wrote starter settings");
+        settingsSet("model", "vendor/m", "project", ctx);
+        expect(text()).toContain("✓ model = vendor/m");
+        out = [];
+        settingsGet("model", ctx);
+        expect(text()).toBe("model: vendor/m");
+    });
+    it("init is idempotent", () => {
+        settingsInit("project", ctx);
+        out = [];
+        settingsInit("project", ctx);
+        expect(text()).toContain("already exists");
+    });
+    it("show reports the merged settings and scope sources", () => {
+        settingsSet("apiUrl", "https://api.example.com", "project", ctx);
+        out = [];
+        settingsShow(ctx);
+        expect(text()).toContain("https://api.example.com");
+        expect(text()).toContain("project");
+    });
+    it("get prints (not set) for an absent key", () => {
+        settingsGet("permissions.defaultMode", ctx);
+        expect(text()).toBe("permissions.defaultMode: (not set)");
+    });
+    it("path lists all three scopes with status", () => {
+        settingsPath(ctx);
+        expect(text()).toContain("user");
+        expect(text()).toContain("project");
+        expect(text()).toContain("local");
+    });
+    it("validate flags a malformed scope file and sets a non-zero exit code", () => {
+        const projectPath = getScopePaths(ctx).project;
+        mkdirSync(join(projectPath, ".."), { recursive: true });
+        writeFileSync(projectPath, JSON.stringify({ apiUrl: "not-a-url" }), "utf8");
+        settingsValidate(ctx);
+        expect(err.join("\n")).toContain("project");
+        expect(process.exitCode).toBe(1);
+    });
+    it("set rejects an unknown scope", () => {
+        settingsSet("model", "x", "bogus", ctx);
+        expect(err.join("\n")).toContain("Unknown scope");
+        expect(process.exitCode).toBe(1);
+    });
+    it("set surfaces an unsupported key as an error", () => {
+        settingsSet("permissions", "x", "project", ctx);
+        expect(err.join("\n")).toContain("cannot set");
+        expect(process.exitCode).toBe(1);
+    });
+    it("init rejects an unknown scope", () => {
+        settingsInit("bogus", ctx);
+        expect(err.join("\n")).toContain("Unknown scope");
+        expect(process.exitCode).toBe(1);
+    });
+});
+//# sourceMappingURL=settings.test.js.map

package/dist/commands/__tests__/settings.test.js.map

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

package/dist/commands/agent.d.ts

@@ -0,0 +1,15 @@
+/**
+ * agent command — manage named agent definitions.
+ *
+ *   oxagen agent list            List available agents (name, description, source)
+ *   oxagen agent show <name>     Show an agent's full definition + system prompt
+ *   oxagen agent new <name>      Scaffold .oxagen/agents/<name>.md
+ *
+ * Run a single turn as an agent with `oxagen --agent <name> "<prompt>"`.
+ */
+import { type LoadAgentsOptions } from "../agents/index.js";
+export type AgentCmdCtx = Pick<LoadAgentsOptions, "cwd" | "userAgentsDir" | "settingsOptions">;
+export declare function agentList(ctx?: AgentCmdCtx): void;
+export declare function agentShow(name: string, ctx?: AgentCmdCtx): void;
+export declare function agentNew(name: string, ctx?: AgentCmdCtx): void;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,eAAe,GAAG,iBAAiB,CAAC,CAAC;AAE/F,wBAAgB,SAAS,CAAC,GAAG,GAAE,WAAgB,GAAG,IAAI,CAarD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,WAAgB,GAAG,IAAI,CAcnE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,WAAgB,GAAG,IAAI,CAalE"}

package/dist/commands/agent.js

@@ -0,0 +1,58 @@
+/**
+ * agent command — manage named agent definitions.
+ *
+ *   oxagen agent list            List available agents (name, description, source)
+ *   oxagen agent show <name>     Show an agent's full definition + system prompt
+ *   oxagen agent new <name>      Scaffold .oxagen/agents/<name>.md
+ *
+ * Run a single turn as an agent with `oxagen --agent <name> "<prompt>"`.
+ */
+import { loadAgents, scaffoldAgent } from "../agents/index.js";
+export function agentList(ctx = {}) {
+    const agents = [...loadAgents(ctx).values()].sort((a, b) => a.name.localeCompare(b.name));
+    if (agents.length === 0) {
+        console.log("No agents defined. Create one with `oxagen agent new <name>`.");
+        return;
+    }
+    console.log("Agents:\n");
+    for (const a of agents) {
+        const tools = a.tools ? a.tools.join(", ") : "(all tools)";
+        console.log(`  ${a.name}`);
+        if (a.description)
+            console.log(`    ${a.description}`);
+        console.log(`    tools: ${tools}${a.model ? `  ·  model: ${a.model}` : ""}`);
+    }
+}
+export function agentShow(name, ctx = {}) {
+    const agent = loadAgents(ctx).get(name);
+    if (!agent) {
+        console.error(`Unknown agent "${name}". Run \`oxagen agent list\`.`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`# ${agent.name}`);
+    if (agent.description)
+        console.log(agent.description);
+    console.log(`\nsource: ${agent.source}`);
+    console.log(`tools:  ${agent.tools ? agent.tools.join(", ") : "(all tools)"}`);
+    if (agent.model)
+        console.log(`model:  ${agent.model}`);
+    console.log("\n--- system prompt ---\n");
+    console.log(agent.systemPrompt);
+}
+export function agentNew(name, ctx = {}) {
+    if (!/^[A-Za-z0-9][\w-]*$/.test(name)) {
+        console.error(`Invalid agent name "${name}". Use letters, digits, dashes, underscores.`);
+        process.exitCode = 1;
+        return;
+    }
+    const { path, created } = scaffoldAgent({ name, cwd: ctx.cwd });
+    if (created) {
+        console.log(`✓ Created agent ${path}`);
+        console.log(`  Edit it, then run: oxagen --agent ${name} "<prompt>"`);
+    }
+    else {
+        console.log(`${path} already exists — left untouched.`);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/agent.skill.load.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const agentSkillLoadCommand: Command;
+//# sourceMappingURL=agent.skill.load.d.ts.map

package/dist/commands/agent.skill.load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.skill.load.d.ts","sourceRoot":"","sources":["../../src/commands/agent.skill.load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,qBAAqB,SA8D/B,CAAC"}

package/dist/commands/agent.skill.load.js

@@ -0,0 +1,57 @@
+import { Command } from "commander";
+import { apiRequest, ApiError } from "../lib/api-client.js";
+import { getWorkspaceId } from "../lib/config.js";
+export const agentSkillLoadCommand = new Command("skill:load")
+    .description("Load an agent skill by slug — returns the skill body and referenced capabilities")
+    .argument("<slug>", "Skill slug to load")
+    .option("-v, --version <constraint>", "Version constraint (e.g. '3', '^2', '~2'). Omit for latest.")
+    .option("-d, --deps <slugs...>", "Additional skill slugs to pre-validate as dependencies")
+    .option("-w, --workspace <id>", "Workspace ID (defaults to current workspace)")
+    .option("--body-only", "Print only the skill body (useful for piping)")
+    .action(async (slug, options) => {
+    try {
+        const payload = { skillSlug: slug };
+        if (options.version)
+            payload.version = options.version;
+        if (options.deps)
+            payload.dependencies = options.deps;
+        const workspaceId = options.workspace ?? getWorkspaceId();
+        if (workspaceId)
+            payload.workspace_id = workspaceId;
+        const data = await apiRequest("/agent/skill/load", {
+            method: "POST",
+            body: JSON.stringify(payload),
+        });
+        if (!data.loaded) {
+            const errors = data.dependencyErrors
+                .map((e) => `  - ${e.slug}: ${e.reason}`)
+                .join("\n");
+            console.error(`Skill "${slug}" could not be loaded.`);
+            if (errors)
+                console.error(`Errors:\n${errors}`);
+            process.exit(1);
+        }
+        if (options.bodyOnly) {
+            console.log(data.body);
+            return;
+        }
+        console.log(`Skill: ${data.skillSlug} (v${data.versionLoaded})`);
+        if (data.capabilities.length > 0) {
+            console.log(`Capabilities: ${data.capabilities.join(", ")}`);
+        }
+        if (data.dependencyErrors.length > 0) {
+            console.log("Dependency warnings:");
+            data.dependencyErrors.forEach((e) => {
+                console.log(`  - ${e.slug}: ${e.reason}`);
+            });
+        }
+        console.log("\n--- Body ---\n");
+        console.log(data.body);
+    }
+    catch (err) {
+        const msg = err instanceof ApiError ? err.message : String(err);
+        console.error(`Error: ${msg}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=agent.skill.load.js.map

package/dist/commands/agent.skill.load.js.map

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

package/dist/commands/code.d.ts

@@ -0,0 +1,14 @@
+export declare function handleCodeDiff(beforeFile: string, afterFile: string, opts: {
+    path?: string;
+    context?: string;
+}): Promise<void>;
+export declare function handleCodeFormat(file: string, opts: {
+    language?: string;
+    indent?: string;
+    write?: boolean;
+}): Promise<void>;
+export declare function handleCodePatch(diffFile: string, opts: {
+    dir?: string;
+    write?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=code.d.ts.map

package/dist/commands/code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/commands/code.ts"],"names":[],"mappings":"AAmCA,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5D,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACtC,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

package/dist/commands/code.js

@@ -0,0 +1,100 @@
+/**
+ * `oxagen code …` — sandboxed code utilities (diff, patch, format) over the
+ * org-scoped /v1 API. Thin shell: each command reads/writes local files and
+ * delegates the actual computation to the code.diff / code.patch / code.format
+ * capabilities so the CLI stays in parity with the API, MCP, and agent surfaces.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { apiPost } from "../lib/api.js";
+export async function handleCodeDiff(beforeFile, afterFile, opts) {
+    const before = readFileSync(beforeFile, "utf8");
+    const after = readFileSync(afterFile, "utf8");
+    const body = { before, after };
+    if (opts.path)
+        body.path = opts.path;
+    if (opts.context !== undefined)
+        body.contextLines = parseInt(opts.context, 10);
+    const res = await apiPost("code/diff", body);
+    if (!res.changed) {
+        process.stderr.write("(no changes)\n");
+        return;
+    }
+    process.stdout.write(res.diff);
+    process.stderr.write(`\n+${res.additions} -${res.deletions}\n`);
+}
+export async function handleCodeFormat(file, opts) {
+    const source = readFileSync(file, "utf8");
+    const language = opts.language ?? inferLanguage(file);
+    if (!language) {
+        process.stderr.write(`Could not infer language for ${file}; pass --language json|python.\n`);
+        process.exit(1);
+    }
+    const body = { language, source };
+    if (opts.indent !== undefined)
+        body.indent = parseInt(opts.indent, 10);
+    const res = await apiPost("code/format", body);
+    if (opts.write) {
+        writeFileSync(file, res.formatted);
+        process.stderr.write(`✓ formatted ${file}${res.changed ? "" : " (already formatted)"}\n`);
+    }
+    else {
+        process.stdout.write(res.formatted);
+    }
+}
+export async function handleCodePatch(diffFile, opts) {
+    const diff = readFileSync(diffFile, "utf8");
+    const dir = opts.dir ?? ".";
+    const files = readWorkspaceForDiff(diff, dir);
+    const res = await apiPost("code/patch", { files, diff });
+    for (const f of res.files) {
+        process.stdout.write(`${f.status.padEnd(8)} ${f.path}\n`);
+    }
+    if (opts.write) {
+        for (const f of res.files) {
+            const abs = join(dir, f.path);
+            if (f.status === "deleted") {
+                if (existsSync(abs))
+                    rmSync(abs);
+            }
+            else {
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, f.content);
+            }
+        }
+        process.stderr.write(`✓ applied ${res.changedCount} file(s) to ${dir}\n`);
+    }
+    else {
+        process.stderr.write(`(dry run — re-run with --write to apply ${res.changedCount} change(s))\n`);
+    }
+}
+/** json from .json, python from .py; undefined when unknown. */
+function inferLanguage(file) {
+    if (file.endsWith(".json"))
+        return "json";
+    if (file.endsWith(".py"))
+        return "python";
+    return undefined;
+}
+/**
+ * Discover the existing workspace files a diff touches by scanning its ---/+++
+ * file headers, then read them from `dir`. This only ASSEMBLES the workspace to
+ * send; the authoritative apply (and path-traversal confinement) happens
+ * server-side in code.patch, so this is a best-effort input gather, not a parser.
+ */
+function readWorkspaceForDiff(diff, dir) {
+    const files = {};
+    for (const line of diff.split("\n")) {
+        const m = /^(?:---|\+\+\+) (?:[ab]\/)?(.+?)(?:\t.*)?$/.exec(line);
+        if (!m)
+            continue;
+        const p = m[1];
+        if (!p || p === "/dev/null" || files[p])
+            continue;
+        const abs = join(dir, p);
+        if (existsSync(abs))
+            files[p] = readFileSync(abs, "utf8");
+    }
+    return files;
+}
+//# sourceMappingURL=code.js.map

package/dist/commands/code.js.map

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

package/dist/commands/command.d.ts

@@ -0,0 +1,17 @@
+/**
+ * command — manage and run user-defined slash commands.
+ *
+ *   oxagen command list                List available slash commands
+ *   oxagen command show <name>         Show a command's template
+ *   oxagen command new <name>          Scaffold .oxagen/commands/<name>.md
+ *   oxagen command run <name> [args…]  Expand the template and run it as a turn
+ *
+ * In the interactive REPL, the same commands are invoked as `/name args`.
+ */
+import { type LoadCommandsOptions } from "../slash/index.js";
+export type CommandCmdCtx = Pick<LoadCommandsOptions, "cwd" | "userCommandsDir">;
+export declare function commandList(ctx?: CommandCmdCtx): void;
+export declare function commandShow(name: string, ctx?: CommandCmdCtx): void;
+export declare function commandNew(name: string, ctx?: CommandCmdCtx): void;
+export declare function commandRun(name: string, args: string[], ctx?: CommandCmdCtx): Promise<void>;
+//# sourceMappingURL=command.d.ts.map

package/dist/commands/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/commands/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAgD,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE3G,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,iBAAiB,CAAC,CAAC;AAEjF,wBAAgB,WAAW,CAAC,GAAG,GAAE,aAAkB,GAAG,IAAI,CAWzD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,aAAkB,GAAG,IAAI,CAcvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,aAAkB,GAAG,IAAI,CAatE;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,GAAE,aAAkB,GACtB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/commands/command.js

@@ -0,0 +1,74 @@
+/**
+ * command — manage and run user-defined slash commands.
+ *
+ *   oxagen command list                List available slash commands
+ *   oxagen command show <name>         Show a command's template
+ *   oxagen command new <name>          Scaffold .oxagen/commands/<name>.md
+ *   oxagen command run <name> [args…]  Expand the template and run it as a turn
+ *
+ * In the interactive REPL, the same commands are invoked as `/name args`.
+ */
+import { loadCommands, scaffoldCommand, loadAndExpand } from "../slash/index.js";
+export function commandList(ctx = {}) {
+    const commands = [...loadCommands(ctx).values()].sort((a, b) => a.name.localeCompare(b.name));
+    if (commands.length === 0) {
+        console.log("No slash commands defined. Create one with `oxagen command new <name>`.");
+        return;
+    }
+    console.log("Slash commands:\n");
+    for (const c of commands) {
+        console.log(`  /${c.name}${c.argumentHint ? ` ${c.argumentHint}` : ""}`);
+        if (c.description)
+            console.log(`    ${c.description}`);
+    }
+}
+export function commandShow(name, ctx = {}) {
+    const command = loadCommands(ctx).get(name);
+    if (!command) {
+        console.error(`Unknown command "/${name}". Run \`oxagen command list\`.`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`# /${command.name}`);
+    if (command.description)
+        console.log(command.description);
+    console.log(`\nsource: ${command.source}`);
+    if (command.argumentHint)
+        console.log(`args:   ${command.argumentHint}`);
+    if (command.model)
+        console.log(`model:  ${command.model}`);
+    console.log("\n--- template ---\n");
+    console.log(command.template);
+}
+export function commandNew(name, ctx = {}) {
+    if (!/^[A-Za-z0-9][\w-]*$/.test(name)) {
+        console.error(`Invalid command name "${name}". Use letters, digits, dashes, underscores.`);
+        process.exitCode = 1;
+        return;
+    }
+    const { path, created } = scaffoldCommand({ name, cwd: ctx.cwd });
+    if (created) {
+        console.log(`✓ Created command ${path}`);
+        console.log(`  Edit it, then run: oxagen command run ${name} <args>  (or /${name} in the REPL)`);
+    }
+    else {
+        console.log(`${path} already exists — left untouched.`);
+    }
+}
+export async function commandRun(name, args, ctx = {}) {
+    const invocation = `/${name}${args.length ? " " + args.join(" ") : ""}`;
+    const expanded = loadAndExpand(invocation, ctx);
+    if (expanded === null) {
+        console.error(`Unknown command "/${name}". Run \`oxagen command list\`.`);
+        process.exitCode = 1;
+        return;
+    }
+    if ("error" in expanded) {
+        console.error(`Error: ${expanded.error}`);
+        process.exitCode = 1;
+        return;
+    }
+    const { runOneShot } = await import("../repl/one-shot.js");
+    await runOneShot(expanded.prompt, { model: expanded.model });
+}
+//# sourceMappingURL=command.js.map

package/dist/commands/command.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,2 @@
+export declare function handleConfig(key?: string, value?: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AA+BA,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC9E"}

package/dist/commands/config.js

@@ -0,0 +1,66 @@
+/**
+ * Config command — view or set local CLI configuration.
+ *
+ * Usage:
+ *   oxagen config              Show all config
+ *   oxagen config token        Show token (masked)
+ *   oxagen config token sk-... Set token
+ *   oxagen config model        Show model
+ *   oxagen config model gpt-4  Set model
+ *   oxagen config api-url      Show API URL
+ */
+import { readConfig, writeConfig } from "../lib/config.js";
+const VALID_KEYS = ["token", "model", "api-url", "org", "workspace"];
+function keyToConfigField(key) {
+    switch (key) {
+        case "token": return "token";
+        case "api-url": return "apiUrl";
+        case "org": return "orgSlug";
+        case "workspace": return "workspaceSlug";
+        case "model": return "model";
+    }
+}
+function maskToken(token) {
+    if (token.length <= 8)
+        return "****";
+    return token.slice(0, 4) + "…" + token.slice(-4);
+}
+export async function handleConfig(key, value) {
+    const config = readConfig();
+    // No args: show all
+    if (!key) {
+        console.log("Configuration (~/.config/oxagen/config.json):\n");
+        console.log(`  token:     ${config.token ? maskToken(config.token) : "(not set)"}`);
+        console.log(`  api-url:   ${config.apiUrl ?? "https://api.oxagen.sh"}`);
+        console.log(`  org:       ${config.orgSlug ?? "(not set)"}`);
+        console.log(`  workspace: ${config.workspaceSlug ?? "(not set)"}`);
+        console.log(`\nSet a value: oxagen config <key> <value>`);
+        return;
+    }
+    if (!VALID_KEYS.includes(key)) {
+        console.error(`Unknown config key: "${key}"`);
+        console.error(`Valid keys: ${VALID_KEYS.join(", ")}`);
+        process.exitCode = 1;
+        return;
+    }
+    const field = keyToConfigField(key);
+    // Get
+    if (value === undefined) {
+        const current = config[field];
+        if (!current) {
+            console.log(`${key}: (not set)`);
+        }
+        else if (key === "token") {
+            console.log(`${key}: ${maskToken(current)}`);
+        }
+        else {
+            console.log(`${key}: ${current}`);
+        }
+        return;
+    }
+    // Set
+    writeConfig({ [field]: value });
+    const display = key === "token" ? maskToken(value) : value;
+    console.log(`✓ ${key} = ${display}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/cost.d.ts

@@ -0,0 +1,10 @@
+export interface CostOptions {
+    in?: number;
+    out?: number;
+    model?: string;
+    rates?: boolean;
+    session?: boolean;
+    json?: boolean;
+}
+export declare function handleCost(opts: CostOptions): Promise<void>;
+//# sourceMappingURL=cost.d.ts.map

package/dist/commands/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/commands/cost.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIjE"}