qlogicagent 2.18.12 → 2.19.2

package/dist/types/protocol/wire/notification-payloads.d.ts

@@ -11,6 +11,7 @@
  * 3. Add event name string in agent-events.ts (if WS-relayed)
  */
 import type { ToolRiskLevel } from "./web-capability.js";
+import type { DelegationError } from "./gateway-rpc.js";
 /** Identifies which agent produced this notification (main or teammate). */
 export interface AgentSource {
     id: string;
@@ -547,125 +548,6 @@ export interface TurnUsageUpdateNotification {
     model?: string;
     sessionCostUSD?: number;
 }
-/** Agent status change notification. */
-export interface AgentsStatusNotification {
-    agentId: string;
-    status: "available" | "spawning" | "running" | "hang" | "failed" | "unavailable";
-    health?: {
-        missedBeats: number;
-        lastActiveAt: string;
-    };
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-    };
-    error?: {
-        phase: string;
-        message: string;
-        retriesLeft: number;
-    };
-}
-/** Agent error notification. */
-export interface AgentsErrorNotification {
-    agentId: string;
-    phase: "detect" | "spawn" | "handshake" | "runtime" | "shutdown" | "heartbeat";
-    error: string;
-    retriesLeft: number;
-}
-/** One-click install progress (state transitions + streamed log lines + final result). */
-export interface AgentInstallProgressNotification {
-    agentId: string;
-    event: {
-        type: "state";
-        state: "installing" | "verifying" | "installed" | "failed";
-    } | {
-        type: "log";
-        stream: "stdout" | "stderr";
-        chunk: string;
-    } | {
-        type: "done";
-        ok: boolean;
-        error?: string;
-    };
-}
-/**
- * Live streaming chunk from an EXTERNAL agent's prompt turn (agents.prompt). Echoes the gateway's
- * turn identity (sessionId/turnId/requestId passed in agents.prompt params) so the gateway can
- * re-emit it on the same turn.delta path the main agent uses — no separate frontend handling.
- */
-export interface AgentsPromptDeltaNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    text: string;
-    /** When true this chunk is the agent's reasoning/thinking (→ turn.reasoning_delta), not reply text. */
-    reasoning?: boolean;
-}
-/**
- * Live tool-call lifecycle from an EXTERNAL agent's prompt turn — same echo-the-turn-identity
- * mechanism as AgentsPromptDeltaNotification, so the gateway re-emits it on the main
- * turn.tool_call / turn.tool_result path and the UI shows external tools running, no extra handling.
- */
-export interface AgentsPromptToolNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    event: {
-        kind: "call";
-        callId: string;
-        name: string;
-        arguments?: string;
-        inputSummary?: string;
-    } | {
-        kind: "result";
-        callId: string;
-        name: string;
-        ok: boolean;
-        outputPreview?: string;
-        error?: string;
-    };
-}
-/**
- * Plan/task update from an EXTERNAL agent's prompt turn (ACP plan steps). The gateway maps the
- * steps onto the main turn.task_updated path so the UI shows the agent's plan as a task list.
- */
-export interface AgentsPromptPlanNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    steps: Array<{
-        content?: string;
-        title?: string;
-        status?: string;
-        priority?: string;
-    }>;
-}
-/**
- * Interactive permission request from an EXTERNAL agent's prompt turn. Echoes the gateway's turn
- * identity so the gateway re-emits it on the main turn.approval_request path → the UI shows an
- * approval card; the user's decision returns via the agents.approvalResponse RPC.
- */
-export interface AgentsPromptApprovalNotification {
-    agentId: string;
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    approvalId: string;
-    callId?: string;
-    toolName: string;
-    arguments?: string;
-    message?: string;
-    category?: string;
-    options?: Array<{
-        optionId: string;
-        name?: string;
-        kind?: string;
-    }>;
-}
 /** Solo agent progress. */
 export interface SoloProgressNotification {
     soloId: string;
@@ -700,12 +582,15 @@ export interface ProductTaskStartedNotification {
     productId: string;
     taskId: string;
     assignee: string;
+    /** Monotonic attempt number under the stable taskId. */
+    attempt: number;
 }
 /** Product task completed. */
 export interface ProductTaskCompletedNotification {
     productId: string;
     taskId: string;
     result: string;
+    attempt: number;
     /** Per-task token usage harvested from the agent's usage tracker. */
     inputTokens?: number;
     outputTokens?: number;
@@ -717,6 +602,8 @@ export interface ProductTaskFailedNotification {
     productId: string;
     taskId: string;
     error: string;
+    attempt: number;
+    terminalState: "failed" | "cancelled";
 }
 /** Product checkpoint saved. */
 export interface ProductCheckpointedNotification {
@@ -812,6 +699,23 @@ export interface ProductPlanningDeltaNotification {
     productId: string;
     text: string;
 }
+export interface ProductLeaderMessageNotification {
+    productId: string;
+    message: string;
+}
+export interface ProductPlanningAskNotification {
+    productId: string;
+    askId: string;
+    questions: Array<{
+        question: string;
+        header: string;
+        options?: Array<{
+            label: string;
+            description?: string;
+        }>;
+        multiSelect?: boolean;
+    }>;
+}
 /** Plan interrupted. */
 export interface PlanInterruptedNotification {
     planId: string;
@@ -837,6 +741,29 @@ export interface ProjectSwitchedNotification {
 export interface ProjectDeletedNotification {
     id: string;
 }
+export interface ProjectDetachedNotification {
+    project: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+        type: string;
+        status: "detached";
+    };
+    switchedTo?: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+    };
+}
+export interface ProjectAttachedNotification {
+    project: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+        type: string;
+        status: "active";
+    };
+}
 /** A project was renamed. */
 export interface ProjectRenamedNotification {
     id: string;
@@ -1023,6 +950,55 @@ export interface GoalAcceptanceUpdatedNotification {
     criterionId: string;
     status: string;
 }
+export interface GoalRoundMessageNotification {
+    goalRunId: string;
+    message: {
+        messageId: string;
+        platform: string;
+        userId?: string;
+        type: string;
+        content: string;
+        timestamp: string;
+        source: string;
+    };
+}
+export interface MentionDelegateStartedNotification {
+    parentSessionId: string;
+    parentMessageId: string;
+    bindingId: string;
+    executionSessionId: string;
+    delegationId: string;
+    sequence: number;
+    providerId: string;
+    revision: number;
+    brief?: string;
+}
+export interface MentionDelegateActivityNotification {
+    parentSessionId: string;
+    parentMessageId: string;
+    bindingId: string;
+    executionSessionId: string;
+    delegationId: string;
+    sequence: number;
+    providerId: string;
+    revision: number;
+    toolName?: string;
+    delta?: string;
+}
+export interface MentionDelegateSettledNotification {
+    parentSessionId: string;
+    parentMessageId: string;
+    bindingId: string;
+    executionSessionId: string;
+    delegationId: string;
+    sequence: number;
+    providerId: string;
+    revision: number;
+    status: "completed" | "failed" | "cancelled";
+    changedFiles?: string[];
+    finalText?: string;
+    error?: DelegationError;
+}
 export interface NotificationMethodMap {
     "turn.start": TurnStartNotification;
     "turn.delta": TurnDeltaNotification;
@@ -1075,13 +1051,6 @@ export interface NotificationMethodMap {
     "team.member.notification": TeamMemberNotification;
     "turn.usage_update": TurnUsageUpdateNotification;
     "pong": PongNotification;
-    "agents.status": AgentsStatusNotification;
-    "agents.error": AgentsErrorNotification;
-    "agent.install.progress": AgentInstallProgressNotification;
-    "agents.prompt.delta": AgentsPromptDeltaNotification;
-    "agents.prompt.tool": AgentsPromptToolNotification;
-    "agents.prompt.approval": AgentsPromptApprovalNotification;
-    "agents.prompt.plan": AgentsPromptPlanNotification;
     "solo.progress": SoloProgressNotification;
     "solo.evaluation": SoloEvaluationNotification;
     "solo.agentDelta": SoloAgentDeltaNotification;
@@ -1100,14 +1069,22 @@ export interface NotificationMethodMap {
     "product.planReady": ProductPlanReadyNotification;
     "product.planFailed": ProductPlanFailedNotification;
     "product.planningDelta": ProductPlanningDeltaNotification;
+    "product.leaderMessage": ProductLeaderMessageNotification;
+    "product.planningAsk": ProductPlanningAskNotification;
     "plan.interrupted": PlanInterruptedNotification;
     "goal.run_state_changed": GoalRunStateChangedNotification;
     "goal.phase_boundary": GoalPhaseBoundaryNotification;
     "goal.goal_edited": GoalGoalEditedNotification;
     "goal.message_queued": GoalMessageQueuedNotification;
     "goal.acceptance_updated": GoalAcceptanceUpdatedNotification;
+    "goal.round_message": GoalRoundMessageNotification;
+    "mention.delegate_started": MentionDelegateStartedNotification;
+    "mention.delegate_activity": MentionDelegateActivityNotification;
+    "mention.delegate_settled": MentionDelegateSettledNotification;
     "project.created": ProjectCreatedNotification;
     "project.switched": ProjectSwitchedNotification;
+    "project.detached": ProjectDetachedNotification;
+    "project.attached": ProjectAttachedNotification;
     "project.deleted": ProjectDeletedNotification;
     "project.renamed": ProjectRenamedNotification;
     "project.archived": ProjectArchivedNotification;

package/dist/types/runtime/infra/host-agent-provider-directory.d.ts

@@ -0,0 +1,17 @@
+import { type HostAgentProviderDiagnostic, type HostAgentProviderGetResult, type HostAgentProviderListResult, type HostProviderRequestParams } from "../../host-contract/index.js";
+export type HostProviderDirectoryErrorCode = "HOST_PROVIDER_DIRECTORY_UNAVAILABLE" | "HOST_PROVIDER_DIRECTORY_INVALID_RESPONSE";
+export declare class HostProviderDirectoryError extends Error {
+    readonly code: HostProviderDirectoryErrorCode;
+    constructor(code: HostProviderDirectoryErrorCode, message: string, options?: ErrorOptions);
+}
+export interface HostProviderDirectoryRequester {
+    request(params: HostProviderRequestParams): Promise<unknown>;
+}
+export declare class HostAgentProviderDirectory {
+    private readonly requester;
+    constructor(requester: HostProviderDirectoryRequester);
+    list(): Promise<Readonly<HostAgentProviderListResult>>;
+    get(providerId: string): Promise<Readonly<HostAgentProviderGetResult>>;
+    diagnose(providerId: string): Promise<Readonly<HostAgentProviderDiagnostic>>;
+    private read;
+}

package/dist/types/runtime/infra/project-authority-facade.d.ts

@@ -1,4 +1,4 @@
-/** Business mutations choose gateway X7 when negotiated, otherwise the standalone local store. */
+/** Project mutations are requests to the Gateway-owned X7 authority. */
 import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
 export declare function createProjectAuthoritative(params: {
     name: string;

package/dist/types/runtime/infra/project-data-paths.d.ts

@@ -10,7 +10,8 @@
  *
  * projectId is the PATH-DERIVED key (deriveProjectId(workspaceDir), see agent-paths) — the
  * mainstream model (VS Code / cc-haha): same folder → same id, deterministic, recomputable, no
- * central-registry dependency for the storage key. Deleting a project = `rm` projectData/<id>/.
+ * central-registry dependency for the storage key. Only the Gateway archive-only internal-data
+ * transaction may remove projectData/<id>; qlogicagent has no lifecycle deletion authority.
  */
 export { getProjectDataDirById, getProjectDataRoot } from "./agent-paths.js";
 /** `~/.qlogicagent/projectData/<projectId>/` for a projectId or workspaceDir. */

package/dist/types/runtime/infra/project-host-authority.d.ts

@@ -2,9 +2,10 @@
 import type { HostProjectInfo, HostProjectSnapshotResult } from "../../host-contract/index.js";
 import type { HostProjectClient } from "../../transport/host-project-client.js";
 export declare function configureHostProjectAuthority(resolver: () => HostProjectClient | undefined): void;
-export declare function hasHostProjectAuthority(): boolean;
 export declare function hydrateHostProjectSnapshot(): Promise<void>;
-export declare function readHostProjectSnapshot(): HostProjectSnapshotResult | undefined;
+export declare function readHostProjectSnapshot(): HostProjectSnapshotResult;
+/** Test-only snapshot injection; production must hydrate through HostProjectClient. */
+export declare function setHostProjectSnapshotForTests(next: HostProjectSnapshotResult): void;
 export declare function createHostProject(params: Parameters<HostProjectClient["create"]>[0]): Promise<HostProjectInfo>;
 export declare function switchHostProject(projectIdOrQuery: string): Promise<HostProjectInfo>;
 export declare function updateHostProject(projectId: string, patch: Parameters<HostProjectClient["update"]>[1]): Promise<HostProjectInfo>;

package/dist/types/runtime/infra/project-store.d.ts

@@ -1,48 +1,13 @@
 /**
- * Local Project Store — persists project metadata to ~/.qlogicagent/projects.json.
+ * Read-only ExtHost-style Project projection.
  *
- * This is the Agent-side (runtime authority) project registry.
- * Hub maintains a mirror copy via EventBus → HubSubscriber → hub.persistProject.
- *
- * Direction A: Agent is the source of truth for project state.
- */
-import type { ProjectInfo, ProjectType } from "../../protocol/methods.js";
-/**
- * Rebuild projects.json from the per-project `project.json` back-refs (the durable truth). Self-heals
- * a lost/corrupted index: any projectData/<id> with a back-ref not present in projects.json is
- * re-added. Called at startup before the default-project bootstrap.
+ * Gateway owns the durable registry and every lifecycle mutation. qlogicagent
+ * may only read the snapshot hydrated through x/host.request.
  */
-export declare function rebuildIndexFromBackrefs(): void;
-export declare function createProject(params: {
-    name: string;
-    workspaceDir: string;
-    type?: ProjectType;
-    groupId?: string;
-    skipAutoSwitch?: boolean;
-}): ProjectInfo;
+import type { ProjectInfo } from "../../protocol/methods.js";
 export declare function listProjects(): ProjectInfo[];
 export declare function getActiveProject(): ProjectInfo | null;
 export declare function getDefaultProject(): ProjectInfo | null;
 export declare function getProjectById(projectId: string): ProjectInfo | null;
-export declare function updateProject(projectId: string, patch: Partial<Pick<ProjectInfo, "planStatus" | "planAgents" | "planWinnerId" | "leaderSessionId" | "primaryWorkflowId">>): boolean;
-export declare function switchProject(projectId: string): ProjectInfo | null;
-export declare function deleteProject(projectId: string): {
-    deleted: boolean;
-    switchedTo?: ProjectInfo;
-};
-export declare function getOrCreateDefaultProject(defaultWorkspaceDir: string): ProjectInfo;
-export declare function renameProject(projectId: string, newName: string): ProjectInfo | null;
-export declare function updateProjectWorkspaceDir(projectId: string, newDir: string): boolean;
-export declare function archiveProject(projectId: string): {
-    archived: boolean;
-    switchedTo?: ProjectInfo;
-};
-export declare function unarchiveProject(projectId: string): ProjectInfo | null;
 export declare function findByGroupId(groupId: string): ProjectInfo | null;
-/**
- * Find the active project whose workspaceDir resolves to `dir` (case-insensitive, path-resolved).
- * Used to gate adoption of externally-supplied working directories (ACP session cwd, turn
- * config.workdir): the active tool workdir must always be a registered project's workspaceDir, so
- * a cwd that maps to no project is ignored rather than silently leaking files outside any project.
- */
 export declare function findByWorkspaceDir(dir: string): ProjectInfo | null;

package/dist/types/runtime/session/session-catalog.d.ts

@@ -1,18 +1,6 @@
 import type { SessionListEntry } from "./session-types.js";
 export declare function listSessions(limit: number | undefined, projectRoot: string): Promise<SessionListEntry[]>;
 export declare function deleteSession(sessionId: string, projectRoot: string): Promise<void>;
-/**
- * Authoritative "already ours" id set for the lazy-migration discovery scan: every session id and
- * bound native id recorded for `agentId` in this project — including ARCHIVED records, which the
- * list pipeline filters out of its window.
- *
- * listSessions' windowed result must NOT be used for discovery dedup: it truncates (limit) and
- * post-filters (archived), so an adopted session pushed out of the window would be "re-discovered"
- * as a second entry — and a resume on that duplicate would fork a second canonical record for the
- * same native conversation. This enumerates metadata.json only (no transcript counting), and
- * callers only pay for it when the scan actually yielded candidates.
- */
-export declare function collectAdoptedNativeIds(agentId: string, projectRoot: string): Promise<Set<string>>;
 /**
  * ⚠️ Destructive cascade with NO user-visible confirmation: every pruned session goes through
  * deleteSession, which permanently removes its transcript + metadata + checkpoints + uploads.

package/dist/types/runtime/session/session-persistence.d.ts

@@ -29,6 +29,6 @@ export declare function loadSessionForResume(sessionId: string, projectRoot: str
 export declare function saveSessionState(sessionId: string, usageSnapshot: SessionUsageSnapshot, metadata: SessionStateSaveMetadata, projectRoot: string): Promise<void>;
 export declare function updateSessionMetadata(sessionId: string, patch: SessionMetadataPatch, projectRoot: string): Promise<import("./session-types.js").SessionMetadata | null>;
 export { getSessionMetadata, readSessionMetadata };
-export { collectAdoptedNativeIds, deleteSession, listSessions, pruneOldSessions } from "./session-catalog.js";
+export { deleteSession, listSessions, pruneOldSessions } from "./session-catalog.js";
 export { generateSessionTitle, maybeGenerateTaskSummary, shouldGenerateTaskSummary, } from "./session-summary.js";
 export { SESSION_SCHEMA_VERSION, type MessageDisplayMetadata, type PersistedChatMessage, type PersistedSession, type SessionListEntry, type SessionMetadata, type TaskSummaryDeps, } from "./session-types.js";

package/dist/types/runtime/session/session-resource-key.d.ts

@@ -9,7 +9,7 @@ export interface SessionResource {
     agentId: string;
     /** Owning project id (path-derived / opaque; not minted here). */
     projectId: string;
-    /** Our-minted session id, stable from creation — never the native Y (Y lives in nativeBinding). */
+    /** Our-minted session id, stable from creation; native identity is held by Gateway Host state. */
     canonicalSessionId: string;
 }
 /** Serialize the canonical session resource to its single opaque key string. */

package/dist/types/runtime/session/session-types.d.ts

@@ -18,25 +18,6 @@ export interface InflightTurnMarker {
     /** 该轮是否已执行过有副作用的工具（写文件/发消息/外部 API）。安全档不据此自动续，仅用于 UI"可能重复"提示 + 为智能档铺路。 */
     hadSideEffectTool?: boolean;
 }
-/**
- * Native (codex/claude) session binding — present only on native sessions, written once the
- * external agent reports its own session id (Y). Our `sessionId` stays the canonical identity;
- * `nativeSessionId` is an ATTRIBUTE used ONLY when talking to the external CLI (ACP session/load),
- * never as a map/pool/list key. `nativeRef` independently locates the external transcript file so
- * content loads (and the binding is recoverable) without relying on `sessionId === nativeSessionId`.
- */
-export interface NativeBinding {
-    /** External agent's own session id (Y) — used only for ACP session/load resume. */
-    nativeSessionId: string;
-    /** Locator for the external transcript file (loadTranscript + binding-loss fallback). */
-    nativeRef: {
-        agentId: string;
-        kind: "codex" | "claude";
-        file: string;
-    };
-    /** ISO time the binding was established (first turn the external agent reported Y). */
-    boundAt: string;
-}
 export interface SessionMetadata {
     schemaVersion?: number;
     sessionId: string;
@@ -71,8 +52,6 @@ export interface SessionMetadata {
     interruptedTurnCount?: number;
     /** 达熔断阈值放弃恢复的时间戳（UI 显示"多次中断已停止自动恢复"）。 */
     recoveryAbandonedAt?: string;
-    /** native(codex/claude)会话绑定：外部 Y + nativeRef;own 会话恒 undefined。见 {@link NativeBinding}。 */
-    nativeBinding?: NativeBinding;
 }
 export interface PersistedSession {
     metadata: SessionMetadata;
@@ -123,8 +102,6 @@ export interface SessionListEntry {
     groupKey?: string;
     previousSessionId?: string;
     carryoverSummary?: string | null;
-    /** N4: native (codex/claude) binding, surfaced so session.list can shape source:"native" + nativeRef. */
-    nativeBinding?: NativeBinding;
 }
 export interface TaskSummaryDeps {
     transport: import("../ports/index.js").LLMTransport;

package/dist/types/transport/acp-server.d.ts

@@ -74,7 +74,6 @@ export interface AcpRequestHandler {
         ok: boolean;
         summary?: string;
     }>;
-    handleAcpAgentsList(): Promise<unknown>;
     handleAcpSoloStart(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloStatus(params: Record<string, unknown>): Promise<unknown>;
     handleAcpSoloSelect(params: Record<string, unknown>): Promise<unknown>;
@@ -106,9 +105,6 @@ export interface AcpRequestHandler {
     handleAcpGoalMessage(params: Record<string, unknown>): Promise<unknown>;
     handleAcpGoalSubscribe(params: Record<string, unknown>): Promise<unknown>;
     handleAcpGoalEvents(params: Record<string, unknown>): Promise<unknown>;
-    handleAcpMentionDelegate(params: Record<string, unknown>): Promise<unknown>;
-    handleAcpMentionCancel(params: Record<string, unknown>): Promise<unknown>;
-    handleAcpMentionList(params: Record<string, unknown>): Promise<unknown>;
 }
 export interface AcpServerConfig {
     verbose?: boolean;
@@ -148,7 +144,7 @@ export declare class AcpServer {
     /**
      * S3a 跨进程 delegate 客户端(泛化本类的 outbound-request 底座;设计 §5.1)。与审批 outboundRequestMap
      * 并存:x/delegate 用 `del-*` rpc id,审批用 `perm-*`,handleResponse 先问 delegate 再落审批,互不干扰。
-     * S3c 接线点:DelegationCoordinator.delegate() 改经 `server.delegate.delegate(...)`(本 S3a 只建能力+测,不切)。
+     * All orchestration stations call this client through the authority-neutral DelegateBridge.
      */
     private readonly delegateClient;
     /** Coordinator-owned client reference; AcpServer only offers its response-claim seam. */
@@ -187,11 +183,7 @@ export declare class AcpServer {
     supportsHostRequestService(service: HostRequestService): boolean;
     /** Capability snapshot consumed by the coordinator-owned HostRequestClient. */
     get hostRequestCapability(): unknown;
-    /**
-     * S3a 跨进程 delegate 客户端(leader 侧接缝)。S3c 接线:DelegationCoordinator.delegate() 改为
-     * 铸 delegationId → `server.delegate.delegate({delegationId,to,input,session,opts}, sink)` 上行 x/delegate、
-     * 消费 x/delegate.update 下行喂规划环/RunStateStore(delegation-coordinator.ts:87 复用点)。本 S3a 只交付+测,不切。
-     */
+    /** Cross-process delegate client used by orchestration stations through DelegateBridge. */
     get delegate(): DelegateClient;
     /** Whether a session id has been registered via session/new on this connection. */
     hasSession(sessionId: string): boolean;