@adea-ai/runtime-sdk 1.5.2

package/dist/sessions.js

@@ -0,0 +1,411 @@
+import { IdentifierSchemas } from '@control-plane/contracts';
+import { z } from 'zod';
+import { RuntimeCapabilityNameSchema } from './capabilities.js';
+import { RuntimeEligibilityNodeStatusSchema } from './eligibility.js';
+import { RuntimeConnectionSchema, RuntimeTimestampSchema, } from './models.js';
+const SessionOperationCapabilitySchema = RuntimeCapabilityNameSchema.refine((name) => name.startsWith('session.'));
+const NormalizedCodeSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .regex(/^[A-Z][A-Z0-9_]*$/);
+const SafeDisplayNameSchema = z
+    .string()
+    .min(1)
+    .max(128)
+    .refine((value) => !value.includes('/') &&
+    !value.includes('\\') &&
+    !value.includes('://') &&
+    [...value].every((character) => {
+        const code = character.charCodeAt(0);
+        return code >= 32 && code !== 127;
+    }), 'Display names cannot contain paths, URLs, or control characters');
+export const OpaqueNativeSessionIdSchema = z
+    .string()
+    .regex(/^nses_[0-9A-HJKMNP-TV-Z]{26}$/, 'Expected a canonical opaque native-session ID');
+export const ExternalSessionCapabilitySnapshotSchema = z
+    .object({
+    version: z.number().int().positive(),
+    observedAt: RuntimeTimestampSchema,
+    expiresAt: RuntimeTimestampSchema,
+    operations: z
+        .array(SessionOperationCapabilitySchema)
+        .max(6)
+        .refine((operations) => new Set(operations).size === operations.length),
+})
+    .strict()
+    .refine((snapshot) => Date.parse(snapshot.expiresAt) > Date.parse(snapshot.observedAt), 'Session capability expiry must follow its observation');
+export const ExternalSessionSafeMetadataSchema = z
+    .object({
+    origin: z.enum(['native_discovery', 'created_through_control_plane']),
+    displayName: SafeDisplayNameSchema.optional(),
+    limitations: z
+        .array(NormalizedCodeSchema)
+        .max(32)
+        .refine((limitations) => new Set(limitations).size === limitations.length),
+})
+    .strict();
+export const ExternalSessionStateSchema = z.enum(['active', 'closed', 'removed', 'revoked']);
+export const ExternalSessionSchema = z
+    .object({
+    externalSessionId: IdentifierSchemas.externalSessionId,
+    runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+    opaqueNativeSessionId: OpaqueNativeSessionIdSchema,
+    workspaceId: IdentifierSchemas.workspaceId,
+    projectId: IdentifierSchemas.projectId.optional(),
+    state: ExternalSessionStateSchema,
+    ownership: z
+        .object({
+        authority: z.literal('external_runtime'),
+        imported: z.literal(false),
+        concurrentNativeUse: z.literal('allowed'),
+    })
+        .strict(),
+    capabilitySnapshot: ExternalSessionCapabilitySnapshotSchema,
+    safeMetadata: ExternalSessionSafeMetadataSchema,
+    lastObservedAt: RuntimeTimestampSchema,
+    version: z.number().int().positive(),
+    createdAt: RuntimeTimestampSchema,
+    updatedAt: RuntimeTimestampSchema,
+})
+    .strict()
+    .superRefine((session, context) => {
+    if (Date.parse(session.capabilitySnapshot.observedAt) > Date.parse(session.lastObservedAt)) {
+        context.addIssue({
+            code: 'custom',
+            message: 'Capabilities cannot postdate session observation',
+        });
+    }
+    if (Date.parse(session.updatedAt) < Date.parse(session.createdAt) ||
+        Date.parse(session.lastObservedAt) < Date.parse(session.createdAt)) {
+        context.addIssue({ code: 'custom', message: 'Session timestamps cannot regress' });
+    }
+});
+const ExternalSessionRegistrationSchema = z
+    .object({
+    externalSessionId: IdentifierSchemas.externalSessionId,
+    runtimeConnectionId: IdentifierSchemas.runtimeConnectionId,
+    opaqueNativeSessionId: OpaqueNativeSessionIdSchema,
+    workspaceId: IdentifierSchemas.workspaceId,
+    projectId: IdentifierSchemas.projectId.optional(),
+    state: ExternalSessionStateSchema,
+    ownership: ExternalSessionSchema.shape.ownership,
+    capabilitySnapshot: ExternalSessionCapabilitySnapshotSchema,
+    safeMetadata: ExternalSessionSafeMetadataSchema,
+    lastObservedAt: RuntimeTimestampSchema,
+})
+    .strict();
+const ExternalSessionUpdateSchema = z
+    .object({
+    externalSessionId: IdentifierSchemas.externalSessionId,
+    expectedVersion: z.number().int().positive(),
+    observedAt: RuntimeTimestampSchema,
+    state: ExternalSessionStateSchema.optional(),
+    capabilitySnapshot: ExternalSessionCapabilitySnapshotSchema.optional(),
+    safeMetadata: ExternalSessionSafeMetadataSchema.optional(),
+})
+    .strict()
+    .refine((update) => update.state !== undefined ||
+    update.capabilitySnapshot !== undefined ||
+    update.safeMetadata !== undefined, 'Session update must change observed state');
+const ExternalSessionListScopeSchema = z
+    .object({
+    workspaceId: IdentifierSchemas.workspaceId,
+    projectId: IdentifierSchemas.projectId.optional(),
+    runtimeConnectionId: IdentifierSchemas.runtimeConnectionId.optional(),
+})
+    .strict();
+export class InMemoryExternalSessionRepository {
+    #sessions = new Map();
+    async insert(session) {
+        if (this.#sessions.has(session.externalSessionId) ||
+            [...this.#sessions.values()].some((candidate) => candidate.runtimeConnectionId === session.runtimeConnectionId &&
+                candidate.opaqueNativeSessionId === session.opaqueNativeSessionId)) {
+            return false;
+        }
+        this.#sessions.set(session.externalSessionId, clone(session));
+        return true;
+    }
+    async get(externalSessionId) {
+        return cloneOptional(this.#sessions.get(externalSessionId));
+    }
+    async findByNativeIdentity(runtimeConnectionId, opaqueNativeSessionId) {
+        return cloneOptional([...this.#sessions.values()].find((session) => session.runtimeConnectionId === runtimeConnectionId &&
+            session.opaqueNativeSessionId === opaqueNativeSessionId));
+    }
+    async list(scope) {
+        return [...this.#sessions.values()]
+            .filter((session) => session.workspaceId === scope.workspaceId &&
+            (scope.projectId === undefined || session.projectId === scope.projectId) &&
+            (scope.runtimeConnectionId === undefined ||
+                session.runtimeConnectionId === scope.runtimeConnectionId))
+            .sort((left, right) => left.externalSessionId.localeCompare(right.externalSessionId))
+            .map(clone);
+    }
+    async compareAndSet(expectedVersion, session) {
+        if (this.#sessions.get(session.externalSessionId)?.version !== expectedVersion)
+            return false;
+        this.#sessions.set(session.externalSessionId, clone(session));
+        return true;
+    }
+}
+export class ExternalSessionRegistryError extends Error {
+    code;
+    currentVersion;
+    constructor(code, currentVersion) {
+        super(code);
+        this.code = code;
+        this.currentVersion = currentVersion;
+        this.name = 'ExternalSessionRegistryError';
+    }
+}
+export class ExternalSessionRegistry {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    async register(inputValue) {
+        const input = normalizeRegistration(ExternalSessionRegistrationSchema.parse(inputValue));
+        const existing = await this.repository.findByNativeIdentity(input.runtimeConnectionId, input.opaqueNativeSessionId);
+        if (existing) {
+            if (sameRegistration(existing, input))
+                return existing;
+            fail('SESSION_IDENTITY_CONFLICT');
+        }
+        const session = ExternalSessionSchema.parse({
+            ...input,
+            version: 1,
+            createdAt: input.lastObservedAt,
+            updatedAt: input.lastObservedAt,
+        });
+        if (!(await this.repository.insert(session))) {
+            const raced = await this.repository.findByNativeIdentity(input.runtimeConnectionId, input.opaqueNativeSessionId);
+            if (raced && sameRegistration(raced, input))
+                return raced;
+            fail('SESSION_IDENTITY_CONFLICT');
+        }
+        return session;
+    }
+    async get(externalSessionIdValue) {
+        const externalSessionId = IdentifierSchemas.externalSessionId.parse(externalSessionIdValue);
+        const session = await this.repository.get(externalSessionId);
+        if (!session)
+            fail('SESSION_MISSING');
+        return ExternalSessionSchema.parse(session);
+    }
+    async list(scopeValue) {
+        const scope = ExternalSessionListScopeSchema.parse(scopeValue);
+        return Promise.all((await this.repository.list(scope)).map((session) => Promise.resolve(ExternalSessionSchema.parse(session))));
+    }
+    async update(inputValue) {
+        const input = ExternalSessionUpdateSchema.parse(inputValue);
+        const current = await this.get(input.externalSessionId);
+        if (current.version !== input.expectedVersion) {
+            fail('STALE_SESSION_VERSION', current.version);
+        }
+        if (current.state === 'revoked' && input.state !== 'revoked')
+            fail('SESSION_REVOKED');
+        if (Date.parse(input.observedAt) < Date.parse(current.lastObservedAt)) {
+            fail('TIMESTAMP_REGRESSION');
+        }
+        const capabilitySnapshot = input.capabilitySnapshot === undefined
+            ? undefined
+            : normalizeSnapshot(input.capabilitySnapshot);
+        if (capabilitySnapshot !== undefined) {
+            if (capabilitySnapshot.version < current.capabilitySnapshot.version ||
+                Date.parse(capabilitySnapshot.observedAt) <
+                    Date.parse(current.capabilitySnapshot.observedAt)) {
+                fail('CAPABILITY_SNAPSHOT_REGRESSION');
+            }
+            if (capabilitySnapshot.version === current.capabilitySnapshot.version &&
+                JSON.stringify(capabilitySnapshot) !== JSON.stringify(current.capabilitySnapshot)) {
+                fail('CAPABILITY_SNAPSHOT_CONFLICT');
+            }
+        }
+        const next = ExternalSessionSchema.parse({
+            ...current,
+            state: input.state ?? current.state,
+            capabilitySnapshot: capabilitySnapshot ?? current.capabilitySnapshot,
+            safeMetadata: input.safeMetadata === undefined
+                ? current.safeMetadata
+                : normalizeSafeMetadata(input.safeMetadata),
+            lastObservedAt: input.observedAt,
+            version: current.version + 1,
+            updatedAt: input.observedAt,
+        });
+        if (!(await this.repository.compareAndSet(input.expectedVersion, next))) {
+            const latest = await this.repository.get(input.externalSessionId);
+            fail('STALE_SESSION_VERSION', latest?.version);
+        }
+        return next;
+    }
+}
+export const ExternalSessionAssessmentStateSchema = z.enum([
+    'active',
+    'closed',
+    'stale',
+    'offline',
+    'runtime_missing',
+    'capability_changed',
+    'removed',
+    'revoked',
+]);
+export const ExternalSessionOperationUnavailableReasonSchema = z.enum([
+    'CAPABILITY_NOT_ADVERTISED',
+    'CAPABILITY_NO_LONGER_ADVERTISED',
+    'RUNTIME_MISSING',
+    'RUNTIME_OFFLINE',
+    'SESSION_CAPABILITIES_STALE',
+    'SESSION_CLOSED',
+    'SESSION_REMOVED',
+    'SESSION_REVOKED',
+]);
+const ExternalSessionOperationAvailabilitySchema = z.union([
+    z.object({ available: z.literal(true) }).strict(),
+    z
+        .object({
+        available: z.literal(false),
+        reason: ExternalSessionOperationUnavailableReasonSchema,
+    })
+        .strict(),
+]);
+export const ExternalSessionAssessmentSchema = z
+    .object({
+    state: ExternalSessionAssessmentStateSchema,
+    recoverable: z.boolean(),
+    evaluatedAt: RuntimeTimestampSchema.optional(),
+    operations: z
+        .object({
+        reference: ExternalSessionOperationAvailabilitySchema,
+        resume: ExternalSessionOperationAvailabilitySchema,
+        load: ExternalSessionOperationAvailabilitySchema,
+        close: ExternalSessionOperationAvailabilitySchema,
+        history: ExternalSessionOperationAvailabilitySchema,
+    })
+        .strict(),
+})
+    .strict();
+const ExternalSessionAssessmentContextSchema = z
+    .object({
+    connection: RuntimeConnectionSchema.optional(),
+    nodeStatus: RuntimeEligibilityNodeStatusSchema,
+    evaluatedAt: RuntimeTimestampSchema,
+})
+    .strict()
+    .refine((context) => context.connection === undefined ||
+    (context.connection.connectionType === 'managed_cloud') ===
+        (context.nodeStatus === 'not_applicable'), 'Managed-cloud sessions must not invent RuntimeNode health');
+export function assessExternalSession(sessionValue, contextValue) {
+    const session = ExternalSessionSchema.parse(sessionValue);
+    const context = ExternalSessionAssessmentContextSchema.parse(contextValue);
+    if (context.connection !== undefined &&
+        context.connection.runtimeConnectionId !== session.runtimeConnectionId) {
+        throw new Error('SESSION_RUNTIME_CONNECTION_MISMATCH');
+    }
+    const base = classifySessionState(session, context);
+    const operations = Object.fromEntries(['resume', 'load', 'close', 'history'].map((operation) => [
+        operation,
+        operationAvailability(session, context.connection, base.state, operation),
+    ]));
+    return ExternalSessionAssessmentSchema.parse({
+        ...base,
+        evaluatedAt: context.evaluatedAt,
+        operations: { reference: { available: true }, ...operations },
+    });
+}
+function classifySessionState(session, context) {
+    if (session.state === 'revoked')
+        return { state: 'revoked', recoverable: false };
+    if (session.state === 'removed')
+        return { state: 'removed', recoverable: true };
+    if (session.state === 'closed')
+        return { state: 'closed', recoverable: false };
+    const connection = context.connection;
+    if (!connection)
+        return { state: 'runtime_missing', recoverable: true };
+    if (connection.status === 'revoked' ||
+        connection.availabilityState === 'revoked' ||
+        context.nodeStatus === 'revoked') {
+        return { state: 'revoked', recoverable: false };
+    }
+    if (['offline', 'unknown'].includes(context.nodeStatus) ||
+        ['disconnected', 'expired', 'unavailable'].includes(connection.status) ||
+        ['offline', 'reconnecting', 'unknown', 'incompatible'].includes(connection.availabilityState ?? 'unknown')) {
+        return { state: 'offline', recoverable: true };
+    }
+    if (Date.parse(session.capabilitySnapshot.expiresAt) <= Date.parse(context.evaluatedAt) ||
+        connection.capabilitySnapshotExpiresAt === undefined ||
+        Date.parse(connection.capabilitySnapshotExpiresAt) <= Date.parse(context.evaluatedAt)) {
+        return { state: 'stale', recoverable: true };
+    }
+    const changed = session.capabilitySnapshot.operations.some((operation) => !runtimeAdvertises(connection, operation));
+    return changed
+        ? { state: 'capability_changed', recoverable: true }
+        : { state: 'active', recoverable: true };
+}
+function operationAvailability(session, connection, state, operation) {
+    if (state === 'revoked')
+        return unavailable('SESSION_REVOKED');
+    if (state === 'removed')
+        return unavailable('SESSION_REMOVED');
+    if (state === 'runtime_missing')
+        return unavailable('RUNTIME_MISSING');
+    if (state === 'offline')
+        return unavailable('RUNTIME_OFFLINE');
+    if (state === 'stale')
+        return unavailable('SESSION_CAPABILITIES_STALE');
+    if (state === 'closed' && operation !== 'history')
+        return unavailable('SESSION_CLOSED');
+    const capability = `session.${operation}`;
+    if (!session.capabilitySnapshot.operations.includes(capability)) {
+        return unavailable('CAPABILITY_NOT_ADVERTISED');
+    }
+    if (!connection || !runtimeAdvertises(connection, capability)) {
+        return unavailable('CAPABILITY_NO_LONGER_ADVERTISED');
+    }
+    return { available: true };
+}
+function runtimeAdvertises(connection, operation) {
+    return connection.capabilities.some((capability) => capability.name === operation && capability.support !== 'unsupported');
+}
+function unavailable(reason) {
+    return { available: false, reason };
+}
+function normalizeRegistration(input) {
+    return {
+        ...input,
+        capabilitySnapshot: normalizeSnapshot(input.capabilitySnapshot),
+        safeMetadata: normalizeSafeMetadata(input.safeMetadata),
+    };
+}
+function normalizeSnapshot(snapshot) {
+    return { ...snapshot, operations: [...snapshot.operations].sort() };
+}
+function normalizeSafeMetadata(metadata) {
+    return { ...metadata, limitations: [...metadata.limitations].sort() };
+}
+function sameRegistration(session, input) {
+    const registered = {
+        externalSessionId: session.externalSessionId,
+        runtimeConnectionId: session.runtimeConnectionId,
+        opaqueNativeSessionId: session.opaqueNativeSessionId,
+        workspaceId: session.workspaceId,
+        ...(session.projectId === undefined ? {} : { projectId: session.projectId }),
+        state: session.state,
+        ownership: session.ownership,
+        capabilitySnapshot: session.capabilitySnapshot,
+        safeMetadata: session.safeMetadata,
+        lastObservedAt: session.lastObservedAt,
+    };
+    return JSON.stringify(registered) === JSON.stringify(input);
+}
+function fail(code, currentVersion) {
+    throw new ExternalSessionRegistryError(code, currentVersion);
+}
+function clone(value) {
+    return structuredClone(value);
+}
+function cloneOptional(value) {
+    return value === undefined ? undefined : clone(value);
+}
+//# sourceMappingURL=sessions.js.map

package/dist/sessions.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,55 @@
+import type { RuntimeAdapter, RuntimeAdapterInspection, RuntimeApprovalRequest, RuntimeCancelRequest, RuntimeExecutionHandle, RuntimeExecutionProgress, RuntimeExecutionStatus, RuntimeInputRequest, RuntimeProgressOptions, RuntimeSessionOperation, RuntimeSessionResult, RuntimeStartRequest } from './adapter.js';
+export type RuntimeTransportKind = 'direct-local' | 'remote-gateway';
+/**
+ * Concrete runtime operations at the location where a harness executes.
+ * Drivers do not decide whether their caller is co-located or remote.
+ */
+export type RuntimeDriver = RuntimeAdapter;
+/**
+ * Selects how normalized RuntimeAdapter operations reach a RuntimeDriver.
+ * Transport choice is topology metadata and never changes semantic payloads.
+ */
+export interface RuntimeTransport extends RuntimeAdapter {
+    readonly kind: RuntimeTransportKind;
+}
+export interface RuntimeAdapterWithTransport extends RuntimeAdapter {
+    readonly transportKind: RuntimeTransportKind;
+}
+declare abstract class DelegatingRuntimeAdapter implements RuntimeAdapter {
+    protected readonly driver: RuntimeDriver;
+    constructor(driver: RuntimeDriver);
+    inspect(requirements?: Parameters<RuntimeAdapter['inspect']>[0]): Promise<RuntimeAdapterInspection>;
+    start(request: RuntimeStartRequest): Promise<RuntimeExecutionHandle>;
+    progress(handle: RuntimeExecutionHandle, options?: RuntimeProgressOptions): AsyncIterable<RuntimeExecutionProgress>;
+    submitInput(handle: RuntimeExecutionHandle, request: RuntimeInputRequest): Promise<RuntimeExecutionStatus>;
+    submitApproval(handle: RuntimeExecutionHandle, request: RuntimeApprovalRequest): Promise<RuntimeExecutionStatus>;
+    cancel(handle: RuntimeExecutionHandle, request: RuntimeCancelRequest): Promise<RuntimeExecutionStatus>;
+    status(handle: RuntimeExecutionHandle): Promise<RuntimeExecutionStatus>;
+    reconcile(handle: RuntimeExecutionHandle): Promise<RuntimeExecutionStatus>;
+    session(operation: RuntimeSessionOperation): Promise<RuntimeSessionResult>;
+    cleanup(handle: RuntimeExecutionHandle): Promise<void>;
+}
+declare abstract class DelegatingRuntimeTransport extends DelegatingRuntimeAdapter implements RuntimeTransport {
+    abstract readonly kind: RuntimeTransportKind;
+}
+/** Adapter-side facade that records topology while preserving the driver's semantic surface. */
+export declare class TransportedRuntimeAdapter extends DelegatingRuntimeAdapter implements RuntimeAdapterWithTransport {
+    protected readonly transport: RuntimeTransport;
+    readonly expectedAdapterName: string;
+    readonly transportKind: RuntimeTransportKind;
+    constructor(transport: RuntimeTransport, expectedAdapterName: string);
+    inspect(requirements?: Parameters<RuntimeAdapter['inspect']>[0]): Promise<RuntimeAdapterInspection>;
+}
+/** In-process/IPC-free transport for a co-located Local or Hosted runtime driver. */
+export declare class DirectLocalRuntimeTransport extends DelegatingRuntimeTransport {
+    readonly kind: "direct-local";
+}
+/**
+ * Semantic wrapper for a driver proxy backed by the authenticated Runtime Gateway.
+ * Wire delivery, reconnect, and command-ledger behavior remain in the proxy driver.
+ */
+export declare class RemoteRuntimeGatewayTransport extends DelegatingRuntimeTransport {
+    readonly kind: "remote-gateway";
+}
+export {};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,cAAc,CAAA;AAGrB,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,gBAAgB,CAAA;AAEpE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,CAAA;AAE1C;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;CACpC;AAED,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IACjE,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAA;CAC7C;AAED,uBAAe,wBAAyB,YAAW,cAAc;IACnD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa;gBAArB,MAAM,EAAE,aAAa;IAEpD,OAAO,CACL,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,wBAAwB,CAAC;IAIpC,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIpE,QAAQ,CACN,MAAM,EAAE,sBAAsB,EAC9B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,aAAa,CAAC,wBAAwB,CAAC;IAI1C,WAAW,CACT,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;IAIlC,cAAc,CACZ,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,sBAAsB,CAAC;IAIlC,MAAM,CACJ,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,sBAAsB,CAAC;IAIlC,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAIvE,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI1E,OAAO,CAAC,SAAS,EAAE,uBAAuB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI1E,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGvD;AAED,uBAAe,0BACb,SAAQ,wBACR,YAAW,gBAAgB;IAE3B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAA;CAC7C;AAED,gGAAgG;AAChG,qBAAa,yBACX,SAAQ,wBACR,YAAW,2BAA2B;IAKpC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB;IAC9C,QAAQ,CAAC,mBAAmB,EAAE,MAAM;IAJtC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAA;gBAGvB,SAAS,EAAE,gBAAgB,EACrC,mBAAmB,EAAE,MAAM;IAMvB,OAAO,CACpB,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,wBAAwB,CAAC;CAYrC;AAED,qFAAqF;AACrF,qBAAa,2BAA4B,SAAQ,0BAA0B;IACzE,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAS;CACxC;AAED;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,0BAA0B;IAC3E,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAS;CAC1C"}

package/dist/transport.js

@@ -0,0 +1,73 @@
+import { RuntimeAdapterInspectionSchema } from './adapter.js';
+class DelegatingRuntimeAdapter {
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    inspect(requirements) {
+        return this.driver.inspect(requirements);
+    }
+    start(request) {
+        return this.driver.start(request);
+    }
+    progress(handle, options) {
+        return this.driver.progress(handle, options);
+    }
+    submitInput(handle, request) {
+        return this.driver.submitInput(handle, request);
+    }
+    submitApproval(handle, request) {
+        return this.driver.submitApproval(handle, request);
+    }
+    cancel(handle, request) {
+        return this.driver.cancel(handle, request);
+    }
+    status(handle) {
+        return this.driver.status(handle);
+    }
+    reconcile(handle) {
+        return this.driver.reconcile(handle);
+    }
+    session(operation) {
+        return this.driver.session(operation);
+    }
+    cleanup(handle) {
+        return this.driver.cleanup(handle);
+    }
+}
+class DelegatingRuntimeTransport extends DelegatingRuntimeAdapter {
+}
+/** Adapter-side facade that records topology while preserving the driver's semantic surface. */
+export class TransportedRuntimeAdapter extends DelegatingRuntimeAdapter {
+    transport;
+    expectedAdapterName;
+    transportKind;
+    constructor(transport, expectedAdapterName) {
+        super(transport);
+        this.transport = transport;
+        this.expectedAdapterName = expectedAdapterName;
+        this.transportKind = transport.kind;
+    }
+    async inspect(requirements) {
+        const inspection = RuntimeAdapterInspectionSchema.parse(await this.transport.inspect(requirements));
+        if (inspection.metadata.adapterName !== this.expectedAdapterName) {
+            throw new Error('RUNTIME_TRANSPORT_DRIVER_FAMILY_MISMATCH');
+        }
+        return RuntimeAdapterInspectionSchema.parse({
+            ...inspection,
+            metadata: { ...inspection.metadata, transportKind: this.transportKind },
+        });
+    }
+}
+/** In-process/IPC-free transport for a co-located Local or Hosted runtime driver. */
+export class DirectLocalRuntimeTransport extends DelegatingRuntimeTransport {
+    kind = 'direct-local';
+}
+/**
+ * Semantic wrapper for a driver proxy backed by the authenticated Runtime Gateway.
+ * Wire delivery, reconnect, and command-ledger behavior remain in the proxy driver.
+ */
+export class RemoteRuntimeGatewayTransport extends DelegatingRuntimeTransport {
+    kind = 'remote-gateway';
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAA;AAsB7D,MAAe,wBAAwB;IACN;IAA/B,YAA+B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAExD,OAAO,CACL,YAAuD;QAEvD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK,CAAC,OAA4B;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACnC,CAAC;IAED,QAAQ,CACN,MAA8B,EAC9B,OAAgC;QAEhC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9C,CAAC;IAED,WAAW,CACT,MAA8B,EAC9B,OAA4B;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC;IAED,cAAc,CACZ,MAA8B,EAC9B,OAA+B;QAE/B,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpD,CAAC;IAED,MAAM,CACJ,MAA8B,EAC9B,OAA6B;QAE7B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED,MAAM,CAAC,MAA8B;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACnC,CAAC;IAED,SAAS,CAAC,MAA8B;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACtC,CAAC;IAED,OAAO,CAAC,SAAkC;QACxC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACvC,CAAC;IAED,OAAO,CAAC,MAA8B;QACpC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACpC,CAAC;CACF;AAED,MAAe,0BACb,SAAQ,wBAAwB;CAIjC;AAED,gGAAgG;AAChG,MAAM,OAAO,yBACX,SAAQ,wBAAwB;IAMX;IACV;IAJF,aAAa,CAAsB;IAE5C,YACqB,SAA2B,EACrC,mBAA2B;QAEpC,KAAK,CAAC,SAAS,CAAC,CAAA;QAHG,cAAS,GAAT,SAAS,CAAkB;QACrC,wBAAmB,GAAnB,mBAAmB,CAAQ;QAGpC,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC,IAAI,CAAA;IACrC,CAAC;IAEQ,KAAK,CAAC,OAAO,CACpB,YAAuD;QAEvD,MAAM,UAAU,GAAG,8BAA8B,CAAC,KAAK,CACrD,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,CAC3C,CAAA;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO,8BAA8B,CAAC,KAAK,CAAC;YAC1C,GAAG,UAAU;YACb,QAAQ,EAAE,EAAE,GAAG,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE;SACxE,CAAC,CAAA;IACJ,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,2BAA4B,SAAQ,0BAA0B;IAChE,IAAI,GAAG,cAAuB,CAAA;CACxC;AAED;;;GAGG;AACH,MAAM,OAAO,6BAA8B,SAAQ,0BAA0B;IAClE,IAAI,GAAG,gBAAyB,CAAA;CAC1C"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@adea-ai/runtime-sdk",
+  "version": "1.5.2",
+  "description": "SDK for building Control Plane runtimes: adapters, capabilities, conformance, discovery, eligibility, health, sessions, transport, and routing.",
+  "keywords": [
+    "adapter",
+    "agents",
+    "conformance",
+    "runtime",
+    "sdk"
+  ],
+  "homepage": "https://github.com/adea-ai/control-plane#readme",
+  "bugs": "https://github.com/adea-ai/control-plane/issues",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adea-ai/control-plane.git",
+    "directory": "packages/runtime-sdk"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "browser": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "node": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "compatibility:check": "bun scripts/compatibility.mjs --check",
+    "compatibility:generate": "bun scripts/compatibility.mjs",
+    "lint": "oxlint src",
+    "test": "bun test src"
+  },
+  "dependencies": {
+    "@adea-ai/contracts": "^1.5.2",
+    "zod": "4.5.4"
+  },
+  "engines": {
+    "node": ">=24 <25"
+  },
+  "devDependencies": {},
+  "peerDependencies": {}
+}