cray-code 1.0.0

package/dist/state/AppState.d.ts

@@ -0,0 +1,70 @@
+/**
+ * AppState — Central state management for Cray Code.
+ *
+ * Uses a simple Store pattern (similar to Zustand/Redux) with:
+ * - Immutable state updates via setState(fn)
+ * - Subscription-based reactivity
+ * - Sub-agent context isolation
+ */
+import type { Message, ConversationState } from '../types/message.js';
+import type { ToolPermissionContext } from '../types/permission.js';
+import type { ToolDef, MCPClientInfo, SkillInfo, AgentDefinitionInfo, ModelConfig } from '../Tool.js';
+export interface AppState {
+    sessionId: string;
+    startTime: number;
+    cwd: string;
+    projectRoot?: string;
+    modelConfig: ModelConfig;
+    modelOverride?: string;
+    messages: Message[];
+    conversationHistory: ConversationState[];
+    permissionContext: ToolPermissionContext;
+    toolPool: ToolDef<any, any>[];
+    mcpClients: Map<string, MCPClientInfo>;
+    skills: SkillInfo[];
+    availableSkills: SkillInfo[];
+    agentDefinitions: AgentDefinitionInfo[];
+    isSubAgent: boolean;
+    isPlanMode: boolean;
+    isVerbose: boolean;
+    statusText: string;
+    backgroundTasks: Map<string, BackgroundTaskInfo>;
+    settings: CraySettings;
+}
+export interface BackgroundTaskInfo {
+    id: string;
+    type: 'bash' | 'agent';
+    description: string;
+    status: 'running' | 'completed' | 'failed';
+    startTime: number;
+    output?: string;
+    error?: string;
+}
+export interface CraySettings {
+    model: string;
+    permissionMode: 'default' | 'acceptEdits' | 'bypass' | 'plan';
+    maxTurns: number;
+    verbose: boolean;
+    theme: 'dark' | 'light';
+}
+export declare function createDefaultAppState(cwd?: string): AppState;
+type Listener = (state: AppState) => void;
+declare class Store {
+    private state;
+    private listeners;
+    constructor(initialState: AppState);
+    getState(): AppState;
+    setState(updater: (prev: AppState) => AppState): void;
+    subscribe(listener: Listener): () => void;
+    private notify;
+}
+/** Initialize the global app state store */
+export declare function initAppState(cwd?: string): Store;
+/** Get the global store (throws if not initialized) */
+export declare function getStore(): Store;
+/** Convenience: get current app state */
+export declare function getAppState(): AppState;
+/** Convenience: update app state */
+export declare function setAppState(updater: (prev: AppState) => AppState): void;
+export {};
+//# sourceMappingURL=AppState.d.ts.map

package/dist/state/AppState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppState.d.ts","sourceRoot":"","sources":["../../src/state/AppState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMtG,MAAM,WAAW,QAAQ;IAEvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IAGzC,iBAAiB,EAAE,qBAAqB,CAAC;IAGzC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;IAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAGvC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,eAAe,EAAE,SAAS,EAAE,CAAC;IAG7B,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IACxC,UAAU,EAAE,OAAO,CAAC;IAGpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IAGnB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAGjD,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAID,wBAAgB,qBAAqB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,QAAQ,CAkD5D;AAID,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAE1C,cAAM,KAAK;IACT,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,SAAS,CAAuB;gBAE5B,YAAY,EAAE,QAAQ;IAIlC,QAAQ,IAAI,QAAQ;IAIpB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,GAAG,IAAI;IAQrD,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAKzC,OAAO,CAAC,MAAM;CASf;AAMD,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAGhD;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,IAAI,KAAK,CAKhC;AAED,yCAAyC;AACzC,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED,oCAAoC;AACpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,GAAG,IAAI,CAEvE"}

package/dist/state/AppState.js

@@ -0,0 +1,106 @@
+/**
+ * AppState — Central state management for Cray Code.
+ *
+ * Uses a simple Store pattern (similar to Zustand/Redux) with:
+ * - Immutable state updates via setState(fn)
+ * - Subscription-based reactivity
+ * - Sub-agent context isolation
+ */
+import { getDefaultPermissionContext } from '../types/permission.js';
+import { BUILT_IN_AGENTS } from '../tools/AgentTool.js';
+// ─── Default State ───────────────────────────────────────────────────────
+export function createDefaultAppState(cwd) {
+    const sessionId = `cray-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    return {
+        sessionId,
+        startTime: Date.now(),
+        cwd: cwd ?? process.cwd(),
+        projectRoot: undefined,
+        modelConfig: {
+            provider: 'generic',
+            model: 'claude-sonnet-4-6',
+            maxTokens: 8192,
+            thinkingEnabled: true,
+            apiKey: '',
+            baseUrl: '',
+        },
+        messages: [],
+        conversationHistory: [],
+        permissionContext: getDefaultPermissionContext(),
+        toolPool: [],
+        mcpClients: new Map(),
+        skills: [],
+        availableSkills: [],
+        agentDefinitions: Object.entries(BUILT_IN_AGENTS).map(([name, def]) => ({
+            name,
+            description: def.description,
+            allowedTools: def.allowedTools,
+        })),
+        isSubAgent: false,
+        isPlanMode: false,
+        isVerbose: false,
+        statusText: 'Ready',
+        backgroundTasks: new Map(),
+        settings: {
+            model: 'claude-sonnet-4-6',
+            permissionMode: 'default',
+            maxTurns: 25,
+            verbose: false,
+            theme: 'dark',
+        },
+    };
+}
+class Store {
+    state;
+    listeners = new Set();
+    constructor(initialState) {
+        this.state = Object.freeze(initialState);
+    }
+    getState() {
+        return this.state;
+    }
+    setState(updater) {
+        const newState = updater(this.state);
+        if (newState !== this.state) {
+            this.state = Object.freeze(newState);
+            this.notify();
+        }
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    notify() {
+        for (const listener of this.listeners) {
+            try {
+                listener(this.state);
+            }
+            catch {
+                // Listener errors shouldn't break the store
+            }
+        }
+    }
+}
+// ─── Global Store Instance ──────────────────────────────────────────────
+let globalStore = null;
+/** Initialize the global app state store */
+export function initAppState(cwd) {
+    globalStore = new Store(createDefaultAppState(cwd));
+    return globalStore;
+}
+/** Get the global store (throws if not initialized) */
+export function getStore() {
+    if (!globalStore) {
+        globalStore = new Store(createDefaultAppState());
+    }
+    return globalStore;
+}
+/** Convenience: get current app state */
+export function getAppState() {
+    return getStore().getState();
+}
+/** Convenience: update app state */
+export function setAppState(updater) {
+    getStore().setState(updater);
+}
+//# sourceMappingURL=AppState.js.map

package/dist/state/AppState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppState.js","sourceRoot":"","sources":["../../src/state/AppState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAgExD,4EAA4E;AAE5E,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAE9F,OAAO;QACL,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,GAAG,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACzB,WAAW,EAAE,SAAS;QAEtB,WAAW,EAAE;YACX,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,mBAAmB;YAC1B,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;SACZ;QAED,QAAQ,EAAE,EAAE;QACZ,mBAAmB,EAAE,EAAE;QAEvB,iBAAiB,EAAE,2BAA2B,EAAE;QAEhD,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,IAAI,GAAG,EAAE;QAErB,MAAM,EAAE,EAAE;QACV,eAAe,EAAE,EAAE;QAEnB,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,IAAI;YACJ,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;SAC/B,CAAC,CAAC;QACH,UAAU,EAAE,KAAK;QAEjB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,KAAK;QAChB,UAAU,EAAE,OAAO;QAEnB,eAAe,EAAE,IAAI,GAAG,EAAE;QAE1B,QAAQ,EAAE;YACR,KAAK,EAAE,mBAAmB;YAC1B,cAAc,EAAE,SAAS;YACzB,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,MAAM;SACd;KACF,CAAC;AACJ,CAAC;AAMD,MAAM,KAAK;IACD,KAAK,CAAW;IAChB,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAExC,YAAY,YAAsB;QAChC,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAa,CAAC;IACvD,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,OAAqC;QAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,QAAQ,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAa,CAAC;YACjD,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,SAAS,CAAC,QAAkB;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEO,MAAM;QACZ,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,2EAA2E;AAE3E,IAAI,WAAW,GAAiB,IAAI,CAAC;AAErC,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,WAAW,GAAG,IAAI,KAAK,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,QAAQ;IACtB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,WAAW,CAAC,OAAqC;IAC/D,QAAQ,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/tools/AgentTool.d.ts

@@ -0,0 +1,62 @@
+/**
+ * AgentTool — Sub-agent spawning and management for Cray Code.
+ * This is the most powerful tool: it creates child agents that run their own
+ * query loops with restricted tool sets, enabling parallel task execution.
+ *
+ * Architecture:
+ * - Foreground agents run inline, streaming results back to the caller
+ * - Background agents run asynchronously with progress notification
+ * - Worktree isolation supported for safe parallel filesystem operations
+ * - Built-in agent types: general-purpose, explore, plan, code-review
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const AGENT_TOOL_NAME = "agent";
+export declare const LEGACY_AGENT_TOOL_NAME = "task";
+/** Built-in agent type definitions */
+export declare const BUILT_IN_AGENTS: {
+    'general-purpose': {
+        name: string;
+        description: string;
+        allowedTools: string[];
+    };
+    explore: {
+        name: string;
+        description: string;
+        allowedTools: string[];
+    };
+    'code-review': {
+        name: string;
+        description: string;
+        allowedTools: string[];
+    };
+    plan: {
+        name: string;
+        description: string;
+        allowedTools: string[];
+    };
+};
+export type BuiltInAgentType = keyof typeof BUILT_IN_AGENTS;
+export declare const AgentTool: ToolDef<z.ZodObject<{
+    description: z.ZodString;
+    prompt: z.ZodString;
+    subagent_type: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodEnum<["sonnet", "opus", "haiku"]>>;
+    run_in_background: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    isolation: z.ZodOptional<z.ZodEnum<["worktree"]>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    prompt: string;
+    run_in_background: boolean;
+    model?: "sonnet" | "opus" | "haiku" | undefined;
+    subagent_type?: string | undefined;
+    isolation?: "worktree" | undefined;
+}, {
+    description: string;
+    prompt: string;
+    model?: "sonnet" | "opus" | "haiku" | undefined;
+    subagent_type?: string | undefined;
+    run_in_background?: boolean | undefined;
+    isolation?: "worktree" | undefined;
+}>, string>;
+//# sourceMappingURL=AgentTool.d.ts.map

package/dist/tools/AgentTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTool.d.ts","sourceRoot":"","sources":["../../src/tools/AgentTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAK3F,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAa7C,sCAAsC;AACtC,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;CAqB3B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE5D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;WAgGpB,CAAC"}

package/dist/tools/AgentTool.js

@@ -0,0 +1,133 @@
+/**
+ * AgentTool — Sub-agent spawning and management for Cray Code.
+ * This is the most powerful tool: it creates child agents that run their own
+ * query loops with restricted tool sets, enabling parallel task execution.
+ *
+ * Architecture:
+ * - Foreground agents run inline, streaming results back to the caller
+ * - Background agents run asynchronously with progress notification
+ * - Worktree isolation supported for safe parallel filesystem operations
+ * - Built-in agent types: general-purpose, explore, plan, code-review
+ */
+import { z } from 'zod';
+import { buildTool } from '../Tool.js';
+import { runSubAgent } from '../services/agentRunner.js';
+export const AGENT_TOOL_NAME = 'agent';
+export const LEGACY_AGENT_TOOL_NAME = 'task'; // Backwards compat
+const inputSchema = z.object({
+    description: z.string().describe('A short (3-5 word) description of the task'),
+    prompt: z.string().describe('The task for the agent to perform'),
+    subagent_type: z.string().optional().describe('The type of specialized agent to use'),
+    model: z.enum(['sonnet', 'opus', 'haiku']).optional().describe('Model override for this agent'),
+    run_in_background: z.boolean().optional().default(false).describe('Run agent in the background'),
+    isolation: z.enum(['worktree']).optional().describe('Isolation mode for the agent'),
+});
+/** Built-in agent type definitions */
+export const BUILT_IN_AGENTS = {
+    'general-purpose': {
+        name: 'general-purpose',
+        description: 'General-purpose agent for research, code search, and multi-step tasks.',
+        allowedTools: ['read', 'glob', 'grep', 'web_fetch', 'web_search', 'bash'],
+    },
+    explore: {
+        name: 'explore',
+        description: 'Fast read-only search agent for locating code. Use for finding files, symbols, or answering "where is X defined."',
+        allowedTools: ['read', 'glob', 'grep', 'web_search'],
+    },
+    'code-review': {
+        name: 'code-review',
+        description: 'Reviews code for bugs, logic errors, security vulnerabilities, and code quality issues.',
+        allowedTools: ['read', 'glob', 'grep'],
+    },
+    plan: {
+        name: 'plan',
+        description: 'Software architect agent for designing implementation plans.',
+        allowedTools: ['read', 'glob', 'grep', 'web_fetch', 'web_search'],
+    },
+};
+export const AgentTool = buildTool({
+    name: AGENT_TOOL_NAME,
+    aliases: [LEGACY_AGENT_TOOL_NAME],
+    searchHint: 'agent sub-agent parallel task delegate',
+    inputSchema,
+    async description(input) {
+        return `Agent: ${input.description}`;
+    },
+    userFacingName() {
+        return 'Agent';
+    },
+    isReadOnly() {
+        return false;
+    },
+    isConcurrencySafe() {
+        return true; // Sub-agents are isolated
+    },
+    async checkPermissions(input, context) {
+        const mode = context?.permissionContext?.mode ?? context?.mode ?? 'default';
+        if (mode === 'bypass')
+            return { behavior: 'allow' };
+        return {
+            behavior: 'ask',
+            message: `Spawn sub-agent for: "${input.description}"?`,
+        };
+    },
+    async call(input, context) {
+        try {
+            const agentDef = input.subagent_type && input.subagent_type in BUILT_IN_AGENTS
+                ? BUILT_IN_AGENTS[input.subagent_type]
+                : BUILT_IN_AGENTS['general-purpose'];
+            if (input.run_in_background) {
+                // Background agent: start and return a handle
+                const taskId = await runSubAgent({
+                    description: input.description,
+                    prompt: input.prompt,
+                    agentType: agentDef.name,
+                    model: input.model,
+                    context,
+                    background: true,
+                });
+                return {
+                    data: `Background agent started: ${taskId}`,
+                    content: `Agent "${input.description}" running in background.\nTask ID: ${taskId}\nThe agent will notify when complete.`,
+                    title: `Agent (background): ${input.description}`,
+                };
+            }
+            // Foreground agent: run and stream results
+            const messages = await runSubAgent({
+                description: input.description,
+                prompt: input.prompt,
+                agentType: agentDef.name,
+                model: input.model,
+                context,
+                background: false,
+            });
+            const textResponse = messages
+                .filter((m) => m.role === 'assistant')
+                .flatMap((m) => m.content)
+                .filter((c) => c.type === 'text')
+                .map((c) => c.text)
+                .join('\n');
+            const truncated = textResponse.length > 100_000;
+            const output = truncated ? textResponse.slice(0, 100_000) + '\n... [truncated]' : textResponse;
+            return {
+                data: output,
+                content: output,
+                truncated,
+                title: `Agent: ${input.description}`,
+            };
+        }
+        catch (err) {
+            return {
+                data: '',
+                content: `Agent error: ${err.message}`,
+                isError: true,
+                title: `Agent Error: ${input.description}`,
+            };
+        }
+    },
+    renderToolUseMessage(input) {
+        const tag = input.run_in_background ? ' [background]' : '';
+        return `Spawning agent: ${input.description}${tag}`;
+    },
+});
+//# sourceMappingURL=AgentTool.js.map

package/dist/tools/AgentTool.js.map

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

package/dist/tools/AskUserQuestionTool.d.ts

@@ -0,0 +1,60 @@
+/**
+ * AskUserQuestionTool — Interactive user questioning for Cray Code.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const ASK_USER_QUESTION_TOOL_NAME = "ask_user";
+export declare const AskUserQuestionTool: ToolDef<z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        header: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            label: string;
+        }, {
+            description: string;
+            label: string;
+        }>, "many">;
+        multiSelect: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect: boolean;
+    }, {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    questions: {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect: boolean;
+    }[];
+}, {
+    questions: {
+        options: {
+            description: string;
+            label: string;
+        }[];
+        question: string;
+        header: string;
+        multiSelect?: boolean | undefined;
+    }[];
+}>, string>;
+//# sourceMappingURL=AskUserQuestionTool.d.ts.map

package/dist/tools/AskUserQuestionTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AskUserQuestionTool.d.ts","sourceRoot":"","sources":["../../src/tools/AskUserQuestionTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAE3F,eAAO,MAAM,2BAA2B,aAAa,CAAC;AAoBtD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAsC9B,CAAC"}

package/dist/tools/AskUserQuestionTool.js

@@ -0,0 +1,52 @@
+/**
+ * AskUserQuestionTool — Interactive user questioning for Cray Code.
+ */
+import { z } from 'zod';
+import { buildTool } from '../Tool.js';
+export const ASK_USER_QUESTION_TOOL_NAME = 'ask_user';
+const optionSchema = z.object({
+    label: z.string().describe('Display text for this option'),
+    description: z.string().describe('What this option means'),
+});
+const questionSchema = z.object({
+    question: z.string().describe('The complete question to ask. Should end with a question mark.'),
+    header: z.string().max(12).describe('Short label (max 12 chars). E.g., "Auth method", "Library".'),
+    options: z.array(optionSchema).min(2).max(4).describe('Available choices (2-4)'),
+    multiSelect: z.boolean().optional().default(false).describe('Allow multiple selections'),
+});
+const inputSchema = z.object({
+    questions: z.array(questionSchema).min(1).max(4).describe('Questions to ask (1-4)'),
+});
+export const AskUserQuestionTool = buildTool({
+    name: ASK_USER_QUESTION_TOOL_NAME,
+    aliases: ['ask', 'question'],
+    searchHint: 'ask user question interactive clarify',
+    inputSchema,
+    async description(input) {
+        return `Asks: ${input.questions[0]?.question.slice(0, 80)}`;
+    },
+    userFacingName() {
+        return 'AskUser';
+    },
+    isReadOnly() {
+        return true;
+    },
+    isConcurrencySafe() {
+        return false; // Block on user input
+    },
+    async call(input, context) {
+        const formatted = input.questions.map((q, i) => {
+            const options = q.options.map((o) => `  - ${o.label}: ${o.description}`).join('\n');
+            return `Q${i + 1}: ${q.question}${q.multiSelect ? ' (multi-select)' : ''}\n${options}`;
+        }).join('\n\n');
+        return {
+            data: formatted,
+            content: `Questions presented to user:\n\n${formatted}`,
+            title: `Questions (${input.questions.length})`,
+        };
+    },
+    renderToolUseMessage(input) {
+        return `Asking: ${input.questions.map((q) => q.question).join(' | ')}`;
+    },
+});
+//# sourceMappingURL=AskUserQuestionTool.js.map

package/dist/tools/AskUserQuestionTool.js.map

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

package/dist/tools/BashTool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * BashTool — Shell command execution tool for Cray Code.
+ * Supports sandboxing, permission checks, and progress reporting.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const BASH_TOOL_NAME = "bash";
+export declare const BashTool: ToolDef<z.ZodObject<{
+    command: z.ZodString;
+    description: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    workdir: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    description: string;
+    workdir?: string | undefined;
+    timeout?: number | undefined;
+}, {
+    command: string;
+    description: string;
+    workdir?: string | undefined;
+    timeout?: number | undefined;
+}>, string>;
+/**
+ * Security functions for shell command analysis
+ */
+export declare const bashSecurity: {
+    /** Check if a command contains known dangerous patterns */
+    isDangerous(command: string): boolean;
+    /** Get the base command for categorization */
+    getBaseCommand(command: string): string;
+};
+//# sourceMappingURL=BashTool.d.ts.map

package/dist/tools/BashTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BashTool.d.ts","sourceRoot":"","sources":["../../src/tools/BashTool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAK3F,eAAO,MAAM,cAAc,SAAS,CAAC;AAWrC,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;WAgKnB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,2DAA2D;yBACtC,MAAM,GAAG,OAAO;IAarC,8CAA8C;4BACtB,MAAM,GAAG,MAAM;CAGxC,CAAC"}