@adea-ai/runtime-sdk 1.19.0 → 1.20.0

package/dist/pi-durable-lead.d.ts

@@ -65,6 +65,7 @@ export declare const PI_DURABLE_REMOTE_SESSION_REFERENCE_CONTRACT_VERSION: {
     readonly minor: 2;
 };
 export declare function supportsPiDurableRemoteSessionReference(consumerVersion: unknown): boolean;
+export declare function supportsPiDurableRemoteOwnerObservation(consumerVersion: unknown): boolean;
 export declare const PiDurableLeadPrepareRequestSchema: z.ZodObject<{
     contractVersion: z.ZodObject<{
         major: z.ZodNumber;
@@ -575,6 +576,18 @@ export declare const PiDurableLeadChildTargetResponseSchema: z.ZodObject<{
             NOT_STARTED: "NOT_STARTED";
             UNAVAILABLE: "UNAVAILABLE";
         }>>;
+        remoteOwnerObservation: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            schemaVersion: z.ZodLiteral<"pi-child-owner-observation/v1">;
+            runtimeConnectionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"runtime-connection ID">, string>>;
+            nativeSessionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"external-session ID">, string>>;
+            ownerInstanceId: z.ZodUUID;
+            permission: z.ZodLiteral<"none">;
+        }, z.core.$strict>>>;
+        remoteOwnerObservationUnavailableReason: z.ZodOptional<z.ZodEnum<{
+            NOT_CONFIGURED: "NOT_CONFIGURED";
+            NOT_STARTED: "NOT_STARTED";
+            UNAVAILABLE: "UNAVAILABLE";
+        }>>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 export declare const PiDurableLeadHttpContract: Readonly<{

package/dist/pi-durable-lead.js

@@ -48,6 +48,13 @@ export function supportsPiDurableRemoteSessionReference(consumerVersion) {
     return (negotiated?.major === PI_DURABLE_REMOTE_SESSION_REFERENCE_CONTRACT_VERSION.major &&
         negotiated.minor >= PI_DURABLE_REMOTE_SESSION_REFERENCE_CONTRACT_VERSION.minor);
 }
+export function supportsPiDurableRemoteOwnerObservation(consumerVersion) {
+    const consumer = ContractVersionSchema.safeParse(consumerVersion);
+    if (!consumer.success)
+        return false;
+    const negotiated = negotiateContractVersion([PublicContractManifest.current], [consumer.data]);
+    return negotiated?.major === 3 && negotiated.minor >= 3;
+}
 function fenceForeignGeneration(receipt, context) {
     const foreign = (generation) => generation !== undefined && generation.attemptId !== receipt.attemptId;
     if (foreign(receipt.observedTarget?.generation))
@@ -336,7 +343,40 @@ export const PiDurableLeadChildTargetResponseSchema = response.extend({
         remoteSessionReferenceUnavailableReason: z
             .enum(['NOT_STARTED', 'NOT_CONFIGURED', 'UNAVAILABLE'])
             .optional(),
+        remoteOwnerObservation: z
+            .strictObject({
+            schemaVersion: z.literal('pi-child-owner-observation/v1'),
+            runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+            nativeSessionId: IdentifierSchemas.externalSessionId,
+            ownerInstanceId: z.uuid(),
+            permission: z.literal('none'),
+        })
+            .nullable()
+            .optional(),
+        remoteOwnerObservationUnavailableReason: z
+            .enum(['NOT_STARTED', 'NOT_CONFIGURED', 'UNAVAILABLE'])
+            .optional(),
     }).superRefine((value, context) => {
+        if ((value.remoteOwnerObservation === null) !==
+            (value.remoteOwnerObservationUnavailableReason !== undefined))
+            context.addIssue({
+                code: 'custom',
+                message: 'Unavailable owner observation requires a bounded reason',
+            });
+        if (value.remoteOwnerObservation &&
+            (!value.child.childAttemptId ||
+                (value.target !== null &&
+                    (value.target.runtimeConnectionId !== value.remoteOwnerObservation.runtimeConnectionId ||
+                        value.target.nativeSessionId !== value.remoteOwnerObservation.nativeSessionId)) ||
+                (value.remoteSessionReference &&
+                    (value.remoteSessionReference.runtimeConnectionId !==
+                        value.remoteOwnerObservation.runtimeConnectionId ||
+                        value.remoteSessionReference.nativeSessionId !==
+                            value.remoteOwnerObservation.nativeSessionId))))
+            context.addIssue({
+                code: 'custom',
+                message: 'Owner observation must bind the selected child reference',
+            });
         const reference = value.remoteSessionReference;
         if ((reference === null) !== (value.remoteSessionReferenceUnavailableReason !== undefined))
             context.addIssue({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adea-ai/runtime-sdk",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "SDK for building Control Plane runtimes: adapters, capabilities, conformance, discovery, eligibility, health, sessions, transport, and routing.",
   "keywords": [
     "adapter",
@@ -43,7 +43,7 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@adea-ai/contracts": "^1.24.0",
+    "@adea-ai/contracts": "^1.25.0",
     "zod": "4.6.6"
   },
   "engines": {