@synap-core/cli 1.7.0 → 1.10.0

package/dist/commands/providers.js

@@ -0,0 +1,170 @@
+/**
+ * synap providers
+ *
+ * Discover and configure AI providers from the connected pod.
+ *
+ * synap providers list              — show available providers on the pod
+ * synap providers pull [--target]   — write provider config to a local tool
+ */
+import chalk from "chalk";
+import ora from "ora";
+import prompts from "prompts";
+import { log } from "../utils/logger.js";
+import { getActivePodConfig } from "../lib/pod.js";
+/**
+ * Fetch enabled providers (model IDs only, no keys) from the pod.
+ * Used for display / listing.
+ */
+export async function fetchPodProviders(podUrl, apiKey) {
+    let res;
+    try {
+        res = await fetch(`${podUrl.replace(/\/$/, "")}/api/hub/providers/models`, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+            signal: AbortSignal.timeout(8000),
+        });
+    }
+    catch (err) {
+        throw new Error(`Could not reach pod at ${podUrl}: ${err.message}`);
+    }
+    if (res.status === 401 || res.status === 403) {
+        throw new Error(`Credentials rejected by pod (HTTP ${res.status}) — check your API key.`);
+    }
+    if (!res.ok) {
+        throw new Error(`Pod returned HTTP ${res.status} for /api/hub/providers/models.`);
+    }
+    const data = (await res.json());
+    return data.providers ?? [];
+}
+/**
+ * Fetch enabled providers WITH decrypted API keys from the pod vault.
+ * The pod resolves: user-level override > workspace > pod-wide key.
+ * Used by local tool installers (opencode, aider, etc.) that need real keys.
+ */
+export async function fetchPodCredentials(podUrl, apiKey, workspaceId) {
+    const base = podUrl.replace(/\/$/, "");
+    const url = workspaceId
+        ? `${base}/api/hub/providers/credentials?workspaceId=${encodeURIComponent(workspaceId)}`
+        : `${base}/api/hub/providers/credentials`;
+    let res;
+    try {
+        res = await fetch(url, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+            signal: AbortSignal.timeout(8000),
+        });
+    }
+    catch (err) {
+        throw new Error(`Could not reach pod at ${podUrl}: ${err.message}`);
+    }
+    if (res.status === 401 || res.status === 403) {
+        throw new Error(`Credentials rejected by pod (HTTP ${res.status}) — check your API key.`);
+    }
+    if (!res.ok) {
+        throw new Error(`Pod returned HTTP ${res.status} for /api/hub/providers/credentials.`);
+    }
+    const data = (await res.json());
+    return data.providers ?? [];
+}
+// ─── Commands ────────────────────────────────────────────────────────────────
+export async function providersList(opts) {
+    let podUrl = opts.podUrl;
+    let apiKey = opts.apiKey;
+    if (!podUrl || !apiKey) {
+        const cfg = getActivePodConfig();
+        podUrl = podUrl ?? cfg?.podUrl;
+        apiKey = apiKey ?? cfg?.hubApiKey;
+    }
+    if (!podUrl || !apiKey) {
+        log.error("Not connected to a pod. Run: synap init");
+        process.exit(1);
+    }
+    const spinner = ora("Fetching providers from pod...").start();
+    let providers;
+    try {
+        providers = await fetchPodProviders(podUrl, apiKey);
+        spinner.succeed(`Fetched ${providers.length} provider(s).`);
+    }
+    catch (err) {
+        spinner.fail(err.message);
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(providers, null, 2));
+        return;
+    }
+    if (providers.length === 0) {
+        log.warn("No enabled providers found on this pod.");
+        log.dim(`Add providers at: ${podUrl}/admin/intelligence → Providers`);
+        log.dim("Then re-run: synap providers list");
+        return;
+    }
+    log.heading(`AI Providers (${providers.length})`);
+    for (const p of providers) {
+        const modelCount = p.models.length;
+        const badge = p.enabled ? chalk.green("●") : chalk.red("○");
+        console.log(`  ${badge} ${chalk.bold(p.name.padEnd(20))} ${chalk.dim(p.providerId)}`);
+        if (modelCount > 0) {
+            const ids = p.models.slice(0, 3).map((m) => m.id);
+            const extra = modelCount > 3 ? chalk.dim(` +${modelCount - 3} more`) : "";
+            console.log(`       ${chalk.dim("models:")} ${ids.join(", ")}${extra}`);
+        }
+    }
+    console.log();
+    log.dim(`IS endpoint: ${podUrl}/v1  (OpenAI-compatible — use with any OpenAI-SDK client)`);
+}
+export async function providersPull(opts) {
+    let podUrl = opts.podUrl;
+    let apiKey = opts.apiKey;
+    if (!podUrl || !apiKey) {
+        const cfg = getActivePodConfig();
+        podUrl = podUrl ?? cfg?.podUrl;
+        apiKey = apiKey ?? cfg?.hubApiKey;
+    }
+    if (!podUrl || !apiKey) {
+        log.error("Not connected to a pod. Run: synap init");
+        process.exit(1);
+    }
+    const VALID_TARGETS = ["opencode", "aider", "show"];
+    let target = opts.target;
+    if (target && !VALID_TARGETS.includes(target)) {
+        log.error(`Unknown target: ${chalk.bold(target)}`);
+        log.dim(`Valid targets: ${VALID_TARGETS.join(", ")}`);
+        process.exit(1);
+    }
+    if (!target) {
+        const { picked } = await prompts({
+            type: "select",
+            name: "picked",
+            message: "Configure provider for which tool?",
+            choices: [
+                { title: "opencode", description: "Write ~/.config/opencode/opencode.json", value: "opencode" },
+                { title: "aider", description: "Write ~/.aider.conf.yml", value: "aider" },
+                { title: "Show IS endpoint  (manual setup)", description: "Print base URL + key for any OpenAI-compatible client", value: "show" },
+            ],
+        });
+        target = picked;
+        if (!target)
+            return; // user cancelled (Ctrl-C)
+    }
+    let ok = true;
+    if (target === "opencode") {
+        const { installOpencode } = await import("../lib/targets.js");
+        ok = await installOpencode({ podUrl, apiKey });
+    }
+    else if (target === "aider") {
+        const { installAider } = await import("../lib/targets.js");
+        ok = await installAider({ podUrl, apiKey });
+    }
+    else {
+        // "show" — print the IS endpoint for manual configuration
+        log.heading("Intelligence Service endpoint");
+        log.info(`Base URL: ${chalk.cyan(podUrl + "/v1")}`);
+        log.info(`API Key:  ${chalk.dim(apiKey)}`);
+        log.blank();
+        log.dim("This is an OpenAI-compatible endpoint. Use it as your AI provider base URL.");
+        log.dim("The API key is your Hub Protocol key — it authenticates and scopes requests.");
+    }
+    if (!ok) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=providers.js.map

package/dist/commands/providers.js.map

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

package/dist/commands/purge.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `synap workspace purge <id|name>` / `synap project purge <id|name>` —
+ * HARD teardown for the pod owner. Irreversible.
+ *
+ * Calls the backend purge endpoints (owner-only):
+ *   workspace: POST /api/hub/workspaces/:id/purge  body { confirm: "<exact name>" }
+ *              → { purged, workspaceId, entitiesDeleted, blobsDeleted }
+ *   project:   POST /api/hub/projects/:id/purge     body { confirm: "<exact name>" }
+ *              → { purged, projectId, podWideEntitiesDeleted, relationsDeleted }
+ *
+ * SAFETY: resolves the target's exact name, then requires the operator to TYPE
+ * that name (interactive) — or pass it via --confirm <name> / --yes — before any
+ * server call is made. A local name mismatch aborts before the network.
+ */
+export interface PurgeOpts {
+    confirm?: string;
+    yes?: boolean;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function workspacePurge(target: string, opts: PurgeOpts): Promise<void>;
+export declare function projectPurge(target: string, opts: PurgeOpts): Promise<void>;

package/dist/commands/purge.js

@@ -0,0 +1,148 @@
+/**
+ * `synap workspace purge <id|name>` / `synap project purge <id|name>` —
+ * HARD teardown for the pod owner. Irreversible.
+ *
+ * Calls the backend purge endpoints (owner-only):
+ *   workspace: POST /api/hub/workspaces/:id/purge  body { confirm: "<exact name>" }
+ *              → { purged, workspaceId, entitiesDeleted, blobsDeleted }
+ *   project:   POST /api/hub/projects/:id/purge     body { confirm: "<exact name>" }
+ *              → { purged, projectId, podWideEntitiesDeleted, relationsDeleted }
+ *
+ * SAFETY: resolves the target's exact name, then requires the operator to TYPE
+ * that name (interactive) — or pass it via --confirm <name> / --yes — before any
+ * server call is made. A local name mismatch aborts before the network.
+ */
+import chalk from "chalk";
+import * as readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet, hubPost } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Resolve a workspace <id|name> to its { id, name }. Throws if unknown. */
+async function resolveWorkspace(value, cfg) {
+    // GET /workspaces returns a { workspaces: [...] } envelope.
+    const res = (await hubGet("/workspaces", {}, cfg));
+    const list = unwrapList(res, ["workspaces"]);
+    const match = UUID_RE.test(value)
+        ? list.find((w) => String(w.id) === value)
+        : list.find((w) => String(w.name ?? "").toLowerCase() === value.toLowerCase());
+    if (!match) {
+        const names = list.map((w) => String(w.name ?? w.id)).join(", ");
+        throw new Error(`Workspace '${value}' not found.${names ? ` Available: ${names}` : ""}`);
+    }
+    return { id: String(match.id), name: String(match.name ?? match.id) };
+}
+/** Resolve a project <id|name> to its { id, name }. Throws if unknown. */
+async function resolveProject(value, cfg) {
+    // GET /projects returns a RAW array (no envelope).
+    const res = (await hubGet("/projects", {}, cfg));
+    const list = unwrapList(res, ["projects"]);
+    const match = UUID_RE.test(value)
+        ? list.find((p) => String(p.id) === value)
+        : list.find((p) => String(p.name ?? "").toLowerCase() === value.toLowerCase());
+    if (!match) {
+        const names = list.map((p) => String(p.name ?? p.id)).join(", ");
+        throw new Error(`Project '${value}' not found.${names ? ` Available: ${names}` : ""}`);
+    }
+    return { id: String(match.id), name: String(match.name ?? match.id) };
+}
+/**
+ * Obtain the confirmation string and check it matches `name` locally — BEFORE
+ * any destructive server call. Returns the validated confirm value, or null if
+ * the operator aborted / mismatched.
+ */
+async function getConfirmation(name, opts) {
+    // Non-interactive: --confirm <name> (must match) or --yes (use resolved name).
+    if (opts.confirm !== undefined) {
+        if (opts.confirm !== name) {
+            log.error(`--confirm '${opts.confirm}' does not match the exact name '${name}'. Aborting.`);
+            return null;
+        }
+        return opts.confirm;
+    }
+    if (opts.yes)
+        return name;
+    // Interactive: operator must TYPE the exact name.
+    const rl = readline.createInterface({ input, output });
+    try {
+        const answer = await rl.question(chalk.bold(`  Type the exact name to confirm purge (${chalk.red(name)}): `));
+        if (answer.trim() !== name) {
+            log.error("Name does not match. Aborting — nothing was purged.");
+            return null;
+        }
+        return answer.trim();
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Surface a thrown hub error: 4xx body + a friendly hint for known statuses. */
+function reportError(e) {
+    const msg = e.message ?? String(e);
+    log.error(msg);
+    if (/HTTP 403/.test(msg)) {
+        log.dim("403 — owner-only operation, or this is a protected/system workspace.");
+    }
+    else if (/HTTP 404/.test(msg)) {
+        log.dim("404 — target no longer exists.");
+    }
+    else if (/HTTP 400/.test(msg)) {
+        log.dim("400 — confirmation name mismatch or malformed request.");
+    }
+}
+export async function workspacePurge(target, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const ws = await resolveWorkspace(target, cfg);
+        if (!opts.json) {
+            log.heading(`Purge workspace — ${ws.name}`);
+            log.warn("This is a HARD, IRREVERSIBLE teardown.");
+            log.dim(`Deletes the workspace ${chalk.dim(ws.id.slice(0, 8))}, all its entities, and their blobs.`);
+        }
+        const confirm = await getConfirmation(ws.name, opts);
+        if (confirm === null)
+            process.exit(1);
+        const res = (await hubPost(`/workspaces/${ws.id}/purge`, { confirm }, cfg, 120_000));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        log.success(`Purged workspace '${ws.name}'.`);
+        log.dim(`Entities deleted: ${chalk.bold(String(res.entitiesDeleted ?? 0))}`);
+        log.dim(`Blobs deleted:    ${chalk.bold(String(res.blobsDeleted ?? 0))}`);
+    }
+    catch (e) {
+        reportError(e);
+        process.exit(1);
+    }
+}
+export async function projectPurge(target, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const proj = await resolveProject(target, cfg);
+        if (!opts.json) {
+            log.heading(`Purge project — ${proj.name}`);
+            log.warn("This is a HARD, IRREVERSIBLE teardown.");
+            log.dim(`Deletes the project ${chalk.dim(proj.id.slice(0, 8))}, its pod-wide-exclusive entities, and belongs_to_project links.`);
+            log.dim("Note: workspace-scoped entities are NOT removed here — use `synap workspace purge` for those.");
+        }
+        const confirm = await getConfirmation(proj.name, opts);
+        if (confirm === null)
+            process.exit(1);
+        const res = (await hubPost(`/projects/${proj.id}/purge`, { confirm }, cfg, 120_000));
+        if (opts.json) {
+            console.log(JSON.stringify(res, null, 2));
+            return;
+        }
+        log.success(`Purged project '${proj.name}'.`);
+        log.dim(`Pod-wide entities deleted: ${chalk.bold(String(res.podWideEntitiesDeleted ?? 0))}`);
+        log.dim(`Relations deleted:         ${chalk.bold(String(res.relationsDeleted ?? 0))}`);
+        log.dim("Reminder: workspace-scoped entities are removed by `synap workspace purge`.");
+    }
+    catch (e) {
+        reportError(e);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=purge.js.map

package/dist/commands/purge.js.map

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

package/dist/commands/raycast.d.ts

@@ -0,0 +1,15 @@
+/**
+ * synap raycast generate — Emit Raycast Script Commands for enabled capabilities
+ *
+ * For each ENABLED runnable verb on the pod, writes a Raycast Script Command shell
+ * script that calls back into `synap capability run <verbId>`. Per-parameter
+ * Raycast arguments are derived from the verb's argsSchema (or the backing skill's
+ * `parameters`); if no schema is reachable, a single freeform `input` arg is used.
+ *
+ * Subcommand: generate
+ */
+export interface RaycastGenerateOpts {
+    out?: string;
+    workspace?: string;
+}
+export declare function raycastGenerate(opts: RaycastGenerateOpts): Promise<void>;

package/dist/commands/raycast.js

@@ -0,0 +1,153 @@
+/**
+ * synap raycast generate — Emit Raycast Script Commands for enabled capabilities
+ *
+ * For each ENABLED runnable verb on the pod, writes a Raycast Script Command shell
+ * script that calls back into `synap capability run <verbId>`. Per-parameter
+ * Raycast arguments are derived from the verb's argsSchema (or the backing skill's
+ * `parameters`); if no schema is reachable, a single freeform `input` arg is used.
+ *
+ * Subcommand: generate
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { resolveHubConfig, hubGet } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+import { log } from "../utils/logger.js";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function isEnabled(cap) {
+    return cap.approved === true || cap.governance === "auto";
+}
+/** Extract parameter NAMES from a skill `parameters` / verb `argsSchema` blob. */
+function extractParamNames(schema) {
+    if (!schema || typeof schema !== "object" || Array.isArray(schema))
+        return [];
+    const obj = schema;
+    // JSON-schema style: { type:"object", properties:{ to:{...}, subject:{...} } }
+    if (obj.properties && typeof obj.properties === "object" && !Array.isArray(obj.properties)) {
+        return Object.keys(obj.properties);
+    }
+    // Flat key→type map: { to:"string", subject:"string", body:"string" }
+    return Object.keys(obj);
+}
+/** Filename-safe slug for a script name. */
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "verb";
+}
+/** Render one Raycast Script Command. Returns the script body + a fallback flag. */
+function renderScript(verb) {
+    const usedFallback = verb.params.length === 0;
+    const params = usedFallback ? ["input"] : verb.params;
+    const argLines = params.map((p, i) => `# @raycast.argument${i + 1} { "type": "text", "placeholder": "${p}" }`);
+    const flags = params.map((p, i) => `--${p} "$${i + 1}"`).join(" ");
+    const content = [
+        `#!/bin/bash`,
+        `# @raycast.schemaVersion 1`,
+        `# @raycast.title ${verb.toolName} — ${verb.label}`,
+        `# @raycast.mode fullOutput`,
+        `# @raycast.packageName Synap`,
+        `# @raycast.icon 🧠`,
+        ...argLines,
+        ``,
+        `exec synap capability run ${verb.verbId} ${flags}`,
+        ``,
+    ].join("\n");
+    return { content, usedFallback };
+}
+export async function raycastGenerate(opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    if (!workspaceId) {
+        log.error("A workspace is required. Set one with `synap use <workspace>` or pass --workspace <id>.");
+        process.exit(1);
+    }
+    const outDir = opts.out ?? join(homedir(), ".synap", "raycast-commands");
+    const spinner = ora({ text: "Fetching capabilities…", color: "cyan" }).start();
+    // The capability read-model already carries each verb's `argsSchema` and each
+    // skill cap's `inputSchema`, so /capabilities is the required source. /skills is
+    // a best-effort fallback (verb.id → skill.parameters) — it can be slow, so a
+    // failure there degrades gracefully rather than aborting generation.
+    let caps;
+    let skills = [];
+    try {
+        const capRes = await hubGet("/capabilities", { workspaceId }, cfg);
+        caps = unwrapList(capRes, ["capabilities"]);
+        spinner.stop();
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Failed to fetch capabilities"));
+        log.error(err.message);
+        process.exit(1);
+    }
+    try {
+        const skillRes = await hubGet("/skills", { workspaceId }, cfg);
+        skills = unwrapList(skillRes, ["skills"]);
+    }
+    catch {
+        // Best-effort enrichment only — proceed with the capability read-model's schemas.
+    }
+    const skillParamsByName = new Map(skills.map((s) => [s.name, extractParamNames(s.parameters)]));
+    // Flatten enabled, runnable verbs. Tool verbs carry an explicit `granted`
+    // state; a skill-kind capability is itself the runnable unit when enabled.
+    const runnables = [];
+    for (const cap of caps) {
+        if (cap.verbs && cap.verbs.length > 0) {
+            for (const v of cap.verbs) {
+                if (v.granted !== true)
+                    continue;
+                const fromArgs = extractParamNames(v.argsSchema);
+                const params = fromArgs.length > 0 ? fromArgs : skillParamsByName.get(v.id) ?? [];
+                runnables.push({ toolName: cap.name, verbId: v.id, label: v.label, params });
+            }
+        }
+        else if (cap.kind === "skill" && isEnabled(cap)) {
+            const fromSchema = extractParamNames(cap.inputSchema);
+            const params = fromSchema.length > 0 ? fromSchema : skillParamsByName.get(cap.name) ?? [];
+            runnables.push({ toolName: cap.name, verbId: cap.name, label: cap.name, params });
+        }
+    }
+    if (runnables.length === 0) {
+        log.warn("No enabled runnable verbs found in this workspace.");
+        log.dim("Enable one first:  synap capability enable <verb>");
+        return;
+    }
+    try {
+        mkdirSync(outDir, { recursive: true });
+    }
+    catch (err) {
+        log.error(`Could not create output dir ${outDir}: ${err.message}`);
+        process.exit(1);
+    }
+    let fallbackCount = 0;
+    for (const verb of runnables) {
+        const { content, usedFallback } = renderScript(verb);
+        if (usedFallback)
+            fallbackCount++;
+        const file = join(outDir, `${slugify(verb.verbId)}.sh`);
+        writeFileSync(file, content, "utf-8");
+        chmodSync(file, 0o755);
+    }
+    log.heading(`Generated ${runnables.length} Raycast Script Command${runnables.length === 1 ? "" : "s"}`);
+    console.log();
+    log.dim(outDir);
+    console.log();
+    log.info("Add this directory in Raycast → Extensions → Script Commands → Add Directory");
+    if (fallbackCount > 0) {
+        console.log();
+        log.warn(`${fallbackCount} verb${fallbackCount === 1 ? "" : "s"} had no parameter schema — ` +
+            `generated with a single freeform "input" argument.`);
+    }
+}
+//# sourceMappingURL=raycast.js.map

package/dist/commands/raycast.js.map

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

package/dist/commands/sessions.d.ts

@@ -0,0 +1,31 @@
+import { type BaseOpts } from "./data.js";
+export declare function startSession(opts: BaseOpts & {
+    goal: string;
+    workspace?: string;
+    taskId?: string;
+}): Promise<void>;
+export declare function listSessions(opts: BaseOpts & {
+    workspace?: string;
+    status?: string;
+    limit?: string;
+}): Promise<void>;
+export declare function getSession(id: string, opts: BaseOpts & {
+    workspace?: string;
+}): Promise<void>;
+export declare function updateSession(id: string, opts: BaseOpts & {
+    workspace?: string;
+    progress?: string;
+    status?: string;
+    goal?: string;
+}): Promise<void>;
+export declare function attachSession(id: string, opts: BaseOpts): Promise<void>;
+export declare function detachSession(opts: {
+    json?: boolean;
+}): void;
+export declare function sessionStatus(opts: {
+    json?: boolean;
+}): void;
+export declare function closeSession(id: string, opts: BaseOpts & {
+    workspace?: string;
+    recap?: string;
+}): Promise<void>;