qlogicagent 2.3.0 → 2.4.0

package/dist/types/protocol/wire/acp-protocol.d.ts

@@ -0,0 +1,411 @@
+export declare const ACP_PROTOCOL_VERSION: 1;
+export declare const ACP_METHODS: {
+    readonly INITIALIZE: "initialize";
+    readonly SESSION_NEW: "session/new";
+    readonly SESSION_PROMPT: "session/prompt";
+    readonly SESSION_END: "session/end";
+    readonly SESSION_SET_CONFIG: "session/set_config_option";
+    readonly SESSION_SET_MODEL: "session/set_model";
+    readonly SESSION_SET_MODE: "session/set_mode";
+    readonly SESSION_UPDATE: "session/update";
+    readonly SESSION_REQUEST_PERMISSION: "session/request_permission";
+    readonly FS_READ_TEXT_FILE: "fs/read_text_file";
+    readonly FS_WRITE_TEXT_FILE: "fs/write_text_file";
+};
+export type AcpStandardMethod = (typeof ACP_METHODS)[keyof typeof ACP_METHODS];
+export declare const ACP_EXTENDED_METHODS: {
+    readonly ABORT: "x/abort";
+    readonly DREAM: "x/dream";
+    readonly AGENTS_LIST: "x/agents.list";
+    readonly SOLO_START: "x/solo.start";
+    readonly SOLO_STATUS: "x/solo.status";
+    readonly SOLO_SELECT: "x/solo.select";
+    readonly SOLO_CANCEL: "x/solo.cancel";
+    readonly PRODUCT_CREATE: "x/product.create";
+    readonly PRODUCT_RESUME: "x/product.resume";
+    readonly PRODUCT_PAUSE: "x/product.pause";
+    readonly PRODUCT_CANCEL: "x/product.cancel";
+    readonly PRODUCT_ROLLBACK: "x/product.rollback";
+    readonly PRODUCT_STATUS: "x/product.status";
+    readonly SOLO_SUBSCRIBE: "x/solo.subscribe";
+    readonly PRODUCT_SUBSCRIBE: "x/product.subscribe";
+    readonly TEAM_DELEGATE: "x/team.delegate";
+};
+export type AcpExtendedMethod = (typeof ACP_EXTENDED_METHODS)[keyof typeof ACP_EXTENDED_METHODS];
+export interface AcpHostCapabilities {
+    /** Host supports x_ extended sessionUpdate types */
+    extendedEvents?: boolean;
+    /** Host supports tool approval flow (session/request_permission) */
+    toolApproval?: boolean;
+    /** Host supports filesystem operations (fs/*) */
+    filesystem?: boolean;
+    /** Host supports x/ extended RPC methods */
+    extendedMethods?: boolean;
+}
+export interface AcpAgentCapabilities {
+    /** Agent supports x_ extended sessionUpdate types */
+    extendedEvents?: boolean;
+    /** Agent supports x/ extended RPC methods */
+    extendedMethods?: boolean;
+    /** Agent supports multi-agent orchestration (solo/product/team) */
+    orchestration?: boolean;
+    /** Supported config options */
+    configOptions?: AcpConfigOptionDescriptor[];
+}
+export interface AcpConfigOptionDescriptor {
+    name: string;
+    type: "string" | "boolean" | "number" | "enum";
+    values?: string[];
+    description?: string;
+}
+export interface AcpInitializeParams {
+    protocolVersion: number | string;
+    clientInfo?: {
+        name: string;
+        version: string;
+    };
+    clientCapabilities?: AcpHostCapabilities;
+}
+export interface AcpInitializeResult {
+    protocolVersion: number;
+    agentInfo: {
+        name: string;
+        version: string;
+    };
+    agentCapabilities?: AcpAgentCapabilities;
+}
+export interface AcpSessionNewParams {
+    /** Working directory for the session (standard ACP field from host). */
+    cwd?: string;
+    /** MCP servers to inject into this session. */
+    mcpServers?: Array<{
+        name: string;
+        uri?: string;
+        command?: string;
+        args?: string[];
+    }>;
+    /** Optional session ID (host-assigned). If omitted, agent generates one. */
+    sessionId?: string;
+    /** Resume: fork an existing session into a new one */
+    resumeSessionId?: string;
+    forkSession?: boolean;
+}
+export interface AcpSessionNewResult {
+    sessionId: string;
+}
+export interface AcpSessionPromptParams {
+    sessionId: string;
+    /** User prompt content blocks (standard ACP field). */
+    prompt: AcpContentBlock[];
+    /** Optional attached context */
+    context?: AcpContextItem[];
+}
+export interface AcpSessionPromptResult {
+    /** Stop reason (required by ACP standard). */
+    stopReason: AcpStopReason;
+    /** Token usage for this turn */
+    usage?: AcpUsage;
+}
+export interface AcpSessionEndParams {
+    sessionId: string;
+}
+export interface AcpSessionSetConfigParams {
+    sessionId: string;
+    option: string;
+    value: unknown;
+}
+export type AcpContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    url: string;
+    mimeType?: string;
+} | {
+    type: "file";
+    path: string;
+    content?: string;
+};
+export interface AcpContextItem {
+    type: "file" | "url" | "text";
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * The `session/update` notification params.
+ * Standard format: { sessionId, update: { sessionUpdate: "<type>", ...payload } }
+ */
+export interface AcpSessionUpdateNotification {
+    sessionId: string;
+    update: {
+        sessionUpdate: AcpSessionUpdateType;
+        [key: string]: unknown;
+    };
+}
+export declare const ACP_SESSION_UPDATE_TYPES: {
+    readonly AGENT_MESSAGE_CHUNK: "agent_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 USAGE_UPDATE: "usage_update";
+    readonly CONFIG_OPTION_UPDATE: "config_option_update";
+    readonly SESSION_INFO_UPDATE: "session_info_update";
+    readonly AVAILABLE_COMMANDS_UPDATE: "available_commands_update";
+};
+export type AcpStandardSessionUpdateType = (typeof ACP_SESSION_UPDATE_TYPES)[keyof typeof ACP_SESSION_UPDATE_TYPES];
+export declare const ACP_EXTENDED_SESSION_UPDATE_TYPES: {
+    readonly X_SUBAGENT_STARTED: "x_subagent_started";
+    readonly X_SUBAGENT_DELTA: "x_subagent_delta";
+    readonly X_SUBAGENT_ENDED: "x_subagent_ended";
+    readonly X_MEDIA_RESULT: "x_media_result";
+    readonly X_MEDIA_PROGRESS: "x_media_progress";
+    readonly X_SKILL_INSTRUCTION: "x_skill_instruction";
+    readonly X_RECOVERY: "x_recovery";
+    readonly X_SIDECHAIN_STARTED: "x_sidechain_started";
+    readonly X_SIDECHAIN_COMPLETED: "x_sidechain_completed";
+    readonly X_SUGGESTIONS: "x_suggestions";
+    readonly X_ASK_USER: "x_ask_user";
+    readonly X_SESSION_INFO: "x_session_info";
+    readonly X_MEMORY_UPDATED: "x_memory_updated";
+    readonly X_TEAM_MEMBER_UPDATE: "x_team_member_update";
+    readonly X_SOLO_STARTED: "x_solo_started";
+    readonly X_SOLO_AGENT_FINISHED: "x_solo_agent_finished";
+    readonly X_SOLO_SELECTED: "x_solo_selected";
+    readonly X_PRODUCT_TASK_STARTED: "x_product_task_started";
+    readonly X_PRODUCT_TASK_COMPLETED: "x_product_task_completed";
+    readonly X_PRODUCT_CHECKPOINT: "x_product_checkpoint";
+};
+export type AcpExtendedSessionUpdateType = (typeof ACP_EXTENDED_SESSION_UPDATE_TYPES)[keyof typeof ACP_EXTENDED_SESSION_UPDATE_TYPES];
+export type AcpSessionUpdateType = AcpStandardSessionUpdateType | AcpExtendedSessionUpdateType;
+export interface AcpAgentMessageChunkPayload {
+    text: string;
+}
+export interface AcpAgentThoughtChunkPayload {
+    text: string;
+}
+export interface AcpToolCallPayload {
+    callId: string;
+    toolName: string;
+    arguments: string;
+    /** Whether the tool call is streaming (partial arguments) */
+    streaming?: boolean;
+}
+export interface AcpToolCallUpdatePayload {
+    callId: string;
+    toolName: string;
+    /** Tool execution result (text) */
+    result?: string;
+    /** Tool execution error */
+    error?: string;
+    /** Whether the tool call was approved and executed */
+    status: "completed" | "failed" | "rejected";
+}
+export interface AcpPlanPayload {
+    steps: Array<{
+        description: string;
+        status: "pending" | "in_progress" | "done" | "skipped";
+    }>;
+}
+export interface AcpUsageUpdatePayload {
+    usage: AcpUsage;
+}
+export interface AcpConfigOptionUpdatePayload {
+    option: string;
+    value: unknown;
+}
+export interface AcpEndTurnPayload {
+    stopReason: AcpStopReason;
+    usage?: AcpUsage;
+}
+export interface AcpAvailableCommandsUpdatePayload {
+    commands: Array<{
+        name: string;
+        description?: string;
+    }>;
+}
+export interface AcpXSubagentStartedPayload {
+    agentId: string;
+    agentName: string;
+    task?: string;
+}
+export interface AcpXSubagentDeltaPayload {
+    agentId: string;
+    text?: string;
+    toolCall?: {
+        callId: string;
+        toolName: string;
+        arguments: string;
+    };
+    toolResult?: {
+        callId: string;
+        result: string;
+        status: "completed" | "failed";
+    };
+}
+export interface AcpXSubagentEndedPayload {
+    agentId: string;
+    result?: string;
+    usage?: AcpUsage;
+}
+export interface AcpXMediaResultPayload {
+    mediaId: string;
+    type: "image" | "video" | "audio";
+    url: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AcpXMediaProgressPayload {
+    mediaId: string;
+    progress: number;
+    stage?: string;
+}
+export interface AcpXSkillInstructionPayload {
+    skillId: string;
+    instruction: string;
+}
+export interface AcpXRecoveryPayload {
+    errorType: string;
+    message: string;
+    action: "retry" | "skip" | "fallback";
+}
+export interface AcpXSidechainStartedPayload {
+    chainId: string;
+    purpose: string;
+}
+export interface AcpXSidechainCompletedPayload {
+    chainId: string;
+    result?: string;
+}
+export interface AcpXSuggestionsPayload {
+    suggestions: string[];
+}
+export interface AcpXAskUserPayload {
+    question: string;
+    options?: string[];
+}
+export interface AcpXSessionInfoPayload {
+    sessionId: string;
+    model?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AcpXMemoryUpdatedPayload {
+    memoryId: string;
+    action: "created" | "updated" | "deleted";
+    summary?: string;
+}
+export interface AcpXTeamMemberUpdatePayload {
+    memberId: string;
+    /** The original ACP session/update from the external agent */
+    type: AcpSessionUpdateType;
+    payload: Record<string, unknown>;
+}
+export interface AcpXSoloStartedPayload {
+    evaluationId: string;
+    agents: string[];
+    task: string;
+}
+export interface AcpXSoloAgentFinishedPayload {
+    evaluationId: string;
+    agentId: string;
+    result?: string;
+    usage?: AcpUsage;
+}
+export interface AcpXSoloSelectedPayload {
+    evaluationId: string;
+    winnerId: string;
+    reason?: string;
+}
+export interface AcpXProductTaskStartedPayload {
+    workflowId: string;
+    taskId: string;
+    agentId: string;
+    description?: string;
+}
+export interface AcpXProductTaskCompletedPayload {
+    workflowId: string;
+    taskId: string;
+    agentId: string;
+    result?: string;
+    status: "completed" | "failed";
+}
+export interface AcpXProductCheckpointPayload {
+    workflowId: string;
+    checkpointId: string;
+    completedTasks: string[];
+}
+export interface AcpPermissionRequestParams {
+    sessionId: string;
+    permissionId: string;
+    toolCall: {
+        callId: string;
+        toolName: string;
+        arguments: string;
+    };
+    message?: string;
+    options: AcpPermissionOption[];
+}
+export interface AcpPermissionOption {
+    id: string;
+    label: string;
+    /** Whether this option grants persistent permission */
+    persistent?: boolean;
+}
+export interface AcpPermissionRequestResult {
+    optionId: string;
+}
+export interface AcpFsReadTextFileParams {
+    path: string;
+    startLine?: number;
+    endLine?: number;
+}
+export interface AcpFsReadTextFileResult {
+    content: string;
+    totalLines: number;
+}
+export interface AcpFsWriteTextFileParams {
+    path: string;
+    content: string;
+    createDirectories?: boolean;
+}
+export interface AcpFsWriteTextFileResult {
+    bytesWritten: number;
+}
+export interface AcpUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    totalCost?: number;
+}
+export type AcpStopReason = "end_turn" | "max_tokens" | "max_turn_requests" | "refusal" | "cancelled";
+export interface AcpJsonRpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+    id: string | number;
+}
+export interface AcpJsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface AcpJsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: unknown;
+    error?: AcpJsonRpcError;
+}
+export interface AcpJsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export type AcpJsonRpcMessage = AcpJsonRpcRequest | AcpJsonRpcResponse | AcpJsonRpcNotification;
+export declare function isAcpJsonRpcRequest(msg: unknown): msg is AcpJsonRpcRequest;
+export declare function isAcpJsonRpcNotification(msg: unknown): msg is AcpJsonRpcNotification;
+export declare function isAcpJsonRpcResponse(msg: unknown): msg is AcpJsonRpcResponse;
+export declare function parseAcpMessage(raw: string): AcpJsonRpcMessage | null;
+/** Check if a sessionUpdate type is a standard ACP v1 type */
+export declare function isStandardSessionUpdateType(type: string): type is AcpStandardSessionUpdateType;
+/** Check if a sessionUpdate type is an x_ extended type */
+export declare function isExtendedSessionUpdateType(type: string): type is AcpExtendedSessionUpdateType;

package/dist/types/protocol/wire/agent-events.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Agent Notification Event Names — shared between Agent and Gateway.
+ *
+ * Single source of truth for which agent notifications should be
+ * relayed to WebSocket clients. Adding a new event = add ONE line here.
+ *
+ * Design: Gateway's generic relay uses this list as its whitelist.
+ * Agent's protocol/notifications.ts defines the full payload types.
+ * This file is the bridge that keeps both sides in sync with zero
+ * manual string matching.
+ */
+/**
+ * Turn-lifecycle events relayed to the Control UI WebSocket.
+ * These are the "chat session" events that every UI client needs.
+ */
+export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_delta", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.usage_update", "team.member.notification", "session.info", "memory.updated"];
+/**
+ * Agent Team events (Solo Mode, Product Mode, Plan lifecycle).
+ * Relayed to the UI's team/orchestration panel.
+ */
+export declare const AGENT_TEAM_WS_EVENT_NAMES: readonly ["solo.progress", "solo.agentDelta", "solo.agentUsage", "solo.agentDiff", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.checkpointed", "product.dagTopology", "plan.interrupted"];
+/**
+ * All agent notifications that Gateway should relay to WS clients.
+ * Union of session events + team events.
+ */
+export declare const ALL_AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_delta", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "solo.progress", "solo.agentDelta", "solo.agentUsage", "solo.agentDiff", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.checkpointed", "product.dagTopology", "plan.interrupted"];
+/** Type-level event name for session events. */
+export type AgentWsEventName = (typeof AGENT_WS_EVENT_NAMES)[number];
+/** Type-level event name for team events. */
+export type AgentTeamWsEventName = (typeof AGENT_TEAM_WS_EVENT_NAMES)[number];
+/** Type-level event name for all relayed events. */
+export type AllAgentWsEventName = (typeof ALL_AGENT_WS_EVENT_NAMES)[number];