@amalgm/shell 0.1.0

package/dist/pty-host.js

@@ -0,0 +1,141 @@
+import { randomBytes } from "node:crypto";
+import { existsSync, chmodSync } from "node:fs";
+import { isAbsolute, dirname, join } from "node:path";
+import { createRequire } from "node:module";
+import { platform } from "node:os";
+import * as nativePty from "@homebridge/node-pty-prebuilt-multiarch";
+import { createPtyApi, PtySessionManager, } from "@amalgm/core/pty";
+import { WS_CLOSE_UNAUTHORIZED, } from "@amalgm/core/transport";
+import { WebSocket, WebSocketServer } from "ws";
+/** Native effects for Core's PTY law; Engine reference local-gateway.js:33-47,333-346,777-904. */
+export function createPtyHost(config) {
+    ensureSpawnHelperExecutable();
+    const manager = new PtySessionManager({
+        spawn: (spec) => adaptProcess(nativePty.spawn(spec.shell, [], spec)),
+        timer: {
+            schedule(delayMs, callback) {
+                const handle = setTimeout(callback, delayMs);
+                handle.unref();
+                return { dispose: () => clearTimeout(handle) };
+            },
+        },
+        now: Date.now,
+        randomHex: (bytes) => randomBytes(bytes).toString("hex"),
+        isAbsolutePath: isAbsolute,
+        defaultCwd: config.env.AMALGM_DEFAULT_CWD || config.defaultCwd,
+        shell: config.env.SHELL || (platform() === "win32" ? "powershell.exe" : "/bin/zsh"),
+        env: config.env,
+    });
+    const api = createPtyApi(manager);
+    const wss = new WebSocketServer({ noServer: true });
+    return {
+        manager,
+        mount: {
+            prefix: "/pty",
+            stream: async (req, res, pathname) => {
+                try {
+                    const response = await api(await fetchRequest(req, pathname));
+                    res.writeHead(response.status, Object.fromEntries(response.headers.entries()));
+                    res.end(Buffer.from(await response.arrayBuffer()));
+                }
+                catch (error) {
+                    res.writeHead(500, { "content-type": "application/json" });
+                    res.end(JSON.stringify({ error: error instanceof Error ? error.message : "internal error" }));
+                }
+            },
+        },
+        upgrade: {
+            prefix: "/pty",
+            handle(req, socket, head, authorized) {
+                wss.handleUpgrade(req, socket, head, (ws) => {
+                    if (!authorized) {
+                        ws.close(WS_CLOSE_UNAUTHORIZED.code, WS_CLOSE_UNAUTHORIZED.reason);
+                        return;
+                    }
+                    const pathname = new URL(req.url ?? "/", "http://pty.local").pathname;
+                    const sessionId = pathname.match(/^\/pty\/([^/]+)\/connect$/)?.[1] ?? "";
+                    manager.attach(sessionId, adaptPeer(ws));
+                });
+            },
+        },
+        close() {
+            manager.closeAll();
+        },
+    };
+}
+function adaptProcess(proc) {
+    return {
+        pid: proc.pid,
+        write: (data) => proc.write(data),
+        resize: (cols, rows) => proc.resize(cols, rows),
+        kill: () => proc.kill(),
+        onData: (listener) => proc.onData(listener),
+        onExit: (listener) => proc.onExit(listener),
+    };
+}
+function adaptPeer(ws) {
+    return {
+        send(data) {
+            if (ws.readyState === WebSocket.OPEN)
+                ws.send(data);
+        },
+        close(code, reason) {
+            ws.close(code, reason);
+        },
+        onInput(listener) {
+            const receive = (data) => listener(rawText(data));
+            ws.on("message", receive);
+            return { dispose: () => ws.off("message", receive) };
+        },
+        onClose(listener) {
+            ws.on("close", listener);
+            return { dispose: () => ws.off("close", listener) };
+        },
+    };
+}
+function rawText(data) {
+    if (Buffer.isBuffer(data))
+        return data.toString("utf8");
+    if (data instanceof ArrayBuffer)
+        return Buffer.from(data).toString("utf8");
+    return Buffer.concat([...data]).toString("utf8");
+}
+function ensureSpawnHelperExecutable() {
+    try {
+        const require = createRequire(import.meta.url);
+        const root = dirname(require.resolve("@homebridge/node-pty-prebuilt-multiarch/package.json"));
+        for (const helper of [
+            join(root, "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper"),
+            join(root, "build", "Release", "spawn-helper"),
+        ]) {
+            if (existsSync(helper))
+                chmodSync(helper, 0o755);
+        }
+    }
+    catch {
+        // Best effort: spawn reports the underlying platform error if no helper is used.
+    }
+}
+async function fetchRequest(req, pathname) {
+    const url = new URL(req.url ?? pathname, "http://pty.local");
+    const headers = new Headers();
+    for (const [name, value] of Object.entries(req.headers)) {
+        if (Array.isArray(value))
+            for (const item of value)
+                headers.append(name, item);
+        else if (value !== undefined)
+            headers.set(name, value);
+    }
+    const method = req.method ?? "GET";
+    const chunks = [];
+    if (method !== "GET" && method !== "HEAD") {
+        for await (const chunk of req)
+            chunks.push(chunk);
+    }
+    return new Request(`http://pty.local${pathname}${url.search}`, {
+        method,
+        headers,
+        body: chunks.length ? Buffer.concat(chunks) : undefined,
+    });
+}
+//# sourceMappingURL=pty-host.js.map

package/dist/pty-host.js.map

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

package/dist/release-catalog.d.ts

@@ -0,0 +1,5 @@
+import type { ReleaseCatalogVerifierPort, SignedReleaseCatalog } from "@amalgm/core/supervision";
+/** Signed once by the Shell release authority. The private key is not part of
+ * the package; changing this graph requires a newly signed release. */
+export declare const shellReleaseCatalog: SignedReleaseCatalog;
+export declare const shellReleaseVerifier: ReleaseCatalogVerifierPort;

package/dist/release-catalog.js

@@ -0,0 +1,23 @@
+import { createPublicKey, verify } from "node:crypto";
+const RELEASE_KEY = `-----BEGIN PUBLIC KEY-----
+MCowBQYDK2VwAyEANMqhSyyHbFnlzR/e7O7OaykWb5zZ73OXCmP+An5/hUc=
+-----END PUBLIC KEY-----`;
+/** Signed once by the Shell release authority. The private key is not part of
+ * the package; changing this graph requires a newly signed release. */
+export const shellReleaseCatalog = Object.freeze({
+    releaseId: "shell-registration-0.1.0",
+    keyId: "shell-registration-2026-08",
+    services: Object.freeze([
+        { id: "core", dependencies: [] },
+        { id: "files", dependencies: ["core"] },
+    ]),
+    signature: "KvhNC0EuTFuDaeunhsKzY-iKT0N5NZyKzCmyVN-uVNjkkHZ16yAwIf22vhlFFc3MhJZwejWWwS5dU7KrsE4zBQ",
+});
+const releaseKey = createPublicKey(RELEASE_KEY);
+export const shellReleaseVerifier = Object.freeze({
+    verify(payload, signature, keyId) {
+        return keyId === shellReleaseCatalog.keyId
+            && verify(null, Buffer.from(payload), releaseKey, Buffer.from(signature, "base64url"));
+    },
+});
+//# sourceMappingURL=release-catalog.js.map

package/dist/release-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-catalog.js","sourceRoot":"","sources":["../src/release-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOtD,MAAM,WAAW,GAAG;;yBAEK,CAAC;AAE1B;uEACuE;AACvE,MAAM,CAAC,MAAM,mBAAmB,GAAyB,MAAM,CAAC,MAAM,CAAC;IACrE,SAAS,EAAE,0BAA0B;IACrC,KAAK,EAAE,4BAA4B;IACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;QACtB,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;QAChC,EAAE,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE;KACxC,CAAC;IACF,SAAS,EAAE,wFAAwF;CACpG,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAA+B,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAa;QACtD,OAAO,KAAK,KAAK,mBAAmB,CAAC,KAAK;eACrC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3F,CAAC;CACF,CAAC,CAAC"}

package/dist/state-host.d.ts

@@ -0,0 +1,4 @@
+import { StateRail } from "@amalgm/core/state";
+import type { BrickMount } from "./gateway.js";
+/** Node socket adapter for Core's portable Fetch state surface. */
+export declare function stateMount(rail: StateRail): BrickMount;

package/dist/state-host.js

@@ -0,0 +1,67 @@
+import { createStateApi } from "@amalgm/core/state";
+/** Node socket adapter for Core's portable Fetch state surface. */
+export function stateMount(rail) {
+    const api = createStateApi(rail);
+    return {
+        prefix: "/state",
+        stream: async (req, res, pathname) => {
+            const abort = new AbortController();
+            const disconnect = () => abort.abort();
+            req.once("aborted", disconnect);
+            res.once("close", disconnect);
+            try {
+                const request = await fetchRequest(req, pathname, abort.signal);
+                const response = await api(request);
+                res.writeHead(response.status, Object.fromEntries(response.headers.entries()));
+                if (!response.body) {
+                    res.end();
+                    return;
+                }
+                const reader = response.body.getReader();
+                try {
+                    while (!res.destroyed) {
+                        const chunk = await reader.read();
+                        if (chunk.done)
+                            break;
+                        res.write(Buffer.from(chunk.value));
+                    }
+                }
+                finally {
+                    await reader.cancel().catch(() => { });
+                }
+                if (!res.writableEnded)
+                    res.end();
+            }
+            catch (error) {
+                if (res.headersSent || res.destroyed)
+                    return;
+                res.writeHead(500, { "content-type": "application/json" });
+                res.end(JSON.stringify({ error: error instanceof Error ? error.message : "internal error" }));
+            }
+        },
+    };
+}
+async function fetchRequest(req, pathname, signal) {
+    const url = new URL(req.url ?? pathname, "http://state.local");
+    const headers = new Headers();
+    for (const [name, value] of Object.entries(req.headers)) {
+        if (Array.isArray(value))
+            for (const item of value)
+                headers.append(name, item);
+        else if (value !== undefined)
+            headers.set(name, value);
+    }
+    const method = req.method ?? "GET";
+    const chunks = [];
+    if (method !== "GET" && method !== "HEAD") {
+        for await (const chunk of req)
+            chunks.push(chunk);
+    }
+    return new Request(`http://state.local${pathname}${url.search}`, {
+        method,
+        headers,
+        signal,
+        body: chunks.length ? Buffer.concat(chunks) : undefined,
+    });
+}
+//# sourceMappingURL=state-host.js.map

package/dist/state-host.js.map

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

package/dist/state-store.d.ts

@@ -0,0 +1,15 @@
+import type { StateEvent, StateEventInput, StateEventStore } from "@amalgm/core/state";
+/** Core's host port backed by a bounded, restart-safe local event tail. */
+export declare class FileStateEventStore implements StateEventStore {
+    #private;
+    constructor(file: string, options?: {
+        maxEvents?: number;
+    });
+    currentSeq(): number;
+    append(input: StateEventInput, ts: string): StateEvent;
+    listAfter(after: number, limit: number): readonly StateEvent[];
+    bounds(): {
+        minSeq: number;
+        maxSeq: number;
+    };
+}

package/dist/state-store.js

@@ -0,0 +1,63 @@
+import { appendFileSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/** Core's host port backed by a bounded, restart-safe local event tail. */
+export class FileStateEventStore {
+    #file;
+    #maxEvents;
+    #events;
+    #seq;
+    constructor(file, options = {}) {
+        this.#file = file;
+        this.#maxEvents = Math.max(1, Math.floor(options.maxEvents ?? 5000));
+        this.#events = readEvents(file).slice(-this.#maxEvents);
+        this.#seq = this.#events.at(-1)?.seq ?? 0;
+    }
+    currentSeq() {
+        return this.#seq;
+    }
+    append(input, ts) {
+        const event = { seq: ++this.#seq, ts, ...input };
+        mkdirSync(dirname(this.#file), { recursive: true });
+        appendFileSync(this.#file, `${JSON.stringify(event)}\n`, "utf8");
+        this.#events.push(event);
+        if (this.#events.length > this.#maxEvents) {
+            this.#events.splice(0, this.#events.length - this.#maxEvents);
+            const temporary = `${this.#file}.${process.pid}.tmp`;
+            writeFileSync(temporary, this.#events.map((row) => JSON.stringify(row)).join("\n") + "\n", "utf8");
+            renameSync(temporary, this.#file);
+        }
+        return event;
+    }
+    listAfter(after, limit) {
+        return this.#events.filter((event) => event.seq > after).slice(0, limit);
+    }
+    bounds() {
+        return { minSeq: this.#events[0]?.seq ?? 0, maxSeq: this.#events.at(-1)?.seq ?? 0 };
+    }
+}
+function readEvents(file) {
+    let text;
+    try {
+        text = readFileSync(file, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return [];
+        throw error;
+    }
+    const events = [];
+    for (const line of text.split("\n")) {
+        if (!line)
+            continue;
+        try {
+            const event = JSON.parse(line);
+            if (Number.isInteger(event.seq) && event.seq > 0)
+                events.push(event);
+        }
+        catch {
+            // A torn final append is not an event; earlier complete rows remain truth.
+        }
+    }
+    return events.sort((left, right) => left.seq - right.seq);
+}
+//# sourceMappingURL=state-store.js.map

package/dist/state-store.js.map

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

package/dist/user-ground-host.d.ts

@@ -0,0 +1,58 @@
+import { type UserGroundPort, type UserHomeDeclaration } from "@amalgm/core/identity";
+import { type EntityType, type UserGroundIdentity } from "@amalgm/live";
+interface GroundRow {
+    readonly uuid: string;
+    readonly type: EntityType;
+    readonly parentUUID: string | null;
+    readonly name: string;
+    readonly status: "active";
+    readonly version: string;
+    readonly payloadVersion: string | null;
+    readonly transportVersion: string | null;
+    readonly relativePath: string;
+    readonly absolutePath: string;
+    readonly deviceNumber: number;
+    readonly inode: number;
+}
+export interface UserGroundHostOptions {
+    readonly amalgmRoot: string;
+    readonly deviceId: string;
+    readonly tunnelUrl: string;
+    readonly tunnelToken: string;
+    readonly runtimeVersion: string;
+    readonly declaration?: UserHomeDeclaration;
+    readonly now?: () => Date;
+}
+/** The production Files port injected into Core. Portable identity remains in
+ * Live; this class owns only Node filesystem, SQLite, Watch, and wire effects. */
+export declare class UserGroundHost {
+    private readonly options;
+    private readonly wire;
+    private readonly watchers;
+    private activeIdentity;
+    private rescanTimer;
+    private cloudState;
+    private syncing;
+    readonly port: UserGroundPort;
+    constructor(options: UserGroundHostOptions);
+    databasePath(identity: UserGroundIdentity): string;
+    rows(identity: UserGroundIdentity): GroundRow[];
+    /** Make every observed filesystem change durable in SQLite, immutable
+     * content storage, and the official cloud head before returning. */
+    flush(): Promise<void>;
+    activateRuntimeTunnel(gatewayPort: number, runtimeToken: string): Promise<void>;
+    stopRuntimeTunnel(): Promise<void>;
+    close(): Promise<void>;
+    private userRoot;
+    private cacheDir;
+    private cloudPort;
+    private localPort;
+    private uploadSnapshotContent;
+    private downloadContent;
+    private ensureWatchers;
+    private scheduleRescan;
+    private syncLocalChanges;
+    private drainOutboxBeforeLookup;
+    private drainOutbox;
+}
+export {};