agentrix 0.0.1

package/dist/core/agents.js

@@ -0,0 +1,91 @@
+import { createIsolatedTerminalSession, queueSessionInput } from './terminal-sessions.js';
+import { runTmux } from './tmux.js';
+import { savePlanToWorktree } from './plan-storage.js';
+function normaliseTerminalInput(value) {
+    if (!value) {
+        return '';
+    }
+    const normalised = String(value).replace(/\r\n/g, '\n').replace(/\r/g, '\n').replace(/\n/g, '\r');
+    return /\r$/.test(normalised) ? normalised : `${normalised}\r`;
+}
+function shellQuote(value) {
+    if (value === undefined || value === null) {
+        return "''";
+    }
+    const text = String(value);
+    if (text === '') {
+        return "''";
+    }
+    return `'${text.replace(/'/g, `'\\''`)}'`;
+}
+async function preparePromptEnvironment(session, prompt) {
+    const value = typeof prompt === 'string' ? prompt : '';
+    if (session?.usingTmux && session.tmuxSessionName) {
+        const target = `=${session.tmuxSessionName}`;
+        try {
+            if (value) {
+                await runTmux(['set-environment', '-t', target, 'AGENTRIX_PROMPT', value]);
+            }
+            else {
+                await runTmux(['set-environment', '-u', '-t', target, 'AGENTRIX_PROMPT']);
+            }
+            return null;
+        }
+        catch (error) {
+            const err = error;
+            console.warn('[agentrix] Failed to set tmux environment variable:', err?.message || error);
+        }
+    }
+    if (!value) {
+        return 'unset AGENTRIX_PROMPT';
+    }
+    return `export AGENTRIX_PROMPT=${shellQuote(value)}`;
+}
+/**
+ * Launches an automation agent command inside the managed terminal session for a worktree.
+ * Commands run inside the same tmux-backed terminal infrastructure used by the UI so that
+ * automation launches remain observable and attachable from the frontend.
+ */
+export async function launchAgentProcess({ command, workdir, org, repo, branch, prompt, }) {
+    if (!command || typeof command !== 'string' || !command.trim()) {
+        throw new Error('Agent command is required');
+    }
+    if (!workdir || !org || !repo || !branch) {
+        throw new Error('workdir, org, repo, and branch are required to launch an agent');
+    }
+    const executable = command.trim();
+    const promptValue = typeof prompt === 'string' ? prompt : '';
+    const session = await createIsolatedTerminalSession(workdir, org, repo, branch);
+    if (session.worktreePath) {
+        try {
+            await savePlanToWorktree({
+                worktreePath: session.worktreePath,
+                branch,
+                planText: promptValue,
+            });
+        }
+        catch (error) {
+            const err = error;
+            console.warn('[agentrix] Failed to persist automation plan:', err?.message || error);
+        }
+    }
+    const envPreparation = await preparePromptEnvironment(session, promptValue);
+    if (envPreparation) {
+        const envInput = normaliseTerminalInput(envPreparation);
+        if (envInput) {
+            queueSessionInput(session, envInput);
+        }
+    }
+    const commandWithPrompt = promptValue.length > 0 ? `${executable} ${shellQuote(promptValue)}` : executable;
+    queueSessionInput(session, normaliseTerminalInput(commandWithPrompt));
+    const pid = session?.process?.pid ?? null;
+    return {
+        pid,
+        command: executable,
+        sessionId: session.id,
+        tmuxSessionName: session.tmuxSessionName ?? null,
+        usingTmux: Boolean(session.usingTmux),
+        createdSession: true,
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/core/agents.js.map

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

package/dist/core/auth.d.ts

@@ -0,0 +1,3 @@
+import type { AuthManager } from '../types/auth.js';
+export declare function createAuthManager(expectedPassword: string): AuthManager;
+//# sourceMappingURL=auth.d.ts.map

package/dist/core/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/core/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMpD,wBAAgB,iBAAiB,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CA+EvE"}

package/dist/core/auth.js

@@ -0,0 +1,69 @@
+import { SESSION_COOKIE_NAME, SESSION_MAX_AGE_SECONDS } from '../config/constants.js';
+import { clearCookie, parseCookies, setCookie } from '../infrastructure/cookies/index.js';
+import { generateSessionToken } from '../utils/random.js';
+export function createAuthManager(expectedPassword) {
+    const validSessionTokens = new Set();
+    function createError(message, statusCode) {
+        const error = new Error(message);
+        error.statusCode = statusCode;
+        return error;
+    }
+    function getTokenFromRequest(req) {
+        const cookies = parseCookies(req.headers?.cookie);
+        return cookies[SESSION_COOKIE_NAME] || '';
+    }
+    function isAuthenticated(req) {
+        const token = getTokenFromRequest(req);
+        return Boolean(token && validSessionTokens.has(token));
+    }
+    function login(req, res, providedPassword, options = {}) {
+        if (typeof providedPassword !== 'string' || !providedPassword.trim()) {
+            throw createError('Password is required', 400);
+        }
+        if (providedPassword.trim() !== expectedPassword) {
+            throw createError('Invalid password', 401);
+        }
+        const existing = getTokenFromRequest(req);
+        if (existing) {
+            validSessionTokens.delete(existing);
+        }
+        const token = generateSessionToken();
+        validSessionTokens.add(token);
+        const secureFlag = options.secure;
+        setCookie(res, SESSION_COOKIE_NAME, token, {
+            maxAge: SESSION_MAX_AGE_SECONDS,
+            sameSite: 'Strict',
+            httpOnly: true,
+            path: '/',
+            secure: secureFlag,
+        });
+        return token;
+    }
+    function logout(req, res, options = {}) {
+        const token = getTokenFromRequest(req);
+        if (token) {
+            validSessionTokens.delete(token);
+        }
+        clearCookie(res, SESSION_COOKIE_NAME, {
+            path: '/',
+            sameSite: 'Strict',
+            httpOnly: true,
+            secure: options?.secure,
+        });
+    }
+    function hasToken(token) {
+        return validSessionTokens.has(token);
+    }
+    function clear() {
+        validSessionTokens.clear();
+    }
+    return {
+        login,
+        logout,
+        isAuthenticated,
+        hasToken,
+        clear,
+        getTokenFromRequest,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/core/auth.js.map

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

package/dist/core/automation/branch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Branch resolution for automation requests, whether supplied by the client or generated.
+ */
+export interface ResolveBranchNameParams {
+    worktreeInput?: string;
+    branchNameGenerator: unknown;
+    prompt: string;
+    org: string;
+    repo: string;
+    defaultBranches: unknown;
+}
+export interface ResolveBranchNameResult {
+    branch: string;
+    defaultBranchOverride?: string;
+    source: 'worktree' | 'generator';
+}
+export declare function resolveBranchName({ worktreeInput, branchNameGenerator, prompt, org, repo, defaultBranches, }: ResolveBranchNameParams): Promise<ResolveBranchNameResult>;
+//# sourceMappingURL=branch.d.ts.map

package/dist/core/automation/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../../src/core/automation/branch.ts"],"names":[],"mappings":"AAMA;;GAEG;AAEH,MAAM,WAAW,uBAAuB;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,UAAU,GAAG,WAAW,CAAC;CAClC;AAED,wBAAsB,iBAAiB,CAAC,EACtC,aAAa,EACb,mBAAmB,EACnB,MAAM,EACN,GAAG,EACH,IAAI,EACJ,eAAe,GAChB,EAAE,uBAAuB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAoC5D"}

package/dist/core/automation/branch.js

@@ -0,0 +1,29 @@
+import { selectDefaultBranchOverride } from '../default-branch.js';
+import { AutomationRequestError, sanitiseWorktreeDescriptor, } from './request-validation.js';
+export async function resolveBranchName({ worktreeInput, branchNameGenerator, prompt, org, repo, defaultBranches, }) {
+    const defaultBranchOverride = selectDefaultBranchOverride(defaultBranches, org, repo);
+    if (worktreeInput) {
+        const branch = sanitiseWorktreeDescriptor(worktreeInput);
+        return { branch, defaultBranchOverride, source: 'worktree' };
+    }
+    const generator = branchNameGenerator;
+    if (!generator || !generator.isConfigured) {
+        throw new AutomationRequestError(503, 'Branch name generation is not configured. Provide a worktree name or configure a local LLM command (set branchNameLlm in config.json).');
+    }
+    try {
+        const branch = await generator.generateBranchName({
+            prompt,
+            org,
+            repo,
+        });
+        if (!branch) {
+            throw new AutomationRequestError(500, 'Failed to determine branch name.');
+        }
+        return { branch, defaultBranchOverride, source: 'generator' };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new AutomationRequestError(500, message, error instanceof Error ? error : undefined);
+    }
+}
+//# sourceMappingURL=branch.js.map

package/dist/core/automation/branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../../src/core/automation/branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AAqBjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EACtC,aAAa,EACb,mBAAmB,EACnB,MAAM,EACN,GAAG,EACH,IAAI,EACJ,eAAe,GACS;IACxB,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAEtF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,SAAS,GAAG,mBAA0G,CAAC;IAC7H,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAC1C,MAAM,IAAI,sBAAsB,CAC9B,GAAG,EACH,wIAAwI,CACzI,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,kBAAmB,CAAC;YACjD,MAAM;YACN,GAAG;YACH,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,sBAAsB,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAChE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,sBAAsB,CAC9B,GAAG,EACH,OAAO,EACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/automation/git-orchestration.d.ts

@@ -0,0 +1,51 @@
+export interface EnsureRepositoryReadyParams {
+    ensureRepositoryExists: (workdir: string, org: string, repo: string) => Promise<{
+        repositoryPath: string;
+        cloned: boolean;
+    }>;
+    workdir: string;
+    org: string;
+    repo: string;
+}
+export interface EnsureWorktreeReadyParams {
+    ensureWorktreeExists: (workdir: string, org: string, repo: string, branch: string, options?: unknown) => Promise<{
+        worktreePath: string;
+        created: boolean;
+    }>;
+    workdir: string;
+    org: string;
+    repo: string;
+    branch: string;
+    defaultBranchOverride?: string;
+}
+export interface RefreshRepositoryViewsParams {
+    refreshCache: (workdir: string) => Promise<unknown>;
+    workdir: string;
+}
+export interface GitOrchestrator {
+    ensureRepositoryReady(args: Omit<EnsureRepositoryReadyParams, 'ensureRepositoryExists'>): Promise<{
+        repositoryPath: string;
+        clonedRepository: boolean;
+    }>;
+    ensureWorktreeReady(args: Omit<EnsureWorktreeReadyParams, 'ensureWorktreeExists'>): Promise<{
+        worktreePath: string;
+        createdWorktree: boolean;
+    }>;
+    refreshRepositoryViews(args: Omit<RefreshRepositoryViewsParams, 'refreshCache'>): Promise<void>;
+}
+export declare function ensureRepositoryReady({ ensureRepositoryExists, workdir, org, repo, }: EnsureRepositoryReadyParams): Promise<{
+    repositoryPath: string;
+    clonedRepository: boolean;
+}>;
+export declare function ensureWorktreeReady({ ensureWorktreeExists, workdir, org, repo, branch, defaultBranchOverride, }: EnsureWorktreeReadyParams): Promise<{
+    worktreePath: string;
+    createdWorktree: boolean;
+}>;
+export declare function refreshRepositoryViews({ refreshCache, workdir, }: RefreshRepositoryViewsParams): Promise<void>;
+export interface GitOrchestratorConfig {
+    ensureRepositoryExists: EnsureRepositoryReadyParams['ensureRepositoryExists'];
+    ensureWorktreeExists: EnsureWorktreeReadyParams['ensureWorktreeExists'];
+    refreshCache?: RefreshRepositoryViewsParams['refreshCache'];
+}
+export declare function createGitOrchestrator({ ensureRepositoryExists, ensureWorktreeExists, refreshCache, }: GitOrchestratorConfig): GitOrchestrator;
+//# sourceMappingURL=git-orchestration.d.ts.map

package/dist/core/automation/git-orchestration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-orchestration.d.ts","sourceRoot":"","sources":["../../../src/core/automation/git-orchestration.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7H,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC7J,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,2BAA2B,EAAE,wBAAwB,CAAC,GAAG,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzJ,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,yBAAyB,EAAE,sBAAsB,CAAC,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChJ,sBAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,4BAA4B,EAAE,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjG;AAED,wBAAsB,qBAAqB,CAAC,EAC1C,sBAAsB,EACtB,OAAO,EACP,GAAG,EACH,IAAI,GACL,EAAE,2BAA2B,GAAG,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,OAAO,CAAA;CAAE,CAAC,CAG9F;AAED,wBAAsB,mBAAmB,CAAC,EACxC,oBAAoB,EACpB,OAAO,EACP,GAAG,EACH,IAAI,EACJ,MAAM,EACN,qBAAqB,GACtB,EAAE,yBAAyB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAAC,CAMzF;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,YAAY,EACZ,OAAO,GACR,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9C;AAED,MAAM,WAAW,qBAAqB;IACpC,sBAAsB,EAAE,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;IAC9E,oBAAoB,EAAE,yBAAyB,CAAC,sBAAsB,CAAC,CAAC;IACxE,YAAY,CAAC,EAAE,4BAA4B,CAAC,cAAc,CAAC,CAAC;CAC7D;AAED,wBAAgB,qBAAqB,CAAC,EACpC,sBAAsB,EACtB,oBAAoB,EACpB,YAAqC,GACtC,EAAE,qBAAqB,GAAG,eAAe,CASzC"}

package/dist/core/automation/git-orchestration.js

@@ -0,0 +1,25 @@
+/**
+ * Git/worktree orchestration helpers used by the automation task runner.
+ */
+import { refreshRepositoryCache } from '../../utils/repository-cache.js';
+export async function ensureRepositoryReady({ ensureRepositoryExists, workdir, org, repo, }) {
+    const { repositoryPath, cloned } = await ensureRepositoryExists(workdir, org, repo);
+    return { repositoryPath, clonedRepository: cloned };
+}
+export async function ensureWorktreeReady({ ensureWorktreeExists, workdir, org, repo, branch, defaultBranchOverride, }) {
+    const { worktreePath, created } = await ensureWorktreeExists(workdir, org, repo, branch, {
+        defaultBranchOverride,
+    });
+    return { worktreePath, createdWorktree: created };
+}
+export async function refreshRepositoryViews({ refreshCache, workdir, }) {
+    await refreshCache(workdir);
+}
+export function createGitOrchestrator({ ensureRepositoryExists, ensureWorktreeExists, refreshCache = refreshRepositoryCache, }) {
+    return {
+        ensureRepositoryReady: (args) => ensureRepositoryReady({ ensureRepositoryExists, ...args }),
+        ensureWorktreeReady: (args) => ensureWorktreeReady({ ensureWorktreeExists, ...args }),
+        refreshRepositoryViews: (args) => refreshRepositoryViews({ refreshCache, ...args }),
+    };
+}
+//# sourceMappingURL=git-orchestration.js.map

package/dist/core/automation/git-orchestration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-orchestration.js","sourceRoot":"","sources":["../../../src/core/automation/git-orchestration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AA6BzE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,sBAAsB,EACtB,OAAO,EACP,GAAG,EACH,IAAI,GACwB;IAC5B,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACpF,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,oBAAoB,EACpB,OAAO,EACP,GAAG,EACH,IAAI,EACJ,MAAM,EACN,qBAAqB,GACK;IAC1B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE;QACvF,qBAAqB;KACtB,CAAC,CAAC;IAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAC3C,YAAY,EACZ,OAAO,GACsB;IAC7B,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAQD,MAAM,UAAU,qBAAqB,CAAC,EACpC,sBAAsB,EACtB,oBAAoB,EACpB,YAAY,GAAG,sBAAsB,GACf;IACtB,OAAO;QACL,qBAAqB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC9B,qBAAqB,CAAC,EAAE,sBAAsB,EAAE,GAAG,IAAI,EAAE,CAAC;QAC5D,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC5B,mBAAmB,CAAC,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,CAAC;QACxD,sBAAsB,EAAE,CAAC,IAAI,EAAE,EAAE,CAC/B,sBAAsB,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC"}

package/dist/core/automation/plan.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utilities for wrapping optional plan generation prior to launching an automation task.
+ */
+export interface GeneratePlanTextParams {
+    planEnabled: boolean;
+    prompt: string;
+    planService: unknown;
+    repositoryPath?: string;
+}
+export interface GeneratePlanTextResult {
+    promptToExecute: string;
+    planGenerated: boolean;
+}
+export declare function generatePlanText({ planEnabled, prompt, planService, repositoryPath, }: GeneratePlanTextParams): Promise<GeneratePlanTextResult>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/core/automation/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/core/automation/plan.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,gBAAgB,CAAC,EACrC,WAAW,EACX,MAAM,EACN,WAAW,EACX,cAAc,GACf,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgC1D"}

package/dist/core/automation/plan.js

@@ -0,0 +1,25 @@
+import { AutomationRequestError } from './request-validation.js';
+export async function generatePlanText({ planEnabled, prompt, planService, repositoryPath, }) {
+    if (!planEnabled) {
+        return { promptToExecute: prompt, planGenerated: false };
+    }
+    if (!prompt.trim()) {
+        throw new AutomationRequestError(400, 'prompt is required when plan is true');
+    }
+    const service = planService;
+    if (!service || !service.isConfigured) {
+        throw new AutomationRequestError(503, 'Plan generation is not configured. Configure a local LLM command (set planLlm in config.json).');
+    }
+    try {
+        const planText = await service.createPlanText({
+            prompt,
+            cwd: repositoryPath,
+        });
+        return { promptToExecute: planText, planGenerated: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new AutomationRequestError(500, message, error instanceof Error ? error : undefined);
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/core/automation/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/core/automation/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAkBjE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,WAAW,EACX,MAAM,EACN,WAAW,EACX,cAAc,GACS;IACvB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,sBAAsB,CAAC,GAAG,EAAE,sCAAsC,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,GAAG,WAA8F,CAAC;IAC/G,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,IAAI,sBAAsB,CAC9B,GAAG,EACH,gGAAgG,CACjG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAe,CAAC;YAC7C,MAAM;YACN,GAAG,EAAE,cAAc;SACpB,CAAC,CAAC;QAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,IAAI,sBAAsB,CAC9B,GAAG,EACH,OAAO,EACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAC3C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/automation/request-validation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Helpers for validating inbound automation API requests and normalising payload data.
+ */
+export declare class AutomationRequestError extends Error {
+    status: number;
+    cause?: unknown;
+    constructor(status: number, message: string, cause?: unknown);
+}
+export declare function extractApiKey(req: {
+    headers?: Record<string, string | string[] | undefined>;
+}): string;
+export declare function parseRequestPayload(readJsonBody: () => Promise<unknown>): Promise<unknown>;
+export declare function parsePlanFlag(value: unknown): boolean;
+export declare function validatePrompt(rawPrompt: unknown): string;
+export declare function parseRepoIdentifier(input: unknown): {
+    org: string;
+    repo: string;
+};
+export declare function sanitiseWorktreeDescriptor(worktreeDescriptor: unknown): string;
+export declare function resolveAgentCommand(agentCommands: unknown, requested: unknown): {
+    key: string;
+    command: unknown;
+};
+export interface ValidateAutomationRequestParams {
+    req: {
+        headers?: Record<string, string | string[] | undefined>;
+    };
+    expectedApiKey: string;
+    readJsonBody: () => Promise<unknown>;
+    agentCommands: unknown;
+}
+export declare function validateAutomationRequest({ req, expectedApiKey, readJsonBody, agentCommands, }: ValidateAutomationRequestParams): Promise<{
+    payload: unknown;
+    planEnabled: boolean;
+    routeLabel: string;
+    org: string;
+    repo: string;
+    agent: {
+        key: string;
+        command: unknown;
+    };
+    prompt: string;
+    worktreeInput: string;
+}>;
+//# sourceMappingURL=request-validation.d.ts.map

package/dist/core/automation/request-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-validation.d.ts","sourceRoot":"","sources":["../../../src/core/automation/request-validation.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,MAAM,EAAE,MAAM,CAAC;IACN,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAQ7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;CAAE,GAAG,MAAM,CAetG;AAED,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhG;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAUzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmBjF;AAED,wBAAgB,0BAA0B,CAAC,kBAAkB,EAAE,OAAO,GAAG,MAAM,CA4C9E;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAsBjH;AAED,MAAM,WAAW,+BAA+B;IAC9C,GAAG,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;KAAE,CAAC;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,yBAAyB,CAAC,EAC9C,GAAG,EACH,cAAc,EACd,YAAY,EACZ,aAAa,GACd,EAAE,+BAA+B,GAAG,OAAO,CAAC;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC,CAmCD"}

package/dist/core/automation/request-validation.js

@@ -0,0 +1,144 @@
+import { normaliseBranchName } from '../git.js';
+/**
+ * Helpers for validating inbound automation API requests and normalising payload data.
+ */
+export class AutomationRequestError extends Error {
+    status;
+    cause;
+    constructor(status, message, cause) {
+        super(message);
+        this.name = 'AutomationRequestError';
+        this.status = status;
+        if (cause) {
+            this.cause = cause;
+        }
+    }
+}
+export function extractApiKey(req) {
+    const apiKeyHeader = req.headers?.['x-api-key'];
+    if (typeof apiKeyHeader === 'string' && apiKeyHeader.trim()) {
+        return apiKeyHeader.trim();
+    }
+    const authHeader = req.headers?.['authorization'];
+    if (typeof authHeader === 'string') {
+        const trimmed = authHeader.trim();
+        if (/^bearer\s+/i.test(trimmed)) {
+            return trimmed.replace(/^bearer\s+/i, '').trim();
+        }
+    }
+    return '';
+}
+export async function parseRequestPayload(readJsonBody) {
+    try {
+        return await readJsonBody();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Invalid JSON payload';
+        throw new AutomationRequestError(400, message, error instanceof Error ? error : undefined);
+    }
+}
+export function parsePlanFlag(value) {
+    if (value === undefined) {
+        return true;
+    }
+    if (typeof value === 'boolean') {
+        return value;
+    }
+    throw new AutomationRequestError(400, 'plan must be a boolean');
+}
+export function validatePrompt(rawPrompt) {
+    if (rawPrompt === undefined) {
+        return '';
+    }
+    if (typeof rawPrompt !== 'string') {
+        throw new AutomationRequestError(400, 'prompt must be a string');
+    }
+    return rawPrompt;
+}
+export function parseRepoIdentifier(input) {
+    if (typeof input !== 'string' || !input.trim()) {
+        throw new AutomationRequestError(400, 'repo must be provided in the format "org/repository"');
+    }
+    const cleaned = input.trim().replace(/\.git$/i, '');
+    const segments = cleaned.split('/').filter(Boolean);
+    if (segments.length !== 2) {
+        throw new AutomationRequestError(400, 'repo must be provided in the format "org/repository"');
+    }
+    return { org: segments[0], repo: segments[1] };
+}
+export function sanitiseWorktreeDescriptor(worktreeDescriptor) {
+    if (typeof worktreeDescriptor !== 'string' || !worktreeDescriptor.trim()) {
+        throw new AutomationRequestError(400, 'worktree must be provided as "type/title"');
+    }
+    const parts = worktreeDescriptor
+        .split('/')
+        .map((part) => part.trim())
+        .filter(Boolean);
+    if (parts.length < 2) {
+        throw new AutomationRequestError(400, 'worktree must include both type and title separated by "/"');
+    }
+    const slugify = (value) => value
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/gi, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const segments = parts.map((part) => {
+        const slug = slugify(part);
+        if (!slug) {
+            throw new AutomationRequestError(400, 'worktree name segments must include alphanumeric characters');
+        }
+        return slug;
+    });
+    const branchName = normaliseBranchName(segments.join('/'));
+    if (!branchName) {
+        throw new AutomationRequestError(400, 'Derived branch name is empty');
+    }
+    if (branchName.toLowerCase() === 'main') {
+        throw new AutomationRequestError(400, 'worktree branch "main" is not allowed');
+    }
+    return branchName;
+}
+export function resolveAgentCommand(agentCommands, requested) {
+    const key = typeof requested === 'string' ? requested.trim().toLowerCase() : '';
+    if (!key) {
+        throw new AutomationRequestError(400, 'command must be one of: codex, cursor, claude');
+    }
+    const commands = agentCommands;
+    const mapping = {
+        codex: commands?.['codexDangerous'] || commands?.['codex'],
+        cursor: commands?.['cursor'],
+        claude: commands?.['claudeDangerous'] || commands?.['claude'],
+    };
+    const command = mapping[key];
+    if (!command) {
+        throw new AutomationRequestError(400, `Unsupported command "${requested}". Expected codex, cursor, or claude.`);
+    }
+    return { key, command: command };
+}
+export async function validateAutomationRequest({ req, expectedApiKey, readJsonBody, agentCommands, }) {
+    if (!expectedApiKey) {
+        throw new AutomationRequestError(503, 'Automation API is not configured (missing API key)');
+    }
+    const providedKey = extractApiKey(req);
+    if (providedKey !== expectedApiKey) {
+        throw new AutomationRequestError(401, 'Invalid API key');
+    }
+    const payload = await parseRequestPayload(readJsonBody);
+    const planEnabled = parsePlanFlag(payload['plan']);
+    const routeLabel = planEnabled ? 'create-plan' : 'passthrough';
+    const prompt = validatePrompt(payload['prompt']);
+    const { org, repo } = parseRepoIdentifier(payload['repo']);
+    const worktreeInput = typeof payload['worktree'] === 'string' ? payload['worktree'].trim() : '';
+    const agent = resolveAgentCommand(agentCommands, payload['command']);
+    return {
+        payload,
+        planEnabled,
+        routeLabel,
+        prompt,
+        org,
+        repo,
+        worktreeInput,
+        agent,
+    };
+}
+//# sourceMappingURL=request-validation.js.map

package/dist/core/automation/request-validation.js.map

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

package/dist/core/automation/task-runner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Coordinates the asynchronous automation launch task, updating task progress and metadata.
+ */
+export declare const TASK_TYPE_AUTOMATION = "automation:launch";
+export declare const STEP_IDS: Readonly<{
+    ENSURE_REPO: "ensure-repository";
+    GENERATE_PLAN: "generate-plan";
+    ENSURE_WORKTREE: "ensure-worktree";
+    LAUNCH_AGENT: "launch-agent";
+    REFRESH_REPOS: "refresh-repositories";
+}>;
+export declare const STEP_LABELS: Readonly<{
+    "ensure-repository": "Ensure repository";
+    "generate-plan": "Generate plan";
+    "ensure-worktree": "Ensure worktree";
+    "launch-agent": "Launch agent";
+    "refresh-repositories": "Refresh repositories";
+}>;
+export interface RunAutomationTaskParams {
+    runTaskImpl: (config: unknown, executor: (context: unknown) => Promise<unknown>) => Promise<unknown>;
+    resolveBranchName: (params: unknown) => Promise<unknown>;
+    generatePlanText: (params: unknown) => Promise<unknown>;
+    gitOrchestrator: unknown;
+    launchAgent: (params: unknown) => Promise<void>;
+    workdir: string;
+    planEnabled: boolean;
+    routeLabel: string;
+    prompt: string;
+    org: string;
+    repo: string;
+    agent: string;
+    requestId: string;
+    worktreeInput?: string;
+    branchNameGenerator: unknown;
+    defaultBranches: unknown;
+    planService: unknown;
+    finishSuccess: (response: unknown) => void;
+    finishFailure: (error: unknown) => void;
+    onBranchResolved?: (branch: string) => void;
+}
+export declare function runAutomationTask({ runTaskImpl, resolveBranchName, generatePlanText, gitOrchestrator, launchAgent, workdir, planEnabled, routeLabel, prompt, org, repo, agent, requestId, worktreeInput, branchNameGenerator, defaultBranches, planService, finishSuccess, finishFailure, onBranchResolved, }: RunAutomationTaskParams): Promise<void>;
+//# sourceMappingURL=task-runner.d.ts.map

package/dist/core/automation/task-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../../../src/core/automation/task-runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD,eAAO,MAAM,QAAQ;;;;;;EAMnB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;EAMtB,CAAC;AAEH,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrG,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,gBAAgB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,aAAa,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,aAAa,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED,wBAAsB,iBAAiB,CAAC,EACtC,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,OAAO,EACP,WAAW,EACX,UAAU,EACV,MAAM,EACN,GAAG,EACH,IAAI,EACJ,KAAK,EACL,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuQzC"}