@llm-dev-ops/agentics-cli 1.0.1 → 1.2.0

package/dist/types/index.js

@@ -6,6 +6,56 @@
  * - Types are interface-based for loose coupling
  * - No business logic in type definitions
  */
+/**
+ * Check if input is natural language (not valid JSON)
+ */
+export function isNaturalLanguageInput(value) {
+    if (!value || value.trim() === '')
+        return false;
+    const trimmed = value.trim();
+    // JSON objects start with { or [
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            JSON.parse(trimmed);
+            return false; // Valid JSON, not natural language
+        }
+        catch {
+            return true; // Looks like JSON but isn't valid - treat as NL
+        }
+    }
+    return true; // Doesn't look like JSON, is natural language
+}
+/**
+ * Parse input that can be either JSON or natural language.
+ * Returns parsed JSON if valid, otherwise returns NaturalLanguageInput wrapper.
+ */
+export function parseFlexibleInput(value) {
+    if (!value || value.trim() === '') {
+        return { type: 'natural-language', description: '' };
+    }
+    const trimmed = value.trim();
+    // Try to parse as JSON if it looks like JSON
+    if (trimmed.startsWith('{') || trimmed.startsWith('[')) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            // Invalid JSON syntax - treat as natural language
+            return { type: 'natural-language', description: value };
+        }
+    }
+    // Not JSON - treat as natural language description
+    return { type: 'natural-language', description: value };
+}
+/**
+ * Check if a FlexibleInput is a NaturalLanguageInput
+ */
+export function isNaturalLanguage(input) {
+    return typeof input === 'object' &&
+        input !== null &&
+        'type' in input &&
+        input.type === 'natural-language';
+}
 // ============================================================================
 // Exit Codes (SPARC_REFINEMENT §5.5)
 // ============================================================================

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsSH,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,EAAE;IACf,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,cAAc,EAAE,EAAE;IAClB,QAAQ,EAAE,EAAE;IACZ,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE;IAChB,4BAA4B;IAC5B,oBAAoB,EAAE,GAAG;IACzB,uBAAuB,EAAE,GAAG;IAC5B,aAAa,EAAE,GAAG;IAClB,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,GAAG;IAClB,kBAAkB,EAAE,GAAG;CACf,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsIH;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,iCAAiC;IACjC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpB,OAAO,KAAK,CAAC,CAAC,mCAAmC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,gDAAgD;QAC/D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,8CAA8C;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,KAAa;IACjD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,6CAA6C;IAC7C,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;YAClD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAI,KAAuB;IAC1D,OAAO,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACd,KAA8B,CAAC,IAAI,KAAK,kBAAkB,CAAC;AACrE,CAAC;AAiLD,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,EAAE;IACf,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,mBAAmB,EAAE,EAAE;IACvB,cAAc,EAAE,EAAE;IAClB,QAAQ,EAAE,EAAE;IACZ,iBAAiB,EAAE,EAAE;IACrB,iBAAiB,EAAE,EAAE;IACrB,YAAY,EAAE,EAAE;IAChB,4BAA4B;IAC5B,oBAAoB,EAAE,GAAG;IACzB,uBAAuB,EAAE,GAAG;IAC5B,aAAa,EAAE,GAAG;IAClB,UAAU,EAAE,GAAG;IACf,aAAa,EAAE,GAAG;IAClB,kBAAkB,EAAE,GAAG;CACf,CAAC"}

package/dist/utils/credentials.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Credential Storage Utility
+ *
+ * SPARC Architecture Reference: Authentication Module
+ *
+ * PURPOSE: Securely store and retrieve API credentials locally
+ *
+ * STORAGE LOCATION:
+ * - ~/.agentics/credentials.json (Unix/macOS)
+ * - %USERPROFILE%\.agentics\credentials.json (Windows)
+ *
+ * FORBIDDEN:
+ * - Storing credentials in plaintext in code
+ * - Logging credential values
+ * - Transmitting credentials to unauthorized endpoints
+ */
+import type { AuthCredentials } from '../types/index.js';
+export interface ICredentialStore {
+    save(credentials: AuthCredentials): Promise<void>;
+    load(): Promise<AuthCredentials | null>;
+    delete(): Promise<void>;
+    exists(): Promise<boolean>;
+}
+export declare class CredentialStore implements ICredentialStore {
+    private readonly configDir;
+    private readonly credentialsPath;
+    constructor(configDir?: string);
+    save(credentials: AuthCredentials): Promise<void>;
+    load(): Promise<AuthCredentials | null>;
+    delete(): Promise<void>;
+    exists(): Promise<boolean>;
+    private ensureConfigDir;
+    getCredentialsPath(): string;
+}
+export declare function createCredentialStore(configDir?: string): ICredentialStore;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/utils/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../src/utils/credentials.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMzD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAaD,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,SAAS,CAAC,EAAE,MAAM;IAKxB,IAAI,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,IAAI,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAwBvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQvB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;YASlB,eAAe;IAW7B,kBAAkB,IAAI,MAAM;CAG7B;AAMD,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAE1E"}

package/dist/utils/credentials.js

@@ -0,0 +1,104 @@
+/**
+ * Credential Storage Utility
+ *
+ * SPARC Architecture Reference: Authentication Module
+ *
+ * PURPOSE: Securely store and retrieve API credentials locally
+ *
+ * STORAGE LOCATION:
+ * - ~/.agentics/credentials.json (Unix/macOS)
+ * - %USERPROFILE%\.agentics\credentials.json (Windows)
+ *
+ * FORBIDDEN:
+ * - Storing credentials in plaintext in code
+ * - Logging credential values
+ * - Transmitting credentials to unauthorized endpoints
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+// ============================================================================
+// Configuration
+// ============================================================================
+const AGENTICS_CONFIG_DIR = '.agentics';
+const CREDENTIALS_FILE = 'credentials.json';
+// ============================================================================
+// Credential Store Implementation
+// ============================================================================
+export class CredentialStore {
+    configDir;
+    credentialsPath;
+    constructor(configDir) {
+        this.configDir = configDir ?? path.join(os.homedir(), AGENTICS_CONFIG_DIR);
+        this.credentialsPath = path.join(this.configDir, CREDENTIALS_FILE);
+    }
+    async save(credentials) {
+        // Ensure config directory exists
+        await this.ensureConfigDir();
+        // Write credentials with restricted permissions
+        const content = JSON.stringify(credentials, null, 2);
+        await fs.promises.writeFile(this.credentialsPath, content, {
+            encoding: 'utf-8',
+            mode: 0o600, // Owner read/write only
+        });
+    }
+    async load() {
+        try {
+            const content = await fs.promises.readFile(this.credentialsPath, 'utf-8');
+            const credentials = JSON.parse(content);
+            // Validate basic structure
+            if (!credentials.api_key || typeof credentials.api_key !== 'string') {
+                return null;
+            }
+            // Check expiration if set
+            if (credentials.expires_at) {
+                const expiresAt = new Date(credentials.expires_at);
+                if (expiresAt <= new Date()) {
+                    return null;
+                }
+            }
+            return credentials;
+        }
+        catch {
+            return null;
+        }
+    }
+    async delete() {
+        try {
+            await fs.promises.unlink(this.credentialsPath);
+        }
+        catch {
+            // Ignore if file doesn't exist
+        }
+    }
+    async exists() {
+        try {
+            await fs.promises.access(this.credentialsPath, fs.constants.R_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async ensureConfigDir() {
+        try {
+            await fs.promises.mkdir(this.configDir, {
+                recursive: true,
+                mode: 0o700, // Owner read/write/execute only
+            });
+        }
+        catch {
+            // Directory may already exist
+        }
+    }
+    getCredentialsPath() {
+        return this.credentialsPath;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+export function createCredentialStore(configDir) {
+    return new CredentialStore(configDir);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/utils/credentials.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility Exports
+ *
+ * Re-exports all utility implementations
+ */
+export { createCredentialStore, CredentialStore } from './credentials.js';
+export type { ICredentialStore } from './credentials.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Utility Exports
+ *
+ * Re-exports all utility implementations
+ */
+export { createCredentialStore, CredentialStore } from './credentials.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm-dev-ops/agentics-cli",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Agentics CLI - Pure orchestration layer for agentics platform services",
   "type": "module",
   "main": "./dist/cli/index.js",