@qodalis/cli-server-abstractions 1.0.0-beta.4 → 1.0.0-beta.6

package/README.md

@@ -68,7 +68,6 @@ Then register the processor with the server package. See [`@qodalis/cli-server-n
 | `description` | `string` | *(abstract)* | Human-readable description shown in help |
 | `author` | `ICliCommandAuthor` | `DefaultLibraryAuthor` | Author metadata |
 | `version` | `string` | `'1.0.0'` | Processor version |
-| `apiVersion` | `number` | `1` | Minimum API version this processor targets |
 | `allowUnlistedCommands` | `boolean?` | `undefined` | Accept sub-commands not in `processors` list |
 | `valueRequired` | `boolean?` | `undefined` | Whether a positional value argument is required |
 | `processors` | `ICliCommandProcessor[]?` | `undefined` | Nested sub-command processors |

package/dist/cli-command-author.d.ts

@@ -1,11 +1,16 @@
+/** Describes the author of a CLI command processor. */
 export interface ICliCommandAuthor {
+    /** Display name of the author. */
     name: string;
+    /** Contact email of the author. */
     email: string;
 }
+/** Concrete implementation of {@link ICliCommandAuthor}. */
 export declare class CliCommandAuthor implements ICliCommandAuthor {
     name: string;
     email: string;
     constructor(name: string, email: string);
 }
+/** Default author used for built-in library processors. */
 export declare const DefaultLibraryAuthor: ICliCommandAuthor;
 //# sourceMappingURL=cli-command-author.d.ts.map

package/dist/cli-command-author.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command-author.d.ts","sourceRoot":"","sources":["../src/cli-command-author.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,YAAW,iBAAiB;IAE3C,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;gBADb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM;CAE3B;AAED,eAAO,MAAM,oBAAoB,EAAE,iBAGlC,CAAC"}
+{"version":3,"file":"cli-command-author.d.ts","sourceRoot":"","sources":["../src/cli-command-author.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,4DAA4D;AAC5D,qBAAa,gBAAiB,YAAW,iBAAiB;IAE3C,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;gBADb,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM;CAE3B;AAED,2DAA2D;AAC3D,eAAO,MAAM,oBAAoB,EAAE,iBAGlC,CAAC"}

package/dist/cli-command-author.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
+/** Concrete implementation of {@link ICliCommandAuthor}. */
 class CliCommandAuthor {
     name;
     email;
@@ -10,5 +11,6 @@ class CliCommandAuthor {
     }
 }
 exports.CliCommandAuthor = CliCommandAuthor;
+/** Default author used for built-in library processors. */
 exports.DefaultLibraryAuthor = new CliCommandAuthor('Nicolae Lupei', 'nicolae.lupei@qodalis.com');
 //# sourceMappingURL=cli-command-author.js.map

package/dist/cli-command-author.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command-author.js","sourceRoot":"","sources":["../src/cli-command-author.ts"],"names":[],"mappings":";;;AAKA,MAAa,gBAAgB;IAEd;IACA;IAFX,YACW,IAAY,EACZ,KAAa;QADb,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;IACrB,CAAC;CACP;AALD,4CAKC;AAEY,QAAA,oBAAoB,GAAsB,IAAI,gBAAgB,CACvE,eAAe,EACf,2BAA2B,CAC9B,CAAC"}
+{"version":3,"file":"cli-command-author.js","sourceRoot":"","sources":["../src/cli-command-author.ts"],"names":[],"mappings":";;;AAQA,4DAA4D;AAC5D,MAAa,gBAAgB;IAEd;IACA;IAFX,YACW,IAAY,EACZ,KAAa;QADb,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;IACrB,CAAC;CACP;AALD,4CAKC;AAED,2DAA2D;AAC9C,QAAA,oBAAoB,GAAsB,IAAI,gBAAgB,CACvE,eAAe,EACf,2BAA2B,CAC9B,CAAC"}

package/dist/cli-command-parameter-descriptor.d.ts

@@ -1,11 +1,19 @@
+/** Describes a parameter accepted by a CLI command processor. */
 export interface ICliCommandParameterDescriptor {
+    /** Parameter name (e.g. "algorithm"). */
     name: string;
+    /** Short alias flags (e.g. ["-a"]). */
     aliases?: string[];
+    /** Human-readable description shown in help output. */
     description: string;
+    /** Whether the parameter must be provided. */
     required: boolean;
+    /** Expected value type (e.g. "string", "boolean", "number"). */
     type: string;
+    /** Default value used when the parameter is omitted. */
     defaultValue?: any;
 }
+/** Concrete implementation of {@link ICliCommandParameterDescriptor}. */
 export declare class CliCommandParameterDescriptor implements ICliCommandParameterDescriptor {
     name: string;
     description: string;
@@ -13,6 +21,14 @@ export declare class CliCommandParameterDescriptor implements ICliCommandParamet
     type: string;
     aliases?: string[] | undefined;
     defaultValue?: any | undefined;
+    /**
+     * @param name - Parameter name.
+     * @param description - Human-readable description.
+     * @param required - Whether the parameter is mandatory.
+     * @param type - Expected value type.
+     * @param aliases - Short alias flags.
+     * @param defaultValue - Default value when omitted.
+     */
     constructor(name: string, description: string, required?: boolean, type?: string, aliases?: string[] | undefined, defaultValue?: any | undefined);
 }
 //# sourceMappingURL=cli-command-parameter-descriptor.d.ts.map

package/dist/cli-command-parameter-descriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command-parameter-descriptor.d.ts","sourceRoot":"","sources":["../src/cli-command-parameter-descriptor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,8BAA8B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;AAED,qBAAa,6BAA8B,YAAW,8BAA8B;IAErE,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE;IAClB,YAAY,CAAC,EAAE,GAAG;gBALlB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,OAAe,EACzB,IAAI,GAAE,MAAiB,EACvB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAA,EAClB,YAAY,CAAC,EAAE,GAAG,YAAA;CAEhC"}
+{"version":3,"file":"cli-command-parameter-descriptor.d.ts","sourceRoot":"","sources":["../src/cli-command-parameter-descriptor.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,WAAW,8BAA8B;IAC3C,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;AAED,yEAAyE;AACzE,qBAAa,6BAA8B,YAAW,8BAA8B;IAUrE,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,MAAM;IACnB,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE;IAClB,YAAY,CAAC,EAAE,GAAG;IAd7B;;;;;;;OAOG;gBAEQ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,OAAe,EACzB,IAAI,GAAE,MAAiB,EACvB,OAAO,CAAC,EAAE,MAAM,EAAE,YAAA,EAClB,YAAY,CAAC,EAAE,GAAG,YAAA;CAEhC"}

package/dist/cli-command-parameter-descriptor.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliCommandParameterDescriptor = void 0;
+/** Concrete implementation of {@link ICliCommandParameterDescriptor}. */
 class CliCommandParameterDescriptor {
     name;
     description;
@@ -8,6 +9,14 @@ class CliCommandParameterDescriptor {
     type;
     aliases;
     defaultValue;
+    /**
+     * @param name - Parameter name.
+     * @param description - Human-readable description.
+     * @param required - Whether the parameter is mandatory.
+     * @param type - Expected value type.
+     * @param aliases - Short alias flags.
+     * @param defaultValue - Default value when omitted.
+     */
     constructor(name, description, required = false, type = 'string', aliases, defaultValue) {
         this.name = name;
         this.description = description;

package/dist/cli-command-parameter-descriptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command-parameter-descriptor.js","sourceRoot":"","sources":["../src/cli-command-parameter-descriptor.ts"],"names":[],"mappings":";;;AASA,MAAa,6BAA6B;IAE3B;IACA;IACA;IACA;IACA;IACA;IANX,YACW,IAAY,EACZ,WAAmB,EACnB,WAAoB,KAAK,EACzB,OAAe,QAAQ,EACvB,OAAkB,EAClB,YAAkB;QALlB,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,SAAI,GAAJ,IAAI,CAAmB;QACvB,YAAO,GAAP,OAAO,CAAW;QAClB,iBAAY,GAAZ,YAAY,CAAM;IAC1B,CAAC;CACP;AATD,sEASC"}
+{"version":3,"file":"cli-command-parameter-descriptor.js","sourceRoot":"","sources":["../src/cli-command-parameter-descriptor.ts"],"names":[],"mappings":";;;AAgBA,yEAAyE;AACzE,MAAa,6BAA6B;IAU3B;IACA;IACA;IACA;IACA;IACA;IAdX;;;;;;;OAOG;IACH,YACW,IAAY,EACZ,WAAmB,EACnB,WAAoB,KAAK,EACzB,OAAe,QAAQ,EACvB,OAAkB,EAClB,YAAkB;QALlB,SAAI,GAAJ,IAAI,CAAQ;QACZ,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAiB;QACzB,SAAI,GAAJ,IAAI,CAAmB;QACvB,YAAO,GAAP,OAAO,CAAW;QAClB,iBAAY,GAAZ,YAAY,CAAM;IAC1B,CAAC;CACP;AAjBD,sEAiBC"}

package/dist/cli-command-processor.d.ts

@@ -1,19 +1,50 @@
 import { ICliCommandAuthor } from './cli-command-author';
 import { ICliCommandParameterDescriptor } from './cli-command-parameter-descriptor';
 import { CliProcessCommand } from './cli-process-command';
+import { CliStructuredResponse } from './cli-structured-response';
+/** Contract for a CLI command processor that handles one command (and optionally sub-commands). */
 export interface ICliCommandProcessor {
+    /** Primary command keyword (e.g. "echo", "hash"). */
     command: string;
+    /** Short description shown in help/listing output. */
     description: string;
+    /** Author metadata for this processor. */
     author: ICliCommandAuthor;
+    /** When true, sub-commands not listed in {@link processors} are forwarded to this processor. */
     allowUnlistedCommands?: boolean;
+    /** When true, the command requires a positional value argument. */
     valueRequired?: boolean;
+    /** Semantic version of this processor. */
     version: string;
-    /** Minimum API version this processor is available in. Defaults to 1. */
-    apiVersion?: number;
+    /** Nested sub-command processors. */
     processors?: ICliCommandProcessor[];
+    /** Parameter descriptors for this command. */
     parameters?: ICliCommandParameterDescriptor[];
-    handleAsync(command: CliProcessCommand): Promise<string>;
+    /**
+     * Permissions required to execute this command (all of them), enforced
+     * server-side when the users plugin protects the server.
+     */
+    requiredPermissions?: string[];
+    /**
+     * Executes the command and returns a plain-text result.
+     * @param command - Parsed command with arguments.
+     * @param signal - Optional AbortSignal to cancel the operation.
+     * @returns Plain-text output string.
+     */
+    handleAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<string>;
+    /**
+     * Executes the command and returns a structured response with typed outputs.
+     * When implemented, takes precedence over {@link handleAsync}.
+     * @param command - Parsed command with arguments.
+     * @param signal - Optional AbortSignal to cancel the operation.
+     * @returns Structured response containing exit code and typed outputs.
+     */
+    handleStructuredAsync?(command: CliProcessCommand, signal?: AbortSignal): Promise<CliStructuredResponse>;
 }
+/**
+ * Abstract base class for CLI command processors with sensible defaults.
+ * Extend this class and implement {@link handleAsync} to create a new command.
+ */
 export declare abstract class CliCommandProcessor implements ICliCommandProcessor {
     abstract command: string;
     abstract description: string;
@@ -21,9 +52,10 @@ export declare abstract class CliCommandProcessor implements ICliCommandProcesso
     allowUnlistedCommands?: boolean;
     valueRequired?: boolean;
     version: string;
-    apiVersion: number;
     processors?: ICliCommandProcessor[];
     parameters?: ICliCommandParameterDescriptor[];
-    abstract handleAsync(command: CliProcessCommand): Promise<string>;
+    requiredPermissions?: string[];
+    abstract handleAsync(command: CliProcessCommand, signal?: AbortSignal): Promise<string>;
+    handleStructuredAsync?(command: CliProcessCommand, signal?: AbortSignal): Promise<CliStructuredResponse>;
 }
 //# sourceMappingURL=cli-command-processor.d.ts.map

package/dist/cli-command-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command-processor.d.ts","sourceRoot":"","sources":["../src/cli-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5D;AAED,8BAAsB,mBAAoB,YAAW,oBAAoB;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,iBAAiB,CAAwB;IACjD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAW;IAC1B,UAAU,EAAE,MAAM,CAAK;IACvB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAE9C,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CACpE"}
+{"version":3,"file":"cli-command-processor.d.ts","sourceRoot":"","sources":["../src/cli-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAwB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gGAAgG;IAChG,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B;;;;;OAKG;IACH,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/E;;;;;;OAMG;IACH,qBAAqB,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5G;AAED;;;GAGG;AACH,8BAAsB,mBAAoB,YAAW,oBAAoB;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,MAAM,EAAE,iBAAiB,CAAwB;IACjD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,MAAM,CAAW;IAC1B,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAC9C,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE/B,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IACvF,qBAAqB,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAC3G"}

package/dist/cli-command-processor.js

@@ -2,14 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliCommandProcessor = void 0;
 const cli_command_author_1 = require("./cli-command-author");
+/**
+ * Abstract base class for CLI command processors with sensible defaults.
+ * Extend this class and implement {@link handleAsync} to create a new command.
+ */
 class CliCommandProcessor {
     author = cli_command_author_1.DefaultLibraryAuthor;
     allowUnlistedCommands;
     valueRequired;
     version = '1.0.0';
-    apiVersion = 1;
     processors;
     parameters;
+    requiredPermissions;
 }
 exports.CliCommandProcessor = CliCommandProcessor;
 //# sourceMappingURL=cli-command-processor.js.map

package/dist/cli-command-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-command-processor.js","sourceRoot":"","sources":["../src/cli-command-processor.ts"],"names":[],"mappings":";;;AAAA,6DAA+E;AAkB/E,MAAsB,mBAAmB;IAGrC,MAAM,GAAsB,yCAAoB,CAAC;IACjD,qBAAqB,CAAW;IAChC,aAAa,CAAW;IACxB,OAAO,GAAW,OAAO,CAAC;IAC1B,UAAU,GAAW,CAAC,CAAC;IACvB,UAAU,CAA0B;IACpC,UAAU,CAAoC;CAGjD;AAZD,kDAYC"}
+{"version":3,"file":"cli-command-processor.js","sourceRoot":"","sources":["../src/cli-command-processor.ts"],"names":[],"mappings":";;;AAAA,6DAA+E;AA6C/E;;;GAGG;AACH,MAAsB,mBAAmB;IAGrC,MAAM,GAAsB,yCAAoB,CAAC;IACjD,qBAAqB,CAAW;IAChC,aAAa,CAAW;IACxB,OAAO,GAAW,OAAO,CAAC;IAC1B,UAAU,CAA0B;IACpC,UAAU,CAAoC;IAC9C,mBAAmB,CAAY;CAIlC;AAbD,kDAaC"}

package/dist/cli-process-command.d.ts

@@ -1,9 +1,16 @@
+/** Parsed representation of a CLI command submitted for execution. */
 export interface CliProcessCommand {
+    /** Primary command keyword (e.g. "hash", "http"). */
     command: string;
+    /** Optional payload data attached to the command. */
     data?: any;
+    /** Sub-command chain following the primary command (e.g. ["encode"] for "base64 encode"). */
     chainCommands: string[];
+    /** Original unparsed command string as entered by the user. */
     rawCommand: string;
+    /** Positional value argument (the first non-flag token after the command). */
     value?: string;
+    /** Named arguments parsed from flags (e.g. { algorithm: "sha256" }). */
     args: Record<string, any>;
 }
 //# sourceMappingURL=cli-process-command.d.ts.map

package/dist/cli-process-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-process-command.d.ts","sourceRoot":"","sources":["../src/cli-process-command.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"cli-process-command.d.ts","sourceRoot":"","sources":["../src/cli-process-command.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAC9B,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,6FAA6F;IAC7F,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B"}

package/dist/cli-processor-filter.d.ts

@@ -0,0 +1,14 @@
+import { ICliCommandProcessor } from './cli-command-processor';
+/**
+ * Provides a mechanism to filter whether a command processor is allowed to execute.
+ * Implementations can use this to disable processors at runtime (e.g., when a plugin is toggled off).
+ */
+export interface ICliProcessorFilter {
+    /**
+     * Determines whether the given command processor is allowed to execute.
+     * @param processor - The command processor to check.
+     * @returns `true` if the processor is allowed; `false` if it should be blocked.
+     */
+    isAllowed(processor: ICliCommandProcessor): boolean;
+}
+//# sourceMappingURL=cli-processor-filter.d.ts.map

package/dist/cli-processor-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-processor-filter.d.ts","sourceRoot":"","sources":["../src/cli-processor-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,SAAS,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAAC;CACvD"}

package/dist/cli-processor-filter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cli-processor-filter.js.map

package/dist/cli-processor-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-processor-filter.js","sourceRoot":"","sources":["../src/cli-processor-filter.ts"],"names":[],"mappings":""}

package/dist/cli-stream-command-processor.d.ts

@@ -0,0 +1,27 @@
+import { CliProcessCommand } from './cli-process-command';
+import { CliStructuredOutput } from './cli-structured-response';
+/**
+ * Optional interface for command processors that support streaming output.
+ * Processors implementing this interface can emit output chunks incrementally
+ * via the `emit` callback, enabling real-time rendering on the client.
+ *
+ * A processor can implement both ICliCommandProcessor and ICliStreamCommandProcessor.
+ * The stream execution endpoint will prefer this interface when available.
+ */
+export interface ICliStreamCommandProcessor {
+    /** Must match the command keyword of the corresponding ICliCommandProcessor. */
+    readonly command: string;
+    /**
+     * Execute the command, emitting output chunks as they become available.
+     * @param command - Parsed command with arguments.
+     * @param emit - Callback to send a single output chunk to the client.
+     * @param signal - Optional AbortSignal to cancel the operation.
+     * @returns Exit code (0 for success).
+     */
+    handleStreamAsync(command: CliProcessCommand, emit: (output: CliStructuredOutput) => void, signal?: AbortSignal): Promise<number>;
+}
+/**
+ * Type guard to check if a processor supports streaming.
+ */
+export declare function isStreamCapable(processor: unknown): processor is ICliStreamCommandProcessor;
+//# sourceMappingURL=cli-stream-command-processor.d.ts.map

package/dist/cli-stream-command-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-stream-command-processor.d.ts","sourceRoot":"","sources":["../src/cli-stream-command-processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA0B;IACvC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,iBAAiB,CACb,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,EAC3C,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC3B,SAAS,EAAE,OAAO,GACnB,SAAS,IAAI,0BAA0B,CAOzC"}

package/dist/cli-stream-command-processor.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStreamCapable = isStreamCapable;
+/**
+ * Type guard to check if a processor supports streaming.
+ */
+function isStreamCapable(processor) {
+    return (typeof processor === 'object' &&
+        processor !== null &&
+        'handleStreamAsync' in processor &&
+        typeof processor.handleStreamAsync === 'function');
+}
+//# sourceMappingURL=cli-stream-command-processor.js.map

package/dist/cli-stream-command-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-stream-command-processor.js","sourceRoot":"","sources":["../src/cli-stream-command-processor.ts"],"names":[],"mappings":";;AAgCA,0CASC;AAZD;;GAEG;AACH,SAAgB,eAAe,CAC3B,SAAkB;IAElB,OAAO,CACH,OAAO,SAAS,KAAK,QAAQ;QAC7B,SAAS,KAAK,IAAI;QAClB,mBAAmB,IAAI,SAAS;QAChC,OAAQ,SAAiB,CAAC,iBAAiB,KAAK,UAAU,CAC7D,CAAC;AACN,CAAC"}

package/dist/cli-structured-response.d.ts

@@ -0,0 +1,31 @@
+/** A single typed output block within a structured CLI response. */
+export type CliStructuredOutput = {
+    type: 'text';
+    value: string;
+    style?: 'success' | 'error' | 'info' | 'warning';
+} | {
+    type: 'table';
+    headers: string[];
+    rows: string[][];
+} | {
+    type: 'list';
+    items: string[];
+    ordered?: boolean;
+} | {
+    type: 'json';
+    value: any;
+} | {
+    type: 'key-value';
+    entries: {
+        key: string;
+        value: string;
+    }[];
+};
+/** Response envelope returned by structured command execution, containing an exit code and typed outputs. */
+export interface CliStructuredResponse {
+    /** Process exit code (0 for success, non-zero for errors). */
+    exitCode: number;
+    /** Ordered list of typed output blocks. */
+    outputs: CliStructuredOutput[];
+}
+//# sourceMappingURL=cli-structured-response.d.ts.map

package/dist/cli-structured-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-structured-response.d.ts","sourceRoot":"","sources":["../src/cli-structured-response.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,MAAM,mBAAmB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC;AAEvE,6GAA6G;AAC7G,MAAM,WAAW,qBAAqB;IAClC,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAClC"}

package/dist/cli-structured-response.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cli-structured-response.js.map

package/dist/cli-structured-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-structured-response.js","sourceRoot":"","sources":["../src/cli-structured-response.ts"],"names":[],"mappings":""}

package/dist/data-explorer-provider.d.ts

@@ -0,0 +1,17 @@
+import { DataExplorerExecutionContext, DataExplorerResult, DataExplorerSchemaResult, DataExplorerProviderOptions } from './data-explorer-types';
+/** Provider that executes queries against a specific data source (e.g. SQL database, MongoDB). */
+export interface IDataExplorerProvider {
+    /**
+     * Executes a query against the data source.
+     * @param context - Execution context containing the query, parameters, and options.
+     * @returns Query results including rows, columns, and execution metadata.
+     */
+    executeAsync(context: DataExplorerExecutionContext): Promise<DataExplorerResult>;
+    /**
+     * Retrieves schema information (tables, columns) from the data source.
+     * @param options - Provider options identifying the data source.
+     * @returns Schema metadata for the data source.
+     */
+    getSchemaAsync?(options: DataExplorerProviderOptions): Promise<DataExplorerSchemaResult>;
+}
+//# sourceMappingURL=data-explorer-provider.d.ts.map

package/dist/data-explorer-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-explorer-provider.d.ts","sourceRoot":"","sources":["../src/data-explorer-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEhJ,kGAAkG;AAClG,MAAM,WAAW,qBAAqB;IAClC;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjF;;;;OAIG;IACH,cAAc,CAAC,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAC5F"}

package/dist/data-explorer-provider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data-explorer-provider.js.map

package/dist/data-explorer-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-explorer-provider.js","sourceRoot":"","sources":["../src/data-explorer-provider.ts"],"names":[],"mappings":""}

package/dist/data-explorer-types.d.ts

@@ -0,0 +1,143 @@
+/** Query language supported by a data explorer provider. */
+export declare enum DataExplorerLanguage {
+    Sql = "sql",
+    Json = "json",
+    Shell = "shell",
+    Graphql = "graphql",
+    Redis = "redis",
+    Elasticsearch = "elasticsearch"
+}
+/** Output format for data explorer query results. */
+export declare enum DataExplorerOutputFormat {
+    Table = "table",
+    Json = "json",
+    Csv = "csv",
+    Raw = "raw"
+}
+/** Predefined query template for a data explorer provider. */
+export interface DataExplorerTemplate {
+    /** Template display name. */
+    name: string;
+    /** Query string, optionally with parameter placeholders. */
+    query: string;
+    /** Human-readable description of what this template does. */
+    description?: string;
+    /** Default parameter values for this template. */
+    parameters?: Record<string, unknown>;
+}
+/** Describes a parameter accepted by a data explorer provider. */
+export interface DataExplorerParameterDescriptor {
+    /** Parameter name. */
+    name: string;
+    /** Human-readable description. */
+    description?: string;
+    /** Whether the parameter must be provided. */
+    required?: boolean;
+    /** Default value when omitted. */
+    defaultValue?: unknown;
+}
+/** Configuration options that define a data explorer provider's identity and capabilities. */
+export interface DataExplorerProviderOptions {
+    /** Unique provider name (e.g. "postgres", "mongodb"). */
+    name: string;
+    /** Human-readable description of the data source. */
+    description: string;
+    /** Query language used by this provider. */
+    language: DataExplorerLanguage;
+    /** Default output format for query results. */
+    defaultOutputFormat: DataExplorerOutputFormat;
+    /** Parameters accepted by this provider. */
+    parameters?: DataExplorerParameterDescriptor[];
+    /** Predefined query templates. */
+    templates?: DataExplorerTemplate[];
+    /** Query execution timeout in milliseconds. */
+    timeout?: number;
+    /** Maximum number of rows to return per query. */
+    maxRows?: number;
+}
+/** Context passed to a data explorer provider when executing a query. */
+export interface DataExplorerExecutionContext {
+    /** Query string to execute. */
+    query: string;
+    /** Parameter values for the query. */
+    parameters: Record<string, unknown>;
+    /** Provider configuration options. */
+    options: DataExplorerProviderOptions;
+    /** Abort signal for cancellation. */
+    signal?: AbortSignal;
+}
+/** Result of a data explorer query execution. */
+export interface DataExplorerResult {
+    /** Whether the query executed without errors. */
+    success: boolean;
+    /** Provider source name that produced this result. */
+    source: string;
+    /** Query language used. */
+    language: DataExplorerLanguage;
+    /** Output format of the result data. */
+    defaultOutputFormat: DataExplorerOutputFormat;
+    /** Query execution time in milliseconds. */
+    executionTime: number;
+    /** Column names, or null if not applicable. */
+    columns: string[] | null;
+    /** Result rows as arrays or objects. */
+    rows: unknown[][] | Record<string, unknown>[];
+    /** Total number of rows returned. */
+    rowCount: number;
+    /** Whether the result was truncated due to maxRows. */
+    truncated: boolean;
+    /** Error message if the query failed, otherwise null. */
+    error: string | null;
+}
+/** Request payload for executing a data explorer query. */
+export interface DataExplorerExecuteRequest {
+    /** Target data source name. */
+    source: string;
+    /** Query string to execute. */
+    query: string;
+    /** Optional parameter values. */
+    parameters?: Record<string, unknown>;
+}
+/** Metadata about a registered data explorer source. */
+export interface DataExplorerSourceInfo {
+    /** Source name. */
+    name: string;
+    /** Human-readable description. */
+    description: string;
+    /** Query language used by this source. */
+    language: DataExplorerLanguage;
+    /** Default output format. */
+    defaultOutputFormat: DataExplorerOutputFormat;
+    /** Available query templates. */
+    templates: DataExplorerTemplate[];
+    /** Accepted parameters. */
+    parameters: DataExplorerParameterDescriptor[];
+}
+/** Describes a single column within a data explorer schema table. */
+export interface DataExplorerSchemaColumn {
+    /** Column name. */
+    name: string;
+    /** Data type (e.g. "varchar", "integer"). */
+    type: string;
+    /** Whether the column allows null values. */
+    nullable: boolean;
+    /** Whether the column is a primary key. */
+    primaryKey: boolean;
+}
+/** Describes a table or collection in a data explorer schema. */
+export interface DataExplorerSchemaTable {
+    /** Table or collection name. */
+    name: string;
+    /** Object type (e.g. "table", "view", "collection"). */
+    type: string;
+    /** Columns within this table. */
+    columns: DataExplorerSchemaColumn[];
+}
+/** Schema introspection result from a data explorer provider. */
+export interface DataExplorerSchemaResult {
+    /** Provider source name. */
+    source: string;
+    /** Tables and their column definitions. */
+    tables: DataExplorerSchemaTable[];
+}
+//# sourceMappingURL=data-explorer-types.d.ts.map

package/dist/data-explorer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-explorer-types.d.ts","sourceRoot":"","sources":["../src/data-explorer-types.ts"],"names":[],"mappings":"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"}

package/dist/data-explorer-types.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataExplorerOutputFormat = exports.DataExplorerLanguage = void 0;
+/** Query language supported by a data explorer provider. */
+var DataExplorerLanguage;
+(function (DataExplorerLanguage) {
+    DataExplorerLanguage["Sql"] = "sql";
+    DataExplorerLanguage["Json"] = "json";
+    DataExplorerLanguage["Shell"] = "shell";
+    DataExplorerLanguage["Graphql"] = "graphql";
+    DataExplorerLanguage["Redis"] = "redis";
+    DataExplorerLanguage["Elasticsearch"] = "elasticsearch";
+})(DataExplorerLanguage || (exports.DataExplorerLanguage = DataExplorerLanguage = {}));
+/** Output format for data explorer query results. */
+var DataExplorerOutputFormat;
+(function (DataExplorerOutputFormat) {
+    DataExplorerOutputFormat["Table"] = "table";
+    DataExplorerOutputFormat["Json"] = "json";
+    DataExplorerOutputFormat["Csv"] = "csv";
+    DataExplorerOutputFormat["Raw"] = "raw";
+})(DataExplorerOutputFormat || (exports.DataExplorerOutputFormat = DataExplorerOutputFormat = {}));
+//# sourceMappingURL=data-explorer-types.js.map

package/dist/data-explorer-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-explorer-types.js","sourceRoot":"","sources":["../src/data-explorer-types.ts"],"names":[],"mappings":";;;AAAA,4DAA4D;AAC5D,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAC5B,mCAAW,CAAA;IACX,qCAAa,CAAA;IACb,uCAAe,CAAA;IACf,2CAAmB,CAAA;IACnB,uCAAe,CAAA;IACf,uDAA+B,CAAA;AACnC,CAAC,EAPW,oBAAoB,oCAApB,oBAAoB,QAO/B;AAED,qDAAqD;AACrD,IAAY,wBAKX;AALD,WAAY,wBAAwB;IAChC,2CAAe,CAAA;IACf,yCAAa,CAAA;IACb,uCAAW,CAAA;IACX,uCAAW,CAAA;AACf,CAAC,EALW,wBAAwB,wCAAxB,wBAAwB,QAKnC"}

package/dist/index.d.ts

@@ -3,5 +3,10 @@ export { CliProcessCommand } from './cli-process-command';
 export { ICliCommandParameterDescriptor, CliCommandParameterDescriptor } from './cli-command-parameter-descriptor';
 export { ICliCommandProcessor, CliCommandProcessor } from './cli-command-processor';
 export { ICliModule, CliModule } from './cli-module';
+export { CliStructuredOutput, CliStructuredResponse } from './cli-structured-response';
 export { ICliJob, ICliJobExecutionContext, ICliJobLogger, CliJobOptions, JobOverlapPolicy, ICliJobStorageProvider, JobExecution, JobExecutionStatus, JobState, JobStatus, JobLogEntry, JobLogLevel, } from './jobs';
+export { DataExplorerLanguage, DataExplorerOutputFormat, DataExplorerTemplate, DataExplorerParameterDescriptor, DataExplorerProviderOptions, DataExplorerExecutionContext, DataExplorerResult, DataExplorerExecuteRequest, DataExplorerSourceInfo, DataExplorerSchemaColumn, DataExplorerSchemaTable, DataExplorerSchemaResult, } from './data-explorer-types';
+export { IDataExplorerProvider } from './data-explorer-provider';
+export { ICliProcessorFilter } from './cli-processor-filter';
+export { ICliStreamCommandProcessor, isStreamCapable } from './cli-stream-command-processor';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACH,OAAO,EACP,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,GACd,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnH,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EACH,OAAO,EACP,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,GACd,MAAM,QAAQ,CAAC;AAChB,OAAO,EACH,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,2BAA2B,EAC3B,4BAA4B,EAC5B,kBAAkB,EAClB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CliModule = exports.CliCommandProcessor = exports.CliCommandParameterDescriptor = exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
+exports.isStreamCapable = exports.DataExplorerOutputFormat = exports.DataExplorerLanguage = exports.CliModule = exports.CliCommandProcessor = exports.CliCommandParameterDescriptor = exports.DefaultLibraryAuthor = exports.CliCommandAuthor = void 0;
 var cli_command_author_1 = require("./cli-command-author");
 Object.defineProperty(exports, "CliCommandAuthor", { enumerable: true, get: function () { return cli_command_author_1.CliCommandAuthor; } });
 Object.defineProperty(exports, "DefaultLibraryAuthor", { enumerable: true, get: function () { return cli_command_author_1.DefaultLibraryAuthor; } });
@@ -10,4 +10,9 @@ var cli_command_processor_1 = require("./cli-command-processor");
 Object.defineProperty(exports, "CliCommandProcessor", { enumerable: true, get: function () { return cli_command_processor_1.CliCommandProcessor; } });
 var cli_module_1 = require("./cli-module");
 Object.defineProperty(exports, "CliModule", { enumerable: true, get: function () { return cli_module_1.CliModule; } });
+var data_explorer_types_1 = require("./data-explorer-types");
+Object.defineProperty(exports, "DataExplorerLanguage", { enumerable: true, get: function () { return data_explorer_types_1.DataExplorerLanguage; } });
+Object.defineProperty(exports, "DataExplorerOutputFormat", { enumerable: true, get: function () { return data_explorer_types_1.DataExplorerOutputFormat; } });
+var cli_stream_command_processor_1 = require("./cli-stream-command-processor");
+Object.defineProperty(exports, "isStreamCapable", { enumerable: true, get: function () { return cli_stream_command_processor_1.isStreamCapable; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiG;AAArE,sHAAA,gBAAgB,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAElE,uFAAmH;AAA1E,iJAAA,6BAA6B,OAAA;AACtE,iEAAoF;AAArD,4HAAA,mBAAmB,OAAA;AAClD,2CAAqD;AAAhC,uGAAA,SAAS,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiG;AAArE,sHAAA,gBAAgB,OAAA;AAAE,0HAAA,oBAAoB,OAAA;AAElE,uFAAmH;AAA1E,iJAAA,6BAA6B,OAAA;AACtE,iEAAoF;AAArD,4HAAA,mBAAmB,OAAA;AAClD,2CAAqD;AAAhC,uGAAA,SAAS,OAAA;AAgB9B,6DAa+B;AAZ3B,2HAAA,oBAAoB,OAAA;AACpB,+HAAA,wBAAwB,OAAA;AAc5B,+EAA6F;AAAxD,+HAAA,eAAe,OAAA"}

package/dist/jobs/cli-job-execution-context.d.ts

@@ -1,5 +1,7 @@
 import { ICliJobLogger } from './cli-job-logger';
+/** Context passed to a job during execution, providing access to logging. */
 export interface ICliJobExecutionContext {
+    /** Logger for recording job progress and diagnostics. */
     logger: ICliJobLogger;
 }
 //# sourceMappingURL=cli-job-execution-context.d.ts.map

package/dist/jobs/cli-job-execution-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-job-execution-context.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACpC,MAAM,EAAE,aAAa,CAAC;CACzB"}
+{"version":3,"file":"cli-job-execution-context.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACpC,yDAAyD;IACzD,MAAM,EAAE,aAAa,CAAC;CACzB"}

package/dist/jobs/cli-job-logger.d.ts

@@ -1,7 +1,12 @@
+/** Logger interface for recording messages during job execution. */
 export interface ICliJobLogger {
+    /** Logs a debug-level message. */
     debug(message: string): void;
+    /** Logs an informational message. */
     info(message: string): void;
+    /** Logs a warning message. */
     warning(message: string): void;
+    /** Logs an error message. */
     error(message: string): void;
 }
 //# sourceMappingURL=cli-job-logger.d.ts.map

package/dist/jobs/cli-job-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-job-logger.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}
+{"version":3,"file":"cli-job-logger.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-logger.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC1B,kCAAkC;IAClC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qCAAqC;IACrC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8BAA8B;IAC9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,6BAA6B;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC"}

package/dist/jobs/cli-job-options.d.ts

@@ -1,5 +1,8 @@
+/** Behavior when a job's timer fires while the previous execution is still running. */
 export type JobOverlapPolicy = 'skip' | 'queue' | 'cancel';
+/** Retry backoff strategy for failed job executions. */
 export type JobRetryStrategy = 'fixed' | 'linear' | 'exponential';
+/** Configuration options for a scheduled or on-demand CLI job. */
 export interface CliJobOptions {
     /** Display name for the job. Defaults to class name. */
     name?: string;

package/dist/jobs/cli-job-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-job-options.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;AAElE,MAAM,WAAW,aAAa;IAC1B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8IAA8I;IAC9I,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,gBAAgB,CAAC;CACpC"}
+{"version":3,"file":"cli-job-options.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-options.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3D,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;AAElE,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC1B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8IAA8I;IAC9I,aAAa,CAAC,EAAE,gBAAgB,CAAC;IACjC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,aAAa,CAAC,EAAE,gBAAgB,CAAC;CACpC"}

package/dist/jobs/cli-job-storage-provider.d.ts

@@ -1,7 +1,15 @@
 import { JobExecution, JobExecutionStatus } from './job-execution';
 import { JobState } from './job-state';
+/** Persistence provider for job execution records and job state. */
 export interface ICliJobStorageProvider {
+    /** Persists or updates a job execution record. */
     saveExecution(execution: JobExecution): Promise<void>;
+    /**
+     * Retrieves paginated execution records for a job.
+     * @param jobId - Job identifier.
+     * @param options - Pagination and filter options.
+     * @returns Paginated result with items and total count.
+     */
     getExecutions(jobId: string, options?: {
         limit?: number;
         offset?: number;
@@ -10,9 +18,13 @@ export interface ICliJobStorageProvider {
         items: JobExecution[];
         total: number;
     }>;
+    /** Retrieves a single execution record by ID, or null if not found. */
     getExecution(executionId: string): Promise<JobExecution | null>;
+    /** Persists the current state (active/paused/stopped) for a job. */
     saveJobState(jobId: string, state: JobState): Promise<void>;
+    /** Retrieves the persisted state for a job, or null if none exists. */
     getJobState(jobId: string): Promise<JobState | null>;
+    /** Retrieves all persisted job states keyed by job ID. */
     getAllJobStates(): Promise<Map<string, JobState>>;
 }
 //# sourceMappingURL=cli-job-storage-provider.d.ts.map

package/dist/jobs/cli-job-storage-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-job-storage-provider.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-storage-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,WAAW,sBAAsB;IACnC,aAAa,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,aAAa,CACT,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAC3E,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACrD,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;CACrD"}
+{"version":3,"file":"cli-job-storage-provider.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job-storage-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACnC,kDAAkD;IAClD,aAAa,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD;;;;;OAKG;IACH,aAAa,CACT,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAC3E,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,uEAAuE;IACvE,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChE,oEAAoE;IACpE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,uEAAuE;IACvE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IACrD,0DAA0D;IAC1D,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;CACrD"}

package/dist/jobs/cli-job.d.ts

@@ -1,5 +1,11 @@
 import { ICliJobExecutionContext } from './cli-job-execution-context';
+/** A scheduled or on-demand background job. */
 export interface ICliJob {
+    /**
+     * Executes the job's work.
+     * @param context - Execution context providing a logger.
+     * @param signal - Abort signal for cancellation and timeout.
+     */
     executeAsync(context: ICliJobExecutionContext, signal: AbortSignal): Promise<void>;
 }
 //# sourceMappingURL=cli-job.d.ts.map

package/dist/jobs/cli-job.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-job.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,WAAW,OAAO;IACpB,YAAY,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF"}
+{"version":3,"file":"cli-job.d.ts","sourceRoot":"","sources":["../../src/jobs/cli-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,+CAA+C;AAC/C,MAAM,WAAW,OAAO;IACpB;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF"}

package/dist/jobs/job-execution.d.ts

@@ -1,15 +1,27 @@
 import { JobLogEntry } from './log-entry';
+/** Possible terminal and in-progress states of a job execution. */
 export type JobExecutionStatus = 'running' | 'completed' | 'failed' | 'cancelled' | 'timed_out';
+/** Record of a single job execution attempt. */
 export interface JobExecution {
+    /** Unique execution identifier. */
     id: string;
+    /** Identifier of the job that was executed. */
     jobId: string;
+    /** Display name of the job. */
     jobName: string;
+    /** Current execution status. */
     status: JobExecutionStatus;
+    /** ISO 8601 timestamp when execution started. */
     startedAt: string;
+    /** ISO 8601 timestamp when execution completed (if finished). */
     completedAt?: string;
+    /** Execution duration in milliseconds. */
     duration?: number;
+    /** Error message if the execution failed. */
     error?: string;
+    /** Log entries recorded during execution. */
     logs: JobLogEntry[];
+    /** Zero-based retry attempt number. */
     retryAttempt: number;
 }
 //# sourceMappingURL=job-execution.d.ts.map

package/dist/jobs/job-execution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-execution.d.ts","sourceRoot":"","sources":["../../src/jobs/job-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhG,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACxB"}
+{"version":3,"file":"job-execution.d.ts","sourceRoot":"","sources":["../../src/jobs/job-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;AAEhG,gDAAgD;AAChD,MAAM,WAAW,YAAY;IACzB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACxB"}

package/dist/jobs/job-state.d.ts

@@ -1,7 +1,12 @@
+/** Lifecycle status of a registered job. */
 export type JobStatus = 'active' | 'paused' | 'stopped';
+/** Persisted state snapshot for a registered job. */
 export interface JobState {
+    /** Current lifecycle status. */
     status: JobStatus;
+    /** ISO 8601 timestamp of the last execution, if any. */
     lastRunAt?: string;
+    /** ISO 8601 timestamp when the state was last modified. */
     updatedAt: string;
 }
 //# sourceMappingURL=job-state.d.ts.map

package/dist/jobs/job-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-state.d.ts","sourceRoot":"","sources":["../../src/jobs/job-state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExD,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"job-state.d.ts","sourceRoot":"","sources":["../../src/jobs/job-state.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExD,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACrB,gCAAgC;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/dist/jobs/log-entry.d.ts

@@ -1,7 +1,12 @@
+/** Severity levels for job log entries. */
 export type JobLogLevel = 'debug' | 'info' | 'warning' | 'error';
+/** A single log entry recorded during job execution. */
 export interface JobLogEntry {
+    /** ISO 8601 timestamp when the entry was created. */
     timestamp: string;
+    /** Severity level. */
     level: JobLogLevel;
+    /** Log message content. */
     message: string;
 }
 //# sourceMappingURL=log-entry.d.ts.map

package/dist/jobs/log-entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-entry.d.ts","sourceRoot":"","sources":["../../src/jobs/log-entry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"log-entry.d.ts","sourceRoot":"","sources":["../../src/jobs/log-entry.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEjE,wDAAwD;AACxD,MAAM,WAAW,WAAW;IACxB,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@qodalis/cli-server-abstractions",
-    "version": "1.0.0-beta.4",
+    "version": "1.0.0-beta.6",
     "description": "Shared interfaces and base classes for Qodalis CLI command processors — zero framework dependencies",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",