@av-pi-studio/server 0.0.1

package/dist/orchestration/schedule-service.js.map

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

package/dist/persistence/atomic-store.d.ts

@@ -0,0 +1,45 @@
+import type { z } from "zod";
+/**
+ * File-based JSON store primitives (architecture/persistence.md § Behavior & Algorithms,
+ * § Error Handling).
+ *
+ * Pi-Studio uses file-based JSON persistence instead of a database. Every document is Zod-validated.
+ * Most stores write **atomically** (temp file in the same directory, fsync, rename — atomic on
+ * POSIX); the loop store uses a plain, queue-serialized writer. There is no migration framework:
+ * forward-compat is optional fields + defaults + an inline `normalize` hook on load.
+ */
+/** The subdirectories created under `$PI_STUDIO_HOME`. */
+export declare const STORE_SUBDIRECTORIES: readonly ["agents", "schedules", "chat", "projects", "loops"];
+/**
+ * Atomically write `data` to `path`: validate against `schema`, write `{path}.tmp` in the **same
+ * directory**, fsync it, then rename over `path`. The rename is atomic on POSIX, so a crash before
+ * the rename leaves the previous `path` intact and only discards the temp file.
+ */
+export declare function atomicWriteJson<S extends z.ZodTypeAny>(path: string, data: z.input<S>, schema: S): Promise<void>;
+/** Options for {@link loadStore}. */
+export interface LoadStoreOptions {
+    /**
+     * Inline legacy normalization hook applied to the raw parsed JSON **before** schema validation.
+     * This is where legacy field shapes are migrated (no versioned migration framework).
+     */
+    normalize?: (raw: unknown) => unknown;
+}
+/**
+ * Load a JSON store from `path`. Missing file → `defaults`. Corrupt/partial JSON or a schema
+ * mismatch → `defaults` (never throws, so the daemon cannot be crashed by a bad file). A
+ * `normalize` hook may rewrite the raw JSON before validation.
+ */
+export declare function loadStore<S extends z.ZodTypeAny>(path: string, schema: S, defaults: z.infer<S>, options?: LoadStoreOptions): Promise<z.infer<S>>;
+/**
+ * Create the `$PI_STUDIO_HOME` directory layout (`agents/`, `schedules/`, `chat/`, `projects/`,
+ * `loops/`). Idempotent — safe to call on every boot.
+ */
+export declare function ensureDirectoryLayout(home: string): Promise<string>;
+/**
+ * A write function that serializes calls through an in-memory promise queue and writes JSON
+ * **non-atomically** (plain write). Used by the loop store (architecture/persistence.md — "Loop
+ * store writes are direct (not atomic) and queued"). Concurrent calls are applied in FIFO order.
+ */
+export type QueuedWriter = <S extends z.ZodTypeAny>(path: string, data: z.input<S>, schema: S) => Promise<void>;
+export declare function createQueuedJsonWriter(): QueuedWriter;
+//# sourceMappingURL=atomic-store.d.ts.map

package/dist/persistence/atomic-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-store.d.ts","sourceRoot":"","sources":["../../src/persistence/atomic-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAI7B;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,+DAAgE,CAAC;AAElG;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC1D,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAChB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACpD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAarB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMzE;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAChD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAChB,MAAM,EAAE,CAAC,KACN,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,wBAAgB,sBAAsB,IAAI,YAAY,CAsBrD"}

package/dist/persistence/atomic-store.js

@@ -0,0 +1,92 @@
+import { existsSync } from "node:fs";
+import { mkdir, open, readFile, rename, unlink } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { safeParseOrDefault } from "@av-pi-studio/protocol";
+import { mapWithConcurrency } from "../util/concurrency.js";
+/**
+ * File-based JSON store primitives (architecture/persistence.md § Behavior & Algorithms,
+ * § Error Handling).
+ *
+ * Pi-Studio uses file-based JSON persistence instead of a database. Every document is Zod-validated.
+ * Most stores write **atomically** (temp file in the same directory, fsync, rename — atomic on
+ * POSIX); the loop store uses a plain, queue-serialized writer. There is no migration framework:
+ * forward-compat is optional fields + defaults + an inline `normalize` hook on load.
+ */
+/** The subdirectories created under `$PI_STUDIO_HOME`. */
+export const STORE_SUBDIRECTORIES = ["agents", "schedules", "chat", "projects", "loops"];
+/**
+ * Atomically write `data` to `path`: validate against `schema`, write `{path}.tmp` in the **same
+ * directory**, fsync it, then rename over `path`. The rename is atomic on POSIX, so a crash before
+ * the rename leaves the previous `path` intact and only discards the temp file.
+ */
+export async function atomicWriteJson(path, data, schema) {
+    const validated = schema.parse(data);
+    const json = `${JSON.stringify(validated, null, 2)}\n`;
+    await mkdir(dirname(path), { recursive: true });
+    // Unique temp name in the same directory so concurrent writers never clobber each other's temp.
+    const tmp = `${path}.${process.pid}.${Math.random().toString(36).slice(2)}.tmp`;
+    const handle = await open(tmp, "w");
+    try {
+        await handle.writeFile(json, "utf8");
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    try {
+        await rename(tmp, path);
+    }
+    catch (error) {
+        // Clean up the orphaned temp file; never leave it where a loader might trip over it.
+        await unlink(tmp).catch(() => undefined);
+        throw error;
+    }
+}
+/**
+ * Load a JSON store from `path`. Missing file → `defaults`. Corrupt/partial JSON or a schema
+ * mismatch → `defaults` (never throws, so the daemon cannot be crashed by a bad file). A
+ * `normalize` hook may rewrite the raw JSON before validation.
+ */
+export async function loadStore(path, schema, defaults, options = {}) {
+    if (!existsSync(path))
+        return defaults;
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        // Corrupt/partial JSON — fall back to defaults rather than crash.
+        return defaults;
+    }
+    const normalized = options.normalize ? options.normalize(raw) : raw;
+    return safeParseOrDefault(schema, normalized, defaults);
+}
+/**
+ * Create the `$PI_STUDIO_HOME` directory layout (`agents/`, `schedules/`, `chat/`, `projects/`,
+ * `loops/`). Idempotent — safe to call on every boot.
+ */
+export async function ensureDirectoryLayout(home) {
+    await mkdir(home, { recursive: true });
+    await mapWithConcurrency(STORE_SUBDIRECTORIES, (sub) => mkdir(join(home, sub), { recursive: true }));
+    return home;
+}
+export function createQueuedJsonWriter() {
+    let tail = Promise.resolve();
+    return function queuedWrite(path, data, schema) {
+        const run = tail.then(async () => {
+            const validated = schema.parse(data);
+            await mkdir(dirname(path), { recursive: true });
+            const handle = await open(path, "w");
+            try {
+                await handle.writeFile(`${JSON.stringify(validated, null, 2)}\n`, "utf8");
+            }
+            finally {
+                await handle.close();
+            }
+        });
+        // Keep the queue alive even if a write rejects, but surface the error to the caller.
+        tail = run.catch(() => undefined);
+        return run;
+    };
+}
+//# sourceMappingURL=atomic-store.js.map

package/dist/persistence/atomic-store.js.map

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