@processfork/sdk 1.0.0

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@processfork/sdk",
+  "version": "1.0.0",
+  "description": "ProcessFork — fork() for AI agents (TypeScript SDK).",
+  "license": "MIT",
+  "homepage": "https://github.com/manav8498/processfork",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/manav8498/processfork.git",
+    "directory": "crates/pf-ts"
+  },
+  "main": "ts/index.js",
+  "types": "ts/index.d.ts",
+  "files": [
+    "ts/",
+    "*.node"
+  ],
+  "napi": {
+    "name": "processfork",
+    "triples": {
+      "defaults": true,
+      "additional": [
+        "x86_64-unknown-linux-gnu",
+        "aarch64-unknown-linux-gnu",
+        "aarch64-apple-darwin",
+        "x86_64-apple-darwin"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "napi build --release --platform",
+    "build:debug": "napi build --platform",
+    "test": "node --test test/smoke.mjs"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/ts/index.ts

@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: MIT
+//
+// ProcessFork — TypeScript SDK.
+//
+// Wraps the napi-rs cdylib. The cdylib's TypeScript types live in
+// `index.d.ts` (auto-generated by `napi build`); this file adds a thin
+// ergonomic layer (Manifest typed object, JSON parsing of readManifest).
+
+import {
+  PfStore as _PfStore,
+  digestOf,
+  snapshotFilesystem,
+  checkoutFilesystem,
+  readManifest as _readManifestRaw,
+  merge as _merge,
+  type Message,
+  type MergeOpts,
+  type MergeReport,
+  type WorldConflict,
+} from "../index.js";
+
+export {
+  digestOf,
+  snapshotFilesystem,
+  checkoutFilesystem,
+  _merge as merge,
+  type Message,
+  type MergeOpts,
+  type MergeReport,
+  type WorldConflict,
+};
+
+/**
+ * Local content-addressed `.pfimg` store. Re-exported from the cdylib;
+ * we attach `readManifest` as an instance method here so callers don't
+ * have to JSON.parse themselves.
+ */
+export class PfStore {
+  private inner: _PfStore;
+
+  private constructor(inner: _PfStore) {
+    this.inner = inner;
+  }
+
+  /** Open (or create) a store rooted at `path`. `~` is expanded. */
+  static open(path: string): PfStore {
+    return new PfStore(_PfStore.open(path));
+  }
+
+  /** Total compressed bytes on disk. */
+  physicalBytes(): number {
+    return this.inner.physicalBytes();
+  }
+
+  /** Underlying napi handle (for use with the free functions). */
+  get _raw(): _PfStore {
+    return this.inner;
+  }
+}
+
+/**
+ * Convenience wrapper around the napi `readManifest` (which returns the
+ * canonical-JSON string). Returns the parsed manifest object.
+ */
+export function readManifest(store: PfStore, cid: string): Manifest {
+  return JSON.parse(_readManifestRaw(store._raw, cid)) as Manifest;
+}
+
+// --------------------------- Manifest types ---------------------------
+
+export interface Manifest {
+  schemaVersion: number;
+  mediaType: string;
+  agent: { kind: string; version: string; fingerprint: string };
+  model: { base: string; diff: string };
+  cache: { layout: string; manifest: string };
+  world: { fs: string; env: string; procs: string };
+  effects: { ledger: string };
+  trace: { messages: string };
+  createdAt: string;
+  parents: string[];
+}