@cotal-ai/connector-jcode 0.29.2 → 0.30.1

package/dist/private-lifecycle.d.ts

@@ -0,0 +1,28 @@
+export interface ProcessIdentity {
+    pid: number;
+    start: string;
+}
+export declare function launchIdentityEnv(): {
+    key: string;
+    value: string;
+};
+/** Immutable identity of one process at capture time; throws when the platform cannot prove it. */
+export declare function captureProcessIdentity(pid: number): ProcessIdentity;
+/** Every PID this seat's private home records. The caller must still prove ownership. */
+export declare function recordedTreePids(jcodeHome: string): number[];
+export interface StopPrivateTreeOptions {
+    jcodeHome: string;
+    /** Immutable identity of the bridge child spawned by this launch. */
+    launch: ProcessIdentity;
+    /** Random launch-bound environment identity inherited only by this bridge tree. */
+    identityValue: string;
+    gracefulWaitMs?: number;
+    killWaitMs?: number;
+    /** Records must remain absent for this long after the bridge is gone (default 500ms). */
+    settleMs?: number;
+}
+/** SIGTERM the launch-owned tree, escalate survivors to SIGKILL, and only return once its records
+ * remain quiescent after the bridge is gone. A stale or reused registry PID is skipped, never
+ * signalled; an unprovable live process is not converted into ownership by location alone. */
+export declare function stopPrivateTree(options: StopPrivateTreeOptions): Promise<void>;
+//# sourceMappingURL=private-lifecycle.d.ts.map

package/dist/private-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-lifecycle.d.ts","sourceRoot":"","sources":["../src/private-lifecycle.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAiCD,wBAAgB,iBAAiB,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAElE;AAED,mGAAmG;AACnG,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAMnE;AAiDD,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB5D;AA0DD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,MAAM,EAAE,eAAe,CAAC;IACxB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;8FAE8F;AAC9F,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuEpF"}

package/dist/retry-policy.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Pacing for a failed turn.
+ *
+ * A jcode turn acks its batch only on success, so a failure leaves `pendingWake()` positive and the
+ * naive `finally` re-drive fires instantly with the SAME batch. One deterministic failure therefore
+ * became a hot loop that re-paid the full injection to the provider on every pass - measured at 62
+ * resends off a single stalled turn (#790). The codex host already solved this with an exponential
+ * `scheduleErrorRetry`; this is the same rule, extracted so it can be graded directly rather than
+ * only through a live seat.
+ */
+/** First delay after a failure. Short, because most failures are transient. */
+export declare const ERROR_RETRY_INITIAL_MS = 1000;
+/** Ceiling on the delay. Past this, waiting longer buys nothing. */
+export declare const ERROR_RETRY_MAX_MS = 60000;
+/** Consecutive failures after which the seat stops re-driving entirely. */
+export declare const ERROR_RETRY_GIVE_UP = 8;
+/** The next delay, doubling from `current` and clamped at the ceiling. */
+export declare function nextRetryDelay(current: number): number;
+/**
+ * Whether a failed turn should be retried at all.
+ *
+ * Refuses when shutting down (a retry would re-drive a batch into a child being torn down), when a
+ * timer is already pending (one in flight at a time, never a fan-out), when there is nothing left to
+ * retry, and once the consecutive-failure budget is spent - at which point the batch stays un-acked
+ * and redelivers rather than being burned against a provider that is not answering.
+ */
+export declare function shouldRetry(state: {
+    stopping: boolean;
+    timerPending: boolean;
+    consecutiveFailures: number;
+    pendingWake: number;
+    wakeQueued: boolean;
+}): {
+    retry: boolean;
+    reason: "ok" | "stopping" | "timer-pending" | "nothing-pending" | "gave-up";
+};
+//# sourceMappingURL=retry-policy.d.ts.map

package/dist/retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../src/retry-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAC5C,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,eAAe,GAAG,iBAAiB,GAAG,SAAS,CAAA;CAAE,CAMlG"}

package/dist/startup-diagnostics.d.ts

@@ -0,0 +1,15 @@
+/** A bounded, connector-owned account of a provider refusal during the mandatory readiness turn.
+ * It deliberately contains only a provider error code and a model/effort value the connector could
+ * classify; the original Harness API message may include private configuration or child output. */
+export declare class JcodeReadinessProviderRefusal extends Error {
+    readonly providerCode: string;
+    readonly parameter: "model" | "reasoning effort";
+    readonly value: string;
+    constructor(providerCode: string, parameter: "model" | "reasoning effort", value: string);
+}
+/**
+ * Classify only the Jcode SDK's invalid-request response and only when both fields are safely
+ * extractable. Everything else retains the existing scrubbed startup diagnostic.
+ */
+export declare function classifyReadinessProviderRefusal(error: unknown): JcodeReadinessProviderRefusal | undefined;
+//# sourceMappingURL=startup-diagnostics.d.ts.map

package/dist/startup-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-diagnostics.d.ts","sourceRoot":"","sources":["../src/startup-diagnostics.ts"],"names":[],"mappings":"AAEA;;mGAEmG;AACnG,qBAAa,6BAA8B,SAAQ,KAAK;IAEpD,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,kBAAkB;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAFb,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,OAAO,GAAG,kBAAkB,EACvC,KAAK,EAAE,MAAM;CAIzB;AAuCD;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,6BAA6B,GAAG,SAAS,CAM1G"}

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.29.2",
+  "version": "0.30.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -28,9 +28,9 @@
     "esbuild": "^0.28.0",
     "tsx": "^4.22.4",
     "zod": "^4.4.3",
-    "@cotal-ai/core": "0.29.2",
-    "@cotal-ai/connector-core": "0.29.2",
-    "@cotal-ai/smoke-kit": "0.0.0"
+    "@cotal-ai/core": "0.30.1",
+    "@cotal-ai/smoke-kit": "0.0.0",
+    "@cotal-ai/connector-core": "0.30.1"
   },
   "files": [
     "dist"