@simonepri/refined-antigravity-acp 0.2.0 → 1.0.0

package/dist/src/core/telemetry.js

@@ -0,0 +1,75 @@
+export const RAW_WS_MSG_MARKER = "RAW WS MSG:";
+export const TELEMETRY_STATES = {
+    WAITING_FOR_TASKS: "STATE_WAITING_FOR_TASKS",
+    FULLY_IDLE: "STATE_FULLY_IDLE",
+    IDLE: "STATE_IDLE",
+    RUNNING: "STATE_RUNNING",
+    COMPLETE: "STATE_COMPLETE",
+    ACTIVE: "STATE_ACTIVE",
+};
+export const TARGET_ENVIRONMENT = "TARGET_ENVIRONMENT";
+function extractJsonCandidate(line) {
+    const idx = line.indexOf(RAW_WS_MSG_MARKER);
+    if (idx !== -1) {
+        return line.slice(idx + RAW_WS_MSG_MARKER.length).trim();
+    }
+    const keyIdx = line.indexOf('"trajectoryStateUpdate"');
+    if (keyIdx === -1)
+        return null;
+    const braceIdx = line.lastIndexOf("{", keyIdx);
+    if (braceIdx === -1)
+        return null;
+    return line.slice(braceIdx).trim();
+}
+function tryParseJsonCandidate(candidate, parser) {
+    if (!candidate)
+        return null;
+    try {
+        return parser(JSON.parse(candidate));
+    }
+    catch {
+        const lastBrace = candidate.lastIndexOf("}");
+        if (lastBrace === -1)
+            return null;
+        try {
+            return parser(JSON.parse(candidate.slice(0, lastBrace + 1)));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function parseTsuObject(parsed) {
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    const tsu = parsed.trajectoryStateUpdate;
+    if (!tsu || typeof tsu !== "object")
+        return null;
+    const o = tsu;
+    if (typeof o.trajectoryId !== "string" || typeof o.state !== "string")
+        return null;
+    return { trajectoryId: o.trajectoryId, state: o.state };
+}
+export function parseTrajectoryStateUpdate(line) {
+    return tryParseJsonCandidate(extractJsonCandidate(line), parseTsuObject);
+}
+function parseStepUpdateObject(parsed) {
+    if (!parsed || typeof parsed !== "object")
+        return null;
+    const su = parsed.stepUpdate;
+    if (!su || typeof su !== "object")
+        return null;
+    const o = su;
+    if (typeof o.trajectoryId !== "string" || typeof o.state !== "string")
+        return null;
+    return {
+        trajectoryId: o.trajectoryId,
+        state: o.state,
+        target: typeof o.target === "string" ? o.target : undefined,
+        source: typeof o.source === "string" ? o.source : undefined,
+    };
+}
+export function parseStepUpdate(line) {
+    return tryParseJsonCandidate(extractJsonCandidate(line), parseStepUpdateObject);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/src/core/telemetry.js.map

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

package/dist/src/core/transport.d.ts

@@ -0,0 +1,7 @@
+import { type ChildProcess } from "node:child_process";
+import type { AcpStreamMessage } from "./types.js";
+import type { AcpPipeline } from "./pipeline.js";
+export declare function traceAcp(direction: "client->agy" | "agy->client", msg: AcpStreamMessage): void;
+export declare function defaultSpawnProcess(cmd: string, args: string[], pipeline?: AcpPipeline): ChildProcess;
+export declare function writeJsonMessage(child: ChildProcess, msg: AcpStreamMessage): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/src/core/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/core/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,wBAAgB,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAM9F;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,QAAQ,CAAC,EAAE,WAAW,GACrB,YAAY,CAed;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhG"}

package/dist/src/core/transport.js

@@ -0,0 +1,37 @@
+import { spawn } from "node:child_process";
+import { once } from "node:events";
+const ACP_TRACE_ENABLED = process.env.REFINED_AGY_TRACE === "1";
+export function traceAcp(direction, msg) {
+    if (!ACP_TRACE_ENABLED)
+        return;
+    const m = msg;
+    const id = m.id === undefined ? "-" : String(m.id);
+    const kind = m.method ? String(m.method) : m.error ? "error" : "result";
+    console.error(`[refined-antigravity-acp][acp] ${direction} id=${id} ${kind}`);
+}
+export function defaultSpawnProcess(cmd, args, pipeline) {
+    const env = {
+        ...process.env,
+        AGY_ACP_FORCE_FILE_STORAGE: "1",
+        BROWSER: "false",
+    };
+    if (pipeline) {
+        pipeline.applySpawn(env, cmd, args);
+    }
+    return spawn(cmd, args, {
+        stdio: ["pipe", "pipe", "pipe"],
+        env,
+    });
+}
+export async function writeJsonMessage(child, msg) {
+    const stdin = child.stdin;
+    if (!stdin || !stdin.writable) {
+        throw new Error("Child process stdin is not writable");
+    }
+    const payload = JSON.stringify(msg) + "\n";
+    const canContinue = stdin.write(payload);
+    if (!canContinue) {
+        await once(stdin, "drain");
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/src/core/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/core/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;AAEhE,MAAM,UAAU,QAAQ,CAAC,SAAwC,EAAE,GAAqB;IACtF,IAAI,CAAC,iBAAiB;QAAE,OAAO;IAC/B,MAAM,CAAC,GAAG,GAA0D,CAAC;IACrE,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxE,OAAO,CAAC,KAAK,CAAC,kCAAkC,SAAS,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,IAAc,EACd,QAAsB;IAEtB,MAAM,GAAG,GAAsB;QAC7B,GAAG,OAAO,CAAC,GAAG;QACd,0BAA0B,EAAE,GAAG;QAC/B,OAAO,EAAE,OAAO;KACjB,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;QACtB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAC/B,GAAG;KACJ,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAmB,EAAE,GAAqB;IAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/src/core/types.d.ts

@@ -0,0 +1,293 @@
+import type { ChildProcess } from "node:child_process";
+export declare const ACP_METHODS: {
+    readonly INITIALIZE: "initialize";
+    readonly AUTHENTICATE: "authenticate";
+    readonly LOGOUT: "logout";
+    readonly SESSION_NEW: "session/new";
+    readonly SESSION_LOAD: "session/load";
+    readonly SESSION_LIST: "session/list";
+    readonly SESSION_RESUME: "session/resume";
+    readonly SESSION_CLOSE: "session/close";
+    readonly SESSION_DELETE: "session/delete";
+    readonly SESSION_FORK: "session/fork";
+    readonly SESSION_PROMPT: "session/prompt";
+    readonly SESSION_SET_MODE: "session/set_mode";
+    readonly SESSION_SET_MODEL: "session/set_model";
+    readonly SESSION_SET_CONFIG_OPTION: "session/set_config_option";
+    readonly SESSION_CANCEL: "session/cancel";
+    readonly SESSION_UPDATE: "session/update";
+    readonly SESSION_REQUEST_PERMISSION: "session/request_permission";
+    readonly CANCEL_REQUEST: "$/cancel_request";
+};
+export declare const SESSION_UPDATES: {
+    readonly AGENT_MESSAGE_CHUNK: "agent_message_chunk";
+    readonly USER_MESSAGE_CHUNK: "user_message_chunk";
+    readonly AGENT_THOUGHT_CHUNK: "agent_thought_chunk";
+    readonly TOOL_CALL: "tool_call";
+    readonly TOOL_CALL_UPDATE: "tool_call_update";
+    readonly PLAN: "plan";
+    readonly PLAN_UPDATE: "plan_update";
+    readonly PLAN_REMOVED: "plan_removed";
+    readonly AVAILABLE_COMMANDS_UPDATE: "available_commands_update";
+    readonly CURRENT_MODE_UPDATE: "current_mode_update";
+    readonly CONFIG_OPTION_UPDATE: "config_option_update";
+    readonly SESSION_INFO_UPDATE: "session_info_update";
+    readonly USAGE_UPDATE: "usage_update";
+    readonly NOTICE: "notice";
+    readonly COMPACTION_UPDATE: "compaction_update";
+    readonly COMPACTION_SUMMARY_CHUNK: "compaction_summary_chunk";
+};
+export declare const STOP_REASONS: {
+    readonly END_TURN: "end_turn";
+    readonly CANCELLED: "cancelled";
+};
+/**
+ * Standard JSON-RPC 2.0 message variants in ACP
+ */
+export interface JsonRpcRequest<TMethod extends string = string, TParams = unknown> {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: TMethod;
+    params?: TParams;
+}
+export interface JsonRpcNotification<TMethod extends string = string, TParams = unknown> {
+    jsonrpc: "2.0";
+    method: TMethod;
+    params?: TParams;
+}
+export interface JsonRpcSuccessResponse<TResult = unknown> {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result: TResult;
+}
+export interface JsonRpcErrorObject {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface JsonRpcErrorResponse {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    error: JsonRpcErrorObject;
+}
+export type AcpStreamMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcSuccessResponse | JsonRpcErrorResponse;
+export declare function isJsonRpcRequest(msg: AcpStreamMessage): msg is JsonRpcRequest;
+export declare function isJsonRpcNotification(msg: AcpStreamMessage): msg is JsonRpcNotification;
+export declare function isJsonRpcSuccessResponse<T = unknown>(msg: AcpStreamMessage): msg is JsonRpcSuccessResponse<T>;
+export declare function isJsonRpcErrorResponse(msg: AcpStreamMessage): msg is JsonRpcErrorResponse;
+export declare function isMethod<M extends string>(msg: AcpStreamMessage, method: M): msg is (JsonRpcRequest<M> | JsonRpcNotification<M>) & {
+    method: M;
+};
+export interface AcpStream {
+    writable: WritableStream<AcpStreamMessage>;
+    readable: ReadableStream<AcpStreamMessage>;
+}
+export type AcpConnector = () => AcpStream | Promise<AcpStream>;
+export interface UrlRewriter {
+    rewriteUrl: (url: string) => Promise<string> | string;
+}
+export interface CachedConfigOption {
+    value: unknown;
+    type?: string | undefined;
+}
+export interface CachedSessionMetadata {
+    sessionId: string;
+    cwd?: string;
+    _meta?: unknown;
+    lastModeId?: string;
+    lastConfigOptions: Map<string, CachedConfigOption>;
+    needsRecycle?: boolean;
+    /** Fixes can store arbitrary session-scoped state here */
+    fixData?: Map<string, unknown>;
+}
+export declare function getFixData<T>(session: CachedSessionMetadata | undefined, key: string): T | undefined;
+export declare function setFixData<T>(session: CachedSessionMetadata, key: string, value: T): void;
+export declare function getOrCreateFixData<T>(session: CachedSessionMetadata, key: string, factory: () => T): T;
+export interface SessionCache {
+    sessions: Map<string, CachedSessionMetadata>;
+    pendingSessionMetadata: Map<string | number, Partial<CachedSessionMetadata>>;
+    /** Session a pending request's response belongs to, by request id. */
+    pendingRequestSessions: Map<string | number, string>;
+    cachedInitializeParams?: unknown;
+}
+export interface CoreContext {
+    sessionCache: SessionCache;
+    proxies?: UrlRewriter | undefined;
+    forwardInbound: (msg: AcpStreamMessage) => void;
+    writeToChild: (msg: AcpStreamMessage) => Promise<void>;
+    sendInternalRequest: (msg: AcpStreamMessage, timeoutMs?: number | undefined) => Promise<AcpStreamMessage>;
+    triggerRecycle: (session: CachedSessionMetadata) => Promise<void>;
+    declareHang: (sessionId: string, promptId: string | number, reason: string) => void;
+}
+export interface OutboundContext extends CoreContext {
+    session?: CachedSessionMetadata | undefined;
+    fixes?: readonly AcpFix[] | undefined;
+}
+export interface InboundContext extends CoreContext {
+    session?: CachedSessionMetadata | undefined;
+    isRecycling?: boolean | undefined;
+}
+export interface StderrContext extends CoreContext {
+    session?: CachedSessionMetadata | undefined;
+}
+/**
+ * Interface that each hardening fix implements.
+ * To add a fix, implement this interface and add to active fixes list.
+ * To remove a fix, delete the file and remove from active fixes list.
+ */
+export interface AcpFix {
+    /** Unique name of the fix matching the Readme issue (e.g. "flattened-model-efforts") */
+    readonly name: string;
+    /** Optional human-readable description */
+    readonly description?: string;
+    /** Hook called during child process spawning to modify environment or command */
+    onSpawn?: (env: NodeJS.ProcessEnv, cmd: string, args: string[]) => void;
+    /**
+     * Intercept or modify an outbound message from the client before it is written to the child process.
+     * Return null or undefined to drop the message.
+     */
+    onOutbound?: (msg: AcpStreamMessage, context: OutboundContext) => Promise<AcpStreamMessage | null | undefined> | AcpStreamMessage | null | undefined;
+    /**
+     * Intercept or modify an inbound message from the child process before it reaches the client.
+     * Return an array of messages (empty to drop, multiple to expand).
+     */
+    onInbound?: (msg: AcpStreamMessage, context: InboundContext) => Promise<AcpStreamMessage[]> | AcpStreamMessage[];
+    /**
+     * Hook called when a turn completes (e.g. response with result arrived),
+     * allowing fixes to flush buffered items or emit synthesized end chunks.
+     */
+    onTurnEnd?: (sessionId: string, context: InboundContext) => AcpStreamMessage[];
+    /**
+     * Intercept a line of stderr output from the child process.
+     * Return true to suppress/drop the line from stderr.
+     */
+    onStderrLine?: (line: string, context: StderrContext) => boolean;
+    /**
+     * Hook called when a child process is recycled to resynchronize fix state.
+     */
+    onRecycle?: (session: CachedSessionMetadata, newChild: ChildProcess, context: CoreContext) => Promise<void> | void;
+    /**
+     * Optional hook allowing a fix to contribute domain-specific system instructions or guidelines
+     * (e.g. formatting requirements, steering behavior) to the session prompt.
+     */
+    getSystemInstructions?: (session?: CachedSessionMetadata, context?: OutboundContext) => readonly string[] | undefined;
+    /** Clean up timers, locks, or resources when the connector closes */
+    dispose?: () => void;
+}
+/**
+ * Structured ACP protocol payloads
+ */
+export interface McpServerConfig {
+    name: string;
+    type?: string;
+    url?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    headers?: unknown;
+}
+export interface PromptContentItem {
+    type: string;
+    text?: string;
+    data?: unknown;
+    [key: string]: unknown;
+}
+export interface SessionPlanEntry {
+    content: string;
+    priority: "high" | "medium" | "low";
+    status: "pending" | "in_progress" | "completed";
+}
+export interface InitializeParams {
+    protocolVersion: number;
+    clientCapabilities?: Record<string, unknown>;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+    [key: string]: unknown;
+}
+export interface SessionNewParams {
+    cwd?: string;
+    modeId?: string;
+    _meta?: unknown;
+    mcpServers?: McpServerConfig[];
+    [key: string]: unknown;
+}
+export interface SessionLoadParams {
+    sessionId: string;
+    cwd?: string;
+    modeId?: string;
+    _meta?: unknown;
+    mcpServers?: McpServerConfig[];
+    [key: string]: unknown;
+}
+export interface SessionSetModeParams {
+    sessionId: string;
+    modeId: string;
+    [key: string]: unknown;
+}
+export interface SessionSetConfigOptionParams {
+    sessionId: string;
+    configId: string;
+    value: unknown;
+    type?: string;
+    [key: string]: unknown;
+}
+export interface SessionPromptParams {
+    sessionId: string;
+    prompt: string | PromptContentItem[];
+    [key: string]: unknown;
+}
+export interface SessionCancelParams {
+    sessionId: string;
+    [key: string]: unknown;
+}
+export interface TextContentBlock {
+    type: "text";
+    text: string;
+}
+export interface SessionUpdatePayload {
+    sessionUpdate?: string;
+    content?: TextContentBlock | TextContentBlock[] | {
+        type?: string;
+        text?: string;
+    } | Array<{
+        type?: string;
+        text?: string;
+    }> | unknown[] | null;
+    toolCallId?: string;
+    name?: string | null;
+    title?: string | null;
+    kind?: string | null;
+    status?: string | null;
+    rawInput?: unknown;
+    arguments?: unknown;
+    entries?: SessionPlanEntry[];
+    availableCommands?: Array<{
+        name: string;
+        description: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface SessionUpdateParams {
+    sessionId: string;
+    update: SessionUpdatePayload;
+    [key: string]: unknown;
+}
+export interface SessionAllocationResult {
+    sessionId: string;
+    [key: string]: unknown;
+}
+export interface SessionPromptResult {
+    stopReason?: string;
+    [key: string]: unknown;
+}
+export type InitializeRequest = JsonRpcRequest<"initialize", InitializeParams>;
+export type SessionNewRequest = JsonRpcRequest<"session/new", SessionNewParams>;
+export type SessionLoadRequest = JsonRpcRequest<"session/load", SessionLoadParams>;
+export type SessionPromptRequest = JsonRpcRequest<"session/prompt", SessionPromptParams>;
+export type SessionSetModeRequest = JsonRpcRequest<"session/set_mode", SessionSetModeParams>;
+export type SessionSetConfigOptionRequest = JsonRpcRequest<"session/set_config_option", SessionSetConfigOptionParams>;
+export type SessionCancelNotification = JsonRpcNotification<"session/cancel", SessionCancelParams>;
+export type SessionUpdateNotification = JsonRpcNotification<"session/update", SessionUpdateParams>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/types.d.ts.map

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

package/dist/src/core/types.js

@@ -0,0 +1,78 @@
+export const ACP_METHODS = {
+    INITIALIZE: "initialize",
+    AUTHENTICATE: "authenticate",
+    LOGOUT: "logout",
+    SESSION_NEW: "session/new",
+    SESSION_LOAD: "session/load",
+    SESSION_LIST: "session/list",
+    SESSION_RESUME: "session/resume",
+    SESSION_CLOSE: "session/close",
+    SESSION_DELETE: "session/delete",
+    SESSION_FORK: "session/fork",
+    SESSION_PROMPT: "session/prompt",
+    SESSION_SET_MODE: "session/set_mode",
+    SESSION_SET_MODEL: "session/set_model",
+    SESSION_SET_CONFIG_OPTION: "session/set_config_option",
+    SESSION_CANCEL: "session/cancel",
+    SESSION_UPDATE: "session/update",
+    SESSION_REQUEST_PERMISSION: "session/request_permission",
+    CANCEL_REQUEST: "$/cancel_request",
+};
+export const SESSION_UPDATES = {
+    AGENT_MESSAGE_CHUNK: "agent_message_chunk",
+    USER_MESSAGE_CHUNK: "user_message_chunk",
+    AGENT_THOUGHT_CHUNK: "agent_thought_chunk",
+    TOOL_CALL: "tool_call",
+    TOOL_CALL_UPDATE: "tool_call_update",
+    PLAN: "plan",
+    PLAN_UPDATE: "plan_update",
+    PLAN_REMOVED: "plan_removed",
+    AVAILABLE_COMMANDS_UPDATE: "available_commands_update",
+    CURRENT_MODE_UPDATE: "current_mode_update",
+    CONFIG_OPTION_UPDATE: "config_option_update",
+    SESSION_INFO_UPDATE: "session_info_update",
+    USAGE_UPDATE: "usage_update",
+    NOTICE: "notice",
+    COMPACTION_UPDATE: "compaction_update",
+    COMPACTION_SUMMARY_CHUNK: "compaction_summary_chunk",
+};
+export const STOP_REASONS = {
+    END_TURN: "end_turn",
+    CANCELLED: "cancelled",
+};
+export function isJsonRpcRequest(msg) {
+    return "method" in msg && "id" in msg && msg.id !== null && msg.id !== undefined;
+}
+export function isJsonRpcNotification(msg) {
+    return "method" in msg && !("id" in msg);
+}
+export function isJsonRpcSuccessResponse(msg) {
+    return "result" in msg && "id" in msg;
+}
+export function isJsonRpcErrorResponse(msg) {
+    return "error" in msg && "id" in msg && typeof msg.error === "object" && msg.error !== null;
+}
+export function isMethod(msg, method) {
+    return "method" in msg && msg.method === method;
+}
+export function getFixData(session, key) {
+    return session?.fixData?.get(key);
+}
+export function setFixData(session, key, value) {
+    if (!session.fixData) {
+        session.fixData = new Map();
+    }
+    session.fixData.set(key, value);
+}
+export function getOrCreateFixData(session, key, factory) {
+    if (!session.fixData) {
+        session.fixData = new Map();
+    }
+    let data = session.fixData.get(key);
+    if (data === undefined) {
+        data = factory();
+        session.fixData.set(key, data);
+    }
+    return data;
+}
+//# sourceMappingURL=types.js.map

package/dist/src/core/types.js.map

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

package/dist/src/fixes/active-turn-collision/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Problem:
+ * Sending a prompt request while an upstream agent turn is in progress (e.g. executing tool calls)
+ * is rejected with a fatal error: `"A foreground turn is already active"`.
+ *
+ * Solution:
+ * Queues in-flight user steering directives, classifies mid-turn inputs, and retries
+ * rejected prompt requests once the active turn transitions to idle.
+ */
+import { type AcpFix } from "../../core/types.js";
+export declare function stripSteeringPrefix(text: string): string;
+export declare const FOREGROUND_TURN_ERROR_PATTERN: RegExp;
+export declare const DONE_CH_ERROR_PATTERN: RegExp;
+export declare const MAX_PROMPT_RETRIES = 5;
+export declare const DEFAULT_PROMPT_RETRY_DELAY_MS = 500;
+export interface UserSteeringOptions {
+    delayMs?: number;
+    maxRetries?: number;
+}
+export declare const USER_STEERING_INSTRUCTIONS: readonly string[];
+export declare function createActiveTurnCollisionFix(options?: UserSteeringOptions): AcpFix;
+export declare const activeTurnCollisionFix: AcpFix;
+export declare const createUserSteeringFix: typeof createActiveTurnCollisionFix;
+export declare const userSteeringFix: AcpFix;
+export declare const createPromptRetryFix: typeof createActiveTurnCollisionFix;
+export declare const promptRetryFix: AcpFix;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/fixes/active-turn-collision/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/fixes/active-turn-collision/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,MAAM,EAEZ,MAAM,qBAAqB,CAAC;AAU7B,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,eAAO,MAAM,6BAA6B,QAAuC,CAAC;AAClF,eAAO,MAAM,qBAAqB,QAAwC,CAAC;AAC3E,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAwDD,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAEvD,CAAC;AAEF,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAwDlF;AAED,eAAO,MAAM,sBAAsB,QAAiC,CAAC;AACrE,eAAO,MAAM,qBAAqB,qCAA+B,CAAC;AAClE,eAAO,MAAM,eAAe,QAAyB,CAAC;AACtD,eAAO,MAAM,oBAAoB,qCAA+B,CAAC;AACjE,eAAO,MAAM,cAAc,QAAyB,CAAC"}