qlogicagent 2.3.0 → 2.4.0

package/dist/types/protocol/wire/execution.d.ts

@@ -0,0 +1,391 @@
+import type { AgentExecutionRefs, AgentExecutionSource, AgentAttemptSource, AgentSidechainType, AgentSidechainRole, AgentSidechainMergePolicy, AgentExecutionSessionStatus, ProxyKeySource, ProxyQuotaSource, TransportResponsePayload, TransportUsageInfo, TransportBillingInfo, ControlApprovalDecision, ControlApprovalSource, ExecutionInterruptReason, ExecutionResumeSource, ExecutionCancelReason } from "./transport.js";
+import type { ModelSelectionReason } from "./session.js";
+import type { TransportCapabilitySummaryContract, TransportApprovalRequiredToolHintEntry, TransportToolEligibilitySummaryEntry, ToolExecutionStepContext } from "./capability-transport.js";
+export interface AgentExecutionRouteInfo {
+    requestedModel?: string;
+    resolvedModel?: string;
+    modelSelectionReason?: ModelSelectionReason;
+    aliasId?: string;
+    provider?: string;
+    model?: string;
+    tier?: string;
+    keySource?: ProxyKeySource;
+    quotaSource?: ProxyQuotaSource;
+}
+export interface AgentExecutionStartedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    source: AgentExecutionSource;
+    capabilitySnapshotVersion?: string;
+    capabilitySummary?: TransportCapabilitySummaryContract;
+    approvalRequiredToolHint?: TransportApprovalRequiredToolHintEntry[];
+    eligibleToolSummary?: TransportToolEligibilitySummaryEntry[];
+    ineligibleToolSummary?: TransportToolEligibilitySummaryEntry[];
+}
+export interface AgentExecutionStartedMsg {
+    type: "agent.execution.started";
+    id: string;
+    payload: AgentExecutionStartedPayload;
+}
+export interface AgentExecutionCompletedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    outcomeId: string;
+    finalAttemptId?: string;
+    resolvedModel?: string;
+    modelSelectionReason?: ModelSelectionReason;
+    routeExplainSummary?: string;
+    response?: TransportResponsePayload;
+    usage?: TransportUsageInfo;
+    billed?: TransportBillingInfo | null;
+}
+export interface AgentExecutionCompletedMsg {
+    type: "agent.execution.completed";
+    id: string;
+    payload: AgentExecutionCompletedPayload;
+}
+export interface AgentExecutionFailedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    outcomeId: string;
+    failedAttemptId?: string;
+    code: string;
+    error: string;
+    retryable: boolean;
+    terminal?: boolean;
+}
+export interface AgentExecutionFailedMsg {
+    type: "agent.execution.failed";
+    id: string;
+    payload: AgentExecutionFailedPayload;
+}
+export interface AgentAttemptStartedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    attemptId: string;
+    attemptIndex: number;
+    source: AgentAttemptSource;
+    route?: AgentExecutionRouteInfo;
+}
+export interface AgentAttemptStartedMsg {
+    type: "agent.attempt.started";
+    id: string;
+    payload: AgentAttemptStartedPayload;
+}
+export interface AgentAttemptCompletedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    attemptId: string;
+    outcomeId: string;
+    response?: TransportResponsePayload;
+    usage?: TransportUsageInfo;
+    route?: AgentExecutionRouteInfo;
+}
+export interface AgentAttemptCompletedMsg {
+    type: "agent.attempt.completed";
+    id: string;
+    payload: AgentAttemptCompletedPayload;
+}
+export interface AgentAttemptFailedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    attemptId: string;
+    outcomeId: string;
+    route?: AgentExecutionRouteInfo;
+    code: string;
+    error: string;
+    retryable: boolean;
+}
+export interface AgentAttemptFailedMsg {
+    type: "agent.attempt.failed";
+    id: string;
+    payload: AgentAttemptFailedPayload;
+}
+export type AgentSidechainToolAccessDecision = "allowed" | "denied";
+export type AgentSidechainToolAccessInheritance = "inherit" | "shrink";
+export type AgentSidechainToolAccessReason = "default-allow" | "always-deny" | "leaf-deny";
+export interface AgentSidechainToolAccessRule {
+    toolName: string;
+    decision: AgentSidechainToolAccessDecision;
+    inheritance: AgentSidechainToolAccessInheritance;
+    reason: AgentSidechainToolAccessReason;
+}
+export interface AgentSidechainToolAccess {
+    deniedTools: string[];
+    canSpawnChildren: boolean;
+    defaultDecision: "allowed";
+    defaultInheritance: "inherit";
+    tools: AgentSidechainToolAccessRule[];
+}
+export interface AgentSidechainStartedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    parentExecutionId: string;
+    sidechainId: string;
+    sidechainType: AgentSidechainType;
+    role: AgentSidechainRole;
+    toolAccess?: AgentSidechainToolAccess;
+    mergePolicy?: AgentSidechainMergePolicy;
+    trigger?: "planner" | "tool-result" | "repair-policy" | "user-followup";
+}
+export interface AgentSidechainStartedMsg {
+    type: "agent.sidechain.started";
+    id: string;
+    payload: AgentSidechainStartedPayload;
+}
+export interface AgentSidechainCompletedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    parentExecutionId: string;
+    sidechainId: string;
+    outcomeId: string;
+    summary?: string;
+    usage?: TransportUsageInfo;
+}
+export interface AgentSidechainCompletedMsg {
+    type: "agent.sidechain.completed";
+    id: string;
+    payload: AgentSidechainCompletedPayload;
+}
+export interface AgentSidechainFailedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    parentExecutionId: string;
+    sidechainId: string;
+    outcomeId: string;
+    code: string;
+    error: string;
+    retryable: boolean;
+}
+export interface AgentSidechainFailedMsg {
+    type: "agent.sidechain.failed";
+    id: string;
+    payload: AgentSidechainFailedPayload;
+}
+export interface AgentSidechainCancelRequestPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    sidechainId: string;
+    requestedAtMs: number;
+    reason?: string;
+}
+export interface AgentSidechainCancelRequestMsg {
+    type: "agent.sidechain.cancel.request";
+    id: string;
+    payload: AgentSidechainCancelRequestPayload;
+}
+export interface AgentSidechainCancelAckPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    sidechainId: string;
+    accepted: boolean;
+    cancelledAtMs: number;
+    reason?: string;
+}
+export interface AgentSidechainCancelAckMsg {
+    type: "agent.sidechain.cancel.ack";
+    id: string;
+    payload: AgentSidechainCancelAckPayload;
+}
+export interface ControlApprovalRequestedPayload extends AgentExecutionRefs, ToolExecutionStepContext {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    approvalId: string;
+    callId?: string;
+    toolName?: string;
+    reason?: string;
+    createdAtMs: number;
+    expiresAtMs: number;
+    policyScope?: "tool" | "workspace" | "session";
+}
+export interface ControlApprovalRequestedMsg {
+    type: "control.approval.requested";
+    id: string;
+    payload: ControlApprovalRequestedPayload;
+}
+export interface ControlApprovalRespondedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    approvalId: string;
+    callId?: string;
+    decision: ControlApprovalDecision;
+    source: ControlApprovalSource;
+    respondedAtMs: number;
+    note?: string;
+}
+export interface ControlApprovalRespondedMsg {
+    type: "control.approval.responded";
+    id: string;
+    payload: ControlApprovalRespondedPayload;
+}
+export interface ExecutionInterruptedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    reason: ExecutionInterruptReason;
+    interruptedAtMs: number;
+    resumable: boolean;
+    callId?: string;
+    approvalId?: string;
+}
+export interface ExecutionInterruptedMsg {
+    type: "execution.interrupted";
+    id: string;
+    payload: ExecutionInterruptedPayload;
+}
+export interface ExecutionResumedPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    source: ExecutionResumeSource;
+    resumedAtMs: number;
+    fromEventId?: string;
+}
+export interface ExecutionResumedMsg {
+    type: "execution.resumed";
+    id: string;
+    payload: ExecutionResumedPayload;
+}
+export interface ExecutionCancelledPayload extends AgentExecutionRefs {
+    sessionId: string;
+    turnId: string;
+    executionId: string;
+    reason: ExecutionCancelReason;
+    cancelledAtMs: number;
+    callId?: string;
+    approvalId?: string;
+}
+export interface ExecutionCancelledMsg {
+    type: "execution.cancelled";
+    id: string;
+    payload: ExecutionCancelledPayload;
+}
+export interface AgentExecutionSessionSnapshot {
+    requestId: string;
+    resumeToken: string;
+    createdAt: string;
+    leaseExpiresAt: string;
+    executionId: string | null;
+    rootExecutionId: string | null;
+    parentExecutionId?: string | null;
+    sidechainId?: string | null;
+    attemptId?: string | null;
+    sessionId: string | null;
+    turnId: string | null;
+    status: AgentExecutionSessionStatus;
+    lastEventAt: string | null;
+    lastEventName: string | null;
+    replayCursor: number;
+    replayStartCursor: number;
+    replayEventCount: number;
+    ackCursor: number;
+    activeStream: boolean;
+}
+export interface AgentRuntimeExecutionSessionListQuery {
+    executionId?: string;
+    rootExecutionId?: string;
+    sessionId?: string;
+    turnId?: string;
+    resumeToken?: string;
+    status?: AgentExecutionSessionStatus;
+    activeStream?: boolean;
+    limit?: number;
+}
+export interface AgentRuntimeExecutionSessionListPayload {
+    items: AgentExecutionSessionSnapshot[];
+}
+export interface AgentExecutionSessionResumeParams {
+    ackCursor?: number;
+    timeoutMs?: number;
+}
+export interface AgentExecutionSessionResumeState {
+    requestId: string;
+    resumeToken: string;
+    replayCursor: number;
+    ackCursor: number;
+}
+export interface AgentSessionEndedPayload {
+    sessionId: string;
+    sessionKey?: string;
+    messageCount: number;
+    endedAtMs: number;
+}
+export interface AgentSessionEndedMsg {
+    type: "agent.session.ended";
+    id: string;
+    payload: AgentSessionEndedPayload;
+}
+export interface CheckpointRestoreAckPayload {
+    executionId: string;
+    rootExecutionId?: string;
+    parentExecutionId?: string;
+    sidechainId?: string;
+    attemptId?: string;
+    runId: string;
+    sessionId?: string;
+    checkpointId: string;
+    restoreId: string;
+    requestedAtMs: number;
+    ackedAtMs: number;
+    accepted: boolean;
+    reason?: string;
+    workingDirectory?: string;
+    pathHints?: string[];
+}
+export interface CheckpointRestoreAckMsg {
+    type: "checkpoint.restore.ack";
+    id: string;
+    payload: CheckpointRestoreAckPayload;
+}
+export interface CheckpointRestoredPayload {
+    executionId: string;
+    rootExecutionId?: string;
+    parentExecutionId?: string;
+    sidechainId?: string;
+    attemptId?: string;
+    runId: string;
+    sessionId?: string;
+    checkpointId: string;
+    restoreId: string;
+    restoredAtMs: number;
+    reason?: string;
+    workingDirectory?: string;
+    pathHints?: string[];
+}
+export interface CheckpointRestoredMsg {
+    type: "checkpoint.restored";
+    id: string;
+    payload: CheckpointRestoredPayload;
+}
+export interface CheckpointRollbackResultPayload {
+    executionId: string;
+    rootExecutionId?: string;
+    parentExecutionId?: string;
+    sidechainId?: string;
+    attemptId?: string;
+    runId: string;
+    sessionId?: string;
+    checkpointId: string;
+    restoreId: string;
+    rollbackCheckpointId: string;
+    completedAtMs: number;
+    reason?: string;
+}
+export interface CheckpointRollbackResultMsg {
+    type: "checkpoint.rollback.result";
+    id: string;
+    payload: CheckpointRollbackResultPayload;
+}

package/dist/types/protocol/wire/gateway-rpc.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Gateway-facing Agent RPC type contract.
+ *
+ * This file defines the typed `AgentCall` signature that Gateway consumers use
+ * to invoke Agent RPC methods with full compile-time safety.
+ *
+ * Design: Gateway only needs the "shape" of params/result for the methods it
+ * actually calls. Internal-only methods (agent internals) are not exposed here.
+ *
+ * Reference: CC uses Zod union in a single package; we use TypeScript interface map
+ * in a shared package (same effect — single source, compile-time checked).
+ */
+export type ProjectType = "default" | "personal" | "group";
+export type ProjectStatus = "active" | "archived";
+export interface ProjectInfo {
+    id: string;
+    name: string;
+    workspaceDir: string;
+    type: ProjectType;
+    status: ProjectStatus;
+    groupId?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface GatewayRpcMethodMap {
+    "session.list": {
+        params: {
+            limit?: number;
+        };
+        result: {
+            sessions: Array<{
+                sessionId: string;
+                title?: string;
+                type?: string;
+                groupKey?: string;
+                groupPlatform?: string;
+                lastActiveAt?: number;
+                pinnedAt?: string | null;
+                archivedAt?: string | null;
+            }>;
+        };
+    };
+    "session.get": {
+        params: {
+            sessionId: string;
+        };
+        result: {
+            session: {
+                sessionId: string;
+                title?: string;
+                type?: string;
+                groupKey?: string;
+                groupPlatform?: string;
+                lastActiveAt?: number;
+                pinnedAt?: string | null;
+                archivedAt?: string | null;
+            } | null;
+        };
+    };
+    "session.create": {
+        params: {
+            sessionId: string;
+            title?: string;
+            type?: string;
+            ownerId?: string;
+            groupKey?: string;
+            groupName?: string;
+            groupPlatform?: string;
+            projectId?: string;
+            projectName?: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "session.update": {
+        params: {
+            sessionId: string;
+            title?: string;
+            pinnedAt?: string | null;
+            archivedAt?: string | null;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "session.delete": {
+        params: {
+            sessionId: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "session.archive": {
+        params: {
+            sessionId: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "session.getState": {
+        params: Record<string, never>;
+        result: {
+            sessionId: string;
+            activeProject: ProjectInfo | null;
+            projects: ProjectInfo[];
+        };
+    };
+    "session.switchProject": {
+        params: {
+            projectId?: string;
+            projectName?: string;
+            workspaceDir?: string;
+        };
+        result: {
+            ok: boolean;
+            project: ProjectInfo;
+        };
+    };
+    "session.getMessages": {
+        params: {
+            sessionId?: string;
+            limit?: number;
+        };
+        result: {
+            messages: unknown[];
+            total: number;
+        };
+    };
+    "project.list": {
+        params: Record<string, never>;
+        result: {
+            projects: ProjectInfo[];
+        };
+    };
+    "project.create": {
+        params: {
+            name: string;
+            workspaceDir?: string;
+            type?: ProjectType;
+            groupId?: string;
+        };
+        result: {
+            ok: boolean;
+            project?: ProjectInfo;
+            error?: string;
+            deduplicated?: boolean;
+        };
+    };
+    "project.delete": {
+        params: {
+            projectId: string;
+        };
+        result: {
+            ok: boolean;
+            switchedTo?: ProjectInfo;
+        };
+    };
+    "project.rename": {
+        params: {
+            projectId: string;
+            newName: string;
+        };
+        result: {
+            ok: boolean;
+            project?: ProjectInfo;
+        };
+    };
+    "project.archive": {
+        params: {
+            projectId: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "project.unarchive": {
+        params: {
+            projectId: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "project.archiveByGroup": {
+        params: {
+            platform: string;
+            chatId: string;
+        };
+        result: {
+            ok: boolean;
+            projectId?: string;
+        };
+    };
+    "instructions.list": {
+        params: {
+            projectId?: string;
+        };
+        result: {
+            instructions: Array<{
+                path: string;
+                name: string;
+                size: number;
+            }>;
+        };
+    };
+    "instructions.read": {
+        params: {
+            projectId?: string;
+            path: string;
+        };
+        result: {
+            content: string;
+            path: string;
+        };
+    };
+    "instructions.write": {
+        params: {
+            projectId?: string;
+            path: string;
+            content: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "instructions.delete": {
+        params: {
+            projectId?: string;
+            path: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "files.list": {
+        params: {
+            projectId: string;
+            path?: string;
+        };
+        result: {
+            entries: Array<{
+                name: string;
+                path: string;
+                type: "file" | "directory";
+                size?: number;
+                modifiedAt?: string;
+            }>;
+        };
+    };
+    "files.read": {
+        params: {
+            projectId: string;
+            path: string;
+        };
+        result: {
+            path: string;
+            content: string;
+            encoding?: string;
+        };
+    };
+    "files.create": {
+        params: {
+            projectId: string;
+            path: string;
+            type?: "file" | "directory";
+            content?: string;
+        };
+        result: {
+            ok: boolean;
+            path: string;
+        };
+    };
+    "files.rename": {
+        params: {
+            projectId: string;
+            oldPath: string;
+            newName: string;
+        };
+        result: {
+            ok: boolean;
+            newPath?: string;
+        };
+    };
+    "files.delete": {
+        params: {
+            projectId: string;
+            path: string;
+        };
+        result: {
+            ok: boolean;
+        };
+    };
+    "files.gitStatus": {
+        params: {
+            projectId: string;
+        };
+        result: {
+            files: Array<{
+                path: string;
+                status: string;
+            }>;
+        };
+    };
+}
+/**
+ * Type-safe Agent RPC caller.
+ * Gateway passes this around instead of `(string, Record<string, unknown>) => Promise<unknown>`.
+ */
+export type AgentCall = <M extends keyof GatewayRpcMethodMap>(method: M, params: GatewayRpcMethodMap[M]["params"]) => Promise<GatewayRpcMethodMap[M]["result"]>;
+/** All gateway-facing RPC method names (runtime array). */
+export declare const GATEWAY_RPC_METHODS: (keyof GatewayRpcMethodMap)[];