@adea-ai/runtime-sdk 1.5.2

package/dist/routing.js

@@ -0,0 +1,314 @@
+import { createHash } from 'node:crypto';
+import { IdentifierSchemas } from '@control-plane/contracts';
+import { z } from 'zod';
+import { RuntimeEligibilityDecisionSchema, RuntimeEligibilityReasonCodeSchema, } from './eligibility.js';
+import { 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 WeightSchema = z.number().int().nonnegative().max(1_000_000);
+export const RuntimeRoutingPolicySchema = z
+    .object({
+    policyId: z.string().min(1).max(128),
+    version: z.number().int().positive(),
+    digest: DigestSchema,
+    weights: z
+        .object({
+        explicitConnection: WeightSchema,
+        preferredFamily: WeightSchema,
+        preferredDeployment: WeightSchema,
+        locality: WeightSchema,
+        health: WeightSchema,
+        load: WeightSchema,
+        queue: WeightSchema,
+        entitlement: WeightSchema,
+        cost: WeightSchema,
+    })
+        .strict(),
+})
+    .strict();
+export const RuntimeRoutingCandidateSchema = z
+    .object({
+    runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+    family: RuntimeFamilySchema,
+    deployment: z.enum(['managed', 'local']),
+    eligibility: RuntimeEligibilityDecisionSchema,
+    signals: z
+        .object({
+        locality: z.number().int().min(0).max(100),
+        health: z.number().int().min(0).max(100),
+        loadPermille: z.number().int().min(0).max(1_000),
+        queueDepth: z.number().int().nonnegative().max(1_000_000),
+        entitlementPriority: z.number().int().min(0).max(100),
+        costClass: z.enum(['low', 'medium', 'high', 'unknown']),
+    })
+        .strict(),
+})
+    .strict()
+    .refine((candidate) => candidate.runtimeConnectionId === candidate.eligibility.audit.runtimeConnectionId, 'Candidate and eligibility runtime identities must agree');
+export const RuntimeRoutingInputSchema = z
+    .object({
+    routingVersion: z.literal(1),
+    executionPlanId: IdentifierSchemas.executionPlanId,
+    evaluatedAt: RuntimeTimestampSchema,
+    policy: RuntimeRoutingPolicySchema,
+    preference: z
+        .object({
+        runtimeConnectionId: IdentifierSchemas.runtimeConnectionId.optional(),
+        family: RuntimeFamilySchema.optional(),
+        deployment: z.enum(['managed', 'local']).optional(),
+    })
+        .strict()
+        .refine((preference) => Object.values(preference).some((value) => value !== undefined))
+        .optional(),
+    candidates: z
+        .array(RuntimeRoutingCandidateSchema)
+        .max(1_000)
+        .refine((candidates) => new Set(candidates.map(({ runtimeConnectionId }) => runtimeConnectionId)).size ===
+        candidates.length, 'Routing candidate identities must be unique'),
+})
+    .strict()
+    .refine((input) => input.candidates.every(({ eligibility }) => eligibility.audit.executionPlanId === input.executionPlanId), 'Routing candidates must share the requested ExecutionPlan');
+export const RuntimeRoutingReasonCodeSchema = z.enum([
+    'COST',
+    'ENTITLEMENT',
+    'EXPLICIT_CONNECTION',
+    'HEALTH',
+    'LOAD',
+    'LOCALITY',
+    'PREFERRED_DEPLOYMENT',
+    'PREFERRED_FAMILY',
+    'QUEUE',
+]);
+const RuntimeRoutingReasonSchema = z
+    .object({
+    code: RuntimeRoutingReasonCodeSchema,
+    contribution: z.number().int().nonnegative(),
+})
+    .strict();
+const RankedRuntimeSchema = z
+    .object({
+    rank: z.number().int().positive(),
+    runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+    score: z.number().int().nonnegative(),
+    eligibilityMode: z.enum(['full', 'degraded']),
+    reasons: z.array(RuntimeRoutingReasonSchema),
+})
+    .strict();
+const ExcludedRuntimeSchema = z
+    .object({
+    runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+    eligibilityReasons: z.array(RuntimeEligibilityReasonCodeSchema),
+})
+    .strict();
+export const RuntimeRoutingDecisionSchema = z
+    .object({
+    outcome: z.enum([
+        'selected',
+        'preference_unavailable',
+        'transient_unavailable',
+        'no_candidate',
+    ]),
+    selected: RankedRuntimeSchema.optional(),
+    ranked: z.array(RankedRuntimeSchema),
+    excluded: z.array(ExcludedRuntimeSchema),
+    audit: z
+        .object({
+        routingVersion: z.literal(1),
+        executionPlanId: IdentifierSchemas.executionPlanId,
+        policy: z
+            .object({
+            policyId: z.string().min(1).max(128),
+            version: z.number().int().positive(),
+            digest: DigestSchema,
+        })
+            .strict(),
+        evaluatedAt: RuntimeTimestampSchema,
+        inputDigest: DigestSchema,
+        decisionDigest: DigestSchema,
+    })
+        .strict(),
+})
+    .strict()
+    .superRefine((decision, context) => {
+    const hasSelection = decision.selected !== undefined;
+    if (hasSelection !== ['selected', 'preference_unavailable'].includes(decision.outcome)) {
+        context.addIssue({ code: 'custom', message: 'Routing outcome and selection must agree' });
+    }
+    if (hasSelection &&
+        decision.ranked[0]?.runtimeConnectionId !== decision.selected?.runtimeConnectionId) {
+        context.addIssue({ code: 'custom', message: 'Selected runtime must lead the ranking' });
+    }
+});
+export function routeRuntimeConnections(inputValue) {
+    const input = RuntimeRoutingInputSchema.parse(inputValue);
+    const eligible = input.candidates.filter(({ eligibility }) => eligibility.eligible);
+    const excluded = input.candidates
+        .filter(({ eligibility }) => !eligibility.eligible)
+        .map((candidate) => ({
+        runtimeConnectionId: candidate.runtimeConnectionId,
+        eligibilityReasons: candidate.eligibility.reasons.map(({ code }) => code).sort(),
+    }))
+        .sort((left, right) => left.runtimeConnectionId.localeCompare(right.runtimeConnectionId));
+    const ranked = eligible
+        .map((candidate) => scoreCandidate(input, candidate))
+        .sort((left, right) => right.score - left.score ||
+        left.runtimeConnectionId.localeCompare(right.runtimeConnectionId))
+        .map((candidate, index) => ({ ...candidate, rank: index + 1 }));
+    const preferenceUnavailable = input.preference !== undefined &&
+        ((input.preference.runtimeConnectionId !== undefined &&
+            !eligible.some(({ runtimeConnectionId }) => runtimeConnectionId === input.preference?.runtimeConnectionId)) ||
+            (input.preference.family !== undefined &&
+                !eligible.some(({ family }) => family === input.preference?.family)) ||
+            (input.preference.deployment !== undefined &&
+                !eligible.some(({ deployment }) => deployment === input.preference?.deployment)));
+    const selected = ranked[0];
+    const outcome = selected
+        ? preferenceUnavailable
+            ? 'preference_unavailable'
+            : 'selected'
+        : classifyEmptyOutcome(input, excluded);
+    const decisionWithoutDigest = {
+        outcome,
+        ...(selected === undefined ? {} : { selected }),
+        ranked,
+        excluded,
+        audit: {
+            routingVersion: input.routingVersion,
+            executionPlanId: input.executionPlanId,
+            policy: {
+                policyId: input.policy.policyId,
+                version: input.policy.version,
+                digest: input.policy.digest,
+            },
+            evaluatedAt: input.evaluatedAt,
+            inputDigest: digest(normalizeRoutingInput(input)),
+        },
+    };
+    return RuntimeRoutingDecisionSchema.parse({
+        ...decisionWithoutDigest,
+        audit: {
+            ...decisionWithoutDigest.audit,
+            decisionDigest: digest(decisionWithoutDigest),
+        },
+    });
+}
+export function toAttemptRoutingDecision(decisionValue) {
+    const decision = RuntimeRoutingDecisionSchema.parse(decisionValue);
+    if (!decision.selected)
+        throw new Error('ROUTING_SELECTION_REQUIRED');
+    const expectedDigest = digest({
+        outcome: decision.outcome,
+        selected: decision.selected,
+        ranked: decision.ranked,
+        excluded: decision.excluded,
+        audit: {
+            routingVersion: decision.audit.routingVersion,
+            executionPlanId: decision.audit.executionPlanId,
+            policy: decision.audit.policy,
+            evaluatedAt: decision.audit.evaluatedAt,
+            inputDigest: decision.audit.inputDigest,
+        },
+    });
+    if (expectedDigest !== decision.audit.decisionDigest) {
+        throw new Error('ROUTING_DECISION_DIGEST_MISMATCH');
+    }
+    return {
+        routingVersion: decision.audit.routingVersion,
+        policy: decision.audit.policy,
+        evaluatedAt: decision.audit.evaluatedAt,
+        inputDigest: decision.audit.inputDigest,
+        decisionDigest: decision.audit.decisionDigest,
+        selectedRank: decision.selected.rank,
+        candidateCount: decision.ranked.length,
+        reasonCodes: decision.selected.reasons.map(({ code }) => code).sort(),
+    };
+}
+function scoreCandidate(input, candidate) {
+    const { preference, policy } = input;
+    const costValue = { low: 3, medium: 2, high: 1, unknown: 0 }[candidate.signals.costClass];
+    const contributions = [
+        {
+            code: 'EXPLICIT_CONNECTION',
+            contribution: preference?.runtimeConnectionId === candidate.runtimeConnectionId
+                ? policy.weights.explicitConnection
+                : 0,
+        },
+        {
+            code: 'PREFERRED_FAMILY',
+            contribution: preference?.family === candidate.family ? policy.weights.preferredFamily : 0,
+        },
+        {
+            code: 'PREFERRED_DEPLOYMENT',
+            contribution: preference?.deployment === candidate.deployment ? policy.weights.preferredDeployment : 0,
+        },
+        {
+            code: 'LOCALITY',
+            contribution: candidate.signals.locality * policy.weights.locality,
+        },
+        { code: 'HEALTH', contribution: candidate.signals.health * policy.weights.health },
+        {
+            code: 'LOAD',
+            contribution: (1_000 - candidate.signals.loadPermille) * policy.weights.load,
+        },
+        {
+            code: 'QUEUE',
+            contribution: Math.max(0, 1_000 - Math.min(candidate.signals.queueDepth, 1_000)) * policy.weights.queue,
+        },
+        {
+            code: 'ENTITLEMENT',
+            contribution: candidate.signals.entitlementPriority * policy.weights.entitlement,
+        },
+        { code: 'COST', contribution: costValue * policy.weights.cost },
+    ].filter(({ contribution }) => contribution > 0);
+    return {
+        rank: 1,
+        runtimeConnectionId: candidate.runtimeConnectionId,
+        score: contributions.reduce((total, { contribution }) => total + contribution, 0),
+        eligibilityMode: candidate.eligibility.mode,
+        reasons: contributions,
+    };
+}
+const transientReasons = new Set([
+    'CAPABILITY_SNAPSHOT_MISSING',
+    'CAPABILITY_SNAPSHOT_STALE',
+    'RUNTIME_EXPIRED',
+    'RUNTIME_NODE_OFFLINE',
+    'RUNTIME_NODE_UNKNOWN',
+    'RUNTIME_OFFLINE',
+    'RUNTIME_STALE',
+    'RUNTIME_UNAVAILABLE',
+]);
+function classifyEmptyOutcome(input, excluded) {
+    if (input.candidates.length === 0 || excluded.length === 0)
+        return 'no_candidate';
+    const reasons = excluded.flatMap(({ eligibilityReasons }) => eligibilityReasons);
+    return reasons.length > 0 && reasons.every((reason) => transientReasons.has(reason))
+        ? 'transient_unavailable'
+        : 'no_candidate';
+}
+function normalizeRoutingInput(input) {
+    return {
+        ...input,
+        candidates: [...input.candidates]
+            .map((candidate) => ({
+            ...candidate,
+            eligibility: {
+                ...candidate.eligibility,
+                reasons: [...candidate.eligibility.reasons].sort(compareCoded),
+                degradations: [...candidate.eligibility.degradations].sort(compareCoded),
+            },
+        }))
+            .sort((left, right) => left.runtimeConnectionId.localeCompare(right.runtimeConnectionId)),
+    };
+}
+function compareCoded(left, right) {
+    return `${left.code}:${left.capability ?? ''}`.localeCompare(`${right.code}:${right.capability ?? ''}`);
+}
+function digest(value) {
+    return `sha256:${createHash('sha256').update(JSON.stringify(value)).digest('hex')}`;
+}
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

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

package/dist/sessions.d.ts

@@ -0,0 +1,251 @@
+import { z } from 'zod';
+export declare const OpaqueNativeSessionIdSchema: z.ZodString;
+export declare const ExternalSessionCapabilitySnapshotSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    observedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+    operations: z.ZodArray<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";
+    }>>;
+}, z.core.$strict>;
+export declare const ExternalSessionSafeMetadataSchema: z.ZodObject<{
+    origin: z.ZodEnum<{
+        native_discovery: "native_discovery";
+        created_through_control_plane: "created_through_control_plane";
+    }>;
+    displayName: z.ZodOptional<z.ZodString>;
+    limitations: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const ExternalSessionStateSchema: z.ZodEnum<{
+    active: "active";
+    closed: "closed";
+    revoked: "revoked";
+    removed: "removed";
+}>;
+export declare const ExternalSessionSchema: z.ZodObject<{
+    externalSessionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"external-session ID">, string>>;
+    runtimeConnectionId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"runtime-connection ID">, string>>;
+    opaqueNativeSessionId: z.ZodString;
+    workspaceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"workspace ID">, string>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"project ID">, string>>>;
+    state: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+        revoked: "revoked";
+        removed: "removed";
+    }>;
+    ownership: z.ZodObject<{
+        authority: z.ZodLiteral<"external_runtime">;
+        imported: z.ZodLiteral<false>;
+        concurrentNativeUse: z.ZodLiteral<"allowed">;
+    }, z.core.$strict>;
+    capabilitySnapshot: z.ZodObject<{
+        version: z.ZodNumber;
+        observedAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+        operations: z.ZodArray<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";
+        }>>;
+    }, z.core.$strict>;
+    safeMetadata: z.ZodObject<{
+        origin: z.ZodEnum<{
+            native_discovery: "native_discovery";
+            created_through_control_plane: "created_through_control_plane";
+        }>;
+        displayName: z.ZodOptional<z.ZodString>;
+        limitations: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    lastObservedAt: z.ZodISODateTime;
+    version: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const ExternalSessionListScopeSchema: z.ZodObject<{
+    workspaceId: z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"workspace ID">, string>>;
+    projectId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"project ID">, string>>>;
+    runtimeConnectionId: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<import("@control-plane/contracts").OpaqueIdentifier<"runtime-connection ID">, string>>>;
+}, z.core.$strict>;
+export type ExternalSession = z.output<typeof ExternalSessionSchema>;
+export type ExternalSessionListScope = z.output<typeof ExternalSessionListScopeSchema>;
+export interface ExternalSessionRepository {
+    insert(session: ExternalSession): Promise<boolean>;
+    get(externalSessionId: string): Promise<ExternalSession | undefined>;
+    findByNativeIdentity(runtimeConnectionId: string, opaqueNativeSessionId: string): Promise<ExternalSession | undefined>;
+    list(scope: ExternalSessionListScope): Promise<readonly ExternalSession[]>;
+    compareAndSet(expectedVersion: number, session: ExternalSession): Promise<boolean>;
+}
+export declare class InMemoryExternalSessionRepository implements ExternalSessionRepository {
+    #private;
+    insert(session: ExternalSession): Promise<boolean>;
+    get(externalSessionId: string): Promise<ExternalSession | undefined>;
+    findByNativeIdentity(runtimeConnectionId: string, opaqueNativeSessionId: string): Promise<ExternalSession | undefined>;
+    list(scope: ExternalSessionListScope): Promise<readonly ExternalSession[]>;
+    compareAndSet(expectedVersion: number, session: ExternalSession): Promise<boolean>;
+}
+export type ExternalSessionRegistryErrorCode = 'CAPABILITY_SNAPSHOT_CONFLICT' | 'CAPABILITY_SNAPSHOT_REGRESSION' | 'SESSION_IDENTITY_CONFLICT' | 'SESSION_MISSING' | 'SESSION_REVOKED' | 'STALE_SESSION_VERSION' | 'TIMESTAMP_REGRESSION';
+export declare class ExternalSessionRegistryError extends Error {
+    readonly code: ExternalSessionRegistryErrorCode;
+    readonly currentVersion?: number | undefined;
+    constructor(code: ExternalSessionRegistryErrorCode, currentVersion?: number | undefined);
+}
+export declare class ExternalSessionRegistry {
+    readonly repository: ExternalSessionRepository;
+    constructor(repository: ExternalSessionRepository);
+    register(inputValue: unknown): Promise<ExternalSession>;
+    get(externalSessionIdValue: string): Promise<ExternalSession>;
+    list(scopeValue: unknown): Promise<readonly ExternalSession[]>;
+    update(inputValue: unknown): Promise<ExternalSession>;
+}
+export declare const ExternalSessionAssessmentStateSchema: z.ZodEnum<{
+    active: "active";
+    closed: "closed";
+    revoked: "revoked";
+    offline: "offline";
+    stale: "stale";
+    removed: "removed";
+    runtime_missing: "runtime_missing";
+    capability_changed: "capability_changed";
+}>;
+export declare const ExternalSessionOperationUnavailableReasonSchema: z.ZodEnum<{
+    RUNTIME_OFFLINE: "RUNTIME_OFFLINE";
+    SESSION_REVOKED: "SESSION_REVOKED";
+    CAPABILITY_NOT_ADVERTISED: "CAPABILITY_NOT_ADVERTISED";
+    CAPABILITY_NO_LONGER_ADVERTISED: "CAPABILITY_NO_LONGER_ADVERTISED";
+    RUNTIME_MISSING: "RUNTIME_MISSING";
+    SESSION_CAPABILITIES_STALE: "SESSION_CAPABILITIES_STALE";
+    SESSION_CLOSED: "SESSION_CLOSED";
+    SESSION_REMOVED: "SESSION_REMOVED";
+}>;
+export declare const ExternalSessionAssessmentSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+        revoked: "revoked";
+        offline: "offline";
+        stale: "stale";
+        removed: "removed";
+        runtime_missing: "runtime_missing";
+        capability_changed: "capability_changed";
+    }>;
+    recoverable: z.ZodBoolean;
+    evaluatedAt: z.ZodOptional<z.ZodISODateTime>;
+    operations: z.ZodObject<{
+        reference: z.ZodUnion<readonly [z.ZodObject<{
+            available: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            available: z.ZodLiteral<false>;
+            reason: z.ZodEnum<{
+                RUNTIME_OFFLINE: "RUNTIME_OFFLINE";
+                SESSION_REVOKED: "SESSION_REVOKED";
+                CAPABILITY_NOT_ADVERTISED: "CAPABILITY_NOT_ADVERTISED";
+                CAPABILITY_NO_LONGER_ADVERTISED: "CAPABILITY_NO_LONGER_ADVERTISED";
+                RUNTIME_MISSING: "RUNTIME_MISSING";
+                SESSION_CAPABILITIES_STALE: "SESSION_CAPABILITIES_STALE";
+                SESSION_CLOSED: "SESSION_CLOSED";
+                SESSION_REMOVED: "SESSION_REMOVED";
+            }>;
+        }, z.core.$strict>]>;
+        resume: z.ZodUnion<readonly [z.ZodObject<{
+            available: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            available: z.ZodLiteral<false>;
+            reason: z.ZodEnum<{
+                RUNTIME_OFFLINE: "RUNTIME_OFFLINE";
+                SESSION_REVOKED: "SESSION_REVOKED";
+                CAPABILITY_NOT_ADVERTISED: "CAPABILITY_NOT_ADVERTISED";
+                CAPABILITY_NO_LONGER_ADVERTISED: "CAPABILITY_NO_LONGER_ADVERTISED";
+                RUNTIME_MISSING: "RUNTIME_MISSING";
+                SESSION_CAPABILITIES_STALE: "SESSION_CAPABILITIES_STALE";
+                SESSION_CLOSED: "SESSION_CLOSED";
+                SESSION_REMOVED: "SESSION_REMOVED";
+            }>;
+        }, z.core.$strict>]>;
+        load: z.ZodUnion<readonly [z.ZodObject<{
+            available: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            available: z.ZodLiteral<false>;
+            reason: z.ZodEnum<{
+                RUNTIME_OFFLINE: "RUNTIME_OFFLINE";
+                SESSION_REVOKED: "SESSION_REVOKED";
+                CAPABILITY_NOT_ADVERTISED: "CAPABILITY_NOT_ADVERTISED";
+                CAPABILITY_NO_LONGER_ADVERTISED: "CAPABILITY_NO_LONGER_ADVERTISED";
+                RUNTIME_MISSING: "RUNTIME_MISSING";
+                SESSION_CAPABILITIES_STALE: "SESSION_CAPABILITIES_STALE";
+                SESSION_CLOSED: "SESSION_CLOSED";
+                SESSION_REMOVED: "SESSION_REMOVED";
+            }>;
+        }, z.core.$strict>]>;
+        close: z.ZodUnion<readonly [z.ZodObject<{
+            available: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            available: z.ZodLiteral<false>;
+            reason: z.ZodEnum<{
+                RUNTIME_OFFLINE: "RUNTIME_OFFLINE";
+                SESSION_REVOKED: "SESSION_REVOKED";
+                CAPABILITY_NOT_ADVERTISED: "CAPABILITY_NOT_ADVERTISED";
+                CAPABILITY_NO_LONGER_ADVERTISED: "CAPABILITY_NO_LONGER_ADVERTISED";
+                RUNTIME_MISSING: "RUNTIME_MISSING";
+                SESSION_CAPABILITIES_STALE: "SESSION_CAPABILITIES_STALE";
+                SESSION_CLOSED: "SESSION_CLOSED";
+                SESSION_REMOVED: "SESSION_REMOVED";
+            }>;
+        }, z.core.$strict>]>;
+        history: z.ZodUnion<readonly [z.ZodObject<{
+            available: z.ZodLiteral<true>;
+        }, z.core.$strict>, z.ZodObject<{
+            available: z.ZodLiteral<false>;
+            reason: z.ZodEnum<{
+                RUNTIME_OFFLINE: "RUNTIME_OFFLINE";
+                SESSION_REVOKED: "SESSION_REVOKED";
+                CAPABILITY_NOT_ADVERTISED: "CAPABILITY_NOT_ADVERTISED";
+                CAPABILITY_NO_LONGER_ADVERTISED: "CAPABILITY_NO_LONGER_ADVERTISED";
+                RUNTIME_MISSING: "RUNTIME_MISSING";
+                SESSION_CAPABILITIES_STALE: "SESSION_CAPABILITIES_STALE";
+                SESSION_CLOSED: "SESSION_CLOSED";
+                SESSION_REMOVED: "SESSION_REMOVED";
+            }>;
+        }, z.core.$strict>]>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ExternalSessionAssessment = z.output<typeof ExternalSessionAssessmentSchema>;
+export declare function assessExternalSession(sessionValue: unknown, contextValue: unknown): ExternalSessionAssessment;
+export {};
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

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