@adea-ai/runtime-sdk 1.5.2

package/dist/eligibility.js

@@ -0,0 +1,310 @@
+import { createHash } from 'node:crypto';
+import { IdentifierSchemas } from '@control-plane/contracts';
+import { z } from 'zod';
+import { CapabilityRequirementSetSchema, RuntimeCapabilityNameSchema, evaluateCapabilities, } from './capabilities.js';
+import { RuntimeNodeHealthStatusSchema } from './health.js';
+import { RuntimeConnectionLocationSchema, RuntimeConnectionSchema, RuntimeTimestampSchema, } from './models.js';
+const DigestSchema = z.string().regex(/^sha256:[a-f0-9]{64}$/);
+const RuntimeFamilySchema = z
+    .string()
+    .min(1)
+    .max(64)
+    .regex(/^[a-z][a-z0-9-]*$/);
+const PolicyReasonCodeSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[A-Z][A-Z0-9_]*$/);
+export const RuntimeEligibilityNodeStatusSchema = z.union([
+    RuntimeNodeHealthStatusSchema,
+    z.literal('not_applicable'),
+]);
+export const RuntimeEligibilityInputSchema = z
+    .object({
+    eligibilityVersion: z.literal(1),
+    evaluatedAt: RuntimeTimestampSchema,
+    executionPlan: z
+        .object({
+        executionPlanId: IdentifierSchemas.executionPlanId,
+        contentDigest: DigestSchema,
+        runtimeRequirements: CapabilityRequirementSetSchema,
+    })
+        .strict(),
+    candidate: z
+        .object({
+        family: RuntimeFamilySchema,
+        nodeStatus: RuntimeEligibilityNodeStatusSchema,
+        connection: RuntimeConnectionSchema,
+    })
+        .strict(),
+    policy: z
+        .object({
+        snapshot: z
+            .object({
+            policyId: z.string().min(1).max(128),
+            version: z.number().int().positive(),
+            digest: DigestSchema,
+        })
+            .strict(),
+        allowedFamilies: z.array(RuntimeFamilySchema).min(1).max(64),
+        allowedLocations: z.array(RuntimeConnectionLocationSchema).min(1).max(8),
+        deniedRuntimeConnectionIds: z.array(IdentifierSchemas.runtimeConnectionId).max(256),
+        requireVerifiedCapabilities: z.boolean(),
+        security: z
+            .object({
+            status: z.enum(['allowed', 'denied']),
+            reasonCode: PolicyReasonCodeSchema.optional(),
+        })
+            .strict(),
+    })
+        .strict(),
+    localProjectGrant: z
+        .object({
+        required: z.boolean(),
+        status: z.enum(['not_required', 'granted', 'missing', 'revoked']),
+        grantRef: z
+            .string()
+            .min(1)
+            .max(256)
+            .regex(/^grant:[A-Za-z0-9._:-]+$/)
+            .optional(),
+    })
+        .strict(),
+    entitlement: z
+        .object({
+        status: z.enum(['allowed', 'denied', 'unknown']),
+        class: z.string().min(1).max(64),
+    })
+        .strict(),
+    preference: z
+        .object({
+        runtimeConnectionId: IdentifierSchemas.runtimeConnectionId.optional(),
+        family: RuntimeFamilySchema.optional(),
+    })
+        .strict()
+        .optional(),
+})
+    .strict()
+    .superRefine((input, context) => {
+    const managedCloud = input.candidate.connection.connectionType === 'managed_cloud';
+    if (managedCloud !== (input.candidate.nodeStatus === 'not_applicable')) {
+        context.addIssue({
+            code: 'custom',
+            path: ['candidate', 'nodeStatus'],
+            message: 'Managed-cloud candidates must not invent RuntimeNode health',
+        });
+    }
+});
+export const RuntimeEligibilityReasonCodeSchema = z.enum([
+    'CAPABILITY_SNAPSHOT_MISSING',
+    'CAPABILITY_SNAPSHOT_STALE',
+    'CAPABILITY_SNAPSHOT_UNVERIFIED',
+    'ENTITLEMENT_DENIED',
+    'ENTITLEMENT_UNKNOWN',
+    'LOCAL_PROJECT_GRANT_MISSING',
+    'LOCAL_PROJECT_GRANT_REVOKED',
+    'REQUIRED_CAPABILITY_INSUFFICIENT',
+    'REQUIRED_CAPABILITY_MISSING',
+    'RUNTIME_CONNECTION_POLICY_DENIED',
+    'RUNTIME_EXPIRED',
+    'RUNTIME_FAMILY_POLICY_DENIED',
+    'RUNTIME_INCOMPATIBLE',
+    'RUNTIME_LOCATION_POLICY_DENIED',
+    'RUNTIME_NODE_OFFLINE',
+    'RUNTIME_NODE_REVOKED',
+    'RUNTIME_NODE_UNKNOWN',
+    'RUNTIME_OFFLINE',
+    'RUNTIME_REVOKED',
+    'RUNTIME_STALE',
+    'RUNTIME_UNAVAILABLE',
+    'SECURITY_POLICY_DENIED',
+]);
+export const RuntimeEligibilityDegradationCodeSchema = z.enum([
+    'COMPATIBILITY_DEGRADED',
+    'COMPATIBILITY_UNTESTED',
+    'OPTIONAL_CAPABILITY_DEGRADED',
+    'OPTIONAL_CAPABILITY_MISSING',
+    'RUNTIME_HEALTH_DEGRADED',
+]);
+const RuntimeEligibilityReasonSchema = z
+    .object({
+    code: RuntimeEligibilityReasonCodeSchema,
+    capability: RuntimeCapabilityNameSchema.optional(),
+})
+    .strict();
+const RuntimeEligibilityDegradationSchema = z
+    .object({
+    code: RuntimeEligibilityDegradationCodeSchema,
+    capability: RuntimeCapabilityNameSchema.optional(),
+})
+    .strict();
+export const RuntimeEligibilityDecisionSchema = z
+    .object({
+    eligible: z.boolean(),
+    mode: z.enum(['full', 'degraded', 'ineligible']),
+    reasons: z.array(RuntimeEligibilityReasonSchema),
+    degradations: z.array(RuntimeEligibilityDegradationSchema),
+    audit: z
+        .object({
+        eligibilityVersion: z.literal(1),
+        executionPlanId: IdentifierSchemas.executionPlanId,
+        runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+        policySnapshot: z
+            .object({
+            policyId: z.string().min(1).max(128),
+            version: z.number().int().positive(),
+            digest: DigestSchema,
+        })
+            .strict(),
+        evaluatedAt: RuntimeTimestampSchema,
+        inputDigest: DigestSchema,
+    })
+        .strict(),
+})
+    .strict();
+export function evaluateRuntimeEligibility(inputValue) {
+    const input = RuntimeEligibilityInputSchema.parse(inputValue);
+    const connection = input.candidate.connection;
+    const reasons = [];
+    const degradations = [];
+    const reason = (code, capability) => reasons.push({ code, ...(capability === undefined ? {} : { capability }) });
+    const degradation = (code, capability) => degradations.push({ code, ...(capability === undefined ? {} : { capability }) });
+    if (input.candidate.nodeStatus === 'offline')
+        reason('RUNTIME_NODE_OFFLINE');
+    if (input.candidate.nodeStatus === 'unknown')
+        reason('RUNTIME_NODE_UNKNOWN');
+    if (input.candidate.nodeStatus === 'revoked')
+        reason('RUNTIME_NODE_REVOKED');
+    if (connection.status === 'revoked' || connection.availabilityState === 'revoked') {
+        reason('RUNTIME_REVOKED');
+    }
+    else if (connection.status === 'expired') {
+        reason('RUNTIME_EXPIRED');
+    }
+    else if (connection.status === 'disconnected' ||
+        connection.availabilityState === 'offline' ||
+        connection.availabilityState === 'reconnecting') {
+        reason('RUNTIME_OFFLINE');
+    }
+    else if (connection.availabilityState === 'stale') {
+        reason('RUNTIME_STALE');
+    }
+    else if (connection.compatibilityState === 'incompatible' ||
+        connection.availabilityState === 'incompatible') {
+        reason('RUNTIME_INCOMPATIBLE');
+    }
+    else if (connection.status === 'unavailable' || connection.availabilityState === 'unknown') {
+        reason('RUNTIME_UNAVAILABLE');
+    }
+    if (connection.compatibilityState === 'revoked')
+        reason('RUNTIME_REVOKED');
+    if (!input.policy.allowedFamilies.includes(input.candidate.family)) {
+        reason('RUNTIME_FAMILY_POLICY_DENIED');
+    }
+    if (!input.policy.allowedLocations.includes(connection.location)) {
+        reason('RUNTIME_LOCATION_POLICY_DENIED');
+    }
+    if (input.policy.deniedRuntimeConnectionIds.includes(connection.runtimeConnectionId)) {
+        reason('RUNTIME_CONNECTION_POLICY_DENIED');
+    }
+    if (input.policy.security.status === 'denied')
+        reason('SECURITY_POLICY_DENIED');
+    if (input.localProjectGrant.required) {
+        if (input.localProjectGrant.status === 'missing')
+            reason('LOCAL_PROJECT_GRANT_MISSING');
+        if (input.localProjectGrant.status === 'revoked')
+            reason('LOCAL_PROJECT_GRANT_REVOKED');
+        if (input.localProjectGrant.status === 'not_required')
+            reason('LOCAL_PROJECT_GRANT_MISSING');
+    }
+    if (input.entitlement.status === 'denied')
+        reason('ENTITLEMENT_DENIED');
+    if (input.entitlement.status === 'unknown')
+        reason('ENTITLEMENT_UNKNOWN');
+    const snapshotVersion = connection.capabilitySnapshotVersion;
+    const snapshotObservedAt = connection.capabilitySnapshotObservedAt;
+    const snapshotExpiresAt = connection.capabilitySnapshotExpiresAt;
+    const snapshotVerification = connection.capabilityVerification;
+    const snapshotComplete = snapshotVersion !== undefined &&
+        snapshotObservedAt !== undefined &&
+        snapshotExpiresAt !== undefined &&
+        snapshotVerification !== undefined;
+    if (!snapshotComplete) {
+        reason('CAPABILITY_SNAPSHOT_MISSING');
+    }
+    else {
+        if (Date.parse(snapshotExpiresAt) <= Date.parse(input.evaluatedAt)) {
+            reason('CAPABILITY_SNAPSHOT_STALE');
+        }
+        if (input.policy.requireVerifiedCapabilities &&
+            connection.capabilityVerification !== 'verified') {
+            reason('CAPABILITY_SNAPSHOT_UNVERIFIED');
+        }
+    }
+    const capabilities = evaluateCapabilities(connection.capabilities, input.executionPlan.runtimeRequirements);
+    for (const capability of capabilities.missingRequired) {
+        reason('REQUIRED_CAPABILITY_MISSING', capability);
+    }
+    for (const capability of capabilities.insufficientRequired) {
+        reason('REQUIRED_CAPABILITY_INSUFFICIENT', capability);
+    }
+    for (const capability of capabilities.missingOptional) {
+        degradation('OPTIONAL_CAPABILITY_MISSING', capability);
+    }
+    for (const capability of capabilities.degradedOptional) {
+        degradation('OPTIONAL_CAPABILITY_DEGRADED', capability);
+    }
+    if (connection.health === 'degraded')
+        degradation('RUNTIME_HEALTH_DEGRADED');
+    if (connection.compatibilityState === 'degraded')
+        degradation('COMPATIBILITY_DEGRADED');
+    if (connection.compatibilityState === 'untested')
+        degradation('COMPATIBILITY_UNTESTED');
+    const normalizedReasons = uniqueSorted(reasons);
+    const normalizedDegradations = uniqueSorted(degradations);
+    const eligible = normalizedReasons.length === 0;
+    return RuntimeEligibilityDecisionSchema.parse({
+        eligible,
+        mode: eligible ? (normalizedDegradations.length > 0 ? 'degraded' : 'full') : 'ineligible',
+        reasons: normalizedReasons,
+        degradations: normalizedDegradations,
+        audit: {
+            eligibilityVersion: input.eligibilityVersion,
+            executionPlanId: input.executionPlan.executionPlanId,
+            runtimeConnectionId: connection.runtimeConnectionId,
+            policySnapshot: input.policy.snapshot,
+            evaluatedAt: input.evaluatedAt,
+            inputDigest: digestEligibilityInput(input),
+        },
+    });
+}
+function uniqueSorted(values) {
+    const unique = new Map(values.map((value) => [`${value.code}:${value.capability ?? ''}`, value]));
+    return [...unique.values()].sort((left, right) => `${left.code}:${left.capability ?? ''}`.localeCompare(`${right.code}:${right.capability ?? ''}`));
+}
+function digestEligibilityInput(input) {
+    const normalized = {
+        ...input,
+        executionPlan: {
+            ...input.executionPlan,
+            runtimeRequirements: [...input.executionPlan.runtimeRequirements].sort((left, right) => left.capability.localeCompare(right.capability)),
+        },
+        candidate: {
+            ...input.candidate,
+            connection: {
+                ...input.candidate.connection,
+                capabilities: [...input.candidate.connection.capabilities].sort((left, right) => left.name.localeCompare(right.name)),
+                limitations: [...input.candidate.connection.limitations].sort(),
+                diagnostics: [...(input.candidate.connection.diagnostics ?? [])].sort(),
+            },
+        },
+        policy: {
+            ...input.policy,
+            allowedFamilies: [...input.policy.allowedFamilies].sort(),
+            allowedLocations: [...input.policy.allowedLocations].sort(),
+            deniedRuntimeConnectionIds: [...input.policy.deniedRuntimeConnectionIds].sort(),
+        },
+    };
+    return `sha256:${createHash('sha256').update(JSON.stringify(normalized)).digest('hex')}`;
+}
+//# sourceMappingURL=eligibility.js.map

package/dist/eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.js","sourceRoot":"","sources":["../src/eligibility.ts"],"names":[],"mappings":"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"}

package/dist/fixtures.d.ts

@@ -0,0 +1,90 @@
+export declare const RuntimeFixtures: Readonly<{
+    mock: {
+        runtimeDefinitionId: import("@control-plane/contracts").OpaqueIdentifier<"runtime-definition ID">;
+        family: string;
+        adapterVersion: string;
+        driverVersion: string;
+        harnessVersion: string;
+        location: "local_device" | "remote_host" | "agent_hq_cloud";
+        health: "degraded" | "healthy" | "unavailable";
+        lifecycle: "active" | "deprecated" | "revoked";
+        capabilities: {
+            name: "stream.output" | "stream.events" | "tool.call" | "tool.parallel" | "output.structured" | "filesystem.read" | "filesystem.write" | "project.read" | "project.write" | "execution.cancel" | "interaction.user-input" | "interaction.approval" | "session.create" | "session.list" | "session.resume" | "session.close" | "session.history" | "session.load" | "model.select" | "execution.child";
+            support: "supported" | "degraded" | "unsupported";
+            limitations?: string[] | undefined;
+        }[];
+        compatibility: {
+            status: "tested" | "untested" | "incompatible";
+            testedVersions: {
+                contractVersion: {
+                    major: number;
+                    minor: number;
+                };
+                adapterVersion: string;
+                driverVersion: string;
+                harnessVersion: string;
+            };
+            limitations: string[];
+            reason?: string | undefined;
+        };
+    };
+    futurePi: {
+        runtimeDefinitionId: import("@control-plane/contracts").OpaqueIdentifier<"runtime-definition ID">;
+        family: string;
+        adapterVersion: string;
+        driverVersion: string;
+        harnessVersion: string;
+        location: "local_device" | "remote_host" | "agent_hq_cloud";
+        health: "degraded" | "healthy" | "unavailable";
+        lifecycle: "active" | "deprecated" | "revoked";
+        capabilities: {
+            name: "stream.output" | "stream.events" | "tool.call" | "tool.parallel" | "output.structured" | "filesystem.read" | "filesystem.write" | "project.read" | "project.write" | "execution.cancel" | "interaction.user-input" | "interaction.approval" | "session.create" | "session.list" | "session.resume" | "session.close" | "session.history" | "session.load" | "model.select" | "execution.child";
+            support: "supported" | "degraded" | "unsupported";
+            limitations?: string[] | undefined;
+        }[];
+        compatibility: {
+            status: "tested" | "untested" | "incompatible";
+            testedVersions: {
+                contractVersion: {
+                    major: number;
+                    minor: number;
+                };
+                adapterVersion: string;
+                driverVersion: string;
+                harnessVersion: string;
+            };
+            limitations: string[];
+            reason?: string | undefined;
+        };
+    };
+    futureAcp: {
+        runtimeDefinitionId: import("@control-plane/contracts").OpaqueIdentifier<"runtime-definition ID">;
+        family: string;
+        adapterVersion: string;
+        driverVersion: string;
+        harnessVersion: string;
+        location: "local_device" | "remote_host" | "agent_hq_cloud";
+        health: "degraded" | "healthy" | "unavailable";
+        lifecycle: "active" | "deprecated" | "revoked";
+        capabilities: {
+            name: "stream.output" | "stream.events" | "tool.call" | "tool.parallel" | "output.structured" | "filesystem.read" | "filesystem.write" | "project.read" | "project.write" | "execution.cancel" | "interaction.user-input" | "interaction.approval" | "session.create" | "session.list" | "session.resume" | "session.close" | "session.history" | "session.load" | "model.select" | "execution.child";
+            support: "supported" | "degraded" | "unsupported";
+            limitations?: string[] | undefined;
+        }[];
+        compatibility: {
+            status: "tested" | "untested" | "incompatible";
+            testedVersions: {
+                contractVersion: {
+                    major: number;
+                    minor: number;
+                };
+                adapterVersion: string;
+                driverVersion: string;
+                harnessVersion: string;
+            };
+            limitations: string[];
+            reason?: string | undefined;
+        };
+    };
+}>;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB1B,CAAA"}

package/dist/fixtures.js

@@ -0,0 +1,48 @@
+import { RuntimeDefinitionSchema } from './models.js';
+const testedVersions = {
+    contractVersion: { major: 1, minor: 0 },
+    adapterVersion: '1.0.0',
+    driverVersion: '1.0.0',
+    harnessVersion: '1.0.0',
+};
+export const RuntimeFixtures = Object.freeze({
+    mock: runtime('rtd_01JABCDEF0123456789ABCDEFG', 'mock', [
+        capability('stream.output'),
+        capability('output.structured'),
+        capability('session.create'),
+    ]),
+    futurePi: runtime('rtd_01JBBCDEF0123456789ABCDEFG', 'pi', [
+        capability('stream.output'),
+        capability('tool.call'),
+        capability('session.create'),
+        capability('session.list'),
+        capability('session.resume'),
+        capability('session.close'),
+        capability('session.history', 'degraded', ['History may be truncated']),
+    ]),
+    futureAcp: runtime('rtd_01JZBCDEF0123456789ABCDEFG', 'acp', [
+        capability('stream.output'),
+        capability('tool.call'),
+        capability('session.list'),
+        capability('session.resume'),
+        capability('session.load'),
+    ]),
+});
+function runtime(runtimeDefinitionId, family, capabilities) {
+    return RuntimeDefinitionSchema.parse({
+        runtimeDefinitionId,
+        family,
+        adapterVersion: '1.0.0',
+        driverVersion: '1.0.0',
+        harnessVersion: '1.0.0',
+        location: 'local_device',
+        health: 'healthy',
+        lifecycle: 'active',
+        capabilities,
+        compatibility: { status: 'tested', testedVersions, limitations: [] },
+    });
+}
+function capability(name, support = 'supported', limitations) {
+    return { name, support, ...(limitations === undefined ? {} : { limitations: [...limitations] }) };
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAA0B,MAAM,aAAa,CAAA;AAE7E,MAAM,cAAc,GAAG;IACrB,eAAe,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;IACvC,cAAc,EAAE,OAAO;IACvB,aAAa,EAAE,OAAO;IACtB,cAAc,EAAE,OAAO;CACf,CAAA;AAEV,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,OAAO,CAAC,gCAAgC,EAAE,MAAM,EAAE;QACtD,UAAU,CAAC,eAAe,CAAC;QAC3B,UAAU,CAAC,mBAAmB,CAAC;QAC/B,UAAU,CAAC,gBAAgB,CAAC;KAC7B,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC,gCAAgC,EAAE,IAAI,EAAE;QACxD,UAAU,CAAC,eAAe,CAAC;QAC3B,UAAU,CAAC,WAAW,CAAC;QACvB,UAAU,CAAC,gBAAgB,CAAC;QAC5B,UAAU,CAAC,cAAc,CAAC;QAC1B,UAAU,CAAC,gBAAgB,CAAC;QAC5B,UAAU,CAAC,eAAe,CAAC;QAC3B,UAAU,CAAC,iBAAiB,EAAE,UAAU,EAAE,CAAC,0BAA0B,CAAC,CAAC;KACxE,CAAC;IACF,SAAS,EAAE,OAAO,CAAC,gCAAgC,EAAE,KAAK,EAAE;QAC1D,UAAU,CAAC,eAAe,CAAC;QAC3B,UAAU,CAAC,WAAW,CAAC;QACvB,UAAU,CAAC,cAAc,CAAC;QAC1B,UAAU,CAAC,gBAAgB,CAAC;QAC5B,UAAU,CAAC,cAAc,CAAC;KAC3B,CAAC;CACH,CAAC,CAAA;AAEF,SAAS,OAAO,CACd,mBAA2B,EAC3B,MAAc,EACd,YAA+C;IAE/C,OAAO,uBAAuB,CAAC,KAAK,CAAC;QACnC,mBAAmB;QACnB,MAAM;QACN,cAAc,EAAE,OAAO;QACvB,aAAa,EAAE,OAAO;QACtB,cAAc,EAAE,OAAO;QACvB,QAAQ,EAAE,cAAc;QACxB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,QAAQ;QACnB,YAAY;QACZ,aAAa,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE;KACrE,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,IAAuD,EACvD,UAAgE,WAAW,EAC3E,WAA+B;IAE/B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC,EAAE,CAAA;AACnG,CAAC"}

package/dist/health.d.ts

@@ -0,0 +1,182 @@
+import { z } from 'zod';
+import { type RuntimeAvailabilityState, type RuntimeConnection } from './models.js';
+import { RuntimeConnectionRegistry } from './registry.js';
+export declare const RuntimeNodeHealthStatusSchema: z.ZodEnum<{
+    unknown: "unknown";
+    revoked: "revoked";
+    online: "online";
+    offline: "offline";
+}>;
+export declare const RuntimeReportedStateSchema: z.ZodEnum<{
+    degraded: "degraded";
+    unknown: "unknown";
+    healthy: "healthy";
+    offline: "offline";
+    reconnecting: "reconnecting";
+}>;
+export declare const RuntimeHealthReportSchema: z.ZodObject<{
+    runtimeConnectionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"runtime-connection ID">, string>>;
+    reportSequence: z.ZodNumber;
+    observedAt: z.ZodISODateTime;
+    discoveredAt: z.ZodISODateTime;
+    nodeStatus: z.ZodEnum<{
+        unknown: "unknown";
+        revoked: "revoked";
+        online: "online";
+        offline: "offline";
+    }>;
+    runtimeState: z.ZodEnum<{
+        degraded: "degraded";
+        unknown: "unknown";
+        healthy: "healthy";
+        offline: "offline";
+        reconnecting: "reconnecting";
+    }>;
+    versions: z.ZodObject<{
+        adapter: z.ZodString;
+        driver: z.ZodString;
+        harness: z.ZodString;
+        protocol: z.ZodString;
+    }, z.core.$strict>;
+    capabilitySnapshot: z.ZodObject<{
+        version: z.ZodNumber;
+        observedAt: z.ZodISODateTime;
+        ttlMs: z.ZodNumber;
+        verification: z.ZodEnum<{
+            verified: "verified";
+            unverified: "unverified";
+        }>;
+        source: z.ZodEnum<{
+            adapter_driver_negotiation: "adapter_driver_negotiation";
+            runtime_declaration: "runtime_declaration";
+        }>;
+        capabilities: z.ZodArray<z.ZodObject<{
+            name: z.ZodEnum<{
+                "stream.output": "stream.output";
+                "stream.events": "stream.events";
+                "tool.call": "tool.call";
+                "tool.parallel": "tool.parallel";
+                "output.structured": "output.structured";
+                "filesystem.read": "filesystem.read";
+                "filesystem.write": "filesystem.write";
+                "project.read": "project.read";
+                "project.write": "project.write";
+                "execution.cancel": "execution.cancel";
+                "interaction.user-input": "interaction.user-input";
+                "interaction.approval": "interaction.approval";
+                "session.create": "session.create";
+                "session.list": "session.list";
+                "session.resume": "session.resume";
+                "session.close": "session.close";
+                "session.history": "session.history";
+                "session.load": "session.load";
+                "model.select": "model.select";
+                "execution.child": "execution.child";
+            }>;
+            support: z.ZodEnum<{
+                supported: "supported";
+                degraded: "degraded";
+                unsupported: "unsupported";
+            }>;
+            limitations: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+    limitations: z.ZodArray<z.ZodString>;
+    diagnostics: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const RuntimeAvailabilityAssessmentSchema: z.ZodObject<{
+    nodeStatus: z.ZodEnum<{
+        unknown: "unknown";
+        revoked: "revoked";
+        online: "online";
+        offline: "offline";
+    }>;
+    availabilityState: z.ZodEnum<{
+        degraded: "degraded";
+        unknown: "unknown";
+        healthy: "healthy";
+        revoked: "revoked";
+        incompatible: "incompatible";
+        offline: "offline";
+        reconnecting: "reconnecting";
+        stale: "stale";
+    }>;
+    executable: z.ZodBoolean;
+    capabilitySnapshotExpiresAt: z.ZodOptional<z.ZodISODateTime>;
+    diagnostics: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const RuntimeAvailabilityChangeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"runtime.availability_changed">;
+    runtimeConnectionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"runtime-connection ID">, string>>;
+    nodeStatus: z.ZodEnum<{
+        unknown: "unknown";
+        revoked: "revoked";
+        online: "online";
+        offline: "offline";
+    }>;
+    previousState: z.ZodEnum<{
+        degraded: "degraded";
+        unknown: "unknown";
+        healthy: "healthy";
+        revoked: "revoked";
+        incompatible: "incompatible";
+        offline: "offline";
+        reconnecting: "reconnecting";
+        stale: "stale";
+    }>;
+    currentState: z.ZodEnum<{
+        degraded: "degraded";
+        unknown: "unknown";
+        healthy: "healthy";
+        revoked: "revoked";
+        incompatible: "incompatible";
+        offline: "offline";
+        reconnecting: "reconnecting";
+        stale: "stale";
+    }>;
+    occurredAt: z.ZodISODateTime;
+    diagnostics: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type RuntimeHealthReport = z.output<typeof RuntimeHealthReportSchema>;
+export type RuntimeAvailabilityAssessment = z.output<typeof RuntimeAvailabilityAssessmentSchema>;
+export type RuntimeAvailabilityChange = z.output<typeof RuntimeAvailabilityChangeSchema>;
+export interface RuntimeAvailabilityChangePublisher {
+    publish(change: RuntimeAvailabilityChange): Promise<void>;
+}
+export declare class RecordingRuntimeAvailabilityChangePublisher implements RuntimeAvailabilityChangePublisher {
+    readonly events: RuntimeAvailabilityChange[];
+    publish(changeInput: RuntimeAvailabilityChange): Promise<void>;
+}
+export interface RuntimeHealthIngestionPolicy {
+    readonly adapterMajor: number;
+    readonly driverMajor: number;
+    readonly harnessMajor: number;
+    readonly protocolMajor: number;
+    readonly healthTtlMs: number;
+    readonly maximumCapabilityTtlMs: number;
+}
+export interface RuntimeHealthIngestionOptions {
+    readonly registry: RuntimeConnectionRegistry;
+    readonly changes: RuntimeAvailabilityChangePublisher;
+    readonly policy: RuntimeHealthIngestionPolicy;
+}
+export type RuntimeHealthIngestionIgnoreReason = 'replayed_report' | 'stale_report' | 'no_health_report' | 'already_current';
+export interface RuntimeHealthIngestionResult {
+    readonly applied: boolean;
+    readonly reason?: RuntimeHealthIngestionIgnoreReason;
+    readonly connection: RuntimeConnection;
+    readonly assessment: RuntimeAvailabilityAssessment;
+}
+export type RuntimeHealthIngestionErrorCode = 'HEALTH_REPORT_CONFLICT' | 'CAPABILITY_SNAPSHOT_CONFLICT' | 'CONNECTION_MISSING' | 'INGESTION_CONCURRENCY_EXHAUSTED';
+export declare class RuntimeHealthIngestionError extends Error {
+    readonly code: RuntimeHealthIngestionErrorCode;
+    constructor(code: RuntimeHealthIngestionErrorCode);
+}
+export declare class RuntimeHealthIngestionService {
+    #private;
+    constructor(options: RuntimeHealthIngestionOptions);
+    ingest(reportInput: unknown, evaluatedAtInput: string, attempt?: number): Promise<RuntimeHealthIngestionResult>;
+    refresh(input: unknown): Promise<RuntimeHealthIngestionResult>;
+}
+export declare function runtimeAvailabilityIsExecutable(state: RuntimeAvailabilityState): boolean;
+//# sourceMappingURL=health.d.ts.map

package/dist/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../src/health.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAML,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,yBAAyB,EAG1B,MAAM,eAAe,CAAA;AAiBtB,eAAO,MAAM,6BAA6B;;;;;EAAsD,CAAA;AAChG,eAAO,MAAM,0BAA0B;;;;;;EAMrC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA2CnC,CAAA;AAEH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;kBAQrC,CAAA;AAEX,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUjC,CAAA;AAEX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC5E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mCAAmC,CAAC,CAAA;AAChG,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAExF,MAAM,WAAW,kCAAkC;IACjD,OAAO,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAED,qBAAa,2CAA4C,YAAW,kCAAkC;IACpG,QAAQ,CAAC,MAAM,EAAE,yBAAyB,EAAE,CAAK;IAE3C,OAAO,CAAC,WAAW,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrE;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;CACxC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAA;IAC5C,QAAQ,CAAC,OAAO,EAAE,kCAAkC,CAAA;IACpD,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAA;CAC9C;AAED,MAAM,MAAM,kCAAkC,GAC1C,iBAAiB,GACjB,cAAc,GACd,kBAAkB,GAClB,iBAAiB,CAAA;AAErB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,kCAAkC,CAAA;IACpD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAA;CACnD;AAED,MAAM,MAAM,+BAA+B,GACvC,wBAAwB,GACxB,8BAA8B,GAC9B,oBAAoB,GACpB,iCAAiC,CAAA;AAErC,qBAAa,2BAA4B,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,+BAA+B;gBAArC,IAAI,EAAE,+BAA+B;CAI3D;AAED,qBAAa,6BAA6B;;gBAK5B,OAAO,EAAE,6BAA6B;IAM5C,MAAM,CACV,WAAW,EAAE,OAAO,EACpB,gBAAgB,EAAE,MAAM,EACxB,OAAO,SAAI,GACV,OAAO,CAAC,4BAA4B,CAAC;IA4ElC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAkErE;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAExF"}