Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
import {
PreviewTabId,
type PreviewAutomationError,
type PreviewAutomationOperation,
type PreviewAutomationHost,
type PreviewAutomationStreamEvent,
} from "@akeru/contracts";
import * as Deferred from "effect/Deferred";
import * as Queue from "effect/Queue";
import * as McpInvocationContext from "./McpInvocationContext.ts";
export interface PreviewAutomationInvokeInput {
readonly scope: McpInvocationContext.McpInvocationScope;
readonly operation: PreviewAutomationOperation;
readonly input: unknown;
readonly tabId?: PreviewTabId;
readonly timeoutMs?: number;
}
export interface ClientConnection {
readonly clientId: string;
readonly connectionId: string;
readonly environmentId: PreviewAutomationHost["environmentId"];
readonly supportedOperations: ReadonlySet<PreviewAutomationOperation>;
readonly focused: boolean;
readonly focusOrder: number;
readonly queue: Queue.Queue<PreviewAutomationStreamEvent>;
}
export interface PendingRequest {
readonly queue: ClientConnection["queue"];
readonly deferred: Deferred.Deferred<unknown, PreviewAutomationError>;
readonly context: PreviewAutomationRequestErrorContext;
}
/**
* A lease pinning one provider session to one desktop runtime. It lives exactly
* as long as the connection it names: `connectionId`/`queue` identity is what
* makes a lease valid, so a disconnected or replaced host is dropped on the next
* lookup. The lease deliberately has no clock of its own — it used to inherit
* the MCP credential's expiry, which coupled host stickiness to an unrelated
* auth deadline and could migrate a live session to another runtime mid-flow.
*/
export interface HostAssignment {
readonly clientId: ClientConnection["clientId"];
readonly connectionId: ClientConnection["connectionId"];
readonly queue: ClientConnection["queue"];
readonly tabId?: PreviewTabId;
readonly tabSequence?: number;
}
export interface PreviewAutomationRequestErrorContext {
readonly operation: PreviewAutomationOperation;
readonly environmentId: McpInvocationContext.McpInvocationScope["environmentId"];
readonly threadId: McpInvocationContext.McpInvocationScope["threadId"];
readonly providerSessionId: string;
readonly providerInstanceId: McpInvocationContext.McpInvocationScope["providerInstanceId"];
readonly clientId: string;
readonly connectionId: ClientConnection["connectionId"];
readonly requestId: string;
readonly tabId?: PreviewTabId;
readonly timeoutMs: number;
readonly selectorKind?: "locator" | "selector";
readonly selectorLength?: number;
}
export interface BrokerState {
readonly clients: ReadonlyMap<string, ClientConnection>;
readonly assignments: ReadonlyMap<string, HostAssignment>;
readonly pending: ReadonlyMap<string, PendingRequest>;
readonly requestSequence: number;
readonly focusSequence: number;
}