@aiassesstech/sam 0.3.16 → 0.4.0

package/README.md

@@ -0,0 +1,41 @@
+# @aiassesstech/sam
+
+Sam — Chief Engineer plugin for OpenClaw. Engineering pipeline management, Docker sandbox execution, autonomous code execution, and fleet-bus communications.
+
+## Install
+
+```bash
+npm install @aiassesstech/sam
+```
+
+## Setup
+
+```bash
+npx @aiassesstech/sam setup --model anthropic/claude-haiku-4-5
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `sam_status` | Current agent state, pipeline summary, sandbox/fleet status |
+| `sam_pipeline` | View engineering pipeline with filters (active/blocked/complete) |
+| `sam_request` | Create, update, or close Engineering Requests |
+| `sam_report` | Generate summary, detailed, or debt reports |
+| `sam_execute` | Run code in Docker sandbox (Node.js, Python, bash) |
+| `sam_sandbox` | Manage sandbox lifecycle (status, build, cleanup) |
+| `sam_test` | Run test suites in sandbox (vitest, jest, pytest, custom) |
+| `sam_artifact` | List, package, and clean up build artifacts |
+| `sam_fleet_task_status` | Report ER status to Jessie via fleet-bus |
+| `sam_fleet_task_complete` | Report ER completion with artifact reference |
+
+## Architecture
+
+- **PipelineManager** — Engineering Request lifecycle (INTAKE → ANALYSIS → BUILD → SELF-REVIEW → ARCHIE-REVIEW → DELIVERED)
+- **SandboxManager** — Docker container lifecycle with resource limits
+- **DirectMemoryWriter** — Filesystem-based memory persistence (compatible with Mighty Mark vector search)
+- **Fleet-bus integration** — Cross-agent task coordination with Jessie
+
+## Repository
+
+Part of the [compsi](https://github.com/spehargreg/compsi) monorepo — `packages/sam/`.

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export type { PipelineStage, EngineeringRequest, PipelineData, SamStatusResult,
 export { PIPELINE_STAGES, STAGE_ORDER, DEFAULT_CONFIG } from './pipeline/types.js';
 export type { FleetContext } from './tools/sam-fleet-tools.js';
 export type { MemoryWriterLike } from './memory/sam-memory.js';
+export { EngineSessionManager } from './tools/engine-session-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnF,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEnF,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -5,4 +5,5 @@ export { SamMemory } from './memory/sam-memory.js';
 export { DirectMemoryWriter } from './memory/direct-writer.js';
 export { SandboxManager } from './sandbox/sandbox-manager.js';
 export { PIPELINE_STAGES, STAGE_ORDER, DEFAULT_CONFIG } from './pipeline/types.js';
+export { EngineSessionManager } from './tools/engine-session-manager.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAa9D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAa9D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAInF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/pipeline/types.d.ts

@@ -19,6 +19,12 @@ export interface EngineeringRequest {
     deliveredAt?: string;
     buildAttempts: number;
     notes: string[];
+    engineSessionId?: string;
+    engineTurnCount?: number;
+    engineCostUsd?: number;
+    engineAuditHead?: string;
+    engineWorktreePath?: string;
+    engineLastGrilloVerdict?: 'allow' | 'allow_with_comment' | 'block';
 }
 export interface PipelineData {
     version: number;
@@ -44,6 +50,13 @@ export interface SamStatusResult {
         status: 'unavailable' | 'available' | 'busy';
     };
     fleetBus: 'connected' | 'observer' | 'standalone';
+    engine?: {
+        status: 'disabled' | 'enabled' | 'active';
+        activeSessions: number;
+        activeErIds: string[];
+        model: string;
+        grilloFailMode: string;
+    };
 }
 export interface PipelineFilter {
     filter?: 'all' | 'active' | 'blocked' | 'complete';
@@ -68,6 +81,19 @@ export interface SamPluginConfig {
     artifactRetentionDays: number;
     telegramToken?: string;
     telegramChatId?: string;
+    engineEnabled: boolean;
+    anthropicApiKey?: string;
+    engineModel?: string;
+    worktreeBasePath?: string;
+    maxBudgetUsd?: number;
+    maxBudgetTokens?: number;
+    maxIterations?: number;
+    sessionTimeoutMs?: number;
+    grilloFailMode?: 'fail_closed' | 'fail_open';
+    jessieResponseTimeoutMs?: number;
+    grilloEndpoint?: string;
+    noahEndpoint?: string;
+    jessieEndpoint?: string;
 }
 export declare const DEFAULT_CONFIG: SamPluginConfig;
 //# sourceMappingURL=types.d.ts.map

package/dist/pipeline/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,UAAU,GACV,OAAO,GACP,aAAa,GACb,eAAe,GACf,WAAW,CAAC;AAEhB,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAO1C,CAAC;AAEX,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAOrD,CAAC;AAIF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE;QACP,MAAM,EAAE,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;KAC9C,CAAC;IACF,QAAQ,EAAE,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACxC;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,EAAE,eAM5B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/types.js

@@ -26,5 +26,14 @@ export const DEFAULT_CONFIG = {
     sandboxImage: 'sam-sandbox:latest',
     artifactDir: '.sam-artifacts',
     artifactRetentionDays: 7,
+    engineEnabled: false,
+    engineModel: 'claude-sonnet-4-6',
+    worktreeBasePath: '/root/sam/worktrees',
+    maxBudgetUsd: 10.0,
+    maxBudgetTokens: 500_000,
+    maxIterations: 50,
+    sessionTimeoutMs: 1_800_000,
+    grilloFailMode: 'fail_closed',
+    jessieResponseTimeoutMs: 1_800_000,
 };
 //# sourceMappingURL=types.js.map

package/dist/pipeline/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,QAAQ;IACR,UAAU;IACV,OAAO;IACP,aAAa;IACb,eAAe;IACf,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,CAAC;CACf,CAAC;AA+EF,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,OAAO,EAAE,WAAW;IACpB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,oBAAoB;IAClC,WAAW,EAAE,gBAAgB;IAC7B,qBAAqB,EAAE,CAAC;CACzB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pipeline/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,QAAQ;IACR,UAAU;IACV,OAAO;IACP,aAAa;IACb,eAAe;IACf,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD,QAAQ,EAAE,CAAC;IACX,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,CAAC;IAChB,eAAe,EAAE,CAAC;IAClB,WAAW,EAAE,CAAC;CACf,CAAC;AA6GF,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,OAAO,EAAE,WAAW;IACpB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,oBAAoB;IAClC,WAAW,EAAE,gBAAgB;IAC7B,qBAAqB,EAAE,CAAC;IACxB,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,mBAAmB;IAChC,gBAAgB,EAAE,qBAAqB;IACvC,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,OAAO;IACxB,aAAa,EAAE,EAAE;IACjB,gBAAgB,EAAE,SAAS;IAC3B,cAAc,EAAE,aAAa;IAC7B,uBAAuB,EAAE,SAAS;CACnC,CAAC"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAyFH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QA+WxC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AA4GH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAucxC"}

package/dist/plugin.js

@@ -34,6 +34,12 @@ import { createExecuteTool } from './tools/sam-execute.js';
 import { createSandboxTool } from './tools/sam-sandbox.js';
 import { createTestTool } from './tools/sam-test.js';
 import { createArtifactTool } from './tools/sam-artifact.js';
+import { createEngineerTool } from './tools/sam-engineer.js';
+import { createEngineerStatusTool } from './tools/sam-engineer-status.js';
+import { createEngineerDiffTool } from './tools/sam-engineer-diff.js';
+import { createEngineerResumeTool } from './tools/sam-engineer-resume.js';
+import { createEngineerTerminateTool } from './tools/sam-engineer-terminate.js';
+import { EngineSessionManager } from './tools/engine-session-manager.js';
 import { SamMemory } from './memory/sam-memory.js';
 import { SandboxManager } from './sandbox/sandbox-manager.js';
 import { DEFAULT_CONFIG } from './pipeline/types.js';
@@ -75,6 +81,19 @@ function resolveConfig(api) {
         artifactRetentionDays: raw.artifactRetentionDays ?? DEFAULT_CONFIG.artifactRetentionDays,
         telegramToken: raw.telegramToken,
         telegramChatId: raw.telegramChatId,
+        engineEnabled: raw.engineEnabled ?? DEFAULT_CONFIG.engineEnabled,
+        anthropicApiKey: raw.anthropicApiKey,
+        engineModel: raw.engineModel ?? DEFAULT_CONFIG.engineModel,
+        worktreeBasePath: raw.worktreeBasePath ?? DEFAULT_CONFIG.worktreeBasePath,
+        maxBudgetUsd: raw.maxBudgetUsd ?? DEFAULT_CONFIG.maxBudgetUsd,
+        maxBudgetTokens: raw.maxBudgetTokens ?? DEFAULT_CONFIG.maxBudgetTokens,
+        maxIterations: raw.maxIterations ?? DEFAULT_CONFIG.maxIterations,
+        sessionTimeoutMs: raw.sessionTimeoutMs ?? DEFAULT_CONFIG.sessionTimeoutMs,
+        grilloFailMode: raw.grilloFailMode ?? DEFAULT_CONFIG.grilloFailMode,
+        jessieResponseTimeoutMs: raw.jessieResponseTimeoutMs ?? DEFAULT_CONFIG.jessieResponseTimeoutMs,
+        grilloEndpoint: raw.grilloEndpoint,
+        noahEndpoint: raw.noahEndpoint,
+        jessieEndpoint: raw.jessieEndpoint,
     };
 }
 // ── Tool Registration Helper ─────────────────────────────────────
@@ -105,6 +124,14 @@ export default function register(api) {
     let validatedToolFactory = null;
     let validationSchemas = {};
     let validationBusinessRules = {};
+    // Engine Bridge (Phase 3) — session manager + deferred bridge loader
+    const engineSessions = new EngineSessionManager();
+    let bridgeLoader = null;
+    if (cfg.engineEnabled) {
+        const bridgeMod = '@aiassesstech/sam-engine-bridge';
+        bridgeLoader = () => import(bridgeMod);
+        console.log(`[sam] Engine bridge enabled — model: ${cfg.engineModel}, grilloFailMode: ${cfg.grilloFailMode}`);
+    }
     const getFleetBusStatus = () => fleetBusState;
     function validationErrorResponse(message) {
         return {
@@ -112,7 +139,7 @@ export default function register(api) {
             isError: true,
         };
     }
-    const ENFORCE_TOOLS = new Set(['sam_execute', 'sam_sandbox']);
+    const ENFORCE_TOOLS = new Set(['sam_execute', 'sam_sandbox', 'sam_engineer']);
     let alertBus = null;
     const fleetAlertingMod = '@aiassesstech/fleet-alerting';
     import(fleetAlertingMod)
@@ -137,7 +164,7 @@ export default function register(api) {
         return { ok: true, params: result };
     }
     // ── Phase 1: Management Tools (always available) ────────────
-    const statusTool = createStatusTool(pipeline, cfg, getFleetBusStatus);
+    const statusTool = createStatusTool(pipeline, cfg, getFleetBusStatus, engineSessions);
     const origStatusExec = statusTool.execute.bind(statusTool);
     statusTool.execute = async function (_toolCallId, params) {
         const v = await validateToolParams('sam_status', _toolCallId, params);
@@ -207,7 +234,7 @@ export default function register(api) {
         return origTestExec(_toolCallId, v.params);
     };
     registerTool(api, testTool);
-    const artifactTool = createArtifactTool(sandbox);
+    const artifactTool = createArtifactTool(sandbox, engineSessions);
     const origArtifactExec = artifactTool.execute.bind(artifactTool);
     artifactTool.execute = async function (_toolCallId, params) {
         const v = await validateToolParams('sam_artifact', _toolCallId, params);
@@ -239,6 +266,54 @@ export default function register(api) {
     };
     registerTool(api, fleetTaskCompleteTool);
     console.log('[sam] Fleet tools registered: sam_fleet_task_status, sam_fleet_task_complete (fleet context pending)');
+    // ── Phase 4: Engine Tools (always registered, engine checked at call time) ───
+    // Per rule 155: unconditional registration — availability checked in execute().
+    const engineerTool = createEngineerTool(pipeline, cfg, engineSessions, () => samMemory, bridgeLoader);
+    const origEngineerExec = engineerTool.execute.bind(engineerTool);
+    engineerTool.execute = async function (_toolCallId, params) {
+        const v = await validateToolParams('sam_engineer', _toolCallId, params);
+        if (!v.ok)
+            return validationErrorResponse(v.message);
+        return origEngineerExec(_toolCallId, v.params);
+    };
+    registerTool(api, engineerTool);
+    const engineerStatusTool = createEngineerStatusTool(engineSessions);
+    const origEngStatusExec = engineerStatusTool.execute.bind(engineerStatusTool);
+    engineerStatusTool.execute = async function (_toolCallId, params) {
+        const v = await validateToolParams('sam_engineer_status', _toolCallId, params);
+        if (!v.ok)
+            return validationErrorResponse(v.message);
+        return origEngStatusExec(_toolCallId, v.params);
+    };
+    registerTool(api, engineerStatusTool);
+    const engineerDiffTool = createEngineerDiffTool(engineSessions);
+    const origEngDiffExec = engineerDiffTool.execute.bind(engineerDiffTool);
+    engineerDiffTool.execute = async function (_toolCallId, params) {
+        const v = await validateToolParams('sam_engineer_diff', _toolCallId, params);
+        if (!v.ok)
+            return validationErrorResponse(v.message);
+        return origEngDiffExec(_toolCallId, v.params);
+    };
+    registerTool(api, engineerDiffTool);
+    const engineerResumeTool = createEngineerResumeTool(pipeline, engineSessions);
+    const origEngResumeExec = engineerResumeTool.execute.bind(engineerResumeTool);
+    engineerResumeTool.execute = async function (_toolCallId, params) {
+        const v = await validateToolParams('sam_engineer_resume', _toolCallId, params);
+        if (!v.ok)
+            return validationErrorResponse(v.message);
+        return origEngResumeExec(_toolCallId, v.params);
+    };
+    registerTool(api, engineerResumeTool);
+    const engineerTerminateTool = createEngineerTerminateTool(pipeline, engineSessions, () => samMemory);
+    const origEngTermExec = engineerTerminateTool.execute.bind(engineerTerminateTool);
+    engineerTerminateTool.execute = async function (_toolCallId, params) {
+        const v = await validateToolParams('sam_engineer_terminate', _toolCallId, params);
+        if (!v.ok)
+            return validationErrorResponse(v.message);
+        return origEngTermExec(_toolCallId, v.params);
+    };
+    registerTool(api, engineerTerminateTool);
+    console.log(`[sam] Engine tools registered: sam_engineer, sam_engineer_status, sam_engineer_diff, sam_engineer_resume, sam_engineer_terminate (engine=${cfg.engineEnabled ? 'active' : 'inactive'})`);
     // ── Command: /sam ──────────────────────────────────────────
     api.registerCommand({
         name: 'sam',
@@ -249,14 +324,20 @@ export default function register(api) {
                 text: '# Sam — Chief Engineer\n\n' +
                     'Use Sam\'s tools for engineering pipeline management:\n\n' +
                     '**Pipeline Management:**\n' +
-                    '- **sam_status** — Current state: active ERs, sandbox, fleet-bus\n' +
+                    '- **sam_status** — Current state: active ERs, sandbox, fleet-bus, engine\n' +
                     '- **sam_pipeline** — Full engineering pipeline view with filters\n' +
                     '- **sam_request** — Create, update, or close Engineering Requests\n' +
                     '- **sam_report** — Engineering reports (summary, detailed, debt)\n\n' +
-                    '**Fleet Communications (Phase 2):**\n' +
+                    '**Autonomous Engineering Engine:**\n' +
+                    '- **sam_engineer** — Start/continue an autonomous engineering session for an ER\n' +
+                    '- **sam_engineer_status** — Session state, cost, files changed, Grillo verdicts\n' +
+                    '- **sam_engineer_diff** — Git diff from the engine\'s worktree\n' +
+                    '- **sam_engineer_resume** — Resume a paused session with optional new guidance\n' +
+                    '- **sam_engineer_terminate** — Hard stop a session (commits in-flight work)\n\n' +
+                    '**Fleet Communications:**\n' +
                     '- **sam_fleet_task_status** — Report ER stage change to Jessie\n' +
                     '- **sam_fleet_task_complete** — Signal ER completion to Jessie\n\n' +
-                    '**Sandbox (Phase 3):**\n' +
+                    '**Sandbox:**\n' +
                     '- **sam_execute** — Run code in Docker sandbox\n' +
                     '- **sam_sandbox** — Manage sandbox lifecycle\n' +
                     '- **sam_test** — Run test suites in sandbox\n' +
@@ -280,7 +361,7 @@ export default function register(api) {
     // ── Prompt Shield Integration (Behavioral Validation) ───────────
     const promptShieldMod = '@aiassesstech/prompt-shield';
     import(promptShieldMod)
-        .then(({ createValidatedToolHandler, sam_execute: samExecuteSchema, SAM_EXECUTE_BUSINESS_RULES, sam_sandbox: samSandboxSchema, sam_status: samStatusSchema, sam_pipeline: samPipelineSchema, sam_request: samRequestSchema, sam_report: samReportSchema, sam_test: samTestSchema, sam_artifact: samArtifactSchema, sam_fleet_task_status: samFleetTaskStatusSchema, sam_fleet_task_complete: samFleetTaskCompleteSchema, }) => {
+        .then(({ createValidatedToolHandler, sam_execute: samExecuteSchema, SAM_EXECUTE_BUSINESS_RULES, sam_sandbox: samSandboxSchema, sam_status: samStatusSchema, sam_pipeline: samPipelineSchema, sam_request: samRequestSchema, sam_report: samReportSchema, sam_test: samTestSchema, sam_artifact: samArtifactSchema, sam_fleet_task_status: samFleetTaskStatusSchema, sam_fleet_task_complete: samFleetTaskCompleteSchema, sam_engineer: samEngineerSchema, SAM_ENGINEER_BUSINESS_RULES, sam_engineer_status: samEngineerStatusSchema, sam_engineer_diff: samEngineerDiffSchema, sam_engineer_resume: samEngineerResumeSchema, sam_engineer_terminate: samEngineerTerminateSchema, }) => {
         validatedToolFactory = createValidatedToolHandler;
         validationSchemas = {
             sam_execute: samExecuteSchema,
@@ -293,11 +374,17 @@ export default function register(api) {
             sam_artifact: samArtifactSchema,
             sam_fleet_task_status: samFleetTaskStatusSchema,
             sam_fleet_task_complete: samFleetTaskCompleteSchema,
+            sam_engineer: samEngineerSchema,
+            sam_engineer_status: samEngineerStatusSchema,
+            sam_engineer_diff: samEngineerDiffSchema,
+            sam_engineer_resume: samEngineerResumeSchema,
+            sam_engineer_terminate: samEngineerTerminateSchema,
         };
         validationBusinessRules = {
             sam_execute: SAM_EXECUTE_BUSINESS_RULES,
+            sam_engineer: SAM_ENGINEER_BUSINESS_RULES,
         };
-        console.log('[sam] Behavioral validation active: 10 tools (sam_execute/sam_sandbox enforce, rest monitor)');
+        console.log('[sam] Behavioral validation active: 15 tools (sam_execute/sam_sandbox/sam_engineer enforce, rest monitor)');
     })
         .catch(() => {
         console.warn('[sam] Prompt shield unavailable — behavioral validation disabled');
@@ -325,6 +412,9 @@ export default function register(api) {
                     'task/assign',
                     'task/cancel',
                     'task/priority_change',
+                    'task/budget-request',
+                    'task/escalation',
+                    'task/redirect',
                     'veto/issue',
                     'fleet/ping',
                     'fleet/pong',
@@ -343,11 +433,20 @@ export default function register(api) {
                     else if (method === 'task/priority_change') {
                         await handleTaskPriorityChange(msg, pipeline, fleetContext);
                     }
+                    else if (method === 'task/budget-request') {
+                        await handleBudgetRequest(msg, pipeline, fleetContext, engineSessions);
+                    }
+                    else if (method === 'task/escalation') {
+                        await handleEscalation(msg, pipeline, fleetContext, engineSessions);
+                    }
+                    else if (method === 'task/redirect') {
+                        await handleRedirect(msg, pipeline, fleetContext, engineSessions);
+                    }
                     else if (method === 'veto/issue') {
                         await handleVetoIssue(msg, pipeline, samMemory);
                     }
                     else if (method === 'fleet/ping') {
-                        await handleFleetPing(msg, pipeline, cfg, fleetContext);
+                        await handleFleetPing(msg, pipeline, cfg, fleetContext, engineSessions);
                     }
                 },
             });
@@ -367,6 +466,8 @@ export default function register(api) {
         'sam_status', 'sam_pipeline', 'sam_request', 'sam_report',
         'sam_execute', 'sam_sandbox', 'sam_test', 'sam_artifact',
         'sam_fleet_task_status', 'sam_fleet_task_complete',
+        'sam_engineer', 'sam_engineer_status', 'sam_engineer_diff',
+        'sam_engineer_resume', 'sam_engineer_terminate',
     ].join(', ');
     let capturedWorkspaceDir = null;
     api.registerHook("agent:bootstrap", async (event) => {
@@ -556,7 +657,7 @@ async function handleTaskPriorityChange(msg, pipeline, fleet) {
         console.error(`[sam] Failed to handle task/priority_change: ${err}`);
     }
 }
-async function handleFleetPing(msg, pipeline, cfg, fleet) {
+async function handleFleetPing(msg, pipeline, cfg, fleet, engineSessions) {
     const summary = pipeline.getSummary();
     try {
         await fleet.fleetSend(fleet.bus, fleet.transport, {
@@ -565,11 +666,13 @@ async function handleFleetPing(msg, pipeline, cfg, fleet) {
             params: {
                 agentId: 'sam',
                 currentStatus: 'active',
-                toolCount: 12,
+                toolCount: 15,
                 pendingTasks: summary.active,
                 activeERs: summary.active,
                 blockedERs: summary.blocked,
                 sandboxStatus: cfg.sandboxEnabled ? 'available' : 'unavailable',
+                engineStatus: cfg.engineEnabled ? 'enabled' : 'disabled',
+                activeEngineSessions: engineSessions?.activeCount() ?? 0,
                 memoryUsageMB: Math.round(process.memoryUsage().heapUsed / 1024 / 1024),
                 uptimeMs: process.uptime() * 1000,
             },
@@ -580,4 +683,130 @@ async function handleFleetPing(msg, pipeline, cfg, fleet) {
         console.error(`[sam] Failed to send fleet/pong: ${err}`);
     }
 }
+// ── Engine-related Fleet Inbound Handlers ────────────────────────
+async function handleBudgetRequest(msg, pipeline, fleet, engineSessions) {
+    const p = msg.params ?? {};
+    const erId = p.taskId ?? p.er_id;
+    if (!erId) {
+        console.warn('[sam] task/budget-request received without taskId — ignoring');
+        return;
+    }
+    const session = engineSessions.get(erId);
+    if (!session) {
+        await fleet.fleetSend(fleet.bus, fleet.transport, {
+            to: msg.from ?? 'jessie',
+            method: 'task/status',
+            params: {
+                taskId: erId,
+                agentId: 'sam',
+                status: 'no_session',
+                details: `No active engine session for ${erId}`,
+            },
+            correlationId: msg.id,
+        });
+        return;
+    }
+    try {
+        const usage = await session.getUsage();
+        await fleet.fleetSend(fleet.bus, fleet.transport, {
+            to: msg.from ?? 'jessie',
+            method: 'task/status',
+            params: {
+                taskId: erId,
+                agentId: 'sam',
+                status: 'budget_report',
+                usage: {
+                    totalInputTokens: usage.totalInputTokens,
+                    totalOutputTokens: usage.totalOutputTokens,
+                    totalCostUsd: usage.totalCostUsdCents / 100,
+                    turns: usage.turnCount,
+                },
+            },
+            correlationId: msg.id,
+        });
+    }
+    catch (err) {
+        console.error(`[sam] Failed to handle task/budget-request for ${erId}: ${err}`);
+    }
+}
+async function handleEscalation(msg, pipeline, fleet, engineSessions) {
+    const p = msg.params ?? {};
+    const erId = p.taskId ?? p.er_id;
+    const action = p.action ?? 'terminate';
+    const reason = p.reason ?? 'Escalation from fleet';
+    if (!erId) {
+        console.warn('[sam] task/escalation received without taskId — ignoring');
+        return;
+    }
+    const session = engineSessions.get(erId);
+    if (!session) {
+        console.warn(`[sam] task/escalation for ${erId} but no active session`);
+        return;
+    }
+    try {
+        if (action === 'terminate') {
+            await session.terminate();
+            engineSessions.delete(erId);
+            await pipeline.handleRequest({
+                action: 'update',
+                er_id: erId,
+                blocker: `ESCALATION TERMINATED: ${reason}`,
+                notes: `Engine terminated via fleet escalation from ${msg.from}: ${reason}`,
+            }).catch(() => { });
+            await fleet.fleetSend(fleet.bus, fleet.transport, {
+                to: msg.from ?? 'jessie',
+                method: 'task/complete',
+                params: {
+                    taskId: erId,
+                    success: false,
+                    result: `Terminated via escalation: ${reason}`,
+                    status: 'terminated',
+                },
+                correlationId: msg.id,
+            });
+        }
+        console.log(`[sam] Escalation handled for ${erId}: ${action} — ${reason}`);
+    }
+    catch (err) {
+        console.error(`[sam] Failed to handle task/escalation for ${erId}: ${err}`);
+    }
+}
+async function handleRedirect(msg, pipeline, fleet, engineSessions) {
+    const p = msg.params ?? {};
+    const erId = p.taskId ?? p.er_id;
+    const newGuidance = p.guidance ?? p.instructions ?? 'Redirect received — adjust approach.';
+    if (!erId) {
+        console.warn('[sam] task/redirect received without taskId — ignoring');
+        return;
+    }
+    const session = engineSessions.get(erId);
+    if (!session) {
+        console.warn(`[sam] task/redirect for ${erId} but no active session`);
+        return;
+    }
+    try {
+        const result = await session.sendTurn(newGuidance);
+        await pipeline.handleRequest({
+            action: 'update',
+            er_id: erId,
+            notes: `[redirect] from ${msg.from}: ${newGuidance.slice(0, 100)}`,
+        }).catch(() => { });
+        await fleet.fleetSend(fleet.bus, fleet.transport, {
+            to: msg.from ?? 'jessie',
+            method: 'task/status',
+            params: {
+                taskId: erId,
+                agentId: 'sam',
+                status: result.success ? 'completed' : 'in_progress',
+                details: `Redirect processed: ${result.iterations} iterations, ${result.toolCalls.length} tool calls`,
+                success: result.success,
+            },
+            correlationId: msg.id,
+        });
+        console.log(`[sam] Redirect processed for ${erId} from ${msg.from}`);
+    }
+    catch (err) {
+        console.error(`[sam] Failed to handle task/redirect for ${erId}: ${err}`);
+    }
+}
 //# sourceMappingURL=plugin.js.map