@skrr-ai/cli 0.1.8

package/dist/commands/triggers/replay.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const prompt_1 = require("../../lib/prompt");
+const triggers_1 = require("../../lib/triggers");
+class TriggersReplay extends base_command_1.BaseCommand {
+    static description = 'Replay a historical trigger fire with its original payload';
+    static examples = [
+        '<%= config.bin %> triggers replay <trigger-id> <fire-id>',
+        '<%= config.bin %> triggers replay <trigger-id> <fire-id> --from-json replay-options.json --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Trigger ID', required: true, ignoreStdin: true }),
+        fireId: core_1.Args.string({
+            description: 'Fire row _id or occurrenceId',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        'from-json': core_1.Flags.string({
+            description: 'Path to a JSON file (or "-" for stdin) to use as replay options',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TriggersReplay);
+        let body;
+        try {
+            body = await (0, prompt_1.readJsonBody)(flags['from-json']);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
+        let result;
+        try {
+            result = await triggers_1.triggerApi.replayFire(args.id, args.fireId, body);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        this.log(`Replay requested: ok=${String(result.ok ?? '-')} outcome=${String(result.outcome ?? '-')} reason=${String(result.reason ?? '-')}`);
+    }
+}
+exports.default = TriggersReplay;

package/dist/commands/triggers/rotate-secret.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+export default class TriggersRotateSecret extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/triggers/rotate-secret.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const triggers_1 = require("../../lib/triggers");
+class TriggersRotateSecret extends base_command_1.BaseCommand {
+    static description = 'Rotate the webhook secret for an on_demand, form, or chat_message trigger';
+    static examples = [
+        '<%= config.bin %> triggers rotate-secret <trigger-id>',
+        '<%= config.bin %> triggers rotate-secret <trigger-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Trigger ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TriggersRotateSecret);
+        let result;
+        try {
+            result = await triggers_1.triggerApi.rotateSecret(args.id);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        this.log(`Secret: ${String(result.secret ?? '-')}`);
+        this.log(String(result.note ?? 'Save this secret now; it cannot be retrieved later.'));
+        if (result.lastRotatedAt)
+            this.log(`Rotated at: ${String(result.lastRotatedAt)}`);
+    }
+}
+exports.default = TriggersRotateSecret;

package/dist/commands/triggers/runs.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * Legacy per-agent run history — backs the `AgentTriggerRun` collection that
+ * pre-dates the universal `TriggerFireRecord` audit log.
+ *
+ * Surfaced for back-compat debugging only. For triggers created after the
+ * universal engine cutover, use `skrr triggers audit <trigger-id>` instead —
+ * it covers every outcome (coalesced, debounced, capped, rate_limited, etc.)
+ * that the legacy table does not record.
+ */
+export default class TriggersRuns extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/triggers/runs.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const triggers_1 = require("../../lib/triggers");
+/**
+ * Legacy per-agent run history — backs the `AgentTriggerRun` collection that
+ * pre-dates the universal `TriggerFireRecord` audit log.
+ *
+ * Surfaced for back-compat debugging only. For triggers created after the
+ * universal engine cutover, use `skrr triggers audit <trigger-id>` instead —
+ * it covers every outcome (coalesced, debounced, capped, rate_limited, etc.)
+ * that the legacy table does not record.
+ */
+class TriggersRuns extends base_command_1.BaseCommand {
+    static description = 'List legacy AgentTriggerRun rows for a trigger (back-compat debugging — prefer `triggers audit`)';
+    static examples = [
+        '<%= config.bin %> triggers runs <trigger-id> --agent <agent-id>',
+        '<%= config.bin %> triggers runs <trigger-id> --agent <agent-id> --limit 50 --json',
+        '<%= config.bin %> triggers runs <trigger-id> --agent <agent-id> --cursor <next-cursor>',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Trigger ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        agent: core_1.Flags.string({
+            description: 'Agent ID the trigger belongs to (required — the legacy runs route is per-agent)',
+            required: true,
+        }),
+        limit: core_1.Flags.integer({ description: 'Maximum rows to return', default: 20 }),
+        cursor: core_1.Flags.string({
+            description: 'Pagination cursor returned as `next_cursor` from a previous call',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TriggersRuns);
+        let response;
+        try {
+            response = await triggers_1.triggerApi.legacyRuns(flags.agent, args.id, {
+                limit: flags.limit,
+                cursor: flags.cursor,
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        (0, triggers_1.renderLegacyRuns)(response.data ?? [], (line) => this.log(line));
+        if (response.has_more && response.next_cursor) {
+            this.log('');
+            this.log(`More rows available — pass --cursor "${response.next_cursor}" to continue.`);
+        }
+    }
+}
+exports.default = TriggersRuns;

package/dist/commands/triggers/show.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../../base-command';
+export default class TriggersShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/triggers/show.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const triggers_1 = require("../../lib/triggers");
+class TriggersShow extends base_command_1.BaseCommand {
+    static description = 'Show a universal trigger';
+    static examples = [
+        '<%= config.bin %> triggers show <trigger-id>',
+        '<%= config.bin %> triggers show <trigger-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Trigger ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TriggersShow);
+        let trigger;
+        try {
+            trigger = await triggers_1.triggerApi.get(args.id);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(trigger, null, 2));
+            return;
+        }
+        (0, triggers_1.renderTriggerSummary)(trigger, (line) => this.log(line));
+    }
+}
+exports.default = TriggersShow;

package/dist/commands/triggers/update.d.ts

@@ -0,0 +1,73 @@
+import { BaseCommand } from '../../base-command';
+export default class TriggersUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        label: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        enabled: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        mode: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        prompt: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'builtin-action': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'builtin-type': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'builtin-config': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'source-action': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'nudge-prompt': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        conversation: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        reference: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        references: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'working-hours': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'quiet-hours': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        cron: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'interval-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'interval-minutes': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'daily-time': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        timezone: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-fires-per-day': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-runs': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'end-at': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'stale-catchup-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        at: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        entity: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        event: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'filter-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'filter-field': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'filter-value': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'debounce-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-per-hour': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        probability: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'jitter-ms': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'eval-interval-minutes': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'next-run-at': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'form-title': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'form-subtitle': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'form-fields': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'form-response-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'thank-you-message': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'redirect-url': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'ip-allowlist': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'ignore-bots': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'submit-button-label': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'chat-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'chat-response-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'allowed-origin': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'allow-file-uploads': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'allowed-mime-types': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'initial-message': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'suggested-prompt': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'input-placeholder': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'auth-mode': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'load-previous-session': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'chat-title': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'chat-subtitle': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'concurrency-key': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'concurrency-policy': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'idempotency-window': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'allow-unknown-event': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/triggers/update.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const prompt_1 = require("../../lib/prompt");
+const triggers_1 = require("../../lib/triggers");
+class TriggersUpdate extends base_command_1.BaseCommand {
+    static description = 'Update a universal trigger';
+    static examples = [
+        '<%= config.bin %> triggers update <trigger-id> --label "Daily brief" --cron "0 8 * * *"',
+        '<%= config.bin %> triggers update <trigger-id> --no-enabled',
+        '<%= config.bin %> triggers update <trigger-id> --from-json patch.json --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Trigger ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        'from-json': core_1.Flags.string({
+            description: 'Path to a JSON file (or "-" for stdin) to use as the patch body',
+        }),
+        label: core_1.Flags.string({ description: 'Human-readable trigger label' }),
+        enabled: core_1.Flags.boolean({ description: 'Enable or disable the trigger', allowNo: true }),
+        mode: core_1.Flags.string({ description: 'Execution mode', options: [...triggers_1.TRIGGER_EXECUTOR_MODES] }),
+        prompt: core_1.Flags.string({ description: 'Prompt template sent when the trigger fires' }),
+        'builtin-action': core_1.Flags.string({
+            description: 'Typed builtinAction JSON object for mode=builtin_action',
+        }),
+        'builtin-type': core_1.Flags.string({ description: 'Built-in action subtype' }),
+        'builtin-config': core_1.Flags.string({ description: 'Built-in action config JSON object' }),
+        'source-action': core_1.Flags.string({ description: 'Source agent action ID for builtin_action' }),
+        'nudge-prompt': core_1.Flags.string({
+            description: 'Runtime text override for text-bearing built-ins',
+        }),
+        conversation: core_1.Flags.string({ description: 'Conversation ID for send_message execution' }),
+        reference: core_1.Flags.string({
+            description: 'Execution reference as kind:id[:label] (repeatable). Kinds: goal, task, space, groupChat',
+            multiple: true,
+        }),
+        references: core_1.Flags.string({ description: 'Execution references JSON array' }),
+        'working-hours': core_1.Flags.string({ description: 'Execution workingHours JSON object' }),
+        'quiet-hours': core_1.Flags.string({ description: 'Execution quietHours JSON object' }),
+        cron: core_1.Flags.string({ description: 'Cron expression for schedule triggers' }),
+        'interval-ms': core_1.Flags.integer({ description: 'Interval schedule period in milliseconds' }),
+        'interval-minutes': core_1.Flags.integer({ description: 'Interval schedule period in minutes' }),
+        'daily-time': core_1.Flags.string({
+            description: 'Daily HH:MM fire time for schedule triggers (repeatable or comma-separated)',
+            multiple: true,
+        }),
+        timezone: core_1.Flags.string({ description: 'IANA timezone for schedule triggers' }),
+        'max-fires-per-day': core_1.Flags.integer({ description: 'Daily fire cap' }),
+        'max-runs': core_1.Flags.integer({ description: 'Lifetime fire cap for schedule triggers' }),
+        'end-at': core_1.Flags.string({
+            description: 'ISO-8601 datetime after which a schedule stops firing',
+        }),
+        'stale-catchup-ms': core_1.Flags.integer({ description: 'Schedule stale catch-up window in ms' }),
+        at: core_1.Flags.string({ description: 'ISO-8601 datetime for once triggers' }),
+        entity: core_1.Flags.string({ description: 'Event entity type for event triggers' }),
+        event: core_1.Flags.string({ description: 'Event type for event triggers' }),
+        'filter-mode': core_1.Flags.string({
+            description: 'Event filter mode',
+            options: [...triggers_1.TRIGGER_EVENT_FILTER_MODES],
+        }),
+        'filter-field': core_1.Flags.string({ description: 'Event filter field path' }),
+        'filter-value': core_1.Flags.string({
+            description: 'Event filter value (repeatable or comma-separated)',
+            multiple: true,
+        }),
+        'debounce-ms': core_1.Flags.integer({ description: 'Event debounce in ms' }),
+        'max-per-hour': core_1.Flags.integer({ description: 'Event hourly cap' }),
+        probability: core_1.Flags.string({ description: 'Stochastic probability from 0 to 1' }),
+        'jitter-ms': core_1.Flags.integer({ description: 'Stochastic jitter in ms' }),
+        'eval-interval-minutes': core_1.Flags.integer({ description: 'Stochastic eval interval in minutes' }),
+        'next-run-at': core_1.Flags.string({ description: 'ISO datetime for self_scheduled triggers' }),
+        'form-title': core_1.Flags.string({ description: 'Form heading for form triggers' }),
+        'form-subtitle': core_1.Flags.string({ description: 'Form subtitle for form triggers' }),
+        'form-fields': core_1.Flags.string({ description: 'Form fields JSON array for form triggers' }),
+        'form-response-mode': core_1.Flags.string({
+            description: 'Form response mode',
+            options: [...triggers_1.TRIGGER_FORM_RESPONSE_MODES],
+        }),
+        'thank-you-message': core_1.Flags.string({ description: 'Thank-you message for form triggers' }),
+        'redirect-url': core_1.Flags.string({ description: 'Redirect URL for form triggers' }),
+        'ip-allowlist': core_1.Flags.string({
+            description: 'IP allowlist entry for form triggers (repeatable or comma-separated)',
+            multiple: true,
+        }),
+        'ignore-bots': core_1.Flags.boolean({
+            description: 'Ignore bot submissions for form triggers',
+            allowNo: true,
+        }),
+        'submit-button-label': core_1.Flags.string({ description: 'Submit button label for form triggers' }),
+        'chat-mode': core_1.Flags.string({
+            description: 'Chat trigger mode',
+            options: [...triggers_1.TRIGGER_CHAT_MODES],
+        }),
+        'chat-response-mode': core_1.Flags.string({
+            description: 'Chat response mode',
+            options: [...triggers_1.TRIGGER_CHAT_RESPONSE_MODES],
+        }),
+        'allowed-origin': core_1.Flags.string({
+            description: 'Allowed origin for embedded chat triggers (repeatable or comma-separated)',
+            multiple: true,
+        }),
+        'allow-file-uploads': core_1.Flags.boolean({
+            description: 'Allow file uploads for chat triggers',
+            allowNo: true,
+        }),
+        'allowed-mime-types': core_1.Flags.string({ description: 'Allowed MIME types for chat uploads' }),
+        'initial-message': core_1.Flags.string({
+            description: 'Initial chat message (repeatable or comma-separated)',
+            multiple: true,
+        }),
+        'suggested-prompt': core_1.Flags.string({
+            description: 'Suggested chat prompt (repeatable or comma-separated)',
+            multiple: true,
+        }),
+        'input-placeholder': core_1.Flags.string({ description: 'Chat input placeholder' }),
+        'auth-mode': core_1.Flags.string({
+            description: 'Chat auth mode',
+            options: [...triggers_1.TRIGGER_CHAT_AUTH_MODES],
+        }),
+        'load-previous-session': core_1.Flags.boolean({
+            description: 'Load previous chat session for chat triggers',
+            allowNo: true,
+        }),
+        'chat-title': core_1.Flags.string({ description: 'Chat trigger title' }),
+        'chat-subtitle': core_1.Flags.string({ description: 'Chat trigger subtitle' }),
+        'concurrency-key': core_1.Flags.string({ description: 'Concurrency key' }),
+        'concurrency-policy': core_1.Flags.string({
+            description: 'Concurrency policy',
+            options: [...triggers_1.TRIGGER_CONCURRENCY_POLICIES],
+        }),
+        'idempotency-window': core_1.Flags.integer({ description: 'Idempotency window in seconds' }),
+        'allow-unknown-event': core_1.Flags.boolean({
+            description: 'Skip the CLI-side check that --entity/--event are in the known catalog. ' +
+                'The server still validates. Use only when authoring against a newer server.',
+        }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(TriggersUpdate);
+        let payload;
+        try {
+            payload = await (0, prompt_1.readJsonBody)(flags['from-json']);
+            // Kind is immutable on update — see TriggerEditor.tsx and the server's
+            // PATCH schema, which silently strips unknown top-level fields. Fail
+            // fast here so the user gets a clear message instead of a silent no-op.
+            if (Object.prototype.hasOwnProperty.call(payload, 'kind')) {
+                throw new Error('Trigger kind cannot be changed after creation. ' +
+                    'Remove `kind` from --from-json, or delete and recreate the trigger.');
+            }
+            const execution = {};
+            const builtinAction = (0, triggers_1.buildBuiltinActionPayload)({
+                builtinAction: flags['builtin-action'],
+                builtinType: flags['builtin-type'],
+                builtinConfig: flags['builtin-config'],
+                sourceActionId: flags['source-action'],
+                nudgePrompt: flags['nudge-prompt'],
+            });
+            (0, triggers_1.setDefined)(execution, {
+                mode: flags.mode ?? (builtinAction ? 'builtin_action' : undefined),
+                promptTemplate: flags.prompt,
+                builtinAction,
+                conversationId: flags.conversation,
+                references: (0, triggers_1.parseExecutionReferences)(flags.reference, flags.references),
+                workingHours: (0, triggers_1.parseJsonObject)(flags['working-hours'], '--working-hours'),
+                quietHours: (0, triggers_1.parseJsonObject)(flags['quiet-hours'], '--quiet-hours'),
+            });
+            const schedule = (0, triggers_1.buildScheduleConfigFromFlags)(flags);
+            (0, triggers_1.assertScheduleTimingShape)(schedule);
+            const once = (0, triggers_1.buildOnceConfigFromFlags)(flags);
+            const filterValues = (0, triggers_1.splitRepeated)(flags['filter-value']);
+            // Consult the authoritative server catalog before warning about a local
+            // snapshot miss; server validation remains final when it is unavailable.
+            const eventCatalogWarning = (0, triggers_1.validateEventReference)(flags.entity, flags.event, {
+                allowUnknown: flags['allow-unknown-event'],
+            });
+            if (eventCatalogWarning) {
+                const serverCatalog = await triggers_1.triggerApi.eventCatalog().catch(() => undefined);
+                if (!(0, triggers_1.serverEventCatalogIncludes)(serverCatalog, flags.entity, flags.event)) {
+                    this.warn(eventCatalogWarning);
+                }
+            }
+            (0, triggers_1.validateEventFilter)({
+                filterMode: flags['filter-mode'],
+                filterField: flags['filter-field'],
+                filterValues,
+            });
+            const event = {};
+            (0, triggers_1.setDefined)(event, {
+                entityType: flags.entity,
+                eventType: flags.event,
+                filterMode: flags['filter-mode'],
+                filterField: flags['filter-field'],
+                filterValue: filterValues && filterValues.length > 1 ? filterValues : filterValues?.[0],
+                debounceMs: flags['debounce-ms'],
+                maxPerHour: flags['max-per-hour'],
+            });
+            const stochastic = {};
+            (0, triggers_1.setDefined)(stochastic, {
+                probability: flags.probability === undefined ? undefined : Number(flags.probability),
+                jitterMs: flags['jitter-ms'],
+                maxFiresPerDay: flags['max-fires-per-day'],
+                evalIntervalMinutes: flags['eval-interval-minutes'],
+            });
+            const selfScheduled = (0, triggers_1.buildSelfScheduledConfigFromFlags)(flags);
+            const form = (0, triggers_1.buildFormConfigFromFlags)(flags);
+            const chatMessage = (0, triggers_1.buildChatMessageConfigFromFlags)(flags);
+            (0, triggers_1.setDefined)(payload, {
+                label: flags.label,
+                enabled: flags.enabled,
+                concurrencyKey: flags['concurrency-key'],
+                concurrencyPolicy: flags['concurrency-policy'],
+                idempotencyWindow: flags['idempotency-window'],
+            });
+            (0, triggers_1.mergeObjectField)(payload, 'execution', execution);
+            (0, triggers_1.mergeObjectField)(payload, 'schedule', schedule);
+            (0, triggers_1.mergeObjectField)(payload, 'once', once);
+            (0, triggers_1.mergeObjectField)(payload, 'event', event);
+            // `kind` is immutable on update (rejected above), so there is no kind to
+            // gate on here; stochastic is only non-empty when stochastic flags were passed.
+            (0, triggers_1.mergeObjectField)(payload, 'stochastic', stochastic);
+            (0, triggers_1.mergeObjectField)(payload, 'selfScheduled', selfScheduled);
+            (0, triggers_1.mergeObjectField)(payload, 'form', form);
+            (0, triggers_1.mergeObjectField)(payload, 'chatMessage', chatMessage);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
+        if (Object.keys(payload).length === 0) {
+            this.error('Nothing to update. Pass at least one flag or --from-json.', { exit: 1 });
+        }
+        let trigger;
+        try {
+            trigger = await triggers_1.triggerApi.update(args.id, payload);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(trigger, null, 2));
+            return;
+        }
+        this.log('Updated trigger:');
+        (0, triggers_1.renderTriggerSummary)(trigger, (line) => this.log(line));
+    }
+}
+exports.default = TriggersUpdate;

package/dist/commands/usage.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../base-command';
+export default class Usage extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        domain: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        page: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    protected wantsJsonOutput(): boolean;
+}