qlogicagent 2.18.12 → 2.19.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.18.12",
+  "version": "2.19.2",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -28,6 +28,10 @@
       "types": "./dist/types/protocol/wire/index.d.ts",
       "default": "./dist/protocol.js"
     },
+    "./agent-contract": {
+      "types": "./dist/types/protocol/agent-contract.d.ts",
+      "default": "./dist/agent-contract.js"
+    },
     "./permissions": {
       "types": "./dist/types/permissions.d.ts",
       "default": "./dist/permissions.js"
@@ -56,6 +60,10 @@
       "types": "./dist/types/host-contract/index.d.ts",
       "default": "./dist/host-contract.js"
     },
+    "./host-session-collection-contract": {
+      "types": "./dist/types/host-session-collection-contract.d.ts",
+      "default": "./dist/host-session-collection-contract.js"
+    },
     "./plugin-marketplace-compute": {
       "types": "./dist/types/skills/plugins/plugin-marketplace.d.ts",
       "default": "./dist/plugin-marketplace-compute.js"
@@ -69,6 +77,9 @@
       "protocol": [
         "./dist/types/protocol/wire/index.d.ts"
       ],
+      "agent-contract": [
+        "./dist/types/protocol/agent-contract.d.ts"
+      ],
       "agent": [
         "./dist/types/agent/agent.d.ts"
       ],
@@ -99,6 +110,9 @@
       "host-contract": [
         "./dist/types/host-contract/index.d.ts"
       ],
+      "host-session-collection-contract": [
+        "./dist/types/host-session-collection-contract.d.ts"
+      ],
       "plugin-marketplace-compute": [
         "./dist/types/skills/plugins/plugin-marketplace.d.ts"
       ]
@@ -123,6 +137,7 @@
     "check:windows-hide": "node scripts/check-windows-hide.mjs src",
     "check:test-suite-governance": "node scripts/check-test-suite-governance.mjs",
     "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
+    "check:agent-contract": "node scripts/check-agent-contract-hash.mjs",
     "check:route-a-teardown": "node scripts/check-route-a-teardown.mjs",
     "check:transcript-tool-persistence": "node scripts/check-transcript-tool-persistence.mjs",
     "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",

package/dist/types/cli/agent-config-coordinator.d.ts

@@ -1,27 +0,0 @@
-import { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
-import type { AcpDetector } from "../runtime/infra/acp-detector.js";
-export interface AgentConfigCoordinatorDeps {
-    acpDetector: AcpDetector;
-    getActiveProjectRoot(): string;
-}
-export declare function resolveLlmrouterPublicOrigin(rawBaseUrl?: string): string | undefined;
-export declare function resolveLlmrouterProtocolBaseUrl(agentId: string, rawBaseUrl?: string): string | undefined;
-export declare class AgentConfigCoordinator {
-    private readonly deps;
-    private store;
-    /** Last resolved managed text model (llmrouterModel), to detect primary-model switches. */
-    private lastLlmrouterModel;
-    constructor(deps: AgentConfigCoordinatorDeps);
-    get currentStore(): AgentConfigStore | null;
-    ensureStore(): Promise<AgentConfigStore>;
-    private syncKeySources;
-    /**
-     * When the managed text model (llmrouterModel) actually changes, pooled OpenAI-compat agents
-     * (codex/qwen/opencode) still hold the OLD OPENAI_MODEL baked at spawn. Evict the platform-model
-     * followers — managed (explicit「平台额度」) or auto, NOT explicit account/userKey BYO — so the next
-     * turn respawns on the new model. The model-switch analogue of the credential-switch eviction (Cut 6);
-     * busy turns settle first (handled inside evictPooledAgentsByAgentId). Runs per agents operation via
-     * syncKeySources, so a primary-model switch takes effect on the next message.
-     */
-    private evictModelFollowersIfChanged;
-}

package/dist/types/cli/agent-config-runtime.d.ts

@@ -1,11 +0,0 @@
-import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
-import type { AcpDetector } from "../runtime/infra/acp-detector.js";
-export interface AgentConfigRuntime {
-    readonly currentStore: AgentConfigStore | null;
-    ensureStore(): Promise<AgentConfigStore>;
-}
-export interface AgentConfigRuntimeDeps {
-    acpDetector: AcpDetector;
-    getActiveProjectRoot(): string;
-}
-export declare function createAgentConfigRuntime(deps: AgentConfigRuntimeDeps): AgentConfigRuntime;

package/dist/types/cli/agent-status-notifier.d.ts

@@ -1,11 +0,0 @@
-import type { AgentsStatusNotification } from "../protocol/notifications.js";
-export interface AgentStatusExtra {
-    missedBeats?: number;
-    lastActivityAt?: number;
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-    };
-}
-export declare function createAgentStatusNotification(agentId: string, state: string, extra?: AgentStatusExtra): AgentsStatusNotification;

package/dist/types/cli/handlers/agents-handler.d.ts

@@ -1,121 +0,0 @@
-/**
- * Agents scan/config/gateway/processes/kill handlers — extracted from StdioServer.
- * Handles: agents.scan, agents.list, agents.config, agents.setConfig, agents.getConfig,
- *          agents.removeConfig, agents.setGateway, agents.getGateway, agents.processes,
- *          agents.kill, agents.listConfigured, agents.getLog, agents.testConnection
- */
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-import type { AgentConfigStore } from "../../runtime/infra/agent-config-store.js";
-import { type AcpDetector } from "../../runtime/infra/acp-detector.js";
-import type { DelegateBridge } from "../../orchestration/delegation-coordinator.js";
-export interface AgentsHandlerHost {
-    acpDetector: AcpDetector;
-    ensureAgentConfigStore(): Promise<AgentConfigStore>;
-    getActiveProjectRoot?(): string;
-    handleMcpToolCall?(memberId: string, tool: string, args: Record<string, unknown>): Promise<unknown>;
-    log?(message: string): void;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
-    sendNotification?(method: string, params: Record<string, unknown>): void;
-    /** 激活层(S3c §1.1):gateway-routed delegate 桥(懒读;未挂/gate 关 = undefined → 旧进程池路径)。 */
-    getDelegateBridge?(): DelegateBridge | undefined;
-}
-interface PooledTurnCtx {
-    sessionId?: string;
-    turnId?: string;
-    requestId?: string;
-    deltas: string[];
-    streamedAny: boolean;
-}
-export declare function relayPooledTurnNotification(input: {
-    agentId: string;
-    turn: PooledTurnCtx | null;
-    method: string;
-    payload: unknown;
-    sendNotification?: (method: string, params: Record<string, unknown>) => void;
-}): void;
-/** Resolve a pending external-agent approval with the user's decision (delivered by the gateway). */
-export declare function handleAgentsApprovalResponse(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsScan(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsList(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * Curated Discover-Agent catalog (12 agents) merged with live install status, for the
- * discover grid. Status comes from the detector; install carries the official command
- * summary + source for the confirm dialog (no secrets).
- */
-export declare function handleAgentsCatalog(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsCheckUpdates(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * One-click install a catalog agent by id. Runs ONLY the official command from the
- * catalog manifest (never a free-form command), streaming progress via the
- * agent.install.progress notification, then refreshes detection. Returns the outcome.
- */
-export declare function handleAgentsInstall(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * Open an OS terminal running an agent's interactive login/setup command (e.g. `kimi login`,
- * `hermes acp --setup`). Lowers the barrier for own-store/oauth agents that can't be driven via
- * injected credentials — the user completes the CLI's native login without leaving the app. The
- * command is resolved server-side from the catalog (fixed string, no user input → no injection).
- */
-export declare function handleAgentsRunSetup(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsConfig(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsSetConfig(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsGetConfig(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsRemoveConfig(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * Log out / switch account for an `account`-mode agent: clear the CLI's own native credential store
- * (where we know it — e.g. codex's ~/.codex/auth.json) and invalidate the resident pool so the next
- * turn re-evaluates auth (and re-prompts login). For agents whose store we don't manage, returns a
- * hint to run the CLI's own `logout`. "Switch account" = logout, then log in again.
- */
-export declare function handleAgentsLogout(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsSetGateway(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsGetGateway(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsListConfigured(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsGetLog(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsTestConnection(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/** Formats a session persisted transcript into a compact prior-conversation block for an external
- *  ACP agent that was cold-spawned (fresh process, empty session). Mirrors the built-in agent
- *  withResumedHistory: the engine on-disk history is authoritative, so we re-supply it and the agent
- *  regains full context after a restart/eviction. Only user/assistant text turns are included;
- *  returns "" when there is no prior history (e.g. the first turn of a new session). */
-export declare function buildExternalHistoryPreamble(messages: Array<{
-    role: string;
-    content: unknown;
-}>): string;
-/** Wraps the owner-level global memory cheat sheet (preferences/boundaries) for an external
- *  agent's cold open. Third-party agents (codex/claude/...) run their own brains and never see
- *  our per-turn memory channel — without this, a user's standing preferences vanish the moment
- *  they switch agents. Injection frequency is ONCE PER PROCESS CONTEXT: it rides the same
- *  cold-spawn moment that (re)builds the agent's context (first turn of a session, or a respawn
- *  after restart/eviction — where the full history is re-sent anyway), and never on warm turns.
- *  That is the floor for a stateless external process, not a per-message tax. Size is capped by
- *  readUserIndexForPrompt itself (2048 chars / 40 lines, visible truncation marker). */
-export declare function buildExternalMemoryPreamble(globalIndex: string | null): string;
-/**
- * Decide how a native-cwd session resumes on a COLD spawn, and whether that resume already carries
- * our injected global memory sheet (so the caller can skip re-injecting it). Pure given its inputs.
- *
- *  - BINDING resume (a `nativeBinding.nativeSessionId` persisted by a prior app turn): that prior
- *    turn injected the sheet into the prompt codex/claude recorded in its OWN rollout, so the
- *    restored context carries it → resumedFromBinding=true (skip re-inject).
- *  - LAZY-MIGRATION resume (no binding yet, but the canonical id exists in the native store — a
- *    session the user may have started in codex/claude directly): its rollout has NEVER seen our
- *    sheet → resumedFromBinding=false (inject once; after this turn the binding persists and
- *    subsequent resumes take the binding branch, injecting exactly once total).
- *  - Neither (brand-new session): no resume → inject as a normal cold open.
- *
- * Conflating binding with lazy-migration (resume===bound) silently starves migrated sessions of the
- * user's preferences — the whole point of the injection is that they follow the user across agents.
- */
-export declare function resolveNativeColdResume(input: {
-    sessionId: string;
-    boundNativeSessionId: string | undefined;
-    nativeSessionExists: () => Promise<boolean>;
-}): Promise<{
-    effectiveResume: string | undefined;
-    resumedFromBinding: boolean;
-}>;
-/** Pre-warm an external agent's process (on agent-select) so the first message skips the cold start. */
-export declare function handleAgentsWarm(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleAgentsPrompt(this: AgentsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export {};

package/dist/types/cli/handlers/project-handler.d.ts

@@ -1,36 +0,0 @@
-/**
- * Project CRUD handlers extracted from StdioServer.
- * Handles: project.create, project.list, project.delete, project.rename,
- *          project.archive, project.unarchive
- */
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-import type { ProjectMemoryStore, ProjectMemoryStoreFactory } from "../../runtime/ports/index.js";
-export interface ProjectHandlerHost {
-    memdir: ProjectMemoryStore | null;
-    projectMemoryStoreFactory: ProjectMemoryStoreFactory;
-    mediaPersistence: {
-        setProjectDir(projectDir: string): void;
-        releaseProjectDir?(projectDir: string): void;
-    };
-    getActiveProjectRoot(): string;
-    setActiveWorkdir(dir: string): void;
-    sendNotification(method: string, params: Record<string, unknown>): void;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
-}
-export declare function handleProjectCreate(this: ProjectHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleProjectList(this: ProjectHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleProjectSwitch(this: ProjectHandlerHost, msg: AgentRpcRequest): Promise<void>;
-/**
- * Reliable recursive directory removal for Windows. fs.rmSync({recursive,force}) cannot be trusted
- * here: on git repos it silently leaves read-only object/pack files (and whole subtrees) behind
- * without throwing. This walks bottom-up, clearing the read-only attribute (chmod) on the EPERM
- * retry, which deletes git worktrees/repos cleanly. Per-entry failures (e.g. a live EBUSY lock) are
- * swallowed; the caller verifies via existsSync and decides success/retry.
- */
-export declare function rmDirRobustSync(target: string): void;
-export declare function handleProjectDelete(this: ProjectHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleProjectPurgeAll(this: ProjectHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleProjectRename(this: ProjectHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleProjectArchive(this: ProjectHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleProjectUnarchive(this: ProjectHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleProjectUpdate(this: ProjectHandlerHost, msg: AgentRpcRequest): void;

package/dist/types/cli/project-command-service.d.ts

@@ -1,28 +0,0 @@
-import type { ProjectInfo } from "../protocol/methods.js";
-import type { ProjectMemoryStore, ProjectMemoryStoreFactory } from "../runtime/ports/index.js";
-export interface ProjectCommandHost {
-    memdir: ProjectMemoryStore | null;
-    projectMemoryStoreFactory: ProjectMemoryStoreFactory;
-    mediaPersistence: {
-        setProjectDir(projectDir: string): void;
-    };
-    setActiveWorkdir(dir: string): void;
-}
-export interface ProjectCreateCommand {
-    name: string;
-    workspaceDir?: string;
-    type?: string;
-    groupId?: string;
-}
-export interface ProjectCreateResult {
-    project: ProjectInfo;
-    nameDuplicate?: ProjectInfo;
-    isAgentTeamProject: boolean;
-    /** True when creation switched the active project (container types never switch). */
-    autoSwitched: boolean;
-    deduplicated?: boolean;
-}
-type ProjectPlanStatus = NonNullable<ProjectInfo["planStatus"]>;
-export declare function isProjectPlanStatus(value: unknown): value is ProjectPlanStatus;
-export declare function createProject(host: ProjectCommandHost, command: ProjectCreateCommand): Promise<ProjectCreateResult>;
-export {};

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

@@ -1,100 +0,0 @@
-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;
-}
-export interface DelegationDeps {
-    orchestrator: ProductOrchestrator;
-    cwd: string;
-    notify: DelegationNotify;
-    log?: {
-        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 {
-    private readonly deps;
-    private readonly active;
-    /** Per-(chat×agent) tail promise — the next same-conversation delegation chains after it so they run
-     *  strictly sequentially (single writer to the shared reused worktree + native session). One entry per
-     *  active (chat×agent) pair (keyed, overwritten — not per-delegation), so it stays bounded. */
-    private readonly convChains;
-    /** Per-(chat×agent) native (codex/claude) session id — the background analogue of the foreground U5
-     *  convergence. Seeded from the first delegation's captured session id; passed as resumeNativeSessionId on
-     *  every subsequent same-conversation delegation so context accumulates (git AND non-git projects).
-     *  In-memory (one entry per active pair); an engine restart resets it → the next delegation starts fresh,
-     *  same as a cold foreground turn whose pool was evicted. */
-    private readonly nativeSessions;
-    constructor(deps: DelegationDeps);
-    /** Active + recent delegations for this project (x/mention.list). */
-    list(): {
-        delegationId: string;
-        agentId: string;
-        brief: string;
-        status: DelegationStatus;
-    }[];
-    /** Cancel a running delegation — aborts the poll loop, which drains+kills the worker. */
-    cancel(delegationId: string): {
-        ok: boolean;
-    };
-    /**
-     * Dispatch ONE ad-hoc task to `agentId` in the background. Returns immediately with the delegationId;
-     * the lifecycle (started / settled) is reported via notify(mention.*). An unready/uninstalled agent
-     * surfaces as a `failed` settle (never a thrown RPC).
-     */
-    delegate(agentId: string, brief: string, opts?: {
-        acceptanceCriteria?: string;
-        delegationId?: string;
-        sessionId?: string;
-    }): {
-        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
-     *  the normal terminal path AND the timeout path, so a timed-out run still hands back its partial output. */
-    private collectProducts;
-    private settle;
-}
-export {};