@agent-vm/agent-vm-worker 0.0.20

package/dist/work-executor/local-tool-mcp-server.js

@@ -0,0 +1,187 @@
+import net from 'node:net';
+import { serve } from '@hono/node-server';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { Hono } from 'hono';
+const localToolServerCache = new Map();
+let registeredCleanup = false;
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isCallToolContentItem(value) {
+    if (!isPlainObject(value) || typeof value.type !== 'string') {
+        return false;
+    }
+    switch (value.type) {
+        case 'text':
+            return typeof value.text === 'string';
+        case 'image':
+            return typeof value.data === 'string' && typeof value.mimeType === 'string';
+        case 'audio':
+            return typeof value.data === 'string' && typeof value.mimeType === 'string';
+        case 'resource':
+            return isPlainObject(value.resource);
+        case 'resource_link':
+            return typeof value.uri === 'string' && typeof value.name === 'string';
+        default:
+            return false;
+    }
+}
+function isCallToolResult(value) {
+    if (!isPlainObject(value) || !Array.isArray(value.content)) {
+        return false;
+    }
+    if (!value.content.every((item) => isCallToolContentItem(item))) {
+        return false;
+    }
+    if ('isError' in value && value.isError !== undefined && typeof value.isError !== 'boolean') {
+        return false;
+    }
+    if ('structuredContent' in value &&
+        value.structuredContent !== undefined &&
+        !isPlainObject(value.structuredContent)) {
+        return false;
+    }
+    return true;
+}
+function toolSignature(tools) {
+    return JSON.stringify(tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+    })));
+}
+async function findOpenPort() {
+    return await new Promise((resolve, reject) => {
+        const server = net.createServer();
+        server.once('error', reject);
+        server.listen(0, '127.0.0.1', () => {
+            const address = server.address();
+            if (!address || typeof address === 'string') {
+                server.close(() => reject(new Error('Could not determine an open port.')));
+                return;
+            }
+            server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve(address.port);
+            });
+        });
+    });
+}
+function createToolDescriptor(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: {
+            type: 'object',
+            ...tool.inputSchema,
+        },
+    };
+}
+function normalizeToolResult(result) {
+    if (isCallToolResult(result)) {
+        return result;
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: typeof result === 'string' ? result : (JSON.stringify(result, null, 2) ?? 'null'),
+            },
+        ],
+        ...(isPlainObject(result) ? { structuredContent: result } : {}),
+    };
+}
+function buildMcpApp(tools) {
+    const toolMap = new Map();
+    for (const tool of tools) {
+        toolMap.set(tool.name, tool);
+    }
+    const app = new Hono();
+    app.all('/mcp', async (context) => {
+        const transport = new WebStandardStreamableHTTPServerTransport();
+        const server = new Server({ name: 'agent-vm-local-tools', version: '1.0.0' }, { capabilities: { tools: { listChanged: false } } });
+        server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: tools.map((tool) => createToolDescriptor(tool)),
+        }));
+        server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const tool = toolMap.get(request.params.name);
+            if (!tool) {
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${request.params.name}` }],
+                    isError: true,
+                };
+            }
+            try {
+                const result = await tool.execute(request.params.arguments ?? {});
+                return normalizeToolResult(result);
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: error instanceof Error ? error.message : String(error),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+        await server.connect(transport);
+        return await transport.handleRequest(context.req.raw);
+    });
+    return app;
+}
+export async function getOrCreateLocalToolMcpServer(tools) {
+    if (tools.length === 0) {
+        return null;
+    }
+    const signature = toolSignature(tools);
+    const existing = localToolServerCache.get(signature);
+    if (existing) {
+        return existing;
+    }
+    const port = await findOpenPort();
+    const app = buildMcpApp(tools);
+    const serverHandle = serve({ fetch: app.fetch, port });
+    if (!registeredCleanup) {
+        const closeAllServers = () => {
+            for (const server of localToolServerCache.values()) {
+                void server.close();
+            }
+            localToolServerCache.clear();
+        };
+        process.once('exit', closeAllServers);
+        process.once('SIGINT', () => {
+            closeAllServers();
+            process.exit(130);
+        });
+        process.once('SIGTERM', () => {
+            closeAllServers();
+            process.exit(143);
+        });
+        registeredCleanup = true;
+    }
+    const server = {
+        url: `http://127.0.0.1:${port}/mcp`,
+        close: async () => {
+            await new Promise((resolve, reject) => {
+                serverHandle.close((error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+        },
+    };
+    localToolServerCache.set(signature, server);
+    return server;
+}
+//# sourceMappingURL=local-tool-mcp-server.js.map

package/dist/work-executor/local-tool-mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-tool-mcp-server.js","sourceRoot":"","sources":["../../src/work-executor/local-tool-mcp-server.ts"],"names":[],"mappings":"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"}

package/dist/work-executor/persistent-thread.d.ts

@@ -0,0 +1,16 @@
+import type { WorkExecutor } from './executor-interface.js';
+export interface PersistentThreadResponse {
+    readonly response: string;
+    readonly tokenCount: number;
+    readonly threadId: string;
+}
+export interface PersistentThread {
+    readonly send: (input: string) => Promise<PersistentThreadResponse>;
+    readonly threadId: () => string | null;
+}
+export interface CreatePersistentThreadProps {
+    readonly executor: WorkExecutor;
+    readonly turnTimeoutMs: number;
+}
+export declare function createPersistentThread(props: CreatePersistentThreadProps): PersistentThread;
+//# sourceMappingURL=persistent-thread.d.ts.map

package/dist/work-executor/persistent-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-thread.d.ts","sourceRoot":"","sources":["../../src/work-executor/persistent-thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AA6BD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,gBAAgB,CAuB3F"}

package/dist/work-executor/persistent-thread.js

@@ -0,0 +1,37 @@
+function toStructuredInput(input) {
+    return [{ type: 'text', text: input }];
+}
+function withTimeout(promise, timeoutMs, label) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            reject(new Error(`${label} timed out after ${String(timeoutMs)}ms`));
+        }, timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timeout);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timeout);
+            reject(error);
+        });
+    });
+}
+export function createPersistentThread(props) {
+    let started = false;
+    return {
+        async send(input) {
+            const result = await withTimeout(started
+                ? props.executor.fix(toStructuredInput(input))
+                : props.executor.execute(toStructuredInput(input)), props.turnTimeoutMs, 'persistent-thread.send');
+            started = true;
+            return {
+                response: result.response,
+                tokenCount: result.tokenCount,
+                threadId: result.threadId,
+            };
+        },
+        threadId() {
+            return props.executor.getThreadId();
+        },
+    };
+}
+//# sourceMappingURL=persistent-thread.js.map

package/dist/work-executor/persistent-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistent-thread.js","sourceRoot":"","sources":["../../src/work-executor/persistent-thread.ts"],"names":[],"mappings":"AAkBA,SAAS,iBAAiB,CAAC,KAAa;IACvC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CACnB,OAAwB,EACxB,SAAiB,EACjB,KAAa;IAEb,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO,CAAC,IAAI,CACX,CAAC,KAAK,EAAE,EAAE;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YAClB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC,CACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAkC;IACxE,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO;QACN,KAAK,CAAC,IAAI,CAAC,KAAa;YACvB,MAAM,MAAM,GAAG,MAAM,WAAW,CAC/B,OAAO;gBACN,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBAC9C,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EACnD,KAAK,CAAC,aAAa,EACnB,wBAAwB,CACxB,CAAC;YACF,OAAO,GAAG,IAAI,CAAC;YACf,OAAO;gBACN,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;aACzB,CAAC;QACH,CAAC;QACD,QAAQ;YACP,OAAO,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/work-phase/controller-tools/controller-tool-support.d.ts

@@ -0,0 +1,19 @@
+import type { RepoLocation } from '../../shared/repo-location.js';
+export interface ControllerToolRepoSelection {
+    readonly repo: RepoLocation | null;
+    readonly error: string | null;
+}
+export interface ControllerToolFailure {
+    readonly type: 'controller-error';
+    readonly success: false;
+    readonly artifact: string;
+}
+export declare function isControllerToolFailure(value: unknown): value is ControllerToolFailure;
+export declare function selectRepo(repos: readonly RepoLocation[], params: Record<string, unknown>): ControllerToolRepoSelection;
+export declare function currentBranch(cwd: string): Promise<string | null>;
+export declare function postControllerJson(options: {
+    readonly url: string;
+    readonly body: Record<string, unknown>;
+    readonly timeoutMs: number;
+}): Promise<unknown>;
+//# sourceMappingURL=controller-tool-support.d.ts.map

package/dist/work-phase/controller-tools/controller-tool-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-tool-support.d.ts","sourceRoot":"","sources":["../../../src/work-phase/controller-tools/controller-tool-support.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAWtF;AAED,wBAAgB,UAAU,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,2BAA2B,CAmC7B;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASvE;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCnB"}

package/dist/work-phase/controller-tools/controller-tool-support.js

@@ -0,0 +1,92 @@
+import { execa } from 'execa';
+export function isControllerToolFailure(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'type' in value &&
+        value.type === 'controller-error' &&
+        'success' in value &&
+        value.success === false &&
+        'artifact' in value &&
+        typeof value.artifact === 'string');
+}
+export function selectRepo(repos, params) {
+    const requestedWorkspacePath = typeof params.repoWorkspacePath === 'string' ? params.repoWorkspacePath : null;
+    const requestedRepoUrl = typeof params.repoUrl === 'string' ? params.repoUrl : null;
+    const configured = repos.map((repo) => `${repo.workspacePath} (${repo.repoUrl})`).join(', ');
+    if (repos.length === 0) {
+        return { repo: null, error: 'No repo configured.' };
+    }
+    if (requestedWorkspacePath) {
+        const repo = repos.find((candidate) => candidate.workspacePath === requestedWorkspacePath) ?? null;
+        return repo
+            ? { repo, error: null }
+            : {
+                repo: null,
+                error: `repoWorkspacePath '${requestedWorkspacePath}' not found; configured repos: ${configured}`,
+            };
+    }
+    if (requestedRepoUrl) {
+        const repo = repos.find((candidate) => candidate.repoUrl === requestedRepoUrl) ?? null;
+        return repo
+            ? { repo, error: null }
+            : {
+                repo: null,
+                error: `repoUrl '${requestedRepoUrl}' not found; configured repos: ${configured}`,
+            };
+    }
+    if (repos.length > 1) {
+        return {
+            repo: null,
+            error: 'Multiple repos configured; provide repoWorkspacePath or repoUrl.',
+        };
+    }
+    return { repo: repos[0] ?? null, error: null };
+}
+export async function currentBranch(cwd) {
+    const result = await execa('git', ['branch', '--show-current'], {
+        cwd,
+        reject: false,
+        timeout: 10_000,
+    });
+    if ((result.exitCode ?? 0) !== 0)
+        return null;
+    const branch = result.stdout.trim();
+    return branch.length > 0 ? branch : null;
+}
+export async function postControllerJson(options) {
+    let response;
+    try {
+        response = await fetch(options.url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            signal: AbortSignal.timeout(options.timeoutMs),
+            body: JSON.stringify(options.body),
+        });
+    }
+    catch (error) {
+        return {
+            type: 'controller-error',
+            success: false,
+            artifact: `Controller request failed: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+    const text = await response.text();
+    if (!response.ok) {
+        return {
+            type: 'controller-error',
+            success: false,
+            artifact: `Controller request failed with HTTP ${String(response.status)}: ${text}`,
+        };
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        return {
+            type: 'controller-error',
+            success: false,
+            artifact: `Controller response was not JSON: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=controller-tool-support.js.map

package/dist/work-phase/controller-tools/controller-tool-support.js.map

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

package/dist/work-phase/controller-tools/git-pull-default-tool.d.ts

@@ -0,0 +1,10 @@
+import type { RepoLocation } from '../../shared/repo-location.js';
+import type { ToolDefinition } from '../../work-executor/executor-interface.js';
+export interface CreateGitPullDefaultToolProps {
+    readonly controllerBaseUrl: string;
+    readonly zoneId: string;
+    readonly taskId: string;
+    readonly repos: readonly RepoLocation[];
+}
+export declare function createGitPullDefaultTool(props: CreateGitPullDefaultToolProps): ToolDefinition;
+//# sourceMappingURL=git-pull-default-tool.d.ts.map

package/dist/work-phase/controller-tools/git-pull-default-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-pull-default-tool.d.ts","sourceRoot":"","sources":["../../../src/work-phase/controller-tools/git-pull-default-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAShF,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,6BAA6B,GAAG,cAAc,CAkC7F"}

package/dist/work-phase/controller-tools/git-pull-default-tool.js

@@ -0,0 +1,36 @@
+import { isControllerToolFailure, postControllerJson, selectRepo, } from './controller-tool-support.js';
+const CONTROLLER_TOOL_TIMEOUT_MS = 120_000;
+export function createGitPullDefaultTool(props) {
+    return {
+        name: 'git-pull-default',
+        description: 'Ask the controller to fetch origin/default and fast-forward the local default branch ref. Does not modify your current branch. Returns commits added to default and divergence vs your current branch.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repoWorkspacePath: { type: 'string' },
+                repoUrl: { type: 'string' },
+            },
+            additionalProperties: false,
+        },
+        async execute(params) {
+            const selected = selectRepo(props.repos, params);
+            if (!selected.repo) {
+                return {
+                    type: 'pull-default',
+                    success: false,
+                    artifact: selected.error ?? 'Repo not found.',
+                };
+            }
+            const result = await postControllerJson({
+                url: `${props.controllerBaseUrl}/zones/${props.zoneId}/tasks/${props.taskId}/pull-default`,
+                timeoutMs: CONTROLLER_TOOL_TIMEOUT_MS,
+                body: { repoUrl: selected.repo.repoUrl },
+            });
+            if (isControllerToolFailure(result)) {
+                return { type: 'pull-default', success: false, artifact: result.artifact };
+            }
+            return { type: 'pull-default', success: true, artifact: result };
+        },
+    };
+}
+//# sourceMappingURL=git-pull-default-tool.js.map

package/dist/work-phase/controller-tools/git-pull-default-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-pull-default-tool.js","sourceRoot":"","sources":["../../../src/work-phase/controller-tools/git-pull-default-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,uBAAuB,EACvB,kBAAkB,EAClB,UAAU,GACV,MAAM,8BAA8B,CAAC;AAEtC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAS3C,MAAM,UAAU,wBAAwB,CAAC,KAAoC;IAC5E,OAAO;QACN,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACV,wMAAwM;QACzM,WAAW,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,oBAAoB,EAAE,KAAK;SAC3B;QACD,KAAK,CAAC,OAAO,CAAC,MAAM;YACnB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpB,OAAO;oBACN,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,QAAQ,CAAC,KAAK,IAAI,iBAAiB;iBAC7C,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;gBACvC,GAAG,EAAE,GAAG,KAAK,CAAC,iBAAiB,UAAU,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,eAAe;gBAC1F,SAAS,EAAE,0BAA0B;gBACrC,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE;aACxC,CAAC,CAAC;YACH,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC5E,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAClE,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/work-phase/controller-tools/git-push-tool.d.ts

@@ -0,0 +1,10 @@
+import type { RepoLocation } from '../../shared/repo-location.js';
+import type { ToolDefinition } from '../../work-executor/executor-interface.js';
+export interface CreateGitPushToolProps {
+    readonly controllerBaseUrl: string;
+    readonly zoneId: string;
+    readonly taskId: string;
+    readonly repos: readonly RepoLocation[];
+}
+export declare function createGitPushTool(props: CreateGitPushToolProps): ToolDefinition;
+//# sourceMappingURL=git-push-tool.d.ts.map

package/dist/work-phase/controller-tools/git-push-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-push-tool.d.ts","sourceRoot":"","sources":["../../../src/work-phase/controller-tools/git-push-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAUhF,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,cAAc,CA2C/E"}

package/dist/work-phase/controller-tools/git-push-tool.js

@@ -0,0 +1,45 @@
+import { currentBranch, isControllerToolFailure, postControllerJson, selectRepo, } from './controller-tool-support.js';
+const CONTROLLER_TOOL_TIMEOUT_MS = 120_000;
+export function createGitPushTool(props) {
+    return {
+        name: 'git-push',
+        description: 'Push the current agent branch to origin via the controller. The VM has no GitHub token; only the controller can push. Refuses the repo default branch. Returns pushed commits and branch divergence.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                repoWorkspacePath: { type: 'string' },
+                repoUrl: { type: 'string' },
+            },
+            additionalProperties: false,
+        },
+        async execute(params) {
+            const selected = selectRepo(props.repos, params);
+            if (!selected.repo) {
+                return { type: 'push', success: false, artifact: selected.error ?? 'Repo not found.' };
+            }
+            const branchName = await currentBranch(selected.repo.workspacePath);
+            if (!branchName) {
+                return { type: 'push', success: false, artifact: 'Refusing to push from detached HEAD.' };
+            }
+            if (branchName === selected.repo.baseBranch) {
+                return {
+                    type: 'push',
+                    success: false,
+                    artifact: `Refusing to push: you are on the default branch "${selected.repo.baseBranch}". Create an agent/* branch first and move your commits to it.`,
+                };
+            }
+            const result = await postControllerJson({
+                url: `${props.controllerBaseUrl}/zones/${props.zoneId}/tasks/${props.taskId}/push-branches`,
+                timeoutMs: CONTROLLER_TOOL_TIMEOUT_MS,
+                body: {
+                    branches: [{ repoUrl: selected.repo.repoUrl, branchName }],
+                },
+            });
+            if (isControllerToolFailure(result)) {
+                return { type: 'push', success: false, artifact: result.artifact };
+            }
+            return { type: 'push', success: true, artifact: result };
+        },
+    };
+}
+//# sourceMappingURL=git-push-tool.js.map

package/dist/work-phase/controller-tools/git-push-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-push-tool.js","sourceRoot":"","sources":["../../../src/work-phase/controller-tools/git-push-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,aAAa,EACb,uBAAuB,EACvB,kBAAkB,EAClB,UAAU,GACV,MAAM,8BAA8B,CAAC;AAEtC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAS3C,MAAM,UAAU,iBAAiB,CAAC,KAA6B;IAC9D,OAAO;QACN,IAAI,EAAE,UAAU;QAChB,WAAW,EACV,sMAAsM;QACvM,WAAW,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACrC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,oBAAoB,EAAE,KAAK;SAC3B;QACD,KAAK,CAAC,OAAO,CAAC,MAAM;YACnB,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACpB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,IAAI,iBAAiB,EAAE,CAAC;YACxF,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACpE,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,sCAAsC,EAAE,CAAC;YAC3F,CAAC;YACD,IAAI,UAAU,KAAK,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC7C,OAAO;oBACN,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,KAAK;oBACd,QAAQ,EAAE,oDAAoD,QAAQ,CAAC,IAAI,CAAC,UAAU,gEAAgE;iBACtJ,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;gBACvC,GAAG,EAAE,GAAG,KAAK,CAAC,iBAAiB,UAAU,KAAK,CAAC,MAAM,UAAU,KAAK,CAAC,MAAM,gBAAgB;gBAC3F,SAAS,EAAE,0BAA0B;gBACrC,IAAI,EAAE;oBACL,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;iBAC1D;aACD,CAAC,CAAC;YACH,IAAI,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpE,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC1D,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/work-phase/validation-tool.d.ts

@@ -0,0 +1,11 @@
+import type { VerificationCommand } from '../validation-runner/verification-runner.js';
+import type { ToolDefinition } from '../work-executor/executor-interface.js';
+export interface BuildValidationToolProps {
+    readonly commands: readonly VerificationCommand[];
+    readonly cwd: string;
+    readonly timeoutMs: number;
+    readonly rawLogDir: string;
+    readonly attemptLabelPrefix: string;
+}
+export declare function buildValidationTool(props: BuildValidationToolProps): ToolDefinition;
+//# sourceMappingURL=validation-tool.d.ts.map

package/dist/work-phase/validation-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-tool.d.ts","sourceRoot":"","sources":["../../src/work-phase/validation-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAEvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAE7E,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACpC;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,cAAc,CAsBnF"}

package/dist/work-phase/validation-tool.js

@@ -0,0 +1,25 @@
+import { runVerification } from '../validation-runner/verification-runner.js';
+const DESCRIPTION = 'Runs the project-configured validation commands in sequence and returns their results. Each command writes a full raw stdout/stderr log.';
+export function buildValidationTool(props) {
+    let callCount = 0;
+    return {
+        name: 'run_validation',
+        description: DESCRIPTION,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            additionalProperties: false,
+        },
+        async execute(_params) {
+            callCount += 1;
+            return await runVerification({
+                commands: props.commands,
+                cwd: props.cwd,
+                timeoutMs: props.timeoutMs,
+                rawLogDir: props.rawLogDir,
+                attemptLabel: `${props.attemptLabelPrefix}-call-${String(callCount)}`,
+            });
+        },
+    };
+}
+//# sourceMappingURL=validation-tool.js.map

package/dist/work-phase/validation-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-tool.js","sourceRoot":"","sources":["../../src/work-phase/validation-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,6CAA6C,CAAC;AAW9E,MAAM,WAAW,GAChB,0IAA0I,CAAC;AAE5I,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IAClE,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,OAAO;QACN,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,WAAW;QACxB,WAAW,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,oBAAoB,EAAE,KAAK;SAC3B;QACD,KAAK,CAAC,OAAO,CAAC,OAAgC;YAC7C,SAAS,IAAI,CAAC,CAAC;YACf,OAAO,MAAM,eAAe,CAAC;gBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,YAAY,EAAE,GAAG,KAAK,CAAC,kBAAkB,SAAS,MAAM,CAAC,SAAS,CAAC,EAAE;aACrE,CAAC,CAAC;QACJ,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/work-phase/work-cycle.d.ts

@@ -0,0 +1,28 @@
+import type { WorkCycleConfig } from '../config/worker-config.js';
+import { type ReviewResult } from '../shared/review-result.js';
+import { type VerificationCommandResult } from '../state/task-event-types.js';
+import type { VerificationCommand } from '../validation-runner/verification-runner.js';
+import type { PersistentThread, PersistentThreadResponse } from '../work-executor/persistent-thread.js';
+export interface RunWorkCycleProps {
+    readonly spec: string;
+    readonly plan: string;
+    readonly planReview: ReviewResult | null;
+    readonly validationCommandList: readonly VerificationCommand[];
+    readonly cycle: WorkCycleConfig;
+    readonly workThread: PersistentThread;
+    readonly reviewThread: PersistentThread;
+    readonly systemPromptWorkAgent: string;
+    readonly systemPromptWorkReviewer: string;
+    readonly getDiff: () => Promise<string>;
+    readonly onWorkAgentTurn: (cycle: number, result: PersistentThreadResponse) => void | Promise<void>;
+    readonly onWorkReviewerTurn: (cycle: number, result: PersistentThreadResponse, review: ReviewResult, validationResults: readonly VerificationCommandResult[], validationSkipped: boolean) => void | Promise<void>;
+    /** Abort signal from the coordinator; when set, cycle stops after the current turn. */
+    readonly isClosed?: () => boolean;
+}
+export interface WorkCycleResult {
+    readonly review: ReviewResult;
+    readonly validationResults: readonly VerificationCommandResult[];
+    readonly validationSkipped: boolean;
+}
+export declare function runWorkCycle(props: RunWorkCycleProps): Promise<WorkCycleResult>;
+//# sourceMappingURL=work-cycle.d.ts.map

package/dist/work-phase/work-cycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-cycle.d.ts","sourceRoot":"","sources":["../../src/work-phase/work-cycle.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAMlE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEnF,OAAO,EAEN,KAAK,yBAAyB,EAC9B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,KAAK,EACX,gBAAgB,EAChB,wBAAwB,EACxB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,qBAAqB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/D,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,wBAAwB,KAC5B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,CAC5B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,wBAAwB,EAChC,MAAM,EAAE,YAAY,EACpB,iBAAiB,EAAE,SAAS,yBAAyB,EAAE,EACvD,iBAAiB,EAAE,OAAO,KACtB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACjE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACpC;AAuED,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiGrF"}