@av-pi-studio/server 0.0.1

package/dist/config/daemon-config.js

@@ -0,0 +1,258 @@
+import { existsSync } from "node:fs";
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+/**
+ * Daemon config (`$PI_STUDIO_HOME/config.json`) — architecture/config.md § Daemon config,
+ * § Env precedence, § Behavior; MAIN-SCOPE.md §6.
+ *
+ * Every field is optional with a sensible default, so a missing or `{}` config yields a fully
+ * populated object. Legacy shapes (`allowedHosts`, provider `command:{mode,…}`) are normalized
+ * inline on load (no migration framework). Environment variables overlay the parsed config (env
+ * wins) for the keys enumerated in config.md.
+ */
+// ---------------------------------------------------------------------------
+// Provider overrides (agents.providers.{id})
+// ---------------------------------------------------------------------------
+/** Provider ids: `/^[a-z][a-z0-9-]*$/`. */
+export const providerIdSchema = z.string().regex(/^[a-z][a-z0-9-]*$/, "invalid provider id");
+/** A custom Pi-compatible provider profile, or an override of the built-in `pi` provider. */
+export const providerOverrideSchema = z.object({
+    extends: z.literal("pi").optional(),
+    label: z.string().optional(),
+    description: z.string().optional(),
+    command: z.array(z.string()).optional(),
+    env: z.record(z.string(), z.string()).optional(),
+    params: z.record(z.string(), z.unknown()).optional(),
+    models: z.array(z.unknown()).optional(),
+    additionalModels: z.array(z.unknown()).optional(),
+    disallowedTools: z.array(z.string()).optional(),
+    enabled: z.boolean().optional(),
+    order: z.number().optional(),
+});
+/** The only built-in provider id; everything else under `agents.providers` is a custom profile. */
+const BUILTIN_PROVIDER_IDS = new Set(["pi"]);
+/**
+ * `agents.providers` map. Keys must match the provider-id pattern. A *custom* profile (any id other
+ * than a built-in) must declare `extends:"pi"` and a `label`; overriding the built-in `pi` does not.
+ */
+export const providersRecordSchema = z
+    .record(providerIdSchema, providerOverrideSchema)
+    .superRefine((record, ctx) => {
+    for (const [id, override] of Object.entries(record)) {
+        if (BUILTIN_PROVIDER_IDS.has(id))
+            continue;
+        if (override.extends !== "pi") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `custom provider "${id}" must set extends:"pi"`,
+                path: [id, "extends"],
+            });
+        }
+        if (!override.label) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `custom provider "${id}" must set a label`,
+                path: [id, "label"],
+            });
+        }
+    }
+});
+export const metadataGenerationProviderSchema = z.object({
+    provider: z.string(),
+    model: z.string().optional(),
+    thinkingOptionId: z.string().optional(),
+});
+// ---------------------------------------------------------------------------
+// PersistedConfigSchema
+// ---------------------------------------------------------------------------
+const hostnamesSchema = z.union([z.literal(true), z.array(z.string())]);
+export const persistedConfigSchema = z
+    .object({
+    version: z.number().default(1),
+    daemon: z
+        .object({
+        listen: z.string().default("127.0.0.1:6767"),
+        hostnames: hostnamesSchema.default(["localhost", "*.localhost"]),
+        mcp: z
+            .object({
+            enabled: z.boolean().default(true),
+            injectIntoAgents: z.boolean().default(true),
+        })
+            .default({}),
+        appendSystemPrompt: z.string().default(""),
+        cors: z.object({ allowedOrigins: z.array(z.string()).default([]) }).default({}),
+        relay: z
+            .object({
+            enabled: z.boolean().default(false),
+            endpoint: z.string().optional(),
+            publicEndpoint: z.string().optional(),
+            useTls: z.boolean().default(false),
+            publicUseTls: z.boolean().default(false),
+        })
+            .default({}),
+        auth: z.object({ password: z.string().optional() }).default({}),
+        serviceProxy: z
+            .object({
+            listen: z.string().optional(),
+            publicBaseUrl: z.string().optional(),
+            enabled: z.boolean().optional(),
+        })
+            .default({}),
+    })
+        .default({}),
+    app: z.object({ baseUrl: z.string().optional() }).default({}),
+    worktrees: z.object({ root: z.string().optional() }).default({}),
+    providers: z
+        .object({ local: z.object({ modelsDir: z.string().optional() }).default({}) })
+        .default({}),
+    agents: z
+        .object({
+        providers: providersRecordSchema.default({}),
+        metadataGeneration: z
+            .object({ providers: z.array(metadataGenerationProviderSchema).default([]) })
+            .default({}),
+    })
+        .default({}),
+    log: z
+        .object({
+        level: z.string().default("info"),
+        format: z.string().default("json"),
+        console: z.record(z.string(), z.unknown()).default({}),
+        file: z
+            .object({
+            level: z.string().optional(),
+            path: z.string().optional(),
+            rotate: z
+                .object({ maxSize: z.string().optional(), maxFiles: z.number().optional() })
+                .default({}),
+        })
+            .default({}),
+    })
+        .default({}),
+})
+    .default({});
+// ---------------------------------------------------------------------------
+// Legacy normalization (inline; no migration framework)
+// ---------------------------------------------------------------------------
+/**
+ * Migrate a legacy provider override. The old `command` was an object `{ mode, command?, args? }`;
+ * the current shape is a `string[]`. The `mode` wrapper is dropped (rpc is implicit).
+ *
+ * COMPAT(legacy-provider-command): inline; remove when no config.json carries the object form.
+ */
+function migrateProviderSettings(value) {
+    if (!value || typeof value !== "object")
+        return value;
+    const override = { ...value };
+    const command = override.command;
+    if (command && !Array.isArray(command) && typeof command === "object") {
+        const legacy = command;
+        const base = typeof legacy.command === "string"
+            ? [legacy.command]
+            : Array.isArray(legacy.command)
+                ? legacy.command
+                : [];
+        const args = Array.isArray(legacy.args) ? legacy.args : [];
+        const merged = [...base, ...args].filter((part) => typeof part === "string");
+        if (merged.length > 0)
+            override.command = merged;
+        else
+            delete override.command;
+    }
+    return override;
+}
+/** Normalize a raw config object before schema validation. */
+export function migrateConfig(raw) {
+    const root = { ...raw };
+    const daemon = { ...root.daemon };
+    // COMPAT(legacy-allowed-hosts): `allowedHosts` → `hostnames` (daemon-level or top-level).
+    if (daemon.hostnames === undefined) {
+        if (daemon.allowedHosts !== undefined)
+            daemon.hostnames = daemon.allowedHosts;
+        else if (root.allowedHosts !== undefined)
+            daemon.hostnames = root.allowedHosts;
+    }
+    delete daemon.allowedHosts;
+    delete root.allowedHosts;
+    root.daemon = daemon;
+    const agents = { ...root.agents };
+    const providers = agents.providers;
+    if (providers && typeof providers === "object" && !Array.isArray(providers)) {
+        const migrated = {};
+        for (const [id, override] of Object.entries(providers)) {
+            migrated[id] = migrateProviderSettings(override);
+        }
+        agents.providers = migrated;
+    }
+    if (Object.keys(agents).length > 0)
+        root.agents = agents;
+    return root;
+}
+function envBool(value) {
+    const v = value.trim().toLowerCase();
+    return v === "1" || v === "true" || v === "yes" || v === "on";
+}
+/**
+ * Overlay environment variables onto a parsed config (env wins) for the keys enumerated in
+ * config.md § Env precedence.
+ */
+export function overlayEnv(config, env) {
+    const next = structuredClone(config);
+    if (env.PI_STUDIO_LISTEN)
+        next.daemon.listen = env.PI_STUDIO_LISTEN;
+    if (env.PI_STUDIO_PASSWORD)
+        next.daemon.auth.password = env.PI_STUDIO_PASSWORD;
+    if (env.PI_STUDIO_HOSTNAMES !== undefined) {
+        const raw = env.PI_STUDIO_HOSTNAMES.trim();
+        next.daemon.hostnames =
+            raw.toLowerCase() === "true"
+                ? true
+                : raw
+                    .split(",")
+                    .map((h) => h.trim())
+                    .filter((h) => h.length > 0);
+    }
+    if (env.PI_STUDIO_RELAY_ENDPOINT)
+        next.daemon.relay.endpoint = env.PI_STUDIO_RELAY_ENDPOINT;
+    if (env.PI_STUDIO_RELAY_PUBLIC_ENDPOINT) {
+        next.daemon.relay.publicEndpoint = env.PI_STUDIO_RELAY_PUBLIC_ENDPOINT;
+    }
+    if (env.PI_STUDIO_RELAY_USE_TLS !== undefined) {
+        next.daemon.relay.useTls = envBool(env.PI_STUDIO_RELAY_USE_TLS);
+    }
+    if (env.PI_STUDIO_RELAY_PUBLIC_USE_TLS !== undefined) {
+        next.daemon.relay.publicUseTls = envBool(env.PI_STUDIO_RELAY_PUBLIC_USE_TLS);
+    }
+    if (env.PI_STUDIO_SERVICE_PROXY_LISTEN) {
+        next.daemon.serviceProxy.listen = env.PI_STUDIO_SERVICE_PROXY_LISTEN;
+    }
+    if (env.PI_STUDIO_SERVICE_PROXY_PUBLIC_BASE_URL) {
+        next.daemon.serviceProxy.publicBaseUrl = env.PI_STUDIO_SERVICE_PROXY_PUBLIC_BASE_URL;
+    }
+    if (env.PI_STUDIO_SERVICE_PROXY_ENABLED !== undefined) {
+        next.daemon.serviceProxy.enabled = envBool(env.PI_STUDIO_SERVICE_PROXY_ENABLED);
+    }
+    return next;
+}
+// ---------------------------------------------------------------------------
+// loadConfig
+// ---------------------------------------------------------------------------
+/**
+ * Load and normalize `config.json`: read JSON (or `{}` when missing/corrupt), migrate legacy
+ * shapes, validate with {@link persistedConfigSchema}, then overlay env vars. Throws if the parsed
+ * config is structurally invalid (e.g. a bad provider id or a custom provider missing extends/label).
+ */
+export function loadConfig(path, env = process.env) {
+    let raw = {};
+    if (existsSync(path)) {
+        try {
+            raw = JSON.parse(readFileSync(path, "utf8"));
+        }
+        catch {
+            raw = {};
+        }
+    }
+    const parsed = persistedConfigSchema.parse(migrateConfig(raw));
+    return overlayEnv(parsed, env);
+}
+//# sourceMappingURL=daemon-config.js.map

package/dist/config/daemon-config.js.map

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

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./daemon-config.js";
+export * from "./project-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+// Configuration: daemon config.json + per-project pi-studio.json.
+export * from "./daemon-config.js";
+export * from "./project-config.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/config/project-config.d.ts

@@ -0,0 +1,104 @@
+import { z } from "zod";
+/**
+ * A named script entry. `command` is required; `type:"service"` flags it for the service proxy.
+ * Extra fields are tolerated (full script-entry schema is TODO(verify)).
+ */
+export declare const scriptEntrySchema: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    command: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    type: z.ZodOptional<z.ZodString>;
+    command: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    type: z.ZodOptional<z.ZodString>;
+    command: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export type ScriptEntry = z.infer<typeof scriptEntrySchema>;
+/** True when a script should be registered with the service proxy. */
+export declare function isServiceScript(entry: ScriptEntry): boolean;
+export declare const piStudioConfigSchema: z.ZodObject<{
+    worktree: z.ZodDefault<z.ZodEffects<z.ZodObject<{
+        setup: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+        teardown: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    }, "strip", z.ZodTypeAny, {
+        setup?: string | string[] | undefined;
+        teardown?: string | string[] | undefined;
+    }, {
+        setup?: string | string[] | undefined;
+        teardown?: string | string[] | undefined;
+    }>, {
+        setup: string[];
+        teardown: string[];
+    }, {
+        setup?: string | string[] | undefined;
+        teardown?: string | string[] | undefined;
+    }>>;
+    scripts: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        type: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        type: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    instructions: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    worktree: {
+        setup: string[];
+        teardown: string[];
+    };
+    scripts: Record<string, z.objectOutputType<{
+        type: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">>;
+    instructions?: string | undefined;
+}, {
+    worktree?: {
+        setup?: string | string[] | undefined;
+        teardown?: string | string[] | undefined;
+    } | undefined;
+    scripts?: Record<string, z.objectInputType<{
+        type: z.ZodOptional<z.ZodString>;
+        command: z.ZodString;
+    }, z.ZodTypeAny, "passthrough">> | undefined;
+    instructions?: string | undefined;
+}>;
+export type PiStudioConfig = z.infer<typeof piStudioConfigSchema>;
+/** Parse + normalize a raw `pi-studio.json` document. Throws on invalid input. */
+export declare function normalizeProjectConfig(raw: unknown): PiStudioConfig;
+/** Revision token of a `pi-studio.json` (content hash). `null` means "no file on disk". */
+export declare const piStudioConfigRevisionSchema: z.ZodNullable<z.ZodString>;
+export type PiStudioConfigRevision = z.infer<typeof piStudioConfigRevisionSchema>;
+export type ProjectConfigWriteError = "project_not_found" | "invalid_project_config" | "stale_project_config" | "write_failed";
+/** Compute the revision token for the given file contents (sha256 hex). */
+export declare function computeRevision(contents: string): string;
+export interface ReadProjectConfigResult {
+    config: PiStudioConfig;
+    /** `null` when no `pi-studio.json` exists (project has no per-project config yet). */
+    revision: PiStudioConfigRevision;
+}
+/**
+ * Read + normalize `pi-studio.json`. A missing file yields the default (empty) config with a `null`
+ * revision; corrupt/invalid JSON yields defaults too (read is lenient — the write path enforces
+ * validity).
+ */
+export declare function readProjectConfig(path: string): Promise<ReadProjectConfigResult>;
+export type WriteProjectConfigResult = {
+    ok: true;
+    revision: string;
+    config: PiStudioConfig;
+} | {
+    ok: false;
+    error: ProjectConfigWriteError;
+};
+/**
+ * Write `pi-studio.json` under the optimistic-concurrency revision model. Returns a typed error:
+ * - `project_not_found` — the project root directory does not exist.
+ * - `invalid_project_config` — `newConfig` fails schema validation.
+ * - `stale_project_config` — the on-disk file changed since `expectedRevision` was read.
+ * - `write_failed` — the filesystem write threw.
+ */
+export declare function writeProjectConfig(path: string, newConfig: unknown, expectedRevision: PiStudioConfigRevision): Promise<WriteProjectConfigResult>;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/config/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2BxB;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;gCAKd,CAAC;AACjB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE3D;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CAEnE;AAMD,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,4BAAwB,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,MAAM,uBAAuB,GAC/B,mBAAmB,GACnB,wBAAwB,GACxB,sBAAsB,GACtB,cAAc,CAAC;AAEnB,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD;AAOD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,sFAAsF;IACtF,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAUtF;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,uBAAuB,CAAA;CAAE,CAAC;AAElD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,OAAO,EAClB,gBAAgB,EAAE,sBAAsB,GACvC,OAAO,CAAC,wBAAwB,CAAC,CAgBnC"}

package/dist/config/project-config.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import { existsSync } from "node:fs";
+import { readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { z } from "zod";
+/**
+ * Per-project `pi-studio.json` config — architecture/config.md § Per-project config,
+ * features/worktrees.md § Lifecycle config, features/service-proxy.md § Triggering.
+ *
+ * Holds worktree lifecycle commands (`setup`/`teardown`) and named `scripts` (a `type:"service"`
+ * script is proxied). A stale-write revision model guards concurrent edits.
+ */
+// ---------------------------------------------------------------------------
+// Schema + normalization
+// ---------------------------------------------------------------------------
+/** Normalize a `string | string[] | undefined` command list: split to array, drop blanks. */
+function toCommandList(value) {
+    const list = value === undefined ? [] : Array.isArray(value) ? value : [value];
+    return list.map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+const commandsInputSchema = z.union([z.string(), z.array(z.string())]).optional();
+/** Worktree lifecycle block — `setup`/`teardown` normalized to deduped command arrays. */
+const worktreeConfigSchema = z
+    .object({ setup: commandsInputSchema, teardown: commandsInputSchema })
+    .transform((w) => ({ setup: toCommandList(w.setup), teardown: toCommandList(w.teardown) }));
+/**
+ * A named script entry. `command` is required; `type:"service"` flags it for the service proxy.
+ * Extra fields are tolerated (full script-entry schema is TODO(verify)).
+ */
+export const scriptEntrySchema = z
+    .object({
+    type: z.string().optional(),
+    command: z.string(),
+})
+    .passthrough();
+/** True when a script should be registered with the service proxy. */
+export function isServiceScript(entry) {
+    return entry.type === "service";
+}
+export const piStudioConfigSchema = z.object({
+    worktree: worktreeConfigSchema.default({}),
+    scripts: z.record(z.string(), scriptEntrySchema).default({}),
+    instructions: z.string().optional(),
+});
+/** Parse + normalize a raw `pi-studio.json` document. Throws on invalid input. */
+export function normalizeProjectConfig(raw) {
+    return piStudioConfigSchema.parse(raw ?? {});
+}
+// ---------------------------------------------------------------------------
+// Revision / stale-write model
+// ---------------------------------------------------------------------------
+/** Revision token of a `pi-studio.json` (content hash). `null` means "no file on disk". */
+export const piStudioConfigRevisionSchema = z.string().nullable();
+/** Compute the revision token for the given file contents (sha256 hex). */
+export function computeRevision(contents) {
+    return createHash("sha256").update(contents).digest("hex");
+}
+async function currentRevision(path) {
+    if (!existsSync(path))
+        return null;
+    return computeRevision(await readFile(path, "utf8"));
+}
+/**
+ * Read + normalize `pi-studio.json`. A missing file yields the default (empty) config with a `null`
+ * revision; corrupt/invalid JSON yields defaults too (read is lenient — the write path enforces
+ * validity).
+ */
+export async function readProjectConfig(path) {
+    if (!existsSync(path))
+        return { config: normalizeProjectConfig({}), revision: null };
+    const contents = await readFile(path, "utf8");
+    let parsed;
+    try {
+        parsed = normalizeProjectConfig(JSON.parse(contents));
+    }
+    catch {
+        parsed = normalizeProjectConfig({});
+    }
+    return { config: parsed, revision: computeRevision(contents) };
+}
+/**
+ * Write `pi-studio.json` under the optimistic-concurrency revision model. Returns a typed error:
+ * - `project_not_found` — the project root directory does not exist.
+ * - `invalid_project_config` — `newConfig` fails schema validation.
+ * - `stale_project_config` — the on-disk file changed since `expectedRevision` was read.
+ * - `write_failed` — the filesystem write threw.
+ */
+export async function writeProjectConfig(path, newConfig, expectedRevision) {
+    if (!existsSync(dirname(path)))
+        return { ok: false, error: "project_not_found" };
+    const parsed = piStudioConfigSchema.safeParse(newConfig);
+    if (!parsed.success)
+        return { ok: false, error: "invalid_project_config" };
+    const onDisk = await currentRevision(path);
+    if (expectedRevision !== onDisk)
+        return { ok: false, error: "stale_project_config" };
+    try {
+        const contents = `${JSON.stringify(newConfig, null, 2)}\n`;
+        await writeFile(path, contents, "utf8");
+        return { ok: true, revision: computeRevision(contents), config: parsed.data };
+    }
+    catch {
+        return { ok: false, error: "write_failed" };
+    }
+}
+//# sourceMappingURL=project-config.js.map

package/dist/config/project-config.js.map

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

package/dist/daemon/bootstrap.d.ts

@@ -0,0 +1,37 @@
+import type { Server as HttpServer } from "node:http";
+export interface DaemonOptions {
+    host: string;
+    port: number;
+    /** Overrides `PI_STUDIO_HOME` (defaults to `~/.pi-studio`). */
+    home?: string;
+    /** Overrides the config path (defaults to `<home>/config.json`). */
+    configPath?: string;
+    serverId?: string;
+}
+export interface DaemonHandle {
+    httpServer: HttpServer;
+    serverId: string;
+    home: string;
+    provider: string;
+    close(): Promise<void>;
+}
+/**
+ * Every WS client only routes bare top-level frames it recognizes (`status`/`ping`/`pong`/
+ * `session`) — `DaemonClient.handleTextFrame`'s `default:` case silently drops anything else,
+ * including unwrapped fan-out messages like `{ type: "terminals_update", ... }`. Call sites across
+ * the daemon send plain "session update" objects (`agent_update`, `workspace_update`,
+ * `terminals_update`, …) expecting them to reach `onSessionMessage` subscribers, so `broadcast`
+ * wraps every message in the `session` envelope through this helper. A few call sites already
+ * wrap manually (`{ type: "session", message: event }`) — passed through as-is, never
+ * double-wrapped.
+ */
+export declare function wrapSessionEnvelope(message: unknown): {
+    type: "session";
+    message: unknown;
+} | unknown;
+/**
+ * Start the real production daemon. Returns a handle exposing the HTTP server, serverId, and a
+ * `close()` for graceful shutdown.
+ */
+export declare function startDaemon(opts: DaemonOptions): DaemonHandle;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/daemon/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/daemon/bootstrap.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC;AAyCtD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAmCD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAIrG;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAwY7D"}