@adea-ai/runtime-sdk 3.0.1 → 3.1.0

package/dist/adapter.d.ts

@@ -511,6 +511,7 @@ export declare const RuntimeStartRequestSchema: z.ZodObject<{
         maximumMicrounits: z.ZodNumber;
         maximumTokens: z.ZodNumber;
     }, z.core.$strict>>>;
+    traceId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"trace ID">, string>>>;
 }, z.core.$strict>;
 export declare const RuntimeInputRequestSchema: z.ZodObject<{
     interactionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"interaction ID">, string>>;

package/dist/adapter.js

@@ -272,6 +272,7 @@ export const RuntimeStartRequestSchema = z
     idempotencyKey: IdempotencyKeySchema,
     executionPlan: RuntimeExecutionPlanSnapshotSchema,
     attemptBudget: RuntimeAttemptBudgetAuthoritySchema.optional(),
+    traceId: IdentifierSchemas.traceId.optional(),
 })
     .strict()
     .superRefine((request, context) => {

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

@@ -253,6 +253,7 @@ export declare const PiDurableSessionEventsRequestSchema: z.ZodObject<{
     operation: z.ZodLiteral<"pi-durable.lead.session-events">;
     parameters: z.ZodObject<{
         runtimeSessionId: typeof PiDurableSessionIdSchema;
+        messageId: z.ZodOptional<z.ZodString>;
         afterSeq: z.ZodNumber;
         waitMs: z.ZodNumber;
         limit: z.ZodOptional<z.ZodNumber>;
@@ -332,6 +333,30 @@ export declare const PiDurableLeadApprovalAnswerRequestSchema: z.ZodObject<{
     operation: z.ZodLiteral<"pi-durable.lead.approval-answer">;
     payload: z.ZodObject<typeof PiDurableApprovalAnswerSchema.shape & typeof PiDurableApprovalAttestationSchema.shape, z.core.$strict>;
 }, z.core.$strict>;
+export declare const PiDurableChildMessageRequestIdSchema: z.ZodString;
+export declare const PI_DURABLE_CHILD_MESSAGE_MAX_CHARS = 8192;
+export declare const PiDurableLeadChildMessageRequestSchema: z.ZodObject<{
+    contractVersion: z.ZodObject<{
+        major: z.ZodNumber;
+        minor: z.ZodNumber;
+    }, z.core.$strict>;
+    requestId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"request ID">, string>>;
+    workspaceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"workspace ID">, string>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"project ID">, string>>>;
+    commandId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"command ID">, string>>;
+    idempotencyKey: z.ZodString;
+    payloadHash: z.ZodString;
+    issuedAt: z.ZodISODateTime;
+    caller: typeof Caller;
+    correlation: typeof Correlation;
+    operation: z.ZodLiteral<"pi-durable.lead.child-message">;
+    payload: z.ZodObject<{
+        dispatchId: typeof PiDurableDispatchIdSchema;
+        delegationId: typeof IdentifierSchemas.delegationId;
+        requestId: typeof PiDurableChildMessageRequestIdSchema;
+        text: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const PiDurableLeadChildCancelRequestSchema: z.ZodObject<{
     contractVersion: z.ZodObject<{
         major: z.ZodNumber;
@@ -798,6 +823,34 @@ export declare const PiDurableLeadChildCancelResponseSchema: z.ZodObject<{
         attributed: z.ZodBoolean;
     }, z.core.$strict>;
 }, z.core.$strict>;
+export declare const PiDurableLeadChildMessageResponseSchema: z.ZodObject<{
+    contractVersion: z.ZodObject<{
+        major: z.ZodNumber;
+        minor: z.ZodNumber;
+    }, z.core.$strict>;
+    requestId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"request ID">, string>>;
+    correlation: z.ZodObject<{
+        traceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"trace ID">, string>>;
+        causationCommandId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"command ID">, string>>>;
+        parentEventId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"event ID">, string>>>;
+    }, z.core.$strict>;
+    data: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"pi-lead-dispatch/v1">;
+        dispatchId: typeof PiDurableDispatchIdSchema;
+        intentId: typeof IntentId;
+        executionId: typeof IdentifierSchemas.executionId;
+        attemptId: typeof IdentifierSchemas.attemptId;
+        runtimeSessionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"external-session ID">, string>>;
+        requestedTarget: z.ZodOptional<typeof PiDurableLeadRequestedTargetSchema>;
+        observedTarget: z.ZodOptional<typeof PiDurableLeadObservedTargetSchema>;
+        child: typeof PiDurableLeadChildSchema;
+        requestId: typeof PiDurableChildMessageRequestIdSchema;
+        outcome: z.ZodEnum<{
+            already_delivered: "already_delivered";
+            delivered: "delivered";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
 export declare const PiDurableLeadChildTargetSchema: z.ZodObject<{
     source: z.ZodLiteral<"control_plane_reported">;
     runtimeConnectionId: typeof IdentifierSchemas.runtimeConnectionId;
@@ -984,6 +1037,13 @@ export declare const PiDurableLeadHttpContract: Readonly<{
         requestSchema: typeof PiDurableLeadChildCancelRequestSchema;
         responseSchema: typeof PiDurableLeadChildCancelResponseSchema;
     }>;
+    childMessage: Readonly<{
+        route: "child-message";
+        operation: "pi-durable.lead.child-message";
+        scope: "execution:write";
+        requestSchema: typeof PiDurableLeadChildMessageRequestSchema;
+        responseSchema: typeof PiDurableLeadChildMessageResponseSchema;
+    }>;
 }>;
 export type PiDurableLeadPrepareRequest = z.output<typeof PiDurableLeadPrepareRequestSchema>;
 export type PiDurableLeadPrepareResponse = z.output<typeof PiDurableLeadPrepareResponseSchema>;
@@ -1016,6 +1076,8 @@ export type PiDurableLeadApprovalAnswerRequest = z.output<typeof PiDurableLeadAp
 export type PiDurableLeadApprovalAnswerResponse = z.output<typeof PiDurableLeadApprovalAnswerResponseSchema>;
 export type PiDurableLeadChildCancelRequest = z.output<typeof PiDurableLeadChildCancelRequestSchema>;
 export type PiDurableLeadChildCancelResponse = z.output<typeof PiDurableLeadChildCancelResponseSchema>;
+export type PiDurableLeadChildMessageRequest = z.output<typeof PiDurableLeadChildMessageRequestSchema>;
+export type PiDurableLeadChildMessageResponse = z.output<typeof PiDurableLeadChildMessageResponseSchema>;
 export type PiDurableLeadChildTargetRequest = z.output<typeof PiDurableLeadChildTargetRequestSchema>;
 export type PiDurableLeadChildTargetResponse = z.output<typeof PiDurableLeadChildTargetResponseSchema>;
 export type PiDurableLeadChildTarget = z.output<typeof PiDurableLeadChildTargetSchema>;

package/dist/pi-durable-lead.js

@@ -173,6 +173,12 @@ export const PiDurableSessionEventsRequestSchema = PiDurableLeadReadEnvelopeSche
     parameters: z
         .object({
         runtimeSessionId: PiDurableSessionIdSchema,
+        messageId: z
+            .string()
+            .min(1)
+            .max(128)
+            .regex(/^[A-Za-z0-9._:-]+$/)
+            .optional(),
         afterSeq: LeadEventSeq,
         waitMs: z.number().int().min(0).max(PI_DURABLE_LEAD_EVENTS_MAX_WAIT_MS),
         limit: z.number().int().min(1).max(PI_DURABLE_LEAD_EVENTS_MAX_PAGE).optional(),
@@ -206,6 +212,21 @@ export const PiDurableLeadApprovalAnswerRequestSchema = PiDurableLeadCommandEnve
     operation: z.literal('pi-durable.lead.approval-answer'),
     payload: PiDurableApprovalAnswerSchema.extend(PiDurableApprovalAttestationSchema.shape),
 });
+export const PiDurableChildMessageRequestIdSchema = z
+    .string()
+    .regex(/^pi-child-message:[a-f0-9]{32}$/);
+export const PI_DURABLE_CHILD_MESSAGE_MAX_CHARS = 8192;
+export const PiDurableLeadChildMessageRequestSchema = PiDurableLeadCommandEnvelopeSchema.extend({
+    operation: z.literal('pi-durable.lead.child-message'),
+    payload: z
+        .object({
+        dispatchId: PiDurableDispatchIdSchema,
+        delegationId: IdentifierSchemas.delegationId,
+        requestId: PiDurableChildMessageRequestIdSchema,
+        text: z.string().trim().min(1).max(PI_DURABLE_CHILD_MESSAGE_MAX_CHARS),
+    })
+        .strict(),
+});
 export const PiDurableLeadChildCancelRequestSchema = PiDurableLeadCommandEnvelopeSchema.extend({
     operation: z.literal('pi-durable.lead.child-cancel'),
     payload: z
@@ -505,6 +526,13 @@ export const PiDurableLeadChildCancelResponseSchema = response.extend({
         attributed: z.boolean(),
     }),
 });
+export const PiDurableLeadChildMessageResponseSchema = response.extend({
+    data: PiDurableLeadReceiptResponseSchema.extend({
+        child: PiDurableLeadChildSchema,
+        requestId: PiDurableChildMessageRequestIdSchema,
+        outcome: z.enum(['delivered', 'already_delivered']),
+    }),
+});
 export const PiDurableLeadChildTargetSchema = z.strictObject({
     source: z.literal('control_plane_reported'),
     runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
@@ -698,4 +726,11 @@ export const PiDurableLeadHttpContract = Object.freeze({
         requestSchema: PiDurableLeadChildCancelRequestSchema,
         responseSchema: PiDurableLeadChildCancelResponseSchema,
     }),
+    childMessage: Object.freeze({
+        route: 'child-message',
+        operation: 'pi-durable.lead.child-message',
+        scope: 'execution:write',
+        requestSchema: PiDurableLeadChildMessageRequestSchema,
+        responseSchema: PiDurableLeadChildMessageResponseSchema,
+    }),
 });

package/package.json

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