@praveencs/agent 0.8.8 → 0.9.0

package/dist/src/scripts/loader.js

@@ -0,0 +1,269 @@
+import { readFile, readdir, access } from 'node:fs/promises';
+import path from 'node:path';
+import { ScriptManifestSchema } from './types.js';
+import { validateSchema } from '../utils/schema.js';
+/**
+ * Script Loader — discovers, validates, and loads scripts
+ *
+ * Scripts are directories containing a `script.yaml` manifest and an
+ * entrypoint file (shell, Node, Python, etc.).
+ *
+ * Default location: `.agent/scripts/`
+ * Also loaded from plugins via `plugin.json` → `scripts` field.
+ */
+export class ScriptLoader {
+    scripts = new Map();
+    /**
+     * Load scripts from all configured install paths
+     */
+    async loadAll(installPaths, projectRoot) {
+        this.scripts.clear();
+        for (const scriptPath of installPaths) {
+            const absPath = path.resolve(projectRoot, scriptPath);
+            await this.loadFromDirectory(absPath, 'project');
+        }
+        return Array.from(this.scripts.values());
+    }
+    /**
+     * Load scripts from the default project location (.agent/scripts/)
+     */
+    async loadProjectScripts(projectRoot) {
+        const scriptsDir = path.join(projectRoot, '.agent', 'scripts');
+        return this.loadFromDirectory(scriptsDir, 'project');
+    }
+    /**
+     * Load scripts from a directory
+     */
+    async loadFromDirectory(dirPath, source = 'project') {
+        try {
+            await access(dirPath);
+        }
+        catch {
+            return 0; // Directory doesn't exist
+        }
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        let count = 0;
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const scriptDir = path.join(dirPath, entry.name);
+            const script = await this.loadScript(scriptDir, source);
+            if (script) {
+                this.scripts.set(script.manifest.name, script);
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Load a single script from its directory
+     */
+    async loadScript(scriptDir, source = 'project') {
+        // Try script.yaml first, then script.yml, then script.json
+        let manifestPath = null;
+        for (const filename of ['script.yaml', 'script.yml', 'script.json']) {
+            const candidate = path.join(scriptDir, filename);
+            try {
+                await access(candidate);
+                manifestPath = candidate;
+                break;
+            }
+            catch {
+                // Try next
+            }
+        }
+        if (!manifestPath) {
+            return null; // No manifest found
+        }
+        try {
+            const content = await readFile(manifestPath, 'utf-8');
+            let raw;
+            if (manifestPath.endsWith('.json')) {
+                raw = JSON.parse(content);
+            }
+            else {
+                // Simple YAML parser for flat structures
+                raw = this.parseSimpleYaml(content);
+            }
+            const result = validateSchema(ScriptManifestSchema, raw, `script manifest in ${path.basename(scriptDir)}`);
+            if (!result.success) {
+                console.error(`Invalid script manifest at ${manifestPath}:\n${result.errors.join('\n')}`);
+                return null;
+            }
+            const manifest = result.data;
+            const entrypointPath = path.resolve(scriptDir, manifest.entrypoint);
+            // Verify entrypoint exists
+            try {
+                await access(entrypointPath);
+            }
+            catch {
+                console.error(`Script entrypoint not found: ${entrypointPath}`);
+                return null;
+            }
+            return {
+                manifest,
+                path: scriptDir,
+                entrypointPath,
+                source,
+            };
+        }
+        catch (err) {
+            console.error(`Failed to load script from ${scriptDir}: ${err.message}`);
+            return null;
+        }
+    }
+    /**
+     * Simple YAML parser — handles flat key: value, arrays, and nested objects
+     */
+    parseSimpleYaml(content) {
+        const result = {};
+        const lines = content.split('\n');
+        let currentKey = null;
+        let currentObject = null;
+        let currentSubKey = null;
+        let currentSubObject = null;
+        for (const line of lines) {
+            // Skip comments and empty lines
+            if (line.trim().startsWith('#') || line.trim() === '')
+                continue;
+            if (line.trim() === '---')
+                continue;
+            const indent = line.length - line.trimStart().length;
+            if (indent === 0) {
+                // Top-level key
+                if (currentSubObject && currentSubKey && currentObject) {
+                    currentObject[currentSubKey] = currentSubObject;
+                    currentSubObject = null;
+                    currentSubKey = null;
+                }
+                if (currentObject && currentKey) {
+                    result[currentKey] = currentObject;
+                    currentObject = null;
+                }
+                const colonIdx = line.indexOf(':');
+                if (colonIdx === -1)
+                    continue;
+                const key = line.slice(0, colonIdx).trim();
+                const value = line.slice(colonIdx + 1).trim();
+                if (value === '') {
+                    // Start of a nested object or array
+                    currentKey = key;
+                    currentObject = {};
+                }
+                else {
+                    result[key] = this.parseYamlValue(value);
+                    currentKey = null;
+                }
+            }
+            else if (indent >= 2 && indent < 4 && currentKey) {
+                // First-level nesting
+                if (currentSubObject && currentSubKey && currentObject) {
+                    currentObject[currentSubKey] = currentSubObject;
+                    currentSubObject = null;
+                    currentSubKey = null;
+                }
+                const trimmed = line.trim();
+                // Array item
+                if (trimmed.startsWith('- ')) {
+                    const item = trimmed.slice(2).trim();
+                    if (!Array.isArray(currentObject)) {
+                        if (currentKey)
+                            result[currentKey] = [];
+                        currentObject = null;
+                    }
+                    const arr = result[currentKey];
+                    if (!Array.isArray(arr)) {
+                        result[currentKey] = [this.parseYamlValue(item)];
+                    }
+                    else {
+                        arr.push(this.parseYamlValue(item));
+                    }
+                    continue;
+                }
+                const colonIdx = trimmed.indexOf(':');
+                if (colonIdx === -1)
+                    continue;
+                const subKey = trimmed.slice(0, colonIdx).trim();
+                const subValue = trimmed.slice(colonIdx + 1).trim();
+                if (!currentObject || Array.isArray(currentObject)) {
+                    currentObject = {};
+                }
+                if (subValue === '') {
+                    currentSubKey = subKey;
+                    currentSubObject = {};
+                }
+                else {
+                    currentObject[subKey] = this.parseYamlValue(subValue);
+                }
+            }
+            else if (indent >= 4 && currentSubKey && currentSubObject) {
+                // Second-level nesting
+                const trimmed = line.trim();
+                const colonIdx = trimmed.indexOf(':');
+                if (colonIdx === -1)
+                    continue;
+                const deepKey = trimmed.slice(0, colonIdx).trim();
+                const deepValue = trimmed.slice(colonIdx + 1).trim();
+                currentSubObject[deepKey] = this.parseYamlValue(deepValue);
+            }
+        }
+        // Flush remaining
+        if (currentSubObject && currentSubKey && currentObject && !Array.isArray(currentObject)) {
+            currentObject[currentSubKey] = currentSubObject;
+        }
+        if (currentObject && currentKey && !Array.isArray(result[currentKey])) {
+            result[currentKey] = currentObject;
+        }
+        return result;
+    }
+    /**
+     * Parse a YAML scalar value
+     */
+    parseYamlValue(value) {
+        if (value === 'true')
+            return true;
+        if (value === 'false')
+            return false;
+        if (value === 'null' || value === '~')
+            return null;
+        // Number
+        if (/^-?\d+(\.\d+)?$/.test(value)) {
+            return Number(value);
+        }
+        // Inline array [item1, item2]
+        if (value.startsWith('[') && value.endsWith(']')) {
+            return value.slice(1, -1).split(',').map(s => s.trim()).filter(Boolean);
+        }
+        // Strip quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            return value.slice(1, -1);
+        }
+        return value;
+    }
+    /**
+     * Get a loaded script by name
+     */
+    get(name) {
+        return this.scripts.get(name);
+    }
+    /**
+     * Check if a script exists
+     */
+    has(name) {
+        return this.scripts.has(name);
+    }
+    /**
+     * List all loaded scripts
+     */
+    list() {
+        return Array.from(this.scripts.values());
+    }
+    /**
+     * Get count of loaded scripts
+     */
+    get size() {
+        return this.scripts.size;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/src/scripts/loader.js.map

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

package/dist/src/scripts/runner.d.ts

@@ -0,0 +1,30 @@
+import type { LoadedScript, ScriptRunResult } from './types.js';
+/**
+ * Script Runner — executes scripts as child processes
+ *
+ * Features:
+ * - Auto-detects interpreter from file extension
+ * - Injects env vars and script args as SCRIPT_ARG_* env vars
+ * - Applies timeout from manifest
+ * - Streams stdout/stderr in real-time
+ * - Returns structured result with exit code
+ */
+export declare class ScriptRunner {
+    /**
+     * Execute a loaded script with optional arguments
+     */
+    run(script: LoadedScript, args?: Record<string, string | boolean | number>, options?: {
+        projectRoot?: string;
+        onStdout?: (data: string) => void;
+        onStderr?: (data: string) => void;
+    }): Promise<ScriptRunResult>;
+    /**
+     * Determine the interpreter and args from the script's entrypoint extension
+     */
+    private resolveInterpreter;
+    /**
+     * Resolve args by merging provided values with defaults
+     */
+    private resolveArgs;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/src/scripts/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/scripts/runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAgB,MAAM,YAAY,CAAC;AAE9E;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACrB;;OAEG;IACG,GAAG,CACL,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAM,EACpD,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;KAAO,GAC7G,OAAO,CAAC,eAAe,CAAC;IA6G3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmC1B;;OAEG;IACH,OAAO,CAAC,WAAW;CAuBtB"}

package/dist/src/scripts/runner.js

@@ -0,0 +1,169 @@
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+/**
+ * Script Runner — executes scripts as child processes
+ *
+ * Features:
+ * - Auto-detects interpreter from file extension
+ * - Injects env vars and script args as SCRIPT_ARG_* env vars
+ * - Applies timeout from manifest
+ * - Streams stdout/stderr in real-time
+ * - Returns structured result with exit code
+ */
+export class ScriptRunner {
+    /**
+     * Execute a loaded script with optional arguments
+     */
+    async run(script, args = {}, options = {}) {
+        const start = Date.now();
+        const manifest = script.manifest;
+        // Validate required args
+        if (manifest.args) {
+            for (const [argName, argDef] of Object.entries(manifest.args)) {
+                if (argDef.required && !(argName in args) && argDef.default === undefined) {
+                    return {
+                        success: false,
+                        exitCode: 1,
+                        stdout: '',
+                        stderr: `Missing required argument: ${argName} — ${argDef.description}`,
+                        durationMs: Date.now() - start,
+                    };
+                }
+            }
+        }
+        // Resolve working directory
+        const projectRoot = options.projectRoot ?? process.cwd();
+        const cwd = path.resolve(projectRoot, manifest.cwd ?? '.');
+        // Determine interpreter
+        const { command, commandArgs } = this.resolveInterpreter(script);
+        // Build environment variables
+        const env = {
+            ...process.env,
+            SCRIPT_NAME: manifest.name,
+            SCRIPT_DIR: script.path,
+            ...(manifest.env ?? {}),
+        };
+        // Inject args as SCRIPT_ARG_* env vars and as positional hints
+        const resolvedArgs = this.resolveArgs(manifest.args ?? {}, args);
+        for (const [key, value] of Object.entries(resolvedArgs)) {
+            env[`SCRIPT_ARG_${key.toUpperCase().replace(/-/g, '_')}`] = String(value);
+        }
+        return new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            const proc = spawn(command, commandArgs, {
+                cwd,
+                env,
+                stdio: ['inherit', 'pipe', 'pipe'],
+                shell: command === 'bash' || command === 'sh' || command === 'zsh',
+            });
+            // Timeout handling
+            const timeout = manifest.timeout ?? 300_000;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                proc.kill('SIGTERM');
+                setTimeout(() => proc.kill('SIGKILL'), 5000);
+            }, timeout);
+            proc.stdout?.on('data', (data) => {
+                const text = data.toString();
+                stdout += text;
+                if (options.onStdout) {
+                    options.onStdout(text);
+                }
+                else {
+                    process.stdout.write(text);
+                }
+            });
+            proc.stderr?.on('data', (data) => {
+                const text = data.toString();
+                stderr += text;
+                if (options.onStderr) {
+                    options.onStderr(text);
+                }
+                else {
+                    process.stderr.write(text);
+                }
+            });
+            proc.on('close', (code) => {
+                clearTimeout(timer);
+                if (timedOut) {
+                    stderr += `\nScript timed out after ${timeout}ms`;
+                }
+                resolve({
+                    success: code === 0 && !timedOut,
+                    exitCode: code ?? 1,
+                    stdout: stdout.trim(),
+                    stderr: stderr.trim(),
+                    durationMs: Date.now() - start,
+                });
+            });
+            proc.on('error', (err) => {
+                clearTimeout(timer);
+                resolve({
+                    success: false,
+                    exitCode: 1,
+                    stdout: '',
+                    stderr: err.message,
+                    durationMs: Date.now() - start,
+                });
+            });
+        });
+    }
+    /**
+     * Determine the interpreter and args from the script's entrypoint extension
+     */
+    resolveInterpreter(script) {
+        const { manifest, entrypointPath } = script;
+        if (manifest.interpreter) {
+            return {
+                command: manifest.interpreter,
+                commandArgs: [entrypointPath],
+            };
+        }
+        const ext = path.extname(entrypointPath).toLowerCase();
+        switch (ext) {
+            case '.sh':
+            case '.bash':
+                return { command: 'bash', commandArgs: [entrypointPath] };
+            case '.zsh':
+                return { command: 'zsh', commandArgs: [entrypointPath] };
+            case '.ts':
+                return { command: 'npx', commandArgs: ['tsx', entrypointPath] };
+            case '.mts':
+                return { command: 'npx', commandArgs: ['tsx', entrypointPath] };
+            case '.js':
+            case '.mjs':
+                return { command: 'node', commandArgs: [entrypointPath] };
+            case '.py':
+                return { command: 'python3', commandArgs: [entrypointPath] };
+            case '.rb':
+                return { command: 'ruby', commandArgs: [entrypointPath] };
+            default:
+                // Try to execute directly (must be executable)
+                return { command: entrypointPath, commandArgs: [] };
+        }
+    }
+    /**
+     * Resolve args by merging provided values with defaults
+     */
+    resolveArgs(argDefs, provided) {
+        const resolved = {};
+        for (const [name, def] of Object.entries(argDefs)) {
+            if (name in provided) {
+                resolved[name] = provided[name];
+            }
+            else if (def.default !== undefined) {
+                resolved[name] = def.default;
+            }
+        }
+        // Also pass through any extra args not in the manifest
+        for (const [name, value] of Object.entries(provided)) {
+            if (!(name in resolved)) {
+                resolved[name] = value;
+            }
+        }
+        return resolved;
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/src/scripts/runner.js.map

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

package/dist/src/scripts/types.d.ts

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+/**
+ * Script System — Types
+ *
+ * Scripts are repeatable, scriptable tasks — direct execution of shell/Node
+ * scripts without LLM involvement. They fill the gap between heavy Skills
+ * (LLM-driven) and lightweight Commands (markdown prompts).
+ *
+ * Scripts live in `.agent/scripts/` or inside plugins, defined via `script.yaml`.
+ */
+export interface ScriptArgDef {
+    /** Human-readable description of the argument */
+    description: string;
+    /** Argument type: string, boolean, or number */
+    type?: 'string' | 'boolean' | 'number';
+    /** Default value if not provided */
+    default?: string | boolean | number;
+    /** Whether this argument is required */
+    required?: boolean;
+}
+export interface ScriptManifest {
+    /** Unique script name */
+    name: string;
+    /** Semver version */
+    version?: string;
+    /** Human-readable description */
+    description: string;
+    /** Author name */
+    author?: string;
+    /** The script file to execute (relative to script directory) */
+    entrypoint: string;
+    /** Interpreter override (auto-detected from extension if omitted) */
+    interpreter?: string;
+    /** Environment variables to inject */
+    env?: Record<string, string>;
+    /** Named arguments with definitions */
+    args?: Record<string, ScriptArgDef>;
+    /** Working directory relative to project root (default: '.') */
+    cwd?: string;
+    /** Timeout in ms (default: 300000 = 5 min) */
+    timeout?: number;
+    /** Whether to prompt for confirmation before execution */
+    confirm?: boolean;
+    /** Tags for discoverability */
+    tags?: string[];
+}
+export declare const ScriptManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    author: z.ZodOptional<z.ZodString>;
+    entrypoint: z.ZodString;
+    interpreter: z.ZodOptional<z.ZodString>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        type: z.ZodDefault<z.ZodEnum<["string", "boolean", "number"]>>;
+        default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodBoolean, z.ZodNumber]>>;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean";
+        required: boolean;
+        description: string;
+        default?: string | number | boolean | undefined;
+    }, {
+        description: string;
+        type?: "string" | "number" | "boolean" | undefined;
+        required?: boolean | undefined;
+        default?: string | number | boolean | undefined;
+    }>>>;
+    cwd: z.ZodDefault<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    confirm: boolean;
+    timeout: number;
+    name: string;
+    cwd: string;
+    description: string;
+    entrypoint: string;
+    args?: Record<string, {
+        type: "string" | "number" | "boolean";
+        required: boolean;
+        description: string;
+        default?: string | number | boolean | undefined;
+    }> | undefined;
+    env?: Record<string, string> | undefined;
+    author?: string | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+    interpreter?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    entrypoint: string;
+    confirm?: boolean | undefined;
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+    args?: Record<string, {
+        description: string;
+        type?: "string" | "number" | "boolean" | undefined;
+        required?: boolean | undefined;
+        default?: string | number | boolean | undefined;
+    }> | undefined;
+    env?: Record<string, string> | undefined;
+    author?: string | undefined;
+    version?: string | undefined;
+    tags?: string[] | undefined;
+    interpreter?: string | undefined;
+}>;
+export interface LoadedScript {
+    /** Parsed manifest */
+    manifest: ScriptManifest;
+    /** Absolute path to the script directory */
+    path: string;
+    /** Absolute path to the entrypoint file */
+    entrypointPath: string;
+    /** Source: 'project' or plugin name */
+    source: string;
+}
+export interface ScriptRunResult {
+    /** Whether the script exited with code 0 */
+    success: boolean;
+    /** Process exit code */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Duration in milliseconds */
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/scripts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/scripts/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAIH,MAAM,WAAW,YAAY;IACzB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACpC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAID,MAAM,WAAW,cAAc;IAC3B,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpC,gEAAgE;IAChE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAWD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa/B,CAAC;AAIH,MAAM,WAAW,YAAY;IACzB,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,eAAe;IAC5B,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;CACtB"}

package/dist/src/scripts/types.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+// ─── Zod Schema for Validation ───
+const ScriptArgDefSchema = z.object({
+    description: z.string(),
+    type: z.enum(['string', 'boolean', 'number']).default('string'),
+    default: z.union([z.string(), z.boolean(), z.number()]).optional(),
+    required: z.boolean().default(false),
+});
+export const ScriptManifestSchema = z.object({
+    name: z.string().min(1).regex(/^[a-z0-9][a-z0-9._-]*$/, 'Must be lowercase alphanumeric with dots, underscores, hyphens'),
+    version: z.string().optional(),
+    description: z.string().min(1),
+    author: z.string().optional(),
+    entrypoint: z.string().min(1),
+    interpreter: z.string().optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    args: z.record(z.string(), ScriptArgDefSchema).optional(),
+    cwd: z.string().default('.'),
+    timeout: z.number().default(300_000),
+    confirm: z.boolean().default(false),
+    tags: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/src/scripts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/scripts/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsDxB,oCAAoC;AAEpC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,wBAAwB,EAAE,gEAAgE,CAAC;IACzH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IACzD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC"}