@quenty/studio-bridge 0.7.1 → 0.8.0

package/dist/src/bridge/internal/host-protocol.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Envelope protocol for client-to-host communication. When a bridge client
+ * needs to send an action to a plugin session, it wraps the action in a
+ * HostEnvelope and sends it to the host. The host unwraps the envelope,
+ * forwards the action to the plugin, wraps the response in a HostResponse,
+ * and sends it back to the client.
+ */
+import type { ServerMessage, PluginMessage } from '../../server/web-socket-protocol.js';
+import type { SessionInfo, SessionContext, InstanceInfo } from '../types.js';
+export interface HostEnvelope {
+    type: 'host-envelope';
+    requestId: string;
+    targetSessionId: string;
+    action: ServerMessage;
+}
+export interface ListSessionsRequest {
+    type: 'list-sessions';
+    requestId: string;
+}
+export interface ListInstancesRequest {
+    type: 'list-instances';
+    requestId: string;
+}
+export interface HostResponse {
+    type: 'host-response';
+    requestId: string;
+    result: PluginMessage;
+}
+export interface ListSessionsResponse {
+    type: 'list-sessions-response';
+    requestId: string;
+    sessions: SessionInfo[];
+}
+export interface ListInstancesResponse {
+    type: 'list-instances-response';
+    requestId: string;
+    instances: InstanceInfo[];
+}
+export interface SessionEvent {
+    type: 'session-event';
+    event: 'connected' | 'disconnected' | 'state-changed';
+    session?: SessionInfo;
+    sessionId: string;
+    context: SessionContext;
+    instanceId: string;
+}
+export interface HostTransferNotice {
+    type: 'host-transfer';
+}
+export type HostProtocolMessage = HostEnvelope | ListSessionsRequest | ListInstancesRequest | HostResponse | ListSessionsResponse | ListInstancesResponse | SessionEvent | HostTransferNotice;
+/**
+ * Encode a host protocol message to a JSON string.
+ */
+export declare function encodeHostMessage(msg: HostProtocolMessage): string;
+/**
+ * Decode a host protocol message from a JSON string.
+ * Returns null if the message is malformed or has an unknown type.
+ */
+export declare function decodeHostMessage(raw: string): HostProtocolMessage | null;
+//# sourceMappingURL=host-protocol.d.ts.map

package/dist/src/bridge/internal/host-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-protocol.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/host-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,WAAW,GAAG,cAAc,GAAG,eAAe,CAAC;IACtD,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,MAAM,mBAAmB,GAC3B,YAAY,GACZ,mBAAmB,GACnB,oBAAoB,GACpB,YAAY,GACZ,oBAAoB,GACpB,qBAAqB,GACrB,YAAY,GACZ,kBAAkB,CAAC;AA+JvB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAazE"}

package/dist/src/bridge/internal/host-protocol.js

@@ -0,0 +1,184 @@
+/**
+ * Envelope protocol for client-to-host communication. When a bridge client
+ * needs to send an action to a plugin session, it wraps the action in a
+ * HostEnvelope and sends it to the host. The host unwraps the envelope,
+ * forwards the action to the plugin, wraps the response in a HostResponse,
+ * and sends it back to the client.
+ */
+import { z } from 'zod';
+// --- Runtime validation schemas ---
+//
+// `ServerMessageSchema` is the load-bearing one: it validates the `action`
+// payload that /client connections forward to plugins. Without it, a buggy
+// or hostile CLI client could ship malformed actions and crash the plugin.
+// Container fields like `result`, `sessions`, `instances`, and `session` are
+// validated only as objects/arrays — their interior shapes flow through to
+// callers that already know how to handle the typed contracts.
+const ErrorCodeSchema = z.enum([
+    'UNKNOWN_REQUEST',
+    'INVALID_PAYLOAD',
+    'TIMEOUT',
+    'CAPABILITY_NOT_SUPPORTED',
+    'INSTANCE_NOT_FOUND',
+    'PROPERTY_NOT_FOUND',
+    'SCREENSHOT_FAILED',
+    'SCRIPT_LOAD_ERROR',
+    'SCRIPT_RUNTIME_ERROR',
+    'BUSY',
+    'SESSION_MISMATCH',
+    'INTERNAL_ERROR',
+]);
+const OutputLevelSchema = z.enum(['Print', 'Info', 'Warning', 'Error']);
+const ServerMessageSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('execute'),
+        sessionId: z.string(),
+        requestId: z.string().optional(),
+        payload: z.object({ script: z.string() }),
+    }),
+    z.object({
+        type: z.literal('shutdown'),
+        sessionId: z.string(),
+        payload: z.object({}).loose(),
+    }),
+    z.object({
+        type: z.literal('queryState'),
+        sessionId: z.string(),
+        requestId: z.string(),
+        payload: z.object({}).loose(),
+    }),
+    z.object({
+        type: z.literal('captureScreenshot'),
+        sessionId: z.string(),
+        requestId: z.string(),
+        payload: z.object({
+            format: z.literal('png').optional(),
+        }),
+    }),
+    z.object({
+        type: z.literal('queryDataModel'),
+        sessionId: z.string(),
+        requestId: z.string(),
+        payload: z.object({
+            path: z.string(),
+            depth: z.number().optional(),
+            properties: z.array(z.string()).optional(),
+            includeAttributes: z.boolean().optional(),
+            find: z
+                .object({
+                name: z.string(),
+                recursive: z.boolean().optional(),
+            })
+                .optional(),
+            listServices: z.boolean().optional(),
+        }),
+    }),
+    z.object({
+        type: z.literal('queryLogs'),
+        sessionId: z.string(),
+        requestId: z.string(),
+        payload: z.object({
+            count: z.number().optional(),
+            direction: z.enum(['head', 'tail']).optional(),
+            levels: z.array(OutputLevelSchema).optional(),
+            includeInternal: z.boolean().optional(),
+        }),
+    }),
+    z.object({
+        type: z.literal('registerAction'),
+        sessionId: z.string(),
+        requestId: z.string(),
+        payload: z.object({
+            name: z.string(),
+            source: z.string(),
+            hash: z.string().optional(),
+            responseType: z.string().optional(),
+        }),
+    }),
+    z.object({
+        type: z.literal('syncActions'),
+        sessionId: z.string(),
+        requestId: z.string(),
+        payload: z.object({
+            actions: z.record(z.string(), z.string()),
+        }),
+    }),
+    z.object({
+        type: z.literal('error'),
+        sessionId: z.string(),
+        requestId: z.string().optional(),
+        payload: z.object({
+            code: ErrorCodeSchema,
+            message: z.string(),
+            details: z.unknown().optional(),
+        }),
+    }),
+]);
+const LooseObjectSchema = z.record(z.string(), z.unknown());
+const HostProtocolMessageSchema = z.discriminatedUnion('type', [
+    z.object({
+        type: z.literal('host-envelope'),
+        requestId: z.string(),
+        targetSessionId: z.string(),
+        action: ServerMessageSchema,
+    }),
+    z.object({
+        type: z.literal('list-sessions'),
+        requestId: z.string(),
+    }),
+    z.object({
+        type: z.literal('list-instances'),
+        requestId: z.string(),
+    }),
+    z.object({
+        type: z.literal('host-response'),
+        requestId: z.string(),
+        result: LooseObjectSchema,
+    }),
+    z.object({
+        type: z.literal('list-sessions-response'),
+        requestId: z.string(),
+        sessions: z.array(LooseObjectSchema),
+    }),
+    z.object({
+        type: z.literal('list-instances-response'),
+        requestId: z.string(),
+        instances: z.array(LooseObjectSchema),
+    }),
+    z.object({
+        type: z.literal('session-event'),
+        event: z.enum(['connected', 'disconnected', 'state-changed']),
+        session: LooseObjectSchema.optional(),
+        sessionId: z.string(),
+        context: z.enum(['edit', 'client', 'server']),
+        instanceId: z.string(),
+    }),
+    z.object({
+        type: z.literal('host-transfer'),
+    }),
+]);
+/**
+ * Encode a host protocol message to a JSON string.
+ */
+export function encodeHostMessage(msg) {
+    return JSON.stringify(msg);
+}
+/**
+ * Decode a host protocol message from a JSON string.
+ * Returns null if the message is malformed or has an unknown type.
+ */
+export function decodeHostMessage(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    const result = HostProtocolMessageSchema.safeParse(parsed);
+    if (!result.success) {
+        return null;
+    }
+    return result.data;
+}
+//# sourceMappingURL=host-protocol.js.map

package/dist/src/bridge/internal/host-protocol.js.map

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

package/dist/src/bridge/internal/host-protocol.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for host-protocol -- validates encode/decode round-trip
+ * for all envelope message types.
+ */
+export {};
+//# sourceMappingURL=host-protocol.test.d.ts.map

package/dist/src/bridge/internal/host-protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-protocol.test.d.ts","sourceRoot":"","sources":["../../../../src/bridge/internal/host-protocol.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/bridge/internal/host-protocol.test.js

@@ -0,0 +1,307 @@
+/**
+ * Unit tests for host-protocol -- validates encode/decode round-trip
+ * for all envelope message types.
+ */
+import { describe, it, expect } from 'vitest';
+import { encodeHostMessage, decodeHostMessage, } from './host-protocol.js';
+function roundTrip(msg) {
+    return decodeHostMessage(encodeHostMessage(msg));
+}
+function createSessionInfo(overrides = {}) {
+    return {
+        sessionId: 'session-1',
+        placeName: 'TestPlace',
+        state: 'Edit',
+        pluginVersion: '1.0.0',
+        capabilities: ['execute'],
+        connectedAt: new Date('2024-01-01'),
+        origin: 'user',
+        context: 'edit',
+        instanceId: 'inst-1',
+        placeId: 100,
+        gameId: 200,
+        ...overrides,
+    };
+}
+describe('host-protocol', () => {
+    describe('HostEnvelope', () => {
+        it('round-trips correctly', () => {
+            const msg = {
+                type: 'host-envelope',
+                requestId: 'req-1',
+                targetSessionId: 'session-1',
+                action: {
+                    type: 'execute',
+                    sessionId: 'session-1',
+                    payload: { script: 'print("hi")' },
+                },
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('host-envelope');
+            const envelope = decoded;
+            expect(envelope.requestId).toBe('req-1');
+            expect(envelope.targetSessionId).toBe('session-1');
+            expect(envelope.action.type).toBe('execute');
+        });
+    });
+    describe('ListSessionsRequest', () => {
+        it('round-trips correctly', () => {
+            const msg = {
+                type: 'list-sessions',
+                requestId: 'req-2',
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('list-sessions');
+            expect(decoded.requestId).toBe('req-2');
+        });
+    });
+    describe('ListInstancesRequest', () => {
+        it('round-trips correctly', () => {
+            const msg = {
+                type: 'list-instances',
+                requestId: 'req-3',
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('list-instances');
+            expect(decoded.requestId).toBe('req-3');
+        });
+    });
+    describe('HostResponse', () => {
+        it('round-trips correctly', () => {
+            const msg = {
+                type: 'host-response',
+                requestId: 'req-4',
+                result: {
+                    type: 'stateResult',
+                    sessionId: 'session-1',
+                    requestId: 'req-4',
+                    payload: {
+                        state: 'Edit',
+                        placeId: 100,
+                        placeName: 'Test',
+                        gameId: 200,
+                    },
+                },
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('host-response');
+            const response = decoded;
+            expect(response.requestId).toBe('req-4');
+            expect(response.result.type).toBe('stateResult');
+        });
+    });
+    describe('ListSessionsResponse', () => {
+        it('round-trips correctly', () => {
+            const msg = {
+                type: 'list-sessions-response',
+                requestId: 'req-5',
+                sessions: [createSessionInfo()],
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('list-sessions-response');
+            const response = decoded;
+            expect(response.requestId).toBe('req-5');
+            expect(response.sessions).toHaveLength(1);
+            expect(response.sessions[0].sessionId).toBe('session-1');
+        });
+        it('handles empty session list', () => {
+            const msg = {
+                type: 'list-sessions-response',
+                requestId: 'req-6',
+                sessions: [],
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.sessions).toHaveLength(0);
+        });
+    });
+    describe('ListInstancesResponse', () => {
+        it('round-trips correctly', () => {
+            const instance = {
+                instanceId: 'inst-1',
+                placeName: 'TestPlace',
+                placeId: 100,
+                gameId: 200,
+                contexts: ['edit', 'server'],
+                origin: 'user',
+            };
+            const msg = {
+                type: 'list-instances-response',
+                requestId: 'req-7',
+                instances: [instance],
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('list-instances-response');
+            const response = decoded;
+            expect(response.instances).toHaveLength(1);
+            expect(response.instances[0].instanceId).toBe('inst-1');
+        });
+    });
+    describe('SessionEvent', () => {
+        it('round-trips connected event', () => {
+            const msg = {
+                type: 'session-event',
+                event: 'connected',
+                session: createSessionInfo(),
+                sessionId: 'session-1',
+                context: 'edit',
+                instanceId: 'inst-1',
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('session-event');
+            const event = decoded;
+            expect(event.event).toBe('connected');
+            expect(event.session).toBeDefined();
+            expect(event.sessionId).toBe('session-1');
+            expect(event.context).toBe('edit');
+            expect(event.instanceId).toBe('inst-1');
+        });
+        it('round-trips disconnected event (no session)', () => {
+            const msg = {
+                type: 'session-event',
+                event: 'disconnected',
+                sessionId: 'session-1',
+                context: 'edit',
+                instanceId: 'inst-1',
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            const event = decoded;
+            expect(event.event).toBe('disconnected');
+            expect(event.session).toBeUndefined();
+        });
+        it('round-trips state-changed event', () => {
+            const msg = {
+                type: 'session-event',
+                event: 'state-changed',
+                session: createSessionInfo({ state: 'Play' }),
+                sessionId: 'session-1',
+                context: 'edit',
+                instanceId: 'inst-1',
+            };
+            const decoded = roundTrip(msg);
+            expect(decoded).not.toBeNull();
+            expect(decoded.event).toBe('state-changed');
+        });
+    });
+    describe('error handling', () => {
+        it('returns null for invalid JSON', () => {
+            expect(decodeHostMessage('not json')).toBeNull();
+        });
+        it('returns null for non-object values', () => {
+            expect(decodeHostMessage('"hello"')).toBeNull();
+            expect(decodeHostMessage('42')).toBeNull();
+            expect(decodeHostMessage('null')).toBeNull();
+        });
+        it('returns null for missing type', () => {
+            expect(decodeHostMessage(JSON.stringify({ requestId: 'r-1' }))).toBeNull();
+        });
+        it('returns null for unknown type', () => {
+            expect(decodeHostMessage(JSON.stringify({ type: 'unknown' }))).toBeNull();
+        });
+        it('returns null for host-envelope with missing fields', () => {
+            expect(decodeHostMessage(JSON.stringify({
+                type: 'host-envelope',
+                requestId: 'r-1',
+                // missing targetSessionId and action
+            }))).toBeNull();
+        });
+        it('returns null for list-sessions with missing requestId', () => {
+            expect(decodeHostMessage(JSON.stringify({
+                type: 'list-sessions',
+            }))).toBeNull();
+        });
+        it('returns null for session-event with invalid event value', () => {
+            expect(decodeHostMessage(JSON.stringify({
+                type: 'session-event',
+                event: 'invalid',
+                sessionId: 's-1',
+                context: 'edit',
+                instanceId: 'i-1',
+            }))).toBeNull();
+        });
+    });
+    describe('HostEnvelope action validation', () => {
+        function envelope(action) {
+            return JSON.stringify({
+                type: 'host-envelope',
+                requestId: 'r-1',
+                targetSessionId: 's-1',
+                action,
+            });
+        }
+        it('returns null when action.type is missing', () => {
+            expect(decodeHostMessage(envelope({ sessionId: 's-1', payload: { script: 'x' } }))).toBeNull();
+        });
+        it('returns null when action.type is unknown', () => {
+            expect(decodeHostMessage(envelope({
+                type: 'totally-fake',
+                sessionId: 's-1',
+                payload: {},
+            }))).toBeNull();
+        });
+        it('returns null when execute action is missing payload.script', () => {
+            expect(decodeHostMessage(envelope({ type: 'execute', sessionId: 's-1', payload: {} }))).toBeNull();
+        });
+        it('returns null when execute action has wrong script type', () => {
+            expect(decodeHostMessage(envelope({
+                type: 'execute',
+                sessionId: 's-1',
+                payload: { script: 42 },
+            }))).toBeNull();
+        });
+        it('returns null when queryDataModel action is missing payload.path', () => {
+            expect(decodeHostMessage(envelope({
+                type: 'queryDataModel',
+                sessionId: 's-1',
+                requestId: 'a',
+                payload: {},
+            }))).toBeNull();
+        });
+        it('returns null when error action has unknown error code', () => {
+            expect(decodeHostMessage(envelope({
+                type: 'error',
+                sessionId: 's-1',
+                payload: { code: 'NOT_A_REAL_CODE', message: 'oops' },
+            }))).toBeNull();
+        });
+        it('returns null when sessionId is missing on action', () => {
+            expect(decodeHostMessage(envelope({ type: 'execute', payload: { script: 'x' } }))).toBeNull();
+        });
+        it('accepts a well-formed execute action', () => {
+            const decoded = decodeHostMessage(envelope({
+                type: 'execute',
+                sessionId: 's-1',
+                payload: { script: 'print("ok")' },
+            }));
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('host-envelope');
+            expect(decoded.action.type).toBe('execute');
+        });
+        it('accepts a well-formed queryDataModel action with all fields', () => {
+            const decoded = decodeHostMessage(envelope({
+                type: 'queryDataModel',
+                sessionId: 's-1',
+                requestId: 'q-1',
+                payload: {
+                    path: 'workspace',
+                    depth: 2,
+                    properties: ['Name', 'ClassName'],
+                    includeAttributes: true,
+                    find: { name: 'Camera', recursive: false },
+                    listServices: false,
+                },
+            }));
+            expect(decoded).not.toBeNull();
+            expect(decoded.type).toBe('host-envelope');
+        });
+    });
+});
+//# sourceMappingURL=host-protocol.test.js.map

package/dist/src/bridge/internal/host-protocol.test.js.map

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

package/dist/src/bridge/internal/session-tracker.d.ts

@@ -0,0 +1,67 @@
+/**
+ * In-memory session map with instance-level grouping. Tracks connected
+ * plugin sessions by sessionId and groups them by instanceId for
+ * multi-context support (edit, client, server in Play mode).
+ *
+ * Used exclusively by bridge-host.ts. Emits events when sessions and
+ * instance groups are added, removed, or updated.
+ */
+import { EventEmitter } from 'events';
+import type { SessionInfo, SessionContext, InstanceInfo, StudioState } from '../types.js';
+import type { PluginMessage, ServerMessage } from '../../server/web-socket-protocol.js';
+export interface TransportHandle {
+    sendActionAsync<TResponse>(message: ServerMessage, timeoutMs: number): Promise<TResponse>;
+    sendMessage(message: ServerMessage): void;
+    readonly isConnected: boolean;
+    on(event: 'message', listener: (msg: PluginMessage) => void): this;
+    on(event: 'disconnected', listener: () => void): this;
+}
+export interface TrackedSession {
+    info: SessionInfo;
+    handle: TransportHandle;
+    lastHeartbeat: Date;
+}
+export declare class SessionTracker extends EventEmitter {
+    private _sessions;
+    private _instanceSessions;
+    /**
+     * Add a session to the tracker. Groups by instanceId and emits events.
+     * If this is the first session for the instanceId, emits 'instance-added'.
+     */
+    addSession(sessionId: string, info: SessionInfo, handle: TransportHandle): void;
+    /**
+     * Remove a session from the tracker. If this was the last session for
+     * the instanceId, removes the instance group and emits 'instance-removed'.
+     */
+    removeSession(sessionId: string): void;
+    /**
+     * Get a tracked session by sessionId.
+     */
+    getSession(sessionId: string): TrackedSession | undefined;
+    /**
+     * List all session infos.
+     */
+    listSessions(): SessionInfo[];
+    /**
+     * Update a session's state and emit 'session-updated'.
+     */
+    updateSessionState(sessionId: string, state: StudioState): void;
+    /**
+     * List unique instances. Each instance groups 1-3 context sessions
+     * that share the same instanceId.
+     */
+    listInstances(): InstanceInfo[];
+    /**
+     * Get all tracked sessions for a given instanceId.
+     */
+    getSessionsByInstance(instanceId: string): TrackedSession[];
+    /**
+     * Get a specific context session for an instance.
+     * Returns undefined if the context is not connected.
+     */
+    getSessionByContext(instanceId: string, context: SessionContext): TrackedSession | undefined;
+    /** Number of currently tracked sessions. */
+    get sessionCount(): number;
+    private _buildInstanceInfo;
+}
+//# sourceMappingURL=session-tracker.d.ts.map