@adea-ai/runtime-sdk 1.17.0 → 1.17.2

package/dist/adapter.d.ts

@@ -293,6 +293,28 @@ export declare const RuntimeExecutionStateSchema: z.ZodEnum<{
     timed_out: "timed_out";
     unknown: "unknown";
 }>;
+/**
+ * The runtime's own observed generation identity for the execution's current
+ * turn.
+ *
+ * Observed by construction: the runtime reports the generation it authorized
+ * for this attempt, never a generation a caller claimed. A control that names
+ * a generation the runtime did not observe is not bound to it, so this shape
+ * is an identity, not a counter the caller can advance.
+ *
+ * The identity is self-verifying: the inference key is the turn's key extended
+ * by the inference id, exactly as the runtime retained it. A key that names a
+ * different turn or inference is refused here rather than accepted as an
+ * observation of something else.
+ */
+export declare const RuntimeObservedGenerationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"runtime-observed-generation/v1">;
+    attemptId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"attempt ID">, string>>;
+    turnKey: z.ZodString;
+    inferenceId: z.ZodString;
+    inferenceKey: z.ZodString;
+}, z.core.$strict>;
+export type RuntimeObservedGeneration = z.output<typeof RuntimeObservedGenerationSchema>;
 export declare const RuntimeExecutionStatusSchema: z.ZodObject<{
     handle: z.ZodObject<{
         handleId: z.ZodString;
@@ -312,6 +334,13 @@ export declare const RuntimeExecutionStatusSchema: z.ZodObject<{
         unknown: "unknown";
     }>;
     observedAt: z.ZodISODateTime;
+    observedGeneration: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<"runtime-observed-generation/v1">;
+        attemptId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@adea-ai/contracts").OpaqueIdentifier<"attempt ID">, string>>;
+        turnKey: z.ZodString;
+        inferenceId: z.ZodString;
+        inferenceKey: z.ZodString;
+    }, z.core.$strict>>;
     result: z.ZodOptional<z.ZodObject<{
         outcome: z.ZodLiteral<"completed">;
         output: z.ZodOptional<z.ZodJSONSchema>;
@@ -641,4 +670,3 @@ export declare class RuntimeAdapterError extends Error {
     toJSON(): RuntimeError;
 }
 export declare function inspectRuntimeCapabilities(capabilities: RuntimeAdapterInspection['capabilities'], requirements: readonly CapabilityRequirement[]): CapabilityEvaluation;
-//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.js

@@ -183,11 +183,43 @@ export const RuntimeExecutionStateSchema = z.enum([
     'timed_out',
     'unknown',
 ]);
+/**
+ * The runtime's own observed generation identity for the execution's current
+ * turn.
+ *
+ * Observed by construction: the runtime reports the generation it authorized
+ * for this attempt, never a generation a caller claimed. A control that names
+ * a generation the runtime did not observe is not bound to it, so this shape
+ * is an identity, not a counter the caller can advance.
+ *
+ * The identity is self-verifying: the inference key is the turn's key extended
+ * by the inference id, exactly as the runtime retained it. A key that names a
+ * different turn or inference is refused here rather than accepted as an
+ * observation of something else.
+ */
+export const RuntimeObservedGenerationSchema = z
+    .object({
+    schemaVersion: z.literal('runtime-observed-generation/v1'),
+    attemptId: IdentifierSchemas.attemptId,
+    turnKey: z.string().min(1).max(4096),
+    inferenceId: z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$/),
+    inferenceKey: z.string().min(1).max(8192),
+})
+    .strict()
+    .superRefine((generation, context) => {
+    if (generation.inferenceKey !== `${generation.turnKey}:${generation.inferenceId}`)
+        context.addIssue({ code: 'custom', path: ['inferenceKey'], message: 'invalid inference key' });
+});
 export const RuntimeExecutionStatusSchema = z
     .object({
     handle: RuntimeExecutionHandleSchema,
     state: RuntimeExecutionStateSchema,
     observedAt: TimestampSchema,
+    // The generation the runtime observed for this attempt, when it has one.
+    // Additive in contract 3.1: a consumer that advertised an earlier version
+    // parses with the pre-3.1 strict status shape, so a producer publishes it
+    // only to a consumer whose negotiated version includes it.
+    observedGeneration: RuntimeObservedGenerationSchema.optional(),
     result: RuntimeExecutionResultSchema.optional(),
     // Observed usage survives unsuccessful termination without fabricating a result.
     terminalUsage: RuntimeUsageSchema.optional(),
@@ -408,4 +440,3 @@ export class RuntimeAdapterError extends Error {
 export function inspectRuntimeCapabilities(capabilities, requirements) {
     return evaluateCapabilities(capabilities, CapabilityRequirementSetSchema.parse(requirements));
 }
-//# sourceMappingURL=adapter.js.map

package/dist/agent-plugins.d.ts

@@ -59,4 +59,3 @@ export declare function createHarnessProfile(input: Readonly<{
     agentPlugins: AgentPluginsCapabilityReport;
     components: ComponentCapabilityReport;
 }>): HarnessProfile;
-//# sourceMappingURL=agent-plugins.d.ts.map

package/dist/agent-plugins.js

@@ -41,4 +41,3 @@ export function harnessProfileFromInspection(input) {
 export function createHarnessProfile(input) {
     return HarnessProfileSchema.parse({ profileVersion: 1, ...input });
 }
-//# sourceMappingURL=agent-plugins.js.map

package/dist/capabilities.d.ts

@@ -133,4 +133,3 @@ export interface CapabilityEvaluation {
 export declare function evaluateCapabilities(capabilitiesInput: readonly RuntimeCapability[], requirementsInput: readonly CapabilityRequirement[]): CapabilityEvaluation;
 export declare function runtimeCapabilitiesEqual(left: readonly RuntimeCapability[], right: readonly RuntimeCapability[]): boolean;
 export declare function capabilityFingerprint(capabilities: readonly RuntimeCapability[]): string;
-//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.js

@@ -85,4 +85,3 @@ export function capabilityFingerprint(capabilities) {
         .map((capability) => RuntimeCapabilitySchema.parse(capability))
         .toSorted((left, right) => compareCodePointOrder(left.name, right.name)));
 }
-//# sourceMappingURL=capabilities.js.map

package/dist/channel-ownership.d.ts

@@ -49,4 +49,3 @@ export interface RuntimeChannelOwnershipRepository {
     heartbeat(record: RuntimeChannelOwnership, credentialFence?: RuntimeChannelOwnershipCredentialFence): Promise<boolean>;
     release(record: RuntimeChannelOwnership): Promise<boolean>;
 }
-//# sourceMappingURL=channel-ownership.d.ts.map

package/dist/channel-ownership.js

@@ -23,4 +23,3 @@ export const RuntimeChannelSequenceRequestSchema = z
     minimum: z.number().int().min(1).max(2147483647),
 })
     .strict();
-//# sourceMappingURL=channel-ownership.js.map

package/dist/compatibility.d.ts

@@ -181,4 +181,3 @@ export interface RuntimeCompatibilityCertificationInput {
     readonly connection: unknown;
 }
 export declare function applyRuntimeCompatibilityCertification(input: RuntimeCompatibilityCertificationInput): RuntimeConnection;
-//# sourceMappingURL=compatibility.d.ts.map

package/dist/compatibility.js

@@ -240,4 +240,3 @@ function certificationIdentity(certification) {
         platform: certification.testedPlatform,
     });
 }
-//# sourceMappingURL=compatibility.js.map

package/dist/conformance.d.ts

@@ -11,4 +11,3 @@ export interface RuntimeAdapterConformanceReport {
     readonly checks: typeof RuntimeAdapterConformanceChecks;
 }
 export declare function runRuntimeAdapterConformance(input: RuntimeAdapterConformanceInput): Promise<RuntimeAdapterConformanceReport>;
-//# sourceMappingURL=conformance.d.ts.map

package/dist/conformance.js

@@ -70,4 +70,3 @@ function assert(condition, code) {
 function fingerprint(value) {
     return JSON.stringify(value);
 }
-//# sourceMappingURL=conformance.js.map

package/dist/discovery.d.ts

@@ -23,4 +23,3 @@ export declare function projectExternalSessionDiscovery(inputValue: {
     readonly session: ExternalSession;
     readonly assessment: ExternalSessionAssessment;
 }): ExternalSessionDiscoveryReadModel;
-//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.js

@@ -251,4 +251,3 @@ function normalizeCode(value) {
         .slice(0, 128);
     return /^[A-Z]/.test(normalized) ? normalized : `RUNTIME_${normalized || 'LIMITATION'}`;
 }
-//# sourceMappingURL=discovery.js.map

package/dist/eligibility.d.ts

@@ -335,4 +335,3 @@ export declare const RuntimeEligibilityDecisionSchema: z.ZodObject<{
 export type RuntimeEligibilityInput = z.output<typeof RuntimeEligibilityInputSchema>;
 export type RuntimeEligibilityDecision = z.output<typeof RuntimeEligibilityDecisionSchema>;
 export declare function evaluateRuntimeEligibility(inputValue: unknown): RuntimeEligibilityDecision;
-//# sourceMappingURL=eligibility.d.ts.map

package/dist/eligibility.js

@@ -308,4 +308,3 @@ function digestEligibilityInput(input) {
     };
     return `sha256:${createHash('sha256').update(JSON.stringify(normalized)).digest('hex')}`;
 }
-//# sourceMappingURL=eligibility.js.map

package/dist/fixtures.d.ts

@@ -87,4 +87,3 @@ export declare const RuntimeFixtures: Readonly<{
         };
     };
 }>;
-//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.js

@@ -45,4 +45,3 @@ function runtime(runtimeDefinitionId, family, capabilities) {
 function capability(name, support = 'supported', limitations) {
     return { name, support, ...(limitations === undefined ? {} : { limitations: [...limitations] }) };
 }
-//# sourceMappingURL=fixtures.js.map

package/dist/health.d.ts

@@ -181,4 +181,3 @@ export declare class RuntimeHealthIngestionService {
     refresh(input: unknown): Promise<RuntimeHealthIngestionResult>;
 }
 export declare function runtimeAvailabilityIsExecutable(state: RuntimeAvailabilityState): boolean;
-//# sourceMappingURL=health.d.ts.map

package/dist/health.js

@@ -480,4 +480,3 @@ function ignored(reason, connection, assessment) {
 function fail(code) {
     throw new RuntimeHealthIngestionError(code);
 }
-//# sourceMappingURL=health.js.map

package/dist/index.d.ts

@@ -17,4 +17,3 @@ export * from './routing.js';
 export * from './sessions.js';
 export * from './transport.js';
 export declare const packageName = "runtime-sdk";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -17,4 +17,3 @@ export * from './routing.js';
 export * from './sessions.js';
 export * from './transport.js';
 export const packageName = 'runtime-sdk';
-//# sourceMappingURL=index.js.map

package/dist/inventory.d.ts

@@ -28,4 +28,3 @@ export declare class InMemoryRuntimeInventoryCheckpointRepository implements Run
     get(runtimeNodeRefId: string): Promise<RuntimeInventoryCheckpoint | undefined>;
     compareAndSet(expectedRevision: number | undefined, checkpointInput: RuntimeInventoryCheckpoint): Promise<boolean>;
 }
-//# sourceMappingURL=inventory.d.ts.map

package/dist/inventory.js

@@ -48,4 +48,3 @@ export class InMemoryRuntimeInventoryCheckpointRepository {
         return true;
     }
 }
-//# sourceMappingURL=inventory.js.map

package/dist/mock.d.ts

@@ -21,4 +21,3 @@ export declare class MockRuntimeAdapter implements RuntimeAdapter {
     cleanup(handleInput: RuntimeExecutionHandle): Promise<void>;
     complete(handleInput: RuntimeExecutionHandle, resultInput: Omit<RuntimeExecutionResult, 'outcome'>): RuntimeExecutionStatus;
 }
-//# sourceMappingURL=mock.d.ts.map

package/dist/mock.js

@@ -258,4 +258,3 @@ function stable(value) {
 function clone(value) {
     return structuredClone(value);
 }
-//# sourceMappingURL=mock.js.map

package/dist/models.d.ts

@@ -284,4 +284,3 @@ export declare function assessRuntimeCompatibility(definitionInput: unknown, exp
     readonly capabilities: readonly CapabilityRequirement[];
 }): RuntimeCompatibilityResult;
 export declare function runtimeDefinitionsEqual(left: unknown, right: unknown): boolean;
-//# sourceMappingURL=models.d.ts.map

package/dist/models.js

@@ -239,4 +239,3 @@ function normalizeDefinition(input) {
 function major(version) {
     return Number.parseInt(version.split('.')[0] ?? '', 10);
 }
-//# sourceMappingURL=models.js.map