@praveencs/agent 0.9.30 → 0.10.0

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

@@ -0,0 +1,55 @@
+export interface MultimodalConfig {
+    /** Enable multimodal features */
+    enabled: boolean;
+    /** OpenAI API key (for Whisper, TTS, Vision) */
+    apiKey?: string;
+    /** Voice input settings */
+    voice: VoiceConfig;
+    /** Vision/image analysis settings */
+    vision: VisionConfig;
+    /** Text-to-speech settings */
+    tts: TTSConfig;
+}
+export interface VoiceConfig {
+    /** Whisper model to use */
+    model: string;
+    /** Language code (auto-detect if omitted) */
+    language?: string;
+    /** Audio format for recording */
+    format: 'wav' | 'mp3' | 'webm';
+}
+export interface VisionConfig {
+    /** Model for image analysis */
+    model: string;
+    /** Max tokens for vision response */
+    maxTokens: number;
+    /** Detail level: low, high, auto */
+    detail: 'low' | 'high' | 'auto';
+}
+export interface TTSConfig {
+    /** TTS model */
+    model: string;
+    /** Voice: alloy, echo, fable, onyx, nova, shimmer */
+    voice: string;
+    /** Output format */
+    format: 'mp3' | 'opus' | 'aac' | 'flac';
+    /** Speed multiplier (0.25 - 4.0) */
+    speed: number;
+}
+export declare const DEFAULT_MULTIMODAL_CONFIG: MultimodalConfig;
+export interface TranscriptionResult {
+    text: string;
+    language?: string;
+    duration?: number;
+}
+export interface VisionAnalysisResult {
+    description: string;
+    model: string;
+    tokensUsed: number;
+}
+export interface SpeechResult {
+    audioPath: string;
+    format: string;
+    text: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/multimodal/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC7B,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,YAAY,CAAC;IACrB,8BAA8B;IAC9B,GAAG,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IACzB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACtB,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;IACxC,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAiBvC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CAChB"}

package/dist/src/multimodal/types.js

@@ -0,0 +1,20 @@
+// ─── Multimodal Types ───
+export const DEFAULT_MULTIMODAL_CONFIG = {
+    enabled: false,
+    voice: {
+        model: 'whisper-1',
+        format: 'wav',
+    },
+    vision: {
+        model: 'gpt-4o',
+        maxTokens: 1024,
+        detail: 'auto',
+    },
+    tts: {
+        model: 'tts-1',
+        voice: 'alloy',
+        format: 'mp3',
+        speed: 1.0,
+    },
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/multimodal/types.ts"],"names":[],"mappings":"AAAA,2BAA2B;AA4C3B,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACvD,OAAO,EAAE,KAAK;IACd,KAAK,EAAE;QACH,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,KAAK;KAChB;IACD,MAAM,EAAE;QACJ,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,MAAM;KACjB;IACD,GAAG,EAAE;QACD,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,GAAG;KACb;CACJ,CAAC"}

package/dist/src/multimodal/vision.d.ts

@@ -0,0 +1,15 @@
+import type { VisionConfig, VisionAnalysisResult } from './types.js';
+export declare class VisionAnalyzer {
+    private config;
+    private apiKey;
+    constructor(config: VisionConfig, apiKey: string);
+    /**
+     * Analyze an image with a prompt.
+     */
+    analyze(imagePath: string, prompt?: string): Promise<VisionAnalysisResult>;
+    /**
+     * Analyze an image from a URL.
+     */
+    analyzeUrl(imageUrl: string, prompt?: string): Promise<VisionAnalysisResult>;
+}
+//# sourceMappingURL=vision.d.ts.map

package/dist/src/multimodal/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../../src/multimodal/vision.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErE,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAKhD;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAyC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAoDlH;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAA+B,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAyC7G"}

package/dist/src/multimodal/vision.js

@@ -0,0 +1,98 @@
+// ─── Vision (Image Analysis) ───
+// Uses OpenAI GPT-4V / GPT-4o for image understanding.
+import { readFileSync } from 'node:fs';
+import { extname } from 'node:path';
+export class VisionAnalyzer {
+    config;
+    apiKey;
+    constructor(config, apiKey) {
+        this.config = config;
+        this.apiKey = apiKey;
+    }
+    /**
+     * Analyze an image with a prompt.
+     */
+    async analyze(imagePath, prompt = 'Describe this image in detail.') {
+        // Read and base64-encode the image
+        const imageBuffer = readFileSync(imagePath);
+        const base64 = imageBuffer.toString('base64');
+        const ext = extname(imagePath).slice(1) || 'png';
+        const mimeType = ext === 'jpg' ? 'image/jpeg' : `image/${ext}`;
+        const dataUrl = `data:${mimeType};base64,${base64}`;
+        const res = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                max_tokens: this.config.maxTokens,
+                messages: [
+                    {
+                        role: 'user',
+                        content: [
+                            { type: 'text', text: prompt },
+                            {
+                                type: 'image_url',
+                                image_url: {
+                                    url: dataUrl,
+                                    detail: this.config.detail,
+                                },
+                            },
+                        ],
+                    },
+                ],
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.json();
+            throw new Error(`Vision API Error: ${err.error?.message || JSON.stringify(err)}`);
+        }
+        const data = await res.json();
+        return {
+            description: data.choices[0]?.message?.content || '',
+            model: this.config.model,
+            tokensUsed: data.usage?.total_tokens || 0,
+        };
+    }
+    /**
+     * Analyze an image from a URL.
+     */
+    async analyzeUrl(imageUrl, prompt = 'Describe this image.') {
+        const res = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.config.model,
+                max_tokens: this.config.maxTokens,
+                messages: [
+                    {
+                        role: 'user',
+                        content: [
+                            { type: 'text', text: prompt },
+                            {
+                                type: 'image_url',
+                                image_url: { url: imageUrl, detail: this.config.detail },
+                            },
+                        ],
+                    },
+                ],
+            }),
+        });
+        if (!res.ok) {
+            const err = await res.json();
+            throw new Error(`Vision API Error: ${err.error?.message || JSON.stringify(err)}`);
+        }
+        const data = await res.json();
+        return {
+            description: data.choices[0]?.message?.content || '',
+            model: this.config.model,
+            tokensUsed: data.usage?.total_tokens || 0,
+        };
+    }
+}
+//# sourceMappingURL=vision.js.map

package/dist/src/multimodal/vision.js.map

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

package/dist/src/multimodal/voice.d.ts

@@ -0,0 +1,11 @@
+import type { VoiceConfig, TranscriptionResult } from './types.js';
+export declare class VoiceInput {
+    private config;
+    private apiKey;
+    constructor(config: VoiceConfig, apiKey: string);
+    /**
+     * Transcribe an audio file using Whisper.
+     */
+    transcribe(audioPath: string): Promise<TranscriptionResult>;
+}
+//# sourceMappingURL=voice.d.ts.map

package/dist/src/multimodal/voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../../src/multimodal/voice.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAa,UAAU;IACnB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAK/C;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAiCpE"}

package/dist/src/multimodal/voice.js

@@ -0,0 +1,43 @@
+// ─── Voice Input (Speech-to-Text) ───
+// Uses OpenAI Whisper API for transcription.
+import { readFileSync } from 'node:fs';
+export class VoiceInput {
+    config;
+    apiKey;
+    constructor(config, apiKey) {
+        this.config = config;
+        this.apiKey = apiKey;
+    }
+    /**
+     * Transcribe an audio file using Whisper.
+     */
+    async transcribe(audioPath) {
+        const audioData = readFileSync(audioPath);
+        const blob = new Blob([audioData]);
+        const formData = new FormData();
+        formData.append('file', blob, `audio.${this.config.format}`);
+        formData.append('model', this.config.model);
+        if (this.config.language) {
+            formData.append('language', this.config.language);
+        }
+        formData.append('response_format', 'verbose_json');
+        const res = await fetch('https://api.openai.com/v1/audio/transcriptions', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+            },
+            body: formData,
+        });
+        if (!res.ok) {
+            const err = await res.json();
+            throw new Error(`Whisper API Error: ${err.error?.message || JSON.stringify(err)}`);
+        }
+        const data = await res.json();
+        return {
+            text: data.text,
+            language: data.language,
+            duration: data.duration,
+        };
+    }
+}
+//# sourceMappingURL=voice.js.map

package/dist/src/multimodal/voice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice.js","sourceRoot":"","sources":["../../../src/multimodal/voice.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,6CAA6C;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,MAAM,OAAO,UAAU;IACX,MAAM,CAAc;IACpB,MAAM,CAAS;IAEvB,YAAY,MAAmB,EAAE,MAAc;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,SAAiB;QAC9B,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvB,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;QACD,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAC;QAEnD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,gDAAgD,EAAE;YACtE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aAC3C;YACD,IAAI,EAAE,QAAQ;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACV,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAS,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA4D,CAAC;QAExF,OAAO;YACH,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SAC1B,CAAC;IACN,CAAC;CACJ"}

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

@@ -83,12 +83,12 @@ export declare const GoalSchema: z.ZodObject<{
     description: string;
     id: string;
     successCriteria: string[];
-    riskLevel: "low" | "medium" | "high";
+    riskLevel: "low" | "high" | "medium";
 }, {
     description: string;
     id: string;
     successCriteria?: string[] | undefined;
-    riskLevel?: "low" | "medium" | "high" | undefined;
+    riskLevel?: "low" | "high" | "medium" | undefined;
 }>;
 export declare const VerifySchema: z.ZodObject<{
     command: z.ZodOptional<z.ZodString>;
@@ -96,13 +96,13 @@ export declare const VerifySchema: z.ZodObject<{
     exitCode: z.ZodOptional<z.ZodNumber>;
     contains: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    command?: string | undefined;
     exitCode?: number | undefined;
+    command?: string | undefined;
     fileExists?: string | undefined;
     contains?: string | undefined;
 }, {
-    command?: string | undefined;
     exitCode?: number | undefined;
+    command?: string | undefined;
     fileExists?: string | undefined;
     contains?: string | undefined;
 }>;
@@ -119,13 +119,13 @@ export declare const StepSchema: z.ZodObject<{
         exitCode: z.ZodOptional<z.ZodNumber>;
         contains: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        command?: string | undefined;
         exitCode?: number | undefined;
+        command?: string | undefined;
         fileExists?: string | undefined;
         contains?: string | undefined;
     }, {
-        command?: string | undefined;
         exitCode?: number | undefined;
+        command?: string | undefined;
         fileExists?: string | undefined;
         contains?: string | undefined;
     }>>;
@@ -142,8 +142,8 @@ export declare const StepSchema: z.ZodObject<{
     tool?: string | undefined;
     skill?: string | undefined;
     verify?: {
-        command?: string | undefined;
         exitCode?: number | undefined;
+        command?: string | undefined;
         fileExists?: string | undefined;
         contains?: string | undefined;
     } | undefined;
@@ -156,8 +156,8 @@ export declare const StepSchema: z.ZodObject<{
     tool?: string | undefined;
     skill?: string | undefined;
     verify?: {
-        command?: string | undefined;
         exitCode?: number | undefined;
+        command?: string | undefined;
         fileExists?: string | undefined;
         contains?: string | undefined;
     } | undefined;
@@ -235,12 +235,12 @@ export declare const PlanSchema: z.ZodObject<{
         description: string;
         id: string;
         successCriteria: string[];
-        riskLevel: "low" | "medium" | "high";
+        riskLevel: "low" | "high" | "medium";
     }, {
         description: string;
         id: string;
         successCriteria?: string[] | undefined;
-        riskLevel?: "low" | "medium" | "high" | undefined;
+        riskLevel?: "low" | "high" | "medium" | undefined;
     }>, "many">;
     steps: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -255,13 +255,13 @@ export declare const PlanSchema: z.ZodObject<{
             exitCode: z.ZodOptional<z.ZodNumber>;
             contains: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            command?: string | undefined;
             exitCode?: number | undefined;
+            command?: string | undefined;
             fileExists?: string | undefined;
             contains?: string | undefined;
         }, {
-            command?: string | undefined;
             exitCode?: number | undefined;
+            command?: string | undefined;
             fileExists?: string | undefined;
             contains?: string | undefined;
         }>>;
@@ -278,8 +278,8 @@ export declare const PlanSchema: z.ZodObject<{
         tool?: string | undefined;
         skill?: string | undefined;
         verify?: {
-            command?: string | undefined;
             exitCode?: number | undefined;
+            command?: string | undefined;
             fileExists?: string | undefined;
             contains?: string | undefined;
         } | undefined;
@@ -292,8 +292,8 @@ export declare const PlanSchema: z.ZodObject<{
         tool?: string | undefined;
         skill?: string | undefined;
         verify?: {
-            command?: string | undefined;
             exitCode?: number | undefined;
+            command?: string | undefined;
             fileExists?: string | undefined;
             contains?: string | undefined;
         } | undefined;
@@ -373,7 +373,7 @@ export declare const PlanSchema: z.ZodObject<{
         description: string;
         id: string;
         successCriteria: string[];
-        riskLevel: "low" | "medium" | "high";
+        riskLevel: "low" | "high" | "medium";
     }[];
     steps: {
         name: string;
@@ -385,8 +385,8 @@ export declare const PlanSchema: z.ZodObject<{
         tool?: string | undefined;
         skill?: string | undefined;
         verify?: {
-            command?: string | undefined;
             exitCode?: number | undefined;
+            command?: string | undefined;
             fileExists?: string | undefined;
             contains?: string | undefined;
         } | undefined;
@@ -411,7 +411,7 @@ export declare const PlanSchema: z.ZodObject<{
         description: string;
         id: string;
         successCriteria?: string[] | undefined;
-        riskLevel?: "low" | "medium" | "high" | undefined;
+        riskLevel?: "low" | "high" | "medium" | undefined;
     }[];
     steps: {
         name: string;
@@ -421,8 +421,8 @@ export declare const PlanSchema: z.ZodObject<{
         tool?: string | undefined;
         skill?: string | undefined;
         verify?: {
-            command?: string | undefined;
             exitCode?: number | undefined;
+            command?: string | undefined;
             fileExists?: string | undefined;
             contains?: string | undefined;
         } | undefined;

package/dist/src/sandbox/docker.d.ts

@@ -0,0 +1,42 @@
+import type { ContainerState, SandboxMount } from './types.js';
+export declare class DockerClient {
+    /**
+     * Check if Docker is available on the system.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Pull a Docker image if not already present.
+     */
+    pullImage(image: string): Promise<void>;
+    /**
+     * Create and start a new container.
+     */
+    createContainer(options: {
+        name: string;
+        image: string;
+        mounts: SandboxMount[];
+        network: string;
+        projectRoot: string;
+    }): Promise<ContainerState>;
+    /**
+     * Execute a command inside a running container.
+     */
+    exec(containerId: string, command: string, cmdArgs?: string[], options?: {
+        cwd?: string;
+        timeout?: number;
+        env?: Record<string, string>;
+    }): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    /**
+     * Check if a container is running.
+     */
+    isRunning(containerId: string): Promise<boolean>;
+    /**
+     * Stop and remove a container.
+     */
+    destroyContainer(containerId: string): Promise<void>;
+}
+//# sourceMappingURL=docker.d.ts.map

package/dist/src/sandbox/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../src/sandbox/docker.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/D,qBAAa,YAAY;IACrB;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY7C;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoC3B;;OAEG;IACG,IAAI,CACN,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAM,EAAO,EACtB,OAAO,GAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC3B,GACP,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAkChE;;OAEG;IACG,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtD;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAS7D"}

package/dist/src/sandbox/docker.js

@@ -0,0 +1,131 @@
+// ─── Docker Client ───
+// Lightweight Docker Engine API client using fetch over Unix socket.
+// No npm dependencies — talks directly to /var/run/docker.sock.
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export class DockerClient {
+    /**
+     * Check if Docker is available on the system.
+     */
+    async isAvailable() {
+        try {
+            await execFileAsync('docker', ['info', '--format', '{{.ServerVersion}}'], {
+                timeout: 5000,
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Pull a Docker image if not already present.
+     */
+    async pullImage(image) {
+        try {
+            // Check if image exists locally
+            await execFileAsync('docker', ['image', 'inspect', image], { timeout: 5000 });
+        }
+        catch {
+            // Image not found locally — pull it
+            await execFileAsync('docker', ['pull', image], {
+                timeout: 120000, // 2 min for large images
+            });
+        }
+    }
+    /**
+     * Create and start a new container.
+     */
+    async createContainer(options) {
+        const args = [
+            'run', '-d',
+            '--name', options.name,
+            '--network', options.network,
+            '--workdir', '/project',
+            // Keep the container alive with a sleep process
+            '--entrypoint', 'tail',
+        ];
+        // Add volume mounts
+        for (const mount of options.mounts) {
+            const hostPath = mount.hostPath === '.'
+                ? options.projectRoot
+                : mount.hostPath;
+            const flag = mount.readOnly ? ':ro' : '';
+            args.push('-v', `${hostPath}:${mount.containerPath}${flag}`);
+        }
+        args.push(options.image, '-f', '/dev/null');
+        const { stdout } = await execFileAsync('docker', args, {
+            timeout: 30000,
+        });
+        const containerId = stdout.trim();
+        return {
+            containerId,
+            name: options.name,
+            running: true,
+            image: options.image,
+            createdAt: new Date(),
+        };
+    }
+    /**
+     * Execute a command inside a running container.
+     */
+    async exec(containerId, command, cmdArgs = [], options = {}) {
+        const args = ['exec'];
+        // Working directory
+        if (options.cwd) {
+            args.push('-w', options.cwd);
+        }
+        // Environment variables
+        if (options.env) {
+            for (const [key, val] of Object.entries(options.env)) {
+                args.push('-e', `${key}=${val}`);
+            }
+        }
+        args.push(containerId, command, ...cmdArgs);
+        try {
+            const { stdout, stderr } = await execFileAsync('docker', args, {
+                timeout: options.timeout || 30000,
+                maxBuffer: 10 * 1024 * 1024,
+                shell: true,
+            });
+            return { stdout: stdout.toString(), stderr: stderr.toString(), exitCode: 0 };
+        }
+        catch (err) {
+            const error = err;
+            return {
+                stdout: error.stdout?.toString() ?? '',
+                stderr: error.stderr?.toString() ?? error.message ?? '',
+                exitCode: error.code ?? 1,
+            };
+        }
+    }
+    /**
+     * Check if a container is running.
+     */
+    async isRunning(containerId) {
+        try {
+            const { stdout } = await execFileAsync('docker', [
+                'inspect', '--format', '{{.State.Running}}', containerId,
+            ], { timeout: 5000 });
+            return stdout.trim() === 'true';
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Stop and remove a container.
+     */
+    async destroyContainer(containerId) {
+        try {
+            await execFileAsync('docker', ['rm', '-f', containerId], {
+                timeout: 10000,
+            });
+        }
+        catch {
+            // Container may already be gone — ignore
+        }
+    }
+}
+//# sourceMappingURL=docker.js.map

package/dist/src/sandbox/docker.js.map

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

package/dist/src/sandbox/engine.d.ts

@@ -0,0 +1,50 @@
+import type { SandboxConfig, ContainerState, SandboxExecResult } from './types.js';
+export declare class SandboxEngine {
+    private docker;
+    private config;
+    private container;
+    private projectRoot;
+    constructor(projectRoot: string, config?: Partial<SandboxConfig>);
+    /** Whether sandbox mode is enabled */
+    get enabled(): boolean;
+    /** Whether the sandbox container is currently running */
+    get isActive(): boolean;
+    /** Current container info */
+    get containerInfo(): ContainerState | null;
+    /**
+     * Start the sandbox: pull image, create container.
+     * Call this when the daemon starts or when the user runs `agent sandbox start`.
+     */
+    start(): Promise<ContainerState>;
+    /**
+     * Execute a command inside the sandbox.
+     * This is the main entry point used by cmd.run when sandbox is enabled.
+     */
+    exec(command: string, args?: string[], options?: {
+        cwd?: string;
+        timeout?: number;
+        env?: Record<string, string>;
+    }): Promise<SandboxExecResult>;
+    /**
+     * Stop and destroy the sandbox container.
+     */
+    stop(): Promise<void>;
+    /**
+     * Get sandbox status for CLI/Studio display.
+     */
+    status(): Promise<{
+        enabled: boolean;
+        running: boolean;
+        image: string;
+        containerId?: string;
+        uptime?: number;
+    }>;
+    /**
+     * Map a host filesystem path to the equivalent container path
+     * based on the configured volume mounts.
+     */
+    private mapHostPathToContainer;
+}
+export declare function getSandboxEngine(): SandboxEngine | null;
+export declare function initSandboxEngine(projectRoot: string, config?: Partial<SandboxConfig>): SandboxEngine;
+//# sourceMappingURL=engine.d.ts.map