@amalgm/shell 0.1.126 → 0.1.128

package/dist/workspace-add-staging.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Direct-to-staging content placement for Cold Add.
+ *
+ * During Cold Add each ordinary file's bytes are written once, directly into
+ * their hidden staged destination: every chunk is verified before its
+ * positioned write, the whole-file hash is proven from that same stream, the
+ * complete file is fsynced, and the workspace is revealed later by one atomic
+ * rename. A second cache copy is not part of the critical path.
+ *
+ * SQLite chunk evidence makes an interrupted staging resumable. Retained
+ * staged bytes are never trusted: every retained chunk is re-read and
+ * re-hashed against its manifest before it may satisfy the download, and the
+ * whole-file digest is proven again from that same stream.
+ */
+import type { ContentManifest, TransferArtifact } from "@amalgm/live";
+import type { SealedContentFile } from "./content-cache-host.js";
+/** The shape every download-set target satisfies, whether it stages bytes in
+ * the machine cache or directly inside a hidden Add staging root. */
+export interface ContentDownloadTarget {
+    hasChunk(index: number): Promise<boolean>;
+    putChunk(index: number, bytes: Uint8Array): Promise<void>;
+    seal(): Promise<SealedContentFile>;
+    close(): Promise<void>;
+}
+/** Routing one download set applies when an Add stages ordinary files
+ * directly: which content hashes land at which staged destinations, and
+ * where their durable resume evidence lives. */
+export interface AddStagingRouting {
+    readonly evidenceDir: string;
+    readonly destinations: ReadonlyMap<string, readonly string[]>;
+}
+/** The device-scoped home of one workspace Add's staging resume evidence.
+ * It lives beside the ground database — never inside the staging root, which
+ * the reveal renames into user-visible ground. */
+export declare function addStagingEvidenceDir(databasePath: string, workspaceId: string): string;
+export declare function clearAddStagingEvidence(databasePath: string, workspaceId: string): void;
+/** Chunk-level resume evidence for one Add's staged files. Disposable: the
+ * staged bytes are re-proven against the manifest whenever a row is used. */
+declare class AddStagingEvidence {
+    private readonly database;
+    constructor(evidenceDir: string);
+    chunk(contentHash: string, index: number): {
+        sha256: string;
+        bytes: number;
+    } | null;
+    record(contentHash: string, index: number, sha256: string, bytes: number): void;
+    forget(contentHash: string, index: number): void;
+    close(): void;
+}
+/** One ordinary file downloading directly into its staged destination.
+ *
+ * Chunks may arrive in any order; each lands with a positioned write, and a
+ * serialized drain feeds the whole-file hasher strictly in chunk order — from
+ * the arriving bytes when the next expected chunk is at hand, otherwise by
+ * reading an already-written later chunk when its turn arrives. This keeps no
+ * unaccounted buffers and cannot deadlock failure settlement. Resume rereads
+ * every retained chunk by necessity so local staging can never stand in for
+ * content proof. */
+export declare class StagedContentFile implements ContentDownloadTarget {
+    private readonly evidence;
+    readonly artifact: TransferArtifact;
+    readonly manifest: ContentManifest;
+    private readonly destinations;
+    private readonly primary;
+    private readonly offsets;
+    private readonly hasher;
+    private readonly ready;
+    private nextChunk;
+    private hashTurn;
+    private prepared;
+    private sealed;
+    constructor(evidence: AddStagingEvidence, artifact: TransferArtifact, manifest: ContentManifest, destinations: readonly string[]);
+    private prepare;
+    /** Feed the whole-file hasher every chunk that is now in order. Turns are
+     * serialized: parallel chunk arrivals only mark readiness. */
+    private queueHash;
+    /** Re-prove one retained staged chunk before it may satisfy the download.
+     * Evidence rows only say what should be there; the bytes decide. */
+    hasChunk(index: number): Promise<boolean>;
+    /** Persist one block already verified by @amalgm/live with a positioned
+     * write, then advance the streaming whole-file proof. */
+    putChunk(index: number, bytes: Uint8Array): Promise<void>;
+    /** Prove the streamed whole-file digest, fsync, and place every duplicate
+     * destination. The staged file needs no rename of its own: the whole
+     * staging root is revealed by one atomic rename after rows commit. */
+    seal(): Promise<SealedContentFile>;
+    /** Keep staged bytes and evidence for the next attempt. */
+    close(): Promise<void>;
+}
+/** One evidence database shared by every staged file in a download set. */
+export declare class StagedContentSet {
+    private readonly evidence;
+    private closed;
+    constructor(evidenceDir: string);
+    target(artifact: TransferArtifact, manifest: ContentManifest, destinations: readonly string[]): StagedContentFile;
+    close(): void;
+}
+export {};

package/dist/workspace-add-staging.js

@@ -0,0 +1,306 @@
+/**
+ * Direct-to-staging content placement for Cold Add.
+ *
+ * During Cold Add each ordinary file's bytes are written once, directly into
+ * their hidden staged destination: every chunk is verified before its
+ * positioned write, the whole-file hash is proven from that same stream, the
+ * complete file is fsynced, and the workspace is revealed later by one atomic
+ * rename. A second cache copy is not part of the critical path.
+ *
+ * SQLite chunk evidence makes an interrupted staging resumable. Retained
+ * staged bytes are never trusted: every retained chunk is re-read and
+ * re-hashed against its manifest before it may satisfy the download, and the
+ * whole-file digest is proven again from that same stream.
+ */
+import { createHash } from "node:crypto";
+import { chmodSync, constants, rmSync } from "node:fs";
+import { open } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import Database from "better-sqlite3";
+import { atomicCopy, ensurePrivateDir, ensureUserDir } from "./filesystem.js";
+const sha256Hex = (input) => createHash("sha256").update(input).digest("hex");
+/** The device-scoped home of one workspace Add's staging resume evidence.
+ * It lives beside the ground database — never inside the staging root, which
+ * the reveal renames into user-visible ground. */
+export function addStagingEvidenceDir(databasePath, workspaceId) {
+    return join(dirname(databasePath), "add-staging", workspaceId);
+}
+export function clearAddStagingEvidence(databasePath, workspaceId) {
+    rmSync(addStagingEvidenceDir(databasePath, workspaceId), { recursive: true, force: true });
+}
+/** Chunk-level resume evidence for one Add's staged files. Disposable: the
+ * staged bytes are re-proven against the manifest whenever a row is used. */
+class AddStagingEvidence {
+    database;
+    constructor(evidenceDir) {
+        ensurePrivateDir(evidenceDir);
+        this.database = new Database(join(evidenceDir, "staging.sqlite"));
+        this.database.pragma("busy_timeout = 5000");
+        this.database.pragma("journal_mode = WAL");
+        this.database.pragma("synchronous = NORMAL");
+        this.database.exec(`
+      CREATE TABLE IF NOT EXISTS staged_blocks (
+        content_hash TEXT NOT NULL,
+        block_index INTEGER NOT NULL,
+        sha256 TEXT NOT NULL,
+        bytes INTEGER NOT NULL,
+        PRIMARY KEY (content_hash, block_index)
+      );
+    `);
+    }
+    chunk(contentHash, index) {
+        const row = this.database.prepare(`
+      SELECT sha256, bytes FROM staged_blocks WHERE content_hash = ? AND block_index = ?
+    `).get(contentHash, index);
+        return row ?? null;
+    }
+    record(contentHash, index, sha256, bytes) {
+        this.database.prepare(`
+      INSERT INTO staged_blocks (content_hash, block_index, sha256, bytes)
+      VALUES (?, ?, ?, ?)
+      ON CONFLICT (content_hash, block_index) DO UPDATE SET
+        sha256 = excluded.sha256,
+        bytes = excluded.bytes
+    `).run(contentHash, index, sha256, bytes);
+    }
+    forget(contentHash, index) {
+        this.database.prepare(`
+      DELETE FROM staged_blocks WHERE content_hash = ? AND block_index = ?
+    `).run(contentHash, index);
+    }
+    close() {
+        this.database.close();
+    }
+}
+async function readFileRange(file, offset, bytes) {
+    const handle = await openRegularFile(file, constants.O_RDONLY | constants.O_NOFOLLOW);
+    const output = Buffer.allocUnsafe(bytes);
+    try {
+        let cursor = 0;
+        while (cursor < bytes) {
+            const result = await handle.read(output, cursor, bytes - cursor, offset + cursor);
+            if (result.bytesRead === 0)
+                throw new Error("staged content range is truncated");
+            cursor += result.bytesRead;
+        }
+        return output;
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function writeFileRange(file, offset, bytes) {
+    const handle = await openRegularFile(file, constants.O_RDWR | constants.O_NOFOLLOW);
+    try {
+        let cursor = 0;
+        while (cursor < bytes.byteLength) {
+            const result = await handle.write(bytes, cursor, bytes.byteLength - cursor, offset + cursor);
+            if (result.bytesWritten === 0)
+                throw new Error("staged content write made no progress");
+            cursor += result.bytesWritten;
+        }
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function fsyncFile(file) {
+    const handle = await openRegularFile(file, constants.O_RDWR | constants.O_NOFOLLOW);
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+/** Open only the regular file named at this exact path. Retained staging is
+ * untrusted until re-proven, so neither a stale symlink nor a special file may
+ * redirect Add's reads, writes, truncation, or durability boundary. */
+async function openRegularFile(file, flags, mode) {
+    const handle = await open(file, flags, mode);
+    try {
+        if (!(await handle.stat()).isFile()) {
+            throw new Error(`staged content is not a regular file: ${file}`);
+        }
+        return handle;
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+}
+/** One ordinary file downloading directly into its staged destination.
+ *
+ * Chunks may arrive in any order; each lands with a positioned write, and a
+ * serialized drain feeds the whole-file hasher strictly in chunk order — from
+ * the arriving bytes when the next expected chunk is at hand, otherwise by
+ * reading an already-written later chunk when its turn arrives. This keeps no
+ * unaccounted buffers and cannot deadlock failure settlement. Resume rereads
+ * every retained chunk by necessity so local staging can never stand in for
+ * content proof. */
+export class StagedContentFile {
+    evidence;
+    artifact;
+    manifest;
+    destinations;
+    primary;
+    offsets;
+    hasher = createHash("sha256");
+    ready = new Set();
+    nextChunk = 0;
+    hashTurn = Promise.resolve();
+    prepared = null;
+    sealed = false;
+    constructor(evidence, artifact, manifest, destinations) {
+        this.evidence = evidence;
+        this.artifact = artifact;
+        this.manifest = manifest;
+        this.destinations = destinations;
+        if (destinations.length === 0)
+            throw new Error("staged content has no destination");
+        this.primary = destinations[0];
+        let offset = 0;
+        this.offsets = manifest.chunks.map((chunk) => {
+            const result = offset;
+            offset += chunk.bytes;
+            return result;
+        });
+    }
+    prepare() {
+        if (!this.prepared) {
+            this.prepared = (async () => {
+                ensureUserDir(dirname(this.primary));
+                let handle;
+                try {
+                    handle = await openRegularFile(this.primary, constants.O_RDWR | constants.O_NOFOLLOW);
+                }
+                catch (error) {
+                    if (error.code !== "ENOENT")
+                        throw error;
+                    handle = await openRegularFile(this.primary, constants.O_RDWR | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o644);
+                }
+                try {
+                    await handle.truncate(this.manifest.bytes);
+                }
+                finally {
+                    await handle.close();
+                }
+            })();
+        }
+        return this.prepared;
+    }
+    /** Feed the whole-file hasher every chunk that is now in order. Turns are
+     * serialized: parallel chunk arrivals only mark readiness. */
+    queueHash(arrived, arrivedBytes) {
+        const turn = this.hashTurn.then(async () => {
+            this.ready.add(arrived);
+            while (this.ready.has(this.nextChunk)) {
+                const index = this.nextChunk;
+                const chunk = this.manifest.chunks[index];
+                const offset = this.offsets[index];
+                if (!chunk || offset === undefined)
+                    throw new Error(`content manifest has no chunk ${index}`);
+                const bytes = index === arrived
+                    ? arrivedBytes
+                    : await readFileRange(this.primary, offset, chunk.bytes);
+                this.hasher.update(bytes);
+                this.ready.delete(index);
+                this.nextChunk += 1;
+            }
+        });
+        // A failed turn already rejected its own caller; keep the chain usable so
+        // later chunks fail on their own evidence, not on a poisoned chain.
+        this.hashTurn = turn.catch(() => { });
+        return turn;
+    }
+    /** Re-prove one retained staged chunk before it may satisfy the download.
+     * Evidence rows only say what should be there; the bytes decide. */
+    async hasChunk(index) {
+        const expected = this.manifest.chunks[index];
+        const offset = this.offsets[index];
+        if (!expected || offset === undefined)
+            throw new Error(`content manifest has no chunk ${index}`);
+        const retained = this.evidence.chunk(this.artifact.contentHash, index);
+        if (retained?.sha256 === expected.sha256 && retained.bytes === expected.bytes) {
+            try {
+                const bytes = await readFileRange(this.primary, offset, expected.bytes);
+                if (sha256Hex(bytes) === expected.sha256) {
+                    await this.queueHash(index, bytes);
+                    return true;
+                }
+            }
+            catch {
+                // The staged bytes disappeared or shrank after their evidence row.
+            }
+            this.evidence.forget(this.artifact.contentHash, index);
+        }
+        return false;
+    }
+    /** Persist one block already verified by @amalgm/live with a positioned
+     * write, then advance the streaming whole-file proof. */
+    async putChunk(index, bytes) {
+        const expected = this.manifest.chunks[index];
+        const offset = this.offsets[index];
+        if (!expected || offset === undefined)
+            throw new Error(`content manifest has no chunk ${index}`);
+        if (bytes.byteLength !== expected.bytes)
+            throw new Error("content block byte count is invalid");
+        await this.prepare();
+        await writeFileRange(this.primary, offset, bytes);
+        this.evidence.record(this.artifact.contentHash, index, expected.sha256, expected.bytes);
+        await this.queueHash(index, bytes);
+    }
+    /** Prove the streamed whole-file digest, fsync, and place every duplicate
+     * destination. The staged file needs no rename of its own: the whole
+     * staging root is revealed by one atomic rename after rows commit. */
+    async seal() {
+        if (this.sealed)
+            throw new Error("staged artifact is already sealed");
+        this.sealed = true;
+        await this.prepare();
+        await this.hashTurn;
+        if (this.nextChunk !== this.manifest.chunks.length) {
+            throw new Error(`cloud content ${this.manifest.contentHash} did not stream every chunk`);
+        }
+        if (this.hasher.digest("hex") !== this.manifest.contentHash) {
+            throw new Error(`cloud content ${this.manifest.contentHash} is corrupt`);
+        }
+        await fsyncFile(this.primary);
+        chmodSync(this.primary, 0o644);
+        for (const duplicate of this.destinations.slice(1)) {
+            ensureUserDir(dirname(duplicate));
+            atomicCopy(this.primary, duplicate, 0o644);
+            await fsyncFile(duplicate);
+        }
+        return {
+            file: this.primary,
+            bytes: this.manifest.bytes,
+            contentHash: this.manifest.contentHash,
+        };
+    }
+    /** Keep staged bytes and evidence for the next attempt. */
+    async close() {
+        if (this.prepared)
+            await this.prepared.catch(() => { });
+    }
+}
+/** One evidence database shared by every staged file in a download set. */
+export class StagedContentSet {
+    evidence;
+    closed = false;
+    constructor(evidenceDir) {
+        this.evidence = new AddStagingEvidence(evidenceDir);
+    }
+    target(artifact, manifest, destinations) {
+        if (this.closed)
+            throw new Error("staged content set is closed");
+        return new StagedContentFile(this.evidence, artifact, manifest, destinations);
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.evidence.close();
+    }
+}
+//# sourceMappingURL=workspace-add-staging.js.map

package/dist/workspace-add-staging.js.map

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

package/npm-shrinkwrap.json

@@ -1,21 +1,21 @@
 {
   "name": "@amalgm/shell",
-  "version": "0.1.126",
+  "version": "0.1.128",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@amalgm/shell",
-      "version": "0.1.126",
+      "version": "0.1.128",
       "license": "UNLICENSED",
       "dependencies": {
         "@amalgm/agents": "0.2.0",
         "@amalgm/apps": "0.1.1",
-        "@amalgm/automations": "0.2.2",
+        "@amalgm/automations": "0.2.5",
         "@amalgm/browser": "0.1.0",
         "@amalgm/channels": "0.1.1",
-        "@amalgm/chat": "0.2.4",
-        "@amalgm/core": "0.4.4",
+        "@amalgm/chat": "0.2.5",
+        "@amalgm/core": "0.4.5",
         "@amalgm/live": "0.2.57",
         "@amalgm/tools": "0.1.4",
         "@anthropic-ai/claude-agent-sdk": "^0.3.224",
@@ -100,9 +100,9 @@
       }
     },
     "node_modules/@amalgm/automations": {
-      "version": "0.2.2",
-      "resolved": "https://registry.npmjs.org/@amalgm/automations/-/automations-0.2.2.tgz",
-      "integrity": "sha512-uIPHbWXCdBwGFyULKXEfNOnNYqpLyC6MQF+ow/+JWuq6l+WJ7TfALd4WfIfbh6c17La3ZjGVoUsWuXG/LTFLrA==",
+      "version": "0.2.5",
+      "resolved": "https://registry.npmjs.org/@amalgm/automations/-/automations-0.2.5.tgz",
+      "integrity": "sha512-fZG89CBW5bq1FcCn8Tb3XOJOexzRXtF9ARHUpSVvyFvwGMghjE9it2joH57/mWnZYxt92aUT+3Ate1sGaf/cxA==",
       "dependencies": {
         "@amalgm/core": "0.4.4",
         "@modelcontextprotocol/sdk": "^1.30.0",
@@ -119,6 +119,14 @@
         "node": ">=20"
       }
     },
+    "node_modules/@amalgm/automations/node_modules/@amalgm/core": {
+      "version": "0.4.4",
+      "resolved": "https://registry.npmjs.org/@amalgm/core/-/core-0.4.4.tgz",
+      "integrity": "sha512-w7/edrjsyvqWh5+nM5SRNkbyY4DjnsVMgqj4c9X+g2E3n+RqG/gNKO7M6B2eH/WNq6vNPDQ8qgeaIChGhfMRBw==",
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@amalgm/browser": {
       "version": "0.1.0",
       "resolved": "https://registry.npmjs.org/@amalgm/browser/-/browser-0.1.0.tgz",
@@ -172,10 +180,18 @@
         "node": ">=20"
       }
     },
+    "node_modules/@amalgm/channels/node_modules/@amalgm/core": {
+      "version": "0.4.4",
+      "resolved": "https://registry.npmjs.org/@amalgm/core/-/core-0.4.4.tgz",
+      "integrity": "sha512-w7/edrjsyvqWh5+nM5SRNkbyY4DjnsVMgqj4c9X+g2E3n+RqG/gNKO7M6B2eH/WNq6vNPDQ8qgeaIChGhfMRBw==",
+      "engines": {
+        "node": ">=18"
+      }
+    },
     "node_modules/@amalgm/chat": {
-      "version": "0.2.4",
-      "resolved": "https://registry.npmjs.org/@amalgm/chat/-/chat-0.2.4.tgz",
-      "integrity": "sha512-cksV7UALZJc1nuk2QeTTD9LoSqKokppk4e+34nnnExzg2mGmGAGA9vjDcESGaz67pqq59YduOd7O7a8jH9ciFA==",
+      "version": "0.2.5",
+      "resolved": "https://registry.npmjs.org/@amalgm/chat/-/chat-0.2.5.tgz",
+      "integrity": "sha512-1srs0GzhgmVXZBD/jiQ0SlOyzlv14IsLRfXzSwhe9j/TbSIKoFKePmhrJdOZw+LsyW4srB5FIgxAKuomvMpkIQ==",
       "dependencies": {
         "@agentclientprotocol/sdk": "^1.4.0",
         "@anthropic-ai/claude-agent-sdk": "^0.3.206",
@@ -190,9 +206,9 @@
       }
     },
     "node_modules/@amalgm/core": {
-      "version": "0.4.4",
-      "resolved": "https://registry.npmjs.org/@amalgm/core/-/core-0.4.4.tgz",
-      "integrity": "sha512-w7/edrjsyvqWh5+nM5SRNkbyY4DjnsVMgqj4c9X+g2E3n+RqG/gNKO7M6B2eH/WNq6vNPDQ8qgeaIChGhfMRBw==",
+      "version": "0.4.5",
+      "resolved": "https://registry.npmjs.org/@amalgm/core/-/core-0.4.5.tgz",
+      "integrity": "sha512-uD5TOcYnpZlcbqziNOma4kIJ2jfyE2CE4HbgJA/BmEvrOAHw9Q6XuHd+MBazOp2x5e4hhPoPtOwFVQSzrYwsdA==",
       "engines": {
         "node": ">=18"
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/shell",
-  "version": "0.1.126",
+  "version": "0.1.128",
   "description": "The Amalgm runtime host assembled from the published @amalgm SDK capabilities.",
   "type": "module",
   "private": false,
@@ -25,7 +25,8 @@
     "dist",
     "npm-shrinkwrap.json",
     "PURPOSE.md",
-    "README.md"
+    "README.md",
+    "skills"
   ],
   "publishConfig": {
     "access": "public"
@@ -46,11 +47,11 @@
   "dependencies": {
     "@amalgm/agents": "0.2.0",
     "@amalgm/apps": "0.1.1",
-    "@amalgm/automations": "0.2.2",
+    "@amalgm/automations": "0.2.5",
     "@amalgm/browser": "0.1.0",
     "@amalgm/channels": "0.1.1",
-    "@amalgm/chat": "0.2.4",
-    "@amalgm/core": "0.4.4",
+    "@amalgm/chat": "0.2.5",
+    "@amalgm/core": "0.4.5",
     "@amalgm/live": "0.2.57",
     "@amalgm/tools": "0.1.4",
     "@anthropic-ai/claude-agent-sdk": "^0.3.224",