@av-pi-studio/server 0.0.1

package/dist/http/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./host-allowlist.js";
+export * from "./http-server.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/http/index.js

@@ -0,0 +1,4 @@
+// HTTP server: host allowlist, CORS, health route, auth pipeline.
+export * from "./host-allowlist.js";
+export * from "./http-server.js";
+//# sourceMappingURL=index.js.map

package/dist/http/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export declare const SERVER_PACKAGE: "@av-pi-studio/server";
+/** Proves the server consumes protocol + highlight emitted declarations. */
+export declare const SERVER_DEPS: readonly ["@av-pi-studio/protocol", "@av-pi-studio/highlight"];
+export * from "./persistence/index.js";
+export * from "./config/index.js";
+export * from "./daemon/index.js";
+export * from "./http/index.js";
+export * from "./auth/index.js";
+export * from "./ws/index.js";
+export * from "./agent/index.js";
+export * from "./projects/index.js";
+export * from "./terminal/index.js";
+export * from "./proxy/index.js";
+export * from "./files/index.js";
+export * from "./orchestration/index.js";
+export * from "./logging/index.js";
+export * from "./util/index.js";
+//# 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":"AAIA,eAAO,MAAM,cAAc,EAAG,sBAA+B,CAAC;AAE9D,4EAA4E;AAC5E,eAAO,MAAM,WAAW,gEAAiD,CAAC;AAG1E,cAAc,wBAAwB,CAAC;AAGvC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,eAAe,CAAC;AAG9B,cAAc,kBAAkB,CAAC;AAGjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,35 @@
+// @av-pi-studio/server — the daemon: WS API, agent supervision, stores, relay.
+import { HIGHLIGHT_PACKAGE } from "@av-pi-studio/highlight";
+import { PROTOCOL_PACKAGE } from "@av-pi-studio/protocol";
+export const SERVER_PACKAGE = "@av-pi-studio/server";
+/** Proves the server consumes protocol + highlight emitted declarations. */
+export const SERVER_DEPS = [PROTOCOL_PACKAGE, HIGHLIGHT_PACKAGE];
+// File-based JSON persistence (atomic store primitive + entity stores).
+export * from "./persistence/index.js";
+// Configuration (daemon config.json + per-project pi-studio.json).
+export * from "./config/index.js";
+// Daemon identity + bootstrap.
+export * from "./daemon/index.js";
+// HTTP server (host allowlist, CORS, health, auth pipeline).
+export * from "./http/index.js";
+// Optional password auth (bcrypt + bearer / WS subprotocol).
+export * from "./auth/index.js";
+// WebSocket server (handshake, sessions, capability rehydrate, routing).
+export * from "./ws/index.js";
+// Agent providers, registry, snapshot, and lifecycle manager.
+export * from "./agent/index.js";
+// Project + workspace registries, key derivation, reconciliation.
+export * from "./projects/index.js";
+// PTY terminal manager + binary stream.
+export * from "./terminal/index.js";
+// HTTP service proxy (generated hostnames + routing).
+export * from "./proxy/index.js";
+// File explorer + binary file transfer.
+export * from "./files/index.js";
+// Orchestration: chat rooms, schedules/heartbeats, loops.
+export * from "./orchestration/index.js";
+// Operational logging (pino + rotating file).
+export * from "./logging/index.js";
+// Shared utilities (bounded-concurrency helpers).
+export * from "./util/index.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,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,CAAC,MAAM,cAAc,GAAG,sBAA+B,CAAC;AAE9D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAU,CAAC;AAE1E,wEAAwE;AACxE,cAAc,wBAAwB,CAAC;AAEvC,mEAAmE;AACnE,cAAc,mBAAmB,CAAC;AAElC,+BAA+B;AAC/B,cAAc,mBAAmB,CAAC;AAElC,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAEhC,6DAA6D;AAC7D,cAAc,iBAAiB,CAAC;AAEhC,yEAAyE;AACzE,cAAc,eAAe,CAAC;AAE9B,8DAA8D;AAC9D,cAAc,kBAAkB,CAAC;AAEjC,kEAAkE;AAClE,cAAc,qBAAqB,CAAC;AAEpC,wCAAwC;AACxC,cAAc,qBAAqB,CAAC;AAEpC,sDAAsD;AACtD,cAAc,kBAAkB,CAAC;AAEjC,wCAAwC;AACxC,cAAc,kBAAkB,CAAC;AAEjC,0DAA0D;AAC1D,cAAc,0BAA0B,CAAC;AAEzC,8CAA8C;AAC9C,cAAc,oBAAoB,CAAC;AAEnC,kDAAkD;AAClD,cAAc,iBAAiB,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,2 @@
+export { createDaemonLogger, createLogger, type CreateLoggerOptions, type Logger, type LogLevel, silentLogger, } from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,2 @@
+export { createDaemonLogger, createLogger, silentLogger, } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,YAAY,EAIZ,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/logging/logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Daemon logging (operational concern; adopted from the reference daemon's `pino` stack). The rest
+ * of the codebase injects a `Pick<Console, "info" | "warn" | "error">`-shaped logger; a pino logger
+ * satisfies that shape, so existing call sites keep working while gaining levels + structure.
+ *
+ * - Dev / TTY: pretty, colorized, human-readable (no worker thread).
+ * - Daemon with a home dir: structured NDJSON to a rotating file under `$PI_STUDIO_HOME/logs/`.
+ */
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "silent";
+/** The structural logger the daemon passes around. A pino `Logger` is assignable to this. */
+export interface Logger {
+    trace(obj: unknown, msg?: string): void;
+    trace(msg: string): void;
+    debug(obj: unknown, msg?: string): void;
+    debug(msg: string): void;
+    info(obj: unknown, msg?: string): void;
+    info(msg: string): void;
+    warn(obj: unknown, msg?: string): void;
+    warn(msg: string): void;
+    error(obj: unknown, msg?: string): void;
+    error(msg: string): void;
+    fatal(obj: unknown, msg?: string): void;
+    fatal(msg: string): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+export interface CreateLoggerOptions {
+    level?: LogLevel;
+    /** Pretty, colorized output (default: true when stdout is a TTY). */
+    pretty?: boolean;
+    /** Write structured NDJSON to a rotating file in this directory instead of stdout. */
+    logDir?: string;
+    /** Rotating-file size threshold (default "10M"). */
+    rotateSize?: string;
+    /** Rotating-file retained count (default 5). */
+    rotateMaxFiles?: number;
+    /** Base bindings attached to every line (e.g. `{ name: "pi-studio" }`). */
+    bindings?: Record<string, unknown>;
+}
+/** Build a pino logger per the options. Pure/synchronous; safe to call in tests. */
+export declare function createLogger(options?: CreateLoggerOptions): Logger;
+/**
+ * Daemon logger: NDJSON to `<home>/logs/` when a home dir is given (the long-running daemon), else a
+ * pretty/stdout dev logger.
+ */
+export declare function createDaemonLogger(home: string | undefined, options?: CreateLoggerOptions): Logger;
+/** A no-op logger for tests / opt-out paths. */
+export declare function silentLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE1F,6FAA6F;AAC7F,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAQD,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA2BtE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAGR;AAED,gDAAgD;AAChD,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/logging/logger.js

@@ -0,0 +1,53 @@
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { pino } from "pino";
+// `pino-pretty` is usable directly as a sonic-boom-compatible stream, which avoids spawning a
+// transport worker thread (worker threads are awkward under Vitest and add shutdown latency).
+import pinoPretty from "pino-pretty";
+import { createStream as createRotatingStream } from "rotating-file-stream";
+function resolveLevel(level) {
+    if (level)
+        return level;
+    const fromEnv = process.env.PI_STUDIO_LOG_LEVEL;
+    return fromEnv ?? "info";
+}
+/** Build a pino logger per the options. Pure/synchronous; safe to call in tests. */
+export function createLogger(options = {}) {
+    const level = resolveLevel(options.level);
+    const base = { level, base: options.bindings ?? undefined };
+    if (level === "silent")
+        return pino({ ...base, level: "silent" });
+    if (options.logDir) {
+        mkdirSync(options.logDir, { recursive: true });
+        const stream = createRotatingStream("pi-studio.log", {
+            size: options.rotateSize ?? "10M",
+            maxFiles: options.rotateMaxFiles ?? 5,
+            path: options.logDir,
+        });
+        return pino(base, stream);
+    }
+    const pretty = options.pretty ?? Boolean(process.stdout.isTTY);
+    if (pretty) {
+        const stream = pinoPretty({
+            colorize: true,
+            translateTime: "SYS:HH:MM:ss.l",
+            ignore: "pid,hostname",
+        });
+        return pino(base, stream);
+    }
+    return pino(base);
+}
+/**
+ * Daemon logger: NDJSON to `<home>/logs/` when a home dir is given (the long-running daemon), else a
+ * pretty/stdout dev logger.
+ */
+export function createDaemonLogger(home, options = {}) {
+    if (home)
+        return createLogger({ ...options, logDir: options.logDir ?? join(home, "logs") });
+    return createLogger(options);
+}
+/** A no-op logger for tests / opt-out paths. */
+export function silentLogger() {
+    return createLogger({ level: "silent" });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,8FAA8F;AAC9F,8FAA8F;AAC9F,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA4C5E,SAAS,YAAY,CAAC,KAA2B;IAC/C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAA2C,CAAC;IACxE,OAAO,OAAO,IAAI,MAAM,CAAC;AAC3B,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,UAA+B,EAAE;IAC5D,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;IAE5D,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAsB,CAAC;IAEvF,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,eAAe,EAAE;YACnD,IAAI,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK;YACjC,QAAQ,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC;YACrC,IAAI,EAAE,OAAO,CAAC,MAAM;SACrB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,CAAsB,CAAC;IACjD,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,UAAU,CAAC;YACxB,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,gBAAgB;YAC/B,MAAM,EAAE,cAAc;SACvB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,CAAsB,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAsB,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAwB,EACxB,UAA+B,EAAE;IAEjC,IAAI,IAAI;QAAE,OAAO,YAAY,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5F,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY;IAC1B,OAAO,YAAY,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/orchestration/chat-service.d.ts

@@ -0,0 +1,61 @@
+import type { ChatMessage, ChatRoom } from "../persistence/entity-schemas.js";
+/**
+ * Chat rooms for agent↔agent / human↔agent coordination (features/chat-rooms.md). Backed by the
+ * shared `chat/rooms.json` store = `{ rooms, messages }` (persistence/entity-stores). Room names are
+ * unique case-insensitively; `@mentions` in a posted body are parsed into `mentionAgentIds` (unknown
+ * mentions dropped); reads are cursor based; waits block until a new message or timeout.
+ */
+export type { ChatMessage, ChatRoom, ChatStore } from "../persistence/entity-schemas.js";
+/** Parse `@mentions` from a body into raw mention tokens (without the leading `@`). */
+export declare function parseMentions(body: string): string[];
+export interface ChatServiceDeps {
+    home: string;
+    /** Resolve a mention token → agent id (null if unknown → dropped). Defaults to identity-if-exists. */
+    resolveMention?: (token: string) => string | null;
+    now?: () => string;
+}
+export declare class ChatService {
+    private readonly deps;
+    private readonly now;
+    private store;
+    private loaded;
+    private readonly waiters;
+    constructor(deps: ChatServiceDeps);
+    private ensureLoaded;
+    private persist;
+    /** Create a room. Rejects a duplicate name (case-insensitive). */
+    createRoom(input: {
+        name: string;
+        purpose?: string;
+    }): Promise<ChatRoom>;
+    listRooms(): Promise<ChatRoom[]>;
+    inspectRoom(roomId: string): Promise<{
+        room: ChatRoom;
+        messages: ChatMessage[];
+    } | null>;
+    /** Delete a room and all its messages. */
+    deleteRoom(roomId: string): Promise<boolean>;
+    /** Post a message; parses + resolves `@mentions`; bumps room.updatedAt; notifies waiters. */
+    postMessage(input: {
+        roomId: string;
+        authorAgentId: string;
+        body: string;
+        replyToMessageId?: string;
+    }): Promise<ChatMessage>;
+    /** Read messages after `cursor` (an index into the room's message list). */
+    readMessages(roomId: string, cursor?: number): Promise<{
+        messages: ChatMessage[];
+        cursor: number;
+    }>;
+    /**
+     * Return new messages after `sinceCursor` immediately if any exist; otherwise block until a new
+     * message arrives or `timeoutMs` elapses (then return whatever is available, possibly empty).
+     */
+    waitForMessages(roomId: string, sinceCursor: number, timeoutMs?: number): Promise<{
+        messages: ChatMessage[];
+        cursor: number;
+    }>;
+    private messagesFor;
+    private notifyWaiters;
+}
+//# sourceMappingURL=chat-service.d.ts.map

package/dist/orchestration/chat-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-service.d.ts","sourceRoot":"","sources":["../../src/orchestration/chat-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAa,MAAM,kCAAkC,CAAC;AAGzF;;;;;GAKG;AAEH,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIzF,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMpD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAClD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAQD,qBAAa,WAAW;IAMV,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEhB,IAAI,EAAE,eAAe;YAIpC,YAAY;YAMZ,OAAO;IAIrB,kEAAkE;IAC5D,UAAU,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoBxE,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKhC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAO9F,0CAA0C;IACpC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUlD,6FAA6F;IACvF,WAAW,CAAC,KAAK,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BxB,4EAA4E;IACtE,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,MAAM,SAAI,GACT,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQvD;;;OAGG;IACG,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,SAAS,GACjB,OAAO,CAAC;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAyBvD,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,aAAa;CAWtB"}

package/dist/orchestration/chat-service.js

@@ -0,0 +1,156 @@
+import { randomUUID } from "node:crypto";
+import { loadChat, saveChat } from "../persistence/entity-stores.js";
+const MENTION_RE = /@([A-Za-z0-9_.:-]+)/g;
+/** Parse `@mentions` from a body into raw mention tokens (without the leading `@`). */
+export function parseMentions(body) {
+    const out = new Set();
+    for (const match of body.matchAll(MENTION_RE)) {
+        if (match[1])
+            out.add(match[1]);
+    }
+    return [...out];
+}
+export class ChatService {
+    deps;
+    now;
+    store = { rooms: [], messages: [] };
+    loaded = false;
+    waiters = new Set();
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? (() => new Date().toISOString());
+    }
+    async ensureLoaded() {
+        if (this.loaded)
+            return;
+        this.store = await loadChat(this.deps.home);
+        this.loaded = true;
+    }
+    async persist() {
+        await saveChat(this.deps.home, this.store);
+    }
+    /** Create a room. Rejects a duplicate name (case-insensitive). */
+    async createRoom(input) {
+        await this.ensureLoaded();
+        const name = input.name.trim();
+        if (!name)
+            throw new Error("room name required");
+        if (this.store.rooms.some((r) => r.name.toLowerCase() === name.toLowerCase())) {
+            throw new Error("duplicate_room_name");
+        }
+        const ts = this.now();
+        const room = {
+            id: randomUUID(),
+            name,
+            purpose: input.purpose,
+            createdAt: ts,
+            updatedAt: ts,
+        };
+        this.store.rooms.push(room);
+        await this.persist();
+        return room;
+    }
+    async listRooms() {
+        await this.ensureLoaded();
+        return [...this.store.rooms];
+    }
+    async inspectRoom(roomId) {
+        await this.ensureLoaded();
+        const room = this.store.rooms.find((r) => r.id === roomId);
+        if (!room)
+            return null;
+        return { room, messages: this.messagesFor(roomId) };
+    }
+    /** Delete a room and all its messages. */
+    async deleteRoom(roomId) {
+        await this.ensureLoaded();
+        const before = this.store.rooms.length;
+        this.store.rooms = this.store.rooms.filter((r) => r.id !== roomId);
+        if (this.store.rooms.length === before)
+            return false;
+        this.store.messages = this.store.messages.filter((m) => m.roomId !== roomId);
+        await this.persist();
+        return true;
+    }
+    /** Post a message; parses + resolves `@mentions`; bumps room.updatedAt; notifies waiters. */
+    async postMessage(input) {
+        await this.ensureLoaded();
+        const room = this.store.rooms.find((r) => r.id === input.roomId);
+        if (!room)
+            throw new Error("unknown_room");
+        const resolve = this.deps.resolveMention ?? ((t) => t);
+        const mentionAgentIds = [];
+        for (const token of parseMentions(input.body)) {
+            const resolved = resolve(token);
+            if (resolved)
+                mentionAgentIds.push(resolved);
+        }
+        const message = {
+            id: randomUUID(),
+            roomId: input.roomId,
+            authorAgentId: input.authorAgentId,
+            body: input.body,
+            replyToMessageId: input.replyToMessageId,
+            mentionAgentIds,
+            createdAt: this.now(),
+        };
+        this.store.messages.push(message);
+        room.updatedAt = message.createdAt;
+        await this.persist();
+        this.notifyWaiters(input.roomId);
+        return message;
+    }
+    /** Read messages after `cursor` (an index into the room's message list). */
+    async readMessages(roomId, cursor = 0) {
+        await this.ensureLoaded();
+        const all = this.messagesFor(roomId);
+        const start = Math.max(0, cursor);
+        const messages = all.slice(start);
+        return { messages, cursor: all.length };
+    }
+    /**
+     * Return new messages after `sinceCursor` immediately if any exist; otherwise block until a new
+     * message arrives or `timeoutMs` elapses (then return whatever is available, possibly empty).
+     */
+    async waitForMessages(roomId, sinceCursor, timeoutMs = 30_000) {
+        await this.ensureLoaded();
+        const immediate = this.messagesFor(roomId).slice(Math.max(0, sinceCursor));
+        if (immediate.length > 0) {
+            return { messages: immediate, cursor: this.messagesFor(roomId).length };
+        }
+        return new Promise((resolve) => {
+            const waiter = {
+                roomId,
+                sinceCursor,
+                resolve: (messages) => {
+                    clearTimeout(timer);
+                    this.waiters.delete(waiter);
+                    resolve({ messages, cursor: this.messagesFor(roomId).length });
+                },
+            };
+            const timer = setTimeout(() => {
+                this.waiters.delete(waiter);
+                resolve({ messages: [], cursor: this.messagesFor(roomId).length });
+            }, timeoutMs);
+            this.waiters.add(waiter);
+        });
+    }
+    messagesFor(roomId) {
+        return this.store.messages.filter((m) => m.roomId === roomId);
+    }
+    notifyWaiters(roomId) {
+        const roomMessages = this.messagesFor(roomId);
+        // Collect ready waiters first; `resolve` mutates `this.waiters`, so don't resolve mid-iteration.
+        const ready = [];
+        for (const waiter of this.waiters) {
+            if (waiter.roomId !== roomId)
+                continue;
+            const fresh = roomMessages.slice(Math.max(0, waiter.sinceCursor));
+            if (fresh.length > 0)
+                ready.push({ waiter, fresh });
+        }
+        for (const { waiter, fresh } of ready)
+            waiter.resolve(fresh);
+    }
+}
+//# sourceMappingURL=chat-service.js.map

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

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

package/dist/orchestration/cron.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Minimal cron + interval next-time computation (features/schedules-heartbeats.md § Behavior).
+ * Supports standard 5-field cron (`min hour dom month dow`) with `*`, lists (`a,b`), ranges (`a-b`),
+ * and steps (`*​/n`, `a-b/n`). An IANA `timezone` makes recurrence follow local wall-clock (DST-aware
+ * via `Intl.DateTimeFormat`); absent timezone = UTC.
+ */
+export declare class CronParseError extends Error {
+    constructor(message: string);
+}
+interface CronFields {
+    minute: Set<number>;
+    hour: Set<number>;
+    dom: Set<number>;
+    month: Set<number>;
+    dow: Set<number>;
+    domRestricted: boolean;
+    dowRestricted: boolean;
+}
+export declare function parseCron(expression: string): CronFields;
+/** Validate a cron expression (throws `CronParseError` if invalid). */
+export declare function assertValidCron(expression: string): void;
+/**
+ * Next cron fire strictly after `after`, in the given timezone (default UTC). Steps minute-by-minute
+ * up to ~366 days; returns null if no match within the window.
+ */
+export declare function nextCronTime(expression: string, after: Date, timezone?: string): Date | null;
+/** Next interval fire after `from`. */
+export declare function nextEveryTime(everyMs: number, from: Date): Date;
+export {};
+//# sourceMappingURL=cron.d.ts.map

package/dist/orchestration/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../src/orchestration/cron.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,UAAU,UAAU;IAClB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACnB,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACxB;AAwCD,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAexD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAExD;AAiDD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAW5F;AAED,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAE/D"}

package/dist/orchestration/cron.js

@@ -0,0 +1,136 @@
+/**
+ * Minimal cron + interval next-time computation (features/schedules-heartbeats.md § Behavior).
+ * Supports standard 5-field cron (`min hour dom month dow`) with `*`, lists (`a,b`), ranges (`a-b`),
+ * and steps (`*​/n`, `a-b/n`). An IANA `timezone` makes recurrence follow local wall-clock (DST-aware
+ * via `Intl.DateTimeFormat`); absent timezone = UTC.
+ */
+export class CronParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CronParseError";
+    }
+}
+const RANGES = {
+    minute: [0, 59],
+    hour: [0, 23],
+    dom: [1, 31],
+    month: [1, 12],
+    dow: [0, 6],
+};
+function parseField(field, name) {
+    const [lo, hi] = RANGES[name];
+    const values = new Set();
+    for (const part of field.split(",")) {
+        const [rangePart, stepPart] = part.split("/");
+        const step = stepPart ? Number.parseInt(stepPart, 10) : 1;
+        if (!Number.isInteger(step) || step < 1)
+            throw new CronParseError(`bad step in "${field}"`);
+        let start = lo;
+        let end = hi;
+        if (rangePart && rangePart !== "*") {
+            const bounds = rangePart.split("-");
+            start = Number.parseInt(bounds[0], 10);
+            end = bounds[1] !== undefined ? Number.parseInt(bounds[1], 10) : start;
+            if (Number.isNaN(start) || Number.isNaN(end))
+                throw new CronParseError(`bad range "${part}"`);
+        }
+        // dow: normalize 7 → 0 (Sunday).
+        if (name === "dow") {
+            start = start === 7 ? 0 : start;
+            end = end === 7 ? 0 : end;
+        }
+        if (start > end)
+            throw new CronParseError(`inverted range "${part}"`);
+        for (let v = start; v <= end; v += step) {
+            if (v < lo || v > hi)
+                throw new CronParseError(`value ${v} out of range for ${name}`);
+            values.add(v);
+        }
+    }
+    return values;
+}
+export function parseCron(expression) {
+    const fields = expression.trim().split(/\s+/);
+    if (fields.length !== 5) {
+        throw new CronParseError(`expected 5 cron fields, got ${fields.length}: "${expression}"`);
+    }
+    const [min, hour, dom, month, dow] = fields;
+    return {
+        minute: parseField(min, "minute"),
+        hour: parseField(hour, "hour"),
+        dom: parseField(dom, "dom"),
+        month: parseField(month, "month"),
+        dow: parseField(dow, "dow"),
+        domRestricted: dom !== "*",
+        dowRestricted: dow !== "*",
+    };
+}
+/** Validate a cron expression (throws `CronParseError` if invalid). */
+export function assertValidCron(expression) {
+    parseCron(expression);
+}
+function zonedParts(date, timeZone) {
+    const fmt = new Intl.DateTimeFormat("en-US", {
+        timeZone,
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+    const parts = {};
+    for (const p of fmt.formatToParts(date)) {
+        if (p.type !== "literal")
+            parts[p.type] = p.value;
+    }
+    const year = Number.parseInt(parts.year, 10);
+    const month = Number.parseInt(parts.month, 10);
+    const day = Number.parseInt(parts.day, 10);
+    let hour = Number.parseInt(parts.hour, 10);
+    if (hour === 24)
+        hour = 0; // some environments render midnight as 24
+    const minute = Number.parseInt(parts.minute, 10);
+    // Day-of-week from the wall-clock calendar date.
+    const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
+    return { year, month, day, hour, minute, weekday };
+}
+function matches(fields, p) {
+    if (!fields.minute.has(p.minute))
+        return false;
+    if (!fields.hour.has(p.hour))
+        return false;
+    if (!fields.month.has(p.month))
+        return false;
+    // Classic crontab: when both dom and dow are restricted, match if EITHER matches.
+    if (fields.domRestricted && fields.dowRestricted) {
+        return fields.dom.has(p.day) || fields.dow.has(p.weekday);
+    }
+    if (!fields.dom.has(p.day))
+        return false;
+    if (!fields.dow.has(p.weekday))
+        return false;
+    return true;
+}
+/**
+ * Next cron fire strictly after `after`, in the given timezone (default UTC). Steps minute-by-minute
+ * up to ~366 days; returns null if no match within the window.
+ */
+export function nextCronTime(expression, after, timezone) {
+    const fields = parseCron(expression);
+    const tz = timezone ?? "UTC";
+    // Start at the next whole minute after `after`.
+    const start = new Date(Math.floor(after.getTime() / 60_000) * 60_000 + 60_000);
+    const maxIterations = 366 * 24 * 60;
+    for (let i = 0; i < maxIterations; i++) {
+        const candidate = new Date(start.getTime() + i * 60_000);
+        if (matches(fields, zonedParts(candidate, tz)))
+            return candidate;
+    }
+    return null;
+}
+/** Next interval fire after `from`. */
+export function nextEveryTime(everyMs, from) {
+    return new Date(from.getTime() + everyMs);
+}
+//# sourceMappingURL=cron.js.map

package/dist/orchestration/cron.js.map

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

package/dist/orchestration/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./chat-service.js";
+export * from "./cron.js";
+export * from "./schedule-service.js";
+export * from "./loop-service.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}