@amalgm/core 0.1.2 → 0.1.3

package/PURPOSE.md

@@ -82,6 +82,11 @@ source until each module is cut over.
     harness discovery may expose auth type and a bounded hint, but secret
     values cross only an explicit authenticated resolution call and never
     enter discovery, logs, or state snapshots.
+14. **A terminal session has one process lifecycle.** Core owns session ids,
+    geometry bounds, peer attachment, exit signaling, and idle teardown;
+    the host supplies the native spawn, path, clock, randomness, and timer
+    effects. A reconnect attaches to the same process rather than creating
+    hidden replacement state.
 
 ## Five surfaces, one behavior
 

package/dist/transport/index.d.ts

@@ -17,6 +17,7 @@ export * from './auth.js';
 export * from './routing.js';
 export * from './shipped-routes.js';
 export * from './state/index.js';
+export * from './pty/index.js';
 export * from './admission.js';
 export * from './ingress.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/index.js

@@ -17,6 +17,7 @@ export * from './auth.js';
 export * from './routing.js';
 export * from './shipped-routes.js';
 export * from './state/index.js';
+export * from './pty/index.js';
 export * from './admission.js';
 export * from './ingress.js';
 //# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/pty/api.d.ts

@@ -0,0 +1,4 @@
+import { PtySessionManager } from './session-manager.js';
+/** Engine parity reference: amalgm-engine/runtime/scripts/local-gateway.js:817-863. */
+export declare function createPtyApi(manager: PtySessionManager): (request: Request) => Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/transport/pty/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/transport/pty/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI5F,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA4BhG"}

package/dist/transport/pty/api.js

@@ -0,0 +1,45 @@
+import { PTY_COLS, PTY_NOT_FOUND, PTY_ROWS, PtySessionManager } from './session-manager.js';
+const JSON_HEADERS = { 'content-type': 'application/json', 'cache-control': 'no-store' };
+/** Engine parity reference: amalgm-engine/runtime/scripts/local-gateway.js:817-863. */
+export function createPtyApi(manager) {
+    return async (request) => {
+        const pathname = new URL(request.url).pathname;
+        if (request.method === 'GET' && pathname === '/pty') {
+            return json(200, { service: 'pty', sessions: manager.list() });
+        }
+        if (request.method === 'GET' && pathname === '/pty/session') {
+            return json(200, { sessions: manager.list() });
+        }
+        if (request.method === 'GET' && pathname === '/pty/resize') {
+            return json(200, { cols: PTY_COLS, rows: PTY_ROWS, sessions: manager.list() });
+        }
+        if (request.method === 'POST' && pathname === '/pty/session') {
+            const session = manager.create(await body(request));
+            return json(200, { success: true, sessionId: session.id, wsPath: `/pty/${session.id}/connect` });
+        }
+        if (request.method === 'POST' && pathname === '/pty/resize') {
+            const input = await body(request);
+            if (!manager.resize(input))
+                return json(404, { error: PTY_NOT_FOUND });
+            return json(200, { success: true });
+        }
+        if (request.method === 'DELETE' && pathname === '/pty/session') {
+            manager.destroy((await body(request)).sessionId);
+            return json(200, { success: true });
+        }
+        return json(404, { error: 'Unknown PTY route' });
+    };
+}
+async function body(request) {
+    const text = await request.text();
+    if (!text)
+        return {};
+    const parsed = JSON.parse(text);
+    return parsed && typeof parsed === 'object' && !Array.isArray(parsed)
+        ? parsed
+        : {};
+}
+function json(status, value) {
+    return new Response(JSON.stringify(value), { status, headers: JSON_HEADERS });
+}
+//# sourceMappingURL=api.js.map

package/dist/transport/pty/api.js.map

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

package/dist/transport/pty/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './session-manager.js';
+export * from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/pty/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/pty/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC"}

package/dist/transport/pty/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './session-manager.js';
+export * from './api.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/pty/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/pty/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC"}

package/dist/transport/pty/session-manager.d.ts

@@ -0,0 +1,45 @@
+import type { CreatePtySessionInput, PtyGeometry, PtyPeer, PtySessionManagerOptions, PtySessionSummary, ResizePtySessionInput } from './types.js';
+/**
+ * Engine parity reference:
+ * amalgm-engine/runtime/scripts/local-gateway.js:777-904
+ *
+ * This is the process/session decision core only. Native PTY loading,
+ * WebSocket framing, paths, clocks, randomness, and timers remain injected
+ * host effects under Core axiom 6.
+ */
+export declare const PTY_COLS: {
+    readonly default: 80;
+    readonly min: 20;
+    readonly max: 400;
+};
+export declare const PTY_ROWS: {
+    readonly default: 24;
+    readonly min: 5;
+    readonly max: 200;
+};
+export declare const PTY_IDLE_TIMEOUT_MS = 30000;
+export declare const PTY_NOT_FOUND = "PTY session not found";
+export declare const PTY_EXIT_CLOSE: {
+    readonly code: 1000;
+    readonly reason: "PTY process exited";
+};
+export declare const PTY_MISSING_CLOSE: {
+    readonly code: 4404;
+    readonly reason: "PTY session not found";
+};
+export declare class PtySessionManager {
+    #private;
+    constructor(options: PtySessionManagerOptions);
+    create(input?: CreatePtySessionInput): PtySessionSummary;
+    list(): PtySessionSummary[];
+    has(sessionId: string): boolean;
+    resize(input: ResizePtySessionInput): boolean;
+    destroy(sessionId: unknown): void;
+    attach(sessionId: string, peer: PtyPeer): boolean;
+    closeAll(): void;
+}
+export declare function normalizePtyGeometry(input: {
+    readonly cols?: unknown;
+    readonly rows?: unknown;
+}): PtyGeometry;
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/transport/pty/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/transport/pty/session-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EAErB,WAAW,EACX,OAAO,EAEP,wBAAwB,EACxB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AAEH,eAAO,MAAM,QAAQ;;;;CAA8C,CAAC;AACpE,eAAO,MAAM,QAAQ;;;;CAA6C,CAAC;AACnE,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,aAAa,0BAA0B,CAAC;AACrD,eAAO,MAAM,cAAc;;;CAAwD,CAAC;AACpF,eAAO,MAAM,iBAAiB;;;CAAiD,CAAC;AAchF,qBAAa,iBAAiB;;gBAIhB,OAAO,EAAE,wBAAwB;IAI7C,MAAM,CAAC,KAAK,GAAE,qBAA0B,GAAG,iBAAiB;IAmC5D,IAAI,IAAI,iBAAiB,EAAE;IAI3B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO;IAU7C,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAQjC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAgBjD,QAAQ,IAAI,IAAI;CA+BjB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,WAAW,CAK7G"}

package/dist/transport/pty/session-manager.js

@@ -0,0 +1,143 @@
+/**
+ * Engine parity reference:
+ * amalgm-engine/runtime/scripts/local-gateway.js:777-904
+ *
+ * This is the process/session decision core only. Native PTY loading,
+ * WebSocket framing, paths, clocks, randomness, and timers remain injected
+ * host effects under Core axiom 6.
+ */
+export const PTY_COLS = { default: 80, min: 20, max: 400 };
+export const PTY_ROWS = { default: 24, min: 5, max: 200 };
+export const PTY_IDLE_TIMEOUT_MS = 30_000;
+export const PTY_NOT_FOUND = 'PTY session not found';
+export const PTY_EXIT_CLOSE = { code: 1000, reason: 'PTY process exited' };
+export const PTY_MISSING_CLOSE = { code: 4404, reason: PTY_NOT_FOUND };
+export class PtySessionManager {
+    #options;
+    #sessions = new Map();
+    constructor(options) {
+        this.#options = options;
+    }
+    create(input = {}) {
+        const geometry = normalizePtyGeometry(input);
+        const requestedCwd = typeof input.cwd === 'string' ? input.cwd : '';
+        const cwd = requestedCwd && this.#options.isAbsolutePath(requestedCwd)
+            ? requestedCwd
+            : this.#options.defaultCwd;
+        const createdAt = this.#options.now();
+        const id = `pty-${createdAt}-${this.#options.randomHex(4)}`;
+        const proc = this.#options.spawn({
+            shell: this.#options.shell,
+            name: 'xterm-256color',
+            ...geometry,
+            cwd,
+            env: {
+                ...this.#options.env,
+                TERM: 'xterm-256color',
+                LANG: this.#options.env.LANG || 'en_US.UTF-8',
+            },
+        });
+        const session = {
+            id,
+            proc,
+            cwd,
+            shell: this.#options.shell,
+            createdAt,
+            cols: geometry.cols,
+            rows: geometry.rows,
+            clients: new Map(),
+            exitSubscription: { dispose() { } },
+        };
+        session.exitSubscription = proc.onExit(({ exitCode }) => this.#onExit(session, exitCode));
+        this.#sessions.set(id, session);
+        return summary(session);
+    }
+    list() {
+        return [...this.#sessions.values()].map(summary);
+    }
+    has(sessionId) {
+        return this.#sessions.has(sessionId);
+    }
+    resize(input) {
+        const session = this.#sessions.get(String(input.sessionId || ''));
+        if (!session)
+            return false;
+        const geometry = normalizePtyGeometry(input);
+        session.proc.resize(geometry.cols, geometry.rows);
+        session.cols = geometry.cols;
+        session.rows = geometry.rows;
+        return true;
+    }
+    destroy(sessionId) {
+        const id = String(sessionId || '');
+        const session = this.#sessions.get(id);
+        if (!session)
+            return;
+        this.#sessions.delete(id);
+        session.proc.kill();
+    }
+    attach(sessionId, peer) {
+        const session = this.#sessions.get(sessionId);
+        if (!session) {
+            peer.close(PTY_MISSING_CLOSE.code, PTY_MISSING_CLOSE.reason);
+            return false;
+        }
+        const subscriptions = [
+            session.proc.onData((data) => peer.send(data)),
+            peer.onInput((data) => session.proc.write(data)),
+            peer.onClose(() => this.#detach(session, peer)),
+        ];
+        session.clients.set(peer, subscriptions);
+        return true;
+    }
+    closeAll() {
+        const sessions = [...this.#sessions.values()];
+        this.#sessions.clear();
+        for (const session of sessions)
+            session.proc.kill();
+    }
+    #detach(session, peer) {
+        const subscriptions = session.clients.get(peer);
+        if (!subscriptions)
+            return;
+        session.clients.delete(peer);
+        for (const subscription of subscriptions)
+            subscription.dispose();
+        this.#options.timer.schedule(this.#options.idleTimeoutMs ?? PTY_IDLE_TIMEOUT_MS, () => {
+            if (session.clients.size > 0 || !this.#sessions.has(session.id))
+                return;
+            this.#sessions.delete(session.id);
+            session.proc.kill();
+        });
+    }
+    #onExit(session, exitCode) {
+        for (const [peer, subscriptions] of session.clients) {
+            peer.send(JSON.stringify({ type: 'exit', exitCode }));
+            peer.close(PTY_EXIT_CLOSE.code, PTY_EXIT_CLOSE.reason);
+            for (const subscription of subscriptions)
+                subscription.dispose();
+        }
+        session.clients.clear();
+        session.exitSubscription.dispose();
+        this.#sessions.delete(session.id);
+    }
+}
+export function normalizePtyGeometry(input) {
+    return {
+        cols: Math.max(PTY_COLS.min, Math.min(PTY_COLS.max, Number(input.cols || PTY_COLS.default))),
+        rows: Math.max(PTY_ROWS.min, Math.min(PTY_ROWS.max, Number(input.rows || PTY_ROWS.default))),
+    };
+}
+function summary(session) {
+    return {
+        id: session.id,
+        cwd: session.cwd,
+        shell: session.shell,
+        createdAt: session.createdAt,
+        cols: session.cols,
+        rows: session.rows,
+        clients: session.clients.size,
+        ...(session.proc.pid === undefined ? {} : { pid: session.proc.pid }),
+    };
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/transport/pty/session-manager.js.map

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

package/dist/transport/pty/types.d.ts

@@ -0,0 +1,64 @@
+export interface Disposable {
+    dispose(): void;
+}
+export interface PtyGeometry {
+    readonly cols: number;
+    readonly rows: number;
+}
+export interface PtySpawnSpec extends PtyGeometry {
+    readonly name: 'xterm-256color';
+    readonly cwd: string;
+    readonly shell: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+}
+/** Native process boundary. Hosts adapt node-pty; Core never imports it. */
+export interface PtyProcess {
+    readonly pid?: number;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+    onData(listener: (data: string) => void): Disposable;
+    onExit(listener: (event: {
+        readonly exitCode: number;
+    }) => void): Disposable;
+}
+/** WebSocket-shaped peer boundary. Hosts own framing and ready-state checks. */
+export interface PtyPeer {
+    send(data: string): void;
+    close(code: number, reason: string): void;
+    onInput(listener: (data: string) => void): Disposable;
+    onClose(listener: () => void): Disposable;
+}
+export interface PtyTimerPort {
+    schedule(delayMs: number, callback: () => void): Disposable;
+}
+export interface PtySessionSummary extends PtyGeometry {
+    readonly id: string;
+    readonly cwd: string;
+    readonly shell: string;
+    readonly createdAt: number;
+    readonly clients: number;
+    readonly pid?: number;
+}
+export interface CreatePtySessionInput {
+    readonly cols?: unknown;
+    readonly rows?: unknown;
+    readonly cwd?: unknown;
+}
+export interface ResizePtySessionInput {
+    readonly sessionId?: unknown;
+    readonly cols?: unknown;
+    readonly rows?: unknown;
+}
+export interface PtySessionManagerOptions {
+    readonly spawn: (spec: PtySpawnSpec) => PtyProcess;
+    readonly timer: PtyTimerPort;
+    readonly now: () => number;
+    readonly randomHex: (bytes: number) => string;
+    readonly isAbsolutePath: (path: string) => boolean;
+    readonly defaultCwd: string;
+    readonly shell: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly idleTimeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/pty/types.d.ts.map

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

package/dist/transport/pty/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/pty/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/transport/pty/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "The Amalgm kernel SDK — identity, transport, supervision, and host capability contracts behind host-injected adapters.",
   "type": "module",
   "license": "UNLICENSED",
@@ -32,6 +32,10 @@
       "types": "./dist/transport/state/index.d.ts",
       "default": "./dist/transport/state/index.js"
     },
+    "./pty": {
+      "types": "./dist/transport/pty/index.d.ts",
+      "default": "./dist/transport/pty/index.js"
+    },
     "./supervision": {
       "types": "./dist/supervision/index.d.ts",
       "default": "./dist/supervision/index.js"