@sonisoft/now-sdk-ext-cli 5.2.0 → 5.4.0

package/dist/commands/flow/definition.d.ts

@@ -0,0 +1,31 @@
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export declare class FlowDefinition extends AuthenticatedCommand<typeof FlowDefinition> {
+    static args: {};
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static flags: {
+        'sys-id': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        type: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<"action" | "flow" | "subflow", import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    /**
+     * Fail with the reason core classified, plus the remediation that goes with it.
+     *
+     * Only the failure classification and the message core produced are logged —
+     * never the response body.
+     */
+    private _failDefinition;
+    /**
+     * Call the one core method that matches the requested type.
+     *
+     * Each type maps to exactly one design-time read. Nothing here executes,
+     * tests, publishes or creates a context.
+     */
+    private _retrieve;
+}
+//# sourceMappingURL=definition.d.ts.map

package/dist/commands/flow/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../src/commands/flow/definition.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA;AAkD5E,qBAAa,cAAe,SAAQ,oBAAoB,CAAC,OAAO,cAAc,CAAC;IAE7E,MAAM,CAAC,IAAI,KAAK;IAChB,MAAM,CAAC,WAAW,SAa4C;IAC9D,MAAM,CAAC,QAAQ;;;QAqBd;IACD,MAAM,CAAC,KAAK;;;;;MAwBX;IAEK,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B1B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAevB;;;;;OAKG;YACW,SAAS;CA6BxB"}

package/dist/commands/flow/definition.js

@@ -0,0 +1,166 @@
+/* eslint-disable perfectionist/sort-objects */
+import { Flags } from '@oclif/core';
+import { FlowManager } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { FlowDisplayService } from '../../services/flow-display.service.js';
+/**
+ * Remediation per machine-readable failure reason. Core classifies the failure;
+ * the CLI is the only layer that knows which flag would have avoided it.
+ */
+const REMEDIATION = {
+    api_error: [
+        'ServiceNow answered with an error. Re-run with --log-level debug to see the request detail.',
+        'If the artifact lives in a scoped application, pass --scope with its scope sys_id or name.',
+    ],
+    invalid_identifier: [
+        'Pass the 32-character sys_id of the artifact, not its name.',
+        'The sys_id is in the sys_id= parameter of the Workflow Studio URL, or in the record list.',
+    ],
+    malformed_response: [
+        'The instance returned a body this version does not recognise.',
+        'Check that Flow Designer is active on the instance and that the family version is supported.',
+    ],
+    not_found: [
+        'Confirm the sys_id exists on this instance — and that --auth points at the instance you meant.',
+        'A deleted or not-yet-deployed artifact reports the same way as a wrong sys_id.',
+    ],
+    permission_denied: [
+        'The authenticated user needs read access to Flow Designer design-time records.',
+        'Retry with an account holding the flow_designer (or admin) role.',
+    ],
+    request_failed: [
+        'The request did not complete. Check connectivity and the instance URL for this alias.',
+        'Run "nex auth doctor" to confirm the credential resolves.',
+    ],
+    type_mismatch: [
+        'The sys_id exists but is a different artifact type than the one requested.',
+        'Retry with the matching --type: flow, subflow, or action.',
+    ],
+};
+export class FlowDefinition extends AuthenticatedCommand {
+    static args = {};
+    static description = 'Retrieve the read-only design-time definition of a flow, subflow, or action.\n\n' +
+        'Returns what the artifact IS, not what a run of it did: triggers, actions, ' +
+        'nested subflows, flow logic, inputs and outputs as Workflow Studio stores ' +
+        'them. Nothing is executed, published or modified, and no flow context is ' +
+        'created or required.\n\n' +
+        'This is the design-time counterpart to `flow details`, which describes one ' +
+        'past execution and needs a context sys_id.\n\n' +
+        'The type is never inferred from the sys_id: --type selects the artifact ' +
+        'that is asked for, and a sys_id of a different type fails with a ' +
+        'type_mismatch rather than being relabelled.\n\n' +
+        'With --json, stdout carries exactly one JSON document — the complete typed ' +
+        'result including the untouched ServiceNow payload — so it can be piped or ' +
+        'redirected. Without it, a short summary is printed; definition bodies, ' +
+        'step scripts and input values are never printed or logged.';
+    static examples = [
+        {
+            description: 'Summarise a flow definition',
+            command: '<%= config.bin %> <%= command.id %> --sys-id 887dda5583237210fdb8f7b6feaad32c --auth dev',
+        },
+        {
+            description: 'Retrieve a subflow definition',
+            command: '<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type subflow --auth dev',
+        },
+        {
+            description: 'Retrieve a custom action definition with its ordered steps',
+            command: '<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --auth dev',
+        },
+        {
+            description: 'Redirect the full JSON definition to a file',
+            command: '<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --json --auth dev > flow.json',
+        },
+        {
+            description: 'Pipe the JSON definition into another tool',
+            command: '<%= config.bin %> <%= command.id %> -i 887dda5583237210fdb8f7b6feaad32c --type action --json --auth dev | jq .summary.steps',
+        },
+    ];
+    static flags = {
+        'sys-id': Flags.string({
+            char: 'i',
+            description: 'sys_id of the flow, subflow, or action to retrieve',
+            required: true,
+        }),
+        'type': Flags.option({
+            char: 't',
+            description: 'Artifact type to retrieve. Must match what the sys_id actually is.',
+            required: false,
+            default: 'flow',
+            options: ['flow', 'subflow', 'action'],
+        })(),
+        'scope': Flags.string({
+            description: 'Scope sys_id or name for the transaction scope parameter. ' +
+                "Optional — ServiceNow resolves the artifact's own scope when omitted.",
+            required: false,
+        }),
+        'json': Flags.boolean({
+            char: 'j',
+            description: 'Output the complete typed result as JSON',
+            required: false,
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FlowDefinition);
+        const displayService = new FlowDisplayService();
+        const artifact = flags.type;
+        const sysId = flags['sys-id'];
+        // Progress goes through this.log, which oclif suppresses under --json — that
+        // is what keeps stdout to a single JSON document for piping.
+        this.log(`Retrieving ${artifact} definition: ${sysId}`);
+        const outcome = await this._retrieve(artifact, sysId, flags.scope);
+        if (!outcome.result.success) {
+            this._failDefinition(artifact, sysId, outcome.result);
+        }
+        const lines = outcome.artifact === 'action'
+            ? displayService.formatActionDefinitionResult(outcome.result, flags.json)
+            : displayService.formatArtifactDefinitionResult(outcome.result, flags.json);
+        for (const line of lines) {
+            flags.json ? console.log(line) : this.log(line);
+        }
+    }
+    /**
+     * Fail with the reason core classified, plus the remediation that goes with it.
+     *
+     * Only the failure classification and the message core produced are logged —
+     * never the response body.
+     */
+    _failDefinition(artifact, sysId, result) {
+        const reason = result.failureReason ?? 'request_failed';
+        const detail = result.errorMessage ?? `ServiceNow did not return a ${artifact} definition.`;
+        this._logger.error('Design-time definition retrieval failed.', { artifact, failureReason: reason, sysId });
+        this.error(`Could not retrieve the ${artifact} definition for ${sysId} [${reason}]: ${detail}`, {
+            suggestions: REMEDIATION[reason] ?? REMEDIATION.request_failed,
+        });
+    }
+    /**
+     * Call the one core method that matches the requested type.
+     *
+     * Each type maps to exactly one design-time read. Nothing here executes,
+     * tests, publishes or creates a context.
+     */
+    async _retrieve(artifact, sysId, scope) {
+        // No scope in the constructor: the design-time routes take the transaction
+        // scope as a request option, not through a background script.
+        const flowManager = new FlowManager(this.instance);
+        const options = scope ? { scope } : undefined;
+        try {
+            switch (artifact) {
+                case 'action': {
+                    return { artifact, result: await flowManager.getActionDefinition(sysId, options) };
+                }
+                case 'subflow': {
+                    return { artifact, result: await flowManager.getSubflowDefinition(sysId, options) };
+                }
+                default: {
+                    return { artifact, result: await flowManager.getFlowDesignDefinition(sysId, options) };
+                }
+            }
+        }
+        catch (error) {
+            this._logger.error('Error retrieving flow design-time definition.', error);
+            return this.error(error);
+        }
+    }
+}
+//# sourceMappingURL=definition.js.map

package/dist/commands/flow/definition.js.map

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

package/dist/commands/transaction/kill.d.ts

@@ -0,0 +1,12 @@
+import { type KillTransactionResult } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export default class TransactionKill extends AuthenticatedCommand<typeof TransactionKill> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        confirm: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'transaction-id': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<KillTransactionResult>;
+}
+//# sourceMappingURL=kill.d.ts.map

package/dist/commands/transaction/kill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.d.ts","sourceRoot":"","sources":["../../../src/commands/transaction/kill.ts"],"names":[],"mappings":"AACA,OAAO,EAA6C,KAAK,qBAAqB,EAAC,MAAM,4BAA4B,CAAA;AAEjH,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAA;AAE1E,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,oBAAoB,CAAC,OAAO,eAAe,CAAC;IACvF,MAAM,CAAC,WAAW,SAGuC;IACzD,MAAM,CAAC,QAAQ,WAGd;IACD,MAAM,CAAC,KAAK;;;MAOX;IAEY,GAAG,IAAI,OAAO,CAAC,qBAAqB,CAAC;CA8BnD"}

package/dist/commands/transaction/kill.js

@@ -0,0 +1,48 @@
+import { Flags } from '@oclif/core';
+import { ClusterTransactionManager, isPolicyRefusal } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+export default class TransactionKill extends AuthenticatedCommand {
+    static description = 'Submit a request to terminate one active transaction. Platform acceptance does not mean immediate removal.\n\n' +
+        'Only pass an identifier you deliberately selected from `nex transaction list`. ' +
+        "Killing another user's transaction aborts their work.";
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --auth dev',
+        '<%= config.bin %> <%= command.id %> --transaction-id 8f9a1234567890abcdef1234567890c1 --confirm --json --auth dev',
+    ];
+    static flags = {
+        confirm: Flags.boolean({ description: 'Confirm submission of the kill request.' }),
+        'transaction-id': Flags.string({
+            char: 't',
+            description: 'Exact 32-character hexadecimal sys_id from `nex transaction list`.',
+            required: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(TransactionKill);
+        const transactionId = flags['transaction-id'].trim();
+        if (!/^[0-9a-f]{32}$/i.test(transactionId)) {
+            this.error('--transaction-id must be exactly 32 hexadecimal characters.');
+        }
+        if (!flags.confirm) {
+            this.error('Refusing to submit a transaction kill request without --confirm.', {
+                suggestions: ['Deliberately select an identifier, then rerun this command with --confirm.'],
+            });
+        }
+        try {
+            const result = await new ClusterTransactionManager(this.instance).killTransaction(transactionId);
+            this._logger.info('Transaction kill request accepted.', { sysId: result.sysId });
+            if (!this.jsonEnabled()) {
+                this.log(`Kill request accepted by the platform for transaction ${result.sysId}.`);
+                this.log('The transaction may take a moment to clear. Run `nex transaction list` again to confirm.');
+            }
+            return result;
+        }
+        catch (error) {
+            this._logger.error('Transaction kill request failed.', error);
+            if (isPolicyRefusal(error))
+                throw error;
+            this.error(error, { suggestions: ['Verify the selected transaction identifier and instance permissions.'] });
+        }
+    }
+}
+//# sourceMappingURL=kill.js.map

package/dist/commands/transaction/kill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill.js","sourceRoot":"","sources":["../../../src/commands/transaction/kill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,aAAa,CAAA;AACjC,OAAO,EAAC,yBAAyB,EAAE,eAAe,EAA6B,MAAM,4BAA4B,CAAA;AAEjH,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAA;AAE1E,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,oBAA4C;IACvF,MAAM,CAAC,WAAW,GAChB,gHAAgH;QAChH,iFAAiF;QACjF,uDAAuD,CAAA;IACzD,MAAM,CAAC,QAAQ,GAAG;QAChB,4GAA4G;QAC5G,mHAAmH;KACpH,CAAA;IACD,MAAM,CAAC,KAAK,GAAG;QACb,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,EAAC,WAAW,EAAE,yCAAyC,EAAC,CAAC;QAChF,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC;YAC7B,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,oEAAoE;YACjF,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAA;QACjD,MAAM,aAAa,GAAG,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAA;QAEpD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAA;QAC3E,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,CAAC,kEAAkE,EAAE;gBAC7E,WAAW,EAAE,CAAC,4EAA4E,CAAC;aAC5F,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;YAChG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAE,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAC,CAAC,CAAA;YAE9E,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CAAC,yDAAyD,MAAM,CAAC,KAAK,GAAG,CAAC,CAAA;gBAClF,IAAI,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAA;YACtG,CAAC;YAED,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAc,CAAC,CAAA;YACtE,IAAI,eAAe,CAAC,KAAK,CAAC;gBAAE,MAAM,KAAK,CAAA;YACvC,IAAI,CAAC,KAAK,CAAC,KAAc,EAAE,EAAC,WAAW,EAAE,CAAC,sEAAsE,CAAC,EAAC,CAAC,CAAA;QACrH,CAAC;IACH,CAAC"}

package/dist/commands/transaction/list.d.ts

@@ -0,0 +1,20 @@
+import { type ClusterTransaction } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+type TransactionListResult = {
+    count: number;
+    transactions: ClusterTransaction[];
+};
+export default class TransactionList extends AuthenticatedCommand<typeof TransactionList> {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        limit: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'poll-interval-ms': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        query: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'timeout-ms': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+    };
+    run(): Promise<TransactionListResult>;
+    private validateFlags;
+}
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/transaction/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/transaction/list.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAA;AAG1E,KAAK,qBAAqB,GAAG;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,kBAAkB,EAAE,CAAA;CAAC,CAAA;AAEhF,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,oBAAoB,CAAC,OAAO,eAAe,CAAC;IACvF,MAAM,CAAC,WAAW,SAA2E;IAC7F,MAAM,CAAC,QAAQ,WAKd;IACD,MAAM,CAAC,KAAK;;;;;MAKX;IAEY,GAAG,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAkClD,OAAO,CAAC,aAAa;CAatB"}

package/dist/commands/transaction/list.js

@@ -0,0 +1,64 @@
+import { Flags } from '@oclif/core';
+import { ClusterTransactionManager, isPolicyRefusal, } from '@sonisoft/now-sdk-ext-core';
+import { AuthenticatedCommand } from '../../common/authenticated-command.js';
+import { TransactionDisplayService } from '../../services/transaction-display.service.js';
+export default class TransactionList extends AuthenticatedCommand {
+    static description = 'List active transactions from all responding ServiceNow cluster nodes.';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --auth dev',
+        '<%= config.bin %> <%= command.id %> --json --auth dev',
+        '<%= config.bin %> <%= command.id %> --query "user=admin" --limit 50 --auth dev',
+        '<%= config.bin %> <%= command.id %> --timeout-ms 120000 --poll-interval-ms 2000 --auth dev',
+    ];
+    static flags = {
+        limit: Flags.integer({ char: 'l', description: 'Maximum transactions to return. Core default: 1000.' }),
+        'poll-interval-ms': Flags.integer({ description: 'Interval between collection status polls. Core default: 1000.' }),
+        query: Flags.string({ char: 'q', description: 'Encoded query used to filter transactions. Core default: none.' }),
+        'timeout-ms': Flags.integer({ description: 'Collection timeout in milliseconds. Core default: 60000.' }),
+    };
+    async run() {
+        const { flags } = await this.parse(TransactionList);
+        this.validateFlags(flags);
+        const controller = new AbortController();
+        const onSigint = () => controller.abort();
+        process.once('SIGINT', onSigint);
+        try {
+            const options = {
+                signal: controller.signal,
+                ...(flags['poll-interval-ms'] === undefined ? {} : { pollIntervalMs: flags['poll-interval-ms'] }),
+                ...(flags['timeout-ms'] === undefined ? {} : { timeoutMs: flags['timeout-ms'] }),
+                ...(flags.limit === undefined ? {} : { limit: flags.limit }),
+                ...(flags.query === undefined ? {} : { query: flags.query }),
+            };
+            const transactions = await new ClusterTransactionManager(this.instance).getTransactions(options);
+            this._logger.info('Active transaction collection completed.', { count: transactions.length });
+            if (!this.jsonEnabled()) {
+                const display = new TransactionDisplayService();
+                for (const line of display.formatTransactions(transactions))
+                    this.log(line);
+            }
+            return { count: transactions.length, transactions };
+        }
+        catch (error) {
+            this._logger.error('Active transaction collection failed.', error);
+            if (isPolicyRefusal(error))
+                throw error;
+            this.error(error, { suggestions: ['Check authentication and collection timeout settings, then try again.'] });
+        }
+        finally {
+            process.off('SIGINT', onSigint);
+        }
+    }
+    validateFlags(flags) {
+        if (flags['poll-interval-ms'] !== undefined && (!Number.isFinite(flags['poll-interval-ms']) || flags['poll-interval-ms'] < 0)) {
+            this.error('--poll-interval-ms must be a non-negative integer.');
+        }
+        if (flags['timeout-ms'] !== undefined && (!Number.isFinite(flags['timeout-ms']) || flags['timeout-ms'] < 0)) {
+            this.error('--timeout-ms must be a non-negative integer.');
+        }
+        if (flags.limit !== undefined && (!Number.isInteger(flags.limit) || flags.limit <= 0)) {
+            this.error('--limit must be a positive integer.');
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/transaction/list.js.map

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

package/dist/services/flow-display.service.d.ts

@@ -1,4 +1,4 @@
-import type { FlowContextDetailsResult, FlowLogResult } from '@sonisoft/now-sdk-ext-core';
+import type { ActionDefinitionResult, FlowArtifactDefinitionResult, FlowContextDetailsResult, FlowLogResult } from '@sonisoft/now-sdk-ext-core';
 export interface FlowCopyResult {
     success: boolean;
     newFlowSysId?: string;
@@ -14,6 +14,24 @@ export interface FlowTestResult {
     errorMessage?: string;
 }
 export declare class FlowDisplayService {
+    /** Widest description the one-line summary will print before eliding. */
+    private static readonly DESCRIPTION_MAX_LENGTH;
+    /**
+     * Render an action design-time definition: metadata plus ordered steps.
+     *
+     * As with a flow definition, only the summary projection is printed — the raw
+     * `metadata`/`steps` payloads stay on the JSON path.
+     */
+    formatActionDefinitionResult(result: ActionDefinitionResult, jsonOutput: boolean): string[];
+    /**
+     * Render a flow or subflow design-time definition.
+     *
+     * The JSON form is the whole typed core result, opaque `definition` payload
+     * included, so it can be piped or redirected straight into a file. The text
+     * form deliberately renders only the summary projection: the definition body
+     * carries step scripts and input values, which do not belong on a terminal.
+     */
+    formatArtifactDefinitionResult(result: FlowArtifactDefinitionResult, jsonOutput: boolean): string[];
     formatCopyResult(result: FlowCopyResult, jsonOutput: boolean): string[];
     formatCancelResult(result: any, jsonOutput: boolean): string[];
     formatErrorResult(result: any, jsonOutput: boolean): string[];
@@ -24,7 +42,18 @@ export declare class FlowDisplayService {
     formatTestResult(result: FlowTestResult, jsonOutput: boolean): string[];
     formatDetailsResult(result: FlowContextDetailsResult, jsonOutput: boolean): string[];
     formatLogsResult(result: FlowLogResult, jsonOutput: boolean): string[];
+    private _artifactLabel;
     private _mapLogLevel;
     private _stateIcon;
+    /**
+     * Reduce a design-time description to one summary line.
+     *
+     * Workflow Studio stores the description as authored, which for a shipped
+     * subflow is frequently a block of HTML hundreds of characters long. Printing
+     * it verbatim buries the counts underneath it, so the tags come out, the
+     * whitespace collapses, and anything past the cutoff is elided. The full text
+     * is never lost \u2014 it is on the `--json` path, untouched.
+     */
+    private _summaryDescription;
 }
 //# sourceMappingURL=flow-display.service.d.ts.map

package/dist/services/flow-display.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-display.service.d.ts","sourceRoot":"","sources":["../../src/services/flow-display.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAEzF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoCvE,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoB9D,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAwB7D,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IA6CjE,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoB/D,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IA4B/D,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAwC9D,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAuCvE,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAqGpF,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAmCtE,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,UAAU;CAwBnB"}
+{"version":3,"file":"flow-display.service.d.ts","sourceRoot":"","sources":["../../src/services/flow-display.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAE/I,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,kBAAkB;IAC7B,yEAAyE;IACzE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAO;IAErD;;;;;OAKG;IACH,4BAA4B,CAAC,MAAM,EAAE,sBAAsB,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoD3F;;;;;;;OAOG;IACH,8BAA8B,CAAC,MAAM,EAAE,4BAA4B,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAiDnG,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoCvE,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoB9D,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAwB7D,qBAAqB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IA6CjE,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAoB/D,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IA4B/D,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAwC9D,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAuCvE,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAqGpF,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE;IAmCtE,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,UAAU;IAyBlB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;CAW5B"}

package/dist/services/flow-display.service.js

@@ -1,4 +1,106 @@
 export class FlowDisplayService {
+    /** Widest description the one-line summary will print before eliding. */
+    static DESCRIPTION_MAX_LENGTH = 160;
+    /**
+     * Render an action design-time definition: metadata plus ordered steps.
+     *
+     * As with a flow definition, only the summary projection is printed — the raw
+     * `metadata`/`steps` payloads stay on the JSON path.
+     */
+    formatActionDefinitionResult(result, jsonOutput) {
+        if (jsonOutput) {
+            return [JSON.stringify(result, null, 2)];
+        }
+        const lines = [];
+        const icon = result.success ? '\u2714' : '\u2718';
+        lines.push(`\n${icon} Action Definition — ${result.sysId}`);
+        lines.push("  " + "\u2500".repeat(60));
+        lines.push(`  Type:           ${result.artifactType ?? 'action'}`);
+        const { summary } = result;
+        if (summary) {
+            lines.push(`  Name:           ${summary.name}`);
+            lines.push(`  Internal Name:  ${summary.internalName}`);
+            lines.push(`  State:          ${summary.state}`);
+            lines.push(`  Active:         ${summary.active}`);
+            lines.push(`  Scope:          ${summary.scopeName || summary.scope}`);
+            const description = summary.description ? this._summaryDescription(summary.description) : '';
+            if (description) {
+                lines.push(`  Description:    ${description}`);
+            }
+            lines.push("");
+            lines.push("  Contents:");
+            lines.push(`    Inputs:       ${summary.inputCount}`);
+            lines.push(`    Outputs:      ${summary.outputCount}`);
+            lines.push(`    Steps:        ${summary.stepCount}`);
+            if (summary.steps.length > 0) {
+                lines.push("");
+                lines.push("  Steps:");
+                for (const step of summary.steps) {
+                    lines.push(`    ${step.order}. ${step.label} [${step.stepTypeName}]`);
+                }
+            }
+        }
+        else if (result.success) {
+            lines.push("");
+            lines.push("  No summary was reported. Re-run with --json for the full definition.");
+        }
+        if (result.errorMessage) {
+            lines.push("");
+            lines.push(`  Error: ${result.errorMessage}${result.failureReason ? ` (${result.failureReason})` : ''}`);
+        }
+        lines.push("  " + "\u2500".repeat(60));
+        return lines;
+    }
+    /**
+     * Render a flow or subflow design-time definition.
+     *
+     * The JSON form is the whole typed core result, opaque `definition` payload
+     * included, so it can be piped or redirected straight into a file. The text
+     * form deliberately renders only the summary projection: the definition body
+     * carries step scripts and input values, which do not belong on a terminal.
+     */
+    formatArtifactDefinitionResult(result, jsonOutput) {
+        if (jsonOutput) {
+            return [JSON.stringify(result, null, 2)];
+        }
+        const lines = [];
+        const icon = result.success ? '\u2714' : '\u2718';
+        // artifactType is what ServiceNow reported, never what was asked for.
+        const label = this._artifactLabel(result.artifactType ?? result.reportedType);
+        lines.push(`\n${icon} ${label} Definition — ${result.sysId}`);
+        lines.push("  " + "\u2500".repeat(60));
+        lines.push(`  Type:           ${result.artifactType ?? result.reportedType ?? 'unknown'}`);
+        const { summary } = result;
+        if (summary) {
+            lines.push(`  Name:           ${summary.name}`);
+            lines.push(`  Internal Name:  ${summary.internalName}`);
+            lines.push(`  Status:         ${summary.status}`);
+            lines.push(`  Active:         ${summary.active}`);
+            lines.push(`  Scope:          ${summary.scopeName || summary.scope}`);
+            const description = summary.description ? this._summaryDescription(summary.description) : '';
+            if (description) {
+                lines.push(`  Description:    ${description}`);
+            }
+            lines.push("");
+            lines.push("  Contents:");
+            lines.push(`    Triggers:     ${summary.triggerCount}`);
+            lines.push(`    Actions:      ${summary.actionCount}`);
+            lines.push(`    Subflows:     ${summary.subflowCount}`);
+            lines.push(`    Flow Logic:   ${summary.flowLogicCount}`);
+            lines.push(`    Inputs:       ${summary.inputCount}`);
+            lines.push(`    Outputs:      ${summary.outputCount}`);
+        }
+        else if (result.success) {
+            lines.push("");
+            lines.push("  No summary was reported. Re-run with --json for the full definition.");
+        }
+        if (result.errorMessage) {
+            lines.push("");
+            lines.push(`  Error: ${result.errorMessage}${result.failureReason ? ` (${result.failureReason})` : ''}`);
+        }
+        lines.push("  " + "\u2500".repeat(60));
+        return lines;
+    }
     formatCopyResult(result, jsonOutput) {
         if (jsonOutput) {
             return [JSON.stringify(result, null, 2)];
@@ -304,6 +406,19 @@ export class FlowDisplayService {
         lines.push("  " + "\u2500".repeat(60));
         return lines;
     }
+    _artifactLabel(artifactType) {
+        switch (artifactType) {
+            case 'flow': {
+                return 'Flow';
+            }
+            case 'subflow': {
+                return 'Subflow';
+            }
+            default: {
+                return 'Flow Artifact';
+            }
+        }
+    }
     _mapLogLevel(level) {
         switch (level) {
             case '-1': {
@@ -348,5 +463,24 @@ export class FlowDisplayService {
             }
         }
     }
+    /**
+     * Reduce a design-time description to one summary line.
+     *
+     * Workflow Studio stores the description as authored, which for a shipped
+     * subflow is frequently a block of HTML hundreds of characters long. Printing
+     * it verbatim buries the counts underneath it, so the tags come out, the
+     * whitespace collapses, and anything past the cutoff is elided. The full text
+     * is never lost \u2014 it is on the `--json` path, untouched.
+     */
+    _summaryDescription(description) {
+        const flattened = description
+            .replaceAll(/<[^>]*>/g, ' ')
+            .replaceAll('&nbsp;', ' ')
+            .replaceAll(/\s+/g, ' ')
+            .trim();
+        return flattened.length > FlowDisplayService.DESCRIPTION_MAX_LENGTH
+            ? `${flattened.slice(0, FlowDisplayService.DESCRIPTION_MAX_LENGTH).trimEnd()}\u2026`
+            : flattened;
+    }
 }
 //# sourceMappingURL=flow-display.service.js.map