@pellux/goodvibes-tui 0.18.11 → 0.18.13

package/src/runtime/transports/direct.ts

@@ -1,73 +0,0 @@
-import type { SharedApprovalRecord, SharedSessionRecord } from '@pellux/goodvibes-sdk/platform/control-plane/index';
-import {
-  createDirectTransportServices,
-  type DirectTransportServices,
-} from '@pellux/goodvibes-sdk/platform/runtime/foundation-services';
-import { createOperatorClient, type OperatorClient, type OperatorControlPlaneSnapshot, type OperatorProvidersSnapshot } from '@pellux/goodvibes-sdk/platform/runtime/operator-client';
-import { createPeerClient, type PeerClient, type PeerClientSnapshot } from '@pellux/goodvibes-sdk/platform/runtime/peer-client';
-import type { RuntimeServices } from '../services.ts';
-import type { UiSessionSnapshot, UiTasksSnapshot } from '../ui-read-models.ts';
-import type { ShellPathService } from '@pellux/goodvibes-sdk/platform/runtime/shell-paths';
-import { createDirectClientTransport } from '@pellux/goodvibes-sdk/platform/runtime/transports/direct-client';
-import type { DirectClientTransport } from '@pellux/goodvibes-sdk/platform/runtime/transports/direct-client';
-export { createDirectClientTransport } from '@pellux/goodvibes-sdk/platform/runtime/transports/direct-client';
-export type { DirectClientTransport } from '@pellux/goodvibes-sdk/platform/runtime/transports/direct-client';
-
-export interface DirectTransportSnapshot {
-  readonly kind: 'direct';
-  readonly operator: {
-    readonly currentSession: UiSessionSnapshot;
-    readonly tasks: UiTasksSnapshot;
-    readonly approvals: readonly SharedApprovalRecord[];
-    readonly sessions: readonly SharedSessionRecord[];
-    readonly controlPlane: OperatorControlPlaneSnapshot;
-    readonly providers: OperatorProvidersSnapshot;
-    readonly shellPaths: ShellPathService;
-  };
-  readonly peer: PeerClientSnapshot;
-}
-
-export interface DirectTransport {
-  readonly kind: 'direct';
-  readonly operator: OperatorClient;
-  readonly peer: PeerClient;
-  getOperatorClient(): OperatorClient;
-  getPeerClient(): PeerClient;
-  snapshot(): Promise<DirectTransportSnapshot>;
-}
-
-export function createDirectTransportFromServices(services: DirectTransportServices): DirectTransport {
-  const operator = createOperatorClient(services.operator);
-  const peer = createPeerClient(services.peer);
-  const transport = createDirectClientTransport(operator, peer);
-
-  return Object.freeze({
-    ...transport,
-    async snapshot(): Promise<DirectTransportSnapshot> {
-      const [providers] = await Promise.all([
-        operator.providers.snapshot(),
-      ]);
-      return {
-        kind: 'direct',
-        operator: {
-          currentSession: operator.sessions.current(),
-          tasks: operator.tasks.snapshot(),
-          approvals: operator.approvals.list(),
-          sessions: operator.sessions.list(),
-          controlPlane: operator.controlPlane.snapshot(),
-          providers,
-          shellPaths: operator.shellPaths,
-        },
-        peer: peer.getSnapshot(),
-      };
-    },
-  });
-}
-
-export function createRuntimeDirectTransport(runtimeServices: RuntimeServices): DirectTransport {
-  return createDirectTransportFromServices(createDirectTransportServices(runtimeServices));
-}
-
-export function createDirectTransport(runtimeServices: RuntimeServices): DirectTransport {
-  return createRuntimeDirectTransport(runtimeServices);
-}

package/src/runtime/transports/http-helpers.ts

@@ -1,218 +0,0 @@
-import type {
-  ControlPlaneRecentEvent,
-  SharedApprovalRecord,
-  SharedSessionRecord,
-} from '@pellux/goodvibes-sdk/platform/control-plane/index';
-import type { ControlPlaneClientRecord } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/control-plane';
-import type { TelemetryFilter, TelemetryRecord } from '@pellux/goodvibes-sdk/platform/runtime/telemetry/api';
-import type { UiControlPlaneSnapshot } from '../ui-read-models.ts';
-import type { TransportPaths } from '@pellux/goodvibes-sdk/platform/runtime/transports/transport-paths';
-import { buildUrl } from '@pellux/goodvibes-sdk/platform/runtime/transports/transport-paths';
-import { createJsonInit, requestJson } from '@pellux/goodvibes-sdk/platform/runtime/transports/http-json-transport';
-import { openServerSentEventStream } from '@pellux/goodvibes-sdk/platform/runtime/transports/sse-stream';
-import type {
-  HttpSessionEnsureInput,
-  HttpSessionMessageInput,
-  HttpSteerSessionMessageInput,
-  HttpTaskSubmitInput,
-  HttpTransportTelemetryQuery,
-  HttpTransportTelemetryStreamHandlers,
-  HttpTransportTelemetryStreamReady,
-} from '@pellux/goodvibes-sdk/platform/runtime/transports/http-types';
-
-export function createJsonRequestInit(token: string | null | undefined, body?: unknown, method = 'GET'): RequestInit {
-  return createJsonInit(token, body, method);
-}
-
-export function maybeObject<T extends object>(value: unknown): T | null {
-  return typeof value === 'object' && value !== null ? value as T : null;
-}
-
-export function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null;
-}
-
-export function readArrayResponse<T>(body: unknown, key: string): readonly T[] {
-  if (Array.isArray(body)) return body as readonly T[];
-  if (isRecord(body)) {
-    const maybeEntries = body[key];
-    if (Array.isArray(maybeEntries)) return maybeEntries as readonly T[];
-  }
-  return [];
-}
-
-function readControlPlaneClients(body: unknown): readonly ControlPlaneClientRecord[] {
-  if (!isRecord(body)) return [];
-  return Array.isArray(body.clients) ? body.clients as readonly ControlPlaneClientRecord[] : [];
-}
-
-function readControlPlaneEvents(body: unknown): readonly ControlPlaneRecentEvent[] {
-  if (!isRecord(body)) return [];
-  return Array.isArray(body.recentEvents) ? body.recentEvents as readonly ControlPlaneRecentEvent[] : [];
-}
-
-function readNumber(value: unknown): number {
-  return typeof value === 'number' && Number.isFinite(value) ? value : 0;
-}
-
-function readString(value: unknown, fallback = ''): string {
-  return typeof value === 'string' ? value : fallback;
-}
-
-function readBoolean(value: unknown): boolean {
-  return value === true;
-}
-
-export async function readControlPlaneSnapshot(
-  fetchImpl: typeof fetch,
-  paths: TransportPaths,
-  token: string | null | undefined,
-): Promise<UiControlPlaneSnapshot> {
-  const approvalsUrl = new URL(paths.approvalsUrl);
-  approvalsUrl.searchParams.set('limit', '6');
-  const [gatewaySnapshot, approvals, sessions] = await Promise.all([
-    requestJson<Record<string, unknown>>(fetchImpl, paths.controlPlaneUrl, createJsonRequestInit(token)),
-    requestJson<readonly SharedApprovalRecord[] | { approvals?: SharedApprovalRecord[] }>(
-      fetchImpl,
-      approvalsUrl.toString(),
-      createJsonRequestInit(token),
-    ),
-    requestJson<readonly SharedSessionRecord[] | { sessions?: SharedSessionRecord[] } | { session?: SharedSessionRecord[] }>(
-      fetchImpl,
-      paths.sessionsUrl,
-      createJsonRequestInit(token),
-    ),
-  ]);
-  const server = maybeObject<Record<string, unknown>>(isRecord(gatewaySnapshot) ? gatewaySnapshot.server : null) ?? {};
-  const totals = maybeObject<Record<string, unknown>>(isRecord(gatewaySnapshot) ? gatewaySnapshot.totals : null) ?? {};
-  const clients = readControlPlaneClients(gatewaySnapshot);
-  const recentEvents = readControlPlaneEvents(gatewaySnapshot).slice(0, 6);
-  const sessionList = readArrayResponse<SharedSessionRecord>(sessions, 'sessions');
-  const approvalList = readArrayResponse<SharedApprovalRecord>(approvals, 'approvals');
-  return {
-    connectionState: readString(server.connectionState, 'unknown'),
-    activeClientIds: clients.filter((client) => readBoolean(client.connected)).map((client) => client.id),
-    requestCount: readNumber(totals.requests),
-    errorCount: readNumber(totals.errors),
-    host: readString(server.host, ''),
-    port: readNumber(server.port),
-    clients,
-    approvals: approvalList.slice(0, 6),
-    sessions: sessionList.length > 0
-      ? sessionList.slice(0, 6)
-      : readArrayResponse<SharedSessionRecord>(sessions, 'session').slice(0, 6),
-    recentEvents,
-  };
-}
-
-export function buildSessionEnsureBody(input: HttpSessionEnsureInput = {}): Record<string, unknown> {
-  return {
-    ...(input.sessionId ? { id: input.sessionId } : {}),
-    ...(input.title ? { title: input.title } : {}),
-    ...(input.metadata ? { metadata: input.metadata } : {}),
-    ...(input.routeId ? { routeId: input.routeId } : {}),
-    ...(input.participant
-      ? {
-          surfaceKind: input.participant.surfaceKind,
-          surfaceId: input.participant.surfaceId,
-          ...(input.participant.externalId ? { externalId: input.participant.externalId } : {}),
-          ...(input.participant.userId ? { userId: input.participant.userId } : {}),
-          ...(input.participant.displayName ? { displayName: input.participant.displayName } : {}),
-        }
-      : {}),
-  };
-}
-
-export function buildSessionMessageBody(input: HttpSessionMessageInput): Record<string, unknown> {
-  return {
-    body: input.body,
-    ...(input.surfaceKind ? { surfaceKind: input.surfaceKind } : {}),
-    ...(input.surfaceId ? { surfaceId: input.surfaceId } : {}),
-    ...(input.externalId ? { externalId: input.externalId } : {}),
-    ...(input.threadId ? { threadId: input.threadId } : {}),
-    ...(input.userId ? { userId: input.userId } : {}),
-    ...(input.displayName ? { displayName: input.displayName } : {}),
-    ...(input.title ? { title: input.title } : {}),
-    ...(input.routeId ? { routeId: input.routeId } : {}),
-    ...(input.metadata ? { metadata: input.metadata } : {}),
-    ...(input.routing ? { routing: input.routing } : {}),
-  };
-}
-
-export function buildSteerSessionMessageBody(input: HttpSteerSessionMessageInput): Record<string, unknown> {
-  return {
-    ...buildSessionMessageBody(input),
-    ...(input.allowSpawnFallback === true ? { allowSpawnFallback: true } : {}),
-  };
-}
-
-export function buildTaskSubmitBody(input: HttpTaskSubmitInput): Record<string, unknown> {
-  return {
-    task: input.task,
-    ...(input.model ? { model: input.model } : {}),
-    ...(input.tools ? { tools: [...input.tools] } : {}),
-    ...(input.routing ? { routing: input.routing } : {}),
-    ...(input.sessionId ? { sessionId: input.sessionId } : {}),
-    ...(input.routeId ? { routeId: input.routeId } : {}),
-    ...(input.surfaceKind ? { surfaceKind: input.surfaceKind } : {}),
-    ...(input.surfaceId ? { surfaceId: input.surfaceId } : {}),
-    ...(input.externalId ? { externalId: input.externalId } : {}),
-    ...(input.threadId ? { threadId: input.threadId } : {}),
-    ...(input.userId ? { userId: input.userId } : {}),
-    ...(input.displayName ? { displayName: input.displayName } : {}),
-    ...(input.title ? { title: input.title } : {}),
-    ...(input.metadata ? { metadata: input.metadata } : {}),
-  };
-}
-
-export function normalizeTelemetryQuery(query: HttpTransportTelemetryQuery | undefined, defaultLimit: number): TelemetryFilter {
-  if (typeof query === 'number') {
-    return { limit: Math.max(1, Math.floor(query)) };
-  }
-  return {
-    ...(query ?? {}),
-    ...(query?.limit !== undefined ? { limit: Math.max(1, Math.floor(query.limit)) } : { limit: defaultLimit }),
-  };
-}
-
-export function appendTelemetryQuery(url: URL, query: TelemetryFilter): void {
-  if (query.limit !== undefined) url.searchParams.set('limit', String(Math.max(1, Math.floor(query.limit))));
-  if (query.since !== undefined) url.searchParams.set('since', String(query.since));
-  if (query.until !== undefined) url.searchParams.set('until', String(query.until));
-  if (query.domains?.length) url.searchParams.set('domains', query.domains.join(','));
-  if (query.eventTypes?.length) url.searchParams.set('types', query.eventTypes.join(','));
-  if (query.severity) url.searchParams.set('severity', query.severity);
-  if (query.traceId) url.searchParams.set('traceId', query.traceId);
-  if (query.sessionId) url.searchParams.set('sessionId', query.sessionId);
-  if (query.turnId) url.searchParams.set('turnId', query.turnId);
-  if (query.agentId) url.searchParams.set('agentId', query.agentId);
-  if (query.taskId) url.searchParams.set('taskId', query.taskId);
-  if (query.cursor) url.searchParams.set('cursor', query.cursor);
-  if (query.view) url.searchParams.set('view', query.view);
-}
-
-export async function connectTelemetryStream(
-  fetchImpl: typeof fetch,
-  url: string,
-  token: string | null | undefined,
-  handlers: HttpTransportTelemetryStreamHandlers,
-): Promise<() => void> {
-  return await openServerSentEventStream(fetchImpl, url, {
-    onEvent: (eventName, payload) => {
-      if (eventName === 'telemetry' && payload && typeof payload === 'object') {
-        handlers.onRecord(payload as TelemetryRecord);
-      }
-    },
-    onReady: handlers.onReady
-      ? (payload) => {
-          handlers.onReady?.(payload as HttpTransportTelemetryStreamReady);
-        }
-      : undefined,
-  }, {
-    authToken: token,
-  });
-}
-
-export function buildTransportUrl(baseUrl: string, path: string): string {
-  return buildUrl(baseUrl, path);
-}

package/src/runtime/transports/http-types.ts

@@ -1,364 +0,0 @@
-import type {
-  ControlPlaneRecentEvent,
-  ControlPlaneAuthSnapshot,
-  SharedApprovalRecord,
-  SharedSessionInputRecord,
-  SharedSessionMessage,
-  SharedSessionRecord,
-  SharedSessionSubmission,
-} from '@pellux/goodvibes-sdk/platform/control-plane/index';
-import type { SteerSharedSessionMessageInput } from '@pellux/goodvibes-sdk/platform/control-plane/index';
-import type { ProviderRuntimeSnapshot, ProviderUsageSnapshot } from '@pellux/goodvibes-sdk/platform/providers/runtime-snapshot';
-import type {
-  TelemetryAggregates,
-  TelemetryCapabilities,
-  TelemetryFilter,
-  TelemetryListResponse,
-  TelemetryRecord,
-  TelemetryRuntimeSnapshot,
-  TelemetrySnapshot,
-  TelemetryViewMode,
-} from '@pellux/goodvibes-sdk/platform/runtime/telemetry/api';
-import type {
-  DistributedNodeHostContract,
-  DistributedPendingWork,
-  DistributedPeerKind,
-  DistributedPeerRecord,
-  DistributedPeerTokenRecord,
-  DistributedRuntimePairRequest,
-  DistributedWorkPriority,
-} from '@pellux/goodvibes-sdk/platform/runtime/remote/distributed-runtime-types';
-import type { UiControlPlaneSnapshot, UiLocalAuthSnapshot, UiSessionSnapshot, UiTasksSnapshot } from '../ui-read-models.ts';
-import type { UiRuntimeEvents } from '@pellux/goodvibes-sdk/platform/runtime/ui-events';
-import type { TransportPaths } from '@pellux/goodvibes-sdk/platform/runtime/transports/shared';
-
-export interface HttpTransportOptions {
-  readonly baseUrl: string;
-  readonly authToken?: string | null;
-  readonly fetchImpl?: typeof fetch;
-}
-
-export interface HttpProvidersSnapshot {
-  readonly providerIds: readonly string[];
-  readonly runtimeSnapshots: readonly ProviderRuntimeSnapshot[];
-  readonly accountSnapshot: Record<string, unknown>;
-  readonly localAuthSnapshot: UiLocalAuthSnapshot;
-}
-
-export interface HttpTransportOperatorSnapshot {
-  readonly currentSession: UiSessionSnapshot;
-  readonly tasks: UiTasksSnapshot;
-  readonly approvals: readonly SharedApprovalRecord[];
-  readonly sessions: readonly SharedSessionRecord[];
-  readonly controlPlane: UiControlPlaneSnapshot;
-  readonly providers: HttpProvidersSnapshot;
-  readonly shellPaths: TransportPaths;
-}
-
-export interface HttpPeerSnapshot {
-  readonly capturedAt: number;
-  readonly nodeHostContract: DistributedNodeHostContract;
-  readonly remoteSnapshot: Record<string, unknown>;
-  readonly pairRequests: readonly DistributedRuntimePairRequest[];
-  readonly peers: readonly DistributedPeerRecord[];
-  readonly work: readonly DistributedPendingWork[];
-}
-
-export interface HttpTransportSnapshot {
-  readonly kind: 'http';
-  readonly operator: HttpTransportOperatorSnapshot;
-  readonly peer: HttpPeerSnapshot;
-}
-
-export interface HttpTransportSessionsClient {
-  current(): Promise<UiSessionSnapshot>;
-  list(limit?: number): Promise<readonly SharedSessionRecord[]>;
-  get(sessionId: string): Promise<SharedSessionRecord | null>;
-  messages(sessionId: string, limit?: number): Promise<readonly SharedSessionMessage[]>;
-  inputs(sessionId: string, limit?: number): Promise<readonly SharedSessionInputRecord[]>;
-  ensureSession(input?: HttpSessionEnsureInput): Promise<SharedSessionRecord>;
-  close(sessionId: string): Promise<SharedSessionRecord | null>;
-  reopen(sessionId: string): Promise<SharedSessionRecord | null>;
-  submitMessage(sessionId: string, input: HttpSessionMessageInput): Promise<SharedSessionSubmission>;
-  steerMessage(sessionId: string, input: HttpSteerSessionMessageInput): Promise<SharedSessionSubmission>;
-  followUpMessage(sessionId: string, input: HttpSessionMessageInput): Promise<SharedSessionSubmission>;
-  cancelInput(sessionId: string, inputId: string): Promise<SharedSessionInputRecord | null>;
-}
-
-export interface HttpTransportTasksClient {
-  snapshot(): Promise<UiTasksSnapshot>;
-  list(limit?: number): Promise<readonly import('@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks').RuntimeTask[]>;
-  get(taskId: string): Promise<import('@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks').RuntimeTask | null>;
-  running(): Promise<readonly import('@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks').RuntimeTask[]>;
-  submit(input: HttpTaskSubmitInput): Promise<HttpTaskSubmitResponse>;
-  cancel(taskId: string): Promise<HttpTaskActionResponse>;
-  retry(taskId: string): Promise<HttpTaskRetryResponse>;
-}
-
-export interface HttpTransportApprovalsClient {
-  list(limit?: number): Promise<readonly SharedApprovalRecord[]>;
-  get(approvalId: string): Promise<SharedApprovalRecord | null>;
-  claim(approvalId: string, actor: string, actorSurface?: string, note?: string): Promise<SharedApprovalRecord | null>;
-  approve(approvalId: string, actor: string, actorSurface?: string, note?: string): Promise<SharedApprovalRecord | null>;
-  deny(approvalId: string, actor: string, actorSurface?: string, note?: string): Promise<SharedApprovalRecord | null>;
-  cancel(approvalId: string, actor: string, actorSurface?: string, note?: string): Promise<SharedApprovalRecord | null>;
-}
-
-export interface HttpTransportProvidersClient {
-  listIds(): Promise<readonly string[]>;
-  runtimeSnapshots(): Promise<readonly ProviderRuntimeSnapshot[]>;
-  runtimeSnapshot(providerId: string): Promise<ProviderRuntimeSnapshot | null>;
-  usageSnapshot(providerId: string): Promise<ProviderUsageSnapshot | null>;
-  accountSnapshot(): Promise<Record<string, unknown>>;
-  localAuthSnapshot(): Promise<UiLocalAuthSnapshot>;
-  snapshot(): Promise<HttpProvidersSnapshot>;
-}
-
-export interface HttpTransportControlPlaneClient {
-  snapshot(): Promise<UiControlPlaneSnapshot>;
-  recentEvents(limit?: number): Promise<readonly ControlPlaneRecentEvent[]>;
-  currentAuth(): Promise<HttpTransportControlPlaneAuthSnapshot>;
-}
-
-export interface HttpTransportControlPlaneAuthSnapshot extends ControlPlaneAuthSnapshot {}
-
-export interface HttpTransportTelemetryMetricsSnapshot {
-  readonly version: 1;
-  readonly view: TelemetryViewMode;
-  readonly rawAccessible: boolean;
-  readonly generatedAt: number;
-  readonly runtime: TelemetryRuntimeSnapshot;
-  readonly sessionMetrics: TelemetrySnapshot['sessionMetrics'];
-  readonly aggregates: TelemetryAggregates;
-}
-
-export type HttpTransportTelemetryQuery = TelemetryFilter | number;
-
-export interface HttpTransportTelemetryStreamReady {
-  readonly version: 1;
-  readonly capabilities: TelemetryCapabilities;
-  readonly view: TelemetryViewMode;
-  readonly rawAccessible: boolean;
-  readonly resumedFrom?: string;
-}
-
-export interface HttpTransportTelemetryStreamHandlers {
-  readonly onRecord: (record: TelemetryRecord) => void;
-  readonly onReady?: (payload: HttpTransportTelemetryStreamReady) => void;
-}
-
-export interface HttpTransportTelemetryClient {
-  snapshot(query?: HttpTransportTelemetryQuery): Promise<TelemetrySnapshot>;
-  events(query?: HttpTransportTelemetryQuery): Promise<TelemetryListResponse<TelemetryRecord>>;
-  errors(query?: HttpTransportTelemetryQuery): Promise<TelemetryListResponse<TelemetryRecord>>;
-  traces(query?: HttpTransportTelemetryQuery): Promise<TelemetryListResponse<import('@pellux/goodvibes-sdk/platform/runtime/telemetry/types').ReadableSpan>>;
-  metrics(query?: HttpTransportTelemetryQuery): Promise<HttpTransportTelemetryMetricsSnapshot>;
-  otlpTraces(query?: HttpTransportTelemetryQuery): Promise<Record<string, unknown>>;
-  otlpLogs(query?: HttpTransportTelemetryQuery): Promise<Record<string, unknown>>;
-  otlpMetrics(query?: HttpTransportTelemetryQuery): Promise<Record<string, unknown>>;
-  stream(handlers: HttpTransportTelemetryStreamHandlers, query?: HttpTransportTelemetryQuery): Promise<() => void>;
-}
-
-export interface HttpTransportOperatorClient {
-  readonly sessions: HttpTransportSessionsClient;
-  readonly tasks: HttpTransportTasksClient;
-  readonly approvals: HttpTransportApprovalsClient;
-  readonly providers: HttpTransportProvidersClient;
-  readonly controlPlane: HttpTransportControlPlaneClient;
-  readonly telemetry: HttpTransportTelemetryClient;
-  readonly events: UiRuntimeEvents;
-  readonly shellPaths: TransportPaths;
-}
-
-export interface HttpTransportPeerPairingClient {
-  listRequests(limit?: number): Promise<readonly DistributedRuntimePairRequest[]>;
-  request(input: HttpRemotePairRequestInput): Promise<HttpRemotePairResponse>;
-  approve(requestId: string, actor: string, note?: string): Promise<HttpRemotePairApprovalResponse | null>;
-  reject(requestId: string, actor: string, note?: string): Promise<DistributedRuntimePairRequest | null>;
-  verify(requestId: string, challenge: string, remoteAddress?: string): Promise<HttpRemotePairVerificationResponse | null>;
-}
-
-export interface HttpTransportPeerPeersClient {
-  list(kind?: DistributedPeerKind, limit?: number): Promise<readonly DistributedPeerRecord[]>;
-  get(peerId: string): Promise<DistributedPeerRecord | null>;
-  getSnapshot(peerId: string): Promise<HttpPeerRecordSnapshot | null>;
-  heartbeat(tokenValue: string, input?: HttpRemotePeerHeartbeatInput): Promise<{ peer: DistributedPeerRecord }>;
-  rotateToken(peerId: string, actor: string, label?: string, scopes?: readonly string[]): Promise<HttpRemotePeerTokenResponse | null>;
-  revokeToken(peerId: string, actor: string, tokenId?: string, note?: string): Promise<DistributedPeerRecord | null>;
-  disconnect(peerId: string, actor: string, note?: string, requeueClaimedWork?: boolean): Promise<DistributedPeerRecord | null>;
-}
-
-export interface HttpTransportPeerWorkClient {
-  list(limit?: number, peerId?: string): Promise<readonly DistributedPendingWork[]>;
-  invoke(input: HttpRemotePeerInvokeInput): Promise<HttpRemotePeerInvokeResponse>;
-  claim(tokenValue: string, input?: HttpRemotePeerClaimInput): Promise<readonly DistributedPendingWork[]>;
-  complete(tokenValue: string, workId: string, input?: HttpRemotePeerCompleteInput): Promise<DistributedPendingWork | null>;
-  cancel(workId: string, actor: string, note?: string): Promise<DistributedPendingWork | null>;
-}
-
-export interface HttpTransportPeerClient {
-  readonly pairing: HttpTransportPeerPairingClient;
-  readonly peers: HttpTransportPeerPeersClient;
-  readonly work: HttpTransportPeerWorkClient;
-  getSnapshot(): Promise<HttpPeerSnapshot>;
-  getNodeHostContract(): Promise<DistributedNodeHostContract>;
-}
-
-export interface HttpTransport {
-  readonly kind: 'http';
-  readonly operator: HttpTransportOperatorClient;
-  readonly peer: HttpTransportPeerClient;
-  getOperatorClient(): HttpTransportOperatorClient;
-  getPeerClient(): HttpTransportPeerClient;
-  snapshot(): Promise<HttpTransportSnapshot>;
-}
-
-export interface HttpSessionEnsureInput {
-  readonly sessionId?: string;
-  readonly title?: string;
-  readonly metadata?: Record<string, unknown>;
-  readonly routeId?: string;
-  readonly participant?: {
-    readonly surfaceKind: string;
-    readonly surfaceId: string;
-    readonly externalId?: string;
-    readonly userId?: string;
-    readonly displayName?: string;
-  };
-}
-
-export interface HttpSessionMessageInput {
-  readonly body: string;
-  readonly surfaceKind?: string;
-  readonly surfaceId?: string;
-  readonly externalId?: string;
-  readonly threadId?: string;
-  readonly userId?: string;
-  readonly displayName?: string;
-  readonly title?: string;
-  readonly routeId?: string;
-  readonly metadata?: Record<string, unknown>;
-  readonly routing?: SteerSharedSessionMessageInput['routing'];
-}
-
-export interface HttpSteerSessionMessageInput extends HttpSessionMessageInput {
-  readonly allowSpawnFallback?: boolean;
-}
-
-export interface HttpTaskSubmitInput {
-  readonly task: string;
-  readonly model?: string;
-  readonly tools?: readonly string[];
-  readonly routing?: HttpSessionMessageInput['routing'];
-  readonly sessionId?: string;
-  readonly routeId?: string;
-  readonly surfaceKind?: string;
-  readonly surfaceId?: string;
-  readonly externalId?: string;
-  readonly threadId?: string;
-  readonly userId?: string;
-  readonly displayName?: string;
-  readonly title?: string;
-  readonly metadata?: Record<string, unknown>;
-}
-
-export interface HttpTaskSubmitResponse {
-  readonly acknowledged: boolean;
-  readonly mode?: string;
-  readonly sessionId?: string | null;
-  readonly agentId?: string | null;
-  readonly status?: string;
-  readonly task?: string;
-}
-
-export interface HttpTaskActionResponse {
-  readonly task: import('@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks').RuntimeTask | null;
-}
-
-export interface HttpTaskRetryResponse {
-  readonly retried?: boolean;
-  readonly task: import('@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks').RuntimeTask | null;
-  readonly agentId?: string;
-}
-
-export interface HttpRemotePairRequestInput {
-  readonly peerKind: DistributedPeerKind;
-  readonly label: string;
-  readonly requestedId?: string;
-  readonly platform?: string;
-  readonly deviceFamily?: string;
-  readonly version?: string;
-  readonly clientMode?: string;
-  readonly capabilities?: readonly string[];
-  readonly commands?: readonly string[];
-  readonly ttlMs?: number;
-  readonly metadata?: Record<string, unknown>;
-}
-
-export interface HttpRemotePairResponse {
-  readonly request: DistributedRuntimePairRequest;
-  readonly challenge: string;
-}
-
-export interface HttpRemotePairApprovalResponse {
-  readonly request: DistributedRuntimePairRequest;
-  readonly peer: DistributedPeerRecord;
-}
-
-export interface HttpRemotePairVerificationResponse {
-  readonly peer: DistributedPeerRecord;
-  readonly token: DistributedPeerTokenRecord & { readonly value: string };
-}
-
-export interface HttpRemotePeerHeartbeatInput {
-  readonly capabilities?: readonly string[];
-  readonly commands?: readonly string[];
-  readonly version?: string;
-  readonly clientMode?: string;
-  readonly metadata?: Record<string, unknown>;
-}
-
-export interface HttpRemotePeerTokenResponse {
-  readonly peer: DistributedPeerRecord;
-  readonly token: DistributedPeerTokenRecord & { readonly value: string };
-}
-
-export interface HttpRemotePeerInvokeInput {
-  readonly peerId: string;
-  readonly command: string;
-  readonly payload?: unknown;
-  readonly priority?: DistributedWorkPriority;
-  readonly waitMs?: number;
-  readonly timeoutMs?: number;
-  readonly sessionId?: string;
-  readonly routeId?: string;
-  readonly automationRunId?: string;
-  readonly automationJobId?: string;
-  readonly approvalId?: string;
-  readonly metadata?: Record<string, unknown>;
-}
-
-export interface HttpRemotePeerInvokeResponse {
-  readonly work: DistributedPendingWork;
-  readonly completed: boolean;
-}
-
-export interface HttpRemotePeerClaimInput {
-  readonly maxItems?: number;
-  readonly leaseMs?: number;
-}
-
-export interface HttpRemotePeerCompleteInput {
-  readonly status?: 'completed' | 'failed' | 'cancelled';
-  readonly result?: unknown;
-  readonly error?: string;
-  readonly metadata?: Record<string, unknown>;
-}
-
-export interface HttpPeerRecordSnapshot {
-  readonly peerId: string;
-  readonly peer: DistributedPeerRecord | null;
-  readonly pairRequests: readonly DistributedRuntimePairRequest[];
-  readonly work: readonly DistributedPendingWork[];
-  readonly nodeHostContract: DistributedNodeHostContract;
-}