@sentropic/h2a-runtime 0.91.0 → 0.92.0

package/dist/llm-routing-config.d.ts

@@ -0,0 +1,28 @@
+import { InMemoryRoutePolicyProfiles, type ModelEquivalenceCouncil, type RoutePolicy, type RoutePolicyProfile, type RouteSelector } from "@sentropic/llm-mesh";
+export interface LlmMeshRoutingConfig {
+    /** Host-level public policy override. Canonical routing knowledge remains in llm-mesh. */
+    policy?: RoutePolicy;
+    /** Optional named policies, validated and activated by llm-mesh. */
+    profiles?: RoutePolicyProfile[];
+    activeProfile?: string;
+    /** Optional request constraint; account selectors use only redacted refs. */
+    explicit?: RouteSelector;
+    /** Optional reviewed council replacement. Never synthesize one in h2a. */
+    council?: ModelEquivalenceCouncil;
+}
+export declare const ROUTING_TRANSPORT_ALIASES: {
+    readonly codex: "codex";
+    readonly "cloud-code": "cloud-code";
+    readonly agy: "cloud-code";
+};
+export type RoutingTransportAlias = keyof typeof ROUTING_TRANSPORT_ALIASES;
+export declare function routeSelectorForTransport(value: string): RouteSelector;
+export declare function validateLlmMeshRoutingConfig(config: LlmMeshRoutingConfig): LlmMeshRoutingConfig;
+export declare function routingProfiles(config: LlmMeshRoutingConfig | undefined): InMemoryRoutePolicyProfiles | undefined;
+export declare function preferredRoutingConfig(current: LlmMeshRoutingConfig | undefined, transports: readonly string[]): LlmMeshRoutingConfig;
+export declare function strategyRoutingConfig(current: LlmMeshRoutingConfig | undefined, strategy: "last-enrolled" | "round-robin"): LlmMeshRoutingConfig;
+export declare function effectiveRoutingPolicy(config: LlmMeshRoutingConfig | undefined): RoutePolicy;
+export declare function effectiveRoutingCouncil(config: LlmMeshRoutingConfig | undefined): ModelEquivalenceCouncil;
+export declare function parseLlmMeshRoutingConfig(value: string): LlmMeshRoutingConfig;
+export declare function describeLlmMeshRoutingConfig(config: LlmMeshRoutingConfig | undefined): Record<string, unknown>;
+//# sourceMappingURL=llm-routing-config.d.ts.map

package/dist/llm-routing-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-routing-config.d.ts","sourceRoot":"","sources":["../src/llm-routing-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,2BAA2B,EAI3B,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACnC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,uBAAuB,CAAC;CACnC;AAED,eAAO,MAAM,yBAAyB;;;;CAI5B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,yBAAyB,CAAC;AAE3E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAQtE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAC3B,oBAAoB,CAiBtB;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,2BAA2B,GAAG,SAAS,CAKzC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,oBAAoB,CAYtB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,QAAQ,EAAE,eAAe,GAAG,aAAa,GACxC,oBAAoB,CAQtB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,WAAW,CAEb;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,uBAAuB,CAEzB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,CAW7E;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAAG,SAAS,GACvC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB"}

package/dist/llm-routing-config.js

@@ -0,0 +1,100 @@
+import { DEFAULT_MODEL_EQUIVALENCE_COUNCIL, DEFAULT_ROUTE_POLICY, InMemoryRoutePolicyProfiles, modelProfiles, validateEquivalenceCouncil, validateRoutePolicy, } from "@sentropic/llm-mesh";
+export const ROUTING_TRANSPORT_ALIASES = {
+    codex: "codex",
+    "cloud-code": "cloud-code",
+    agy: "cloud-code",
+};
+export function routeSelectorForTransport(value) {
+    const transport = ROUTING_TRANSPORT_ALIASES[value];
+    if (!transport) {
+        throw new Error(`unsupported routing transport "${value}"; expected codex, cloud-code, or agy`);
+    }
+    return { transportProviderId: transport };
+}
+export function validateLlmMeshRoutingConfig(config) {
+    if (config.policy)
+        validateRoutePolicy(config.policy);
+    const names = new Set();
+    for (const profile of config.profiles ?? []) {
+        if (names.has(profile.name)) {
+            throw new Error(`duplicate llm-mesh route profile: ${profile.name}`);
+        }
+        names.add(profile.name);
+        validateRoutePolicy(profile.policy);
+    }
+    if (config.activeProfile && !names.has(config.activeProfile)) {
+        throw new Error(`unknown llm-mesh route profile: ${config.activeProfile}`);
+    }
+    if (config.council) {
+        validateEquivalenceCouncil(config.council, modelProfiles);
+    }
+    return config;
+}
+export function routingProfiles(config) {
+    if (!config?.profiles?.length)
+        return undefined;
+    const profiles = new InMemoryRoutePolicyProfiles(config.profiles);
+    if (config.activeProfile)
+        profiles.activate(config.activeProfile);
+    return profiles;
+}
+export function preferredRoutingConfig(current, transports) {
+    if (transports.length === 0) {
+        throw new Error("at least one routing transport is required");
+    }
+    const policy = {
+        ...(current?.policy ?? DEFAULT_ROUTE_POLICY),
+        strategy: {
+            kind: "ordered",
+            preferences: transports.map(routeSelectorForTransport),
+        },
+    };
+    return validateLlmMeshRoutingConfig({ ...current, policy });
+}
+export function strategyRoutingConfig(current, strategy) {
+    const policy = {
+        ...(current?.policy ?? DEFAULT_ROUTE_POLICY),
+        strategy: strategy === "last-enrolled"
+            ? { kind: "last-enrolled" }
+            : { kind: "round-robin", scope: "new-affinity" },
+    };
+    return validateLlmMeshRoutingConfig({ ...current, policy });
+}
+export function effectiveRoutingPolicy(config) {
+    return config?.policy ?? DEFAULT_ROUTE_POLICY;
+}
+export function effectiveRoutingCouncil(config) {
+    return config?.council ?? DEFAULT_MODEL_EQUIVALENCE_COUNCIL;
+}
+export function parseLlmMeshRoutingConfig(value) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`invalid routing JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("routing JSON must be an object");
+    }
+    return validateLlmMeshRoutingConfig(parsed);
+}
+export function describeLlmMeshRoutingConfig(config) {
+    const policy = effectiveRoutingPolicy(config);
+    return {
+        strategy: policy.strategy,
+        fallbackMode: policy.fallbackMode,
+        negativeCacheTtlMs: policy.negativeCacheTtlMs,
+        maxAttempts: policy.maxAttempts,
+        preferSameTransport: policy.preferSameTransport,
+        stickyAccount: policy.stickyAccount,
+        allowEquivalentModels: policy.allowEquivalentModels,
+        rotateEquivalentAccounts: policy.rotateEquivalentAccounts,
+        rules: policy.rules,
+        activeProfile: config?.activeProfile ?? null,
+        profiles: (config?.profiles ?? []).map(({ name, revision }) => ({ name, revision })),
+        explicit: config?.explicit ?? null,
+        councilRevision: effectiveRoutingCouncil(config).revision,
+    };
+}
+//# sourceMappingURL=llm-routing-config.js.map

package/dist/llm-routing-config.js.map

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

package/dist/native-terminal/client.d.ts

@@ -0,0 +1,23 @@
+import type { NativeTerminalControllerLease, NativeTerminalControllerState, NativeTerminalCreateOptions, NativeTerminalObserverAttachment, NativeTerminalReplay, NativeTerminalSessionState } from "./host.js";
+import { type NativeTerminalPing, type NativeTerminalStopSignal } from "./protocol.js";
+export declare class NativeTerminalClient {
+    #private;
+    private constructor();
+    static connect(socketPath: string, options?: {
+        connectTimeoutMs?: number;
+        requestTimeoutMs?: number;
+    }): Promise<NativeTerminalClient>;
+    ping(timeoutMs?: number): Promise<NativeTerminalPing>;
+    create(options: NativeTerminalCreateOptions): Promise<NativeTerminalSessionState>;
+    list(): Promise<ReadonlyArray<NativeTerminalSessionState>>;
+    state(id: string): Promise<NativeTerminalSessionState>;
+    readOutput(id: string, afterSeq: number): Promise<NativeTerminalReplay>;
+    attachObserver(id: string): Promise<NativeTerminalObserverAttachment>;
+    acquireController(id: string, controllerId: string): Promise<NativeTerminalControllerLease>;
+    releaseController(lease: NativeTerminalControllerLease): Promise<NativeTerminalControllerState>;
+    write(lease: NativeTerminalControllerLease, data: string): Promise<void>;
+    resize(lease: NativeTerminalControllerLease, cols: number, rows: number): Promise<void>;
+    stop(lease: NativeTerminalControllerLease, signal?: NativeTerminalStopSignal): Promise<NativeTerminalSessionState>;
+    close(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/native-terminal/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/native-terminal/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EAML,KAAK,kBAAkB,EAEvB,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AAYvB,qBAAa,oBAAoB;;IAO/B,OAAO;WAUM,OAAO,CAClB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KACtB,GACL,OAAO,CAAC,oBAAoB,CAAC;IAyDhC,IAAI,CAAC,SAAS,SAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIrE,MAAM,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAIjF,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,0BAA0B,CAAC,CAAC;IAI1D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAItD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIvE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAIrE,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAI3F,iBAAiB,CAAC,KAAK,EAAE,6BAA6B,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAIzF,KAAK,CAAC,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxE,MAAM,CAAC,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,IAAI,CACF,KAAK,EAAE,6BAA6B,EACpC,MAAM,CAAC,EAAE,wBAAwB,GAChC,OAAO,CAAC,0BAA0B,CAAC;IAOtC,KAAK,IAAI,IAAI;CAkGd"}

package/dist/native-terminal/client.js

@@ -0,0 +1,203 @@
+import { randomUUID } from "node:crypto";
+import { createConnection } from "node:net";
+import { NATIVE_TERMINAL_DEFAULT_REQUEST_TIMEOUT_MS, NATIVE_TERMINAL_MAX_FRAME_BYTES, NATIVE_TERMINAL_PROTOCOL_VERSION, NativeTerminalRemoteError, parseNativeTerminalResponse, } from "./protocol.js";
+import { inspectPrivateNativeTerminalSocket, sameNativeTerminalSocket, } from "./socket-path.js";
+export class NativeTerminalClient {
+    #socket;
+    #requestTimeoutMs;
+    #pending = new Map();
+    #buffer = "";
+    #closed = false;
+    constructor(socket, requestTimeoutMs) {
+        this.#socket = socket;
+        this.#requestTimeoutMs = requestTimeoutMs;
+        socket.setNoDelay(true);
+        socket.setEncoding("utf8");
+        socket.on("data", (chunk) => this.#onData(chunk));
+        socket.on("error", (error) => this.#fail(error));
+        socket.on("close", () => this.#fail(new Error("terminal host connection closed")));
+    }
+    static async connect(socketPath, options = {}) {
+        const expected = await inspectPrivateNativeTerminalSocket(socketPath);
+        const connectTimeoutMs = options.connectTimeoutMs ?? 1_000;
+        const requestTimeoutMs = options.requestTimeoutMs ?? NATIVE_TERMINAL_DEFAULT_REQUEST_TIMEOUT_MS;
+        for (const [label, value] of [
+            ["connectTimeoutMs", connectTimeoutMs],
+            ["requestTimeoutMs", requestTimeoutMs],
+        ]) {
+            if (!Number.isSafeInteger(value) || value <= 0) {
+                throw new RangeError(`${label} must be a positive safe integer`);
+            }
+        }
+        return new Promise((resolve, reject) => {
+            const socket = createConnection(socketPath);
+            let settled = false;
+            const timeout = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                socket.destroy();
+                reject(new Error("terminal host connection timed out"));
+            }, connectTimeoutMs);
+            timeout.unref();
+            const onError = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timeout);
+                socket.removeListener("connect", onConnect);
+                socket.destroy();
+                reject(error);
+            };
+            const onConnect = () => {
+                void inspectPrivateNativeTerminalSocket(socketPath).then((connected) => {
+                    if (settled)
+                        return;
+                    if (!sameNativeTerminalSocket(expected, connected)) {
+                        settled = true;
+                        clearTimeout(timeout);
+                        socket.destroy();
+                        reject(new Error("terminal host socket changed while connecting"));
+                        return;
+                    }
+                    settled = true;
+                    clearTimeout(timeout);
+                    socket.removeListener("error", onError);
+                    resolve(new NativeTerminalClient(socket, requestTimeoutMs));
+                }, onError);
+            };
+            socket.once("error", onError);
+            socket.once("connect", onConnect);
+        });
+    }
+    ping(timeoutMs = this.#requestTimeoutMs) {
+        return this.#request("ping", undefined, timeoutMs);
+    }
+    create(options) {
+        return this.#request("create", options);
+    }
+    list() {
+        return this.#request("list");
+    }
+    state(id) {
+        return this.#request("state", { id });
+    }
+    readOutput(id, afterSeq) {
+        return this.#request("read-output", { id, afterSeq });
+    }
+    attachObserver(id) {
+        return this.#request("attach-observer", { id });
+    }
+    acquireController(id, controllerId) {
+        return this.#request("acquire-controller", { id, controllerId });
+    }
+    releaseController(lease) {
+        return this.#request("release-controller", { lease });
+    }
+    async write(lease, data) {
+        await this.#request("write", { lease, data });
+    }
+    async resize(lease, cols, rows) {
+        await this.#request("resize", { lease, cols, rows });
+    }
+    stop(lease, signal) {
+        return this.#request("stop", signal === undefined ? { lease } : { lease, signal });
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#socket.destroy();
+        this.#fail(new Error("terminal host client closed"));
+    }
+    #request(operation, params, timeoutMs = this.#requestTimeoutMs) {
+        if (this.#closed)
+            return Promise.reject(new Error("terminal host client is closed"));
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs <= 0) {
+            return Promise.reject(new RangeError("terminal host request timeout must be a positive safe integer"));
+        }
+        const id = randomUUID();
+        const request = params === undefined
+            ? { version: NATIVE_TERMINAL_PROTOCOL_VERSION, id, operation }
+            : { version: NATIVE_TERMINAL_PROTOCOL_VERSION, id, operation, params };
+        const frame = `${JSON.stringify(request)}\n`;
+        if (Buffer.byteLength(frame) > NATIVE_TERMINAL_MAX_FRAME_BYTES) {
+            return Promise.reject(new RangeError("terminal host request exceeds the frame limit"));
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                if (!this.#pending.delete(id))
+                    return;
+                reject(new Error(`terminal host ${operation} request timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            timeout.unref();
+            this.#pending.set(id, { resolve, reject, timeout });
+            this.#socket.write(frame, (error) => {
+                if (!error)
+                    return;
+                const pending = this.#pending.get(id);
+                if (!pending)
+                    return;
+                this.#pending.delete(id);
+                clearTimeout(pending.timeout);
+                reject(error);
+            });
+        });
+    }
+    #onData(chunk) {
+        this.#buffer += chunk;
+        for (;;) {
+            const newline = this.#buffer.indexOf("\n");
+            if (newline < 0)
+                break;
+            const line = this.#buffer.slice(0, newline);
+            this.#buffer = this.#buffer.slice(newline + 1);
+            if (line.length === 0)
+                continue;
+            if (Buffer.byteLength(line) > NATIVE_TERMINAL_MAX_FRAME_BYTES) {
+                this.#socket.destroy(new Error("terminal host response exceeds the frame limit"));
+                return;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(line);
+            }
+            catch {
+                this.#socket.destroy(new Error("terminal host returned invalid JSON"));
+                return;
+            }
+            let response;
+            try {
+                response = parseNativeTerminalResponse(parsed);
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                this.#fail(new Error(`terminal host returned an invalid response: ${detail}`));
+                this.#socket.destroy();
+                return;
+            }
+            const pending = this.#pending.get(response.id);
+            if (!pending)
+                continue;
+            this.#pending.delete(response.id);
+            clearTimeout(pending.timeout);
+            if (response.ok)
+                pending.resolve(response.result);
+            else
+                pending.reject(new NativeTerminalRemoteError(response.error));
+        }
+        if (Buffer.byteLength(this.#buffer) > NATIVE_TERMINAL_MAX_FRAME_BYTES) {
+            this.#socket.destroy(new Error("terminal host response exceeds the frame limit"));
+        }
+    }
+    #fail(error) {
+        if (!this.#closed)
+            this.#closed = true;
+        for (const pending of this.#pending.values()) {
+            clearTimeout(pending.timeout);
+            pending.reject(error);
+        }
+        this.#pending.clear();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/native-terminal/client.js.map

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

package/dist/native-terminal/host.d.ts

@@ -0,0 +1,78 @@
+import type { PtySpawner } from "../pty.js";
+import { type TerminalOutputChunk, type TerminalReplayGap } from "./replay-buffer.js";
+import { type NativeTerminalStopSignal } from "./protocol.js";
+export type NativeTerminalExit = Readonly<{
+    exitCode: number;
+    signal?: number;
+}>;
+export type NativeTerminalSessionStatus = "running" | "stopping" | "exited";
+export type NativeTerminalSessionState = Readonly<{
+    id: string;
+    generation: string;
+    incarnation: string;
+    pid: number;
+    status: NativeTerminalSessionStatus;
+    latestSeq: number;
+    exit: NativeTerminalExit | null;
+    stopSignal: string | null;
+}>;
+export type NativeTerminalReplay = Readonly<{
+    generation: string;
+    incarnation: string;
+    chunks: ReadonlyArray<TerminalOutputChunk>;
+    gap: TerminalReplayGap | null;
+    latestSeq: number;
+}>;
+export type NativeTerminalObserverAttachment = Readonly<{
+    role: "observer";
+    id: string;
+    generation: string;
+    incarnation: string;
+    controllerEpoch: number;
+}>;
+export type NativeTerminalControllerLease = Readonly<{
+    role: "controller";
+    id: string;
+    generation: string;
+    incarnation: string;
+    controllerId: string;
+    epoch: number;
+}>;
+export type NativeTerminalControllerState = Readonly<{
+    id: string;
+    generation: string;
+    incarnation: string;
+    controllerEpoch: number;
+}>;
+export type NativeTerminalCreateOptions = Readonly<{
+    id: string;
+    command: string;
+    args: ReadonlyArray<string>;
+    cwd: string;
+    env: Readonly<Record<string, string>>;
+    cols: number;
+    rows: number;
+}>;
+export declare class NativeTerminalHost {
+    #private;
+    constructor(options: {
+        generation: string;
+        replayBytesPerSession: number;
+        maxSessions?: number;
+        spawner: PtySpawner;
+    });
+    get generation(): string;
+    create(options: NativeTerminalCreateOptions): NativeTerminalSessionState;
+    list(): ReadonlyArray<NativeTerminalSessionState>;
+    state(id: string): NativeTerminalSessionState;
+    readOutput(id: string, afterSeq: number): NativeTerminalReplay;
+    attachObserver(id: string): NativeTerminalObserverAttachment;
+    acquireController(id: string, controllerId: string): NativeTerminalControllerLease;
+    releaseController(lease: NativeTerminalControllerLease): NativeTerminalControllerState;
+    write(lease: NativeTerminalControllerLease, data: string): void;
+    resize(lease: NativeTerminalControllerLease, cols: number, rows: number): void;
+    stop(lease: NativeTerminalControllerLease, signal?: NativeTerminalStopSignal): NativeTerminalSessionState;
+    stopAll(signal?: NativeTerminalStopSignal): ReadonlyArray<NativeTerminalSessionState>;
+    forceStopAll(signal?: NativeTerminalStopSignal): ReadonlyArray<NativeTerminalSessionState>;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/native-terminal/host.d.ts.map

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