@zds-ai/cli 0.1.0

package/dist/utils/hook-executor.js

@@ -0,0 +1,351 @@
+import { exec } from "child_process";
+import * as path from "path";
+import * as os from "os";
+import * as fs from "fs";
+const ENV_PREFIX = "ZDS_AI_AGENT_";
+/**
+ * Parse hook output for command directives
+ * Lines starting with "ENV ", "TOOL_RESULT ", "ECHO ", "RUN ", "BACKEND ", "MODEL ", "SYSTEM ", "SYSTEM_FILE ", "BASE_URL ", or "API_KEY_ENV_VAR " are commands
+ * Other lines are treated as TOOL_RESULT if present
+ */
+function parseHookOutput(stdout) {
+    const commands = [];
+    const lines = stdout.split("\n").filter((line) => line.trim());
+    for (const line of lines) {
+        if (line.startsWith("ENV ")) {
+            commands.push({ type: "ENV", value: line.slice(4) });
+        }
+        else if (line.startsWith("TOOL_RESULT ")) {
+            commands.push({ type: "TOOL_RESULT", value: line.slice(12) });
+        }
+        else if (line.startsWith("ECHO ")) {
+            commands.push({ type: "ECHO", value: line.slice(5) });
+        }
+        else if (line.startsWith("RUN ")) {
+            commands.push({ type: "RUN", value: line.slice(4) });
+        }
+        else if (line.startsWith("BACKEND ")) {
+            commands.push({ type: "BACKEND", value: line.slice(8) });
+        }
+        else if (line.startsWith("MODEL ")) {
+            commands.push({ type: "MODEL", value: line.slice(6) });
+        }
+        else if (line.startsWith("SYSTEM_FILE ")) {
+            commands.push({ type: "SYSTEM_FILE", value: line.slice(12) });
+        }
+        else if (line.startsWith("SYSTEM ")) {
+            commands.push({ type: "SYSTEM", value: line.slice(7) });
+        }
+        else if (line.startsWith("BASE_URL ")) {
+            commands.push({ type: "BASE_URL", value: line.slice(9) });
+        }
+        else if (line.startsWith("API_KEY_ENV_VAR ")) {
+            commands.push({ type: "API_KEY_ENV_VAR", value: line.slice(16) });
+        }
+        else if (line.trim()) {
+            // Non-empty lines without a command prefix are treated as TOOL_RESULT
+            commands.push({ type: "TOOL_RESULT", value: line });
+        }
+    }
+    return commands;
+}
+/**
+ * Apply hook commands and return extracted values
+ * ENV commands are applied to process.env (auto-prefixes ENV_PREFIX if not present)
+ * ENV VAR= (empty value) will unset the variable
+ * TOOL_RESULT commands are aggregated into a single string
+ * SYSTEM commands are aggregated into a single string
+ * SYSTEM_FILE commands read file contents (up to 20k) and add to system string
+ * MODEL commands set the model to use (last one wins if multiple)
+ * BACKEND commands set the backend to use (last one wins if multiple)
+ * BASE_URL commands set the base URL to use (last one wins if multiple)
+ * API_KEY_ENV_VAR commands set the env var name for API key (last one wins if multiple)
+ * Returns extracted values for caller to use
+ */
+export function applyHookCommands(commands) {
+    const env = {};
+    const toolResultLines = [];
+    const systemLines = [];
+    let model = undefined;
+    let backend = undefined;
+    let baseUrl = undefined;
+    let apiKeyEnvVar = undefined;
+    for (const cmd of commands) {
+        if (cmd.type === "ENV") {
+            // Parse "KEY=VALUE" - DO NOT apply to process.env yet, just extract
+            const match = cmd.value.match(/^([A-Z_]+)=(.*)$/);
+            if (match) {
+                let [, key, value] = match;
+                // If key doesn't start with ENV_PREFIX, prepend it
+                if (!key.startsWith(ENV_PREFIX)) {
+                    key = `${ENV_PREFIX}${key}`;
+                }
+                // Store ALL env variables for caller to apply after test succeeds
+                env[key] = value;
+            }
+        }
+        else if (cmd.type === "TOOL_RESULT") {
+            toolResultLines.push(cmd.value);
+        }
+        else if (cmd.type === "SYSTEM") {
+            systemLines.push(cmd.value);
+        }
+        else if (cmd.type === "SYSTEM_FILE") {
+            // Read file contents and add to system lines
+            const filePath = cmd.value.trim();
+            try {
+                // Expand ~ to home directory
+                const expandedPath = filePath.startsWith("~/")
+                    ? path.join(os.homedir(), filePath.slice(2))
+                    : filePath;
+                const MAX_FILE_SIZE = 20000;
+                // Check file size first
+                const stats = fs.statSync(expandedPath);
+                if (stats.size > MAX_FILE_SIZE) {
+                    // File is too large - read only first 20k bytes
+                    const fd = fs.openSync(expandedPath, 'r');
+                    const buffer = Buffer.alloc(MAX_FILE_SIZE);
+                    fs.readSync(fd, buffer, 0, MAX_FILE_SIZE, 0);
+                    fs.closeSync(fd);
+                    const truncated = buffer.toString('utf-8');
+                    systemLines.push(`${truncated}\n\n[File truncated at ${MAX_FILE_SIZE} characters]`);
+                }
+                else {
+                    // File is small enough - read entire file
+                    const fileContents = fs.readFileSync(expandedPath, 'utf-8');
+                    systemLines.push(fileContents);
+                }
+            }
+            catch (error) {
+                // Add error message to system lines if file can't be read
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                systemLines.push(`[Error reading file ${filePath}: ${errorMsg}]`);
+            }
+        }
+        else if (cmd.type === "MODEL") {
+            model = cmd.value.trim();
+        }
+        else if (cmd.type === "BACKEND") {
+            backend = cmd.value.trim();
+        }
+        else if (cmd.type === "BASE_URL") {
+            baseUrl = cmd.value.trim();
+        }
+        else if (cmd.type === "API_KEY_ENV_VAR") {
+            apiKeyEnvVar = cmd.value.trim();
+        }
+    }
+    return {
+        env,
+        toolResult: toolResultLines.join("\n"),
+        system: systemLines.join("\n"),
+        model,
+        backend,
+        baseUrl,
+        apiKeyEnvVar,
+    };
+}
+/**
+ * Apply extracted ENV variables to process.env
+ * Should be called AFTER model/backend tests succeed
+ * @param env Environment variables to apply
+ */
+export function applyEnvVariables(env) {
+    for (const [key, value] of Object.entries(env)) {
+        if (value === '') {
+            // Empty value means unset the variable
+            delete process.env[key];
+        }
+        else {
+            process.env[key] = value;
+        }
+    }
+}
+/**
+ * Execute a hook with operation details passed via environment variables
+ * Generic hook executor for operations that need validation
+ * @param hookPath Path to hook script (supports ~/ expansion)
+ * @param operation Operation type (e.g., "tool", "task", "persona", "mood")
+ * @param data Key-value pairs to pass as environment variables
+ * @param timeoutMs Timeout in milliseconds (default 30000)
+ * @param mandatory If true, timeout rejects instead of auto-approving
+ * @returns Promise<HookResult>
+ */
+export async function executeOperationHook(hookPath, operation, data, timeoutMs = 30000, mandatory = false, contextCurrent, contextMax) {
+    // Expand ~ to home directory
+    const expandedPath = hookPath.startsWith("~/")
+        ? path.join(os.homedir(), hookPath.slice(2))
+        : hookPath;
+    // Build environment using ZDS_AI_AGENT_* naming convention
+    // Note: These variables are only set in the child process and are automatically
+    // cleaned up when the child process exits. They do NOT modify the parent process environment.
+    const env = {
+        ...process.env,
+        [`${ENV_PREFIX}OPERATION`]: operation,
+    };
+    // Add context information if provided
+    if (contextCurrent !== undefined) {
+        env[`${ENV_PREFIX}CONTEXT_CURRENT`] = contextCurrent.toString();
+    }
+    if (contextMax !== undefined) {
+        env[`${ENV_PREFIX}CONTEXT_MAX`] = contextMax.toString();
+    }
+    // Add each data field as ZDS_AI_AGENT_PARAM_<KEY>=<VALUE>
+    for (const [key, value] of Object.entries(data)) {
+        const envKey = `${ENV_PREFIX}PARAM_${key.toUpperCase()}`;
+        env[envKey] = typeof value === 'string' ? value : JSON.stringify(value);
+    }
+    return new Promise((resolve) => {
+        // Execute hook with isolated environment (child process only)
+        const child = exec(expandedPath, { env, timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                // Check if it was a timeout
+                if (error.killed && error.signal === "SIGTERM") {
+                    // Timeout behavior depends on whether hook is mandatory
+                    if (mandatory) {
+                        // Mandatory hook timeout = reject
+                        resolve({
+                            approved: false,
+                            reason: "Hook timed out and is mandatory",
+                            timedOut: true,
+                        });
+                    }
+                    else {
+                        // Non-mandatory hook timeout = auto-approve (don't block the agent)
+                        resolve({
+                            approved: true,
+                            timedOut: true,
+                        });
+                    }
+                    return;
+                }
+                // Non-zero exit code = rejected
+                if (error.code && error.code > 0) {
+                    // Parse commands even on rejection
+                    const commands = parseHookOutput(stdout);
+                    // Extract TOOL_RESULT commands as the denial reason
+                    const toolResultLines = [];
+                    for (const cmd of commands) {
+                        if (cmd.type === "TOOL_RESULT") {
+                            toolResultLines.push(cmd.value);
+                        }
+                    }
+                    const reason = toolResultLines.length > 0
+                        ? toolResultLines.join("\n")
+                        : (stdout.trim() || stderr.trim() || "Operation denied by hook");
+                    resolve({
+                        approved: false,
+                        reason,
+                        timedOut: false,
+                        commands,
+                    });
+                    return;
+                }
+            }
+            // Exit code 0 = approved
+            const commands = parseHookOutput(stdout);
+            resolve({
+                approved: true,
+                timedOut: false,
+                commands,
+            });
+        });
+        // Handle timeout explicitly
+        setTimeout(() => {
+            try {
+                child.kill("SIGTERM");
+            }
+            catch (e) {
+                // Process may have already exited
+            }
+        }, timeoutMs);
+    });
+}
+/**
+ * Execute a tool approval hook with tool name and parameters passed via environment
+ * @param hookPath Path to hook script (supports ~/ expansion)
+ * @param toolName Name of the tool being executed
+ * @param parameters Tool parameters as key-value pairs
+ * @param timeoutMs Timeout in milliseconds (default 30000)
+ * @returns Promise<HookResult>
+ */
+export async function executeToolApprovalHook(hookPath, toolName, parameters, timeoutMs = 30000, contextCurrent, contextMax) {
+    // Expand ~ to home directory
+    const expandedPath = hookPath.startsWith("~/")
+        ? path.join(os.homedir(), hookPath.slice(2))
+        : hookPath;
+    // Build environment with tool info using ZDS_AI_AGENT_* naming convention
+    // Note: These variables are only set in the child process and are automatically
+    // cleaned up when the child process exits. They do NOT modify the parent process environment.
+    const env = {
+        ...process.env,
+        [`${ENV_PREFIX}TOOL_NAME`]: toolName,
+    };
+    // Add context information if provided
+    if (contextCurrent !== undefined) {
+        env[`${ENV_PREFIX}CONTEXT_CURRENT`] = contextCurrent.toString();
+    }
+    if (contextMax !== undefined) {
+        env[`${ENV_PREFIX}CONTEXT_MAX`] = contextMax.toString();
+    }
+    // Add each parameter as ZDS_AI_AGENT_PARAM_<KEY>=<VALUE>
+    for (const [key, value] of Object.entries(parameters)) {
+        const envKey = `${ENV_PREFIX}PARAM_${key.toUpperCase()}`;
+        env[envKey] = typeof value === 'string' ? value : JSON.stringify(value);
+    }
+    return new Promise((resolve) => {
+        // Execute hook with isolated environment (child process only)
+        const child = exec(expandedPath, { env, timeout: timeoutMs }, (error, stdout, stderr) => {
+            if (error) {
+                // Check if it was a timeout
+                if (error.killed && error.signal === "SIGTERM") {
+                    // Timeout = auto-approve (don't block the agent)
+                    resolve({
+                        approved: true,
+                        timedOut: true,
+                    });
+                    return;
+                }
+                // Non-zero exit code = rejected
+                if (error.code && error.code > 0) {
+                    // Parse commands even on rejection
+                    const commands = parseHookOutput(stdout);
+                    // Extract TOOL_RESULT commands as the denial reason
+                    const toolResultLines = [];
+                    for (const cmd of commands) {
+                        if (cmd.type === "TOOL_RESULT") {
+                            toolResultLines.push(cmd.value);
+                        }
+                    }
+                    const reason = toolResultLines.length > 0
+                        ? toolResultLines.join("\n")
+                        : (stdout.trim() || stderr.trim() || "Tool execution denied by hook");
+                    resolve({
+                        approved: false,
+                        reason,
+                        timedOut: false,
+                        commands,
+                    });
+                    return;
+                }
+            }
+            // Exit code 0 = approved
+            const commands = parseHookOutput(stdout);
+            resolve({
+                approved: true,
+                timedOut: false,
+                commands,
+            });
+        });
+        // Handle timeout explicitly
+        setTimeout(() => {
+            try {
+                child.kill("SIGTERM");
+            }
+            catch (e) {
+                // Process may have already exited
+            }
+        }, timeoutMs);
+    });
+}
+//# sourceMappingURL=hook-executor.js.map

package/dist/utils/hook-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-executor.js","sourceRoot":"","sources":["../../src/utils/hook-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,UAAU,GAAG,eAAe,CAAC;AAcnC;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,sEAAsE;YACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAYD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,KAAK,GAAuB,SAAS,CAAC;IAC1C,IAAI,OAAO,GAAuB,SAAS,CAAC;IAC5C,IAAI,OAAO,GAAuB,SAAS,CAAC;IAC5C,IAAI,YAAY,GAAuB,SAAS,CAAC;IAEjD,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACvB,oEAAoE;YACpE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YAClD,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;gBAC3B,mDAAmD;gBACnD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAChC,GAAG,GAAG,GAAG,UAAU,GAAG,GAAG,EAAE,CAAC;gBAC9B,CAAC;gBACD,kEAAkE;gBAClE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACnB,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACtC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACtC,6CAA6C;YAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,6BAA6B;gBAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;oBAC5C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC5C,CAAC,CAAC,QAAQ,CAAC;gBAEb,MAAM,aAAa,GAAG,KAAK,CAAC;gBAE5B,wBAAwB;gBACxB,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAExC,IAAI,KAAK,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;oBAC/B,gDAAgD;oBAChD,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;oBAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;oBAC3C,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;oBAC7C,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBACjB,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;oBAC3C,WAAW,CAAC,IAAI,CAAC,GAAG,SAAS,0BAA0B,aAAa,cAAc,CAAC,CAAC;gBACtF,CAAC;qBAAM,CAAC;oBACN,0CAA0C;oBAC1C,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBAC5D,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0DAA0D;gBAC1D,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxE,WAAW,CAAC,IAAI,CAAC,uBAAuB,QAAQ,KAAK,QAAQ,GAAG,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAChC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACnC,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC1C,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO;QACL,GAAG;QACH,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAC9B,KAAK;QACL,OAAO;QACP,OAAO;QACP,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAA2B;IAC3D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjB,uCAAuC;YACvC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAgB,EAChB,SAAiB,EACjB,IAAyB,EACzB,YAAoB,KAAK,EACzB,YAAqB,KAAK,EAC1B,cAAuB,EACvB,UAAmB;IAEnB,6BAA6B;IAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,QAAQ,CAAC;IAEb,2DAA2D;IAC3D,gFAAgF;IAChF,8FAA8F;IAC9F,MAAM,GAAG,GAA2B;QAClC,GAAG,OAAO,CAAC,GAA6B;QACxC,CAAC,GAAG,UAAU,WAAW,CAAC,EAAE,SAAS;KACtC,CAAC;IAEF,sCAAsC;IACtC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,CAAC,GAAG,UAAU,iBAAiB,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,GAAG,CAAC,GAAG,UAAU,aAAa,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,0DAA0D;IAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,GAAG,UAAU,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,8DAA8D;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACtF,IAAI,KAAK,EAAE,CAAC;gBACV,4BAA4B;gBAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/C,wDAAwD;oBACxD,IAAI,SAAS,EAAE,CAAC;wBACd,kCAAkC;wBAClC,OAAO,CAAC;4BACN,QAAQ,EAAE,KAAK;4BACf,MAAM,EAAE,iCAAiC;4BACzC,QAAQ,EAAE,IAAI;yBACf,CAAC,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACN,oEAAoE;wBACpE,OAAO,CAAC;4BACN,QAAQ,EAAE,IAAI;4BACd,QAAQ,EAAE,IAAI;yBACf,CAAC,CAAC;oBACL,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,gCAAgC;gBAChC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBACjC,mCAAmC;oBACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;oBAEzC,oDAAoD;oBACpD,MAAM,eAAe,GAAa,EAAE,CAAC;oBACrC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;wBAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;4BAC/B,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;wBAClC,CAAC;oBACH,CAAC;oBAED,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC;wBACvC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC5B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,0BAA0B,CAAC,CAAC;oBAEnE,OAAO,CAAC;wBACN,QAAQ,EAAE,KAAK;wBACf,MAAM;wBACN,QAAQ,EAAE,KAAK;wBACf,QAAQ;qBACT,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC;gBACN,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,KAAK;gBACf,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,kCAAkC;YACpC,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAAgB,EAChB,QAAgB,EAChB,UAA+B,EAC/B,YAAoB,KAAK,EACzB,cAAuB,EACvB,UAAmB;IAEnB,6BAA6B;IAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;QAC5C,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC,QAAQ,CAAC;IAEb,0EAA0E;IAC1E,gFAAgF;IAChF,8FAA8F;IAC9F,MAAM,GAAG,GAA2B;QAClC,GAAG,OAAO,CAAC,GAA6B;QACxC,CAAC,GAAG,UAAU,WAAW,CAAC,EAAE,QAAQ;KACrC,CAAC;IAEF,sCAAsC;IACtC,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,CAAC,GAAG,UAAU,iBAAiB,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,GAAG,CAAC,GAAG,UAAU,aAAa,CAAC,GAAG,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,yDAAyD;IACzD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,GAAG,UAAU,SAAS,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,8DAA8D;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACtF,IAAI,KAAK,EAAE,CAAC;gBACV,4BAA4B;gBAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC/C,iDAAiD;oBACjD,OAAO,CAAC;wBACN,QAAQ,EAAE,IAAI;wBACd,QAAQ,EAAE,IAAI;qBACf,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,gCAAgC;gBAChC,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBACjC,mCAAmC;oBACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;oBAEzC,oDAAoD;oBACpD,MAAM,eAAe,GAAa,EAAE,CAAC;oBACrC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;wBAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;4BAC/B,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;wBAClC,CAAC;oBACH,CAAC;oBAED,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC;wBACvC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;wBAC5B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,+BAA+B,CAAC,CAAC;oBAExE,OAAO,CAAC;wBACN,QAAQ,EAAE,KAAK;wBACf,MAAM;wBACN,QAAQ,EAAE,KAAK;wBACf,QAAQ;qBACT,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;YACH,CAAC;YAED,yBAAyB;YACzB,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACzC,OAAO,CAAC;gBACN,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,KAAK;gBACf,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,UAAU,CAAC,GAAG,EAAE;YACd,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,kCAAkC;YACpC,CAAC;QACH,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/model-config.d.ts

@@ -0,0 +1,28 @@
+import { UserSettings, ProjectSettings } from './settings-manager.js';
+export interface ModelOption {
+    model: string;
+}
+export type ModelConfig = string;
+export { UserSettings, ProjectSettings };
+/**
+ * Get the effective current model
+ * Priority: project current model > user default model > system default
+ */
+export declare function getCurrentModel(): string;
+/**
+ * Load model configuration
+ * Priority: user-settings.json models > default hardcoded
+ */
+export declare function loadModelConfig(): ModelOption[];
+/**
+ * Get default models list
+ */
+export declare function getDefaultModels(): string[];
+/**
+ * Update the current model in project settings
+ */
+export declare function updateCurrentModel(modelName: string): void;
+/**
+ * Update the user's default model preference
+ */
+export declare function updateDefaultModel(modelName: string): void;

package/dist/utils/model-config.js

@@ -0,0 +1,42 @@
+import { getSettingsManager } from './settings-manager.js';
+/**
+ * Get the effective current model
+ * Priority: project current model > user default model > system default
+ */
+export function getCurrentModel() {
+    const manager = getSettingsManager();
+    return manager.getCurrentModel();
+}
+/**
+ * Load model configuration
+ * Priority: user-settings.json models > default hardcoded
+ */
+export function loadModelConfig() {
+    const manager = getSettingsManager();
+    const models = manager.getAvailableModels();
+    return models.map(model => ({
+        model: model.trim()
+    }));
+}
+/**
+ * Get default models list
+ */
+export function getDefaultModels() {
+    const manager = getSettingsManager();
+    return manager.getAvailableModels();
+}
+/**
+ * Update the current model in project settings
+ */
+export function updateCurrentModel(modelName) {
+    const manager = getSettingsManager();
+    manager.setCurrentModel(modelName);
+}
+/**
+ * Update the user's default model preference
+ */
+export function updateDefaultModel(modelName) {
+    const manager = getSettingsManager();
+    manager.updateUserSetting('defaultModel', modelName);
+}
+//# sourceMappingURL=model-config.js.map

package/dist/utils/model-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-config.js","sourceRoot":"","sources":["../../src/utils/model-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAiC,MAAM,uBAAuB,CAAC;AAW1F;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAE5C,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;KACpB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,OAAO,CAAC,kBAAkB,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IACrC,OAAO,CAAC,iBAAiB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/dist/utils/path-utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Expands ~ in file paths to the user's home directory
+ */
+export declare function expandHomeDir(filePath: string): string;

package/dist/utils/path-utils.js

@@ -0,0 +1,12 @@
+import * as os from 'os';
+import * as path from 'path';
+/**
+ * Expands ~ in file paths to the user's home directory
+ */
+export function expandHomeDir(filePath) {
+    if (filePath.startsWith('~')) {
+        return path.join(os.homedir(), filePath.slice(1));
+    }
+    return filePath;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/utils/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../src/utils/path-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/settings-manager.d.ts

@@ -0,0 +1,169 @@
+/**
+ * User-level settings stored in ~/.grok/user-settings.json
+ * These are global settings that apply across all projects
+ */
+export interface UserSettings {
+    apiKey?: string;
+    baseURL?: string;
+    defaultModel?: string;
+    models?: string[];
+    temperature?: number;
+    maxTokens?: number;
+    startupHook?: string;
+    instanceHook?: string;
+    taskApprovalHook?: string;
+    toolApprovalHook?: string;
+    personaHook?: string;
+    personaHookMandatory?: boolean;
+    moodHook?: string;
+    moodHookMandatory?: boolean;
+    contextViewHelper?: string;
+    contextViewHelperGui?: string;
+    contextEditHelper?: string;
+    contextEditHelperGui?: string;
+    mcpServers?: Record<string, any>;
+}
+/**
+ * Project-level settings stored in .grok/settings.json
+ * These are project-specific settings
+ */
+export interface ProjectSettings {
+    model?: string;
+    mcpServers?: Record<string, any>;
+}
+/**
+ * Unified settings manager that handles both user-level and project-level settings
+ */
+export declare class SettingsManager {
+    private static instance;
+    private userSettingsPath;
+    private projectSettingsPath;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): SettingsManager;
+    /**
+     * Ensure directory exists for a given file path
+     */
+    private ensureDirectoryExists;
+    /**
+     * Load user settings from ~/.grok/user-settings.json
+     */
+    loadUserSettings(): UserSettings;
+    /**
+     * Save user settings to ~/.grok/user-settings.json
+     */
+    saveUserSettings(settings: Partial<UserSettings>): void;
+    /**
+     * Update a specific user setting
+     */
+    updateUserSetting<K extends keyof UserSettings>(key: K, value: UserSettings[K]): void;
+    /**
+     * Get a specific user setting
+     */
+    getUserSetting<K extends keyof UserSettings>(key: K): UserSettings[K];
+    /**
+     * Load project settings from .grok/settings.json
+     */
+    loadProjectSettings(): ProjectSettings;
+    /**
+     * Save project settings to .grok/settings.json
+     * Note: This is a no-op - project settings are not used in ZDS agent workflow
+     */
+    saveProjectSettings(settings: Partial<ProjectSettings>): void;
+    /**
+     * Update a specific project setting
+     */
+    updateProjectSetting<K extends keyof ProjectSettings>(key: K, value: ProjectSettings[K]): void;
+    /**
+     * Get a specific project setting
+     */
+    getProjectSetting<K extends keyof ProjectSettings>(key: K): ProjectSettings[K];
+    /**
+     * Get the current model with proper fallback logic:
+     * 1. Project-specific model setting
+     * 2. User's default model
+     * 3. System default
+     */
+    getCurrentModel(): string;
+    /**
+     * Set the current model for the project
+     */
+    setCurrentModel(model: string): void;
+    /**
+     * Get available models list from user settings
+     */
+    getAvailableModels(): string[];
+    /**
+     * Get API key from user settings or environment
+     */
+    getApiKey(): string | undefined;
+    /**
+     * Get startup hook command from user settings
+     */
+    getStartupHook(): string | undefined;
+    /**
+     * Get instance hook command from user settings
+     */
+    getInstanceHook(): string | undefined;
+    /**
+     * Get task approval hook command from user settings
+     * Used for validating all task operations (start/transition/stop)
+     */
+    getTaskApprovalHook(): string | undefined;
+    /**
+     * Get tool approval hook command from user settings
+     */
+    getToolApprovalHook(): string | undefined;
+    /**
+     * Get persona hook command from user settings
+     */
+    getPersonaHook(): string | undefined;
+    /**
+     * Check if persona hook is mandatory
+     */
+    isPersonaHookMandatory(): boolean;
+    /**
+     * Get mood hook command from user settings
+     */
+    getMoodHook(): string | undefined;
+    /**
+     * Check if mood hook is mandatory
+     */
+    isMoodHookMandatory(): boolean;
+    /**
+     * Detect if we're running in a GUI environment or text-only (SSH/terminal)
+     * Returns true if GUI is available, false for text-only
+     */
+    isGuiAvailable(): boolean;
+    /**
+     * Get context view helper command from user settings
+     * Auto-detects GUI vs text-only environment
+     */
+    getContextViewHelper(): string;
+    /**
+     * Get context edit helper command from user settings
+     * Auto-detects GUI vs text-only environment
+     */
+    getContextEditHelper(): string;
+    /**
+     * Get base URL from user settings or environment
+     */
+    getBaseURL(): string;
+    /**
+     * Get temperature from user settings
+     * Defaults to 0.7 if not set
+     */
+    getTemperature(): number;
+    /**
+     * Get max tokens from user settings or environment
+     * Priority: user settings > ZDS_AI_AGENT_MAX_TOKENS env var > undefined
+     * Returns undefined if not set (allows API to use its default)
+     */
+    getMaxTokens(): number | undefined;
+}
+/**
+ * Convenience function to get the singleton instance
+ */
+export declare function getSettingsManager(): SettingsManager;