@roj-ai/kompjutr-platform 0.0.0 → 0.2.11

package/README.md

@@ -1,3 +1,116 @@
 # @roj-ai/kompjutr-platform
 
-Placeholder. Use a version >= 0.2.10.
+Run the Roj SDK against a [Kompjutr](https://www.npmjs.com/package/@kompjutr/do)
+workspace. This adapter uses `@kompjutr/do` **0.1.2** from npm.
+
+```bash
+bun add @roj-ai/sdk @roj-ai/kompjutr-platform @kompjutr/do@0.1.2
+```
+
+## Connect a workspace
+
+The host creates a `Workspace` with SQL storage and optional Git support, then
+passes the platform and event store to the SDK:
+
+```ts
+import { Workspace, createGit } from '@kompjutr/do'
+import { bootstrap } from '@roj-ai/sdk'
+import { createKompjutrPlatform, KompjutrEventStore } from '@roj-ai/kompjutr-platform'
+
+const workspace = new Workspace({
+	storage, // Durable Object storage supplied by the host
+	git: createGit(),
+	defaultGitIdentity: { name: 'Agent', email: 'agent@example.com' },
+})
+workspace.filesystem.mkdir('/data', { recursive: true })
+workspace.filesystem.mkdir('/workspace', { recursive: true })
+
+const platform = createKompjutrPlatform(workspace, { scheduler })
+const eventStore = new KompjutrEventStore(workspace.db)
+const services = bootstrap(config, { presets }, platform, {
+	eventStore,
+	pluginProfile: 'isolate',
+})
+```
+
+`config`, `presets`, `storage` and `scheduler` come from the host application.
+Use virtual paths such as `/data` and `/workspace` in the configuration and
+presets. In Durable Objects, supply an alarm-backed scheduler if work must
+resume after eviction; the default scheduler uses in-memory timers.
+
+## Capabilities and boundaries
+
+- Filesystem operations use the workspace's SQLite data. The optional `fsRevision`
+  port is omitted because upstream revisions do not cover Git-only changes.
+- Git status and shell Git commands require `git: createGit()` on the workspace.
+- The shell interprets supported commands in the virtual filesystem. It is not
+  a native process runner. Process spawning and native dev servers are unsupported;
+  hosts can supply a service executor through SDK bootstrap overrides.
+- `shellConfinement` defaults to `none`. Set it to `host` only when the host
+  isolates the entire workspace. It does not create a per-directory sandbox.
+  Shell path grants are unsupported.
+- Known limitation: the host shell runner does not implement the virtual
+  `/home/user/session` and `/home/user/workspace` namespace exposed by
+  preset-level `sandboxed: true`. Support requires a native upstream namespace
+  shared by filesystem resolution, shell execution and Git; this work is deferred.
+  Existing Bun/bwrap virtual paths are unchanged.
+- Session logs, LLM call logs and events are stored as SQL rows. Pass the
+  `KompjutrEventStore` explicitly to bootstrap to use SQL event persistence.
+- The host owns authentication, workspace isolation and storage lifetime.
+
+## LLM call storage
+
+`KompjutrLLMCallLog` stores the exact request, response, metrics and error
+strings in fixed **256 KiB byte blocks**. Agent IDs, model names and provider
+request IDs use the same storage, so large scalar values cannot inflate the
+parent row. Each field has explicit presence, byte-length and block-count
+metadata; blocks have a field name and sequence number. Strings are JSON-string
+encoded before UTF-8 encoding to preserve Unicode, including lone surrogates.
+Reads assemble and decode blocks in JavaScript, without SQL concatenation.
+Missing blocks, invalid metadata and malformed encodings fail visibly.
+
+The parent keeps only session/call identity keys, timestamps, status and a
+format version. With the SDK's bounded identity keys (UUIDv7 call IDs), parent,
+metadata and block rows stay well below the documented
+[2 MB SQLite row/string/BLOB limit](https://developers.cloudflare.com/durable-objects/platform/limits/).
+Local tests measure actual stored values and returned SQL rows
+against a conservative 2,000,000-byte budget; they do not prove Cloudflare's
+exact engine limit.
+
+Create, complete, retention and delete run in synchronous SQL transactions.
+Deleting a parent also deletes its field metadata and blocks. Completion of a
+reaped call is a no-op. Normal completion replaces only outcome fields and
+does not read or rewrite request blocks. Retention defaults to the newest
+200 calls per session; `maxCallsPerSession: 0` retains every call.
+
+`maxBlobBytes` defaults to `undefined`, so the SDK caller does not clamp the
+request. An explicit positive value opts into the existing caller-side request
+clamp, measured in UTF-8 bytes. Zero or a negative value disables it. This option
+does not set the block size, limit other fields, or truncate direct store writes.
+The adapter preserves the strings it receives and propagates database failures.
+
+Existing inline rows remain readable. Their first completion migrates the
+request and scalar fields transactionally; this one-time migration can read the
+legacy request. An explicit format marker distinguishes inline and block rows,
+including empty strings. **Older adapters cannot read the new block format.**
+
+## Local tests
+
+The Bun-only `@roj-ai/kompjutr-platform/testing` export provides
+`BunSqliteStorage`, a local storage adapter that enforces the Durable Object
+100-bind-parameter limit:
+
+```ts
+import { BunSqliteStorage } from '@roj-ai/kompjutr-platform/testing'
+
+const storage = new BunSqliteStorage(':memory:')
+// Pass storage to Workspace, then close it when the host shuts down.
+storage.close()
+```
+
+Run the adapter tests from the repository root:
+
+```bash
+bun test packages/kompjutr-platform/src
+bunx tsc -p packages/kompjutr-platform/tsconfig.test.json --noEmit
+```

package/dist/event-store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `EventStore` over the workspace's own SQLite rather than a JSONL file in it.
+ *
+ * The file store rewrites a blob through the filesystem on every append and
+ * parses the whole file on every load. One row per event turns an append into
+ * an insert and `loadRange` into a seek down the clustered `(session_id, seq)`
+ * key. This is the write path an event-sourced session spends its day on.
+ */
+import { BaseEventStore, SessionId } from '@roj-ai/sdk';
+import type { DomainEvent, LoadRangeOptions, LoadRangeResult, Logger, SessionMetadata } from '@roj-ai/sdk';
+import type { SqlDatabase } from '@kompjutr/do';
+export declare class KompjutrEventStore extends BaseEventStore {
+    #private;
+    private readonly db;
+    private readonly logger?;
+    constructor(db: SqlDatabase, logger?: Logger | undefined);
+    protected doAppend(sessionId: SessionId, event: DomainEvent): Promise<void>;
+    protected doAppendBatch(sessionId: SessionId, events: DomainEvent[]): Promise<void>;
+    load(sessionId: SessionId): Promise<DomainEvent[]>;
+    loadRange(sessionId: SessionId, options?: LoadRangeOptions): Promise<LoadRangeResult>;
+    exists(sessionId: SessionId): Promise<boolean>;
+    /**
+     * Every session this store holds, from either side of the pair.
+     *
+     * Neither side implies the other. A session created by `updateMetadata` alone
+     * has no events yet and the file store still lists it; a session whose
+     * metadata write failed after its rows landed has events and no metadata, and
+     * then the log is the only record it ran. So the answer is a union — taken
+     * without reading the log, because a status poll counts these.
+     *
+     * The recursive term seeks from one distinct id straight to the next down the
+     * `(session_id, seq)` primary key, so the cost follows sessions rather than
+     * events. `SELECT DISTINCT session_id` reads every row instead.
+     */
+    listSessions(): Promise<SessionId[]>;
+    /**
+     * Drop every row this store holds for one session, and report how many events went.
+     *
+     * Deliberately outside the `EventStore` contract: the log is the only record
+     * that a session existed, so nothing in the SDK can reach this by accident.
+     * Whether a session may be dropped is the caller's policy.
+     */
+    deleteSession(sessionId: SessionId): Promise<number>;
+    protected readMetadata(sessionId: SessionId): Promise<SessionMetadata | null>;
+    protected writeMetadata(sessionId: SessionId, metadata: SessionMetadata): Promise<void>;
+    protected getAllSessionMetadata(): Promise<SessionMetadata[]>;
+}
+//# sourceMappingURL=event-store.d.ts.map

package/dist/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../src/event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAuE,SAAS,EAAyB,MAAM,aAAa,CAAA;AACnJ,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC1G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAc/C,qBAAa,kBAAmB,SAAQ,cAAc;;IAKpD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBADP,EAAE,EAAE,WAAW,EACf,MAAM,CAAC,EAAE,MAAM,YAAA;cAsBjB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;cAIjE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBnF,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKlD,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BrF,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAIpD;;;;;;;;;;;;OAYG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAkB1C;;;;;;OAMG;IACG,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC;cAgB1C,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;cAcnE,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;cAS7E,qBAAqB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;CAuDnE"}

package/dist/event-store.js

@@ -0,0 +1,206 @@
+/**
+ * `EventStore` over the workspace's own SQLite rather than a JSONL file in it.
+ *
+ * The file store rewrites a blob through the filesystem on every append and
+ * parses the whole file on every load. One row per event turns an append into
+ * an insert and `loadRange` into a seek down the clustered `(session_id, seq)`
+ * key. This is the write path an event-sourced session spends its day on.
+ */
+import { BaseEventStore, domainEventSchema, EventAppendError, EventStoreError, isDomainEvent, SessionId, sessionMetadataSchema } from '@roj-ai/sdk';
+const EVENTS_TABLE = 'roj_events';
+const METADATA_TABLE = 'roj_session_metadata';
+/** A Durable Object binds at most 100 parameters per statement, and a row costs three. */
+const EVENTS_PER_INSERT = 33;
+export class KompjutrEventStore extends BaseEventStore {
+    db;
+    logger;
+    /** Tail of the append chain per session; see #serialized. */
+    #appendTails = new Map();
+    constructor(db, logger) {
+        super();
+        this.db = db;
+        this.logger = logger;
+        // WITHOUT ROWID stores rows in primary-key order, so a session's events are
+        // contiguous and loadRange never leaves the index.
+        this.db.run(`CREATE TABLE IF NOT EXISTS ${EVENTS_TABLE} (
+				session_id TEXT NOT NULL,
+				seq INTEGER NOT NULL,
+				payload TEXT NOT NULL,
+				PRIMARY KEY (session_id, seq)
+			) WITHOUT ROWID`);
+        this.db.run(`CREATE TABLE IF NOT EXISTS ${METADATA_TABLE} (
+				session_id TEXT PRIMARY KEY,
+				metadata TEXT NOT NULL
+			)`);
+    }
+    async doAppend(sessionId, event) {
+        await this.doAppendBatch(sessionId, [event]);
+    }
+    async doAppendBatch(sessionId, events) {
+        if (events.length === 0)
+            return;
+        await this.#serialized(sessionId, async () => {
+            try {
+                // One transaction, so a batch too wide for a single statement still
+                // lands whole. The old shape relied on the host committing a
+                // synchronous run together, which only a Durable Object promises.
+                this.db.transactionSync(() => {
+                    const firstSeq = this.#lastSeq(sessionId) + 1;
+                    for (let offset = 0; offset < events.length; offset += EVENTS_PER_INSERT) {
+                        const chunk = events.slice(offset, offset + EVENTS_PER_INSERT);
+                        const tuples = chunk.map(() => '(?, ?, ?)').join(', ');
+                        const bindings = chunk.flatMap((event, index) => [sessionId, firstSeq + offset + index, JSON.stringify(event)]);
+                        this.db.run(`INSERT INTO ${EVENTS_TABLE} (session_id, seq, payload) VALUES ${tuples}`, ...bindings);
+                    }
+                });
+                await this.updateMetadataFromEvents(sessionId, events);
+            }
+            catch (error) {
+                throw new EventAppendError(sessionId, error);
+            }
+        });
+    }
+    async load(sessionId) {
+        const rows = this.db.all(`SELECT seq, payload FROM ${EVENTS_TABLE} WHERE session_id = ? ORDER BY seq`, sessionId);
+        return rows.map((row) => this.#decodeEvent(sessionId, row));
+    }
+    async loadRange(sessionId, options) {
+        const since = options?.since ?? -1;
+        const limit = options?.limit;
+        const rows = this.db.all(`SELECT seq, payload FROM ${EVENTS_TABLE} WHERE session_id = ? AND seq > ? ORDER BY seq LIMIT ?`, sessionId, since, 
+        // SQLite reads a negative limit as unlimited; clamp rather than inherit that.
+        limit === undefined ? -1 : Math.max(limit, 0));
+        const first = rows[0];
+        const last = rows[rows.length - 1];
+        if (first === undefined || last === undefined) {
+            // Report the store's last index instead, so a poller keeps its cursor.
+            return { events: [], fromIndex: -1, toIndex: this.#lastSeq(sessionId) };
+        }
+        return {
+            events: rows.map((row) => this.#decodeEvent(sessionId, row)),
+            fromIndex: first.seq,
+            toIndex: last.seq,
+        };
+    }
+    async exists(sessionId) {
+        return this.db.one(`SELECT 1 FROM ${EVENTS_TABLE} WHERE session_id = ? LIMIT 1`, sessionId) !== undefined;
+    }
+    /**
+     * Every session this store holds, from either side of the pair.
+     *
+     * Neither side implies the other. A session created by `updateMetadata` alone
+     * has no events yet and the file store still lists it; a session whose
+     * metadata write failed after its rows landed has events and no metadata, and
+     * then the log is the only record it ran. So the answer is a union — taken
+     * without reading the log, because a status poll counts these.
+     *
+     * The recursive term seeks from one distinct id straight to the next down the
+     * `(session_id, seq)` primary key, so the cost follows sessions rather than
+     * events. `SELECT DISTINCT session_id` reads every row instead.
+     */
+    async listSessions() {
+        const rows = this.db.all(`WITH RECURSIVE event_sessions(session_id) AS (
+				SELECT MIN(session_id) FROM ${EVENTS_TABLE}
+				UNION ALL
+				SELECT (SELECT MIN(session_id) FROM ${EVENTS_TABLE} WHERE session_id > previous.session_id)
+				FROM event_sessions AS previous
+				WHERE previous.session_id IS NOT NULL
+			)
+			SELECT session_id FROM event_sessions WHERE session_id IS NOT NULL
+			UNION
+			SELECT session_id FROM ${METADATA_TABLE}
+			ORDER BY session_id`);
+        return rows.map((row) => SessionId(row.session_id));
+    }
+    /**
+     * Drop every row this store holds for one session, and report how many events went.
+     *
+     * Deliberately outside the `EventStore` contract: the log is the only record
+     * that a session existed, so nothing in the SDK can reach this by accident.
+     * Whether a session may be dropped is the caller's policy.
+     */
+    async deleteSession(sessionId) {
+        let events = 0;
+        // Serialized with appends, so a delete cannot land between a batch's
+        // sequence claim and its inserts and leave the tail of that batch behind.
+        await this.#serialized(sessionId, async () => {
+            this.db.transactionSync(() => {
+                events = this.db.scalar(`SELECT COUNT(*) FROM ${EVENTS_TABLE} WHERE session_id = ?`, sessionId) ?? 0;
+                this.db.run(`DELETE FROM ${EVENTS_TABLE} WHERE session_id = ?`, sessionId);
+                this.db.run(`DELETE FROM ${METADATA_TABLE} WHERE session_id = ?`, sessionId);
+            });
+        });
+        return events;
+    }
+    async readMetadata(sessionId) {
+        const row = this.db.one(`SELECT metadata FROM ${METADATA_TABLE} WHERE session_id = ?`, sessionId);
+        return row === undefined ? null : this.#decodeMetadata(sessionId, row.metadata);
+    }
+    /** A session whose metadata does not parse is skipped, never thrown over. */
+    #skip(sessionId, reason) {
+        this.logger?.warn('Skipping invalid session metadata', {
+            sessionId,
+            reason,
+        });
+        return null;
+    }
+    async writeMetadata(sessionId, metadata) {
+        this.db.run(`INSERT INTO ${METADATA_TABLE} (session_id, metadata) VALUES (?, ?)
+			ON CONFLICT(session_id) DO UPDATE SET metadata = excluded.metadata`, sessionId, JSON.stringify(metadata));
+    }
+    async getAllSessionMetadata() {
+        const rows = this.db.all(`SELECT session_id, metadata FROM ${METADATA_TABLE} ORDER BY session_id`);
+        return rows.map((row) => this.#decodeMetadata(SessionId(row.session_id), row.metadata)).filter((metadata) => metadata !== null);
+    }
+    /** Index of the last stored event, -1 when the session has none. */
+    #lastSeq(sessionId) {
+        return this.db.scalar(`SELECT MAX(seq) FROM ${EVENTS_TABLE} WHERE session_id = ?`, sessionId) ?? -1;
+    }
+    /**
+     * Run appends for one session one at a time.
+     *
+     * The SQL is synchronous but the metadata update that follows it is not, so
+     * concurrent appends would otherwise read-modify-write the same metrics.
+     */
+    #serialized(sessionId, task) {
+        const previous = this.#appendTails.get(sessionId) ?? Promise.resolve();
+        const next = previous.then(task);
+        // The stored tail must never reject, or the next append inherits this failure.
+        const tail = next
+            .catch(() => undefined)
+            .then(() => {
+            if (this.#appendTails.get(sessionId) === tail)
+                this.#appendTails.delete(sessionId);
+        });
+        this.#appendTails.set(sessionId, tail);
+        return next;
+    }
+    #decodeEvent(sessionId, row) {
+        try {
+            const parsed = domainEventSchema.parse(JSON.parse(row.payload));
+            // The schema validates fields; the SDK guard supplies the domain event brand.
+            if (!isDomainEvent(parsed))
+                throw new Error('Invalid domain event');
+            return parsed;
+        }
+        catch (error) {
+            throw new EventStoreError(`Failed to parse event at index ${row.seq}`, sessionId, error);
+        }
+    }
+    /**
+     * Null rather than a throw, matching `FileEventStore`: one unreadable row must
+     * not take out the listing every other session appears in.
+     */
+    #decodeMetadata(sessionId, raw) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (error) {
+            return this.#skip(sessionId, String(error));
+        }
+        const result = sessionMetadataSchema.safeParse(parsed);
+        return result.success ? result.data : this.#skip(sessionId, result.error.message);
+    }
+}
+//# sourceMappingURL=event-store.js.map

package/dist/event-store.js.map

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

package/dist/fs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `FileSystem` port over a kompjutr workspace.
+ *
+ * kompjutr ships a node:fs-shaped shim (`NodeFsCompat`) over its own bulk-first
+ * `Filesystem`, and the shim already answers the port's optional verbs in the
+ * shape the port asks for. So most of this file forwards. What it does not
+ * forward is what the shim does not do, or does with different semantics than
+ * the port states — `appendFile`, a recursive `cp`, and a walk's symlink sizes.
+ */
+import type { Filesystem, NodeFsCompat } from '@kompjutr/do';
+import type { FileSystem } from '@roj-ai/sdk/platform';
+export interface KompjutrFileSystemOptions {
+    /** The node:fs-shaped shim. `Workspace.fs`. */
+    compat: NodeFsCompat;
+    /** The bulk API underneath it, over the same database. `Workspace.filesystem`. */
+    filesystem: Filesystem;
+}
+export declare function createKompjutrFileSystem(options: KompjutrFileSystemOptions): FileSystem;
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAQ,MAAM,cAAc,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAkG,MAAM,sBAAsB,CAAA;AAQtJ,MAAM,WAAW,yBAAyB;IACzC,+CAA+C;IAC/C,MAAM,EAAE,YAAY,CAAA;IACpB,kFAAkF;IAClF,UAAU,EAAE,UAAU,CAAA;CACtB;AAgBD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,UAAU,CA+LvF"}

package/dist/fs.js

@@ -0,0 +1,200 @@
+/**
+ * `FileSystem` port over a kompjutr workspace.
+ *
+ * kompjutr ships a node:fs-shaped shim (`NodeFsCompat`) over its own bulk-first
+ * `Filesystem`, and the shim already answers the port's optional verbs in the
+ * shape the port asks for. So most of this file forwards. What it does not
+ * forward is what the shim does not do, or does with different semantics than
+ * the port states — `appendFile`, a recursive `cp`, and a walk's symlink sizes.
+ */
+/** Pages a subtree scan. kompjutr caps a page at 1,000 rows. */
+const SCAN_PAGE = 1_000;
+/** What `Filesystem.copyFiles` accepts in one call. */
+const COPY_BATCH = 1_000;
+function toBytes(data) {
+    return typeof data === 'string' ? new TextEncoder().encode(data) : data;
+}
+function fileError(code, path, message) {
+    return Object.assign(new Error(`${message}: ${path}`), { code, path });
+}
+/** The port's `type`, which names a directory in full and admits things kompjutr cannot produce. */
+function walkType(type) {
+    if (type === 'dir')
+        return 'directory';
+    return type;
+}
+export function createKompjutrFileSystem(options) {
+    const { compat, filesystem } = options;
+    /** Every path under `root`, parents before children. Excludes `root` itself. */
+    const scanSubtree = (root) => {
+        const paths = [];
+        let after;
+        for (;;) {
+            const page = filesystem.scan(root, { after, limit: SCAN_PAGE });
+            if (page.length === 0)
+                return paths;
+            for (const entry of page)
+                paths.push(entry.path);
+            if (page.length < SCAN_PAGE)
+                return paths;
+            after = page[page.length - 1]?.path;
+        }
+    };
+    /** Copies inside SQLite, so file bytes never enter the isolate. */
+    const copyEntries = (entries, force = true) => {
+        let pending = entries.filter(({ source, destination }) => {
+            const sourceStat = filesystem.stat(source);
+            const destinationStat = filesystem.stat(destination);
+            if (sourceStat !== null && destinationStat !== null && sourceStat.ino === destinationStat.ino) {
+                throw fileError('ERR_FS_CP_EINVAL', destination, 'source and destination are the same file');
+            }
+            if (sourceStat?.type === 'dir' && destinationStat !== null && destinationStat.type !== 'dir') {
+                throw fileError('ERR_FS_CP_DIR_TO_NON_DIR', destination, 'cannot overwrite a non-directory with a directory');
+            }
+            if (sourceStat?.type !== 'dir' && destinationStat?.type === 'dir') {
+                throw fileError('ERR_FS_CP_NON_DIR_TO_DIR', destination, 'cannot overwrite a directory with a non-directory');
+            }
+            return force || destinationStat === null || sourceStat?.type === 'dir';
+        });
+        while (pending.length > 0) {
+            const batch = filesystem.copyFiles(pending.slice(0, COPY_BATCH), {
+                parents: true,
+            });
+            const deferred = [...batch.remaining, ...pending.slice(COPY_BATCH)];
+            if (deferred.length >= pending.length)
+                throw fileError('EIO', pending[0]?.source ?? '', 'copy made no progress');
+            pending = deferred;
+        }
+    };
+    const remove = (path, rmOptions) => {
+        if (!rmOptions?.recursive && filesystem.stat(path)?.type === 'dir') {
+            throw fileError('ERR_FS_EISDIR', path, 'is a directory');
+        }
+        compat.rmSync(path, rmOptions);
+    };
+    return {
+        // Every method here is `async`, and deliberately so: kompjutr's shim reaches
+        // its synchronous core through `Promise.resolve(xSync(...))`, so a failure
+        // throws where the port says it rejects. `async` puts that back.
+        readFile: (async (path, encoding) => encoding ? compat.readFileSync(path, { encoding }) : compat.readFileSync(path)),
+        writeFile: async (path, data) => {
+            compat.writeFileSync(path, data);
+        },
+        // The shim's own appendFile is ENOSYS; write at the current end instead.
+        appendFile: async (path, data) => {
+            const stat = filesystem.statTarget(path);
+            if (stat === null) {
+                compat.writeFileSync(path, data);
+                return;
+            }
+            filesystem.writeRange(path, toBytes(data), stat.size);
+        },
+        mkdir: async (path, mkdirOptions) => {
+            compat.mkdirSync(path, mkdirOptions);
+        },
+        readdir: (async (path, readdirOptions) => readdirOptions?.withFileTypes ? compat.readdirSync(path, { withFileTypes: true }) : compat.readdirSync(path)),
+        stat: async (path) => compat.statSync(path),
+        lstat: async (path) => compat.lstatSync(path),
+        access: async (path, mode) => {
+            compat.accessSync(path, mode);
+        },
+        unlink: async (path) => {
+            compat.unlinkSync(path);
+        },
+        rm: async (path, rmOptions) => {
+            remove(path, rmOptions);
+        },
+        cp: async (source, dest, cpOptions) => {
+            const stat = filesystem.stat(source);
+            if (stat === null)
+                throw fileError('ENOENT', source, 'no such file or directory');
+            if (stat.type !== 'dir') {
+                copyEntries([{ source, destination: dest }], cpOptions?.force);
+                return;
+            }
+            if (!cpOptions?.recursive)
+                throw fileError('EISDIR', source, 'is a directory');
+            const root = filesystem.realpath(source);
+            copyEntries([
+                { source: root, destination: dest },
+                ...scanSubtree(root).map((path) => ({
+                    source: path,
+                    destination: `${dest}${path.slice(root.length)}`,
+                })),
+            ], cpOptions?.force);
+        },
+        // The shim exposes fds, not handles; wrap one in the read subset the port uses.
+        open: async (path, flags) => {
+            const fd = compat.openSync(path, flags ?? 'r');
+            return {
+                stat: async () => compat.fstatSync(fd),
+                read: async (buffer, offset, length, position) => ({
+                    bytesRead: compat.readSync(fd, buffer, offset, length, position),
+                    buffer,
+                }),
+                close: async () => {
+                    compat.closeSync(fd);
+                },
+            };
+        },
+        exists: async (path) => compat.existsSync(path),
+        realpath: async (path) => compat.realpathSync(path),
+        walk: async (dir, walkOptions) => {
+            const entries = await compat.walk(dir, walkOptions);
+            return entries.map((entry) => ({
+                path: entry.path,
+                type: walkType(entry.type),
+                // The shim reports a symlink's own size; the port wants the target's,
+                // because the readdir-and-stat loop it replaces follows the link.
+                size: entry.type === 'symlink' ? (filesystem.statTarget(entry.path)?.size ?? 0) : entry.size,
+                mtime: entry.mtime,
+            }));
+        },
+        readFiles: async (paths) => {
+            try {
+                const entries = await compat.readFiles(paths);
+                return entries.map((entry, index) => ({
+                    path: paths[index] ?? entry.path,
+                    ...(entry.content === undefined ? {} : { content: Buffer.from(entry.content) }),
+                    ...(entry.error === undefined ? {} : { error: entry.error }),
+                }));
+            }
+            catch (error) {
+                if (!(error instanceof Error) || !('code' in error) || (error.code !== 'ENOTDIR' && error.code !== 'ELOOP'))
+                    throw error;
+                // Path resolution can abort the upstream batch before it reports individual failures.
+                return Promise.all(paths.map(async (path) => {
+                    try {
+                        const [entry] = await compat.readFiles([path]);
+                        if (!entry)
+                            throw new Error('readFiles returned no entry');
+                        return {
+                            path,
+                            ...(entry.content === undefined ? {} : { content: Buffer.from(entry.content) }),
+                            ...(entry.error === undefined ? {} : { error: entry.error }),
+                        };
+                    }
+                    catch (entryError) {
+                        if (entryError instanceof Error && 'code' in entryError && typeof entryError.code === 'string') {
+                            return { path, error: entryError.code };
+                        }
+                        throw entryError;
+                    }
+                }));
+            }
+        },
+        // The bulk primitive replaces final links; resolve them as single writes do.
+        writeFiles: async (entries, writeOptions) => {
+            filesystem.writeFiles(entries.map((entry) => ({
+                path: filesystem.realpath(entry.path),
+                bytes: toBytes(entry.content),
+            })), { parents: writeOptions?.createParents ?? false });
+        },
+        rmFiles: async (paths, rmOptions) => {
+            for (const path of paths)
+                remove(path, rmOptions);
+        },
+        scopeReads: (fn) => filesystem.withReadScope(fn),
+    };
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `GitClient` port over kompjutr's git runtime.
+ *
+ * The port names four questions `git-status` asks, and kompjutr answers each
+ * one directly rather than by walking a tree: status reads its index tracker,
+ * and `divergence` counts both sides of a fork in one call. Two of the four had
+ * no honest answer over the binding this replaces.
+ */
+import type { GitClient } from '@roj-ai/sdk/platform';
+import type { Git } from '@kompjutr/do';
+export declare function createKompjutrGitClient(git: Git): GitClient;
+//# sourceMappingURL=git.d.ts.map

package/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAkF,MAAM,sBAAsB,CAAA;AACrI,OAAO,KAAK,EAAE,GAAG,EAAe,MAAM,cAAc,CAAA;AAcpD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAiD3D"}