@imbrace/cli 0.3.0 → 0.4.1

package/dist/commands/workflow/runs.js

@@ -1,6 +1,6 @@
 import { Flags } from "@oclif/core";
 import { BaseCommand } from "../../base-command.js";
-import { apiRequest } from "../../http.js";
+import { getClient } from "../../lib/client.js";
 export default class WorkflowRuns extends BaseCommand {
     static description = "List recent workflow runs (execution history)";
     static examples = [
@@ -14,15 +14,17 @@ export default class WorkflowRuns extends BaseCommand {
     async run() {
         const { flags } = await this.parse(WorkflowRuns);
         try {
-            const res = await apiRequest(`/workflow/runs?limit=${flags.limit}`);
+            const client = getClient();
+            const res = await client.workflows.listRuns({ limit: flags.limit });
+            const data = res?.data ?? [];
             if (flags.json) {
-                this.log(JSON.stringify(res, null, 2));
+                this.log(JSON.stringify({ ok: true, count: data.length, data }, null, 2));
                 return;
             }
-            this.log(`\n  Found ${res.count} run(s):\n`);
+            this.log(`\n  Found ${data.length} run(s):\n`);
             this.log("  RUN ID                   FLOW ID                  STATUS       DURATION");
             this.log("  ───────────────────────────────────────────────────────────────────────");
-            for (const run of res.data || []) {
+            for (const run of data) {
                 const id = (run.id || "").padEnd(24);
                 const flowId = (run.flowId || "").padEnd(24);
                 const status = (run.status || "").padEnd(12);

package/dist/config.d.ts

@@ -3,11 +3,13 @@ interface ImbraceConfig {
     credential?: string;
     method?: "api-key" | "password";
     email?: string;
-    apiUrl?: string;
 }
 /**
- * Saves credentials to ~/.config/imbrace/config.json
- * Uses `conf` package — cross-platform, auto-create
+ * Saves credentials via the `conf` package — cross-platform, auto-create.
+ * Path depends on OS:
+ *   macOS:   ~/Library/Preferences/imbrace-nodejs/config.json
+ *   Linux:   ~/.config/imbrace-nodejs/config.json
+ *   Windows: %APPDATA%/imbrace-nodejs/Config/config.json
  */
 export declare const config: Conf<ImbraceConfig>;
 export declare function saveCredential(opts: {
@@ -16,12 +18,10 @@ export declare function saveCredential(opts: {
     email?: string;
 }): void;
 export declare function getCredential(): string | undefined;
-export declare function getApiUrl(): string;
 export declare function clearCredential(): void;
 export declare function getAuthInfo(): {
     credential: string | undefined;
     method: "api-key" | "password" | undefined;
     email: string | undefined;
-    apiUrl: string | undefined;
 };
 export {};

package/dist/config.js

@@ -1,14 +1,12 @@
 import Conf from "conf";
 /**
- * Saves credentials to ~/.config/imbrace/config.json
- * Uses `conf` package — cross-platform, auto-create
+ * Saves credentials via the `conf` package — cross-platform, auto-create.
+ * Path depends on OS:
+ *   macOS:   ~/Library/Preferences/imbrace-nodejs/config.json
+ *   Linux:   ~/.config/imbrace-nodejs/config.json
+ *   Windows: %APPDATA%/imbrace-nodejs/Config/config.json
  */
-export const config = new Conf({
-    projectName: "imbrace",
-    defaults: {
-        apiUrl: "http://localhost:3456",
-    },
-});
+export const config = new Conf({ projectName: "imbrace" });
 export function saveCredential(opts) {
     config.set("credential", opts.credential);
     config.set("method", opts.method);
@@ -18,9 +16,6 @@ export function saveCredential(opts) {
 export function getCredential() {
     return config.get("credential");
 }
-export function getApiUrl() {
-    return config.get("apiUrl") || "http://localhost:3456";
-}
 export function clearCredential() {
     config.delete("credential");
     config.delete("method");
@@ -31,6 +26,5 @@ export function getAuthInfo() {
         credential: config.get("credential"),
         method: config.get("method"),
         email: config.get("email"),
-        apiUrl: config.get("apiUrl"),
     };
 }

package/dist/lib/ai-agent.d.ts

@@ -0,0 +1,40 @@
+import { GW } from "./gateway.js";
+export interface CreateAgentInput {
+    name: string;
+    description?: string;
+    instructions?: string;
+    model?: string;
+    provider_id?: string;
+    mode?: string;
+    channel?: string;
+    category?: string[] | string;
+    personality_role?: string;
+    core_task?: string;
+    tone_and_style?: string;
+    response_length?: string;
+    banned_words?: string;
+    preload_information?: string;
+    guardrail_id?: string;
+    show_thinking_process?: boolean;
+    streaming?: boolean;
+    use_memory?: boolean;
+    temperature?: number;
+    knowledge_hubs?: string[];
+    folder_ids?: string[];
+    default_folder_id?: string;
+    board_ids?: string[];
+    file_ids?: string[];
+}
+export declare function createAgent(body: CreateAgentInput): Promise<any>;
+export declare function updateAgent(id: string, body: Record<string, any>): Promise<any>;
+export declare function listProviders(): Promise<{
+    id: any;
+    _id: any;
+    provider_id: any;
+    name: any;
+    type: any;
+    is_default: boolean;
+    models: any;
+}[]>;
+export declare function listProviderModels(providerId: string): Promise<any>;
+export { GW };

package/dist/lib/ai-agent.js

@@ -0,0 +1,150 @@
+// AI Agent payload builders — mirror the legacy api/src/routes/ai-agent.ts
+// behavior so command output stays consistent across the api→sdk migration.
+import { getClient } from "./client.js";
+import { fetchSystemModels, gatewayFetch, GW } from "./gateway.js";
+export async function createAgent(body) {
+    const client = getClient();
+    const slug = body.name.toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+    const workflowName = `${slug}_v${Date.now()}`;
+    const data = await client.agent.createUseCase({
+        usecase: {
+            title: body.name,
+            short_description: body.description || "",
+            agent_type: "agent",
+            demo_url: "https://chat-widgetv2.imbrace.co",
+            supported_channels: [{ title: "channel_", icon: "" }],
+        },
+        assistant: {
+            name: body.name,
+            description: body.description || "",
+            instructions: body.instructions || "",
+            workflow_name: workflowName,
+            credential_name: `${body.mode || "standard"} | ${body.name}`,
+            provider_id: body.provider_id || "system",
+            model_id: body.model || "Default",
+            agent_type: "agent",
+            mode: body.mode || "standard",
+            version: 2,
+            channel: body.channel || "",
+            category: body.category || ["Support"],
+            personality_role: body.personality_role || "",
+            core_task: body.core_task || "",
+            tone_and_style: body.tone_and_style || "",
+            response_length: body.response_length || "",
+            banned_words: body.banned_words || "",
+            preload_information: body.preload_information || "",
+            guardrail_id: body.guardrail_id || "",
+            show_thinking_process: body.show_thinking_process ?? false,
+            streaming: body.streaming ?? true,
+            use_memory: body.use_memory ?? true,
+            temperature: typeof body.temperature === "number" ? body.temperature : 0.1,
+            knowledge_hubs: body.knowledge_hubs || [],
+            folder_ids: body.folder_ids || [],
+            default_folder_id: body.default_folder_id || "",
+            board_ids: body.board_ids || [],
+            file_ids: body.file_ids || [],
+            workflow_function_call: [],
+            sub_agents: [],
+            team_leads: [],
+            metadata: {
+                other_requirements: [],
+                channel_id: "",
+                team_ids: [],
+                tool_server: null,
+                enable_echart: false,
+                top_k_relevant_results: 3,
+                top_k: 40,
+                max_steps: 10,
+            },
+        },
+    });
+    return data?.data ?? data;
+}
+const ASSISTANT_FIELDS = [
+    "instructions", "description", "provider_id",
+    "personality_role", "core_task", "tone_and_style", "response_length",
+    "banned_words", "category", "guardrail_id", "preload_information", "channel",
+    "folder_ids", "default_folder_id", "knowledge_hubs", "board_ids", "file_ids",
+];
+export async function updateAgent(id, body) {
+    const client = getClient();
+    const tpl = (await client.agent.get(id))?.data ?? {};
+    const assistantId = tpl.assistant_id;
+    const results = {};
+    const hasAssistantUpdate = assistantId && (body.name || body.model || typeof body.temperature === "number" ||
+        typeof body.streaming === "boolean" || typeof body.use_memory === "boolean" ||
+        typeof body.show_thinking_process === "boolean" || body.mode ||
+        ASSISTANT_FIELDS.some((f) => body[f] !== undefined));
+    if (hasAssistantUpdate) {
+        // chatAi.updateAiAgent uses PUT (full replace) — fetch+merge so unchanged
+        // fields aren't reset to null.
+        const currentAssistant = await gatewayFetch(`/v3/ai/assistants/${assistantId}`);
+        const aUpdate = {
+            ...currentAssistant,
+            name: body.name ?? currentAssistant.name,
+            workflow_name: currentAssistant.workflow_name ||
+                `${(body.name ?? currentAssistant.name).toLowerCase().replace(/[^a-z0-9]+/g, "_")}_v${Date.now()}`,
+        };
+        if (body.model)
+            aUpdate.model_id = body.model;
+        if (body.mode)
+            aUpdate.mode = body.mode;
+        if (typeof body.temperature === "number")
+            aUpdate.temperature = body.temperature;
+        if (typeof body.streaming === "boolean")
+            aUpdate.streaming = body.streaming;
+        if (typeof body.use_memory === "boolean")
+            aUpdate.use_memory = body.use_memory;
+        if (typeof body.show_thinking_process === "boolean")
+            aUpdate.show_thinking_process = body.show_thinking_process;
+        for (const f of ASSISTANT_FIELDS) {
+            if (body[f] !== undefined)
+                aUpdate[f] = body[f];
+        }
+        results.assistant = await client.chatAi.updateAiAgent(assistantId, aUpdate);
+    }
+    if (body.name || body.description) {
+        const tUpdate = {};
+        if (body.name)
+            tUpdate.title = body.name;
+        if (body.description)
+            tUpdate.short_description = body.description;
+        results.template = await client.agent.updateUseCase(id, tUpdate);
+    }
+    if (Object.keys(results).length === 0) {
+        throw new Error("No update fields provided");
+    }
+    return results;
+}
+export async function listProviders() {
+    const client = getClient();
+    const [r, systemModels] = await Promise.all([
+        client.ai.listProviders(),
+        fetchSystemModels(),
+    ]);
+    const arr = (r?.data || r);
+    return [
+        { id: "system", _id: "system", provider_id: "system", name: "system", type: "system", is_default: true, models: systemModels },
+        ...arr.map((p) => ({
+            id: p.provider_id || p._id,
+            _id: p._id,
+            provider_id: p.provider_id || p._id,
+            name: p.name,
+            type: p.type,
+            is_default: false,
+            models: (p.models || []).map((m) => typeof m === "string" ? m : m.name),
+        })),
+    ];
+}
+export async function listProviderModels(providerId) {
+    if (providerId === "system")
+        return fetchSystemModels();
+    const client = getClient();
+    const r = await client.ai.listProviders();
+    const arr = (r?.data || r);
+    const provider = arr.find((p) => p.provider_id === providerId || p._id === providerId);
+    if (!provider)
+        throw new Error(`Provider "${providerId}" not found`);
+    return (provider.models || []).map((m) => typeof m === "string" ? m : m.name);
+}
+export { GW };

package/dist/lib/client.d.ts

@@ -0,0 +1,7 @@
+import { ImbraceClient } from "@imbrace/sdk";
+/**
+ * Build an authenticated ImbraceClient from the saved credential.
+ * Caches per-process — re-call to refresh after login.
+ */
+export declare function getClient(): ImbraceClient;
+export declare function resetClient(): void;

package/dist/lib/client.js

@@ -0,0 +1,21 @@
+import { ImbraceClient } from "@imbrace/sdk";
+import { getCredential } from "../config.js";
+let cachedClient = null;
+/**
+ * Build an authenticated ImbraceClient from the saved credential.
+ * Caches per-process — re-call to refresh after login.
+ */
+export function getClient() {
+    if (cachedClient)
+        return cachedClient;
+    const credential = getCredential();
+    if (!credential) {
+        throw new Error("Not logged in. Run: imbrace login --api-key api_xxx...");
+    }
+    const isApiKey = credential.startsWith("sk-") || credential.startsWith("api_");
+    cachedClient = new ImbraceClient(isApiKey ? { apiKey: credential } : { accessToken: credential });
+    return cachedClient;
+}
+export function resetClient() {
+    cachedClient = null;
+}

package/dist/lib/gateway.d.ts

@@ -0,0 +1,3 @@
+export declare const GW = "https://app-gatewayv2.imbrace.co";
+export declare function gatewayFetch<T = any>(path: string, init?: RequestInit): Promise<T>;
+export declare function fetchSystemModels(): Promise<string[]>;

package/dist/lib/gateway.js

@@ -0,0 +1,31 @@
+// Direct gateway fetch for routes the SDK doesn't expose (e.g. workflow-agent
+// system models, raw assistant fetch for PUT-merge).
+import { getCredential } from "../config.js";
+export const GW = "https://app-gatewayv2.imbrace.co";
+function authHeader() {
+    const cred = getCredential();
+    if (!cred)
+        throw new Error("Not logged in. Run: imbrace login --api-key api_xxx...");
+    return cred.startsWith("api_") ? { "x-api-key": cred } : { authorization: `Bearer ${cred}` };
+}
+export async function gatewayFetch(path, init) {
+    const res = await fetch(`${GW}${path}`, {
+        ...init,
+        headers: { ...authHeader(), ...init?.headers },
+    });
+    if (!res.ok)
+        throw new Error(`[${res.status}] ${await res.text()}`);
+    return res.json();
+}
+// System provider only exposes one model "Default" via /workflow-agent endpoint.
+// Empty/error → fall back to ["Default"] so create commands still work.
+export async function fetchSystemModels() {
+    try {
+        const j = await gatewayFetch("/ai/v3/workflow-agent/models");
+        const arr = j?.data || j?.message?.data || [];
+        return arr.map((m) => (typeof m === "string" ? m : m.name)).filter(Boolean);
+    }
+    catch {
+        return ["Default"];
+    }
+}

package/dist/lib/workflow.d.ts

@@ -0,0 +1,20 @@
+import { ImbraceClient } from "@imbrace/sdk";
+export declare const PIECE_PREFIX = "@activepieces/";
+export declare function normalizePieceName(input: string): string;
+export declare function resolveProjectId(client: ImbraceClient): Promise<string>;
+export declare function fetchPieceMeta(pieceName: string): Promise<{
+    version: string;
+}>;
+export declare function buildPropertySettings(input: Record<string, any>): Record<string, any>;
+export interface FlatNode {
+    name: string;
+    type: string;
+    displayName?: string;
+    pieceName?: string;
+    actionName?: string;
+    triggerName?: string;
+    input?: any;
+    valid?: boolean;
+}
+export declare function flattenNodes(trigger: any): FlatNode[];
+export declare function nextStepName(trigger: any): string;

package/dist/lib/workflow.js

@@ -0,0 +1,71 @@
+import { gatewayFetch } from "./gateway.js";
+export const PIECE_PREFIX = "@activepieces/";
+// "slack" → "@activepieces/piece-slack" (idempotent)
+export function normalizePieceName(input) {
+    if (input.startsWith(PIECE_PREFIX))
+        return input;
+    return `${PIECE_PREFIX}piece-${input.toLowerCase()}`;
+}
+// Resolve projectId by reusing the project of any existing flow.
+export async function resolveProjectId(client) {
+    const flows = await client.workflows.listFlows();
+    const first = flows?.data?.[0];
+    if (!first?.projectId) {
+        throw new Error("Cannot resolve projectId — no existing flows to derive from. " +
+            "Create your first flow via the UI (cloud.imbrace.co/workflow-v2) once.");
+    }
+    return first.projectId;
+}
+// Backend rejects ops without correct pieceVersion + propertySettings,
+// so we fetch piece metadata directly from the gateway.
+export async function fetchPieceMeta(pieceName) {
+    const data = await gatewayFetch(`/activepieces/v1/pieces/${pieceName}`);
+    return { version: data.version };
+}
+// Each input key gets a `propertySettings: { type: "MANUAL" }` entry.
+// authFields is the only special case — its schema lives one level deeper.
+export function buildPropertySettings(input) {
+    const ps = {};
+    for (const k of Object.keys(input || {})) {
+        ps[k] = (k === "authFields" && typeof input[k] === "object")
+            ? { type: "MANUAL", schema: {} }
+            : { type: "MANUAL" };
+    }
+    return ps;
+}
+export function flattenNodes(trigger) {
+    const nodes = [];
+    function visit(node) {
+        if (!node)
+            return;
+        nodes.push({
+            name: node.name,
+            type: node.type,
+            displayName: node.displayName,
+            pieceName: node.settings?.pieceName,
+            actionName: node.settings?.actionName,
+            triggerName: node.settings?.triggerName,
+            input: node.settings?.input,
+            valid: node.valid,
+        });
+        if (node.nextAction)
+            visit(node.nextAction);
+        for (const ch of (node.children || [])) {
+            if (ch)
+                visit(ch);
+        }
+        if (node.firstLoopAction)
+            visit(node.firstLoopAction);
+    }
+    visit(trigger);
+    return nodes;
+}
+// Generate next available step_N name given the existing tree.
+export function nextStepName(trigger) {
+    const nodes = flattenNodes(trigger);
+    const used = new Set(nodes.map((n) => n.name));
+    let i = 1;
+    while (used.has(`step_${i}`))
+        i++;
+    return `step_${i}`;
+}

package/dist/select-board.js

@@ -1,8 +1,9 @@
 import { select } from "@inquirer/prompts";
-import { apiRequest } from "./http.js";
+import { getClient } from "./lib/client.js";
 export async function selectBoard() {
-    const res = await apiRequest("/data-board/list");
-    const boards = res.data || [];
+    const client = getClient();
+    const res = await client.boards.list();
+    const boards = res?.data ?? [];
     if (!boards.length)
         throw new Error("No boards found. Create a board first.");
     return select({

package/llms.txt

@@ -27,6 +27,7 @@ Things to remember when using Imbrace CLI:
 - `imbrace help [command]` — Show help for any command
 - `imbrace autocomplete [shell]` — Display shell completion install instructions (bash, zsh, fish, powershell)
 - `imbrace --version` — Print CLI version
+- `imbrace docs` — Print the bundled `llms.txt` (this file). Pipe to a file (`imbrace docs > llms.txt`) and feed into a coding agent's context for one-shot reference. `--path` prints just the absolute path; `--json` outputs `{ path, content }`.
 
 ## Data Board Commands
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imbrace/cli",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "CLI tool for interacting with the Imbrace CRM platform from the terminal",
   "repository": {
@@ -24,7 +24,7 @@
     "prepack": "oclif manifest"
   },
   "dependencies": {
-    "@imbrace/sdk": "1.0.2",
+    "@imbrace/sdk": "^1.0.4",
     "@inquirer/prompts": "^7.10.1",
     "@oclif/core": "^4.2.0",
     "@oclif/plugin-autocomplete": "^3.2.0",

package/dist/http.d.ts

@@ -1,9 +0,0 @@
-/**
- * HTTP client for the local Hono API server
- * Automatically attaches the Bearer token from config
- */
-export declare function apiRequest<T = any>(path: string, opts?: {
-    method?: string;
-    body?: any;
-}): Promise<T>;
-export declare function apiRequestText(path: string): Promise<string>;

package/dist/http.js

@@ -1,40 +0,0 @@
-import { getCredential, getApiUrl } from "./config.js";
-/**
- * HTTP client for the local Hono API server
- * Automatically attaches the Bearer token from config
- */
-export async function apiRequest(path, opts) {
-    const credential = getCredential();
-    const baseUrl = getApiUrl();
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (credential) {
-        headers["Authorization"] = `Bearer ${credential}`;
-    }
-    const res = await fetch(`${baseUrl}${path}`, {
-        method: opts?.method || "GET",
-        headers,
-        body: opts?.body ? JSON.stringify(opts.body) : undefined,
-    });
-    const data = await res.json();
-    if (!res.ok) {
-        throw new Error(data?.message || `HTTP ${res.status}`);
-    }
-    return data;
-}
-export async function apiRequestText(path) {
-    const credential = getCredential();
-    const baseUrl = getApiUrl();
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    if (credential) {
-        headers["Authorization"] = `Bearer ${credential}`;
-    }
-    const res = await fetch(`${baseUrl}${path}`, { method: "GET", headers });
-    if (!res.ok) {
-        throw new Error(`HTTP ${res.status}`);
-    }
-    return res.text();
-}