@moorline/control-api 0.0.1

package/dist/bootstrap.d.ts

@@ -0,0 +1,33 @@
+interface ControlApiBootstrapRecord {
+    version: 1;
+    protocol: 'http';
+    adapterPackageId: string;
+    pid: number;
+    url: string;
+    token: string;
+    startedAt: string;
+    configPath: string;
+}
+export declare function resolveControlApiConfigPath(customPath?: string): string;
+export declare function readControlApiBootstrapRecord(configPath?: string): ControlApiBootstrapRecord | null;
+export declare function writeControlApiBootstrapRecord(record: ControlApiBootstrapRecord): void;
+export declare function clearControlApiBootstrapRecord(configPath?: string): void;
+export declare class ApiBootstrapResolver {
+    private readonly input;
+    constructor(input: {
+        configPath?: string;
+        entrypoint?: string;
+    });
+    resolveConnection(input?: {
+        url?: string;
+        token?: string;
+        configPath?: string;
+        autoStart?: boolean;
+    }): Promise<{
+        url: string;
+        token: string;
+        configPath: string;
+    }>;
+    startLocalApiInBackground(configPath?: string): Promise<ControlApiBootstrapRecord>;
+}
+export {};

package/dist/bootstrap.js

@@ -0,0 +1,149 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+function sleep(ms) {
+    return new Promise((resolve) => {
+        globalThis.setTimeout(resolve, ms);
+    });
+}
+function defaultMoorlineHomePath() {
+    const override = process.env.MOORLINE_HOME?.trim();
+    return resolve(override || homedir(), override ? '.' : '.moorline');
+}
+export function resolveControlApiConfigPath(customPath) {
+    return customPath ? resolve(customPath) : resolve(defaultMoorlineHomePath(), 'config.json');
+}
+function runtimeRootForConfigPath(configPath) {
+    if (!existsSync(configPath)) {
+        return resolve(defaultMoorlineHomePath(), 'runtime');
+    }
+    const parsed = JSON.parse(readFileSync(configPath, 'utf8'));
+    if (typeof parsed.runtimeRoot !== 'string' || parsed.runtimeRoot.trim().length === 0) {
+        return resolve(defaultMoorlineHomePath(), 'runtime');
+    }
+    return resolve(parsed.runtimeRoot);
+}
+function controlApiStateDir(configPath) {
+    return join(runtimeRootForConfigPath(configPath), 'state');
+}
+function controlApiBootstrapPath(configPath) {
+    return join(controlApiStateDir(resolveControlApiConfigPath(configPath)), 'control-api-bootstrap.json');
+}
+export function readControlApiBootstrapRecord(configPath) {
+    const path = controlApiBootstrapPath(configPath);
+    if (!existsSync(path)) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof parsed.pid !== 'number' ||
+            parsed.version !== 1 ||
+            parsed.protocol !== 'http' ||
+            typeof parsed.adapterPackageId !== 'string' ||
+            typeof parsed.url !== 'string' ||
+            typeof parsed.token !== 'string' ||
+            typeof parsed.startedAt !== 'string' ||
+            typeof parsed.configPath !== 'string') {
+            return null;
+        }
+        return {
+            version: 1,
+            protocol: 'http',
+            adapterPackageId: parsed.adapterPackageId,
+            pid: parsed.pid,
+            url: parsed.url,
+            token: parsed.token,
+            startedAt: parsed.startedAt,
+            configPath: parsed.configPath
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function writeControlApiBootstrapRecord(record) {
+    const path = controlApiBootstrapPath(record.configPath);
+    mkdirSync(controlApiStateDir(record.configPath), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
+    chmodSync(path, 0o600);
+}
+export function clearControlApiBootstrapRecord(configPath) {
+    rmSync(controlApiBootstrapPath(configPath), { force: true });
+}
+async function isAuthenticated(url, token) {
+    try {
+        const response = await fetch(`${url.replace(/\/+$/, '')}/api/state/configure`, {
+            headers: {
+                authorization: `Bearer ${token}`
+            }
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export class ApiBootstrapResolver {
+    input;
+    constructor(input) {
+        this.input = input;
+    }
+    async resolveConnection(input = {}) {
+        const configPath = resolveControlApiConfigPath(input.configPath ?? this.input.configPath);
+        const url = input.url ?? process.env.MOORLINE_API_URL;
+        const token = input.token ?? process.env.MOORLINE_API_TOKEN;
+        if (url && token) {
+            return { url, token, configPath };
+        }
+        if (url && !token) {
+            throw new Error('Control API token is required when using a remote --url or MOORLINE_API_URL.');
+        }
+        const record = readControlApiBootstrapRecord(configPath);
+        if (record && (await isAuthenticated(record.url, record.token))) {
+            return {
+                url: record.url,
+                token: record.token,
+                configPath
+            };
+        }
+        const shouldAutoStart = input.autoStart ?? false;
+        if (!shouldAutoStart) {
+            throw new Error('Control API is not available. Start it with `moorline api start` or provide --url and --token.');
+        }
+        if (!this.input.entrypoint) {
+            throw new Error('Control API auto-start requires a Moorline CLI entrypoint.');
+        }
+        const started = await this.startLocalApiInBackground(configPath);
+        return {
+            url: started.url,
+            token: started.token,
+            configPath
+        };
+    }
+    async startLocalApiInBackground(configPath = resolveControlApiConfigPath(this.input.configPath)) {
+        const existing = readControlApiBootstrapRecord(configPath);
+        if (existing && (await isAuthenticated(existing.url, existing.token))) {
+            return existing;
+        }
+        if (!this.input.entrypoint) {
+            throw new Error('Control API auto-start requires a Moorline CLI entrypoint.');
+        }
+        const child = spawn(process.execPath, [this.input.entrypoint, 'api-run-foreground', '--config', configPath], {
+            detached: true,
+            stdio: 'ignore',
+            env: process.env
+        });
+        child.unref();
+        const timeoutAt = Date.now() + 20_000;
+        while (Date.now() < timeoutAt) {
+            const record = readControlApiBootstrapRecord(configPath);
+            if (record && (await isAuthenticated(record.url, record.token))) {
+                return record;
+            }
+            await sleep(250);
+        }
+        throw new Error('Timed out waiting for the Control API to start.');
+    }
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,36 @@
+import type { ControlApiBinaryGetPath, ControlApiBinaryPostPath, ControlApiGetPath, ControlApiPayloadForPath, ControlApiPostPath, ControlApiTextGetPath } from './contracts/routes.js';
+export type MainLifecyclePolicy = 'detached' | 'stop_on_last_lease';
+interface ControlApiClientOptions {
+    url?: string;
+    token?: string;
+    configPath?: string;
+    autoStart?: boolean;
+    entrypoint?: string;
+}
+export interface ControlApiLeaseBinding {
+    leaseId: string;
+    release(): Promise<void>;
+}
+export declare class ControlApiClient {
+    private readonly options;
+    private baseUrl;
+    private token;
+    constructor(options?: ControlApiClientOptions);
+    private ensureConnection;
+    get(path: ControlApiGetPath): Promise<unknown>;
+    post<Path extends ControlApiPostPath>(path: Path, body: ControlApiPayloadForPath<Path>): Promise<unknown>;
+    getText(path: ControlApiTextGetPath): Promise<string>;
+    getBinary(path: ControlApiBinaryGetPath): Promise<{
+        bytes: Uint8Array;
+        contentType: string;
+        contentDisposition: string | null;
+    }>;
+    postBinary(path: ControlApiBinaryPostPath, body: Uint8Array | ArrayBuffer, contentType: string): Promise<unknown>;
+    private request;
+}
+export declare function bindControlApiLease(client: Pick<ControlApiClient, 'post'>, input: {
+    clientName: string;
+    policy: MainLifecyclePolicy;
+    ttlMs?: number;
+}): Promise<ControlApiLeaseBinding>;
+export {};

package/dist/client.js

@@ -0,0 +1,123 @@
+import { ApiBootstrapResolver } from './bootstrap.js';
+export class ControlApiClient {
+    options;
+    baseUrl = null;
+    token = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async ensureConnection() {
+        if (this.baseUrl && this.token) {
+            return;
+        }
+        const resolver = new ApiBootstrapResolver({
+            configPath: this.options.configPath,
+            ...(this.options.entrypoint ? { entrypoint: this.options.entrypoint } : {})
+        });
+        const resolved = await resolver.resolveConnection({
+            url: this.options.url,
+            token: this.options.token,
+            configPath: this.options.configPath,
+            autoStart: this.options.autoStart
+        });
+        this.baseUrl = resolved.url.replace(/\/+$/, '');
+        this.token = resolved.token.trim();
+    }
+    async get(path) {
+        const response = await this.request(path, { method: 'GET' });
+        return response.status === 204 ? null : await response.json();
+    }
+    async post(path, body) {
+        const response = await this.request(path, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json'
+            },
+            body: JSON.stringify(body)
+        });
+        return response.status === 204 ? null : await response.json();
+    }
+    async getText(path) {
+        const response = await this.request(path, { method: 'GET' });
+        return await response.text();
+    }
+    async getBinary(path) {
+        const response = await this.request(path, { method: 'GET' });
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        return {
+            bytes,
+            contentType: response.headers.get('content-type') ?? 'application/octet-stream',
+            contentDisposition: response.headers.get('content-disposition')
+        };
+    }
+    async postBinary(path, body, contentType) {
+        const response = await this.request(path, {
+            method: 'POST',
+            headers: {
+                'content-type': contentType
+            },
+            body
+        });
+        return response.status === 204 ? null : await response.json();
+    }
+    async request(path, init) {
+        await this.ensureConnection();
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            ...init,
+            headers: {
+                authorization: `Bearer ${this.token}`,
+                ...(init.headers ?? {})
+            }
+        });
+        if (!response.ok) {
+            const payload = await response.text();
+            let detail = payload || response.statusText;
+            try {
+                const parsed = JSON.parse(payload);
+                if (typeof parsed.error === 'string' && parsed.error.trim()) {
+                    detail = parsed.error.trim();
+                }
+            }
+            catch {
+                // Keep payload.
+            }
+            throw new Error(`Control API request failed (${response.status} ${path}): ${detail}`);
+        }
+        return response;
+    }
+}
+export async function bindControlApiLease(client, input) {
+    const created = (await client.post('/api/leases/create', {
+        client: input.clientName,
+        policy: input.policy,
+        ...(typeof input.ttlMs === 'number' ? { ttlMs: input.ttlMs } : {})
+    }));
+    if (typeof created.leaseId !== 'string' || created.leaseId.trim().length === 0) {
+        throw new Error('Control API lease creation returned an invalid lease id.');
+    }
+    const leaseId = created.leaseId;
+    const ttlMs = Math.max(5_000, input.ttlMs ?? 30_000);
+    const heartbeatMs = Math.max(1_000, Math.floor(ttlMs / 2));
+    let released = false;
+    const timer = globalThis.setInterval(() => {
+        if (released) {
+            return;
+        }
+        void client.post('/api/leases/heartbeat', { leaseId, ttlMs }).catch(() => undefined);
+    }, heartbeatMs);
+    if (typeof timer.unref === 'function') {
+        timer.unref();
+    }
+    return {
+        leaseId,
+        async release() {
+            if (released) {
+                return;
+            }
+            released = true;
+            clearInterval(timer);
+            await client.post('/api/leases/release', { leaseId }).catch(() => undefined);
+        }
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/contracts/api.d.ts

@@ -0,0 +1,73 @@
+interface ManagementContribution {
+    placement?: string;
+}
+interface ManagementReadModel {
+    overview: {
+        sessions: number;
+        missions: number;
+        pendingRequests: number;
+    };
+    runtime: {
+        status: {
+            runningSessions: number;
+            waitingSessions: number;
+        };
+        control: {
+            acceptingNewWork: boolean;
+        };
+    } & Record<string, unknown>;
+    diagnostics: {
+        runtimeHealth: unknown;
+        recentRuntimeActivities: unknown;
+        recentAuditEvents: unknown;
+    };
+    objects: {
+        managementContributions: ManagementContribution[];
+        sessions: unknown;
+        missions: unknown;
+        pendingRequests: unknown;
+    };
+    setup: unknown;
+    settings: unknown;
+    packages: {
+        catalog?: unknown;
+        installed?: unknown;
+    } & Record<string, unknown>;
+    history: {
+        status?: unknown;
+        entries?: unknown;
+    } & Record<string, unknown>;
+}
+export interface ControlApiState {
+    generatedAt: string;
+    runtimeMode: 'runtime' | 'management_only';
+    readModel: ManagementReadModel;
+    operations: ControlApiOperationsState;
+    configure: ControlApiConfigureState;
+}
+export interface ControlApiOperationsState {
+    summary: {
+        sessions: number;
+        missions: number;
+        pendingRequests: number;
+        runningSessions: number;
+        waitingSessions: number;
+        acceptingNewWork: boolean;
+    };
+    runtime: ManagementReadModel['runtime'];
+    diagnostics: Pick<ManagementReadModel['diagnostics'], 'runtimeHealth' | 'recentRuntimeActivities' | 'recentAuditEvents'>;
+    managementContributions: ManagementReadModel['objects']['managementContributions'];
+    sessions: ManagementReadModel['objects']['sessions'];
+    missions: ManagementReadModel['objects']['missions'];
+    pendingRequests: ManagementReadModel['objects']['pendingRequests'];
+}
+export interface ControlApiConfigureState {
+    setup: ManagementReadModel['setup'];
+    settings: ManagementReadModel['settings'];
+    packages: ManagementReadModel['packages'];
+    history: ManagementReadModel['history'];
+    managementContributions: ManagementReadModel['objects']['managementContributions'];
+}
+export declare function projectOperationsState(model: ManagementReadModel): ControlApiOperationsState;
+export declare function projectConfigureState(model: ManagementReadModel): ControlApiConfigureState;
+export {};

package/dist/contracts/api.js

@@ -0,0 +1,32 @@
+export function projectOperationsState(model) {
+    return {
+        summary: {
+            sessions: model.overview.sessions,
+            missions: model.overview.missions,
+            pendingRequests: model.overview.pendingRequests,
+            runningSessions: model.runtime.status.runningSessions,
+            waitingSessions: model.runtime.status.waitingSessions,
+            acceptingNewWork: model.runtime.control.acceptingNewWork
+        },
+        runtime: model.runtime,
+        diagnostics: {
+            runtimeHealth: model.diagnostics.runtimeHealth,
+            recentRuntimeActivities: model.diagnostics.recentRuntimeActivities,
+            recentAuditEvents: model.diagnostics.recentAuditEvents
+        },
+        managementContributions: model.objects.managementContributions.filter((contribution) => typeof contribution.placement === 'string' && ['overview', 'control', 'work', 'health'].includes(contribution.placement)),
+        sessions: model.objects.sessions,
+        missions: model.objects.missions,
+        pendingRequests: model.objects.pendingRequests
+    };
+}
+export function projectConfigureState(model) {
+    return {
+        setup: model.setup,
+        settings: model.settings,
+        packages: model.packages,
+        history: model.history,
+        managementContributions: model.objects.managementContributions.filter((contribution) => typeof contribution.placement === 'string' && ['packages', 'settings'].includes(contribution.placement))
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/contracts/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../../src/contracts/api.ts"],"names":[],"mappings":"AA2EA,MAAM,UAAU,sBAAsB,CAAC,KAA0B;IAC/D,OAAO;QACL,OAAO,EAAE;YACP,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;YACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ;YACjC,eAAe,EAAE,KAAK,CAAC,QAAQ,CAAC,eAAe;YAC/C,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe;YACrD,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe;YACrD,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB;SACzD;QACD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE;YACX,aAAa,EAAE,KAAK,CAAC,WAAW,CAAC,aAAa;YAC9C,uBAAuB,EAAE,KAAK,CAAC,WAAW,CAAC,uBAAuB;YAClE,iBAAiB,EAAE,KAAK,CAAC,WAAW,CAAC,iBAAiB;SACvD;QACD,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,YAAoC,EAAE,EAAE,CAC7G,OAAO,YAAY,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CACzH;QACD,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;QAChC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;QAChC,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,eAAe;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAA0B;IAC9D,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,YAAoC,EAAE,EAAE,CAC7G,OAAO,YAAY,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CACxG;KACF,CAAC;AACJ,CAAC"}

package/dist/contracts/routes.d.ts

@@ -0,0 +1,118 @@
+import type { PackageKind, PackageSurface } from '@moorline/contracts';
+import { parseControlApiRuntimeMode } from '../validation.js';
+export type ControlApiGetPath = '/api/state' | '/api/main/status' | '/api/state/operations' | '/api/state/configure' | '/api/packages/catalog' | '/api/packages/search' | `/api/packages/search?${string}` | `/api/packages/info?${string}` | '/api/packages/installed' | '/api/history/status' | '/api/history/list' | `/api/history/show?${string}` | '/api/history/diff' | `/api/history/diff?${string}` | '/api/pending-requests/list' | `/api/pending-requests/inspect?${string}` | '/api/management/backup' | `/api/management/backup?${string}`;
+export type ControlApiTextGetPath = '/api/management/diagnostics-export' | '/api/management/setup-export';
+export type ControlApiBinaryGetPath = '/api/management/backup' | `/api/management/backup?${string}`;
+export type ControlApiBinaryPostPath = '/api/management/import';
+export type ControlApiPostPath = '/api/main/start' | '/api/main/stop' | '/api/main/restart' | '/api/shutdown' | '/api/leases/create' | '/api/leases/heartbeat' | '/api/leases/release' | '/api/runtime/accepting' | '/api/runtime/reload' | '/api/provider/test' | '/api/provider/start' | '/api/provider/stop' | '/api/work/session/create' | '/api/work/session/direct' | '/api/work/session/archive' | '/api/work/session/delete' | '/api/work/mission/create' | '/api/work/mission/pause' | '/api/work/mission/resume' | '/api/work/mission/stop' | '/api/work/mission/run' | '/api/work/mission/archive' | '/api/work/mission/delete' | '/api/packages/install' | '/api/packages/remove' | '/api/packages/enable' | '/api/packages/disable' | '/api/packages/activate' | '/api/packages/deactivate' | '/api/packages/select' | '/api/packages/config' | '/api/packages/apply' | '/api/history/snapshot' | '/api/history/restore' | '/api/history/discard' | '/api/pending-requests/resolve' | '/api/pending-requests/answer' | '/api/pending-requests/cancel' | '/api/management/default-model' | '/api/management/config-migration-warning/acknowledge';
+type SessionTargetPayload = {
+    sessionId?: string;
+    spaceId?: string;
+};
+type SpaceSessionTargetPayload = {
+    sessionId?: string;
+    spaceId: string;
+};
+type MissionTargetPayload = {
+    missionId?: string;
+    spaceId: string;
+};
+type RuntimeReloadMode = 'graceful' | 'force';
+export type ControlApiPayloadForPath<Path extends ControlApiPostPath> = Path extends '/api/main/start' | '/api/main/stop' | '/api/main/restart' | '/api/shutdown' ? Record<string, never> : Path extends '/api/leases/create' ? {
+    client?: string;
+    policy?: 'detached' | 'stop_on_last_lease';
+    ttlMs?: number;
+} : Path extends '/api/leases/heartbeat' ? {
+    leaseId: string;
+    ttlMs?: number;
+} : Path extends '/api/leases/release' ? {
+    leaseId: string;
+} : Path extends '/api/runtime/accepting' ? {
+    accepting: boolean;
+} : Path extends '/api/runtime/reload' ? {
+    mode: RuntimeReloadMode;
+} : Path extends '/api/provider/test' ? {
+    sendTurn?: boolean;
+    prompt?: string;
+} : Path extends '/api/provider/start' | '/api/provider/stop' ? {
+    threadId?: string;
+} : Path extends '/api/work/session/create' ? {
+    requestedName: string;
+    runtimeMode: ReturnType<typeof parseControlApiRuntimeMode>;
+    initialInstruction?: string;
+    objective?: string;
+} : Path extends '/api/work/session/direct' ? SessionTargetPayload & {
+    instruction: string;
+    reason?: string;
+} : Path extends '/api/work/session/archive' | '/api/work/session/delete' ? SpaceSessionTargetPayload : Path extends '/api/work/mission/create' ? {
+    title: string;
+    goal: string;
+    schedule: string;
+    runtimeMode: ReturnType<typeof parseControlApiRuntimeMode>;
+    startTime?: string;
+} : Path extends '/api/work/mission/pause' | '/api/work/mission/resume' | '/api/work/mission/stop' | '/api/work/mission/run' | '/api/work/mission/archive' | '/api/work/mission/delete' ? MissionTargetPayload : Path extends '/api/packages/install' ? {
+    kind: PackageKind;
+    surface?: PackageKind;
+    packageId?: string;
+    source?: string;
+} : Path extends '/api/packages/remove' ? {
+    kind: PackageKind;
+    surface?: PackageKind;
+    packageId: string;
+    cascade?: boolean;
+} : Path extends '/api/packages/enable' | '/api/packages/disable' ? {
+    surface: 'plugin' | 'skill';
+    packageId: string;
+} : Path extends '/api/packages/activate' | '/api/packages/deactivate' ? {
+    surface: PackageSurface;
+    packageId: string;
+} : Path extends '/api/packages/select' ? {
+    surface: 'api-adapter' | 'transport' | 'provider';
+    packageId: string | null;
+} : Path extends '/api/packages/config' ? {
+    surface: PackageSurface;
+    packageId: string;
+    values?: Record<string, string>;
+    secretReplacements?: Array<{
+        key: string;
+        value: string;
+    }>;
+} : Path extends '/api/packages/apply' ? Record<string, never> : Path extends '/api/history/snapshot' ? {
+    label: string;
+} : Path extends '/api/history/restore' ? {
+    commitish: string;
+    path?: string;
+} : Path extends '/api/history/discard' ? {
+    path?: string;
+} : Path extends '/api/pending-requests/resolve' ? {
+    requestId: string;
+    decision: 'accept' | 'decline' | 'cancel';
+} : Path extends '/api/pending-requests/answer' ? {
+    requestId: string;
+    answers: Record<string, string | string[]>;
+} : Path extends '/api/pending-requests/cancel' ? {
+    requestId: string;
+} : Path extends '/api/management/default-model' ? {
+    model: string;
+} : Path extends '/api/management/config-migration-warning/acknowledge' ? Record<string, never> : never;
+export type ControlApiPostCommand = {
+    [Path in ControlApiPostPath]: {
+        kind: 'api';
+        path: Path;
+        payload: ControlApiPayloadForPath<Path>;
+    };
+}[ControlApiPostPath];
+export type ControlApiPostRoute = ControlApiPostCommand;
+export declare function parseControlApiPostRoute(pathname: string, rawBody: unknown): ControlApiPostRoute;
+export declare function parseHistoryShowQuery(url: URL): {
+    commitish: string;
+};
+export declare function parseHistoryDiffQuery(url: URL): {
+    from?: string;
+    to?: string;
+    path?: string;
+};
+export declare function parsePendingInspectQuery(url: URL): {
+    requestId: string;
+};
+export {};