@qcobro/ctl 1.27.0

package/README.md

@@ -0,0 +1,290 @@
+# ctl
+
+Command-Line for QCobro
+
+[![Version](https://img.shields.io/npm/v/@qcobro/ctl.svg)](https://npmjs.org/package/@qcobro/ctl)
+[![License](https://img.shields.io/npm/l/@qcobro/ctl.svg)](https://github.com/fonoster/qcobro/blob/main/package.json)
+
+Use this tool to manage your QCobro resources from the command line, without going through
+the operator console: sync a portfolio, create an agent template, or configure an MCP client
+like Claude Desktop to use [`@qcobro/mcp`](../mcp).
+
+It's built on [`@qcobro/sdk`](../sdk), so every command talks to the same QCobro API the SDK
+and the console use, with the same client-side input validation.
+
+## Setup
+
+Link a workspace before running any authenticated command. You'll need a workspace API key
+(an `accessKeyId` + `accessKeySecret`) — create one from the QCobro console's API Keys page —
+and the `accessKeyId` of the workspace that key acts in.
+
+```sh-session
+$ qcobro workspaces:login
+```
+
+<!-- toc -->
+
+- [Usage](#usage)
+- [Commands](#commands)
+<!-- tocstop -->
+
+# Usage
+
+<!-- usage -->
+
+```sh-session
+$ npm install -g @qcobro/ctl
+$ qcobro COMMAND
+running command...
+$ qcobro (--version)
+@qcobro/ctl/1.24.1 darwin-arm64 node-v22.17.0
+$ qcobro --help [COMMAND]
+USAGE
+  $ qcobro COMMAND
+...
+```
+
+<!-- usagestop -->
+
+# Commands
+
+<!-- commands -->
+
+- [`qcobro agents:create`](#qcobro-agentscreate)
+- [`qcobro agents:eval TEMPLATEID`](#qcobro-agentseval-templateid)
+- [`qcobro mcp:configure`](#qcobro-mcpconfigure)
+- [`qcobro portfolios:get ID`](#qcobro-portfoliosget-id)
+- [`qcobro portfolios:list`](#qcobro-portfolioslist)
+- [`qcobro portfolios:sync`](#qcobro-portfoliossync)
+- [`qcobro workspaces:active`](#qcobro-workspacesactive)
+- [`qcobro workspaces:list`](#qcobro-workspaceslist)
+- [`qcobro workspaces:login`](#qcobro-workspaceslogin)
+- [`qcobro workspaces:logout WORKSPACEACCESSKEYID`](#qcobro-workspaceslogout-workspaceaccesskeyid)
+- [`qcobro workspaces:use WORKSPACEACCESSKEYID`](#qcobro-workspacesuse-workspaceaccesskeyid)
+
+## `qcobro agents:create`
+
+create an agent template in the active workspace
+
+```
+USAGE
+  $ qcobro agents:create --type VOICE_AI|VOICE_PRERECORDED|SMS|EMAIL|WHATSAPP --name <value> [--voice <value>]
+    [--language <value>] [--system-prompt <value>] [--first-message <value>] [--script <value>] [--fonoster-app-name
+    <value>] [--message-body <value>] [--sender-id <value>] [--subject <value>] [--max-replies <value>] [--template-name
+    <value>]
+
+FLAGS
+  --first-message=<value>      opening line (VOICE_AI, optional)
+  --fonoster-app-name=<value>  Fonoster application name (voice types)
+  --language=<value>           language code (voice channel types)
+  --max-replies=<value>        reply cap per gestión (EMAIL, WHATSAPP)
+  --message-body=<value>       message text (SMS, EMAIL)
+  --name=<value>               (required) template name
+  --script=<value>             full TTS script (VOICE_PRERECORDED)
+  --sender-id=<value>          sender identifier (SMS, optional)
+  --subject=<value>            email subject (EMAIL)
+  --system-prompt=<value>      AI persona/instructions (VOICE_AI, EMAIL, WHATSAPP)
+  --template-name=<value>      Meta template name (WHATSAPP)
+  --type=<option>              (required) agent channel type
+                               <options: VOICE_AI|VOICE_PRERECORDED|SMS|EMAIL|WHATSAPP>
+  --voice=<value>              voice identifier (voice channel types)
+
+DESCRIPTION
+  create an agent template in the active workspace
+
+EXAMPLES
+  $ qcobro agents:create --type VOICE_AI --name "Cobranza suave" --voice sofia --system-prompt "Sé amable y directo." --language es
+
+  $ qcobro agents:create --type SMS --name "Recordatorio" --message-body "Hola {{firstName}}, tienes un saldo pendiente."
+```
+
+## `qcobro agents:eval TEMPLATEID`
+
+re-attempt an agent template's Fonoster sync and report the resulting status. This validates the template's configuration and its sync with Fonoster — QCobro has no conversational-intelligence evaluation feature today, so this does not test conversation behavior. Only VOICE_AI templates sync with Fonoster; other channel types are a no-op that leaves the template unchanged.
+
+```
+USAGE
+  $ qcobro agents:eval TEMPLATEID
+
+ARGUMENTS
+  TEMPLATEID  the agent template id
+
+DESCRIPTION
+  re-attempt an agent template's Fonoster sync and report the resulting status. This validates the template's
+  configuration and its sync with Fonoster — QCobro has no conversational-intelligence evaluation feature today, so this
+  does not test conversation behavior. Only VOICE_AI templates sync with Fonoster; other channel types are a no-op that
+  leaves the template unchanged.
+
+EXAMPLES
+  $ qcobro agents:eval <templateId>
+```
+
+## `qcobro mcp:configure`
+
+configure an MCP client to use @qcobro/mcp
+
+```
+USAGE
+  $ qcobro mcp:configure [-c claude] [--url <value>] [--access-key-id <value>] [--access-key-secret <value>]
+    [--workspace <value>]
+
+FLAGS
+  -c, --client=<option>            [default: claude] MCP client to configure
+                                   <options: claude>
+      --access-key-id=<value>      workspace API key id (overrides active workspace)
+      --access-key-secret=<value>  workspace API key secret (overrides active workspace)
+      --url=<value>                [default: https://api.qcobro.com] QCobro API base URL
+      --workspace=<value>          workspace to act in, its accessKeyId (overrides active workspace)
+
+DESCRIPTION
+  configure an MCP client to use @qcobro/mcp
+
+EXAMPLES
+  $ qcobro mcp:configure
+
+  $ qcobro mcp:configure --client claude
+
+  $ qcobro mcp:configure --access-key-id <id> --access-key-secret <secret> --workspace <workspaceAccessKeyId>
+```
+
+## `qcobro portfolios:get ID`
+
+display a single portfolio
+
+```
+USAGE
+  $ qcobro portfolios:get ID
+
+ARGUMENTS
+  ID  the portfolio id
+
+DESCRIPTION
+  display a single portfolio
+
+EXAMPLES
+  $ qcobro portfolios:get <id>
+```
+
+## `qcobro portfolios:list`
+
+display the active workspace's portfolios
+
+```
+USAGE
+  $ qcobro portfolios:list [--include-archived]
+
+FLAGS
+  --include-archived  include archived portfolios
+
+DESCRIPTION
+  display the active workspace's portfolios
+
+EXAMPLES
+  $ qcobro portfolios:list
+
+  $ qcobro portfolios:list --include-archived
+```
+
+## `qcobro portfolios:sync`
+
+synchronize a batch of account rows into a portfolio, from a JSON file
+
+```
+USAGE
+  $ qcobro portfolios:sync --portfolio-id <value> --file <value> [--mode APPEND_ONLY|UPDATE_EXISTING|REPLACE]
+
+FLAGS
+  --file=<value>          (required) path to a JSON file containing an array of account rows
+  --mode=<option>         [default: APPEND_ONLY] merge strategy
+                          <options: APPEND_ONLY|UPDATE_EXISTING|REPLACE>
+  --portfolio-id=<value>  (required) the portfolio id
+
+DESCRIPTION
+  synchronize a batch of account rows into a portfolio, from a JSON file
+
+EXAMPLES
+  $ qcobro portfolios:sync --portfolio-id <id> --file rows.json --mode APPEND_ONLY
+```
+
+## `qcobro workspaces:active`
+
+display the active QCobro workspace
+
+```
+USAGE
+  $ qcobro workspaces:active
+
+DESCRIPTION
+  display the active QCobro workspace
+
+EXAMPLES
+  $ qcobro workspaces:active
+```
+
+## `qcobro workspaces:list`
+
+display all linked QCobro workspaces
+
+```
+USAGE
+  $ qcobro workspaces:list
+
+DESCRIPTION
+  display all linked QCobro workspaces
+
+EXAMPLES
+  $ qcobro workspaces:list
+```
+
+## `qcobro workspaces:login`
+
+link a QCobro workspace to the local environment
+
+```
+USAGE
+  $ qcobro workspaces:login
+
+DESCRIPTION
+  link a QCobro workspace to the local environment
+
+EXAMPLES
+  $ qcobro workspaces:login
+```
+
+## `qcobro workspaces:logout WORKSPACEACCESSKEYID`
+
+unlink a QCobro workspace from the local environment
+
+```
+USAGE
+  $ qcobro workspaces:logout WORKSPACEACCESSKEYID
+
+ARGUMENTS
+  WORKSPACEACCESSKEYID  the workspace to unlink (its accessKeyId)
+
+DESCRIPTION
+  unlink a QCobro workspace from the local environment
+
+EXAMPLES
+  $ qcobro workspaces:logout WO6ueex0qan9ojhf820wgiae3qi5luy08y
+```
+
+## `qcobro workspaces:use WORKSPACEACCESSKEYID`
+
+set a linked workspace as the active one
+
+```
+USAGE
+  $ qcobro workspaces:use WORKSPACEACCESSKEYID
+
+ARGUMENTS
+  WORKSPACEACCESSKEYID  the workspace to activate (its accessKeyId)
+
+DESCRIPTION
+  set a linked workspace as the active one
+
+EXAMPLES
+  $ qcobro workspaces:use WO6ueex0qan9ojhf820wgiae3qi5luy08y
+```
+
+<!-- commandsstop -->

package/bin/dev.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env -S node --import tsx
+
+process.removeAllListeners("warning");
+process.on("warning", () => {});
+
+const { execute } = await import("@oclif/core");
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+// The following code suppresses the warning about the punycode deprecated module.
+// This is a temporary workaround until this get's fixed upstream.
+process.removeAllListeners("warning");
+process.on("warning", () => {});
+
+const { execute } = await import("@oclif/core");
+await execute({ dir: import.meta.url });

package/dist/AuthenticatedCommand.d.ts

@@ -0,0 +1,13 @@
+import { Command } from "@oclif/core";
+import { Client } from "@qcobro/sdk";
+import { BaseCommand } from "./BaseCommand.js";
+/**
+ * Base class for commands that need an authenticated `@qcobro/sdk` `Client`.
+ * Constructs the client from the active workspace's stored credentials, the
+ * same way `@qcobro/mcp`'s `createClient` util does (`loginWithApiKey` then
+ * `useWorkspace`) — see `mods/mcp/src/utils/createClient.ts`.
+ */
+export declare abstract class AuthenticatedCommand<T extends typeof Command> extends BaseCommand<T> {
+    protected createSdkClient(): Promise<Client>;
+}
+//# sourceMappingURL=AuthenticatedCommand.d.ts.map

package/dist/AuthenticatedCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthenticatedCommand.d.ts","sourceRoot":"","sources":["../src/AuthenticatedCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAI/C;;;;;GAKG;AACH,8BAAsB,oBAAoB,CAAC,CAAC,SAAS,OAAO,OAAO,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;cACzE,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;CAyBnD"}

package/dist/AuthenticatedCommand.js

@@ -0,0 +1,32 @@
+import { Client } from "@qcobro/sdk";
+import { BaseCommand } from "./BaseCommand.js";
+import { getActiveWorkspace, getConfig } from "./config/index.js";
+import { CONFIG_FILE } from "./constants.js";
+/**
+ * Base class for commands that need an authenticated `@qcobro/sdk` `Client`.
+ * Constructs the client from the active workspace's stored credentials, the
+ * same way `@qcobro/mcp`'s `createClient` util does (`loginWithApiKey` then
+ * `useWorkspace`) — see `mods/mcp/src/utils/createClient.ts`.
+ */
+export class AuthenticatedCommand extends BaseCommand {
+    async createSdkClient() {
+        const workspaces = getConfig(CONFIG_FILE);
+        const activeWorkspace = getActiveWorkspace(workspaces);
+        if (!activeWorkspace) {
+            this.error("No active workspace found. Run `qcobro workspaces:login` first.", { exit: 1 });
+        }
+        try {
+            const client = new Client({ endpoint: activeWorkspace.endpoint });
+            await client.loginWithApiKey({
+                accessKeyId: activeWorkspace.accessKeyId,
+                accessKeySecret: activeWorkspace.accessKeySecret
+            });
+            client.useWorkspace(activeWorkspace.workspaceAccessKeyId);
+            return client;
+        }
+        catch {
+            return this.error("Failed to initialize the SDK client. Try `qcobro workspaces:login` again.", { exit: 1 });
+        }
+    }
+}
+//# sourceMappingURL=AuthenticatedCommand.js.map

package/dist/AuthenticatedCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthenticatedCommand.js","sourceRoot":"","sources":["../src/AuthenticatedCommand.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,OAAgB,oBAA+C,SAAQ,WAAc;IAC/E,KAAK,CAAC,eAAe;QAC7B,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,eAAe,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAEvD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,iEAAiE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7F,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC;YAElE,MAAM,MAAM,CAAC,eAAe,CAAC;gBAC3B,WAAW,EAAE,eAAe,CAAC,WAAW;gBACxC,eAAe,EAAE,eAAe,CAAC,eAAe;aACjD,CAAC,CAAC;YACH,MAAM,CAAC,YAAY,CAAC,eAAe,CAAC,oBAAoB,CAAC,CAAC;YAE1D,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,KAAK,CACf,2EAA2E,EAC3E,EAAE,IAAI,EAAE,CAAC,EAAE,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/BaseCommand.d.ts

@@ -0,0 +1,22 @@
+import { Command, Interfaces } from "@oclif/core";
+export type Args<T extends typeof Command> = Interfaces.InferredArgs<T["args"]>;
+/**
+ * Base class every `@qcobro/ctl` command extends. Provides shared flag
+ * parsing (`baseFlags`, inherited by every command via `Flags<T>`) and a
+ * single place to hook error handling, mirroring `@fonoster/ctl`'s
+ * `BaseCommand`. QCobro's SDK talks tRPC over HTTPS with no insecure-channel
+ * concept, so — unlike Fonoster's version — no `--insecure` flag is defined
+ * here.
+ */
+export declare abstract class BaseCommand<T extends typeof Command> extends Command {
+    static readonly baseFlags: {};
+    protected flags: Flags<T>;
+    protected args: Args<T>;
+    init(): Promise<void>;
+    protected catch(err: Error & {
+        exitCode?: number;
+    }): Promise<unknown>;
+    protected finally(err: Error | undefined): Promise<unknown>;
+}
+export type Flags<T extends typeof Command> = Interfaces.InferredFlags<(typeof BaseCommand)["baseFlags"] & T["flags"]>;
+//# sourceMappingURL=BaseCommand.d.ts.map

package/dist/BaseCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../src/BaseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhF;;;;;;;GAOG;AACH,8BAAsB,WAAW,CAAC,CAAC,SAAS,OAAO,OAAO,CAAE,SAAQ,OAAO;IACzE,MAAM,CAAC,QAAQ,CAAC,SAAS,KAAM;IAE/B,SAAS,CAAC,KAAK,EAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,SAAS,CAAC,IAAI,EAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEZ,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;cAalB,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;cAI3D,OAAO,CAAC,GAAG,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;CAGlE;AAED,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,aAAa,CACpE,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAC/C,CAAC"}

package/dist/BaseCommand.js

@@ -0,0 +1,33 @@
+import { Command } from "@oclif/core";
+/**
+ * Base class every `@qcobro/ctl` command extends. Provides shared flag
+ * parsing (`baseFlags`, inherited by every command via `Flags<T>`) and a
+ * single place to hook error handling, mirroring `@fonoster/ctl`'s
+ * `BaseCommand`. QCobro's SDK talks tRPC over HTTPS with no insecure-channel
+ * concept, so — unlike Fonoster's version — no `--insecure` flag is defined
+ * here.
+ */
+export class BaseCommand extends Command {
+    static baseFlags = {};
+    flags;
+    args;
+    async init() {
+        await super.init();
+        const { args, flags } = await this.parse({
+            flags: this.ctor.flags,
+            baseFlags: super.ctor.baseFlags,
+            enableJsonFlag: this.ctor.enableJsonFlag,
+            args: this.ctor.args,
+            strict: this.ctor.strict
+        });
+        this.flags = flags;
+        this.args = args;
+    }
+    async catch(err) {
+        return super.catch(err);
+    }
+    async finally(err) {
+        return super.finally(err);
+    }
+}
+//# sourceMappingURL=BaseCommand.js.map

package/dist/BaseCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseCommand.js","sourceRoot":"","sources":["../src/BaseCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAc,MAAM,aAAa,CAAC;AAIlD;;;;;;;GAOG;AACH,MAAM,OAAgB,WAAsC,SAAQ,OAAO;IACzE,MAAM,CAAU,SAAS,GAAG,EAAE,CAAC;IAErB,KAAK,CAAY;IACjB,IAAI,CAAW;IAElB,KAAK,CAAC,IAAI;QACf,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;YACvC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK;YACtB,SAAS,EAAG,KAAK,CAAC,IAA2B,CAAC,SAAS;YACvD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM;SACzB,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,GAAG,KAAiB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAe,CAAC;IAC9B,CAAC;IAES,KAAK,CAAC,KAAK,CAAC,GAAkC;QACtD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,GAAsB;QAC5C,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC"}

package/dist/commands/agents/create.d.ts

@@ -0,0 +1,25 @@
+import { Interfaces } from "@oclif/core";
+import { AuthenticatedCommand } from "../../AuthenticatedCommand.js";
+export default class Create extends AuthenticatedCommand<typeof Create> {
+    static readonly description = "create an agent template in the active workspace";
+    static readonly examples: string[];
+    static readonly flags: {
+        type: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
+        name: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
+        voice: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        language: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        "system-prompt": Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        "first-message": Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        script: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        "fonoster-app-name": Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        "message-body": Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        "sender-id": Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        subject: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        "max-replies": Interfaces.OptionFlag<number | undefined, Interfaces.CustomOptions>;
+        "template-name": Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+    };
+    run(): Promise<void>;
+    private buildPayload;
+    private required;
+}
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/agents/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,CAAC,OAAO,OAAO,MAAO,SAAQ,oBAAoB,CAAC,OAAO,MAAM,CAAC;IACrE,gBAAyB,WAAW,sDAAsD;IAC1F,gBAAyB,QAAQ,WAG/B;IACF,gBAAyB,KAAK;;;;;;;;;;;;;;MAsB5B;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,OAAO,CAAC,YAAY;IAuDpB,OAAO,CAAC,QAAQ;CAIjB"}

package/dist/commands/agents/create.js

@@ -0,0 +1,96 @@
+import { Flags } from "@oclif/core";
+import { AuthenticatedCommand } from "../../AuthenticatedCommand.js";
+export default class Create extends AuthenticatedCommand {
+    static description = "create an agent template in the active workspace";
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --type VOICE_AI --name "Cobranza suave" --voice sofia --system-prompt "Sé amable y directo." --language es',
+        '<%= config.bin %> <%= command.id %> --type SMS --name "Recordatorio" --message-body "Hola {{firstName}}, tienes un saldo pendiente."'
+    ];
+    static flags = {
+        type: Flags.string({
+            description: "agent channel type",
+            options: ["VOICE_AI", "VOICE_PRERECORDED", "SMS", "EMAIL", "WHATSAPP"],
+            required: true
+        }),
+        name: Flags.string({ description: "template name", required: true }),
+        // Voice (VOICE_AI, VOICE_PRERECORDED)
+        voice: Flags.string({ description: "voice identifier (voice channel types)" }),
+        language: Flags.string({ description: "language code (voice channel types)" }),
+        "system-prompt": Flags.string({
+            description: "AI persona/instructions (VOICE_AI, EMAIL, WHATSAPP)"
+        }),
+        "first-message": Flags.string({ description: "opening line (VOICE_AI, optional)" }),
+        script: Flags.string({ description: "full TTS script (VOICE_PRERECORDED)" }),
+        "fonoster-app-name": Flags.string({ description: "Fonoster application name (voice types)" }),
+        // Text (SMS, EMAIL, WHATSAPP)
+        "message-body": Flags.string({ description: "message text (SMS, EMAIL)" }),
+        "sender-id": Flags.string({ description: "sender identifier (SMS, optional)" }),
+        subject: Flags.string({ description: "email subject (EMAIL)" }),
+        "max-replies": Flags.integer({ description: "reply cap per gestión (EMAIL, WHATSAPP)" }),
+        "template-name": Flags.string({ description: "Meta template name (WHATSAPP)" })
+    };
+    async run() {
+        const { flags } = await this.parse(Create);
+        const client = await this.createSdkClient();
+        const payload = this.buildPayload(flags);
+        const created = await client.agentTemplates.create(payload);
+        this.log(`Created agent template ${created.id} (${created.type}) "${created.name}".`);
+    }
+    buildPayload(flags) {
+        const base = { name: flags.name };
+        switch (flags.type) {
+            case "VOICE_AI":
+                return {
+                    ...base,
+                    type: "VOICE_AI",
+                    voice: this.required(flags.voice, "--voice"),
+                    systemPrompt: this.required(flags["system-prompt"], "--system-prompt"),
+                    firstMessage: flags["first-message"],
+                    language: this.required(flags.language, "--language"),
+                    fonosterAppName: flags["fonoster-app-name"]
+                };
+            case "VOICE_PRERECORDED":
+                return {
+                    ...base,
+                    type: "VOICE_PRERECORDED",
+                    voice: this.required(flags.voice, "--voice"),
+                    script: this.required(flags.script, "--script"),
+                    language: this.required(flags.language, "--language"),
+                    fonosterAppName: flags["fonoster-app-name"]
+                };
+            case "SMS":
+                return {
+                    ...base,
+                    type: "SMS",
+                    messageBody: this.required(flags["message-body"], "--message-body"),
+                    senderId: flags["sender-id"]
+                };
+            case "EMAIL":
+                return {
+                    ...base,
+                    type: "EMAIL",
+                    subject: this.required(flags.subject, "--subject"),
+                    messageBody: this.required(flags["message-body"], "--message-body"),
+                    systemPrompt: this.required(flags["system-prompt"], "--system-prompt"),
+                    maxReplies: flags["max-replies"]
+                };
+            case "WHATSAPP":
+                return {
+                    ...base,
+                    type: "WHATSAPP",
+                    templateName: this.required(flags["template-name"], "--template-name"),
+                    messageBody: this.required(flags["message-body"], "--message-body"),
+                    systemPrompt: this.required(flags["system-prompt"], "--system-prompt"),
+                    maxReplies: flags["max-replies"]
+                };
+            default:
+                return this.error(`Unknown agent type: ${flags.type}`, { exit: 1 });
+        }
+    }
+    required(value, flagName) {
+        if (!value)
+            this.error(`Missing required flag ${flagName} for this agent type.`, { exit: 1 });
+        return value;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/agents/create.js.map

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

package/dist/commands/agents/eval.d.ts

@@ -0,0 +1,15 @@
+import { AuthenticatedCommand } from "../../AuthenticatedCommand.js";
+export default class Eval extends AuthenticatedCommand<typeof Eval> {
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        "template-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        scenarios: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private buildInput;
+    /** Prints one evaluation event; returns true if it signals a failure. */
+    private printEvent;
+}
+//# sourceMappingURL=eval.d.ts.map

package/dist/commands/agents/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/eval.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,CAAC,OAAO,OAAO,IAAK,SAAQ,oBAAoB,CAAC,OAAO,IAAI,CAAC;IACjE,gBAAyB,WAAW,SAKqD;IACzF,gBAAyB,QAAQ,WAG/B;IACF,gBAAyB,KAAK;;;;MAQ5B;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,OAAO,CAAC,UAAU;IAqBlB,yEAAyE;IACzE,OAAO,CAAC,UAAU;CAkBnB"}

package/dist/commands/agents/eval.js

@@ -0,0 +1,70 @@
+import { readFileSync } from "node:fs";
+import { Flags } from "@oclif/core";
+import { parse as parseYaml } from "yaml";
+import { AuthenticatedCommand } from "../../AuthenticatedCommand.js";
+export default class Eval extends AuthenticatedCommand {
+    static description = "evaluate a VOICE_AI/EMAIL/WHATSAPP agent's conversation logic — either an existing " +
+        "template plus a scenarios file, or a standalone YAML eval template (agent definition " +
+        "plus its own embedded scenarios) that is never created. Streams each turn's result as " +
+        "it happens, then a final pass/fail summary; exits non-zero when the run fails. For a " +
+        "static SMS/VOICE_PRERECORDED render (no conversation), use `agents:preview` instead.";
+    static examples = [
+        "<%= config.bin %> <%= command.id %> --template-id <id> --scenarios scenarios.yaml",
+        "<%= config.bin %> <%= command.id %> --file eval-template.yaml"
+    ];
+    static flags = {
+        "template-id": Flags.string({ description: "an existing agent template id" }),
+        scenarios: Flags.string({
+            description: "path to a YAML file with the scenarios to run (used with --template-id)"
+        }),
+        file: Flags.string({
+            description: "path to a standalone YAML eval template (agent definition + embedded scenarios)"
+        })
+    };
+    async run() {
+        const { flags } = await this.parse(Eval);
+        const client = await this.createSdkClient();
+        let anyFailed = false;
+        for await (const event of client.agentEvaluations.evaluate(this.buildInput(flags))) {
+            anyFailed = this.printEvent(event) || anyFailed;
+        }
+        if (anyFailed)
+            this.exit(1);
+    }
+    buildInput(flags) {
+        if (flags.file) {
+            return { yaml: readFileSync(flags.file, "utf8") };
+        }
+        if (flags["template-id"] && flags.scenarios) {
+            const parsed = parseYaml(readFileSync(flags.scenarios, "utf8"));
+            const scenarios = Array.isArray(parsed)
+                ? parsed
+                : (parsed.scenarios ?? parsed);
+            return {
+                agentTemplateId: flags["template-id"],
+                scenarios: scenarios
+            };
+        }
+        return this.error("Provide --file, or both --template-id and --scenarios.", { exit: 1 });
+    }
+    /** Prints one evaluation event; returns true if it signals a failure. */
+    printEvent(event) {
+        if (event.type === "turn") {
+            const verdict = event.result.passed === undefined ? "" : event.result.passed ? " ✓" : " ✗";
+            const detail = event.result.action ?? event.result.aiResponse ?? event.result.input;
+            this.log(`[${event.scenarioRef}] turn ${event.result.turnIndex}: ${detail}${verdict}`);
+            return event.result.passed === false;
+        }
+        if (event.type === "scenarioSummary") {
+            this.log(`[${event.scenarioRef}] scenario ${event.overallPassed ? "PASSED" : "FAILED"}`);
+            return !event.overallPassed;
+        }
+        if (event.type === "summary") {
+            this.log(`Overall: ${event.verdict.toUpperCase()} (${event.scenarios.length} scenario(s))`);
+            return event.verdict === "fail";
+        }
+        this.log(`Error: ${event.message}`);
+        return true;
+    }
+}
+//# sourceMappingURL=eval.js.map