@pellux/goodvibes-sdk 0.18.14 → 0.18.15

package/dist/_internal/platform/runtime/health/wiring.js

@@ -0,0 +1,100 @@
+/**
+ * Health Error Propagation — HealthStoreWiring
+ *
+ * Wires together the RuntimeHealthAggregator, CascadeEngine, and RuntimeEventBus
+ * to form a complete error-propagation pipeline. When a domain health status
+ * changes, the wiring evaluates cascade rules and applies their effects.
+ *
+ * Lifecycle:
+ * 1. Call `start()` to subscribe to aggregator health changes.
+ * 2. Call `evaluateDomain()` to push a domain health update and trigger cascades.
+ * 3. Call `stop()` to unsubscribe and release all listeners.
+ *
+ * @module health/wiring
+ */
+import { handleCascadeEffect } from './effect-handlers.js';
+/**
+ * Wires the health aggregator, cascade engine, and event bus together.
+ *
+ * Orchestrates the full error-propagation pipeline:
+ * domain health change → cascade evaluation → effect application → event emission.
+ */
+export class HealthStoreWiring {
+    aggregator;
+    cascadeEngine;
+    eventBus;
+    unsubscribe = null;
+    /**
+     * @param aggregator - Tracks per-domain health; source of health change events.
+     * @param cascadeEngine - Evaluates declarative cascade rules against domain health.
+     * @param eventBus - Receives CASCADE_APPLIED and synthetic domain events.
+     */
+    constructor(aggregator, cascadeEngine, eventBus) {
+        this.aggregator = aggregator;
+        this.cascadeEngine = cascadeEngine;
+        this.eventBus = eventBus;
+    }
+    /**
+     * Start listening to aggregator health changes.
+     *
+     * When any domain health changes (detected via aggregator subscribers),
+     * the cascade engine is not automatically re-evaluated for subscriber-driven
+     * changes — callers should use `evaluateDomain()` for explicit cascade evaluation.
+     *
+     * Calling `start()` on an already-started wiring replaces the existing
+     * subscription without leaking the old one.
+     */
+    start() {
+        // Release any existing subscription before re-subscribing
+        this.unsubscribe?.();
+        // Subscribe to aggregator for observability (e.g. external monitoring).
+        // The primary cascade pipeline is driven by evaluateDomain() calls.
+        this.unsubscribe = this.aggregator.subscribe((health) => {
+            // Log health state transitions for observability.
+            // The primary cascade pipeline is driven by evaluateDomain() calls;
+            // this subscription provides a secondary audit trail for monitoring.
+            const failed = health.failedDomains;
+            const degraded = health.degradedDomains;
+            if (failed.length > 0 || degraded.length > 0) {
+                // Emit health state to stderr for observability — lightweight, no logger import needed
+                process.stderr.write(`[health] overall=${health.overall} failed=[${failed.join(',')}] degraded=[${degraded.join(',')}]\n`);
+            }
+        });
+    }
+    /**
+     * Stop listening to aggregator health changes and release all resources.
+     *
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    stop() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+    /**
+     * Update a domain's health status and evaluate cascade rules.
+     *
+     * Pipeline:
+     * 1. Update the domain health in the aggregator.
+     * 2. Evaluate cascade rules for the new domain + status.
+     * 3. Apply all actionable cascade effects via effect handlers.
+     *    Pending-recovery effects are NOT applied — they await recovery exhaustion.
+     *
+     * @param domain - The domain whose health has changed.
+     * @param status - The new health status for the domain.
+     * @param sourceContext - Optional context identifying the triggering entity
+     *   (e.g. `{ pluginId: 'my-plugin' }`). Propagated into CascadeResult.
+     */
+    evaluateDomain(domain, status, sourceContext) {
+        // 1. Update domain health in the aggregator
+        this.aggregator.updateDomainHealth(domain, status);
+        // 2. Evaluate cascade rules for this domain transition
+        const { cascades } = this.cascadeEngine.evaluate(domain, status, sourceContext);
+        // 3. Apply each actionable cascade effect
+        for (const cascade of cascades) {
+            handleCascadeEffect(cascade.effect, cascade, {
+                aggregator: this.aggregator,
+                eventBus: this.eventBus,
+            });
+        }
+    }
+}

package/dist/_internal/platform/runtime/index.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Runtime module barrel for reusable platform runtime surfaces.
+ *
+ * This intentionally excludes interactive-host shell wiring such as
+ * compositor/input/panel setup. It includes reusable runtime data,
+ * clients, transports, diagnostics, health, and host-bootstrap helpers.
+ */
+export { createRuntimeStore, createDomainDispatch } from './store/index.js';
+export type { RuntimeStore, DomainDispatch } from './store/index.js';
+export type { RuntimeState } from './store/state.js';
+export * from './store/selectors/index.js';
+export { RuntimeEventBus } from './events/index.js';
+export { createEventEnvelope } from './event-envelope.js';
+export type { EventEnvelope, EventEnvelopeContext } from './event-envelope.js';
+export type { RuntimeEventEnvelope, EnvelopeContext } from './events/envelope.js';
+export { RUNTIME_EVENT_DOMAINS, isRuntimeEventDomain } from './events/domain-map.js';
+export type { AnyRuntimeEvent, RuntimeEventDomain } from './events/domain-map.js';
+export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
+export type { RuntimeEventFeed, RuntimeEventFeeds } from './event-feeds.js';
+export type { EmitterContext } from './emitters/index.js';
+export { RuntimeHealthAggregator } from './health/aggregator.js';
+export { CascadeEngine } from './health/cascade-engine.js';
+export { CASCADE_RULES } from './health/cascade-rules.js';
+export { createHealthSystem } from './health/index.js';
+export type { HealthStatus, HealthDomain as RuntimeHealthDomain, DomainHealth, CompositeHealth, CascadeRule, CascadeEffect, CascadeResult, EvaluateResult, CascadeAppliedEvent, } from './health/types.js';
+export { NotificationRouter, createNotificationRouter } from './notifications/index.js';
+export type { Notification, NotificationLevel, NotificationTarget, DomainVerbosity, RoutingDecision } from './notifications/types.js';
+export { ModelPickerDataProvider, createModelPickerData } from './ui/model-picker/index.js';
+export type { ModelPickerDataProviderOptions } from './ui/model-picker/index.js';
+export { ProviderHealthDataProvider, buildFallbackChainData, createProviderHealthData } from './ui/provider-health/index.js';
+export { RetentionPolicy, SnapshotPruner, DEFAULT_RETENTION_CONFIG, } from './retention/index.js';
+export type { RetentionClass, RetentionClassConfig, RetentionConfig, CheckpointRecord, PruneOptions, PruneResult, PerClassPruneResult, Pruner, RetentionStats, } from './retention/index.js';
+export { shutdownRuntime, saveSession } from './lifecycle.js';
+export { createUiRuntimeServices } from './ui-services.js';
+export type { UiRuntimeServices } from './ui-services.js';
+export { createDirectTransportServices, createOperatorClientServices, createPeerClientDependencies, } from './foundation-services.js';
+export type { DirectTransportServicesOptions, DirectTransportServices, OperatorClientServicesOptions, OperatorClientServices, OperatorClientReadModels, } from './foundation-services.js';
+export { createRuntimeFoundationClients } from './foundation-clients.js';
+export type { RuntimeFoundationClients, RuntimeFoundationClientsOptions, } from './foundation-clients.js';
+export { createOperatorClient } from './operator-client.js';
+export type { OperatorClient } from './operator-client.js';
+export { createPeerClient } from './peer-client.js';
+export type { PeerClient } from './peer-client.js';
+export { createRuntimeProviderApi } from './runtime-provider-api.js';
+export { createRuntimeKnowledgeApi } from './runtime-knowledge-api.js';
+export { createRuntimeHookApi } from './runtime-hook-api.js';
+export { createRuntimeMcpApi } from './runtime-mcp-api.js';
+export { createRuntimeOpsApi } from './runtime-ops-api.js';
+export type { OpsApi } from './ops-api.js';
+export { scheduleBackgroundMcpDiscovery, scheduleMcpAutodiscovery, startBackgroundProviderDiscovery, startBackgroundProviderRegistration, } from './bootstrap-background.js';
+export type { BackgroundMcpDiscoveryOptions, BackgroundProviderDiscoveryOptions, HostSystemMessageSink, RuntimeSelectionState, } from './bootstrap-background.js';
+export { loadBootstrapSystemPrompt, loadRuntimeSystemPrompt, restoreRuntimeModel, restoreSavedModel, syncConfiguredServices, synchronizeConfiguredServices, } from './bootstrap-helpers.js';
+export type { RuntimeModelSelectionState } from './bootstrap-helpers.js';
+export { registerBootstrapRuntimeEvents, registerHostRuntimeEvents } from './bootstrap-runtime-events.js';
+export type { BootstrapRuntimeEventBridgeOptions, HostRuntimeEventBridgeOptions, HostRuntimeMessageRouter } from './bootstrap-runtime-events.js';
+export { startExternalServices, startHostServices } from './bootstrap-services.js';
+export type { ExternalServicesConfig, ExternalServicesHandle, HostServicesConfig, HostServicesHandle } from './bootstrap-services.js';
+export { createDiagnosticsProvider, DiagnosticsProvider } from './diagnostics/index.js';
+export type { DiagnosticsProviderConfig, DiagnosticPanelName } from './diagnostics/provider.js';
+export { createDirectTransport, createDirectTransportFromServices } from './transports/direct.js';
+export { createRuntimeDirectTransport } from './transports/direct.js';
+export type { DirectTransport } from './transports/direct.js';
+export { createDirectClientTransport } from './transports/direct-client.js';
+export type { DirectClientTransport } from './transports/direct-client.js';
+export { createClientTransport } from './transports/client-transport.js';
+export type { ClientTransport } from './transports/client-transport.js';
+export { buildUrl, createTransportPaths, normalizeBaseUrl } from './transports/transport-paths.js';
+export type { TransportPaths } from './transports/transport-paths.js';
+export { createFetch, createHttpJsonTransport, createJsonInit, createJsonRequestInit, readJsonBody, requestJson, } from './transports/http-json-transport.js';
+export type { HttpJsonRequestOptions, HttpJsonTransport, HttpJsonTransportOptions, JsonObject, JsonValue, ResolvedContractRequest, TransportJsonError, } from './transports/http-json-transport.js';
+export { buildContractInput, invokeContractRoute, openContractRouteStream, requireContractRoute, } from './transports/contract-http-client.js';
+export type { ContractInvokeOptions, ContractRouteDefinition, ContractRouteLike, ContractStreamOptions, } from './transports/contract-http-client.js';
+export { isAbortError, openServerSentEventStream } from './transports/sse-stream.js';
+export type { ServerSentEventHandlers, ServerSentEventOptions } from './transports/sse-stream.js';
+export { createOperatorRemoteClient } from './transports/operator-remote-client.js';
+export type { OperatorRemoteClient, OperatorRemoteClientInvokeOptions, OperatorRemoteClientStreamOptions, } from './transports/operator-remote-client.js';
+export { createPeerRemoteClient } from './transports/peer-remote-client.js';
+export type { PeerRemoteClient, PeerRemoteClientInvokeOptions, } from './transports/peer-remote-client.js';
+export { buildEventSourceUrl, buildWebSocketUrl, createEventSourceConnector, createRemoteDomainEvents, createRemoteRuntimeEvents, createRemoteUiRuntimeEvents, createWebSocketConnector, } from './transports/remote-events.js';
+export type { DomainEventConnector, RemoteDomainEvents, RemoteRuntimeEvents, SerializedRuntimeEnvelope, } from './transports/remote-events.js';
+export * from './network/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/_internal/platform/runtime/index.d.ts.map

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

package/dist/_internal/platform/runtime/index.js

@@ -0,0 +1,49 @@
+/**
+ * Runtime module barrel for reusable platform runtime surfaces.
+ *
+ * This intentionally excludes interactive-host shell wiring such as
+ * compositor/input/panel setup. It includes reusable runtime data,
+ * clients, transports, diagnostics, health, and host-bootstrap helpers.
+ */
+export { createRuntimeStore, createDomainDispatch } from './store/index.js';
+export * from './store/selectors/index.js';
+export { RuntimeEventBus } from './events/index.js';
+export { createEventEnvelope } from './event-envelope.js';
+export { RUNTIME_EVENT_DOMAINS, isRuntimeEventDomain } from './events/domain-map.js';
+export { createRuntimeEventFeed, createRuntimeEventFeeds } from './event-feeds.js';
+export { RuntimeHealthAggregator } from './health/aggregator.js';
+export { CascadeEngine } from './health/cascade-engine.js';
+export { CASCADE_RULES } from './health/cascade-rules.js';
+export { createHealthSystem } from './health/index.js';
+export { NotificationRouter, createNotificationRouter } from './notifications/index.js';
+export { ModelPickerDataProvider, createModelPickerData } from './ui/model-picker/index.js';
+export { ProviderHealthDataProvider, buildFallbackChainData, createProviderHealthData } from './ui/provider-health/index.js';
+export { RetentionPolicy, SnapshotPruner, DEFAULT_RETENTION_CONFIG, } from './retention/index.js';
+export { shutdownRuntime, saveSession } from './lifecycle.js';
+export { createUiRuntimeServices } from './ui-services.js';
+export { createDirectTransportServices, createOperatorClientServices, createPeerClientDependencies, } from './foundation-services.js';
+export { createRuntimeFoundationClients } from './foundation-clients.js';
+export { createOperatorClient } from './operator-client.js';
+export { createPeerClient } from './peer-client.js';
+export { createRuntimeProviderApi } from './runtime-provider-api.js';
+export { createRuntimeKnowledgeApi } from './runtime-knowledge-api.js';
+export { createRuntimeHookApi } from './runtime-hook-api.js';
+export { createRuntimeMcpApi } from './runtime-mcp-api.js';
+export { createRuntimeOpsApi } from './runtime-ops-api.js';
+export { scheduleBackgroundMcpDiscovery, scheduleMcpAutodiscovery, startBackgroundProviderDiscovery, startBackgroundProviderRegistration, } from './bootstrap-background.js';
+export { loadBootstrapSystemPrompt, loadRuntimeSystemPrompt, restoreRuntimeModel, restoreSavedModel, syncConfiguredServices, synchronizeConfiguredServices, } from './bootstrap-helpers.js';
+export { registerBootstrapRuntimeEvents, registerHostRuntimeEvents } from './bootstrap-runtime-events.js';
+export { startExternalServices, startHostServices } from './bootstrap-services.js';
+export { createDiagnosticsProvider, DiagnosticsProvider } from './diagnostics/index.js';
+export { createDirectTransport, createDirectTransportFromServices } from './transports/direct.js';
+export { createRuntimeDirectTransport } from './transports/direct.js';
+export { createDirectClientTransport } from './transports/direct-client.js';
+export { createClientTransport } from './transports/client-transport.js';
+export { buildUrl, createTransportPaths, normalizeBaseUrl } from './transports/transport-paths.js';
+export { createFetch, createHttpJsonTransport, createJsonInit, createJsonRequestInit, readJsonBody, requestJson, } from './transports/http-json-transport.js';
+export { buildContractInput, invokeContractRoute, openContractRouteStream, requireContractRoute, } from './transports/contract-http-client.js';
+export { isAbortError, openServerSentEventStream } from './transports/sse-stream.js';
+export { createOperatorRemoteClient } from './transports/operator-remote-client.js';
+export { createPeerRemoteClient } from './transports/peer-remote-client.js';
+export { buildEventSourceUrl, buildWebSocketUrl, createEventSourceConnector, createRemoteDomainEvents, createRemoteRuntimeEvents, createRemoteUiRuntimeEvents, createWebSocketConnector, } from './transports/remote-events.js';
+export * from './network/index.js';

package/dist/_internal/platform/runtime/integration/helpers.d.ts

@@ -0,0 +1,110 @@
+import type { PanelManager } from '../../panels/panel-manager.js';
+import type { ConfigManager } from '../../config/index.js';
+import type { ServiceRegistry } from '../../config/service-registry.js';
+import type { SubscriptionManager } from '@pellux/goodvibes-sdk/platform/config/subscriptions';
+import type { SecretsManager } from '../../config/secrets.js';
+import type { AutomationManager } from '../../automation/index.js';
+import type { ApprovalBroker, SharedSessionBroker } from '../../control-plane/index.js';
+import type { DistributedRuntimeManager } from '@pellux/goodvibes-sdk/platform/runtime/remote/distributed-runtime';
+import type { RemoteRunnerRegistry } from '../remote/runner-registry.js';
+import type { RemoteSupervisor } from '../remote/supervisor.js';
+import type { ProviderRegistry } from '../../providers/registry.js';
+import type { RuntimeStore } from '../store/index.js';
+import type { RuntimeEventBus, RuntimeEventDomain } from '../events/index.js';
+import type { UserAuthManager } from '@pellux/goodvibes-sdk/platform/security/user-auth';
+import { type RecoveryFileInfo } from '../session-persistence.js';
+import { type ManagedWorktreeMeta, type WorktreeOwnershipSummary } from '../worktree/registry.js';
+import type { ManagedRollbackRecord, SettingsConflictRecord, StagedManagedBundle } from '../settings/control-plane-store.js';
+export interface IntegrationHelpersContext {
+    readonly workingDirectory: string;
+    readonly homeDirectory: string;
+    readonly runtimeStore: RuntimeStore;
+    readonly runtimeBus: RuntimeEventBus;
+    readonly configManager?: ConfigManager;
+    readonly getConversationTitle?: () => string | undefined;
+    readonly automationManager: AutomationManager;
+    readonly approvalBroker: ApprovalBroker;
+    readonly sessionBroker: SharedSessionBroker;
+    readonly distributedRuntime: DistributedRuntimeManager;
+    readonly remoteRunnerRegistry: RemoteRunnerRegistry;
+    readonly remoteSupervisor: RemoteSupervisor;
+    readonly panelManager: PanelManager;
+    readonly localUserAuthManager: UserAuthManager;
+    readonly providerRegistry: ProviderRegistry;
+    readonly serviceRegistry: ServiceRegistry;
+    readonly subscriptionManager: SubscriptionManager;
+    readonly secretsManager: SecretsManager;
+}
+export interface PanelSnapshot {
+    readonly id: string;
+    readonly name: string;
+    readonly category: string;
+    readonly description: string;
+    readonly open: boolean;
+}
+export interface SettingsSnapshotUnavailable {
+    readonly available: false;
+    readonly reason: string;
+}
+export interface SettingsSnapshotAvailable {
+    readonly available: true;
+    readonly liveKeyCount: number;
+    readonly profileCount: number;
+    readonly managedLockCount: number;
+    readonly resolvedCounts: Readonly<Record<string, number>>;
+    readonly conflicts: readonly SettingsConflictRecord[];
+    readonly recentFailures: readonly {
+        readonly surface: string;
+        readonly message: string;
+        readonly timestamp: number;
+    }[];
+    readonly stagedManagedBundle?: StagedManagedBundle;
+    readonly rollbackHistory: readonly ManagedRollbackRecord[];
+}
+export type SettingsSnapshot = SettingsSnapshotUnavailable | SettingsSnapshotAvailable;
+export interface ContinuitySnapshot {
+    readonly sessionId: string;
+    readonly status: string;
+    readonly recoveryState: string;
+    readonly lastSessionPointer: string | null;
+    readonly recoveryFilePresent: boolean;
+    readonly recoveryFile: RecoveryFileInfo | null;
+}
+export interface WorktreeSnapshot {
+    readonly summary: WorktreeOwnershipSummary;
+    readonly records: readonly ManagedWorktreeMeta[];
+}
+export declare class IntegrationHelperService {
+    private readonly context;
+    constructor(context: IntegrationHelpersContext);
+    getRuntimeStore(): RuntimeStore;
+    getContext(): IntegrationHelpersContext;
+    buildReview(): {
+        readonly apiFamilies: readonly string[];
+        readonly routes: readonly string[];
+        readonly sessions: number;
+        readonly tasks: number;
+        readonly pendingApprovals: number;
+        readonly remoteContracts: number;
+        readonly panels: number;
+    };
+    getSessionSnapshot(): Record<string, unknown>;
+    getTaskSnapshot(): Record<string, unknown>;
+    getAutomationSnapshot(): Record<string, unknown>;
+    getRouteSnapshot(): Record<string, unknown>;
+    getApprovalSnapshot(): Record<string, unknown>;
+    getSessionBrokerSnapshot(): Record<string, unknown>;
+    getDeliverySnapshot(): Record<string, unknown>;
+    getRemoteSnapshot(): Record<string, unknown>;
+    getHealthSnapshot(): Record<string, unknown>;
+    getAccountsSnapshot(): Promise<Record<string, unknown>>;
+    getSettingsSnapshot(): SettingsSnapshot;
+    getLocalAuthSnapshot(): Record<string, unknown>;
+    getContinuitySnapshot(): ContinuitySnapshot;
+    getWorktreeSnapshot(): WorktreeSnapshot;
+    getIntelligenceSnapshot(): Record<string, unknown>;
+    listPanels(): PanelSnapshot[];
+    openPanel(id: string, pane?: 'top' | 'bottom'): boolean;
+    createEventStream(request: Request, domains: readonly RuntimeEventDomain[]): Response;
+}
+//# sourceMappingURL=helpers.d.ts.map

package/dist/_internal/platform/runtime/integration/helpers.d.ts.map

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