agentrix 0.0.1

package/README.md

@@ -0,0 +1,235 @@
+# agentrix
+
+`agentrix` is a password-protected CLI that serves a browser-based interface for managing
+Git repositories, worktrees, and persistent shell sessions. The backend is an ES module Node.js
+service that exposes REST + WebSocket APIs, while the frontend is a Vite-powered React application
+that lives in `ui/`.
+
+## Prerequisites
+
+- Node.js 18 or newer
+- Git (for cloning repositories and creating worktrees)
+
+## Install Dependencies
+
+From the repository root:
+
+```bash
+npm install
+```
+
+Install frontend dependencies separately:
+
+```bash
+cd ui
+npm install
+```
+
+## Build the Frontend
+
+The backend serves pre-built assets from `ui/dist`. Build them once (or whenever the UI changes):
+
+```bash
+npm run build          # Invokes `vite build` in ui/
+```
+
+The build artefacts land in `ui/dist/` and are picked up automatically by the CLI defaults.
+
+## Running the CLI
+
+After building the UI:
+
+```bash
+npm start
+```
+
+or directly:
+
+```bash
+node bin/agentrix.js
+```
+
+By default the server binds to `0.0.0.0:3414`, serves assets from `ui/dist`, and scans the current
+working directory for repositories. Customise behaviour with flags:
+
+```bash
+node bin/agentrix.js \
+  --port 4000 \
+  --host 127.0.0.1 \
+  --ui ./ui/dist \
+  --workdir /path/to/workdir \
+  --password secret
+```
+
+### CLI Options
+
+- `-p, --port <number>` – HTTP port (default: `3414`)
+- `-H, --host <host>` – Bind address (default: `0.0.0.0`)
+- `-u, --ui <path>` – Directory or entry file for the built UI (default: `ui/dist`)
+- `-w, --workdir <path>` – Root directory that holds `org/repo` folders (default: process CWD)
+- `-P, --password <string>` – UI password (default: secure random string generated at startup)
+- `--default-branch <name>` – Override the sync branch when repositories use a non-`main` default
+- `--terminal-session-mode <auto|tmux|pty>` – Select the terminal backend (`auto` tries tmux, falls back to PTY)
+- `--force-tmux` – Shortcut for `--terminal-session-mode tmux`; errors if tmux is unavailable
+- `--no-tmux` – Shortcut for `--terminal-session-mode pty`; disables tmux usage entirely
+- `--show-password` – Print the resolved password even if it was set via config or flag
+- `--ngrok-api-key <token>` – Authtoken used to establish a public ngrok tunnel
+- `--ngrok-domain <domain>` – Reserved ngrok domain exposed when tunnelling (requires `--ngrok-api-key`)
+- `--save` – Persist the effective configuration to `~/.agentrix/config.json` and exit
+- `-h, --help` – Print usage
+- `-v, --version` – Show package version
+
+When both ngrok flags are supplied the CLI will establish a tunnel after the HTTP server boots and
+print the public URL. If either flag is omitted the service remains reachable only via the bound host
+and port.
+
+### Configuration File
+
+At startup the CLI also reads `~/.agentrix/config.json` if it exists. Any values in that file
+fill in defaults for matching CLI options, while explicit command-line arguments always win. A simple
+configuration might look like:
+
+```json
+{
+  "port": 4001,
+  "host": "127.0.0.1",
+  "ui": "./ui/dist",
+  "workdir": "/srv/worktrees",
+  "password": "s3cr3t",
+  "defaultBranch": "develop",
+  "defaultBranches": {
+    "acme/web": "master"
+  },
+  "cookies": {
+    "secure": "auto"
+  },
+  "commands": {
+    "codex": "codex",
+    "cursor": "cursor-agent",
+    "vscode": "code ."
+  },
+  "ngrok": {
+    "apiKey": "NGROK_AUTHTOKEN",
+    "domain": "example.ngrok.app"
+  },
+  "automation": {
+    "apiKey": "AUTOMATION_API_KEY"
+  }
+}
+```
+
+Supported keys mirror the CLI flags (`port`, `host`, `ui`, `workdir`, `password`, individual
+`*Command` entries, plus `ngrokApiKey`/`ngrokDomain` or `ngrok.apiKey` / `ngrok.domain`). The
+automation API key can be supplied as `automation.apiKey`, `automationApiKey`, or `apiKey`. Leave
+the file absent to continue using only CLI arguments. Use `terminalSessionMode` to persist the
+preferred terminal backend (`auto`, `tmux`, or `pty`).
+
+Run `agentrix --port 4001 --workdir /srv/worktrees --save` to save the provided values into
+the config file without starting the server.
+
+### Authentication
+
+When the CLI generates a password it prints the value once at startup. If you supply a password via
+CLI flag or config file it is kept out of stdout; pass `--show-password` if you still need the value
+echoed. Clients must authenticate before calling API endpoints.
+
+Repositories that do not use `main` can set a global `defaultBranch` or repo-specific overrides in
+`defaultBranches` (keyed by `org/repo`). The CLI uses these when syncing before creating worktrees.
+Successful logins receive an HTTP-only session cookie; log out via the UI or `POST
+/api/auth/logout`. On shutdown the backend cleans up shell sessions, tmux attachments, and WebSocket
+clients.
+
+### Automation API
+
+When `config.json` includes an automation API key the backend exposes a machine-consumable endpoint
+for provisioning worktrees and launching agents.
+
+- Endpoint: `POST /api/automation/launch`
+- Headers: `X-API-Key: <key>` (alternatively `Authorization: Bearer <key>`)
+- Body shape:
+
+  ```json
+  {
+    "repo": "org/repository",
+    "worktree": "type/title",
+    "command": "codex",
+    "prompt": "Kick off the task at hand",
+    "plan": true
+  }
+  ```
+
+The server uses `codex`, `cursor`, or `claude` agent commands configured via `config.json`, cloning
+`git@github.com:org/repository.git` if necessary, creating (or reusing) the specified worktree, and
+then launching the agent inside the same tmux-backed terminal session that the UI attaches to. When
+`plan` is omitted or set to `true` the submitted prompt is first transformed via the **Create Plan**
+pipeline (powered by the configured local LLM); set `"plan": false` to preserve the original prompt and bypass
+planning. The request responds with `202 Accepted` once the terminal session is ready and includes
+metadata about the repository, worktree, agent command, process `pid`, terminal identifiers
+(`terminalSessionId`, `terminalSessionCreated`, `terminalUsingTmux`, `tmuxSessionName` when
+applicable), plus the automation metadata `plan`, `promptRoute`, and `automationRequestId`. Automated
+launches therefore appear immediately inside the UI terminal. The effective prompt (planned or
+passthrough) is exported to the session as `AGENTRIX_PROMPT` and appended to the initial
+agent command so automation invocations receive it straight away.
+
+### Task Persistence
+
+Automation launches and other background workflows publish task status updates that power
+`/api/tasks` and the UI dashboard. The backend persists this metadata to
+`<workdir>/.agentrix/tasks.json` using atomic writes so that state survives process
+restarts. During bootstrap the saved snapshot is rehydrated; any task that was still `pending` or
+`running` is marked as `failed` with `error.reason` set to `process_restart`, allowing the UI to show
+that progress was interrupted. Completed tasks remain visible for 15 minutes before being pruned
+from both memory and disk.
+
+### Plan Artifacts
+
+Automation runs (and prompt-driven worktree creation) persist Markdown plans inside each worktree
+under `.plans/`. Access them without SSHing into the worktree:
+
+- `GET /api/plans?org=<org>&repo=<repo>&branch=<branch>` – returns the newest plan identifiers and
+  timestamps for the requested worktree.
+- `GET /api/plans/content?...&planId=<file>` – streams the selected plan’s contents in Markdown.
+- CLI helper: `agentrix plans list --org <org> --repo <repo> --branch <branch>` followed by
+  `agentrix plans show --org <org> --repo <repo> --branch <branch> --plan-id <file>` to
+  render Markdown locally.
+
+The server prunes older artifacts, keeping the 20 most recent plans per branch by default. Delete
+entries manually if you need to reclaim space sooner.
+
+### Real-time Updates
+
+After authentication the UI opens a Server-Sent Events stream at `GET /api/events` to receive
+push notifications:
+
+- `repos:update` — emits the full repository/worktree snapshot (equivalent to `GET /api/repos`).
+- `sessions:update` — lists active terminal sessions (subset of `GET /api/sessions`).
+
+When the stream is unavailable the client automatically falls back to minute-level polling to keep
+state in sync.
+
+### Repository Layout & Worktrees
+
+The work directory is expected to follow:
+
+```
+[workdir]/
+  org/
+    repo/
+      repository/      # main checkout
+      <worktree-name>/ # additional worktrees
+```
+
+Use **Add Repo** to clone into this structure, **Create Worktree** to branch from up-to-date
+`origin/main`, and **Delete Worktree** to remove worktrees (except `main`, which is intentionally
+protected). Terminal sessions are backed by `node-pty` and optionally tmux so reconnects resume the
+previous shell.
+
+## Development Workflow
+
+- `npm run dev` – Start the backend CLI.
+- `npm run dev:ui` – Run the Vite dev server (hot-module reloading React).
+- `npm run preview` – Serve the production build through Vite.
+- `npm run build` – Generate production assets in `ui/dist`.
+
+During local development run the backend CLI (`npm run dev`) alongside the Vite dev server (`npm run
+dev:ui`). Use the dev server URL directly in the browser while exercising APIs exposed by the CLI.

package/bin/agentrix.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { main } from '../dist/cli.js';
+
+main();

package/dist/api/auth.d.ts

@@ -0,0 +1,10 @@
+import type { RequestContext } from '../types/http.js';
+import type { AuthManager, CookieManager } from '../types/auth.js';
+export declare function createAuthHandlers(authManager: AuthManager, { cookieManager }?: {
+    cookieManager?: CookieManager;
+}): {
+    login: (context: RequestContext) => Promise<void>;
+    logout: (context: RequestContext) => Promise<void>;
+    status: (context: RequestContext) => Promise<void>;
+};
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,EAAE,aAAa,EAAE,GAAE;IAAE,aAAa,CAAC,EAAE,aAAa,CAAA;CAAO;;;;EAiC1D"}

package/dist/api/auth.js

@@ -0,0 +1,30 @@
+import { sendJson } from '../utils/http.js';
+import { createAuthService } from '../services/index.js';
+import { asyncHandler } from '../infrastructure/errors/index.js';
+import { createSimpleHandler } from './base-handler.js';
+export function createAuthHandlers(authManager, { cookieManager } = {}) {
+    const authService = createAuthService(authManager, cookieManager);
+    // Login requires special error handling for status codes
+    const login = asyncHandler(async (context) => {
+        const payload = await context.readJsonBody();
+        const password = typeof payload['password'] === 'string' ? payload['password'].trim() : '';
+        try {
+            const result = await authService.login(context.req, context.res, password);
+            sendJson(context.res, 200, result);
+        }
+        catch (error) {
+            // Auth errors need special handling for status codes
+            const err = error;
+            const statusCode = err.statusCode || (err.message === 'Invalid password' ? 401 : 400);
+            sendJson(context.res, statusCode, { error: err.message });
+        }
+    });
+    const logout = createSimpleHandler(async (context) => authService.logout(context.req, context.res));
+    const status = createSimpleHandler(async (context) => authService.getStatus(context.req));
+    return {
+        login,
+        logout,
+        status,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/api/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/api/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,UAAU,kBAAkB,CAChC,WAAwB,EACxB,EAAE,aAAa,KAAwC,EAAE;IAEzD,MAAM,WAAW,GAAG,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAElE,yDAAyD;IACzD,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,OAAuB,EAAE,EAAE;QAC3D,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC3E,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,qDAAqD;YACrD,MAAM,GAAG,GAAG,KAAiD,CAAC;YAC9D,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,OAAO,KAAK,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACtF,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,mBAAmB,CAChC,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,CAChF,CAAC;IAEF,MAAM,MAAM,GAAG,mBAAmB,CAChC,KAAK,EAAE,OAAuB,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CACtE,CAAC;IAEF,OAAO;QACL,KAAK;QACL,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/api/automation.d.ts

@@ -0,0 +1,52 @@
+import { launchAgentProcess } from '../core/agents.js';
+import { runTask } from '../core/tasks.js';
+import type { Logger } from '../infrastructure/logging/index.js';
+declare function ensureRepositoryExists(workdir: string, org: string, repo: string): Promise<{
+    repositoryPath: string;
+    cloned: boolean;
+}>;
+declare function ensureWorktreeExists(workdir: string, org: string, repo: string, branch: string, options?: unknown): Promise<{
+    worktreePath: string;
+    created: boolean;
+}>;
+export declare const automationPlanMetrics: {
+    planTrue: {
+        requests: number;
+        successes: number;
+        failures: number;
+        totalLatencyMs: number;
+    };
+    planFalse: {
+        requests: number;
+        successes: number;
+        failures: number;
+        totalLatencyMs: number;
+    };
+};
+export declare function resetAutomationPlanMetrics(): void;
+export interface AutomationHandlersConfig {
+    workdir: string;
+    agentCommands: unknown;
+    apiKey?: string;
+    branchNameGenerator: unknown;
+    planService: unknown;
+    logger?: Logger;
+    defaultBranches: unknown;
+}
+export interface AutomationHandlersDependencies {
+    ensureRepositoryExists?: typeof ensureRepositoryExists;
+    ensureWorktreeExists?: typeof ensureWorktreeExists;
+    launchAgentProcess?: typeof launchAgentProcess;
+    runTaskImpl?: typeof runTask;
+    now?: () => number;
+    createRequestId?: () => string;
+}
+export declare function createAutomationHandlers({ workdir, agentCommands, apiKey, branchNameGenerator, planService, logger, defaultBranches, }: AutomationHandlersConfig, { ensureRepositoryExists: ensureRepoExists, ensureWorktreeExists: ensureWorktree, launchAgentProcess: launchAgent, runTaskImpl, now, createRequestId, }?: AutomationHandlersDependencies): {
+    launch: (context: {
+        req: unknown;
+        res: unknown;
+        readJsonBody: () => Promise<unknown>;
+    }) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=automation.d.ts.map

package/dist/api/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/api/automation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAW3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAEjE,iBAAe,sBAAsB,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CActD;AAED,iBAAe,oBAAoB,CACjC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,OAAY,GACpB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAarD;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAajC,CAAC;AAEF,wBAAgB,0BAA0B,SAOzC;AAeD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,8BAA8B;IAC7C,sBAAsB,CAAC,EAAE,OAAO,sBAAsB,CAAC;IACvD,oBAAoB,CAAC,EAAE,OAAO,oBAAoB,CAAC;IACnD,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,WAAW,CAAC,EAAE,OAAO,OAAO,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,MAAM,CAAC;CAChC;AAED,wBAAgB,wBAAwB,CACtC,EACE,OAAO,EACP,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,WAAW,EACX,MAAM,EACN,eAAe,GAChB,EAAE,wBAAwB,EAC3B,EACE,sBAAsB,EAAE,gBAAyC,EACjE,oBAAoB,EAAE,cAAqC,EAC3D,kBAAkB,EAAE,WAAgC,EACpD,WAAqB,EACrB,GAAsB,EACtB,eAAoC,GACrC,GAAE,8BAAmC;sBASP;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,KAAG,OAAO,CAAC,IAAI,CAAC;EAoHpH"}

package/dist/api/automation.js

@@ -0,0 +1,181 @@
+import { randomUUID } from 'node:crypto';
+import { cloneRepository, createWorktree, ensureRepository, getWorktreePath, } from '../core/git.js';
+import { launchAgentProcess } from '../core/agents.js';
+import { runTask } from '../core/tasks.js';
+import { sendJson } from '../utils/http.js';
+import { validateAutomationRequest, AutomationRequestError, } from '../core/automation/request-validation.js';
+import { resolveBranchName } from '../core/automation/branch.js';
+import { generatePlanText } from '../core/automation/plan.js';
+import { createGitOrchestrator } from '../core/automation/git-orchestration.js';
+import { runAutomationTask } from '../core/automation/task-runner.js';
+import { createLogger } from '../infrastructure/logging/index.js';
+async function ensureRepositoryExists(workdir, org, repo) {
+    try {
+        const { repositoryPath } = await ensureRepository(workdir, org, repo);
+        return { repositoryPath, cloned: false };
+    }
+    catch (error) {
+        const err = error;
+        if (err && /Repository not found/i.test(err.message || '')) {
+            const remote = `git@github.com:${org}/${repo}.git`;
+            await cloneRepository(workdir, remote);
+            const { repositoryPath } = await ensureRepository(workdir, org, repo);
+            return { repositoryPath, cloned: true };
+        }
+        throw error;
+    }
+}
+async function ensureWorktreeExists(workdir, org, repo, branch, options = {}) {
+    try {
+        const { worktreePath } = await getWorktreePath(workdir, org, repo, branch);
+        return { worktreePath, created: false };
+    }
+    catch (error) {
+        const err = error;
+        if (err && /worktree .* not found/i.test(err.message || '')) {
+            await createWorktree(workdir, org, repo, branch, options);
+            const { worktreePath } = await getWorktreePath(workdir, org, repo, branch);
+            return { worktreePath, created: true };
+        }
+        throw error;
+    }
+}
+export const automationPlanMetrics = {
+    planTrue: {
+        requests: 0,
+        successes: 0,
+        failures: 0,
+        totalLatencyMs: 0,
+    },
+    planFalse: {
+        requests: 0,
+        successes: 0,
+        failures: 0,
+        totalLatencyMs: 0,
+    },
+};
+export function resetAutomationPlanMetrics() {
+    for (const bucket of Object.values(automationPlanMetrics)) {
+        bucket.requests = 0;
+        bucket.successes = 0;
+        bucket.failures = 0;
+        bucket.totalLatencyMs = 0;
+    }
+}
+function finishMetrics(key, success, durationMs) {
+    const bucket = automationPlanMetrics[key];
+    if (!bucket) {
+        return;
+    }
+    if (success) {
+        bucket.successes += 1;
+    }
+    else {
+        bucket.failures += 1;
+    }
+    bucket.totalLatencyMs += durationMs;
+}
+export function createAutomationHandlers({ workdir, agentCommands, apiKey, branchNameGenerator, planService, logger, defaultBranches, }, { ensureRepositoryExists: ensureRepoExists = ensureRepositoryExists, ensureWorktreeExists: ensureWorktree = ensureWorktreeExists, launchAgentProcess: launchAgent = launchAgentProcess, runTaskImpl = runTask, now = () => Date.now(), createRequestId = () => randomUUID(), } = {}) {
+    const gitOrchestrator = createGitOrchestrator({
+        ensureRepositoryExists: ensureRepoExists,
+        ensureWorktreeExists: ensureWorktree,
+    });
+    const log = createLogger(logger);
+    async function launch(context) {
+        const ctx = context;
+        let validation;
+        try {
+            validation = await validateAutomationRequest({
+                req: ctx.req,
+                expectedApiKey: apiKey || '',
+                readJsonBody: ctx.readJsonBody,
+                agentCommands,
+            });
+        }
+        catch (error) {
+            if (error instanceof AutomationRequestError) {
+                sendJson(ctx.res, error.status, { error: error.message });
+                return;
+            }
+            log.error('[agentrix] Automation validation failed unexpectedly.', error);
+            sendJson(ctx.res, 500, { error: 'Unexpected error while validating automation request' });
+            return;
+        }
+        const { planEnabled, prompt, org, repo, worktreeInput, agent, routeLabel } = validation;
+        const metricsKey = planEnabled ? 'planTrue' : 'planFalse';
+        automationPlanMetrics[metricsKey].requests += 1;
+        const requestId = createRequestId();
+        const startedAt = now();
+        const elapsedMs = () => {
+            const value = now() - startedAt;
+            return Number.isFinite(value) ? value : 0;
+        };
+        const finishSuccess = (detail) => {
+            const durationMs = elapsedMs();
+            finishMetrics(metricsKey, true, durationMs);
+            const suffix = detail ? `: ${detail}` : '';
+            log.info(`[agentrix] Automation request ${requestId} (${routeLabel}) completed in ${durationMs}ms${suffix}`);
+        };
+        const finishFailure = (message, error) => {
+            const durationMs = elapsedMs();
+            finishMetrics(metricsKey, false, durationMs);
+            if (error) {
+                log.error(`[agentrix] Automation request ${requestId} (${routeLabel}) failed after ${durationMs}ms: ${message}`, error);
+            }
+            else {
+                log.error(`[agentrix] Automation request ${requestId} (${routeLabel}) failed after ${durationMs}ms: ${message}`);
+            }
+        };
+        log.info(`[agentrix] Automation request ${requestId} (${routeLabel}) received.`);
+        if (planEnabled && !prompt.trim()) {
+            const message = 'prompt is required when plan is true';
+            finishFailure(message);
+            sendJson(ctx.res, 400, { error: message });
+            return;
+        }
+        const service = planService;
+        if (planEnabled && (!service || !service.isConfigured)) {
+            const message = 'Plan generation is not configured. Configure a local LLM command (set planLlm in config.json).';
+            finishFailure(message);
+            sendJson(ctx.res, 503, { error: message });
+            return;
+        }
+        try {
+            const result = (await runAutomationTask({
+                runTaskImpl: runTaskImpl,
+                resolveBranchName: resolveBranchName,
+                generatePlanText: generatePlanText,
+                gitOrchestrator,
+                launchAgent: launchAgent,
+                workdir,
+                planEnabled,
+                routeLabel,
+                prompt,
+                org,
+                repo,
+                agent: agent,
+                requestId,
+                worktreeInput,
+                branchNameGenerator,
+                defaultBranches,
+                planService,
+                finishSuccess: finishSuccess,
+                finishFailure: finishFailure,
+                onBranchResolved: (branch) => {
+                    log.info(`[agentrix] Automation request ${requestId} (${routeLabel}) targeting ${org}/${repo}#${branch}.`);
+                },
+            }));
+            sendJson(ctx.res, 202, { taskId: result.taskId, data: result.queuedData });
+        }
+        catch (error) {
+            const status = error instanceof AutomationRequestError && typeof error.status === 'number'
+                ? error.status
+                : 500;
+            const message = error instanceof Error ? error.message : String(error);
+            finishFailure(message, error instanceof Error ? error : undefined);
+            sendJson(ctx.res, status, { error: message });
+        }
+    }
+    return { launch };
+}
+//# sourceMappingURL=automation.js.map

package/dist/api/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../src/api/automation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,KAAK,UAAU,sBAAsB,CACnC,OAAe,EACf,GAAW,EACX,IAAY;IAEZ,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QACtE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAA6B,CAAC;QAC1C,IAAI,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,kBAAkB,GAAG,IAAI,IAAI,MAAM,CAAC;YACnD,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YACtE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,OAAe,EACf,GAAW,EACX,IAAY,EACZ,MAAc,EACd,UAAmB,EAAE;IAErB,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAA6B,CAAC;QAC1C,IAAI,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,MAAM,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAgB,CAAC,CAAC;YACnE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3E,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE;QACR,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,cAAc,EAAE,CAAC;KAClB;IACD,SAAS,EAAE;QACT,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;QACZ,QAAQ,EAAE,CAAC;QACX,cAAc,EAAE,CAAC;KAClB;CACF,CAAC;AAEF,MAAM,UAAU,0BAA0B;IACxC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC;QACrB,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAA6B,EAAE,OAAgB,EAAE,UAAkB;IACxF,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,CAAC,cAAc,IAAI,UAAU,CAAC;AACtC,CAAC;AAqBD,MAAM,UAAU,wBAAwB,CACtC,EACE,OAAO,EACP,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,WAAW,EACX,MAAM,EACN,eAAe,GACU,EAC3B,EACE,sBAAsB,EAAE,gBAAgB,GAAG,sBAAsB,EACjE,oBAAoB,EAAE,cAAc,GAAG,oBAAoB,EAC3D,kBAAkB,EAAE,WAAW,GAAG,kBAAkB,EACpD,WAAW,GAAG,OAAO,EACrB,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,EACtB,eAAe,GAAG,GAAG,EAAE,CAAC,UAAU,EAAE,MACF,EAAE;IAEtC,MAAM,eAAe,GAAG,qBAAqB,CAAC;QAC5C,sBAAsB,EAAE,gBAAgB;QACxC,oBAAoB,EAAE,cAAc;KACrC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEjC,KAAK,UAAU,MAAM,CAAC,OAA6E;QACjG,MAAM,GAAG,GAAG,OAAsO,CAAC;QACnP,IAAI,UAAU,CAAC;QACf,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,yBAAyB,CAAC;gBAC3C,GAAG,EAAE,GAAG,CAAC,GAAG;gBACZ,cAAc,EAAE,MAAM,IAAI,EAAE;gBAC5B,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,aAAa;aACd,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;gBAC5C,QAAQ,CAAC,GAAG,CAAC,GAAgC,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvF,OAAO;YACT,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;YAC1E,QAAQ,CAAC,GAAG,CAAC,GAAgC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,sDAAsD,EAAE,CAAC,CAAC;YACvH,OAAO;QACT,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;QAExF,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC;QAC1D,qBAAqB,CAAC,UAAU,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;QAExB,MAAM,SAAS,GAAG,GAAG,EAAE;YACrB,MAAM,KAAK,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC;YAChC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,CAAC,MAAe,EAAQ,EAAE;YAC9C,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;YAC/B,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,GAAG,CAAC,IAAI,CACN,iCAAiC,SAAS,KAAK,UAAU,kBAAkB,UAAU,KAAK,MAAM,EAAE,CACnG,CAAC;QACJ,CAAC,CAAC;QAEF,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,KAAe,EAAQ,EAAE;YAC/D,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;YAC/B,aAAa,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;YAC7C,IAAI,KAAK,EAAE,CAAC;gBACV,GAAG,CAAC,KAAK,CACP,iCAAiC,SAAS,KAAK,UAAU,kBAAkB,UAAU,OAAO,OAAO,EAAE,EACrG,KAAK,CACN,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CACP,iCAAiC,SAAS,KAAK,UAAU,kBAAkB,UAAU,OAAO,OAAO,EAAE,CACtG,CAAC;YACJ,CAAC;QACH,CAAC,CAAC;QAEF,GAAG,CAAC,IAAI,CAAC,iCAAiC,SAAS,KAAK,UAAU,aAAa,CAAC,CAAC;QAEjF,IAAI,WAAW,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,sCAAsC,CAAC;YACvD,aAAa,CAAC,OAAO,CAAC,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,GAAgC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,WAAyC,CAAC;QAC1D,IAAI,WAAW,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,GACX,gGAAgG,CAAC;YACnG,aAAa,CAAC,OAAO,CAAC,CAAC;YACvB,QAAQ,CAAC,GAAG,CAAC,GAAgC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACxE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAM,iBAAiB,CAAC;gBACtC,WAAW,EAAE,WAAoB;gBACjC,iBAAiB,EAAE,iBAA0B;gBAC7C,gBAAgB,EAAE,gBAAyB;gBAC3C,eAAe;gBACf,WAAW,EAAE,WAAoB;gBACjC,OAAO;gBACP,WAAW;gBACX,UAAU;gBACV,MAAM;gBACN,GAAG;gBACH,IAAI;gBACJ,KAAK,EAAE,KAA0B;gBACjC,SAAS;gBACT,aAAa;gBACb,mBAAmB;gBACnB,eAAe;gBACf,WAAW;gBACX,aAAa,EAAE,aAAsB;gBACrC,aAAa,EAAE,aAAsB;gBACrC,gBAAgB,EAAE,CAAC,MAAc,EAAE,EAAE;oBACnC,GAAG,CAAC,IAAI,CACN,iCAAiC,SAAS,KAAK,UAAU,eAAe,GAAG,IAAI,IAAI,IAAI,MAAM,GAAG,CACjG,CAAC;gBACJ,CAAC;aACF,CAAC,CAAuD,CAAC;YAE1D,QAAQ,CAAC,GAAG,CAAC,GAAgC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC1G,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,MAAM,GACV,KAAK,YAAY,sBAAsB,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;gBACzE,CAAC,CAAC,KAAK,CAAC,MAAM;gBACd,CAAC,CAAC,GAAG,CAAC;YACV,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,aAAa,CAAC,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACnE,QAAQ,CAAC,GAAG,CAAC,GAAgC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC"}

package/dist/api/base-handler.d.ts

@@ -0,0 +1,62 @@
+import type { RequestContext } from '../types/http.js';
+/**
+ * Generic handler function type
+ */
+export type HandlerFunction<TInput = unknown, TOutput = unknown> = (input: TInput, context: RequestContext) => Promise<TOutput>;
+/**
+ * Validation function type
+ */
+export type ValidationFunction<TInput = unknown> = (payload: unknown) => TInput;
+/**
+ * Options for creating a handler
+ */
+export interface HandlerOptions<TInput, TOutput> {
+    /**
+     * The service method to call
+     */
+    handler: HandlerFunction<TInput, TOutput>;
+    /**
+     * Optional validation function for request body
+     */
+    validator?: ValidationFunction<TInput>;
+    /**
+     * HTTP status code for successful response (default: 200)
+     */
+    successCode?: number;
+    /**
+     * Whether to read JSON body from request (default: true if validator is provided)
+     */
+    readBody?: boolean;
+    /**
+     * Custom response transformer (default: wraps result in { data: result })
+     */
+    responseTransformer?: (result: TOutput) => unknown;
+}
+/**
+ * Creates a standardized API handler with validation and error handling
+ *
+ * @example
+ * ```typescript
+ * const createUser = createHandler({
+ *   handler: async (input, context) => userService.create(input),
+ *   validator: validateUserCreate,
+ *   successCode: 201
+ * });
+ * ```
+ */
+export declare function createHandler<TInput = void, TOutput = unknown>(options: HandlerOptions<TInput, TOutput>): (context: RequestContext) => Promise<void>;
+/**
+ * Creates a simple handler that doesn't require input validation
+ */
+export declare function createSimpleHandler<TOutput = unknown>(handler: (context: RequestContext) => Promise<TOutput>, options?: {
+    successCode?: number;
+    responseTransformer?: (result: TOutput) => unknown;
+}): (context: RequestContext) => Promise<void>;
+/**
+ * Creates a handler for query parameter-based requests
+ */
+export declare function createQueryHandler<TOutput = unknown>(handler: (context: RequestContext) => Promise<TOutput>, options?: {
+    successCode?: number;
+    responseTransformer?: (result: TOutput) => unknown;
+}): (context: RequestContext) => Promise<void>;
+//# sourceMappingURL=base-handler.d.ts.map

package/dist/api/base-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../src/api/base-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CACjE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,MAAM,GAAG,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,EAAE,OAAO;IAC7C;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE1C;;OAEG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEvC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CACpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAG,IAAI,EAAE,OAAO,GAAG,OAAO,EAC5D,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CA2B5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACnD,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,EACtD,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CAAO,GACzF,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAM5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAG,OAAO,EAClD,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,EACtD,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAA;CAAO,GACzF,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ5C"}

package/dist/api/base-handler.js

@@ -0,0 +1,55 @@
+import { sendJson } from '../utils/http.js';
+import { asyncHandler } from '../infrastructure/errors/index.js';
+/**
+ * Creates a standardized API handler with validation and error handling
+ *
+ * @example
+ * ```typescript
+ * const createUser = createHandler({
+ *   handler: async (input, context) => userService.create(input),
+ *   validator: validateUserCreate,
+ *   successCode: 201
+ * });
+ * ```
+ */
+export function createHandler(options) {
+    const { handler, validator, successCode = 200, readBody = Boolean(validator), responseTransformer, } = options;
+    return asyncHandler(async (context) => {
+        let input;
+        if (readBody) {
+            const payload = await context.readJsonBody();
+            input = validator ? validator(payload) : payload;
+        }
+        else {
+            input = undefined;
+        }
+        const result = await handler(input, context);
+        const response = responseTransformer
+            ? responseTransformer(result)
+            : result;
+        sendJson(context.res, successCode, response);
+    });
+}
+/**
+ * Creates a simple handler that doesn't require input validation
+ */
+export function createSimpleHandler(handler, options = {}) {
+    return createHandler({
+        handler: async (_input, context) => handler(context),
+        readBody: false,
+        ...options,
+    });
+}
+/**
+ * Creates a handler for query parameter-based requests
+ */
+export function createQueryHandler(handler, options = {}) {
+    return asyncHandler(async (context) => {
+        const result = await handler(context);
+        const response = options.responseTransformer
+            ? options.responseTransformer(result)
+            : result;
+        sendJson(context.res, options.successCode || 200, response);
+    });
+}
+//# sourceMappingURL=base-handler.js.map