@cotal-ai/core 0.101.7 → 0.102.0

package/dist/turn-contract.d.ts

@@ -6,6 +6,7 @@
  * same objects: implementations never import each other, and a private copy keeps passing after
  * the manager's contract changes.
  */
+import { type EpCaller } from "./endpoint-subjects.js";
 /** `turn` (workflow runs, cotal-lang §5.3): wake the TARGET seat for one turn on behalf of a
  *  workflow run. The manager relays and stays run-ignorant: `payload` is an opaque bounded string
  *  the seat pulls back verbatim through `turn-pending` — its shape is the runtime↔connector
@@ -91,4 +92,16 @@ export declare const TURN_OUTPUT_SCHEMA: {
         };
     };
 };
+/** The reserved reply-rail nonce of a turn notice (SPEC 14.3). A seat's own requests use random
+ *  nonces, so no reply it awaits can arrive on this one. */
+export declare const TURN_NOTICE_NONCE = "turn-pending-notice-v1";
+/** The subject a manager publishes a turn notice on: the seat's own reply rail (the versioned one
+ *  when the seat's credential is an issuance, SPEC 13.15), under the manager's instance and serve
+ *  epoch. Only that instance's serve credential may publish it, and every baseline seat credential
+ *  may read it, so the notice needs no new grant. It carries no turn: the seat answers it with its
+ *  authenticated `turn-pending` pull. */
+export declare function turnNoticeSubject(space: string, instanceId: string, epoch: number, seat: EpCaller): string;
+/** The seat's subscription for {@link turnNoticeSubject}: its launching manager instance at any
+ *  epoch, so a manager that re-serves under a new epoch still reaches it. */
+export declare function turnNoticeFilter(space: string, instanceId: string, seat: EpCaller): string;
 //# sourceMappingURL=turn-contract.d.ts.map

package/dist/turn-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turn-contract.d.ts","sourceRoot":"","sources":["../src/turn-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;2BAQ2B;AAC3B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWnB,CAAC;AACZ;;4EAE4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBpB,CAAC"}
+{"version":3,"file":"turn-contract.d.ts","sourceRoot":"","sources":["../src/turn-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvH;;;;;;;;2BAQ2B;AAC3B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWnB,CAAC;AACZ;;4EAE4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBpB,CAAC;AAYZ;4DAC4D;AAC5D,eAAO,MAAM,iBAAiB,2BAA2B,CAAC;AAE1D;;;;yCAIyC;AACzC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAE1G;AAED;6EAC6E;AAC7E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAK1F"}

package/dist/turn-contract.js

@@ -6,6 +6,8 @@
  * same objects: implementations never import each other, and a private copy keeps passing after
  * the manager's contract changes.
  */
+import { callerRailTokens, endpointToken, epPlaneTokens, epReplySubject } from "./endpoint-subjects.js";
+import { assertLifecycleToken, spacePrefix } from "./subjects.js";
 /** `turn` (workflow runs, cotal-lang §5.3): wake the TARGET seat for one turn on behalf of a
  *  workflow run. The manager relays and stays run-ignorant: `payload` is an opaque bounded string
  *  the seat pulls back verbatim through `turn-pending` — its shape is the runtime↔connector
@@ -59,4 +61,23 @@ function deepFreeze(v) {
     }
     return v;
 }
+/** The reserved reply-rail nonce of a turn notice (SPEC 14.3). A seat's own requests use random
+ *  nonces, so no reply it awaits can arrive on this one. */
+export const TURN_NOTICE_NONCE = "turn-pending-notice-v1";
+/** The subject a manager publishes a turn notice on: the seat's own reply rail (the versioned one
+ *  when the seat's credential is an issuance, SPEC 13.15), under the manager's instance and serve
+ *  epoch. Only that instance's serve credential may publish it, and every baseline seat credential
+ *  may read it, so the notice needs no new grant. It carries no turn: the seat answers it with its
+ *  authenticated `turn-pending` pull. */
+export function turnNoticeSubject(space, instanceId, epoch, seat) {
+    return epReplySubject(space, { endpoint: "manager", instanceId, epoch, caller: seat, nonce: TURN_NOTICE_NONCE });
+}
+/** The seat's subscription for {@link turnNoticeSubject}: its launching manager instance at any
+ *  epoch, so a manager that re-serves under a new epoch still reaches it. */
+export function turnNoticeFilter(space, instanceId, seat) {
+    return [
+        spacePrefix(space), ...epPlaneTokens(seat), "reply", endpointToken("manager"), assertLifecycleToken(instanceId, "instanceId"), "*",
+        ...callerRailTokens(seat), TURN_NOTICE_NONCE,
+    ].join(".");
+}
 //# sourceMappingURL=turn-contract.js.map

package/dist/turn-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"turn-contract.js","sourceRoot":"","sources":["../src/turn-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;2BAQ2B;AAC3B,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC;IAClE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;IACnE,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;QAC3D,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,4FAA4F;QAC5F,6FAA6F;QAC7F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE;KAC9D;CACO,CAAC,CAAC;AACZ;;4EAE4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK;IAC3C,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,CAAC;IAC9F,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACvB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;QAC3C,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE,KAAK;YAC3B,QAAQ,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC;YACnC,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;SACzF;KACF;CACO,CAAC,CAAC;AAEZ;6FAC6F;AAC7F,SAAS,UAAU,CAAI,CAAI;IACzB,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QACxC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,CAA4B,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"turn-contract.js","sourceRoot":"","sources":["../src/turn-contract.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cotal-ai/core",
   "description": "The Cotal protocol: endpoint, subjects, message types, the NATS client layer, and the extension contracts.",
-  "version": "0.101.7",
+  "version": "0.102.0",
   "license": "Apache-2.0",
   "keywords": [
     "cotal",