pi-daddy 0.22.0 → 0.24.0

package/dist/dashboard-host-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-host-contract.js","sourceRoot":"","sources":["../src/dashboard-host-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAMrD,MAAM,CAAC,MAAM,qBAAqB,GAAG,0CAA0C,CAAC;AA+BhF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAsB,EAAU,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAA2C,EAAU,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACvH,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,MAAM,CAAC,GAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAAA,YAAY,CAAC,CAAC,EAAC,CAAC,SAAS,EAAC,WAAW,EAAC,YAAY,EAAC,aAAa,EAAC,iBAAiB,EAAC,WAAW,EAAC,SAAS,CAAC,CAAC,CAAC;IACnI,IAAG,CAAC,CAAC,OAAO,KAAG,KAAK,IAAE,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAC,CAAC,CAAC,WAAW,EAAC,CAAC,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAE,CAAC,CAAC,SAAS,EAAC,SAAS,EAAC,WAAW,EAAC,OAAO,EAAC,SAAS,EAAC,UAAU,EAAC,QAAQ,EAAC,QAAQ,EAAC,oBAAoB,EAAC,kBAAkB,EAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,IAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAC,KAAK;QAAC,MAAM,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAAA,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;AACzZ,CAAC;AACD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAuB,EAAU,EAAE,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/dashboard-host-transport.d.ts

@@ -0,0 +1,16 @@
+import { type DashboardHost } from "./dashboard-host.ts";
+export declare const ENV_DASHBOARD_HOST_SOCKET = "PI_DADDY_HOST_SOCKET";
+export type DashboardConnection = {
+    frame: DashboardHost["frame"];
+    action: DashboardHost["action"];
+    humanAction: DashboardHost["humanAction"];
+};
+export declare const isDashboardConnection: (v: unknown) => v is DashboardConnection;
+/** Same original host process. No worker socket, native TUI attach, PID lookup or authority transport. */
+export declare function serveDashboardHost(path: string, host: DashboardHost): Promise<Readonly<{
+    path: string;
+    close: () => Promise<void>;
+}>>;
+/** Explicit operator-selected endpoint. Socket ownership is access policy, not module/human authentication. */
+export declare function connectDashboardHost(path: string): DashboardConnection;
+//# sourceMappingURL=dashboard-host-transport.d.ts.map

package/dist/dashboard-host-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-host-transport.d.ts","sourceRoot":"","sources":["../src/dashboard-host-transport.ts"],"names":[],"mappings":"AAIA,OAAO,EAAyC,KAAK,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC3H,eAAO,MAAM,yBAAyB,yBAAuB,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAC;IAAC,KAAK,EAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAAA,MAAM,EAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAAA,WAAW,EAAC,aAAa,CAAC,aAAa,CAAC,CAAA;CAAC,CAAC;AAEvI,eAAO,MAAM,qBAAqB,GAAE,GAAE,OAAO,KAAE,CAAC,IAAI,mBAA0F,CAAC;AAE/I,0GAA0G;AAC1G,wBAAsB,kBAAkB,CAAC,IAAI,EAAC,MAAM,EAAC,IAAI,EAAC,aAAa;;;IAgBtE;AACD,+GAA+G;AAC/G,wBAAgB,oBAAoB,CAAC,IAAI,EAAC,MAAM,GAAE,mBAAmB,CAUpE"}

package/dist/dashboard-host-transport.js

@@ -0,0 +1,124 @@
+import { createServer, createConnection } from "node:net";
+import { lstat, realpath, chmod } from "node:fs/promises";
+import { dirname, isAbsolute } from "node:path";
+import { parseRetentionJson } from "./retention-json.js";
+import { isDashboardHost, dashboardHostRequest } from "./dashboard-host.js";
+export const ENV_DASHBOARD_HOST_SOCKET = "PI_DADDY_HOST_SOCKET";
+const connections = new WeakSet();
+export const isDashboardConnection = (v) => isDashboardHost(v) || typeof v === "object" && v !== null && connections.has(v);
+async function parent(path) { if (!isAbsolute(path) || Buffer.byteLength(path) > 100 || await realpath(dirname(path)) !== dirname(path))
+    throw Error("canonical bounded private dashboard socket required"); const s = await lstat(dirname(path)); if (!s.isDirectory() || s.mode & 0o077 || s.uid !== process.getuid?.())
+    throw Error("private owned dashboard socket parent required"); }
+/** Same original host process. No worker socket, native TUI attach, PID lookup or authority transport. */
+export async function serveDashboardHost(path, host) {
+    if (!isDashboardHost(host))
+        throw Error("original dashboard host required");
+    await parent(path);
+    const clients = new Set(), tasks = new Set();
+    const server = createServer(socket => {
+        if (clients.size >= 4) {
+            socket.destroy();
+            return;
+        }
+        clients.add(socket);
+        socket.on("close", () => clients.delete(socket));
+        socket.on("error", () => { });
+        socket.setTimeout(5000, () => socket.destroy());
+        let size = 0, used = false;
+        const chunks = [];
+        socket.on("data", bytes => {
+            if (used)
+                return;
+            size += bytes.length;
+            if (size > 65536) {
+                socket.destroy();
+                return;
+            }
+            chunks.push(bytes);
+            if (bytes.at(-1) !== 10)
+                return;
+            used = true;
+            const task = (async () => {
+                try {
+                    const text = new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks));
+                    const r = parseRetentionJson(text, 65536);
+                    let result;
+                    if (Object.keys(r).join() === "operation" && r.operation === "frame")
+                        result = await host.frame();
+                    else if (Object.keys(r).sort().join() === "operation,request" && r.operation === "action")
+                        result = await host.action(dashboardHostRequest(r.request));
+                    else if (Object.keys(r).sort().join() === "key,operation" && r.operation === "human-action" && typeof r.key === "string")
+                        result = await host.humanAction(r.key);
+                    else
+                        throw Error("closed dashboard protocol required");
+                    const output = JSON.stringify({ ok: true, result }) + "\n";
+                    if (Buffer.byteLength(output) > 512 * 1024)
+                        throw Error("dashboard frame bound exceeded");
+                    socket.end(output);
+                }
+                catch {
+                    socket.end(JSON.stringify({ ok: false, error: "refused or acknowledgement unknown; explicit readback only" }) + "\n");
+                }
+            })();
+            tasks.add(task);
+            void task.finally(() => tasks.delete(task));
+        });
+    });
+    await new Promise((resolve, reject) => { server.once("error", reject); server.listen(path, () => { server.off("error", reject); resolve(); }); });
+    try {
+        await chmod(path, 0o600);
+    }
+    catch (error) {
+        server.close();
+        throw error;
+    }
+    return Object.freeze({ path, close: () => new Promise((resolve, reject) => { for (const c of clients)
+            c.destroy(); server.close(e => e ? reject(e) : void Promise.allSettled([...tasks]).then(() => resolve())); }) });
+}
+/** Explicit operator-selected endpoint. Socket ownership is access policy, not module/human authentication. */
+export function connectDashboardHost(path) {
+    const call = async (operation, payload = {}) => {
+        await parent(path);
+        const s = await lstat(path);
+        if (!s.isSocket() || s.mode & 0o077 || s.uid !== process.getuid?.())
+            throw Error("private original dashboard endpoint unavailable");
+        return new Promise((resolve, reject) => {
+            const socket = createConnection(path);
+            let size = 0, done = false;
+            const chunks = [];
+            const fail = (e) => { if (!done) {
+                done = true;
+                socket.destroy();
+                reject(e);
+            } };
+            socket.setTimeout(5000, () => fail(Error("dashboard acknowledgement timeout; do not repeat action")));
+            socket.on("error", fail);
+            socket.on("connect", () => socket.write(JSON.stringify({ operation, ...payload }) + "\n"));
+            socket.on("data", b => { size += b.length; if (size > 512 * 1024) {
+                fail(Error("dashboard frame limit"));
+                return;
+            } chunks.push(b); });
+            socket.on("end", () => { try {
+                const text = new TextDecoder("utf-8", { fatal: true }).decode(Buffer.concat(chunks));
+                const r = parseRetentionJson(text, 512 * 1024);
+                if (r.ok !== true)
+                    throw Error("dashboard refused or acknowledgement unknown");
+                if (operation === "frame" && r.result?.version !== "producer-dashboard-frame-v1")
+                    throw Error("incompatible dashboard host");
+                if (!done) {
+                    done = true;
+                    resolve(r.result);
+                }
+            }
+            catch (e) {
+                fail(e);
+            } });
+            socket.on("close", () => { if (!done)
+                fail(Error("dashboard disconnected; acknowledgement unknown")); });
+        });
+    };
+    const api = { frame: () => call("frame"), action: (r) => call("action", { request: dashboardHostRequest(r) }), humanAction: (key) => call("human-action", { key }) };
+    connections.add(api);
+    return Object.freeze(api);
+}
+//# sourceMappingURL=dashboard-host-transport.js.map

package/dist/dashboard-host-transport.js.map

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

package/dist/dashboard-host.d.ts

@@ -0,0 +1,203 @@
+import { type OrdinaryChildren } from "./ordinary-children.ts";
+import { type GovernedBudgetBinding } from "./resource-budget.ts";
+import { type openExperiment } from "./experiment.ts";
+import { type DashboardHarness, type DashboardHostConfig, type DashboardHostRequest, type DashboardHostAuthority } from "./dashboard-host-contract.ts";
+export * from "./dashboard-host-contract.ts";
+export declare const isDashboardHost: (value: unknown) => value is DashboardHost;
+export type DashboardHost = ReturnType<typeof openDashboardHost>;
+export interface DashboardHostOptions {
+    ordinary?: OrdinaryChildren;
+    harness: DashboardHarness;
+    config: DashboardHostConfig;
+    budget: GovernedBudgetBinding;
+    experiment?: ReturnType<typeof openExperiment>;
+    authority: () => DashboardHostAuthority | null;
+    /** Exact actions constructed and authorized by the owner; the dashboard exposes only human labels/keys. */
+    humanActions?: (context: {
+        hostDigest: string;
+        selectionDigest: string;
+        tip: string;
+        observations: readonly {
+            sourceId: string;
+            checkpointId: string;
+        }[];
+    }) => readonly {
+        key: string;
+        label: string;
+        request: DashboardHostRequest;
+    }[] | Promise<readonly {
+        key: string;
+        label: string;
+        request: DashboardHostRequest;
+    }[]>;
+    /** Explicit approved observation effect only; refresh/frame never invokes it. */
+    beforeObservation?: (sourceId: string) => Promise<void>;
+    /** Independently sourced current declaration. Never inferred from idle, a PID, title or request fields. */
+    presence?: () => {
+        present: boolean;
+        closing: boolean;
+        evidenceDigest: string;
+        expiresAt: number;
+    } | null;
+}
+/** Explicit creation, NEVER called by refresh/reconnect. One fixed host child per registered trust store. */
+export declare function createDashboardHost(options: DashboardHostOptions): Readonly<{
+    hostDigest: string;
+    selectionDigest: string;
+    frame(): Promise<{
+        version: string;
+        hostDigest: string;
+        selectionDigest: string;
+        selectionState: string;
+        tip: string;
+        source: unknown;
+        controls: unknown;
+        debrief: unknown;
+        attention: {
+            policyId: string;
+            attentionUsed: number;
+            tip: string;
+            grantExpansion: false;
+        };
+        error: string | null;
+        actions: {
+            key: string;
+            label: string;
+            operation: string;
+        }[];
+        requests: Record<string, unknown>[];
+        control: string;
+        acknowledgement: string;
+        identity: string;
+        activeBranch: null;
+        acceptance: string;
+        freshness: string;
+        workerInteractions: number;
+    }>;
+    /** Explicit reconciliation is read-only. A retained claim is never replayed as an effect. */
+    reconcile: () => Promise<{
+        version: string;
+        hostDigest: string;
+        selectionDigest: string;
+        selectionState: string;
+        tip: string;
+        source: unknown;
+        controls: unknown;
+        debrief: unknown;
+        attention: {
+            policyId: string;
+            attentionUsed: number;
+            tip: string;
+            grantExpansion: false;
+        };
+        error: string | null;
+        actions: {
+            key: string;
+            label: string;
+            operation: string;
+        }[];
+        requests: Record<string, unknown>[];
+        control: string;
+        acknowledgement: string;
+        identity: string;
+        activeBranch: null;
+        acceptance: string;
+        freshness: string;
+        workerInteractions: number;
+    }>;
+    humanAction(key: string): Promise<{
+        state: string;
+        result?: undefined;
+    } | {
+        state: string;
+        result: unknown;
+    }>;
+    action(input: DashboardHostRequest): Promise<{
+        state: string;
+        result?: undefined;
+    } | {
+        state: string;
+        result: unknown;
+    }>;
+}>;
+/** Existing native writers + original controllers; no model, launch, authority-file loader or PID recovery. */
+export declare function openDashboardHost(options: DashboardHostOptions): Readonly<{
+    hostDigest: string;
+    selectionDigest: string;
+    frame(): Promise<{
+        version: string;
+        hostDigest: string;
+        selectionDigest: string;
+        selectionState: string;
+        tip: string;
+        source: unknown;
+        controls: unknown;
+        debrief: unknown;
+        attention: {
+            policyId: string;
+            attentionUsed: number;
+            tip: string;
+            grantExpansion: false;
+        };
+        error: string | null;
+        actions: {
+            key: string;
+            label: string;
+            operation: string;
+        }[];
+        requests: Record<string, unknown>[];
+        control: string;
+        acknowledgement: string;
+        identity: string;
+        activeBranch: null;
+        acceptance: string;
+        freshness: string;
+        workerInteractions: number;
+    }>;
+    /** Explicit reconciliation is read-only. A retained claim is never replayed as an effect. */
+    reconcile: () => Promise<{
+        version: string;
+        hostDigest: string;
+        selectionDigest: string;
+        selectionState: string;
+        tip: string;
+        source: unknown;
+        controls: unknown;
+        debrief: unknown;
+        attention: {
+            policyId: string;
+            attentionUsed: number;
+            tip: string;
+            grantExpansion: false;
+        };
+        error: string | null;
+        actions: {
+            key: string;
+            label: string;
+            operation: string;
+        }[];
+        requests: Record<string, unknown>[];
+        control: string;
+        acknowledgement: string;
+        identity: string;
+        activeBranch: null;
+        acceptance: string;
+        freshness: string;
+        workerInteractions: number;
+    }>;
+    humanAction(key: string): Promise<{
+        state: string;
+        result?: undefined;
+    } | {
+        state: string;
+        result: unknown;
+    }>;
+    action(input: DashboardHostRequest): Promise<{
+        state: string;
+        result?: undefined;
+    } | {
+        state: string;
+        result: unknown;
+    }>;
+}>;
+//# sourceMappingURL=dashboard-host.d.ts.map

package/dist/dashboard-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-host.d.ts","sourceRoot":"","sources":["../src/dashboard-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,gBAAgB,EAA6B,MAAM,wBAAwB,CAAC;AAOpI,OAAO,EAA6C,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAG7G,OAAO,EAAgF,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEpI,OAAO,EACL,KAAK,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAChJ,cAAc,8BAA8B,CAAC;AAE7C,eAAO,MAAM,eAAe,GAAE,OAAM,OAAO,KAAE,KAAK,IAAI,aAAsE,CAAC;AAC7H,MAAM,MAAM,aAAa,GAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC/D,MAAM,WAAW,oBAAoB;IAAG,QAAQ,CAAC,EAAC,gBAAgB,CAAC;IAAC,OAAO,EAAC,gBAAgB,CAAC;IAAC,MAAM,EAAC,mBAAmB,CAAC;IAAC,MAAM,EAAC,qBAAqB,CAAC;IAAC,UAAU,CAAC,EAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;IAAC,SAAS,EAAC,MAAI,sBAAsB,GAAC,IAAI,CAAC;IAC/O,2GAA2G;IAC3G,YAAY,CAAC,EAAC,CAAC,OAAO,EAAC;QAAC,UAAU,EAAC,MAAM,CAAC;QAAA,eAAe,EAAC,MAAM,CAAC;QAAA,GAAG,EAAC,MAAM,CAAC;QAAA,YAAY,EAAC,SAAS;YAAC,QAAQ,EAAC,MAAM,CAAC;YAAA,YAAY,EAAC,MAAM,CAAA;SAAC,EAAE,CAAA;KAAC,KAAG,SAAS;QAAC,GAAG,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAC;QAAA,OAAO,EAAC,oBAAoB,CAAA;KAAC,EAAE,GAAC,OAAO,CAAC,SAAS;QAAC,GAAG,EAAC,MAAM,CAAC;QAAA,KAAK,EAAC,MAAM,CAAC;QAAA,OAAO,EAAC,oBAAoB,CAAA;KAAC,EAAE,CAAC,CAAC;IAC1R,iFAAiF;IACjF,iBAAiB,CAAC,EAAC,CAAC,QAAQ,EAAC,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,2GAA2G;IAC3G,QAAQ,CAAC,EAAC,MAAI;QAAC,OAAO,EAAC,OAAO,CAAC;QAAA,OAAO,EAAC,OAAO,CAAC;QAAA,cAAc,EAAC,MAAM,CAAC;QAAA,SAAS,EAAC,MAAM,CAAA;KAAC,GAAC,IAAI,CAAC;CAC7F;AAOD,6GAA6G;AAC7G,wBAAgB,mBAAmB,CAAC,OAAO,EAAC,oBAAoB;;;;;;;;;;;;;;;;;;;;iBAyDC,MAAM;mBAAO,MAAM;uBAAW,MAAM;;;;;;;;;;;IASjG,6FAA6F;;;;;;;;;;;;;;;;;;iBAThC,MAAM;mBAAO,MAAM;uBAAW,MAAM;;;;;;;;;;;qBAW3E,MAAM;;;;;;;kBAGT,oBAAoB;;;;;;;GA/D1C;AACD,+GAA+G;AAC/G,wBAAgB,iBAAiB,CAAC,OAAO,EAAC,oBAAoB;;;;;;;;;;;;;;;;;;;;iBA+CG,MAAM;mBAAO,MAAM;uBAAW,MAAM;;;;;;;;;;;IASjG,6FAA6F;;;;;;;;;;;;;;;;;;iBAThC,MAAM;mBAAO,MAAM;uBAAW,MAAM;;;;;;;;;;;qBAW3E,MAAM;;;;;;;kBAGT,oBAAoB;;;;;;;GAsF1C"}