@fonoster/ctl 0.27.0 → 0.31.0

package/dist/commands/webhooks/update.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const SDK = __importStar(require("@fonoster/sdk"));
+const core_1 = require("@oclif/core");
+const AuthenticatedCommand_1 = require("../../AuthenticatedCommand");
+const errorHandler_1 = __importDefault(require("../../errorHandler"));
+const webhookFlags_1 = require("../../utils/webhookFlags");
+class Update extends AuthenticatedCommand_1.AuthenticatedCommand {
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const { args, flags } = yield this.parse(Update);
+            if (!flags.url && !((_a = flags.event) === null || _a === void 0 ? void 0 : _a.length)) {
+                this.error("Nothing to update: pass --url and/or --event.");
+            }
+            try {
+                const client = yield this.createSdkClient();
+                const webhooks = new SDK.Webhooks(client);
+                yield webhooks.updateWebhook(Object.assign(Object.assign({ ref: args.ref }, (flags.url ? { url: flags.url } : {})), (((_b = flags.event) === null || _b === void 0 ? void 0 : _b.length) ? { events: flags.event } : {})));
+                this.log("Done!");
+            }
+            catch (e) {
+                (0, errorHandler_1.default)(e, this.error.bind(this));
+            }
+        });
+    }
+}
+Update.description = "change a Webhook's URL or events (--event replaces the list)";
+Update.examples = [
+    "<%= config.bin %> <%= command.id %> <ref> -e call.started -e call.ended",
+    "<%= config.bin %> <%= command.id %> <ref> --url https://example.com/new"
+];
+Update.args = {
+    ref: core_1.Args.string({ description: "the Webhook to update", required: true })
+};
+Update.flags = {
+    url: core_1.Flags.string({ char: "u", description: "the new endpoint" }),
+    event: (0, webhookFlags_1.eventFlag)(false)
+};
+exports.default = Update;

package/dist/commands/workspaces/login.d.ts

@@ -2,6 +2,11 @@ import { BaseCommand } from "../../BaseCommand";
 export default class Login extends BaseCommand<typeof Login> {
     static description: string;
     static examples: string[];
+    static flags: {
+        endpoint: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        "access-key-id": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        "access-key-secret": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
     run(): Promise<void>;
     private saveConfig;
     private getWorkspaceFromDB;

package/dist/commands/workspaces/login.js

@@ -62,6 +62,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 const SDK = __importStar(require("@fonoster/sdk"));
 const prompts_1 = require("@inquirer/prompts");
+const core_1 = require("@oclif/core");
 const BaseCommand_1 = require("../../BaseCommand");
 const config_1 = require("../../config");
 const saveConfig_1 = require("../../config/saveConfig");
@@ -69,12 +70,24 @@ const constants_1 = require("../../constants");
 class Login extends BaseCommand_1.BaseCommand {
     run() {
         return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { flags } = yield this.parse(Login);
+            if (flags["access-key-id"] && flags["access-key-secret"]) {
+                const answers = {
+                    endpoint: (_a = flags.endpoint) !== null && _a !== void 0 ? _a : "api.fonoster.ai",
+                    accessKeyId: flags["access-key-id"],
+                    accessKeySecret: flags["access-key-secret"]
+                };
+                const workspaceFromDB = yield this.getWorkspaceFromDB(answers);
+                this.saveConfig(Object.assign(Object.assign({}, answers), { workspaceAccessKeyId: workspaceFromDB.accessKeyId, ref: workspaceFromDB.ref, name: workspaceFromDB.name }));
+                return;
+            }
             this.log("This utility will help you add a Workspace.");
             this.log("Press ^C at any time to quit.");
             const answers = {
                 endpoint: yield (0, prompts_1.input)({
                     message: "Endpoint",
-                    default: "api.fonoster.com"
+                    default: "api.fonoster.ai"
                 }),
                 accessKeyId: yield (0, prompts_1.input)({
                     message: "Access Key Id",
@@ -140,5 +153,18 @@ class Login extends BaseCommand_1.BaseCommand {
     }
 }
 Login.description = "link a Workspace to the local environment";
-Login.examples = ["<%= config.bin %> <%= command.id %>"];
+Login.examples = [
+    "<%= config.bin %> <%= command.id %>",
+    "<%= config.bin %> <%= command.id %> --insecure --endpoint localhost:16449 --access-key-id WO... --access-key-secret ..."
+];
+Login.flags = {
+    endpoint: core_1.Flags.string({
+        char: "e",
+        description: "the API endpoint (skips the questions with the key flags)"
+    }),
+    "access-key-id": core_1.Flags.string({ description: "a Workspace API key id" }),
+    "access-key-secret": core_1.Flags.string({
+        description: "the API key secret"
+    })
+};
 exports.default = Login;

package/dist/constants.d.ts

@@ -1,6 +1,5 @@
 export declare const BASE_DIR: string;
 export declare const CONFIG_FILE: string;
 export declare const FONOSTER_ACCESS_CONTROL_LIST: string[];
-export declare const FONOSTER_ORIGINATION_URI_BASE = "pstn.fonoster.com";
 export declare const TWILIO_PSTN_URI_BASE = "pstn.twilio.com";
-export declare const WORKSPACE_ENDPOINT = "api.fonoster.com";
+export declare const WORKSPACE_ENDPOINT = "api.fonoster.ai";

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKSPACE_ENDPOINT = exports.TWILIO_PSTN_URI_BASE = exports.FONOSTER_ORIGINATION_URI_BASE = exports.FONOSTER_ACCESS_CONTROL_LIST = exports.CONFIG_FILE = exports.BASE_DIR = void 0;
+exports.WORKSPACE_ENDPOINT = exports.TWILIO_PSTN_URI_BASE = exports.FONOSTER_ACCESS_CONTROL_LIST = exports.CONFIG_FILE = exports.BASE_DIR = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -24,6 +24,5 @@ const path_1 = require("path");
 exports.BASE_DIR = (0, path_1.join)((0, os_1.homedir)(), ".fonoster");
 exports.CONFIG_FILE = (0, path_1.join)((0, os_1.homedir)(), ".fonoster", "config.json");
 exports.FONOSTER_ACCESS_CONTROL_LIST = ["165.22.7.155/32"]; // TODO: We will need to allow passing this as a parameter
-exports.FONOSTER_ORIGINATION_URI_BASE = "pstn.fonoster.com";
 exports.TWILIO_PSTN_URI_BASE = "pstn.twilio.com";
-exports.WORKSPACE_ENDPOINT = "api.fonoster.com";
+exports.WORKSPACE_ENDPOINT = "api.fonoster.ai";

package/dist/utils/applicationFlags.d.ts

@@ -0,0 +1,24 @@
+/** Flags shared by `applications:create` and `applications:update` (a stream or an Autopilot agent). */
+export declare const applicationFlags: {
+    "from-file": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    name: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    url: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    protocol: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    voice: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    language: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "stt-model": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "tts-model": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "silence-timeout": import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    patience: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "audio-codec": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "audio-rate": import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "fallback-app": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "fallback-message": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    listener: import("@oclif/core/lib/interfaces").OptionFlag<string[], import("@oclif/core/lib/interfaces").CustomOptions>;
+    "clear-listeners": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    recording: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+    amd: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    "amd-window": import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+    "noise-cancelling": import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+};

package/dist/utils/applicationFlags.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applicationFlags = void 0;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const core_1 = require("@oclif/core");
+/** Flags shared by `applications:create` and `applications:update` (a stream or an Autopilot agent). */
+exports.applicationFlags = {
+    "from-file": core_1.Flags.string({
+        char: "f",
+        description: "a YAML or JSON file with the Application (an `agent` key makes it an Autopilot agent)"
+    }),
+    name: core_1.Flags.string({ char: "n", description: "the Application name" }),
+    url: core_1.Flags.string({
+        char: "u",
+        description: "the stream's WebSocket URL (ws:// or wss://)"
+    }),
+    protocol: core_1.Flags.string({
+        description: "the protocol the stream speaks",
+        options: ["fonoster", "twilio"]
+    }),
+    agent: core_1.Flags.string({
+        char: "a",
+        description: "a YAML or JSON agent file; makes it an Autopilot agent (hosted by Fonoster)"
+    }),
+    voice: core_1.Flags.string({
+        description: "TTS voice as a catalog id (e.g. deepgram/aura-2-thalia-en)"
+    }),
+    language: core_1.Flags.string({ description: "speech language (e.g. en-US)" }),
+    "stt-model": core_1.Flags.string({
+        description: "STT model as a catalog id (e.g. deepgram/nova-3)"
+    }),
+    "tts-model": core_1.Flags.string({
+        description: "TTS model as a catalog id (e.g. elevenlabs/eleven_flash_v2_5)"
+    }),
+    "silence-timeout": core_1.Flags.integer({
+        description: "milliseconds of caller silence before a silence event"
+    }),
+    patience: core_1.Flags.string({
+        description: "how long to wait before taking the turn",
+        options: ["low", "normal", "high"]
+    }),
+    "audio-codec": core_1.Flags.string({
+        description: "audio frames for fonoster-protocol streams",
+        options: ["pcm16", "pcmu"]
+    }),
+    "audio-rate": core_1.Flags.integer({
+        description: "audio sample rate for fonoster-protocol streams: 8000, 16000 or 24000 (pcmu is 8000 only)"
+    }),
+    "fallback-app": core_1.Flags.string({
+        description: "the Application to hand the call to when this one fails"
+    }),
+    "fallback-message": core_1.Flags.string({
+        description: "what the caller hears when the app fails and no fallback app answers"
+    }),
+    listener: core_1.Flags.string({
+        char: "l",
+        description: "a listen-only socket: <wss-url>[,inbound|outbound|both] (repeatable, at most 4)",
+        multiple: true
+    }),
+    "clear-listeners": core_1.Flags.boolean({
+        description: "remove the current listeners (update; combine with --listener to replace)",
+        default: false
+    }),
+    recording: core_1.Flags.string({
+        description: "the recording policy",
+        options: ["off", "on", "consent"]
+    }),
+    amd: core_1.Flags.boolean({
+        description: "answering-machine detection: the app gets one amd.result per call (--no-amd turns it off)",
+        allowNo: true
+    }),
+    "amd-window": core_1.Flags.integer({
+        description: "milliseconds of caller audio AMD classifies (500 to 15000, default 4000); implies --amd"
+    }),
+    "noise-cancelling": core_1.Flags.string({
+        description: "noise cancelling on the caller's audio: none, or a noise-cancelling provider (aicoustics)"
+    })
+};

package/dist/utils/applicationRequest.d.ts

@@ -0,0 +1,42 @@
+import { Application, AppListener, CreateApplicationRequest } from "@fonoster/types";
+type ApplicationFlags = {
+    name?: string;
+    url?: string;
+    protocol?: string;
+    agent?: string;
+    voice?: string;
+    language?: string;
+    "stt-model"?: string;
+    "tts-model"?: string;
+    "silence-timeout"?: number;
+    patience?: string;
+    "audio-codec"?: string;
+    "audio-rate"?: number;
+    "fallback-app"?: string;
+    "fallback-message"?: string;
+    listener?: string[];
+    "clear-listeners"?: boolean;
+    recording?: string;
+    amd?: boolean;
+    "amd-window"?: number;
+    /** none, or an nc provider id (aicoustics). */
+    "noise-cancelling"?: string;
+};
+type AppRequest = CreateApplicationRequest & {
+    ref?: string;
+};
+/** Reads a YAML or JSON file into an object. */
+declare function readConfigFile<T = Record<string, unknown>>(filePath: string): T;
+/** `wss://host/path` or `wss://host/path,inbound` (tracks: inbound, outbound or both). */
+declare function parseListener(value: string): AppListener;
+/** An existing app as a create/update request (blank fields dropped). */
+declare function applicationToRequest(app: Application): AppRequest;
+/** A file in the new app model; `agent` (inline) makes it an Autopilot agent. */
+declare function fileToRequest(raw: Record<string, unknown>): AppRequest;
+/**
+ * Applies command flags on top of `base` (the current app on update, `{}` on create).
+ */
+declare function applyFlags(base: AppRequest, flags: ApplicationFlags): AppRequest;
+/** Throws the errors the control plane would, before a round trip. */
+declare function checkRequest(request: AppRequest): void;
+export { AppRequest, ApplicationFlags, applicationToRequest, applyFlags, checkRequest, fileToRequest, parseListener, readConfigFile };

package/dist/utils/applicationRequest.js

@@ -0,0 +1,215 @@
+"use strict";
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applicationToRequest = applicationToRequest;
+exports.applyFlags = applyFlags;
+exports.checkRequest = checkRequest;
+exports.fileToRequest = fileToRequest;
+exports.parseListener = parseListener;
+exports.readConfigFile = readConfigFile;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+const common_1 = require("@fonoster/common");
+const js_yaml_1 = require("js-yaml");
+const TRACKS = ["inbound", "outbound", "both"];
+/** Reads a YAML or JSON file into an object. */
+function readConfigFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, "utf8");
+    const ext = path_1.default.extname(filePath).toLowerCase();
+    if (ext === ".yaml" || ext === ".yml")
+        return (0, js_yaml_1.load)(content);
+    if (ext === ".json")
+        return JSON.parse(content);
+    throw new Error("Unsupported file format. Please use YAML or JSON files.");
+}
+/** `wss://host/path` or `wss://host/path,inbound` (tracks: inbound, outbound or both). */
+function parseListener(value) {
+    const comma = value.lastIndexOf(",");
+    const tail = comma > 0 ? value.slice(comma + 1).trim() : "";
+    if (comma > 0 && TRACKS.includes(tail)) {
+        return {
+            url: value.slice(0, comma).trim(),
+            tracks: tail
+        };
+    }
+    if (comma > 0 && tail && !tail.includes("/")) {
+        throw new Error(`invalid listener tracks "${tail}" (use inbound, outbound or both)`);
+    }
+    return { url: value.trim(), tracks: "both" };
+}
+function blank(value) {
+    return value === "" || value === 0 || value === null || value === undefined;
+}
+function compact(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => !blank(v)));
+}
+/** The LLM product the control plane files the agent under (`llm.<provider>`). */
+function intelligenceFor(agent) {
+    var _a;
+    const model = (_a = agent.languageModel) === null || _a === void 0 ? void 0 : _a.model;
+    return {
+        productRef: (model === null || model === void 0 ? void 0 : model.includes("/")) ? `llm.${model.split("/")[0]}` : "",
+        config: agent
+    };
+}
+/** An existing app as a create/update request (blank fields dropped). */
+function applicationToRequest(app) {
+    var _a, _b, _c, _d, _e, _f;
+    const request = {
+        name: app.name,
+        type: app.type,
+        protocol: (app.protocol || undefined),
+        speech: compact(Object.assign({}, ((_a = app.speech) !== null && _a !== void 0 ? _a : {}))),
+        audio: ((_b = app.audio) === null || _b === void 0 ? void 0 : _b.codec) ? app.audio : undefined,
+        fallbackAppRef: app.fallbackAppRef || undefined,
+        fallbackMessage: app.fallbackMessage || undefined,
+        listeners: (_c = app.listeners) !== null && _c !== void 0 ? _c : [],
+        recording: (app.recording || undefined),
+        amd: ((_d = app.amd) === null || _d === void 0 ? void 0 : _d.enabled)
+            ? compact({ enabled: true, windowMs: app.amd.windowMs })
+            : undefined,
+        filters: (_e = app.filters) !== null && _e !== void 0 ? _e : []
+    };
+    // Autopilot apps follow the operator's hosted Autopilot URL; only streams carry theirs.
+    if (app.type !== "AUTOPILOT")
+        request.url = app.url || app.endpoint;
+    const config = (_f = app.intelligence) === null || _f === void 0 ? void 0 : _f.config;
+    if (app.type === "AUTOPILOT" && config && Object.keys(config).length) {
+        request.intelligence = intelligenceFor(config);
+    }
+    return compact(request);
+}
+/** A file in the new app model; `agent` (inline) makes it an Autopilot agent. */
+function fileToRequest(raw) {
+    var _a, _b;
+    const _c = raw, { agent } = _c, rest = __rest(_c, ["agent"]);
+    const request = Object.assign({}, rest);
+    // Test cases belong to applications:eval, not to the app.
+    delete request.testCases;
+    if (agent) {
+        request.type = "AUTOPILOT";
+        request.intelligence = intelligenceFor(agent);
+    }
+    // Never send a model key that sits in an agent file; keys live in the vendor keys.
+    const lm = (_b = (_a = request.intelligence) === null || _a === void 0 ? void 0 : _a.config) === null || _b === void 0 ? void 0 : _b.languageModel;
+    if (lm)
+        delete lm.apiKey;
+    return request;
+}
+/**
+ * Applies command flags on top of `base` (the current app on update, `{}` on create).
+ */
+function applyFlags(base, flags) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const request = Object.assign(Object.assign({}, base), { speech: Object.assign({}, ((_a = base.speech) !== null && _a !== void 0 ? _a : {})), listeners: [...((_b = base.listeners) !== null && _b !== void 0 ? _b : [])] });
+    if (flags.name !== undefined)
+        request.name = flags.name;
+    if (flags.agent) {
+        const agent = readConfigFile(flags.agent);
+        request.type = "AUTOPILOT";
+        request.intelligence = fileToRequest({ agent }).intelligence;
+    }
+    if (flags.url !== undefined)
+        request.url = flags.url;
+    if (flags.protocol !== undefined)
+        request.protocol = flags.protocol;
+    const speech = request.speech;
+    if (flags.voice !== undefined)
+        speech.voice = flags.voice;
+    if (flags.language !== undefined)
+        speech.language = flags.language;
+    if (flags["stt-model"] !== undefined)
+        speech.sttModel = flags["stt-model"];
+    if (flags["tts-model"] !== undefined)
+        speech.ttsModel = flags["tts-model"];
+    if (flags["silence-timeout"] !== undefined)
+        speech.silenceTimeoutMs = flags["silence-timeout"];
+    if (flags.patience !== undefined)
+        speech.patience = flags.patience;
+    if (flags["audio-codec"] !== undefined || flags["audio-rate"] !== undefined) {
+        const codec = ((_e = (_c = flags["audio-codec"]) !== null && _c !== void 0 ? _c : (_d = request.audio) === null || _d === void 0 ? void 0 : _d.codec) !== null && _e !== void 0 ? _e : "pcm16");
+        const rate = (_f = flags["audio-rate"]) !== null && _f !== void 0 ? _f : (codec === "pcmu" ? 8000 : ((_h = (_g = request.audio) === null || _g === void 0 ? void 0 : _g.rate) !== null && _h !== void 0 ? _h : 16000));
+        request.audio = { codec, rate };
+    }
+    if (flags["fallback-app"] !== undefined)
+        request.fallbackAppRef = flags["fallback-app"];
+    if (flags["fallback-message"] !== undefined)
+        request.fallbackMessage = flags["fallback-message"];
+    if (flags["clear-listeners"])
+        request.listeners = [];
+    if ((_j = flags.listener) === null || _j === void 0 ? void 0 : _j.length) {
+        request.listeners = [
+            ...((_k = request.listeners) !== null && _k !== void 0 ? _k : []),
+            ...flags.listener.map(parseListener)
+        ];
+    }
+    if (flags.recording !== undefined)
+        request.recording = flags.recording;
+    if (flags.amd === false)
+        request.amd = undefined;
+    else if (flags.amd || flags["amd-window"] !== undefined) {
+        const windowMs = (_l = flags["amd-window"]) !== null && _l !== void 0 ? _l : (_m = request.amd) === null || _m === void 0 ? void 0 : _m.windowMs;
+        request.amd = windowMs ? { enabled: true, windowMs } : { enabled: true };
+    }
+    if (flags["noise-cancelling"] !== undefined)
+        request.filters = noiseCancellingFilters(flags["noise-cancelling"]);
+    if (!request.type)
+        request.type = "STREAM";
+    return request;
+}
+/** `--noise-cancelling none|<nc provider>` as the app's filters (one filter per provider). */
+function noiseCancellingFilters(value) {
+    const provider = value.trim().toLowerCase();
+    if (!provider || provider === "none" || provider === "off")
+        return [];
+    const name = common_1.AudioFilters.FILTER_BY_PROVIDER[provider];
+    if (!name)
+        throw new Error(`unknown noise-cancelling provider "${value}" (use none or ${Object.keys(common_1.AudioFilters.FILTER_BY_PROVIDER).join(", ")})`);
+    return [{ name }];
+}
+/** Throws the errors the control plane would, before a round trip. */
+function checkRequest(request) {
+    var _a;
+    if (!request.name)
+        throw new Error("a name is required (--name)");
+    if (request.type === "AUTOPILOT") {
+        if (!((_a = request.intelligence) === null || _a === void 0 ? void 0 : _a.config))
+            throw new Error("an Autopilot agent needs an agent file (--agent)");
+        if (request.protocol && request.protocol !== "fonoster")
+            throw new Error("Autopilot agents use the fonoster protocol");
+    }
+    else if (!request.url) {
+        throw new Error("a url is required (--url ws:// or wss://)");
+    }
+}

package/dist/utils/createOrUpdateApplication.d.ts

@@ -1,2 +1,27 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
 import * as SDK from "@fonoster/sdk";
-export declare function createOrUpdateApplication(client: SDK.Client, filePath: string, appRef?: string, isUpdate?: boolean): Promise<import("@fonoster/types").BaseApiObject>;
+import { CreateApplicationResponse } from "@fonoster/types";
+import { ApplicationFlags } from "./applicationRequest";
+/**
+ * Creates an app, or updates one, from an optional YAML/JSON file in the app model plus flags.
+ * An update starts from the current app (the control plane replaces the whole app), then the
+ * file, then the flags.
+ */
+export declare function createOrUpdateApplication(client: SDK.Client, filePath?: string, appRef?: string, isUpdate?: boolean, flags?: ApplicationFlags): Promise<CreateApplicationResponse>;