@amodalai/runtime 0.1.0

package/dist/src/agent/routes/webhooks.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { Router } from 'express';
+import { verifyHmacSignature } from '../proactive/delivery.js';
+/**
+ * Creates routes for receiving webhook events from external systems.
+ *
+ * POST /webhooks/:name — trigger a webhook-based automation
+ */
+export function createWebhookRouter(options) {
+    const router = Router();
+    router.post('/webhooks/:name', async (req, res) => {
+        const automationName = req.params['name'] ?? '';
+        // HMAC verification
+        if (options.webhookSecret) {
+            const signature = req.headers['x-amodal-signature'];
+            if (typeof signature !== 'string') {
+                res.status(401).json({ error: 'Missing X-Amodal-Signature header' });
+                return;
+            }
+            const rawBody = typeof req.body === 'string'
+                ? req.body
+                : JSON.stringify(req.body);
+            if (!verifyHmacSignature(rawBody, signature, options.webhookSecret)) {
+                res.status(401).json({ error: 'Invalid webhook signature' });
+                return;
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Express body parsing
+        const payload = (req.body ?? {});
+        try {
+            const result = await options.runner.handleWebhook(automationName, payload);
+            if (!result.matched) {
+                res.status(404).json({ error: result.error });
+                return;
+            }
+            if (result.error) {
+                res.status(500).json({ error: result.error, matched: true });
+                return;
+            }
+            res.json({ status: 'accepted', automation: automationName });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            res.status(500).json({ error: msg });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/src/agent/routes/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../../src/agent/routes/webhooks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,MAAM,EAAC,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAQ7D;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,EAAE;QACnE,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAEhD,oBAAoB;QACpB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;YACpD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAClC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,mCAAmC,EAAC,CAAC,CAAC;gBACnE,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAC1C,CAAC,CAAC,GAAG,CAAC,IAAI;gBACV,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAE7B,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;gBACpE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,2BAA2B,EAAC,CAAC,CAAC;gBAC3D,OAAO;YACT,CAAC;QACH,CAAC;QAED,+FAA+F;QAC/F,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC;QAE5D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAC,CAAC,CAAC;gBAC5C,OAAO;YACT,CAAC;YAED,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,CAAC;gBAC3D,OAAO;YACT,CAAC;YAED,GAAG,CAAC,IAAI,CAAC,EAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,EAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAC,KAAK,EAAE,GAAG,EAAC,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/agent/routes/webhooks.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/agent/routes/webhooks.test.js

@@ -0,0 +1,100 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi } from 'vitest';
+import express from 'express';
+import request from 'supertest';
+import { createHmac } from 'node:crypto';
+import { createWebhookRouter } from './webhooks.js';
+function makeMockRunner(overrides) {
+    return {
+        start: vi.fn(),
+        stop: vi.fn(),
+        listAutomations: vi.fn().mockReturnValue([]),
+        handleWebhook: vi.fn().mockResolvedValue({ matched: true }),
+        triggerAutomation: vi.fn().mockResolvedValue({ success: true }),
+        ...overrides,
+    };
+}
+function createApp(runner, webhookSecret) {
+    const app = express();
+    app.use(express.json());
+    app.use(createWebhookRouter({ runner, webhookSecret }));
+    return app;
+}
+describe('repo-webhooks routes', () => {
+    it('should accept valid webhook', async () => {
+        const runner = makeMockRunner();
+        const app = createApp(runner);
+        const res = await request(app)
+            .post('/webhooks/my-auto')
+            .send({ alert: 'cpu-high' });
+        expect(res.status).toBe(200);
+        expect(res.body.status).toBe('accepted');
+        expect(runner.handleWebhook).toHaveBeenCalledWith('my-auto', { alert: 'cpu-high' });
+    });
+    it('should return 404 for unmatched automation', async () => {
+        const runner = makeMockRunner({
+            handleWebhook: vi.fn().mockResolvedValue({ matched: false, error: 'Not found' }),
+        });
+        const app = createApp(runner);
+        const res = await request(app)
+            .post('/webhooks/unknown')
+            .send({});
+        expect(res.status).toBe(404);
+    });
+    it('should return 500 on automation error', async () => {
+        const runner = makeMockRunner({
+            handleWebhook: vi.fn().mockResolvedValue({ matched: true, error: 'Exec failed' }),
+        });
+        const app = createApp(runner);
+        const res = await request(app)
+            .post('/webhooks/my-auto')
+            .send({});
+        expect(res.status).toBe(500);
+        expect(res.body.error).toBe('Exec failed');
+    });
+    it('should verify HMAC signature when secret is set', async () => {
+        const runner = makeMockRunner();
+        const secret = 'my-secret';
+        const app = createApp(runner, secret);
+        const body = JSON.stringify({ alert: 'test' });
+        const sig = `sha256=${createHmac('sha256', secret).update(body).digest('hex')}`;
+        const res = await request(app)
+            .post('/webhooks/my-auto')
+            .set('Content-Type', 'application/json')
+            .set('X-Amodal-Signature', sig)
+            .send(body);
+        expect(res.status).toBe(200);
+    });
+    it('should reject missing signature when secret is set', async () => {
+        const runner = makeMockRunner();
+        const app = createApp(runner, 'my-secret');
+        const res = await request(app)
+            .post('/webhooks/my-auto')
+            .send({ alert: 'test' });
+        expect(res.status).toBe(401);
+        expect(res.body.error).toContain('Missing');
+    });
+    it('should reject invalid signature', async () => {
+        const runner = makeMockRunner();
+        const app = createApp(runner, 'my-secret');
+        const res = await request(app)
+            .post('/webhooks/my-auto')
+            .set('X-Amodal-Signature', 'sha256=invalid')
+            .send({ alert: 'test' });
+        expect(res.status).toBe(401);
+        expect(res.body.error).toContain('Invalid');
+    });
+    it('should not require signature when no secret configured', async () => {
+        const runner = makeMockRunner();
+        const app = createApp(runner);
+        const res = await request(app)
+            .post('/webhooks/my-auto')
+            .send({});
+        expect(res.status).toBe(200);
+    });
+});
+//# sourceMappingURL=webhooks.test.js.map

package/dist/src/agent/routes/webhooks.test.js.map

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

package/dist/src/agent/session-manager.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AmodalRepo } from '@amodalai/core';
+import type { RuntimeTelemetryEvent, CustomToolExecutor, CustomShellExecutor, StoreBackend } from '@amodalai/core';
+import type { AgentSession } from './agent-types.js';
+export type TelemetrySink = (event: RuntimeTelemetryEvent) => void;
+export interface AgentSessionManagerOptions {
+    ttlMs?: number;
+    telemetrySink?: TelemetrySink;
+    toolExecutor?: CustomToolExecutor;
+    shellExecutor?: CustomShellExecutor;
+    storeBackend?: StoreBackend;
+}
+/**
+ * Manages repo-based sessions with TTL eviction.
+ */
+export declare class AgentSessionManager {
+    private repo;
+    private readonly sessions;
+    private readonly ttlMs;
+    private readonly telemetrySink?;
+    private readonly toolExecutor?;
+    private readonly shellExecutor?;
+    private readonly storeBackend?;
+    private platformTelemetry?;
+    private cleanupTimer;
+    constructor(repo: AmodalRepo, options?: AgentSessionManagerOptions);
+    get size(): number;
+    /**
+     * Create a new session, optionally fetching user context for role extraction.
+     */
+    create(tenantId: string, tenantToken?: string): Promise<AgentSession>;
+    /**
+     * Create a session from a specific repo (e.g., enriched with tenant credentials).
+     * Used by hosted runtime when tenant-specific config is fetched from the platform API.
+     */
+    createFromRepo(repo: AmodalRepo, tenantId: string): Promise<AgentSession>;
+    /**
+     * Re-register a session under a different ID (e.g., restoring original ID on hydration).
+     */
+    reregister(session: AgentSession, newId: string): void;
+    /**
+     * Get an existing session by ID.
+     */
+    get(sessionId: string): AgentSession | undefined;
+    /**
+     * Destroy a session.
+     */
+    destroy(sessionId: string): void;
+    /**
+     * Remove sessions that have been idle longer than TTL.
+     * Returns the number of sessions removed.
+     */
+    cleanup(): number;
+    /**
+     * Update the repo for all new sessions (hot reload).
+     * Existing sessions keep their old repo.
+     */
+    updateRepo(repo: AmodalRepo): void;
+    /**
+     * Shut down all sessions and stop the cleanup timer.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Initialize MCP servers for a session if the repo has MCP config.
+     */
+    private initMcp;
+    private getConnectionsMap;
+}

package/dist/src/agent/session-manager.js

@@ -0,0 +1,214 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { randomUUID } from 'node:crypto';
+import { setupSession, PlanModeManager, prepareExploreConfig, extractRoles, buildConnectionsMap, PlatformTelemetrySink, McpManager, } from '@amodalai/core';
+import { fetchUserContext } from './user-context-fetcher.js';
+const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 minutes
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+/**
+ * Manages repo-based sessions with TTL eviction.
+ */
+export class AgentSessionManager {
+    repo;
+    sessions = new Map();
+    ttlMs;
+    telemetrySink;
+    toolExecutor;
+    shellExecutor;
+    storeBackend;
+    platformTelemetry;
+    cleanupTimer = null;
+    constructor(repo, options) {
+        this.repo = repo;
+        this.ttlMs = options?.ttlMs ?? DEFAULT_TTL_MS;
+        // If platform config is set and no explicit sink provided, create a platform sink
+        if (!options?.telemetrySink && repo.config.platform?.apiKey) {
+            const platformUrl = process.env['PLATFORM_API_URL'] ?? 'http://localhost:4000';
+            this.platformTelemetry = new PlatformTelemetrySink(platformUrl, repo.config.platform.apiKey);
+            this.telemetrySink = this.platformTelemetry.sink();
+        }
+        else {
+            this.telemetrySink = options?.telemetrySink;
+        }
+        this.toolExecutor = options?.toolExecutor;
+        this.shellExecutor = options?.shellExecutor;
+        this.storeBackend = options?.storeBackend;
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, CLEANUP_INTERVAL_MS);
+        // Unref so the timer doesn't keep the process alive
+        if (this.cleanupTimer && typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {
+            this.cleanupTimer.unref();
+        }
+    }
+    get size() {
+        return this.sessions.size;
+    }
+    /**
+     * Create a new session, optionally fetching user context for role extraction.
+     */
+    async create(tenantId, tenantToken) {
+        let userRoles = [];
+        // Fetch user context if configured
+        if (this.repo.config.userContext && tenantToken) {
+            try {
+                const connectionsMap = this.getConnectionsMap();
+                const userData = await fetchUserContext(this.repo, tenantToken, connectionsMap);
+                userRoles = extractRoles(userData);
+            }
+            catch {
+                // Degraded but functional — empty roles
+            }
+        }
+        const runtime = setupSession({
+            repo: this.repo,
+            userId: tenantId,
+            userRoles,
+            isDelegated: false,
+            telemetrySink: this.telemetrySink,
+        });
+        const planModeManager = new PlanModeManager();
+        const exploreConfig = prepareExploreConfig(runtime);
+        const session = {
+            id: randomUUID(),
+            runtime,
+            tenantId,
+            conversationHistory: [],
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            planModeManager,
+            exploreConfig,
+            toolExecutor: this.toolExecutor,
+            shellExecutor: this.shellExecutor,
+            storeBackend: this.storeBackend,
+        };
+        // Start MCP servers if configured (non-blocking)
+        await this.initMcp(session, this.repo);
+        this.sessions.set(session.id, session);
+        return session;
+    }
+    /**
+     * Create a session from a specific repo (e.g., enriched with tenant credentials).
+     * Used by hosted runtime when tenant-specific config is fetched from the platform API.
+     */
+    async createFromRepo(repo, tenantId) {
+        const runtime = setupSession({
+            repo,
+            userId: tenantId,
+            userRoles: [],
+            isDelegated: false,
+            telemetrySink: this.telemetrySink,
+        });
+        const planModeManager = new PlanModeManager();
+        const exploreConfig = prepareExploreConfig(runtime);
+        const session = {
+            id: randomUUID(),
+            runtime,
+            tenantId,
+            conversationHistory: [],
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            planModeManager,
+            exploreConfig,
+            toolExecutor: this.toolExecutor,
+            shellExecutor: this.shellExecutor,
+            storeBackend: this.storeBackend,
+        };
+        // Start MCP servers if configured (non-blocking)
+        await this.initMcp(session, repo);
+        this.sessions.set(session.id, session);
+        return session;
+    }
+    /**
+     * Re-register a session under a different ID (e.g., restoring original ID on hydration).
+     */
+    reregister(session, newId) {
+        this.sessions.delete(session.id);
+        session.id = newId;
+        this.sessions.set(newId, session);
+    }
+    /**
+     * Get an existing session by ID.
+     */
+    get(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastAccessedAt = Date.now();
+        }
+        return session;
+    }
+    /**
+     * Destroy a session.
+     */
+    destroy(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    /**
+     * Remove sessions that have been idle longer than TTL.
+     * Returns the number of sessions removed.
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [id, session] of this.sessions) {
+            if (now - session.lastAccessedAt > this.ttlMs) {
+                this.sessions.delete(id);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /**
+     * Update the repo for all new sessions (hot reload).
+     * Existing sessions keep their old repo.
+     */
+    updateRepo(repo) {
+        this.repo = repo;
+    }
+    /**
+     * Shut down all sessions and stop the cleanup timer.
+     */
+    async shutdown() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        if (this.platformTelemetry) {
+            await this.platformTelemetry.destroy();
+            this.platformTelemetry = undefined;
+        }
+        // Shutdown MCP managers for all sessions
+        for (const session of this.sessions.values()) {
+            if (session.mcpManager) {
+                await session.mcpManager.shutdown().catch(() => { });
+            }
+        }
+        this.sessions.clear();
+    }
+    /**
+     * Initialize MCP servers for a session if the repo has MCP config.
+     */
+    async initMcp(session, repo) {
+        if (!repo.mcpServers || Object.keys(repo.mcpServers).length === 0) {
+            return;
+        }
+        const manager = new McpManager();
+        try {
+            await manager.startServers(repo.mcpServers);
+            if (manager.connectedCount > 0) {
+                session.mcpManager = manager;
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[SESSION] MCP initialization failed: ${msg}\n`);
+        }
+    }
+    getConnectionsMap() {
+        return buildConnectionsMap(this.repo.connections);
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/src/agent/session-manager.js.map

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

package/dist/src/agent/session-manager.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/agent/session-manager.test.js

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { AgentSessionManager } from './session-manager.js';
+// Mock setupSession and friends
+vi.mock('@amodalai/core', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        setupSession: vi.fn(() => ({
+            repo: makeRepo(),
+            scrubTracker: {},
+            fieldScrubber: { scrub: vi.fn() },
+            outputGuard: { guard: vi.fn(() => ({ output: '', modified: false, blocked: false, findings: [] })) },
+            actionGate: { evaluate: vi.fn(() => ({ decision: 'allow', escalated: false, endpointPath: '' })) },
+            contextCompiler: {},
+            compiledContext: { systemPrompt: 'test', tokenUsage: { total: 100000, used: 500, remaining: 99500, sectionBreakdown: {} }, sections: [] },
+            exploreContext: { systemPrompt: 'explore', tokenUsage: { total: 100000, used: 300, remaining: 99700, sectionBreakdown: {} }, sections: [] },
+            outputPipeline: { process: vi.fn((t) => ({ output: t, modified: false, blocked: false, findings: [] })), createStreamProcessor: vi.fn() },
+            telemetry: { logScrub: vi.fn(), logGuard: vi.fn(), logGate: vi.fn(), logExplore: vi.fn() },
+            connectionsMap: {},
+            userRoles: [],
+            sessionId: 'test-session',
+            isDelegated: false,
+        })),
+        prepareExploreConfig: vi.fn(() => ({
+            systemPrompt: 'explore',
+            model: { provider: 'anthropic', model: 'test' },
+            connectionsMap: {},
+            readOnly: true,
+            maxTurns: 10,
+            maxDepth: 2,
+        })),
+        PlanModeManager: vi.fn(() => ({
+            isActive: vi.fn(() => false),
+            getApprovedPlan: vi.fn(() => null),
+            getReason: vi.fn(() => null),
+            enter: vi.fn(),
+            approve: vi.fn(),
+            exit: vi.fn(),
+            getPlanningReminder: vi.fn(() => null),
+            getApprovedPlanContext: vi.fn(() => null),
+        })),
+        extractRoles: vi.fn(() => []),
+        buildConnectionsMap: vi.fn(() => ({})),
+    };
+});
+function makeRepo() {
+    return {
+        source: 'local',
+        origin: '/test',
+        config: {
+            name: 'test',
+            version: '1.0.0',
+            models: {
+                main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' },
+            },
+        },
+        connections: new Map(),
+        skills: [],
+        agents: { subagents: [] },
+        automations: [],
+        knowledge: [],
+        evals: [],
+        tools: [],
+        stores: [],
+    };
+}
+describe('AgentSessionManager', () => {
+    let manager;
+    beforeEach(() => {
+        vi.useFakeTimers();
+        manager = new AgentSessionManager(makeRepo(), { ttlMs: 1000 });
+    });
+    afterEach(async () => {
+        await manager.shutdown();
+        vi.useRealTimers();
+    });
+    it('should create a session', async () => {
+        const session = await manager.create('tenant-1');
+        expect(session.id).toBeTruthy();
+        expect(session.tenantId).toBe('tenant-1');
+        expect(session.conversationHistory).toEqual([]);
+        expect(manager.size).toBe(1);
+    });
+    it('should get an existing session', async () => {
+        const session = await manager.create('tenant-1');
+        const found = manager.get(session.id);
+        expect(found).toBeDefined();
+        expect(found?.id).toBe(session.id);
+    });
+    it('should return undefined for unknown session', () => {
+        expect(manager.get('nonexistent')).toBeUndefined();
+    });
+    it('should destroy a session', async () => {
+        const session = await manager.create('tenant-1');
+        manager.destroy(session.id);
+        expect(manager.get(session.id)).toBeUndefined();
+        expect(manager.size).toBe(0);
+    });
+    it('should clean up expired sessions', async () => {
+        await manager.create('tenant-1');
+        expect(manager.size).toBe(1);
+        vi.advanceTimersByTime(1500);
+        const removed = manager.cleanup();
+        expect(removed).toBe(1);
+        expect(manager.size).toBe(0);
+    });
+    it('should not clean up active sessions', async () => {
+        const session = await manager.create('tenant-1');
+        vi.advanceTimersByTime(500);
+        // Access the session to update lastAccessedAt
+        manager.get(session.id);
+        vi.advanceTimersByTime(600);
+        const removed = manager.cleanup();
+        expect(removed).toBe(0);
+        expect(manager.size).toBe(1);
+    });
+    it('should update repo for new sessions', async () => {
+        const newRepo = makeRepo();
+        newRepo.config.name = 'updated';
+        manager.updateRepo(newRepo);
+        // The next created session should use the new repo
+        const session = await manager.create('tenant-1');
+        expect(session).toBeDefined();
+    });
+    it('should shutdown cleanly', async () => {
+        await manager.create('tenant-1');
+        await manager.create('tenant-2');
+        expect(manager.size).toBe(2);
+        await manager.shutdown();
+        expect(manager.size).toBe(0);
+    });
+    it('should update lastAccessedAt on get', async () => {
+        const session = await manager.create('tenant-1');
+        const initialAccess = session.lastAccessedAt;
+        vi.advanceTimersByTime(100);
+        manager.get(session.id);
+        expect(session.lastAccessedAt).toBeGreaterThan(initialAccess);
+    });
+});
+//# sourceMappingURL=session-manager.test.js.map

package/dist/src/agent/session-manager.test.js.map

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

package/dist/src/agent/shell-executor-local.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { CustomShellExecutor } from '@amodalai/core';
+/**
+ * Executes shell commands locally via child_process.
+ */
+export declare class LocalShellExecutor implements CustomShellExecutor {
+    exec(command: string, timeout: number, signal: AbortSignal): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+}