qlogicagent 2.18.6 → 2.18.7

package/dist/types/host-contract/project-id.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Derive the stable project id shared by agent and host. This implementation lives
+ * in the leaf contract so runtime path helpers consume it without a reverse edge.
+ */
+export declare function deriveProjectId(workspaceDir: string): string;

package/dist/types/host-contract/provider-profile.d.ts

@@ -0,0 +1,46 @@
+export interface ProviderCatalogModelRef {
+    id?: string;
+}
+export interface ProviderCatalogDef {
+    id: string;
+    name?: string;
+    displayName?: string;
+    group?: string;
+    baseUrl?: string;
+    base_url?: string;
+    transport?: string;
+    defaultModel?: string;
+    authType?: string;
+    apiKeyEnvVars?: string[];
+    models?: ProviderCatalogModelRef[];
+}
+export interface SettingsProviderOption {
+    id: string;
+    displayName: string;
+    baseUrl: string;
+    modelCount: number;
+    variants?: SettingsProviderVariantOption[];
+}
+export interface SettingsProviderVariantOption {
+    id: string;
+    displayName: string;
+    baseUrl: string;
+    modelCount: number;
+}
+export interface ProviderValidationProbe {
+    method: "GET" | "POST";
+    url: string;
+    headers: Record<string, string>;
+    body?: Record<string, unknown>;
+}
+export interface ProviderKeyValidationResult {
+    valid: boolean;
+    status: number;
+    error?: string;
+    url?: string;
+}
+export declare function providerCatalogBaseUrl(provider: ProviderCatalogDef): string | undefined;
+export declare function providerCatalogDisplayName(provider: ProviderCatalogDef): string;
+export declare function listSettingsProviderOptions(upstreamProviders: ProviderCatalogDef[]): SettingsProviderOption[];
+export declare function isProviderProbeEndpointUnavailable(status: number): boolean;
+export declare function buildProviderValidationProbes(providerId: string, apiKey: string, baseUrl: string, provider: ProviderCatalogDef | undefined): ProviderValidationProbe[];

package/dist/types/orchestration/agent-instance.d.ts

@@ -18,6 +18,7 @@ import type { ProductPhase, ProductCreateParams, ProductStatus, ProductSummary }
 import { type PlannerMemoryContext } from "./planner-memory-brief.js";
 import type { DagMutation } from "./product-planner.js";
 import type { ProductLeaderCoordinator } from "./product-run-coordinator.js";
+import type { DelegateBridge } from "./delegation-coordinator.js";
 export type { ProductLeaderCoordinator } from "./product-run-coordinator.js";
 export interface ProductCallbacks {
     log?: {
@@ -52,6 +53,9 @@ export interface ProductCallbacks {
     onBudgetUpdate?: (productId: string, inputTokens: number, outputTokens: number, elapsed: number, maxTotalTokens?: number) => void;
     /** Streaming text output from a running task. */
     onTaskOutputDelta?: (productId: string, taskId: string, text: string) => void;
+    /** Per-task tool activity heartbeat(delegate 路径由 sink.onToolCall 单发;旧路径经共享 PM 的
+     *  turn.tool_call 在 product-coordinator 转 product.agentActivity,PM 在 delegate 路径看不见 worker)。 */
+    onTaskActivity?: (productId: string, taskId: string, toolName: string) => void;
     /** Team roster resolved at run start — fired once (engine-driven) for both initial start and resume,
      *  so the run view's 团队成员 panel populates live instead of only on a history reopen. */
     onMembers?: (productId: string, members: {
@@ -59,6 +63,8 @@ export interface ProductCallbacks {
         role: string;
         name: string;
     }[]) => void;
+    /** 激活层(S3c §1.2):gateway-routed delegate 桥(gate 关/未挂 = undefined → 旧本地 spawn 路径)。 */
+    getDelegateBridge?: () => DelegateBridge | undefined;
 }
 /**
  * Prepend completed upstream task outputs to a downstream task prompt so the

package/dist/types/orchestration/delegation-coordinator.d.ts

@@ -1,4 +1,25 @@
 import type { ProductOrchestrator } from "./agent-instance.js";
+import type { DelegateRequestParams, SupervisorEventSink, TurnResult } from "../host-contract/index.js";
+/**
+ * 激活层(S3c):gateway-routed delegate 传输桥(解耦接口;wire 从 AcpServer.delegate/supportsDelegate 供)。
+ * hostSupportsDelegate(=gateway 在 initialize 声明 delegate 能力位)时,run() 改走此桥:leader 请网关代派
+ * worker 回合(x/delegate),事件回流经 sink,resolve 统一 TurnResult —— 不再 ProductOrchestrator.create
+ * 本地 spawn。gate 关(gateway 未声明)= isSupported()=false = 旧路径保留(单轨,zero-regression)。
+ */
+export interface DelegateBridge {
+    /** T9:gateway 声明 delegate 能力才放行(否则旧 ProcessManager/Orchestrator 路径)。 */
+    isSupported(): boolean;
+    /** 上行 x/delegate(resolve TurnResult;回流事件经 sink)。 */
+    send(params: DelegateRequestParams, sink: SupervisorEventSink): Promise<TurnResult>;
+    /** x/delegate.cancel(取消回合,不杀进程;rec.abort 触发时调)。 */
+    cancel(delegationId: string): void;
+    /**
+     * x/delegate.respond(leader 来源审批应答,通知 fire-and-forget;optionId 不透明透传 E2)。
+     * 站点收到 sink.onApprovalRequest 后按用户/策略决议经此应答(chat 站 §1.1 审批往返;
+     * gateway 侧 delegate-server → supervisor.respondApproval,freeze §11 补遗#3 唯一应答口)。
+     */
+    respond(delegationId: string, approvalId: string, optionId: string): void;
+}
 export interface DelegationNotify {
     (method: string, payload: Record<string, unknown>): void;
 }
@@ -10,6 +31,15 @@ export interface DelegationDeps {
         info(m: string): void;
         warn(m: string): void;
     };
+    /**
+     * 激活层(S3c):gateway-routed delegate 传输 + 会话上下文(可选;缺省 = 旧 ProductOrchestrator 路径)。
+     * bridge.isSupported()=true(gateway 声明 delegate 能力位)时,run() 改走 gateway 代派 worker;否则旧路径。
+     * projectId = deriveProjectId(cwd)(wire 供,避免 coordinator import agent-paths;单轨解析权威在会话面)。
+     */
+    delegate?: {
+        bridge: DelegateBridge;
+        projectId: string;
+    };
 }
 type DelegationStatus = "running" | "completed" | "failed" | "cancelled" | "timed_out";
 export declare class DelegationCoordinator {
@@ -50,6 +80,16 @@ export declare class DelegationCoordinator {
         delegationId: string;
     };
     private run;
+    /**
+     * 激活层(S3c):gateway-routed delegate 路径 —— 不本地 spawn,请网关代派一个 worker 回合。
+     * leader 铸 delegationId(rec.delegationId 已是 `del-*`,承 Q4「leader 铸 + gateway 校验唯一」);
+     * 回流 sink 把 worker 工具活动转 mention.delegate_activity(live 进度),final 由 TurnResult 承。
+     * 与旧路径行为对齐:started/settled 通知、cancel 语义(rec.abort → x/delegate.cancel)、convChain 串行不变。
+     *
+     * native session 累积(跨同会话委派的 resume)在此路径由 gateway SessionProjectService.recordNativeSessionId
+     * 于 relay 观察点回填(freeze §11 补遗#2)—— coordinator 不再本地捕获 getDelegationNativeSessionId(单轨,权威上移)。
+     */
+    private runViaDelegate;
     /** Collect a delegation's produced artifacts: the union of the worktree diff (tasks[].changedFiles,
      *  omitted by the wire type but carried at runtime) and the mtime-isolated capture of project-root files
      *  (for workers that write straight to the workspace), plus the worker task + terminal phase. Shared by

package/dist/types/orchestration/goal-mode-adapters.d.ts

@@ -1,5 +1,6 @@
 import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
+import type { DelegateBridge } from "./delegation-coordinator.js";
 import { type PlannerMemoryContext } from "./planner-memory-brief.js";
 import type { ProductOrchestrator } from "./agent-instance.js";
 import type { LeaderPort, PhaseRunnerPort } from "./goal-loop-coordinator.js";
@@ -67,6 +68,8 @@ export interface LeaderAdapterDeps {
         info(msg: string): void;
         warn(msg: string): void;
     };
+    /** 激活层(S3c §1.4):gateway-routed delegate 桥(gate 关/未挂 = undefined → 旧本地 spawn 路径)。 */
+    getDelegateBridge?: () => DelegateBridge | undefined;
 }
 export declare function createLeaderAdapter(deps: LeaderAdapterDeps): LeaderPort;
 export interface PhaseRunnerAdapterDeps {

package/dist/types/orchestration/product-planner.d.ts

@@ -26,6 +26,7 @@
 import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
+import type { DelegateBridge } from "./delegation-coordinator.js";
 import type { ProductPlanParams, ProductPlan, ProductConfirmParams } from "../protocol/wire/acp-agent-management.js";
 export type PlanningPhase = "planning" | "awaiting_confirmation" | "confirmed" | "executing" | "paused" | "completed" | "cancelled";
 export interface PlanningMessage {
@@ -94,6 +95,8 @@ export interface PlannerCallbacks {
         running: number;
         failed: number;
     };
+    /** 激活层(S3c §1.3):gateway-routed delegate 桥(gate 关/未挂 = undefined → 旧本地 spawn 路径)。 */
+    getDelegateBridge?: () => DelegateBridge | undefined;
 }
 /** Describes a DAG mutation performed by the leader. */
 export interface DagMutation {

package/dist/types/orchestration/solo-evaluator.d.ts

@@ -21,6 +21,7 @@
 import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
+import type { DelegateBridge } from "./delegation-coordinator.js";
 import type { SoloState, SoloAgentState, SoloEvaluation, SoloStatus, SoloStartParams, SoloSelectParams, SoloSpec } from "../protocol/wire/acp-agent-management.js";
 export interface SoloCallbacks {
     log?: {
@@ -29,17 +30,22 @@ export interface SoloCallbacks {
         debug?(msg: string): void;
     };
     onProgress?: (soloId: string, agentId: string, state: SoloAgentState, progress?: string, worktreePath?: string) => void;
-    onEvaluation?: (soloId: string, evaluation: SoloEvaluation) => void;
+    onEvaluation?: (soloId: string, evaluation: SoloEvaluation) => void | Promise<void>;
     /** Streaming text delta from a competing agent (forwarded from child process). */
     onAgentDelta?: (soloId: string, agentId: string, text: string) => void;
+    /** Live tool-activity heartbeat(delegate 路径由 sink.onToolCall 单发;旧路径经共享 PM 的
+     *  turn.tool_call 在 solo-handler 转 solo.agentActivity,PM 在 delegate 路径看不见竞速者)。 */
+    onAgentActivity?: (soloId: string, agentId: string, toolName: string) => void;
     /** Token usage report after agent completes. */
     onAgentUsage?: (soloId: string, agentId: string, inputTokens: number, outputTokens: number) => void;
+    /** 激活层(S3c §1.5):gateway-routed delegate 桥(gate 关/未挂 = undefined → 旧本地 spawn 路径)。 */
+    getDelegateBridge?: () => DelegateBridge | undefined;
     /**
      * Race reached a terminal state WITHOUT an evaluation winner (all agents failed, or cancelled).
      * The success path uses onEvaluation; this lets the host write back the plan project's planStatus
      * (failed/cancelled) so 历史方案 is correct and recovery doesn't restore a dead run.
      */
-    onTerminal?: (soloId: string, state: SoloState) => void;
+    onTerminal?: (soloId: string, state: SoloState) => void | Promise<void>;
 }
 /**
  * Assemble the prompt every competitor receives (Cut4). Shared context (rules/memory) + optional
@@ -80,6 +86,16 @@ export declare class SoloEvaluator {
      * Creates worktrees, spawns agents in parallel, waits for completion, then evaluates.
      */
     start(params: SoloStartParams): Promise<string>;
+    /**
+     * 激活层(S3c §1.5):gateway-routed delegate 路径 —— 竞速者回合经网关代派(x/delegate),不本地
+     * spawn。同 handle(solo-racer/soloId/agentId/seq)⇒ supervisor 按 memberKey 复用同一竞速者进程与
+     * ACP 会话:初赛 → follow-up → 评比全程上下文连续(取代旧「watchdog reap + 按需 re-spawn」循环,
+     * worktree 文件仍是 durable state)。cwd=worktree;self 竞速者的 QLOGICAGENT_WORKTREE_WORKDIR /
+     * QLOGICAGENT_SOLO_LEAN 由 gateway 按 kind=solo-racer 派生注入(AgentSpec.envOverrides,freeze §1
+     * —— descriptor/env 注入在 qla 侧退场,env 是监督者按成员种类决定的启动器不变量,非调用方入参)。
+     * usage 由 TurnResult.usage 承(不再读共享 PM 的 usage tracker)。
+     */
+    private runTurnViaDelegate;
     /**
      * Ensure the agent's ACP process is alive in its worktree, spawning it if absent. Used by the
      * initial run AND by follow-up messages: the watchdog reaps idle competitors after the race, so a
@@ -89,7 +105,6 @@ export declare class SoloEvaluator {
      * QLOGICAGENT_WORKTREE_WORKDIR anchors writes to the worktree; QLOGICAGENT_SOLO_LEAN drops media
      * tools so it matches the external coding CLIs and won't wander into 图像生成 on a code task.
      */
-    private ensureAgentRunning;
     /**
      * Send a follow-up message to a specific agent within a solo session.
      * Agent must be in "idle" or "completed" state.

package/dist/types/orchestration/solo-persistence.d.ts

@@ -15,6 +15,8 @@ export interface PersistedSoloState {
     agents: Array<{
         agentId: string;
         memberId: string;
+        /** Handle seq(delegate 路径 MemberHandle 第四元);旧持久化文件缺省时按数组序回填。 */
+        seq?: number;
         worktreePath: string;
         worktreeBranch: string;
         state: SoloAgentState;

package/dist/types/orchestration/testing/delegate-test-bridge.d.ts

@@ -0,0 +1,4 @@
+import type { AgentProcessManager } from "../../runtime/infra/agent-process.js";
+import type { DelegateBridge } from "../delegation-coordinator.js";
+/** Test-only adapter for migrating orchestration fixtures from the retired local spawn lane. */
+export declare function makeDelegateTestBridge(processManager: AgentProcessManager): DelegateBridge;

package/dist/types/permissions.d.ts

@@ -1,2 +1,4 @@
 export { PERMISSION_MODES, } from "./runtime/ports/permission-contracts.js";
+export { buildPermissionModel, } from "./runtime/permission-model.js";
 export type { ApprovalRequest, ApprovalResponse, PermissionAllowResult, PermissionApprovalResolver, PermissionAskResult, PermissionBehavior, PermissionConfig, PermissionDecisionReason, PermissionDenyResult, PermissionMetadataResolver, PermissionMode, PermissionResult, PermissionRuleEnginePort, PermissionRuleEntry, ToolPermissionCheckInput, } from "./runtime/ports/permission-contracts.js";
+export type { PermissionModeDescriptor, PermissionModelContract, PermissionPromptOption, } from "./runtime/permission-model.js";

package/dist/types/protocol/methods.d.ts

@@ -189,127 +189,6 @@ export interface ToolsListResult {
     }>;
     total: number;
 }
-export interface SettingsListProvidersResult {
-    providers: Array<{
-        id: string;
-        displayName: string;
-        baseUrl: string;
-        modelCount: number;
-    }>;
-}
-export interface SettingsAddKeyParams {
-    providerId: string;
-    key: string;
-    label?: string;
-}
-export interface SettingsAddKeyResult {
-    keyId: string;
-    providerId: string;
-}
-export interface SettingsRemoveKeyParams {
-    keyId: string;
-}
-export interface SettingsGetKeyParams {
-    keyId: string;
-}
-export interface SettingsGetKeyResult {
-    key: string;
-}
-export interface SettingsToggleKeyParams {
-    keyId: string;
-    enabled: boolean;
-}
-export interface SettingsListModelsParams {
-    purpose?: string;
-    provider?: string;
-}
-export interface SettingsListModelsResult {
-    models: Array<{
-        id: string;
-        provider: string;
-        model: string;
-        displayName: string;
-        routeIntents: string[];
-        capabilityProfile?: {
-            tasks?: string[];
-            input_modalities?: string[];
-            output_modalities?: string[];
-            traits?: string[];
-            verification?: Record<string, unknown>;
-            cost?: Record<string, unknown>;
-        };
-        baseUrl?: string;
-        enabled: boolean;
-    }>;
-    grouped: Record<string, Array<{
-        id: string;
-        provider: string;
-        model: string;
-        displayName: string;
-        routeIntents: string[];
-        capabilityProfile?: {
-            tasks?: string[];
-            input_modalities?: string[];
-            output_modalities?: string[];
-            traits?: string[];
-            verification?: Record<string, unknown>;
-            cost?: Record<string, unknown>;
-        };
-        baseUrl?: string;
-        enabled: boolean;
-    }>>;
-}
-export interface SettingsSetActiveModelParams {
-    purpose: string;
-    modelId: string;
-}
-export interface SettingsGetActiveModelParams {
-    purpose: string;
-}
-export interface SettingsGetActiveModelResult {
-    model: {
-        id: string;
-        provider: string;
-        model: string;
-        displayName: string;
-        routeIntents: string[];
-        capabilityProfile?: {
-            tasks?: string[];
-            input_modalities?: string[];
-            output_modalities?: string[];
-            traits?: string[];
-            verification?: Record<string, unknown>;
-            cost?: Record<string, unknown>;
-        };
-        enabled: boolean;
-    } | null;
-    available: boolean;
-}
-export interface SettingsGetOverviewResult {
-    providers: Array<{
-        providerId: string;
-        baseUrl?: string;
-        keyCount: number;
-        healthyKeys: number;
-        totalKeys: number;
-    }>;
-    purposes: Record<string, {
-        bound: boolean;
-        modelId?: string;
-        modelName?: string;
-        available: boolean;
-    }>;
-}
-export interface SettingsValidateKeyParams {
-    providerId: string;
-    apiKey: string;
-    baseUrl?: string;
-}
-export interface SettingsValidateKeyResult {
-    valid: boolean;
-    status: number;
-    error?: string;
-}
 export interface MediaListModelsParams {
     /** Filter by media type (image/video/music/tts/3d/stt/embedding). Omit to list all. */
     mediaType?: string;
@@ -325,23 +204,6 @@ export interface MediaListModelsResult {
         capabilities?: Record<string, unknown>;
     }>;
 }
-export interface ConfigGetParams {
-    keys?: string[];
-}
-export interface ConfigGetResult {
-    config: Record<string, unknown>;
-}
-export interface ConfigUpdateParams {
-    settings: Record<string, unknown>;
-}
-export interface ConfigUpdateResult {
-    ok: boolean;
-    applied: string[];
-    rejected?: Array<{
-        key: string;
-        reason: string;
-    }>;
-}
 export type CommunityInstallRiskTier = "R0" | "R1" | "R2" | "R3";
 export type CommunityInstallSourceTier = "official" | "community";
 export type CommunityInstallTrustStage = "quarantine" | "trial" | "trusted";
@@ -630,14 +492,6 @@ export interface RpcMethodMap {
         params: MediaListModelsParams;
         result: MediaListModelsResult;
     };
-    "config.get": {
-        params: ConfigGetParams;
-        result: ConfigGetResult;
-    };
-    "config.update": {
-        params: ConfigUpdateParams;
-        result: ConfigUpdateResult;
-    };
     "community.resolveInstall": {
         params: CommunityResolveInstallParams;
         result: CommunityResolveInstallResult;
@@ -949,59 +803,6 @@ export interface RpcMethodMap {
         params: FilesGitStatusParams;
         result: FilesGitStatusResult;
     };
-    "settings.listProviders": {
-        params: undefined;
-        result: SettingsListProvidersResult;
-    };
-    "settings.addKey": {
-        params: SettingsAddKeyParams;
-        result: SettingsAddKeyResult;
-    };
-    "settings.removeKey": {
-        params: SettingsRemoveKeyParams;
-        result: {
-            ok: true;
-        };
-    };
-    "settings.getKey": {
-        params: SettingsGetKeyParams;
-        result: SettingsGetKeyResult;
-    };
-    "settings.toggleKey": {
-        params: SettingsToggleKeyParams;
-        result: {
-            ok: true;
-        };
-    };
-    "settings.listModels": {
-        params: SettingsListModelsParams;
-        result: SettingsListModelsResult;
-    };
-    "settings.setActiveModel": {
-        params: SettingsSetActiveModelParams;
-        result: {
-            ok: true;
-        };
-    };
-    "settings.getActiveModel": {
-        params: SettingsGetActiveModelParams;
-        result: SettingsGetActiveModelResult;
-    };
-    "settings.getOverview": {
-        params: undefined;
-        result: SettingsGetOverviewResult;
-    };
-    "settings.refreshModels": {
-        params: undefined;
-        result: {
-            ok: true;
-            catalogRefreshed?: boolean;
-        };
-    };
-    "settings.validateKey": {
-        params: SettingsValidateKeyParams;
-        result: SettingsValidateKeyResult;
-    };
 }
 /** All known RPC method names. */
 export type RpcMethod = keyof RpcMethodMap;

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

@@ -1,3 +1,4 @@
+import { type HostRequestCapability } from "../../host-contract/index.js";
 export declare const ACP_PROTOCOL_VERSION: 1;
 export declare const ACP_METHODS: {
     readonly INITIALIZE: "initialize";
@@ -53,6 +54,10 @@ export declare const ACP_EXTENDED_METHODS: {
     readonly MENTION_DELEGATE: "x/mention.delegate";
     readonly MENTION_CANCEL: "x/mention.cancel";
     readonly MENTION_LIST: "x/mention.list";
+    readonly DELEGATE: "x/delegate";
+    readonly DELEGATE_UPDATE: "x/delegate.update";
+    readonly DELEGATE_RESPOND: "x/delegate.respond";
+    readonly DELEGATE_CANCEL: "x/delegate.cancel";
 };
 export type AcpExtendedMethod = (typeof ACP_EXTENDED_METHODS)[keyof typeof ACP_EXTENDED_METHODS];
 /** qlogicagent 专属扩展套件的协商开关(host 与 agent 双向声明)。存在即启用扩展。 */
@@ -65,6 +70,16 @@ export interface AcpQlogicagentCapability {
     methods?: boolean;
     /** Multi-agent orchestration (solo / product / team). */
     orchestration?: boolean;
+    /**
+     * T9 capability 握手 gate(S3a 跨进程 delegate 传输;host→agent 声明位)。
+     * host(gateway)声明「我服务 gateway-routed delegate」——即由 GatewayDelegateServer 认
+     * `x/delegate` 请求、下行 `x/delegate.update` 回流帧。qlogicagent(leader)【仅当】收到此位才走
+     * DelegateClient 发 x/delegate;未声明 = inert-until-cutover(旧自 spawn 路径 / fail-loud,不运行时双轨)。
+     * S3a/S3b:host 不声明(在位不接管);S3c:host 声明(硬切)。见 agent-supervision-s3a-transport-design §2.4/T9。
+     */
+    delegate?: boolean;
+    /** Exact services the host has registered for x/host.request. */
+    hostRequest?: HostRequestCapability;
     /** Config options (agent side only). */
     configOptions?: AcpConfigOptionDescriptor[];
 }
@@ -95,7 +110,7 @@ export interface AcpAgentCapabilities {
 }
 export interface AcpConfigOptionDescriptor {
     name: string;
-    type: "string" | "boolean" | "number" | "enum";
+    type: "string" | "boolean" | "number" | "enum" | "object";
     values?: string[];
     description?: string;
 }