@liquidmetal-ai/raindrop-code 0.0.8 → 0.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liquidmetal-ai/raindrop-code",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "AI-powered terminal coding assistant with deep code understanding, file operations, and extensible tools",
   "keywords": [
     "ai",
@@ -36,6 +36,35 @@
     "raindrop-code": "bin/raindrop-code"
   },
   "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts"
+    },
+    "./control": {
+      "types": "./types/control.d.ts"
+    },
+    "./files": {
+      "types": "./types/files.d.ts"
+    },
+    "./log": {
+      "types": "./types/log.d.ts"
+    },
+    "./resumable": {
+      "types": "./types/resumable.d.ts"
+    },
+    "./runtime": {
+      "types": "./types/runtime.d.ts"
+    },
+    "./state": {
+      "types": "./types/state.d.ts"
+    },
+    "./ui": {
+      "types": "./types/ui.d.ts"
+    },
+    "./bash": {
+      "types": "./types/bash.d.ts"
+    }
+  },
   "files": [
     "install.js",
     "README.md",
@@ -43,9 +72,9 @@
     "types/"
   ],
   "optionalDependencies": {
-    "@liquidmetal-ai/raindrop-code-darwin-universal": "0.0.8",
-    "@liquidmetal-ai/raindrop-code-linux-x64": "0.0.8",
-    "@liquidmetal-ai/raindrop-code-linux-arm64": "0.0.8",
-    "@liquidmetal-ai/raindrop-code-win32-x64": "0.0.8"
+    "@liquidmetal-ai/raindrop-code-darwin-universal": "0.0.10",
+    "@liquidmetal-ai/raindrop-code-linux-x64": "0.0.10",
+    "@liquidmetal-ai/raindrop-code-linux-arm64": "0.0.10",
+    "@liquidmetal-ai/raindrop-code-win32-x64": "0.0.10"
   }
 }

package/types/control.d.ts

@@ -1,12 +1,67 @@
 declare module '@liquidmetal-ai/raindrop-code/control' {
+  /**
+   * Schema definition for AI response validation.
+   * Must be a Zod schema object (use z.object()).
+   */
+  export interface ResponseSchema {
+    /** Parse and validate data against the schema (required) */
+    parse: (data: any) => any;
+    /** Get the schema shape for field extraction (required) */
+    shape: () => Record<string, SchemaField>;
+    /** Internal definition metadata */
+    _def?: {
+      shape?: () => Record<string, SchemaField>;
+    };
+  }
+
+  /**
+   * Schema field definition
+   */
+  export interface SchemaField {
+    /** Field type information */
+    _def?: {
+      typeName?: string;
+      description?: string;
+      innerType?: SchemaField;
+    };
+    /** Check if field is optional */
+    isOptional?: () => boolean;
+  }
+
   /**
    * Options for passing control to AI
    */
   export interface PassToAIOptions {
     /** The prompt to send to the AI */
     prompt: string;
-    /** Signal name to wait for from session_control tool */
-    untilSignal: string;
+    /**
+     * REQUIRED: Zod schema defining the expected response structure.
+     * Use z.object() with .describe() on fields for better AI instructions.
+     * 
+     * Automatically:
+     * - Generates unique signal name
+     * - Appends instructions with example to prompt
+     * - Validates AI response against schema
+     * - Returns typed data
+     * 
+     * @example
+     * z.object({
+     *   result: z.string().describe('The result of the operation'),
+     *   success: z.boolean().describe('Whether it succeeded')
+     * })
+     */
+    responseSchema: ResponseSchema;
+    /**
+     * REQUIRED: Example object showing realistic response values.
+     * Must contain at least one field. Used to generate clear instructions.
+     * 
+     * @example
+     * {
+     *   result: 'Successfully completed the task',
+     *   success: true
+     * }
+     */
+    example: Record<string, any>;
     /** Timeout in seconds (default: 3600) */
     timeout?: number;
     /** Optional: Specific tools to enable for this AI session */
@@ -26,8 +81,12 @@ declare module '@liquidmetal-ai/raindrop-code/control' {
   export interface PassToUserOptions {
     /** Message to display to the user */
     message: string;
-    /** Available actions for the user to choose from */
-    actions: string[];
+    /** Type of user input: "choice" (default) or "text" */
+    type?: 'choice' | 'text';
+    /** Available actions for the user to choose from (for type="choice") */
+    actions?: string[];
+    /** Placeholder text for text input (for type="text") */
+    placeholder?: string;
   }
 
   /**
@@ -43,30 +102,33 @@ declare module '@liquidmetal-ai/raindrop-code/control' {
   /**
    * Pass control to AI by sending a prompt and waiting for a signal.
    * 
-   * The AI must use the session_control tool to send back the expected signal:
-   * ```xml
-   * <tool_use>
-   *   <name>session_control</name>
-   *   <input>
-   *     <signal>your_signal_name</signal>
-   *     <data>
-   *       <key>value</key>
-   *     </data>
-   *   </input>
-   * </tool_use>
-   * ```
+   * Uses Zod schema to automatically generate instructions and validate responses.
+   * The AI receives clear examples and the response is type-checked.
    * 
    * @param opts - Options for the AI session
-   * @returns Promise resolving to the signal data sent by AI
+   * @returns Promise resolving to the validated signal data
    * 
    * @example
    * ```typescript
+   * import { z } from 'zod';
+   * 
    * const result = await passToAI({
-   *   prompt: 'Analyze this code and signal when done',
-   *   untilSignal: 'analysis_complete',
+   *   prompt: 'Analyze this code and find potential bugs',
+   *   responseSchema: z.object({
+   *     bugs: z.array(z.string()).describe('List of bugs found'),
+   *     severity: z.enum(['low', 'medium', 'high']).describe('Overall severity'),
+   *     summary: z.string().describe('Brief analysis summary')
+   *   }),
+   *   example: {
+   *     bugs: ['Memory leak in loop', 'Unhandled error case'],
+   *     severity: 'high',
+   *     summary: 'Found 2 critical issues'
+   *   },
    *   timeout: 300
    * });
-   * console.log(result.findings);
+   * 
+   * console.log(result.bugs);      // string[] - typed and validated!
+   * console.log(result.severity);  // 'low' | 'medium' | 'high'
    * ```
    */
   export function passToAI(opts: PassToAIOptions): Promise<SignalData>;
@@ -122,5 +184,3 @@ declare module '@liquidmetal-ai/raindrop-code/control' {
    */
   export function current(): string;
 }
-tring;
-}

package/types/index.d.ts

@@ -11,7 +11,6 @@
 // Re-export all modules for convenience
 export * from '@liquidmetal-ai/raindrop-code/control';
 export * from '@liquidmetal-ai/raindrop-code/files';
-export * from '@liquidmetal-ai/raindrop-code/git';
 export * from '@liquidmetal-ai/raindrop-code/bash';
 export * from '@liquidmetal-ai/raindrop-code/ui';
 export * from '@liquidmetal-ai/raindrop-code/log';

package/types/git.d.ts

@@ -1,99 +0,0 @@
-declare module '@liquidmetal-ai/raindrop-code/git' {
-  /**
-   * Git repository status
-   */
-  export interface GitStatus {
-    /** List of modified files */
-    modified: string[];
-    /** List of added files */
-    added: string[];
-    /** List of deleted files */
-    deleted: string[];
-    /** List of untracked files */
-    untracked: string[];
-  }
-
-  /**
-   * Commit changes to git.
-   * Optionally add files before committing.
-   * 
-   * @param message - Commit message
-   * @param files - Optional array of files to add before committing
-   * @returns Promise resolving when commit completes
-   * 
-   * @example
-   * ```typescript
-   * await commit('Add new feature', ['src/feature.ts']);
-   * ```
-   */
-  export function commit(message: string, files?: string[]): Promise<void>;
-
-  /**
-   * Get git log entries.
-   * 
-   * @param count - Number of log entries to retrieve
-   * @returns Promise resolving to log output
-   * 
-   * @example
-   * ```typescript
-   * const log = await getLog(10);
-   * console.log(log);
-   * ```
-   */
-  export function log(count: number): Promise<string>;
-
-  /**
-   * Get git repository status.
-   * 
-   * @returns Promise resolving to status object
-   * 
-   * @example
-   * ```typescript
-   * const status = await getStatus();
-   * if (status.modified.length > 0) {
-   *   console.log('Modified files:', status.modified);
-   * }
-   * ```
-   */
-  export function status(): Promise<GitStatus>;
-
-  /**
-   * Add files to git staging area.
-   * 
-   * @param files - Array of file paths to add
-   * @returns Promise resolving when add completes
-   * 
-   * @example
-   * ```typescript
-   * await add(['src/main.ts', 'README.md']);
-   * ```
-   */
-  export function add(files: string[]): Promise<void>;
-
-  /**
-   * Get current git branch name.
-   * 
-   * @returns Promise resolving to branch name
-   * 
-   * @example
-   * ```typescript
-   * const branch = await getBranch();
-   * console.log('Current branch:', branch);
-   * ```
-   */
-  export function branch(): Promise<string>;
-
-  /**
-   * Get git diff output.
-   * 
-   * @param files - Optional array of files to diff (if empty, diffs all changes)
-   * @returns Promise resolving to diff output
-   * 
-   * @example
-   * ```typescript
-   * const diff = await getDiff(['src/main.ts']);
-   * console.log(diff);
-   * ```
-   */
-  export function diff(files?: string[]): Promise<string>;
-}