@amalgm/apps 0.1.0

package/dist/identity.js

@@ -0,0 +1,59 @@
+import crypto from 'node:crypto';
+import os from 'node:os';
+import path from 'node:path';
+import { resolveProductStateDir } from '@amalgm/core/identity';
+import { APP_REF_PATTERN } from '@amalgm/core/transport';
+const REF_ALPHABET = 'abcdefghijklmnopqrstuvwxyz0123456789';
+function defaultStateDir(env = process.env, scope) {
+    return resolveProductStateDir({
+        product: 'apps',
+        primitive: 'apps',
+        env,
+        homedir: path.join(os.homedir(), '.amalgm'),
+        scope,
+    });
+}
+function allocatePort(store, preferred, minimum, maximum) {
+    const apps = store.listApps();
+    if (preferred !== undefined) {
+        const port = Number(preferred);
+        if (!Number.isInteger(port) || port < 1 || port > 65535) {
+            throw new Error('port must be between 1 and 65535');
+        }
+        if (apps.some((app) => app.port === port))
+            throw new Error(`Port is already registered: ${port}`);
+        return port;
+    }
+    const used = new Set(apps.map((app) => app.port));
+    for (let port = minimum; port <= maximum; port += 1) {
+        if (!used.has(port))
+            return port;
+    }
+    throw new Error('No app ports are available');
+}
+function allocateRef(store) {
+    const used = new Set(store.listApps().map((app) => app.appRef));
+    for (let attempt = 0; attempt < 20; attempt += 1) {
+        let candidate = '';
+        while (candidate.length < 12) {
+            for (const byte of crypto.randomBytes(16)) {
+                if (byte >= 252)
+                    continue;
+                candidate += REF_ALPHABET[byte % REF_ALPHABET.length];
+                if (candidate.length === 12)
+                    break;
+            }
+        }
+        if (!used.has(candidate))
+            return candidate;
+    }
+    throw new Error('Could not allocate an app ref');
+}
+function assertAppRef(value) {
+    if (!APP_REF_PATTERN.test(String(value || ''))) {
+        throw new Error('app ref must contain 8-24 lowercase letters or digits');
+    }
+    return String(value);
+}
+export { APP_REF_PATTERN, allocatePort, allocateRef, assertAppRef, defaultStateDir, };
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { Apps, defaultStateDir } from './apps.js';
+export { runCli } from './cli.js';
+export * from './lease.js';
+export { normalizeManifest, readManifest } from './manifest.js';
+export { createMcpTools } from './mcp.js';
+export { createMcpServer } from './mcp-server.js';
+export { inspectPackage, materialize, packPackage, unpackPackage, validatePackageFiles, } from './package.js';
+export type * from './types.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+export { Apps, defaultStateDir } from './apps.js';
+export { runCli } from './cli.js';
+export * from './lease.js';
+export { normalizeManifest, readManifest } from './manifest.js';
+export { createMcpTools } from './mcp.js';
+export { createMcpServer } from './mcp-server.js';
+export { inspectPackage, materialize, packPackage, unpackPackage, validatePackageFiles, } from './package.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/dist/lease.d.ts

@@ -0,0 +1,30 @@
+declare const DEFAULT_HEARTBEAT_INTERVAL_MS = 30000;
+interface AppGrants {
+    appId: string | null;
+    appRef: string | null;
+    publicUrl: string | null;
+    dataDir: string | null;
+    port: number | null;
+    runtimeUrl: string | null;
+    chatServerUrl: string | null;
+}
+interface LeaseResult extends Record<string, unknown> {
+    ok: boolean;
+    error?: string;
+}
+interface ConnectOptions {
+    heartbeatIntervalMs?: number;
+    onError?: (error: Error) => unknown;
+}
+interface AppLease {
+    active: boolean;
+    stop(): void;
+}
+type AppEnvironment = Record<string, string | undefined>;
+declare function grants(env?: AppEnvironment): AppGrants;
+declare function isManaged(env?: AppEnvironment): boolean;
+declare function ready(options?: Pick<ConnectOptions, 'heartbeatIntervalMs'>, env?: AppEnvironment): Promise<LeaseResult>;
+declare function heartbeat(env?: AppEnvironment): Promise<LeaseResult>;
+declare function connect(options?: ConnectOptions, env?: AppEnvironment): AppLease;
+export { DEFAULT_HEARTBEAT_INTERVAL_MS, connect, grants, heartbeat, isManaged, ready, };
+export type { AppEnvironment, AppGrants, AppLease, ConnectOptions, LeaseResult };

package/dist/lease.js

@@ -0,0 +1,82 @@
+import { runtimeTokenFromEnv, withRuntimeToken } from '@amalgm/core/transport';
+const REQUEST_TIMEOUT_MS = 3_000;
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;
+function grants(env = process.env) {
+    return {
+        appId: env.AMALGM_APP_ID || null,
+        appRef: env.AMALGM_APP_REF || null,
+        publicUrl: env.AMALGM_APP_URL || null,
+        dataDir: env.AMALGM_APP_DATA_DIR || null,
+        port: env.PORT ? Number(env.PORT) : null,
+        runtimeUrl: env.AMALGM_MCP_URL || null,
+        chatServerUrl: env.AMALGM_CHAT_SERVER_URL || null,
+    };
+}
+function isManaged(env = process.env) {
+    const issued = grants(env);
+    return Boolean(issued.appId && issued.runtimeUrl);
+}
+async function post(pathname, body, env = process.env) {
+    const issued = grants(env);
+    if (!issued.appId || !issued.runtimeUrl) {
+        return { ok: false, error: 'not managed by an Amalgm runtime' };
+    }
+    const headers = withRuntimeToken({ 'content-type': 'application/json' }, runtimeTokenFromEnv(env));
+    try {
+        const response = await fetch(new URL(pathname, issued.runtimeUrl), {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ app_id: issued.appId, ...body }),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        const payload = await response.json().catch(() => ({}));
+        if (!response.ok)
+            return { ok: false, error: String(payload.error || `runtime answered ${response.status}`) };
+        return { ...payload, ok: payload.ok !== false };
+    }
+    catch (error) {
+        return { ok: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}
+function ready(options = {}, env = process.env) {
+    return post('/apps/ready', {
+        ...(options.heartbeatIntervalMs
+            ? { heartbeat_interval_ms: options.heartbeatIntervalMs }
+            : {}),
+    }, env);
+}
+function heartbeat(env = process.env) {
+    return post('/apps/heartbeat', {}, env);
+}
+function connect(options = {}, env = process.env) {
+    if (!isManaged(env))
+        return { active: false, stop() { } };
+    const intervalMs = Number(options.heartbeatIntervalMs) || DEFAULT_HEARTBEAT_INTERVAL_MS;
+    const onError = typeof options.onError === 'function' ? options.onError : null;
+    let failing = false;
+    const report = (result) => {
+        if (result.ok) {
+            failing = false;
+            return;
+        }
+        if (failing)
+            return;
+        failing = true;
+        const error = new Error(result.error || 'health announcement failed');
+        if (onError)
+            onError(error);
+        else
+            console.warn(`[amalgm/apps] ${error.message}`);
+    };
+    ready({ heartbeatIntervalMs: intervalMs }, env).then(report);
+    const timer = setInterval(() => heartbeat(env).then(report), intervalMs);
+    timer.unref?.();
+    return {
+        active: true,
+        stop() {
+            clearInterval(timer);
+        },
+    };
+}
+export { DEFAULT_HEARTBEAT_INTERVAL_MS, connect, grants, heartbeat, isManaged, ready, };
+//# sourceMappingURL=lease.js.map

package/dist/lease.js.map

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

package/dist/logs.d.ts

@@ -0,0 +1,11 @@
+import { Writable } from 'node:stream';
+declare const DEFAULT_MAX_LOG_BYTES: number;
+declare class CappedLog extends Writable {
+    private remaining;
+    private readonly output;
+    constructor(file: string, maxBytes?: number);
+    _write(chunk: Buffer, encoding: BufferEncoding, callback: (error?: Error | null) => void): void;
+    _final(callback: (error?: Error | null) => void): void;
+    _destroy(error: Error | null, callback: (error?: Error | null) => void): void;
+}
+export { CappedLog, DEFAULT_MAX_LOG_BYTES };

package/dist/logs.js

@@ -0,0 +1,40 @@
+import fs from 'node:fs';
+import { Writable } from 'node:stream';
+const DEFAULT_MAX_LOG_BYTES = 10 * 1024 * 1024;
+function rotate(file, maxBytes) {
+    const size = fs.existsSync(file) ? fs.statSync(file).size : 0;
+    if (size < maxBytes)
+        return size;
+    const previous = `${file}.1`;
+    fs.rmSync(previous, { force: true });
+    fs.renameSync(file, previous);
+    return 0;
+}
+class CappedLog extends Writable {
+    remaining;
+    output;
+    constructor(file, maxBytes = DEFAULT_MAX_LOG_BYTES) {
+        super();
+        this.remaining = maxBytes - rotate(file, maxBytes);
+        this.output = fs.createWriteStream(file, { flags: 'a' });
+        this.output.on('error', (error) => this.destroy(error));
+    }
+    _write(chunk, encoding, callback) {
+        if (this.remaining <= 0) {
+            callback();
+            return;
+        }
+        const content = chunk.length > this.remaining ? chunk.subarray(0, this.remaining) : chunk;
+        this.remaining -= content.length;
+        this.output.write(content, encoding, callback);
+    }
+    _final(callback) {
+        this.output.end(callback);
+    }
+    _destroy(error, callback) {
+        this.output.destroy();
+        callback(error);
+    }
+}
+export { CappedLog, DEFAULT_MAX_LOG_BYTES };
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,qBAAqB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,IAAI,GAAG,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,CAAC;IAC7B,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,SAAU,SAAQ,QAAQ;IACtB,SAAS,CAAS;IACT,MAAM,CAAc;IAErC,YAAY,IAAY,EAAE,QAAQ,GAAG,qBAAqB;QACxD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CACJ,KAAa,EACb,QAAwB,EACxB,QAAwC;QAExC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;YACxB,QAAQ,EAAE,CAAC;YACX,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC1F,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,QAAwC;QAC7C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED,QAAQ,CAAC,KAAmB,EAAE,QAAwC;QACpE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;CACF;AAED,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,6 @@
+import type { AppManifest } from './types.js';
+declare const MANIFEST_FILE = "amalgm.app.json";
+declare const SCHEMA_VERSION = 1;
+declare function normalizeManifest(value: unknown): AppManifest;
+declare function readManifest(rootDir: string): AppManifest;
+export { MANIFEST_FILE, SCHEMA_VERSION, normalizeManifest, readManifest, };

package/dist/manifest.js

@@ -0,0 +1,105 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { errorMessage } from './boundaries.js';
+const MANIFEST_FILE = 'amalgm.app.json';
+const SCHEMA_VERSION = 1;
+const FIELDS = new Set([
+    'schemaVersion',
+    'name',
+    'description',
+    'buildCommand',
+    'startCommand',
+    'toolIds',
+    'package',
+]);
+const PACKAGE_FIELDS = new Set(['include', 'exclude']);
+function object(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function string(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function strings(value, field, errors, optional = false) {
+    if (value === undefined && optional)
+        return [];
+    if (!Array.isArray(value)) {
+        errors.push(`${field} must be an array of strings`);
+        return [];
+    }
+    const result = [];
+    value.forEach((entry, index) => {
+        const item = string(entry);
+        if (!item)
+            errors.push(`${field}[${index}] must be a non-empty string`);
+        else if (!result.includes(item))
+            result.push(item);
+    });
+    return result;
+}
+function unknown(value, allowed, prefix = '') {
+    if (!object(value))
+        return [];
+    return Object.keys(value)
+        .filter((key) => !allowed.has(key))
+        .map((key) => `${prefix}${key} is not supported`);
+}
+function normalizeManifest(value) {
+    if (!object(value))
+        throw new Error(`${MANIFEST_FILE} must contain an object`);
+    const errors = unknown(value, FIELDS);
+    if (value.schemaVersion !== SCHEMA_VERSION) {
+        errors.push(`schemaVersion must be ${SCHEMA_VERSION}`);
+    }
+    const name = string(value.name);
+    if (!name)
+        errors.push('name must be a non-empty string');
+    const description = value.description === undefined ? '' : string(value.description);
+    if (value.description !== undefined && typeof value.description !== 'string') {
+        errors.push('description must be a string');
+    }
+    const buildCommand = value.buildCommand == null ? null : string(value.buildCommand);
+    if (value.buildCommand != null && !buildCommand) {
+        errors.push('buildCommand must be a non-empty string or null');
+    }
+    const startCommand = string(value.startCommand);
+    if (!startCommand)
+        errors.push('startCommand must be a non-empty string');
+    const toolIds = strings(value.toolIds, 'toolIds', errors, true);
+    if (!object(value.package))
+        errors.push('package must be an object');
+    else
+        errors.push(...unknown(value.package, PACKAGE_FIELDS, 'package.'));
+    const packageDefinition = object(value.package) ? value.package : {};
+    const include = strings(packageDefinition.include, 'package.include', errors);
+    const exclude = strings(packageDefinition.exclude, 'package.exclude', errors, true);
+    if (include.length === 0)
+        errors.push('package.include must select at least one app file');
+    if (errors.length) {
+        throw new Error(`${MANIFEST_FILE} is invalid:\n- ${errors.join('\n- ')}`);
+    }
+    return {
+        schemaVersion: SCHEMA_VERSION,
+        name,
+        description,
+        buildCommand,
+        startCommand,
+        toolIds,
+        package: { include, exclude },
+    };
+}
+function readManifest(rootDir) {
+    const file = path.join(path.resolve(rootDir), MANIFEST_FILE);
+    if (!fs.existsSync(file))
+        throw new Error(`${MANIFEST_FILE} is required: ${file}`);
+    try {
+        return normalizeManifest(JSON.parse(fs.readFileSync(file, 'utf8')));
+    }
+    catch (error) {
+        const message = errorMessage(error);
+        if (message.startsWith(`${MANIFEST_FILE} is invalid`))
+            throw error;
+        throw new Error(`${MANIFEST_FILE} is not valid JSON: ${message}`);
+    }
+}
+export { MANIFEST_FILE, SCHEMA_VERSION, normalizeManifest, readManifest, };
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer, McpServerOptions } from './types.js';
+declare function createMcpServer(options?: McpServerOptions): McpServer;
+export { createMcpServer };

package/dist/mcp-server.js

@@ -0,0 +1,65 @@
+import readline from 'node:readline';
+import { Apps } from './apps.js';
+import { createMcpTools } from './mcp.js';
+import { errorCode } from './boundaries.js';
+function descriptor(tool) {
+    const { handler, ...definition } = tool;
+    return definition;
+}
+function createMcpServer(options = {}) {
+    const apps = options.apps || new Apps(options);
+    const tools = createMcpTools(apps);
+    const byName = new Map(tools.map((tool) => [tool.name, tool]));
+    async function handle(message) {
+        if (message.method === 'initialize') {
+            return {
+                protocolVersion: message.params?.protocolVersion || '2024-11-05',
+                capabilities: { tools: { listChanged: false } },
+                serverInfo: { name: 'amalgm-apps', version: '0.1.0' },
+            };
+        }
+        if (message.method === 'ping')
+            return {};
+        if (message.method === 'tools/list')
+            return { tools: tools.map(descriptor) };
+        if (message.method === 'tools/call') {
+            const tool = byName.get(message.params?.name);
+            if (!tool)
+                throw Object.assign(new Error(`Unknown tool: ${message.params?.name}`), { code: -32602 });
+            return tool.handler(message.params?.arguments || {});
+        }
+        if (message.method?.startsWith('notifications/'))
+            return undefined;
+        throw Object.assign(new Error(`Method not found: ${message.method}`), { code: -32601 });
+    }
+    async function start(input = process.stdin, output = process.stdout) {
+        await apps.boot();
+        const lines = readline.createInterface({ input, crlfDelay: Infinity });
+        lines.on('line', async (line) => {
+            let message;
+            try {
+                message = JSON.parse(line);
+                const result = await handle(message);
+                if (message.id === undefined || result === undefined)
+                    return;
+                output.write(`${JSON.stringify({ jsonrpc: '2.0', id: message.id, result })}\n`);
+            }
+            catch (error) {
+                if (message?.id === undefined)
+                    return;
+                output.write(`${JSON.stringify({
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    error: {
+                        code: errorCode(error) || -32603,
+                        message: error instanceof Error ? error.message : String(error),
+                    },
+                })}\n`);
+            }
+        });
+        return lines;
+    }
+    return { apps, handle, start, tools };
+}
+export { createMcpServer };
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,4 @@
+import type { Apps } from './apps.js';
+import type { McpTool } from './types.js';
+declare function createMcpTools(apps: Apps): McpTool[];
+export { createMcpTools };

package/dist/mcp.js

@@ -0,0 +1,171 @@
+function text(value) {
+    return {
+        content: [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }],
+    };
+}
+function createMcpTools(apps) {
+    const action = (definition, handler) => ({
+        ...definition,
+        async handler(args = {}) {
+            try {
+                return text(await handler(args));
+            }
+            catch (error) {
+                return { ...text(error instanceof Error ? error.message : String(error)), isError: true };
+            }
+        },
+    });
+    const id = {
+        app_id: { type: 'string', description: 'Stable app id' },
+    };
+    return [
+        action({
+            name: 'apps_register',
+            description: 'Register, build, and start an app from a directory containing amalgm.app.json.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['cwd'],
+                properties: {
+                    cwd: { type: 'string' },
+                    port: { type: 'integer' },
+                    connect_dns: { type: 'boolean' },
+                    autostart: { type: 'boolean' },
+                    keep_alive: { type: 'boolean' },
+                },
+            },
+        }, (args) => apps.register(args)),
+        action({
+            name: 'apps_validate',
+            description: 'Validate and inspect an app package without changing state.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['cwd'],
+                properties: { cwd: { type: 'string' } },
+            },
+        }, ({ cwd }) => apps.validate(cwd)),
+        action({
+            name: 'apps_list',
+            description: 'List registered apps and their active releases.',
+            inputSchema: { type: 'object', additionalProperties: false, properties: {} },
+        }, () => apps.list()),
+        action({
+            name: 'apps_show',
+            description: 'Get one registered app.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => {
+            const app = apps.get(app_id);
+            if (!app)
+                throw new Error(`App not found: ${app_id}`);
+            return app;
+        }),
+        action({
+            name: 'apps_deploy',
+            description: 'Build an immutable release and activate it. The current process stays up through the build.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: { ...id, cwd: { type: 'string' } },
+            },
+        }, ({ app_id, cwd }) => apps.deploy(app_id, { cwd })),
+        action({
+            name: 'apps_versions',
+            description: 'List immutable releases for an app.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.versions(app_id)),
+        action({
+            name: 'apps_deployments',
+            description: 'List append-only deployment history for an app.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.deployments(app_id)),
+        action({
+            name: 'apps_rollback',
+            description: 'Activate an earlier immutable release as a new deployment.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: { ...id, release_id: { type: 'string' } },
+            },
+        }, ({ app_id, release_id }) => apps.rollback(app_id, { releaseId: release_id })),
+        action({
+            name: 'apps_rename',
+            description: 'Rename an app without changing its id, route, or releases.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id', 'name'],
+                properties: { ...id, name: { type: 'string' } },
+            },
+        }, ({ app_id, name }) => apps.rename(app_id, name)),
+        action({
+            name: 'apps_start',
+            description: 'Start the active deployment.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.start(app_id)),
+        action({
+            name: 'apps_stop',
+            description: 'Stop an app and preserve its releases.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.stop(app_id)),
+        action({
+            name: 'apps_connect_dns',
+            description: 'Make a running healthy app eligible for route publication.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.connectDns(app_id)),
+        action({
+            name: 'apps_disconnect_dns',
+            description: 'Remove route eligibility without stopping the app.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.disconnectDns(app_id)),
+        action({
+            name: 'apps_delete',
+            description: 'Stop and delete an app, its releases, deployments, logs, and data.',
+            inputSchema: {
+                type: 'object',
+                additionalProperties: false,
+                required: ['app_id'],
+                properties: id,
+            },
+        }, ({ app_id }) => apps.delete(app_id)),
+    ];
+}
+export { createMcpTools };
+//# sourceMappingURL=mcp.js.map