@codiac.io/codiac-cli 1.3.253 → 1.3.254

package/dist/apis/codiac-relay-nats/gen/contracts/types.gen.d.ts

@@ -16820,3 +16820,52 @@ export type AiAgentProvisionResult = {
     agent?: ProvisionedAgent;
     error?: ProvisionError;
 };
+export type ModelServeMode = "served" | "byo";
+export type ModelRuntimeTier = "cpu" | "gpu";
+export type ModelAttachSpec = {
+    kind: "existing" | "new" | "none";
+    agentName?: string;
+    framework?: string;
+};
+export type AiModelProvisionRequest = {
+    enterprise: string;
+    cabinet: string;
+    mode: ModelServeMode;
+    model?: string;
+    runtime?: ModelRuntimeTier;
+    baseUrl?: string;
+    key?: string;
+    attach?: ModelAttachSpec;
+    name?: string;
+    overrides?: Record<string, any>;
+    inputs?: Record<string, string>;
+    correlationId?: string;
+    socketId?: string;
+};
+export type ProvisionedModel = {
+    handle: string;
+    cabinet: string;
+    mode: ModelServeMode;
+    endpoint: string;
+    exposure: string;
+    status: string;
+};
+export type AiModelProvisionResult = {
+    status: "ok" | "needs_action" | "failed";
+    steps: Array<StepResult>;
+    nextAction?: Remediation;
+    model?: ProvisionedModel;
+    error?: ProvisionError;
+};
+export type AiModelListRequest = {
+    enterprise: string;
+    cabinet?: string;
+};
+export type AiModelAttachRequest = {
+    enterprise: string;
+    cabinet: string;
+    modelHandle: string;
+    agentName: string;
+    correlationId?: string;
+    socketId?: string;
+};

package/dist/commands/ai/model/attach.d.ts

@@ -0,0 +1,37 @@
+import { AtLeast } from '@codiac.io/codiac-common/contracts';
+import { RootMap } from '../../../apis/codiac-api/contracts';
+import { CommandBaseExec, IEnterpriseEntity } from '../../../command-base-exec';
+export type IModelAttachRequest = IEnterpriseEntity & {
+    enterprise: string;
+    cabinet: string;
+    /** Handle of the already-provisioned model to wire in. */
+    model: string;
+    /** Name of the already-installed agent to wire the model into. */
+    agent: string;
+};
+export default class AiModelAttach extends CommandBaseExec<IModelAttachRequest> {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        enterpriseCode: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        model: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        cabinet: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        silent: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        echo: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "to-script": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {};
+    protected adminOnly: boolean;
+    captureArgs(): Promise<[Partial<IModelAttachRequest>, boolean]>;
+    buildCandidate_silently(partial: AtLeast<IModelAttachRequest, "enterprise">, _rootMap: RootMap): Promise<IModelAttachRequest | undefined>;
+    buildCandidate_interactively(partial: AtLeast<IModelAttachRequest, "enterprise">, rootMap: RootMap, takeDefaults: boolean): Promise<IModelAttachRequest | undefined>;
+    buildCommandString(candidate: IModelAttachRequest, cmd: string[]): string[];
+    executeTask(candidate: IModelAttachRequest): Promise<void>;
+    private printStepResults;
+    private isSilentMode;
+}

package/dist/commands/ai/model/attach.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const _ = require("lodash");
+const command_base_exec_1 = require("../../../command-base-exec");
+class AiModelAttach extends command_base_exec_1.CommandBaseExec {
+    constructor() {
+        super(...arguments);
+        this.adminOnly = true;
+    }
+    captureArgs() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { flags } = yield this.parse(AiModelAttach);
+            let partial = {};
+            if (flags.enterpriseCode)
+                partial.enterprise = flags.enterpriseCode;
+            if (flags.model)
+                partial.model = flags.model.trim();
+            if (flags.agent)
+                partial.agent = flags.agent.trim();
+            if (flags.cabinet)
+                partial.cabinet = flags.cabinet;
+            return [partial, false];
+        });
+    }
+    buildCandidate_silently(partial, _rootMap) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (partial.model == undefined || _.isEmpty(partial.model))
+                throw new Error("Must specify a model handle (--model <handle>).");
+            if (partial.agent == undefined || _.isEmpty(partial.agent))
+                throw new Error("Must specify an agent name (--agent <name>).");
+            if (partial.cabinet == undefined || _.isEmpty(partial.cabinet))
+                throw new Error("Must specify cabinet (-c <cabinet>).");
+            return { enterprise: partial.enterprise, cabinet: partial.cabinet, model: partial.model, agent: partial.agent };
+        });
+    }
+    buildCandidate_interactively(partial, rootMap, takeDefaults) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            if (partial.model == undefined || _.isEmpty(partial.model)) {
+                const typed = yield this._ui.prompt('model', 'Handle of the model to wire in:', true);
+                partial.model = (typed !== null && typed !== void 0 ? typed : '').trim();
+            }
+            if (partial.agent == undefined || _.isEmpty(partial.agent)) {
+                const typed = yield this._ui.prompt('agent', 'Name of the agent to wire the model into:', true);
+                partial.agent = (typed !== null && typed !== void 0 ? typed : '').trim();
+            }
+            const [cabinet] = yield this.rootMapUtils.promptForCabinet(partial.enterprise, rootMap, partial.cabinet, takeDefaults, undefined, partial.cabinet);
+            partial.cabinet = cabinet.name;
+            // Redeploying the agent touches the cabinet's cluster — ensure the tenant's cloud creds first,
+            // the same gate `cod asset deploy` uses.
+            const cluster = rootMap.clusters.find(c => c.name === cabinet.cluster);
+            if (cluster == undefined)
+                throw new Error(`Cabinet [${cabinet.name}] has no recognized cluster [${cabinet.cluster}].`);
+            yield this.cspContextualizer.promptForCloudProviderCreds(this.ioc, cluster.provider, takeDefaults, undefined, undefined, cluster.providerSubscriptionId);
+            return this.buildCandidate_silently(partial, rootMap);
+        });
+    }
+    buildCommandString(candidate, cmd) {
+        cmd.push("-e", candidate.enterprise);
+        cmd.push("-m", candidate.model);
+        cmd.push("--agent", candidate.agent);
+        cmd.push("-c", candidate.cabinet);
+        cmd.push("--silent");
+        return cmd;
+    }
+    // NOTE: thin client over the SYNC `post.ai-model-attach`. The relay writes modelBaseUrl/modelApiKey
+    // ScopedSettings onto the agent asset + redeploys it; this only sends the request and drives the
+    // needs_action loop (e.g. NEEDS_AGENT_NAME). Unlike provision this is request/reply — no watcher.
+    executeTask(candidate) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            let agentName = candidate.agent;
+            const attemptedCodes = new Set();
+            while (true) {
+                const result = yield this.genRelayClient.Call.aiModelAttach({
+                    enterprise: candidate.enterprise,
+                    cabinet: candidate.cabinet,
+                    modelHandle: candidate.model,
+                    agentName,
+                });
+                if (result.error || !result.output) {
+                    const msg = `Error attaching model [${candidate.model}] to agent [${agentName}]: ${(_a = result.message) !== null && _a !== void 0 ? _a : ''} ${(_c = (_b = result.error) === null || _b === void 0 ? void 0 : _b.message) !== null && _c !== void 0 ? _c : ''}`.trimEnd();
+                    this.logger.error(msg, result.error);
+                    this._ui.userMessage(`${this._styler.colorCritical('ERROR!')} ${msg}`);
+                    throw (_d = result.error) !== null && _d !== void 0 ? _d : new Error(msg);
+                }
+                const out = result.output;
+                this.printStepResults(out.steps);
+                if (out.status === 'ok') {
+                    this._ui.userMessage(`${this._styler.colorGood('WIRED')} Model ${this._styler.hilite(candidate.model)} is attached to agent ${this._styler.hilite(agentName)} in cabinet [${candidate.cabinet}] (agent redeployed).`);
+                    return;
+                }
+                if (out.status === 'failed') {
+                    const msg = `Failed attaching model [${candidate.model}] to agent [${agentName}]: ${(_f = (_e = out.error) === null || _e === void 0 ? void 0 : _e.message) !== null && _f !== void 0 ? _f : ''}`.trimEnd();
+                    this.logger.notice(msg, out);
+                    this._ui.userMessage(`${this._styler.colorCritical('FAILED!')} ${msg}`);
+                    throw new Error(msg);
+                }
+                // status === 'needs_action' — the only expected code here is NEEDS_AGENT_NAME (bad/missing agent).
+                const rem = out.nextAction;
+                const needs = (_h = (_g = rem.resolvedBy) === null || _g === void 0 ? void 0 : _g.needs) !== null && _h !== void 0 ? _h : [];
+                if (this.isSilentMode()) {
+                    const missing = needs.map(f => f.name).join(', ');
+                    const hint = ((_j = rem.resolvedBy) === null || _j === void 0 ? void 0 : _j.cliCommand) ? ` Resolve with: ${rem.resolvedBy.cliCommand}` : '';
+                    throw new Error(`Cannot proceed in --silent mode: ${rem.reason}${missing ? ` (missing: ${missing})` : ''}.${hint}`);
+                }
+                if (needs.length > 0) {
+                    for (const f of needs) {
+                        const value = yield this._ui.prompt(f.name, `${rem.reason}\n${f.label}:`, true);
+                        // The one field attach can re-resolve is the agent name — update the request for the re-call.
+                        if (value != undefined && value.trim() !== "" && (f.name === 'agentName' || f.name === 'agent')) {
+                            agentName = value.trim();
+                        }
+                    }
+                }
+                else {
+                    this._ui.userMessage(this._styler.colorWarning(`Action needed (${rem.code}): ${rem.reason}`));
+                    if ((_k = rem.resolvedBy) === null || _k === void 0 ? void 0 : _k.cliCommand)
+                        this._ui.userMessage(`Resolve with:  ${this._styler.hilite(rem.resolvedBy.cliCommand)}`);
+                    const proceed = yield this._ui.promptConfirm('recheck', "Re-check after you've resolved this?", true);
+                    if (!proceed)
+                        return;
+                }
+                // Loop guard: same code twice with no new input → abort.
+                if (attemptedCodes.has(rem.code) && needs.length === 0) {
+                    const msg = `Still blocked on [${rem.code}]: ${rem.reason}`;
+                    this._ui.userMessage(this._styler.colorCritical(msg));
+                    throw new Error(msg);
+                }
+                attemptedCodes.add(rem.code);
+            }
+        });
+    }
+    printStepResults(steps) {
+        for (const s of steps !== null && steps !== void 0 ? steps : []) {
+            const line = s.detail ? `${s.step}: ${s.status} — ${s.detail}` : `${s.step}: ${s.status}`;
+            if (s.status === 'failed')
+                this._ui.userMessage(this._styler.colorCritical(line));
+            else if (s.status === 'blocked')
+                this._ui.userMessage(this._styler.colorWarning(line));
+            else
+                this._ui.userMessage(this._styler.colorGood(line));
+        }
+    }
+    isSilentMode() {
+        return this.argv.includes('--silent') || this.pipedInput != undefined;
+    }
+}
+exports.default = AiModelAttach;
+AiModelAttach.description = 'Wires an already-provisioned model into an already-installed agent (writes the model endpoint onto the agent and redeploys it so it uses the private model).';
+AiModelAttach.examples = [
+    {
+        description: 'Wire the qwen3-dev model into the hermes-agent in the dev cabinet.',
+        command: '<%= config.bin %> <%= command.id %> -e ben -m qwen3-dev --agent hermes-agent -c dev',
+    },
+    {
+        description: 'Non-interactive (scripted) invocation.',
+        command: '<%= config.bin %> <%= command.id %> -e ben -m qwen3-dev --agent hermes-agent -c dev --silent',
+    },
+];
+AiModelAttach.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+    enterpriseCode: core_1.Flags.string({ char: 'e', required: false, description: 'Code name identifying the target enterprise.' }),
+    model: core_1.Flags.string({ char: 'm', description: 'Handle of the provisioned model to wire in.' }),
+    agent: core_1.Flags.string({ description: 'Name of the already-installed agent to wire the model into.' }),
+    cabinet: core_1.Flags.string({ char: 'c', description: 'Cabinet the model and agent are deployed in.' }),
+    silent: core_1.Flags.boolean({ exclusive: ["echo", "to-script"], description: 'Executes without any user interaction; fails on missing or invalid arguments.' }),
+    echo: core_1.Flags.boolean({ exclusive: ["to-script", "silent"], description: 'Renders the equivalent non-interactive command for future use before executing.' }),
+    "to-script": core_1.Flags.boolean({ exclusive: ["echo", "silent"], description: 'Renders the equivalent non-interactive command without executing it.' }),
+};
+AiModelAttach.args = {};
+//# sourceMappingURL=attach.js.map

package/dist/commands/ai/model/attach.js.map

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

package/dist/commands/ai/model/install.d.ts

@@ -0,0 +1,105 @@
+import { AtLeast } from '@codiac.io/codiac-common/contracts';
+import { CommandBaseExec, IEnterpriseEntity } from '../../../command-base-exec';
+import { RootMap } from '../../../apis/codiac-api/contracts';
+import { RuntimeTier } from '../../../uilogic/model-spec';
+export type ModelSource = 'served' | 'byo';
+export type ModelAttachKind = 'existing' | 'new' | 'none';
+export interface IModelInstallRequest extends IEnterpriseEntity {
+    enterprise: string;
+    cabinet: string;
+    /** Whether to serve a catalog model in-cluster, or register a BYO OpenAI-compatible endpoint. */
+    source: ModelSource;
+    /** Catalog model kind (e.g. "qwen3") — required when source==="served". */
+    model?: string;
+    /** Compute tier for a served model — required when source==="served". */
+    runtime?: RuntimeTier;
+    /** OpenAI-compatible endpoint — required when source==="byo". */
+    baseUrl?: string;
+    /** API key for the BYO endpoint (stored as a secret server-side). */
+    key?: string;
+    /** How (and whether) to wire the model to an agent once it is ready. */
+    attach: ModelAttachKind;
+    /** Name of the agent to attach to — required when attach==="existing". */
+    agent?: string;
+    /** Agent framework to install and wire — required when attach==="new". */
+    framework?: string;
+    /** Optional handle for the model (server-assigned when omitted). */
+    name?: string;
+    /** Pre-supplied needs_action inputs (from --input key=value), threaded onto the candidate so
+     *  executeTask never re-parses flags. */
+    inputs?: Record<string, string>;
+}
+export default class AiModelInstall extends CommandBaseExec<IModelInstallRequest> {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        enterpriseCode: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        source: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        model: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        runtime: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        'base-url': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        key: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        cabinet: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        name: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        attach: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        framework: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        input: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        "take-defaults": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        silent: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        echo: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "to-script": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {};
+    protected adminOnly: boolean;
+    captureArgs(): Promise<[
+        partial: Partial<IModelInstallRequest>,
+        takeDefaults: boolean,
+        explicit?: Partial<IModelInstallRequest>
+    ]>;
+    buildCandidate_silently(partial: AtLeast<IModelInstallRequest, "enterprise">, _rootMap: RootMap, _explicit?: Partial<IModelInstallRequest>): Promise<IModelInstallRequest | undefined>;
+    buildCandidate_interactively(partial: AtLeast<IModelInstallRequest, "enterprise">, rootMap: RootMap, takeDefaults: boolean, explicit?: Partial<IModelInstallRequest>): Promise<IModelInstallRequest | undefined>;
+    private setSource;
+    private setModel;
+    private setRuntime;
+    private setAttach;
+    private setAgent;
+    private setFramework;
+    private setBaseUrl;
+    private setKey;
+    private setName;
+    buildCommandString(candidate: IModelInstallRequest, cmd: string[]): string[];
+    executeTask(candidate: IModelInstallRequest): Promise<void>;
+    /** Maps the resolved candidate (plus any remediation inputs gathered so far) to the
+     *  `post.ai-model-provision` request shape. */
+    private toProvisionRequest;
+    /** attach === 'new': installs a fresh agent already wired to the just-provisioned model, entirely
+     *  CLI-side (no new relay endpoint) — it reuses the existing `aiAgentProvision` op, threading the
+     *  model's endpoint through `overrides` as the `modelBaseUrl`/`modelApiKey` chart values the
+     *  hermes chart consumes. Runs the same ack-then-stream needs_action loop shape as `cod ai agent
+     *  install`. Never exposes ingress (`hasIngress:false`) so the wiring cannot demand a host-naming
+     *  strategy — the wiring is env-only and must succeed headlessly; the agent still reaches the
+     *  model in-cluster. */
+    private wireNewAgent;
+    /** Derives the fresh agent's name from its framework — the framework's catalog default name
+     *  (e.g. hermes → "hermes-agent") when known, else "<framework>-agent". */
+    private deriveAgentName;
+    /** Best-effort note about the freshly wired agent — prefers the server-resolved URL, else states
+     *  it is reachable in-cluster (attach=new never requests ingress). */
+    private printAgentInfo;
+    /** Adds code-specific guidance ahead of the generic needs/consent handling for the model-side
+     *  remediation codes. */
+    private renderRemediationGuidance;
+    /** One line per step: `<step>: <status>` (+ detail when present). */
+    private printStepResults;
+    /** Prints the ready model's handle + in-cluster (or BYO) endpoint. */
+    private printModelInfo;
+    /** Silent mode disables all prompting (the base lifecycle rebinds `_ui` to a throwing
+     *  provider) — mirrors the same detection `CommandBaseExec.runAsync()` uses, so a
+     *  `needs_action` response can fail fast with a clear message. */
+    private isSilentMode;
+}