@pellux/goodvibes-sdk 0.18.14 → 0.18.16

package/dist/_internal/platform/runtime/peer-client.d.ts

@@ -0,0 +1,108 @@
+import type { AcpConnection } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/acp';
+import type { RuntimeStore } from './store/index.js';
+import type { DistributedRuntimeManager } from '@pellux/goodvibes-sdk/platform/runtime/remote/distributed-runtime-manager';
+import type { DistributedNodeHostContract, DistributedPeerAuth, DistributedPeerKind, DistributedPeerRecord, DistributedPendingWork, DistributedRuntimePairRequest } from './remote/index.js';
+import type { RemoteExecutionArtifact, RemoteRunnerContract, RemoteRunnerPool } from '@pellux/goodvibes-sdk/platform/runtime/remote/types';
+import type { RemoteRunnerRegistry } from './remote/runner-registry.js';
+import type { RemoteSupervisor, RemoteSupervisorSnapshot } from './remote/supervisor.js';
+import type { RemoteSessionStateSnapshot } from '@pellux/goodvibes-sdk/platform/runtime/remote/session-state';
+export interface PeerClientDependencies {
+    readonly runtimeStore: RuntimeStore;
+    readonly distributedRuntime: DistributedRuntimeManager;
+    readonly remoteRunnerRegistry: RemoteRunnerRegistry;
+    readonly remoteSupervisor: RemoteSupervisor;
+}
+export interface PeerClientPairingSnapshot {
+    readonly requests: readonly DistributedRuntimePairRequest[];
+    readonly total: number;
+    readonly pending: number;
+    readonly approved: number;
+    readonly verified: number;
+    readonly rejected: number;
+    readonly expired: number;
+}
+export interface PeerClientPeerSnapshot {
+    readonly peerId: string;
+    readonly peer: DistributedPeerRecord | null;
+    readonly session: RemoteSessionStateSnapshot | null;
+    readonly runnerContract: RemoteRunnerContract | null;
+    readonly pairRequests: readonly DistributedRuntimePairRequest[];
+    readonly pendingWork: readonly DistributedPendingWork[];
+    readonly artifacts: readonly RemoteExecutionArtifact[];
+}
+export interface PeerClientRunnersSnapshot {
+    readonly pools: readonly RemoteRunnerPool[];
+    readonly contracts: readonly RemoteRunnerContract[];
+    readonly artifacts: readonly RemoteExecutionArtifact[];
+}
+export interface PeerClientAcpSnapshot {
+    readonly transportState: string;
+    readonly totalMessages: number;
+    readonly activeConnections: readonly AcpConnection[];
+}
+export interface PeerClientSnapshot {
+    readonly capturedAt: number;
+    readonly nodeHostContract: DistributedNodeHostContract;
+    readonly acp: PeerClientAcpSnapshot;
+    readonly pairing: PeerClientPairingSnapshot;
+    readonly peers: readonly DistributedPeerRecord[];
+    readonly peerSnapshots: readonly PeerClientPeerSnapshot[];
+    readonly work: readonly DistributedPendingWork[];
+    readonly runners: PeerClientRunnersSnapshot;
+    readonly supervisor: RemoteSupervisorSnapshot;
+}
+export interface PeerClientPairingDomain {
+    listRequests(limit?: number): DistributedRuntimePairRequest[];
+    request(input: Parameters<DistributedRuntimeManager['requestPairing']>[0]): ReturnType<DistributedRuntimeManager['requestPairing']>;
+    approve(requestId: string, input?: Parameters<DistributedRuntimeManager['approvePairRequest']>[1]): ReturnType<DistributedRuntimeManager['approvePairRequest']>;
+    reject(requestId: string, input?: Parameters<DistributedRuntimeManager['rejectPairRequest']>[1]): ReturnType<DistributedRuntimeManager['rejectPairRequest']>;
+    verify(requestId: string, challenge: string, input?: Parameters<DistributedRuntimeManager['verifyPairRequest']>[2]): ReturnType<DistributedRuntimeManager['verifyPairRequest']>;
+}
+export interface PeerClientPeersDomain {
+    list(kind?: DistributedPeerKind, limit?: number): DistributedPeerRecord[];
+    get(peerId: string): DistributedPeerRecord | null;
+    getSnapshot(peerId: string): PeerClientPeerSnapshot | null;
+    authenticateToken(tokenValue: string, remoteAddress?: string): ReturnType<DistributedRuntimeManager['authenticatePeerToken']>;
+    heartbeat(auth: DistributedPeerAuth, input?: Parameters<DistributedRuntimeManager['heartbeatPeer']>[1]): ReturnType<DistributedRuntimeManager['heartbeatPeer']>;
+    rotateToken(peerId: string, input?: Parameters<DistributedRuntimeManager['rotatePeerToken']>[1]): ReturnType<DistributedRuntimeManager['rotatePeerToken']>;
+    revokeToken(peerId: string, input?: Parameters<DistributedRuntimeManager['revokePeerToken']>[1]): ReturnType<DistributedRuntimeManager['revokePeerToken']>;
+    disconnect(peerId: string, input?: Parameters<DistributedRuntimeManager['disconnectPeer']>[1]): ReturnType<DistributedRuntimeManager['disconnectPeer']>;
+}
+export interface PeerClientWorkDomain {
+    list(limit?: number, peerId?: string): DistributedPendingWork[];
+    enqueue(input: Parameters<DistributedRuntimeManager['enqueueWork']>[0]): ReturnType<DistributedRuntimeManager['enqueueWork']>;
+    invoke(input: Parameters<DistributedRuntimeManager['invokePeer']>[0]): ReturnType<DistributedRuntimeManager['invokePeer']>;
+    claim(auth: DistributedPeerAuth, input?: Parameters<DistributedRuntimeManager['claimWork']>[1]): ReturnType<DistributedRuntimeManager['claimWork']>;
+    complete(auth: DistributedPeerAuth, workId: string, input?: Parameters<DistributedRuntimeManager['completeWork']>[2]): ReturnType<DistributedRuntimeManager['completeWork']>;
+    cancel(workId: string, input?: Parameters<DistributedRuntimeManager['cancelWork']>[1]): ReturnType<DistributedRuntimeManager['cancelWork']>;
+}
+export interface PeerClientRunnersDomain {
+    listPools(): RemoteRunnerPool[];
+    getPool(poolId: string): RemoteRunnerPool | null;
+    createPool(input: Parameters<RemoteRunnerRegistry['createPool']>[0]): RemoteRunnerPool;
+    assignRunnerToPool(poolId: string, runnerId: string): RemoteRunnerPool | null;
+    removeRunnerFromPool(poolId: string, runnerId: string): RemoteRunnerPool | null;
+    listContracts(): RemoteRunnerContract[];
+    getContract(runnerId: string): RemoteRunnerContract | null;
+    registerContract(contract: RemoteRunnerContract): RemoteRunnerContract;
+    upsertContractForAgent(agentId: string): RemoteRunnerContract | null;
+    listArtifacts(): RemoteExecutionArtifact[];
+    getArtifact(artifactId: string): RemoteExecutionArtifact | null;
+    captureArtifactForAgent(agentId: string): RemoteExecutionArtifact | null;
+    captureArtifactForRunner(runnerId: string): RemoteExecutionArtifact | null;
+    exportArtifact(artifactId: string, path?: string): ReturnType<RemoteRunnerRegistry['exportArtifact']>;
+    importArtifact(path: string): ReturnType<RemoteRunnerRegistry['importArtifact']>;
+    buildReviewSummary(artifactId: string): string | null;
+    exportSessionBundle(path?: string): ReturnType<RemoteRunnerRegistry['exportSessionBundle']>;
+    importSessionBundle(path: string): ReturnType<RemoteRunnerRegistry['importSessionBundle']>;
+}
+export interface PeerClient {
+    readonly pairing: PeerClientPairingDomain;
+    readonly peers: PeerClientPeersDomain;
+    readonly work: PeerClientWorkDomain;
+    readonly runners: PeerClientRunnersDomain;
+    getSnapshot(): PeerClientSnapshot;
+    getNodeHostContract(): DistributedNodeHostContract;
+}
+export declare function createPeerClient(deps: PeerClientDependencies): PeerClient;
+//# sourceMappingURL=peer-client.d.ts.map

package/dist/_internal/platform/runtime/peer-client.d.ts.map

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

package/dist/_internal/platform/runtime/peer-client.js

@@ -0,0 +1,232 @@
+function countRequests(requests) {
+    return {
+        requests,
+        total: requests.length,
+        pending: requests.filter((request) => request.status === 'pending').length,
+        approved: requests.filter((request) => request.status === 'approved').length,
+        verified: requests.filter((request) => request.status === 'verified').length,
+        rejected: requests.filter((request) => request.status === 'rejected').length,
+        expired: requests.filter((request) => request.status === 'expired').length,
+    };
+}
+function collectPeerIds(peers, contracts, sessions, requests, work) {
+    const ids = new Set();
+    for (const peer of peers)
+        ids.add(peer.id);
+    for (const contract of contracts)
+        ids.add(contract.runnerId);
+    for (const session of sessions)
+        ids.add(session.runnerId);
+    for (const request of requests) {
+        if (request.peerId)
+            ids.add(request.peerId);
+        if (request.requestedId)
+            ids.add(request.requestedId);
+    }
+    for (const item of work)
+        ids.add(item.peerId);
+    return [...ids].sort();
+}
+function buildAcpSnapshot(store) {
+    const state = store.getState().acp;
+    return {
+        transportState: state.managerTransportState,
+        totalMessages: state.totalMessages,
+        activeConnections: state.activeConnectionIds
+            .map((id) => state.connections.get(id))
+            .filter((connection) => connection !== undefined),
+    };
+}
+function buildPeerSnapshot(deps, peerId) {
+    deps.remoteRunnerRegistry.ensureContractsFromStore(deps.runtimeStore);
+    const peers = deps.distributedRuntime.listPeers(undefined, 500);
+    const peer = peers.find((entry) => entry.id === peerId) ?? null;
+    const runnerContract = deps.remoteRunnerRegistry.getContract(peerId);
+    const pairRequests = deps.distributedRuntime
+        .listPairRequests(250)
+        .filter((request) => request.peerId === peerId || request.requestedId === peerId);
+    const pendingWork = deps.distributedRuntime.listWork(250, peerId);
+    const artifacts = deps.remoteRunnerRegistry.listArtifacts().filter((artifact) => artifact.runnerId === peerId);
+    const sessions = deps.remoteSupervisor.getSnapshot(deps.runtimeStore).sessions;
+    const session = sessions.find((entry) => entry.runnerId === peerId) ?? null;
+    if (!peer && !runnerContract && !session && pairRequests.length === 0 && pendingWork.length === 0 && artifacts.length === 0) {
+        return null;
+    }
+    return {
+        peerId,
+        peer,
+        session,
+        runnerContract: runnerContract ?? null,
+        pairRequests,
+        pendingWork,
+        artifacts,
+    };
+}
+function buildPeerSnapshots(deps) {
+    deps.remoteRunnerRegistry.ensureContractsFromStore(deps.runtimeStore);
+    const pairingRequests = deps.distributedRuntime.listPairRequests(250);
+    const peers = deps.distributedRuntime.listPeers(undefined, 500);
+    const work = deps.distributedRuntime.listWork(500);
+    const contracts = deps.remoteRunnerRegistry.listContracts();
+    const sessions = deps.remoteSupervisor.getSnapshot(deps.runtimeStore).sessions;
+    const peerIds = collectPeerIds(peers, contracts, sessions, pairingRequests, work);
+    const snapshots = peerIds
+        .map((peerId) => buildPeerSnapshot(deps, peerId))
+        .filter((snapshot) => snapshot !== null);
+    return Object.freeze(snapshots);
+}
+function buildSnapshot(deps) {
+    deps.remoteRunnerRegistry.ensureContractsFromStore(deps.runtimeStore);
+    const pairingRequests = deps.distributedRuntime.listPairRequests(250);
+    const peers = deps.distributedRuntime.listPeers(undefined, 500);
+    const work = deps.distributedRuntime.listWork(500);
+    const pools = deps.remoteRunnerRegistry.listPools();
+    const contracts = deps.remoteRunnerRegistry.listContracts();
+    const artifacts = deps.remoteRunnerRegistry.listArtifacts();
+    const supervisor = deps.remoteSupervisor.getSnapshot(deps.runtimeStore);
+    return Object.freeze({
+        capturedAt: Date.now(),
+        nodeHostContract: deps.distributedRuntime.getNodeHostContract(),
+        acp: buildAcpSnapshot(deps.runtimeStore),
+        pairing: countRequests(pairingRequests),
+        peers,
+        peerSnapshots: buildPeerSnapshots(deps),
+        work,
+        runners: {
+            pools,
+            contracts,
+            artifacts,
+        },
+        supervisor,
+    });
+}
+export function createPeerClient(deps) {
+    const resolved = Object.freeze({ ...deps });
+    return {
+        pairing: {
+            listRequests(limit = 100) {
+                return resolved.distributedRuntime.listPairRequests(limit);
+            },
+            request(input) {
+                return resolved.distributedRuntime.requestPairing(input);
+            },
+            approve(requestId, input) {
+                return resolved.distributedRuntime.approvePairRequest(requestId, input ?? {});
+            },
+            reject(requestId, input) {
+                return resolved.distributedRuntime.rejectPairRequest(requestId, input ?? {});
+            },
+            verify(requestId, challenge, input) {
+                return resolved.distributedRuntime.verifyPairRequest(requestId, challenge, input ?? {});
+            },
+        },
+        peers: {
+            list(kind, limit = 200) {
+                return resolved.distributedRuntime.listPeers(kind, limit);
+            },
+            get(peerId) {
+                return resolved.distributedRuntime.listPeers(undefined, 500).find((peer) => peer.id === peerId) ?? null;
+            },
+            getSnapshot(peerId) {
+                return buildPeerSnapshot(resolved, peerId);
+            },
+            authenticateToken(tokenValue, remoteAddress) {
+                return resolved.distributedRuntime.authenticatePeerToken(tokenValue, remoteAddress);
+            },
+            heartbeat(auth, input) {
+                return resolved.distributedRuntime.heartbeatPeer(auth, input ?? {});
+            },
+            rotateToken(peerId, input) {
+                return resolved.distributedRuntime.rotatePeerToken(peerId, input ?? {});
+            },
+            revokeToken(peerId, input) {
+                return resolved.distributedRuntime.revokePeerToken(peerId, input ?? {});
+            },
+            disconnect(peerId, input) {
+                return resolved.distributedRuntime.disconnectPeer(peerId, input ?? {});
+            },
+        },
+        work: {
+            list(limit = 200, peerId) {
+                return resolved.distributedRuntime.listWork(limit, peerId);
+            },
+            enqueue(input) {
+                return resolved.distributedRuntime.enqueueWork(input);
+            },
+            invoke(input) {
+                return resolved.distributedRuntime.invokePeer(input);
+            },
+            claim(auth, input) {
+                return resolved.distributedRuntime.claimWork(auth, input ?? {});
+            },
+            complete(auth, workId, input) {
+                return resolved.distributedRuntime.completeWork(auth, workId, input ?? {});
+            },
+            cancel(workId, input) {
+                return resolved.distributedRuntime.cancelWork(workId, input ?? {});
+            },
+        },
+        runners: {
+            listPools() {
+                return resolved.remoteRunnerRegistry.listPools();
+            },
+            getPool(poolId) {
+                return resolved.remoteRunnerRegistry.getPool(poolId);
+            },
+            createPool(input) {
+                return resolved.remoteRunnerRegistry.createPool(input);
+            },
+            assignRunnerToPool(poolId, runnerId) {
+                return resolved.remoteRunnerRegistry.assignRunnerToPool(poolId, runnerId);
+            },
+            removeRunnerFromPool(poolId, runnerId) {
+                return resolved.remoteRunnerRegistry.removeRunnerFromPool(poolId, runnerId);
+            },
+            listContracts() {
+                return resolved.remoteRunnerRegistry.listContracts();
+            },
+            getContract(runnerId) {
+                return resolved.remoteRunnerRegistry.getContract(runnerId);
+            },
+            registerContract(contract) {
+                return resolved.remoteRunnerRegistry.registerContract(contract);
+            },
+            upsertContractForAgent(agentId) {
+                return resolved.remoteRunnerRegistry.upsertContractForAgent(agentId, resolved.runtimeStore);
+            },
+            listArtifacts() {
+                return resolved.remoteRunnerRegistry.listArtifacts();
+            },
+            getArtifact(artifactId) {
+                return resolved.remoteRunnerRegistry.getArtifact(artifactId);
+            },
+            captureArtifactForAgent(agentId) {
+                return resolved.remoteRunnerRegistry.captureArtifactForAgent(agentId, resolved.runtimeStore);
+            },
+            captureArtifactForRunner(runnerId) {
+                return resolved.remoteRunnerRegistry.captureArtifactForRunner(runnerId, resolved.runtimeStore);
+            },
+            exportArtifact(artifactId, path) {
+                return resolved.remoteRunnerRegistry.exportArtifact(artifactId, path);
+            },
+            importArtifact(path) {
+                return resolved.remoteRunnerRegistry.importArtifact(path);
+            },
+            buildReviewSummary(artifactId) {
+                return resolved.remoteRunnerRegistry.buildReviewSummary(artifactId);
+            },
+            exportSessionBundle(path) {
+                return resolved.remoteRunnerRegistry.exportSessionBundle(resolved.runtimeStore, path);
+            },
+            importSessionBundle(path) {
+                return resolved.remoteRunnerRegistry.importSessionBundle(path);
+            },
+        },
+        getSnapshot() {
+            return buildSnapshot(resolved);
+        },
+        getNodeHostContract() {
+            return resolved.distributedRuntime.getNodeHostContract();
+        },
+    };
+}

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

@@ -0,0 +1,34 @@
+/**
+ * Performance budget system — barrel export.
+ *
+ * Provides budget definitions, the PerfMonitor class for metric collection
+ * and budget evaluation, and the reporter for CI/console output.
+ *
+ * @example
+ * ```ts
+ * import { createPerfMonitor, DEFAULT_BUDGETS } from './perf/index.js';
+ *
+ * const monitor = createPerfMonitor();
+ * const report = monitor.evaluate(snapshot);
+ * ```
+ */
+export type { PerfBudget, PerfMetric, BudgetViolation, PerfReport, PerfUnit, } from '@pellux/goodvibes-sdk/platform/runtime/perf/types';
+export { DEFAULT_BUDGETS } from '@pellux/goodvibes-sdk/platform/runtime/perf/budgets';
+export { PerfMonitor } from '@pellux/goodvibes-sdk/platform/runtime/perf/monitor';
+export type { PerfSnapshot } from '@pellux/goodvibes-sdk/platform/runtime/perf/monitor';
+export { formatReport, exitCode } from '@pellux/goodvibes-sdk/platform/runtime/perf/reporter';
+export { SloCollector, SLO_METRICS } from './slo-collector.js';
+export type { PanelResourceContract, PanelHealthState, PanelThrottleStatus, PanelHealthStatus, } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-contracts';
+export { CATEGORY_CONTRACTS, buildContract, createInitialPanelHealthState, } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-contracts';
+export { PanelHealthMonitor, } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-health-monitor';
+import { PerfMonitor } from '@pellux/goodvibes-sdk/platform/runtime/perf/monitor';
+import type { PerfBudget } from '@pellux/goodvibes-sdk/platform/runtime/perf/types';
+/**
+ * Factory function that creates a PerfMonitor with the default budgets.
+ * Pass a custom budgets array to override defaults.
+ *
+ * @param budgets - Optional custom budget definitions.
+ * @returns A new PerfMonitor instance ready for evaluation.
+ */
+export declare function createPerfMonitor(budgets?: PerfBudget[]): PerfMonitor;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/perf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,UAAU,EACV,QAAQ,GACT,MAAM,mDAAmD,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAClF,YAAY,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/D,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,6BAA6B,GAC9B,MAAM,6DAA6D,CAAC;AACrE,OAAO,EACL,kBAAkB,GACnB,MAAM,kEAAkE,CAAC;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mDAAmD,CAAC;AAGpF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,UAAU,EAAoB,GAAG,WAAW,CAEtF"}

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

@@ -0,0 +1,32 @@
+/**
+ * Performance budget system — barrel export.
+ *
+ * Provides budget definitions, the PerfMonitor class for metric collection
+ * and budget evaluation, and the reporter for CI/console output.
+ *
+ * @example
+ * ```ts
+ * import { createPerfMonitor, DEFAULT_BUDGETS } from './perf/index.js';
+ *
+ * const monitor = createPerfMonitor();
+ * const report = monitor.evaluate(snapshot);
+ * ```
+ */
+export { DEFAULT_BUDGETS } from '@pellux/goodvibes-sdk/platform/runtime/perf/budgets';
+export { PerfMonitor } from '@pellux/goodvibes-sdk/platform/runtime/perf/monitor';
+export { formatReport, exitCode } from '@pellux/goodvibes-sdk/platform/runtime/perf/reporter';
+export { SloCollector, SLO_METRICS } from './slo-collector.js';
+export { CATEGORY_CONTRACTS, buildContract, createInitialPanelHealthState, } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-contracts';
+export { PanelHealthMonitor, } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-health-monitor';
+import { PerfMonitor } from '@pellux/goodvibes-sdk/platform/runtime/perf/monitor';
+import { DEFAULT_BUDGETS } from '@pellux/goodvibes-sdk/platform/runtime/perf/budgets';
+/**
+ * Factory function that creates a PerfMonitor with the default budgets.
+ * Pass a custom budgets array to override defaults.
+ *
+ * @param budgets - Optional custom budget definitions.
+ * @returns A new PerfMonitor instance ready for evaluation.
+ */
+export function createPerfMonitor(budgets = DEFAULT_BUDGETS) {
+    return new PerfMonitor(budgets);
+}

package/dist/_internal/platform/runtime/perf/slo-collector.d.ts

@@ -0,0 +1,95 @@
+/**
+ * SloCollector — collects SLO duration measurements from runtime events.
+ *
+ * Listens to the RuntimeEventBus and tracks four critical path latencies:
+ * - turn_start_ms: TURN_SUBMITTED → first STREAM_DELTA
+ * - cancel_ms: TURN_CANCEL → TURN_COMPLETED or TURN_ERROR
+ * - reconnect_recovery_ms: TRANSPORT_RECONNECTING → TRANSPORT_CONNECTED
+ * - permission_decision_ms: PERMISSION_REQUESTED → DECISION_EMITTED
+ *
+ * Maintains a capped rolling window of measurements per SLO and exposes
+ * p95 values for PerfMonitor integration via `getMetrics()`.
+ */
+import type { RuntimeEventBus } from '../events/index.js';
+import type { PerfMetric } from '@pellux/goodvibes-sdk/platform/runtime/perf/types';
+/** Metric key constants for each SLO measurement. */
+export declare const SLO_METRICS: {
+    readonly TURN_START: "slo.turn_start.p95";
+    readonly CANCEL: "slo.cancel.p95";
+    readonly RECONNECT_RECOVERY: "slo.reconnect_recovery.p95";
+    readonly PERMISSION_DECISION: "slo.permission_decision.p95";
+};
+/**
+ * SloCollector subscribes to RuntimeEventBus events and tracks per-SLO
+ * duration samples in rolling windows. Call `getMetrics()` to retrieve
+ * current p95 values compatible with PerfMonitor's extraMetrics field.
+ *
+ * @example
+ * ```ts
+ * const collector = new SloCollector(bus);
+ * const metrics = collector.getMetrics();
+ * const report = monitor.evaluate({ uiPerf, extraMetrics: Object.fromEntries(
+ *   metrics.map(m => [m.name, m.value])
+ * )});
+ * collector.dispose();
+ * ```
+ */
+export declare class SloCollector {
+    /** Rolling window of turn_start_ms samples (TURN_SUBMITTED → first STREAM_DELTA). */
+    private readonly _turnStartSamples;
+    /** Rolling window of cancel_ms samples (TURN_CANCEL → TURN_COMPLETED/ERROR). */
+    private readonly _cancelSamples;
+    /** Rolling window of reconnect_recovery_ms samples (TRANSPORT_RECONNECTING → TRANSPORT_CONNECTED). */
+    private readonly _reconnectSamples;
+    /** Rolling window of permission_decision_ms samples (PERMISSION_REQUESTED → DECISION_EMITTED). */
+    private readonly _permissionSamples;
+    /** Pending turn start timestamps keyed by turnId. */
+    private readonly _pendingTurnStart;
+    /** Tracks which turnIds have received their first STREAM_DELTA. */
+    private readonly _seenFirstDelta;
+    /** Pending cancel timestamps keyed by turnId (set on TURN_CANCEL). */
+    private readonly _pendingCancel;
+    /** Pending reconnect start timestamp. Only the most recent reconnect attempt is tracked. */
+    private _pendingReconnectAt;
+    /** Pending permission request timestamps keyed by callId. */
+    private readonly _pendingPermission;
+    /** Registered unsubscribe functions. */
+    private readonly _unsubs;
+    /** Timer handle for the periodic stale-entry sweep. */
+    private _sweepTimer;
+    constructor(bus: RuntimeEventBus);
+    /**
+     * Attach all event listeners to the bus.
+     */
+    private _subscribe;
+    /**
+     * Sweep all pending maps and evict entries older than PENDING_TTL_MS.
+     *
+     * Called periodically by the sweep timer to prevent unbounded memory growth
+     * when expected follow-up events (e.g. TURN_COMPLETED after TURN_CANCEL)
+     * never arrive due to connection drops or unexpected process termination.
+     */
+    private _sweepPending;
+    /**
+     * Returns current p95 values for all four SLO metrics as PerfMetric entries.
+     * Metrics with no samples return a value of 0.
+     *
+     * Intended for use with `PerfMonitor.evaluate()` via the `extraMetrics` field:
+     * ```ts
+     * const extras = Object.fromEntries(collector.getMetrics().map(m => [m.name, m.value]));
+     * monitor.evaluate({ uiPerf, extraMetrics: extras });
+     * ```
+     */
+    getMetrics(): PerfMetric[];
+    /**
+     * Returns the number of samples collected for each SLO metric.
+     * Useful for diagnostics to distinguish "no data yet" from an actual 0ms result.
+     */
+    getSampleCounts(): Readonly<Record<string, number>>;
+    /**
+     * Unsubscribes all event listeners and releases resources.
+     * The collector should not be used after disposal.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=slo-collector.d.ts.map

package/dist/_internal/platform/runtime/perf/slo-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slo-collector.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/runtime/perf/slo-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAyC,MAAM,oBAAoB,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mDAAmD,CAAC;AAEpF,qDAAqD;AACrD,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AA8DX;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACvB,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;IAClD,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,sGAAsG;IACtG,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;IAClD,kGAAkG;IAClG,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAgB;IAEnD,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,sEAAsE;IACtE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,4FAA4F;IAC5F,OAAO,CAAC,mBAAmB,CAAuB;IAClD,6DAA6D;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAEhE,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,uDAAuD;IACvD,OAAO,CAAC,WAAW,CAA+C;gBAEtD,GAAG,EAAE,eAAe;IAKhC;;OAEG;IACH,OAAO,CAAC,UAAU;IA6IlB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;;;;;;OASG;IACI,UAAU,IAAI,UAAU,EAAE;IA8BjC;;;OAGG;IACI,eAAe,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAS1D;;;OAGG;IACI,OAAO,IAAI,IAAI;CAevB"}