@cotal-ai/connector-jcode 0.57.0 → 0.59.0

package/dist/session-fork.d.ts

@@ -0,0 +1,61 @@
+/** The seat's private Jcode home under `root` (the launch's COTAL_JCODE_HOME), keyed by space and
+ *  name. host.ts claims it; buildLaunch reads it to see whether the seat already owns its fork. */
+export declare function jcodeSeatHome(root: string, space: string, name: string): string;
+/** The seat's record of its fork (source, fork, title, transcript hash), which the manager reads
+ *  as the fork's provenance. */
+export declare function jcodeForkRecordPath(seatHome: string): string;
+export interface JcodeForkSource {
+    sessionId: string;
+    title?: string;
+    /** sha256 over the source snapshot bytes followed by its journal bytes, as read. */
+    transcriptSha256: string;
+    messages: unknown[];
+    compaction?: unknown;
+    systemPrompt?: unknown;
+    model?: unknown;
+}
+/**
+ * Read the named session from `sourceHome`, folding its journal the way Jcode's loader does. Every
+ * failure is a named refusal, so `buildLaunch` can call this to refuse before anything launches.
+ *
+ * The source may be live. Jcode checkpoints by writing the folded snapshot and then unlinking the
+ * journal, so two reads can straddle it and lose the journal's messages or count them twice, and a
+ * pair read between the two steps holds a journal the snapshot already folded. Every Jcode save
+ * stamps `updated_at`, so such a journal is one whose lines are no newer than the snapshot. The pair
+ * is therefore read until two consecutive reads agree and every journal line is newer than the
+ * snapshot and adds no message it already holds, and refused as unstable when that does not happen.
+ */
+export declare function readJcodeForkSource(sourceHome: string, sessionId: string): JcodeForkSource;
+export interface JcodeFork {
+    forkId: string;
+    title?: string;
+    transcriptSha256: string;
+    /** False when this seat home already holds the fork of the same source from an earlier launch. */
+    created: boolean;
+    /** Whether a launch has appended the seat's briefing to the fork. A first launch that failed
+     *  before its briefing leaves this false, so the retry still briefs the seat. */
+    briefed: boolean;
+}
+export interface ForkMarker {
+    source: string;
+    fork: string;
+    title?: string;
+    transcriptSha256: string;
+    briefed: boolean;
+}
+/** The seat's fork of `sessionId` when it already owns one, else undefined. A marker that names
+ *  another source, or that cannot be parsed, is a named refusal rather than a silent re-fork. */
+export declare function ownedJcodeFork(seatHome: string, sessionId: string): ForkMarker | undefined;
+/** Record that the seat's briefing is now in its fork, so a later relaunch does not repeat it. */
+export declare function markJcodeForkBriefed(seatHome: string, sessionId: string): void;
+/**
+ * Give the seat its fork of `sessionId`. A seat home that already forked the same source keeps that
+ * fork, the same way a restarted seat continues its own session rather than starting over (#789).
+ */
+export declare function forkJcodeSession(opts: {
+    sourceHome: string;
+    sessionId: string;
+    seatHome: string;
+    cwd: string;
+}): JcodeFork;
+//# sourceMappingURL=session-fork.d.ts.map

package/dist/session-fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-fork.d.ts","sourceRoot":"","sources":["../src/session-fork.ts"],"names":[],"mappings":"AAsBA;mGACmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED;gCACgC;AAChC,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+FD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CA2B1F;AA+ED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,kGAAkG;IAClG,OAAO,EAAE,OAAO,CAAC;IACjB;qFACiF;IACjF,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAUD;iGACiG;AACjG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAqB1F;AAED,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAI9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAkC1H"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cotal-ai/connector-jcode",
   "description": "Cotal connector for Jcode: a host-mode mesh peer driven through Jcode's Harness API bridge.",
-  "version": "0.57.0",
+  "version": "0.59.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -26,12 +26,12 @@
     "smol-toml": "^1.8.0"
   },
   "devDependencies": {
+    "@cotal-ai/connector-core": "0.59.0",
+    "@cotal-ai/core": "0.59.0",
+    "@cotal-ai/smoke-kit": "0.0.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",
-    "zod": "^4.4.3",
-    "@cotal-ai/smoke-kit": "0.0.0",
-    "@cotal-ai/connector-core": "0.57.0",
-    "@cotal-ai/core": "0.57.0"
+    "zod": "^4.4.3"
   },
   "files": [
     "dist"