@aiassesstech/sam 0.2.3 → 0.3.0

package/dist/tools/sam-execute.d.ts

@@ -0,0 +1,60 @@
+/**
+ * sam_execute — Execute code in the Docker sandbox
+ *
+ * Creates an ephemeral container, runs code with resource limits,
+ * captures output, extracts artifacts, destroys container.
+ * Writes memory file on completion.
+ */
+import type { SandboxManager } from '../sandbox/sandbox-manager.js';
+import type { SamMemory } from '../memory/sam-memory.js';
+export declare function createExecuteTool(sandbox: SandboxManager, getMemory: () => SamMemory | null): {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            language: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            code: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        filename: {
+                            type: string;
+                        };
+                        content: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            er_id: {
+                type: string;
+                description: string;
+            };
+            timeout_minutes: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(_toolCallId: string, params: Record<string, unknown>): Promise<{
+        isError?: boolean | undefined;
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=sam-execute.d.ts.map

package/dist/tools/sam-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sam-execute.d.ts","sourceRoot":"","sources":["../../src/tools/sam-execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwCpD,MAAM,EAAE;;yBAEjB,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EA8DrE"}

package/dist/tools/sam-execute.js

@@ -0,0 +1,109 @@
+/**
+ * sam_execute — Execute code in the Docker sandbox
+ *
+ * Creates an ephemeral container, runs code with resource limits,
+ * captures output, extracts artifacts, destroys container.
+ * Writes memory file on completion.
+ */
+export function createExecuteTool(sandbox, getMemory) {
+    return {
+        name: 'sam_execute',
+        description: 'Execute code in the Docker sandbox. Supports nodejs, python, and bash. ' +
+            'Provide code directly or with supporting files. Returns stdout, stderr, exit code, ' +
+            'execution time, and list of created files.',
+        parameters: {
+            type: 'object',
+            properties: {
+                language: {
+                    type: 'string',
+                    enum: ['nodejs', 'python', 'bash'],
+                    description: 'Language/runtime for execution',
+                },
+                code: {
+                    type: 'string',
+                    description: 'The code to execute',
+                },
+                files: {
+                    type: 'array',
+                    description: 'Additional files to place in /workspace before execution',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            filename: { type: 'string' },
+                            content: { type: 'string' },
+                        },
+                        required: ['filename', 'content'],
+                    },
+                },
+                er_id: {
+                    type: 'string',
+                    description: 'Engineering Request ID to associate artifacts with',
+                },
+                timeout_minutes: {
+                    type: 'number',
+                    description: 'Execution timeout in minutes (default 10, max 30)',
+                },
+            },
+            required: ['language', 'code'],
+        },
+        async execute(_toolCallId, params) {
+            try {
+                const language = params.language;
+                const code = params.code;
+                const files = params.files ?? [];
+                const erId = params.er_id;
+                const timeoutMin = Math.min(params.timeout_minutes || 10, 30);
+                const timeoutMs = timeoutMin * 60 * 1000;
+                const result = await sandbox.execute(language, code, files, {
+                    timeoutMs,
+                    erId,
+                });
+                const memory = getMemory();
+                if (memory && erId) {
+                    memory.writer?.write?.({
+                        agent: 'sam',
+                        type: 'sandbox-execution',
+                        tags: ['engineering', 'sandbox', language, erId],
+                        title: `Sandbox Execution: ${erId} — ${language}`,
+                        body: `## Sandbox Execution\n\n` +
+                            `**ER**: ${erId}\n` +
+                            `**Language**: ${language}\n` +
+                            `**Exit Code**: ${result.exitCode}\n` +
+                            `**Duration**: ${result.executionTimeMs}ms\n` +
+                            `**Timed Out**: ${result.timedOut}\n` +
+                            `**Files Created**: ${result.filesCreated.length}\n`,
+                        metadata: {
+                            er_id: erId,
+                            language,
+                            exit_code: result.exitCode,
+                            execution_time_ms: result.executionTimeMs,
+                        },
+                    }).catch(() => { });
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                exitCode: result.exitCode,
+                                timedOut: result.timedOut,
+                                executionTimeMs: result.executionTimeMs,
+                                stdout: result.stdout.slice(0, 10_000),
+                                stderr: result.stderr.slice(0, 10_000),
+                                filesCreated: result.filesCreated,
+                                ...(result.stdout.length > 10_000 ? { stdoutTruncated: true } : {}),
+                                ...(result.stderr.length > 10_000 ? { stderrTruncated: true } : {}),
+                            }, null, 2),
+                        }],
+                    ...(result.exitCode !== 0 ? { isError: true } : {}),
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: `sam_execute error: ${err instanceof Error ? err.message : String(err)}` }],
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=sam-execute.js.map

package/dist/tools/sam-execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sam-execute.js","sourceRoot":"","sources":["../../src/tools/sam-execute.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,UAAU,iBAAiB,CAAC,OAAuB,EAAE,SAAiC;IAC1F,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,yEAAyE;YACzE,qFAAqF;YACrF,4CAA4C;QAC9C,UAAU,EAAE;YACV,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;oBAClC,WAAW,EAAE,gCAAgC;iBAC9C;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qBAAqB;iBACnC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,WAAW,EAAE,0DAA0D;oBACvE,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BAC5B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAC5B;wBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;qBAClC;iBACF;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mDAAmD;iBACjE;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,CAAa;SAC3C;QACD,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,MAA+B;YAChE,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAwC,CAAC;gBACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAc,CAAC;gBACnC,MAAM,KAAK,GAAI,MAAM,CAAC,KAAsD,IAAI,EAAE,CAAC;gBACnF,MAAM,IAAI,GAAG,MAAM,CAAC,KAA2B,CAAC;gBAChD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAE,MAAM,CAAC,eAA0B,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC1E,MAAM,SAAS,GAAG,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;gBAEzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE;oBAC1D,SAAS;oBACT,IAAI;iBACL,CAAC,CAAC;gBAEH,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;oBAClB,MAAc,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;wBAC9B,KAAK,EAAE,KAAK;wBACZ,IAAI,EAAE,mBAAmB;wBACzB,IAAI,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC;wBAChD,KAAK,EAAE,sBAAsB,IAAI,MAAM,QAAQ,EAAE;wBACjD,IAAI,EACF,0BAA0B;4BAC1B,WAAW,IAAI,IAAI;4BACnB,iBAAiB,QAAQ,IAAI;4BAC7B,kBAAkB,MAAM,CAAC,QAAQ,IAAI;4BACrC,iBAAiB,MAAM,CAAC,eAAe,MAAM;4BAC7C,kBAAkB,MAAM,CAAC,QAAQ,IAAI;4BACrC,sBAAsB,MAAM,CAAC,YAAY,CAAC,MAAM,IAAI;wBACtD,QAAQ,EAAE;4BACR,KAAK,EAAE,IAAI;4BACX,QAAQ;4BACR,SAAS,EAAE,MAAM,CAAC,QAAQ;4BAC1B,iBAAiB,EAAE,MAAM,CAAC,eAAe;yBAC1C;qBACF,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACrB,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,CAAC;4BACR,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gCACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gCACzB,eAAe,EAAE,MAAM,CAAC,eAAe;gCACvC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;gCACtC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC;gCACtC,YAAY,EAAE,MAAM,CAAC,YAAY;gCACjC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gCACnE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;6BACpE,EAAE,IAAI,EAAE,CAAC,CAAC;yBACZ,CAAC;oBACF,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACpD,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBAC3G,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/sam-sandbox.d.ts

@@ -0,0 +1,29 @@
+/**
+ * sam_sandbox — Manage sandbox lifecycle and configuration
+ *
+ * Actions: status, build, cleanup
+ */
+import type { SandboxManager } from '../sandbox/sandbox-manager.js';
+export declare function createSandboxTool(sandbox: SandboxManager): {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(_toolCallId: string, params: Record<string, unknown>): Promise<{
+        isError?: boolean | undefined;
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=sam-sandbox.d.ts.map

package/dist/tools/sam-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sam-sandbox.d.ts","sourceRoot":"","sources":["../../src/tools/sam-sandbox.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc;;;;;;;;;;;;kBAiB3B,MAAM,EAAE;;yBAEP,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EA6DrE"}

package/dist/tools/sam-sandbox.js

@@ -0,0 +1,83 @@
+/**
+ * sam_sandbox — Manage sandbox lifecycle and configuration
+ *
+ * Actions: status, build, cleanup
+ */
+export function createSandboxTool(sandbox) {
+    return {
+        name: 'sam_sandbox',
+        description: 'Manage the Docker sandbox. ' +
+            'status: Docker availability, image, running containers, disk usage. ' +
+            'build: Rebuild the sandbox Docker image. ' +
+            'cleanup: Remove stale containers and old artifacts.',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['status', 'build', 'cleanup'],
+                    description: 'Sandbox management action',
+                },
+            },
+            required: ['action'],
+        },
+        async execute(_toolCallId, params) {
+            try {
+                const action = params.action;
+                if (action === 'status') {
+                    const status = await sandbox.getStatus();
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    action: 'status',
+                                    docker: status.dockerAvailable ? 'available' : 'not found',
+                                    image: status.imageExists ? 'ready' : 'not built',
+                                    runningContainers: status.runningContainers,
+                                    artifactDiskUsageMb: status.artifactDiskUsageMb,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                if (action === 'build') {
+                    const result = await sandbox.buildImage();
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    action: 'build',
+                                    success: result.success,
+                                    output: result.output.slice(0, 5_000),
+                                }, null, 2),
+                            }],
+                        ...(result.success ? {} : { isError: true }),
+                    };
+                }
+                if (action === 'cleanup') {
+                    const result = await sandbox.cleanup();
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    action: 'cleanup',
+                                    containersRemoved: result.removed,
+                                    diskReclaimedMb: result.reclaimedMb,
+                                }, null, 2),
+                            }],
+                    };
+                }
+                return {
+                    content: [{ type: 'text', text: `Unknown action: ${action}` }],
+                    isError: true,
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: `sam_sandbox error: ${err instanceof Error ? err.message : String(err)}` }],
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=sam-sandbox.js.map

package/dist/tools/sam-sandbox.js.map

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

package/dist/tools/sam-status.js

@@ -16,7 +16,7 @@ export function createStatusTool(pipeline, config, fleetBusStatus) {
                     agent: {
                         name: 'Sam',
                         role: 'Chief Engineer',
-                        version: '0.2.3',
+                        version: '0.3.0',
                         internalName: 'SAM2',
                     },
                     pipeline: summary,

package/dist/tools/sam-test.d.ts

@@ -0,0 +1,55 @@
+/**
+ * sam_test — Run test suites in the Docker sandbox
+ *
+ * Supports vitest, jest, pytest, and custom test commands.
+ * Parses structured results from test output.
+ */
+import type { SandboxManager } from '../sandbox/sandbox-manager.js';
+import type { SamMemory } from '../memory/sam-memory.js';
+export declare function createTestTool(sandbox: SandboxManager, getMemory: () => SamMemory | null): {
+    name: string;
+    description: string;
+    parameters: {
+        type: "object";
+        properties: {
+            framework: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            files: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                    properties: {
+                        filename: {
+                            type: string;
+                        };
+                        content: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+            command: {
+                type: string;
+                description: string;
+            };
+            er_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(_toolCallId: string, params: Record<string, unknown>): Promise<{
+        isError?: boolean | undefined;
+        content: {
+            type: string;
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=sam-test.d.ts.map

package/dist/tools/sam-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sam-test.d.ts","sourceRoot":"","sources":["../../src/tools/sam-test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAoBzD,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoC/C,MAAM,EAAE;;yBAEnB,MAAM,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EAwFrE"}

package/dist/tools/sam-test.js

@@ -0,0 +1,191 @@
+/**
+ * sam_test — Run test suites in the Docker sandbox
+ *
+ * Supports vitest, jest, pytest, and custom test commands.
+ * Parses structured results from test output.
+ */
+const FRAMEWORK_COMMANDS = {
+    vitest: {
+        install: 'npm init -y && npm install vitest --save-dev',
+        run: 'npx vitest run --reporter=json 2>/dev/null || npx vitest run',
+        language: 'nodejs',
+    },
+    jest: {
+        install: 'npm init -y && npm install jest --save-dev',
+        run: 'npx jest --json 2>/dev/null || npx jest',
+        language: 'nodejs',
+    },
+    pytest: {
+        install: 'pip3 install --user pytest',
+        run: 'python3 -m pytest -v',
+        language: 'python',
+    },
+};
+export function createTestTool(sandbox, getMemory) {
+    return {
+        name: 'sam_test',
+        description: 'Run test suites in the Docker sandbox. ' +
+            'Supports vitest, jest, pytest, or custom commands. ' +
+            'Returns passed/failed/skipped counts and failure details.',
+        parameters: {
+            type: 'object',
+            properties: {
+                framework: {
+                    type: 'string',
+                    enum: ['vitest', 'jest', 'pytest', 'custom'],
+                    description: 'Test framework to use',
+                },
+                files: {
+                    type: 'array',
+                    description: 'Source and test files to place in /workspace',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            filename: { type: 'string' },
+                            content: { type: 'string' },
+                        },
+                        required: ['filename', 'content'],
+                    },
+                },
+                command: {
+                    type: 'string',
+                    description: 'Custom test command (required when framework is "custom")',
+                },
+                er_id: {
+                    type: 'string',
+                    description: 'Engineering Request ID',
+                },
+            },
+            required: ['framework', 'files'],
+        },
+        async execute(_toolCallId, params) {
+            try {
+                const framework = params.framework;
+                const files = params.files;
+                const customCommand = params.command;
+                const erId = params.er_id;
+                let code;
+                let language;
+                if (framework === 'custom') {
+                    if (!customCommand) {
+                        return {
+                            content: [{ type: 'text', text: 'Custom framework requires a "command" parameter' }],
+                            isError: true,
+                        };
+                    }
+                    code = customCommand;
+                    language = 'bash';
+                }
+                else {
+                    const fw = FRAMEWORK_COMMANDS[framework];
+                    if (!fw) {
+                        return {
+                            content: [{ type: 'text', text: `Unknown framework: ${framework}` }],
+                            isError: true,
+                        };
+                    }
+                    code = `cd /workspace && ${fw.install} 2>/dev/null && ${fw.run}`;
+                    language = 'bash';
+                }
+                const result = await sandbox.execute(language, code, files, {
+                    timeoutMs: 10 * 60 * 1000,
+                    networkEnabled: true,
+                    erId,
+                });
+                const testResult = parseTestOutput(result.stdout, result.stderr, framework);
+                const memory = getMemory();
+                if (memory && erId) {
+                    memory.writer?.write?.({
+                        agent: 'sam',
+                        type: 'test-execution',
+                        tags: ['engineering', 'test', framework, erId],
+                        title: `Test Execution: ${erId} — ${framework}`,
+                        body: `## Test Results\n\n` +
+                            `**Framework**: ${framework}\n` +
+                            `**Passed**: ${testResult.passed}\n` +
+                            `**Failed**: ${testResult.failed}\n` +
+                            `**Skipped**: ${testResult.skipped}\n` +
+                            `**Duration**: ${result.executionTimeMs}ms\n` +
+                            `**Exit Code**: ${result.exitCode}\n`,
+                        metadata: {
+                            er_id: erId,
+                            framework,
+                            passed: testResult.passed,
+                            failed: testResult.failed,
+                            skipped: testResult.skipped,
+                        },
+                    }).catch(() => { });
+                }
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                framework,
+                                passed: testResult.passed,
+                                failed: testResult.failed,
+                                skipped: testResult.skipped,
+                                failureDetails: testResult.failureDetails.slice(0, 20),
+                                executionTimeMs: result.executionTimeMs,
+                                exitCode: result.exitCode,
+                                output: (result.stdout + result.stderr).slice(0, 10_000),
+                            }, null, 2),
+                        }],
+                    ...(testResult.failed > 0 ? { isError: true } : {}),
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: `sam_test error: ${err instanceof Error ? err.message : String(err)}` }],
+                    isError: true,
+                };
+            }
+        },
+    };
+}
+function parseTestOutput(stdout, stderr, framework) {
+    const combined = stdout + '\n' + stderr;
+    // Try JSON parse for vitest/jest
+    if (framework === 'vitest' || framework === 'jest') {
+        try {
+            const json = JSON.parse(stdout);
+            if (json.numPassedTests !== undefined) {
+                return {
+                    passed: json.numPassedTests ?? 0,
+                    failed: json.numFailedTests ?? 0,
+                    skipped: json.numPendingTests ?? 0,
+                    failureDetails: (json.testResults ?? [])
+                        .flatMap((r) => (r.assertionResults ?? []).filter((a) => a.status === 'failed'))
+                        .map((a) => ({ testName: a.fullName ?? a.title ?? 'unknown', error: (a.failureMessages ?? []).join('\n') })),
+                };
+            }
+        }
+        catch { /* fall through to regex */ }
+    }
+    // Regex fallback
+    let passed = 0, failed = 0, skipped = 0;
+    const failureDetails = [];
+    // vitest/jest pattern: "Tests  X passed (Y)"
+    const vitestMatch = combined.match(/Tests\s+(\d+)\s+passed/);
+    if (vitestMatch)
+        passed = parseInt(vitestMatch[1]);
+    const vitestFail = combined.match(/Tests\s+(\d+)\s+failed/);
+    if (vitestFail)
+        failed = parseInt(vitestFail[1]);
+    // pytest pattern: "X passed, Y failed"
+    const pytestMatch = combined.match(/(\d+)\s+passed/);
+    if (pytestMatch && !vitestMatch)
+        passed = parseInt(pytestMatch[1]);
+    const pytestFail = combined.match(/(\d+)\s+failed/);
+    if (pytestFail && !vitestFail)
+        failed = parseInt(pytestFail[1]);
+    const skipMatch = combined.match(/(\d+)\s+skipped/);
+    if (skipMatch)
+        skipped = parseInt(skipMatch[1]);
+    // Extract FAIL lines as failure details
+    const failLines = combined.match(/FAIL\s+.+/g) ?? [];
+    for (const line of failLines.slice(0, 20)) {
+        failureDetails.push({ testName: line.replace(/^FAIL\s+/, ''), error: 'See full output' });
+    }
+    return { passed, failed, skipped, failureDetails };
+}
+//# sourceMappingURL=sam-test.js.map

package/dist/tools/sam-test.js.map

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

package/docker/Dockerfile

@@ -0,0 +1,16 @@
+FROM node:20-slim
+
+RUN apt-get update && apt-get install -y \
+    python3 python3-pip python3-venv \
+    git curl jq \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd -m -s /bin/bash builder
+
+WORKDIR /workspace
+RUN chown builder:builder /workspace
+
+RUN mkdir -p /artifacts && chown builder:builder /artifacts
+
+USER builder
+CMD ["/bin/bash"]

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "sam",
   "name": "Sam — Chief Engineer",
   "description": "Chief Engineer plugin — engineering pipeline management, Docker sandbox execution, autonomous build/test/deliver lifecycle, fleet-bus communications, and searchable engineering memory.",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "entry": "dist/plugin.js",
   "configSchema": {
     "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiassesstech/sam",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Sam — Chief Engineer plugin for OpenClaw. Engineering pipeline, Docker sandbox, autonomous execution, fleet-bus communications.",
   "type": "module",
   "main": "dist/index.js",
@@ -17,6 +17,7 @@
     "dist",
     "agent",
     "openclaw.plugin.json",
+    "docker",
     "README.md",
     "LICENSE"
   ],