@studio-foundation/api 0.3.0-beta.1

package/README.md

@@ -0,0 +1,161 @@
+# @studio-foundation/api
+
+HTTP REST API for Studio. Same engine as the CLI, machine-to-machine interface. Like GitHub is to `git`.
+
+## Role
+
+api wraps the engine in a Fastify server. It handles fire-and-forget pipeline launches, real-time SSE streaming, webhook dispatch, and integration lifecycle (Linear, etc.). The CLI (`studio api start`) is the primary way to run it, but it can also be imported programmatically.
+
+```
+Linear webhook → POST /api/runs → launcher → engine → pipeline run → webhook dispatch
+Slack bot      → POST /api/runs ↗
+CI/CD          → POST /api/runs ↗
+Dashboard      → GET  /api/runs/:id/stream (SSE)
+```
+
+## Starting the server
+
+```bash
+# Via CLI (recommended)
+studio api start
+
+# Standalone (PM2/systemd)
+STUDIO_CWD=/path/to/project node node_modules/.bin/studio-api
+
+# Programmatic
+import { createApi } from '@studio-foundation/api';
+const { server, cleanup } = await createApi({ cwd: '/path/to/project' });
+await server.listen({ port: 3700 });
+```
+
+## Configuration
+
+The server reads `.studio/config.yaml` from the project directory (or the first `.studio/` found walking up from `STUDIO_CWD`):
+
+```yaml
+api:
+  key: my-secret-key   # Optional — enables Bearer auth. Omit for open local use.
+  port: 3700           # Default: 3700
+
+db:
+  type: postgres       # 'sqlite' | 'postgres' | 'inmemory'. Default: 'sqlite'
+  url: ${DATABASE_URL} # Required if type is postgres
+
+providers:
+  anthropic:
+    apiKey: ${ANTHROPIC_API_KEY}
+```
+
+**Authentication:** If `api.key` is set, all routes require `Authorization: Bearer <key>`. Without a key, the API is open (local use only).
+
+## Endpoints
+
+### Runs
+
+```
+POST   /api/runs                → Launch a pipeline (fire-and-forget). Returns run ID immediately.
+GET    /api/runs                → List runs (?status=&limit=)
+GET    /api/runs/:id            → Run detail
+GET    /api/runs/:id/logs       → Raw JSONL logs
+GET    /api/runs/:id/stream     → SSE — live events (?events=csv filter)
+DELETE /api/runs/:id            → Cancel a running pipeline
+```
+
+### Project
+
+```
+GET    /api/projects            → Current project (name, id, pipelines_dir)
+GET    /api/projects/:id/pipelines → Pipelines for a project
+```
+
+### CRUD (Pipelines, Agents, Contracts, Skills)
+
+```
+GET    /api/pipelines           → List pipeline names
+GET    /api/pipelines/:name     → Parsed pipeline (YAML → JSON)
+PUT    /api/pipelines/:name     → Create or update a pipeline (body: YAML or JSON)
+DELETE /api/pipelines/:name     → Delete a pipeline
+
+GET    /api/agents              → List agent names
+GET    /api/agents/:name        → Parsed agent
+PUT    /api/agents/:name        → Create or update an agent
+DELETE /api/agents/:name        → Delete an agent
+
+GET    /api/contracts           → List contract names
+GET    /api/contracts/:name     → Parsed contract
+PUT    /api/contracts/:name     → Create or update a contract
+DELETE /api/contracts/:name     → Delete a contract
+
+GET    /api/skills              → List skill names
+GET    /api/skills/:name        → Skill content (.skill.md)
+PUT    /api/skills/:name        → Create or update a skill (body: markdown)
+DELETE /api/skills/:name        → Delete a skill
+```
+
+### Tools, Config, Validation
+
+```
+GET    /api/tools               → Available tools (YAML plugins + builtins)
+
+GET    /api/config              → Current config (API keys masked)
+PUT    /api/config              → Update config
+
+POST   /api/validate            → Validate a JSON output against a contract
+```
+
+### Webhooks
+
+```
+POST   /api/webhooks            → Register a webhook (url + events filter)
+GET    /api/webhooks            → List webhooks
+DELETE /api/webhooks/:id        → Delete a webhook
+```
+
+### Swagger UI
+
+```
+GET    /api/docs                → Swagger UI (dev only — disabled in NODE_ENV=production)
+GET    /api/docs/json           → OpenAPI spec (for client generation)
+```
+
+## SSE streaming
+
+Connect to `/api/runs/:id/stream` to receive live events:
+
+```javascript
+const es = new EventSource('/api/runs/run-123/stream');
+es.addEventListener('stage_complete', (e) => console.log(JSON.parse(e.data)));
+es.addEventListener('pipeline_complete', (e) => { es.close(); });
+
+// Filter to specific event types:
+// GET /api/runs/:id/stream?events=stage_complete,tool_call_complete
+```
+
+## Integrations
+
+The API manages integration lifecycle (webhook routing, failure handling). Integrations are configured via `.studio/config.yaml` and declared via `.integration.yaml` files in `.studio/integrations/`.
+
+**Linear integration** — drag an issue to "In Progress" → Studio receives the webhook → auto-launches the matching pipeline → posts results as a comment → moves the issue to "Done" on success.
+
+## Sub-pipeline spawning
+
+The API uses `HttpApiSpawner` — a self-referential `RunSpawner` that calls back into the same API to spawn child runs. This is how `studio_run` tool calls work when the engine is running behind the API.
+
+## Bootstrap internals
+
+`bootstrap(cwd)` is the composition root:
+1. Finds `.studio/` by walking up from `cwd`
+2. Loads `config.yaml` (with `${ENV_VAR}` substitution)
+3. Creates `RunStore` based on `db.type` (`SQLiteRunStore` | `PgRunStore` | `InMemoryRunStore`)
+4. Creates `ProviderRegistry`, `ToolRegistry` (loads `.tool.yaml` plugins)
+5. Loads Claude Code plugins (`MCPClient` per server)
+6. Creates `HttpApiSpawner`, `PipelineEngine`, `InProcessLauncher`
+7. Creates `WebhookStore`, `IntegrationStore`, `IntegrationRuntime`
+8. Returns `BootstrapResult` passed to `buildServer()`
+
+## Rules
+
+- **api depends on engine + runner.** It is a composition root, same as cli.
+- **Routes must have complete Swagger schemas** — tags, summary, params, response codes. Without this, routes don't appear in Swagger UI.
+- **The engine is the same.** The API doesn't bypass or wrap the engine — it delegates to `InProcessLauncher`, which calls `PipelineEngine.run()` directly.
+- `studio api start` calls `bootstrap()` then `buildServer()`. The two steps are separate so programmatic users can customize between them.

package/dist/api.d.ts

@@ -0,0 +1,8 @@
+export { bootstrap } from './bootstrap.js';
+export { buildServer } from './server.js';
+export type { ServerDeps, ApiConfig } from './server.js';
+export type { RunLauncher, LaunchConfig } from './launcher.js';
+export { InProcessLauncher, generateRunId } from './launcher.js';
+export { cloneRepo, resolveRepoPath } from './utils/repo-resolver.js';
+export type { RepoResolveOptions } from './utils/repo-resolver.js';
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/api.js

@@ -0,0 +1,6 @@
+// Named exports for programmatic use (CLI, tests)
+export { bootstrap } from './bootstrap.js';
+export { buildServer } from './server.js';
+export { InProcessLauncher, generateRunId } from './launcher.js';
+export { cloneRepo, resolveRepoPath } from './utils/repo-resolver.js';
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,66 @@
+import { type AnyRunStore } from '@studio-foundation/engine';
+import { type RunLauncher } from './launcher.js';
+import type { MaskedConfig } from './server.js';
+import { WebhookStore } from './webhook-store.js';
+import { IntegrationStore } from './integration-store.js';
+import { IntegrationRuntime } from './integration-runtime.js';
+import { type PlansConfig } from './plans.js';
+import { UserStore } from './user-store.js';
+import { PgUserStore } from './user-store-pg.js';
+export interface StudioApiConfig {
+    providers?: {
+        openai?: {
+            apiKey: string;
+        };
+        anthropic?: {
+            apiKey: string;
+        };
+        ollama?: {
+            baseUrl?: string;
+        };
+    };
+    paths?: {
+        projects_dir?: string;
+    };
+    defaults?: {
+        provider?: string;
+        model?: string;
+    };
+    api?: {
+        key?: string;
+        port?: number;
+    };
+    integrations?: Record<string, Record<string, unknown>>;
+    db?: {
+        type?: 'sqlite' | 'postgres' | 'inmemory';
+        url?: string;
+    };
+    plans?: Record<string, {
+        runs_per_day?: number;
+        max_concurrent?: number;
+        max_tokens_per_run?: number;
+        rate_limit_per_minute?: number;
+    }>;
+}
+export interface BootstrapResult {
+    store: AnyRunStore;
+    launcher: RunLauncher;
+    configsDir: string;
+    /** Raw projects_dir from config (may contain ~). Used by route handlers for repo cloning. */
+    projectsDir?: string;
+    projectName: string;
+    apiConfig: {
+        key?: string;
+        port?: number;
+    };
+    cleanup: () => Promise<void>;
+    studioVersion: string;
+    maskedConfig: MaskedConfig;
+    webhookStore: WebhookStore;
+    integrationStore: IntegrationStore;
+    integrationRuntime: IntegrationRuntime;
+    userStore: UserStore | PgUserStore;
+    plans: PlansConfig;
+}
+export declare function bootstrap(cwd?: string): Promise<BootstrapResult>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,2BAA2B,CAAC;AAUnC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5B,SAAS,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/B,MAAM,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/B,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,EAAE,CAAC,EAAE;QACH,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;QAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC;IACnC,KAAK,EAAE,WAAW,CAAC;CACpB;AAkBD,wBAAsB,SAAS,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuKrF"}

package/dist/bootstrap.js

@@ -0,0 +1,193 @@
+// Bootstrap — finds .studio/, loads config, creates engine + store + launcher
+// Same pattern as CLI but without terminal output
+import { resolve, join, dirname } from 'node:path';
+import { access, readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import yaml from 'js-yaml';
+import { SQLiteRunStore, InMemoryRunStore, PgRunStore, } from '@studio-foundation/engine';
+import { createDefaultRegistry, ToolRegistry, loadProjectTools, loadPlugins, loadProjectIntegrations, MCPClient, } from '@studio-foundation/runner';
+import { InProcessLauncher } from './launcher.js';
+import { RunEventBus } from './event-bus.js';
+import { WebhookStore } from './webhook-store.js';
+import { WebhookDispatcher } from './webhook-dispatcher.js';
+import { IntegrationStore } from './integration-store.js';
+import { IntegrationRuntime } from './integration-runtime.js';
+import { HttpApiSpawner } from './spawners/http-api-spawner.js';
+import { resolvePlans } from './plans.js';
+import { UserStore } from './user-store.js';
+import { PgUserStore } from './user-store-pg.js';
+async function findStudioDir(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        const candidate = join(current, '.studio');
+        try {
+            await access(candidate);
+            return candidate;
+        }
+        catch {
+            // not here, go up
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+export async function bootstrap(cwd = process.cwd()) {
+    const studioDir = await findStudioDir(cwd);
+    if (!studioDir) {
+        throw new Error(`No .studio/ directory found from ${cwd}. Run 'studio init' first.`);
+    }
+    // Load config
+    let config = {};
+    try {
+        const raw = await readFile(join(studioDir, 'config.yaml'), 'utf-8');
+        // Resolve env vars
+        const resolved = raw.replace(/\$\{([^}]+)\}/g, (_m, v) => process.env[v.trim()] ?? '');
+        config = yaml.load(resolved) ?? {};
+    }
+    catch {
+        // No config.yaml — use defaults
+    }
+    // Read studio version from api/package.json
+    const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
+    const pkgRaw = await readFile(pkgPath, 'utf-8');
+    const studioVersion = JSON.parse(pkgRaw).version;
+    // Build masked config — provider names only, no API keys
+    const maskedConfig = {
+        defaults: config.defaults,
+        providers: Object.keys(config.providers ?? {}),
+    };
+    const runsDir = join(studioDir, 'runs');
+    const dbType = config.db?.type ?? 'sqlite';
+    // WebhookStore and IntegrationStore are always SQLite — they are separate from RunStore
+    const dbPath = join(studioDir, 'runs', 'runs.db');
+    let store;
+    if (dbType === 'postgres') {
+        const url = config.db?.url;
+        if (!url)
+            throw new Error('db.url is required when db.type is postgres');
+        store = new PgRunStore(url);
+    }
+    else if (dbType === 'inmemory') {
+        store = new InMemoryRunStore();
+    }
+    else {
+        store = new SQLiteRunStore(dbPath);
+    }
+    // UserStore — same DB as run store
+    let userStore;
+    if (dbType === 'postgres') {
+        const url = config.db?.url;
+        if (!url)
+            throw new Error('db.url is required when db.type is postgres');
+        userStore = new PgUserStore(url);
+    }
+    else {
+        userStore = new UserStore(dbPath);
+    }
+    const plans = resolvePlans(config.plans);
+    const providerRegistry = createDefaultRegistry({
+        openai: config.providers?.openai ? { apiKey: config.providers.openai.apiKey } : undefined,
+        anthropic: config.providers?.anthropic ? { apiKey: config.providers.anthropic.apiKey } : undefined,
+        ollama: config.providers?.ollama ? { baseUrl: config.providers.ollama.baseUrl } : undefined,
+    });
+    const toolsDir = join(studioDir, 'tools');
+    const loadedPlugins = await loadProjectTools(toolsDir, cwd);
+    const toolRegistry = new ToolRegistry();
+    for (const plugin of loadedPlugins) {
+        toolRegistry.registerPlugin(plugin.name, plugin.tools, plugin.promptSnippet);
+    }
+    // Load MCP plugins
+    const pluginsDir = join(studioDir, 'plugins');
+    const pluginManifests = await loadPlugins(pluginsDir);
+    const mcpClients = [];
+    const pluginSkills = {};
+    for (const manifest of pluginManifests) {
+        for (const [serverName, serverDef] of Object.entries(manifest.mcpServers)) {
+            const client = new MCPClient(manifest.name, serverName, serverDef);
+            try {
+                await client.start();
+                const mcpTools = await client.getTools();
+                toolRegistry.registerPlugin(`${manifest.name}-${serverName}`, mcpTools);
+                mcpClients.push(client);
+            }
+            catch {
+                // Plugin failed to start — skip silently for API
+            }
+        }
+        if (manifest.skills.length > 0) {
+            pluginSkills[manifest.name] = manifest.skills.map((s) => `## Skill: ${s.name}\n\n${s.content}`);
+        }
+    }
+    // Self-referential spawner: allows pipelines to spawn child runs via the API
+    // Must match DEFAULT_PORT in index.ts (3700) — was 3000 which collides with common dev servers
+    const apiPort = config.api?.port ?? 3700;
+    const spawner = new HttpApiSpawner(`http://localhost:${apiPort}`, config.api?.key);
+    const engineConfig = {
+        configsDir: studioDir,
+        providerRegistry,
+        toolRegistry,
+        db: store,
+        pluginSkills,
+        spawner,
+        maxDepth: 3,
+        defaultProvider: config.defaults?.provider,
+        defaultModel: config.defaults?.model,
+    };
+    const bus = new RunEventBus();
+    const launcher = new InProcessLauncher(engineConfig, store, runsDir, bus);
+    // Derive project name from the directory containing .studio/
+    const projectName = studioDir.split('/').slice(-2, -1)[0] ?? 'studio-project';
+    const webhookStore = new WebhookStore(dbPath);
+    const integrationStore = new IntegrationStore(dbPath);
+    const integrationsDir = join(studioDir, 'integrations');
+    const loadedIntegrations = await loadProjectIntegrations(integrationsDir);
+    const integrationConfigs = (config.integrations ?? {});
+    const integrationRuntime = new IntegrationRuntime({
+        integrations: loadedIntegrations,
+        store: integrationStore,
+        launcher,
+        configsDir: studioDir,
+        projectsDir: config.paths?.projects_dir,
+        apiConfig: config.api ?? {},
+        integrationConfigs,
+    });
+    integrationRuntime.setupEventBus(bus);
+    const webhookDispatcher = new WebhookDispatcher(webhookStore, projectName);
+    bus.subscribeAll((runId, event) => {
+        void webhookDispatcher.handleBusEvent(runId, event.type, event.data);
+    });
+    return {
+        store,
+        launcher,
+        configsDir: studioDir,
+        projectsDir: config.paths?.projects_dir,
+        projectName,
+        apiConfig: config.api ?? {},
+        studioVersion,
+        maskedConfig,
+        webhookStore,
+        integrationStore,
+        integrationRuntime,
+        userStore,
+        plans,
+        cleanup: async () => {
+            for (const client of mcpClients) {
+                try {
+                    await client.close();
+                }
+                catch { /* ignore */ }
+            }
+            if ('close' in store && typeof store.close === 'function') {
+                await store.close();
+            }
+            if (userStore && 'close' in userStore && typeof userStore.close === 'function') {
+                await userStore.close();
+            }
+            webhookStore.close();
+            integrationStore.close();
+        },
+    };
+}
+//# 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/event-bus.d.ts

@@ -0,0 +1,16 @@
+export type SseEventType = 'pipeline_start' | 'stage_start' | 'stage_complete' | 'stage_retry' | 'group_start' | 'group_iteration' | 'group_feedback' | 'group_complete' | 'pipeline_complete' | 'pipeline_cancelled' | 'stage_context' | 'tool_call_start' | 'tool_call_complete' | 'done';
+export interface BusEvent {
+    type: SseEventType;
+    data: unknown;
+}
+export type BusListener = (event: BusEvent) => void;
+export type GlobalBusListener = (runId: string, event: BusEvent) => void;
+export declare class RunEventBus {
+    private subs;
+    private globalListeners;
+    subscribe(runId: string, listener: BusListener): () => void;
+    subscribeAll(listener: GlobalBusListener): () => void;
+    emit(runId: string, type: SseEventType, data: unknown): void;
+    close(runId: string): void;
+}
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,aAAa,GACb,aAAa,GACb,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,GACpB,eAAe,GACf,iBAAiB,GACjB,oBAAoB,GACpB,MAAM,CAAC;AAEX,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AACpD,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEzE,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,eAAe,CAAgC;IAEvD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,IAAI;IAW3D,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAOrD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAa5D,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAI3B"}

package/dist/event-bus.js

@@ -0,0 +1,37 @@
+export class RunEventBus {
+    subs = new Map();
+    globalListeners = new Set();
+    subscribe(runId, listener) {
+        if (!this.subs.has(runId)) {
+            this.subs.set(runId, new Set());
+        }
+        this.subs.get(runId).add(listener);
+        return () => {
+            this.subs.get(runId)?.delete(listener);
+        };
+    }
+    // Global subscription — receives all events across all runs
+    subscribeAll(listener) {
+        this.globalListeners.add(listener);
+        return () => {
+            this.globalListeners.delete(listener);
+        };
+    }
+    emit(runId, type, data) {
+        const event = { type, data };
+        const listeners = this.subs.get(runId);
+        if (listeners) {
+            for (const listener of listeners) {
+                listener(event);
+            }
+        }
+        for (const listener of this.globalListeners) {
+            listener(runId, event);
+        }
+    }
+    close(runId) {
+        this.emit(runId, 'done', {});
+        this.subs.delete(runId);
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../src/event-bus.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,WAAW;IACd,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAC3C,eAAe,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEvD,SAAS,CAAC,KAAa,EAAE,QAAqB;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,YAAY,CAAC,QAA2B;QACtC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,IAAkB,EAAE,IAAa;QACnD,MAAM,KAAK,GAAa,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,SAAS,EAAE,CAAC;YACd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+// Standalone entrypoint for @studio/api
+// PM2: pm2 start node_modules/.bin/studio-api --env STUDIO_CWD=/path/to/project
+// systemd: ExecStart=/usr/bin/node /path/to/api/dist/index.js
+import { bootstrap } from './bootstrap.js';
+import { buildServer } from './server.js';
+const DEFAULT_PORT = 3700;
+async function main() {
+    const cwd = process.env['STUDIO_CWD'] ?? process.cwd();
+    let result;
+    try {
+        result = await bootstrap(cwd);
+    }
+    catch (err) {
+        console.error('Bootstrap failed:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+    const { store, launcher, configsDir, projectName, apiConfig, cleanup, studioVersion, maskedConfig, webhookStore, integrationStore, integrationRuntime, userStore, plans } = result;
+    const port = apiConfig.port ?? DEFAULT_PORT;
+    let hasUsers = false;
+    try {
+        // listUsers() is sync on UserStore and async on PgUserStore; await handles both
+        const users = await userStore.listUsers();
+        hasUsers = users.length > 0;
+    }
+    catch {
+        // DB unavailable at startup — default to open/dev mode
+    }
+    const server = buildServer({ store, launcher, configsDir, projectName, apiConfig, studioVersion, maskedConfig, webhookStore, integrationStore, integrationRuntime, userStore, plans, hasUsers });
+    // Graceful shutdown
+    const shutdown = async () => {
+        await server.close();
+        await cleanup();
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => void shutdown());
+    process.on('SIGINT', () => void shutdown());
+    try {
+        await server.listen({ port, host: '0.0.0.0' });
+        console.log(`Studio API listening on port ${port}`);
+        if (!apiConfig.key) {
+            console.log('Warning: no api.key configured — running without auth');
+        }
+    }
+    catch (err) {
+        console.error('Failed to start server:', err);
+        await cleanup();
+        process.exit(1);
+    }
+}
+void main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,wCAAwC;AACxC,gFAAgF;AAChF,8DAA8D;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,KAAK,UAAU,IAAI;IACjB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEvD,IAAI,MAA6C,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACnL,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,YAAY,CAAC;IAE5C,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC;QACH,gFAAgF;QAChF,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;QAC1C,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEjM,oBAAoB;IACpB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC"}

package/dist/integration-runtime.d.ts

@@ -0,0 +1,22 @@
+import type { FastifyInstance } from 'fastify';
+import type { IntegrationPluginDef } from '@studio-foundation/contracts';
+import type { IntegrationStore } from './integration-store.js';
+import type { RunLauncher } from './launcher.js';
+import type { RunEventBus } from './event-bus.js';
+import type { ApiConfig } from './server.js';
+export interface IntegrationRuntimeDeps {
+    integrations: IntegrationPluginDef[];
+    store: IntegrationStore;
+    launcher: RunLauncher;
+    configsDir: string;
+    projectsDir?: string;
+    apiConfig: ApiConfig;
+    integrationConfigs: Record<string, Record<string, unknown>>;
+}
+export declare class IntegrationRuntime {
+    private deps;
+    constructor(deps: IntegrationRuntimeDeps);
+    setupEventBus(bus: RunEventBus): void;
+    registerRoutes(fastify: FastifyInstance, prefix: string): void;
+}
+//# sourceMappingURL=integration-runtime.d.ts.map

package/dist/integration-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-runtime.d.ts","sourceRoot":"","sources":["../src/integration-runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,oBAAoB,EAAE,CAAC;IACrC,KAAK,EAAE,gBAAgB,CAAC;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC7D;AAED,qBAAa,kBAAkB;IACjB,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,sBAAsB;IAEhD,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAiCrC,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA0H/D"}