qlogicagent 2.18.6 → 2.18.8

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

@@ -18,6 +18,9 @@
  */
 import type { Transport } from "./io-transport.js";
 import { type AcpInitializeParams, type AcpInitializeResult, type AcpSessionNewParams, type AcpSessionLoadParams, type AcpSessionNewResult, type AcpSessionPromptParams, type AcpSessionPromptResult, type AcpSessionCloseParams, type AcpSessionSetConfigParams, type AcpSessionUpdateType, type AcpPermissionRequestParams, type AcpPermissionRequestResult } from "../protocol/wire/index.js";
+import { DelegateClient } from "./delegate-client.js";
+import type { HostRequestClient } from "./host-request-client.js";
+import { type HostRequestService } from "../host-contract/index.js";
 export declare const ACP_ERROR_CODES: {
     readonly PARSE_ERROR: -32700;
     readonly INVALID_REQUEST: -32600;
@@ -109,6 +112,8 @@ export interface AcpRequestHandler {
 }
 export interface AcpServerConfig {
     verbose?: boolean;
+    /** Coordinator-owned unary host client used only for response claiming here. */
+    hostRequestClient?: HostRequestClient;
 }
 /**
  * AcpServermanages the ACP protocol state machine.
@@ -130,12 +135,24 @@ export declare class AcpServer {
     private hostSupportsExtendedEvents;
     /** Whether the host supports x/ extended RPC methods */
     private hostSupportsExtendedMethods;
+    /** T9(S3a):host 是否在 initialize 声明服务 gateway-routed delegate(x/delegate 族;设计 §2.4)。 */
+    private hostSupportsDelegate;
+    /** Exact host-request capability negotiated during initialize. */
+    private negotiatedHostRequestCapability;
     /** Sessions registered via session/new on this connection (multi-session per connection). */
     private registeredSessions;
     /** Pending permission requests (agent -> host) waiting for response */
     private pendingPermissions;
     /** Map from outbound JSON-RPC request id -> permissionId for response matching */
     private outboundRequestMap;
+    /**
+     * S3a 跨进程 delegate 客户端(泛化本类的 outbound-request 底座;设计 §5.1)。与审批 outboundRequestMap
+     * 并存:x/delegate 用 `del-*` rpc id,审批用 `perm-*`,handleResponse 先问 delegate 再落审批,互不干扰。
+     * S3c 接线点:DelegationCoordinator.delegate() 改经 `server.delegate.delegate(...)`(本 S3a 只建能力+测,不切)。
+     */
+    private readonly delegateClient;
+    /** Coordinator-owned client reference; AcpServer only offers its response-claim seam. */
+    private readonly hostRequestClient?;
     constructor(transport: Transport, handler: AcpRequestHandler, config?: AcpServerConfig);
     /**
      * Route an incoming raw message through ACP protocol handling.
@@ -164,6 +181,18 @@ export declare class AcpServer {
     get supportsExtendedEvents(): boolean;
     /** Whether the host supports extended methods */
     get supportsExtendedMethods(): boolean;
+    /** T9(S3a):host 是否声明服务 gateway-routed delegate(gate;设计 §2.4)。 */
+    get supportsDelegate(): boolean;
+    /** Exact service check over the initialize capability; no boolean/prefix fallback. */
+    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 只交付+测,不切。
+     */
+    get delegate(): DelegateClient;
     /** Whether a session id has been registered via session/new on this connection. */
     hasSession(sessionId: string): boolean;
     private handleRequest;

package/dist/types/transport/delegate-client.d.ts

@@ -0,0 +1,82 @@
+/**
+ * DelegateClient —— qlogicagent(leader)侧的跨进程 delegate 传输客户端(S3a lane impl-transport-qla)。
+ *
+ * 契约单一事实源:host-contract §12 DelegateWire(冻结,严禁本文件自改契约)。
+ * 设计单一事实源:docs/agent-supervision-s3a-transport-design.md(§3 帧 / §4 保序背压取消失败 / §5.1 两端职责)。
+ *
+ * 方向倒置(设计 §1):今天 qlogicagent→gateway 唯一 outbound 请求 = session/request_permission
+ * (acp-server.ts:247 requestPermission)。本客户端泛化该 outbound-request 底座,新增:
+ *   - `x/delegate`(agent→host 请求,有 id,resolve TurnResult)—— leader 请网关代派一个 worker 回合。
+ *   - `x/delegate.update`(host→agent 通知,回流帧)—— 消费 worker 的 SupervisorEventSink 事件喂 leader。
+ *   - `x/delegate.respond` / `x/delegate.cancel`(agent→host 通知)—— 审批应答 / 取消。
+ *
+ * 不变式落点(设计 §6,注释标 T 号):
+ *   T3/T6 消费方 seq 单调连续校验(跳号=丢帧/乱序,fail-loud);
+ *   T5    请求无客户端硬超时(回合可跑数分钟;挂死靠 gateway 判活 + 下行 lifecycle 暴露,不靠客户端计时);
+ *   T7    结构化 error 保结构(code + data.diagnostics,禁裸串);
+ *   T9    capability 握手 gate:host 未声明 delegate 能力则拒发 x/delegate(fail-loud,不静默降级);
+ *   E1/R1 每帧带权威 member(=to.handle);leader 断言帧 member 与请求一致(不等=路由漂移,fail-loud)。
+ *
+ * 纪律:fail-loud(丢帧/漂移/gate 未过一律炸,不静默);单轨(delegationId 唯一关联主键,无第二关联轴);零 mock。
+ */
+import { type DelegateCancelParams, type DelegateRequestParams, type DelegateRespondParams, type DelegateUpdateFrame, type SupervisorEventSink, type TurnResult } from "../host-contract/index.js";
+import type { AcpJsonRpcNotification, AcpJsonRpcRequest, AcpJsonRpcResponse } from "../protocol/wire/index.js";
+/** 结构化 JSON-RPC error(保留 code + data;T7)。 */
+export type DelegateRpcError = Error & {
+    code?: number;
+    data?: unknown;
+};
+/**
+ * 传输底座(由 AcpServer 注入):把帧写到与 gateway 的 ACP/stdio 双向连接(T1 单通道),
+ * 并暴露 T9 gate(host 是否在 initialize 声明了 delegate 能力位)。
+ */
+export interface DelegateClientTransport {
+    /** 发一帧(请求或通知)到 host(复用现有 ACP/stdio 连接;不开第二通道,T1)。 */
+    send(msg: AcpJsonRpcRequest | AcpJsonRpcNotification): void;
+    /** T9:host 是否在 initialize 声明服务 delegate(否则拒发 x/delegate,fail-loud,不静默降级)。 */
+    hostSupportsDelegate(): boolean;
+}
+export interface DelegateClientOptions {
+    /** 结构化日志出口(默认 stderr;绝不含 prompt/凭据明文)。 */
+    log?: (line: string) => void;
+}
+export declare class DelegateClient {
+    private readonly transport;
+    /** rpc id → 在飞 delegation(x/delegate 终态响应按此匹配)。 */
+    private readonly byRpcId;
+    /** delegationId → 在飞 delegation(x/delegate.update 回流帧按此路由;本地唯一性去重)。 */
+    private readonly byDelegationId;
+    private readonly log;
+    constructor(transport: DelegateClientTransport, options?: DelegateClientOptions);
+    /**
+     * 发 `x/delegate` 请求(agent→host),resolve 出最终 TurnResult。回流事件经 sink 喂 leader。
+     * 【请求即隐式订阅】(设计 §3.1):gateway 收到即开始把该 delegation 的 sink 事件泵成 x/delegate.update
+     * 下行,本客户端按 delegationId 路由到传入 sink。**无客户端硬超时**(T5:回合可跑数分钟)。
+     */
+    delegate(params: DelegateRequestParams, sink: SupervisorEventSink): Promise<TurnResult>;
+    /** 发 `x/delegate.respond`(leader 来源审批应答;通知,fire-and-forget)。optionId 不透明透传(E2)。 */
+    respond(params: DelegateRespondParams): void;
+    /** 发 `x/delegate.cancel`(取消回合,不杀进程;通知)。终态由 gateway 保证下行显式 cancelled(E3)。 */
+    cancel(params: DelegateCancelParams): void;
+    /** 是否有该 delegationId 在飞(观测/测试用)。 */
+    has(delegationId: string): boolean;
+    /**
+     * AcpServer.handleResponse 优先问本客户端是否认领该 rpc 响应(x/delegate 终态)。
+     * 返回 true=已认领并处理;false=非 delegate 响应(调用方继续走审批映射)。
+     */
+    handleResponse(msg: AcpJsonRpcResponse): boolean;
+    /**
+     * AcpServer.handleNotification 收到 `x/delegate.update` 回流帧时调用。
+     * T3/T6 seq 单调连续校验(跳号=丢帧/乱序,fail-loud reject 该 delegation);
+     * E1/R1 member 断言(帧 member 必须 = 请求的 to.handle,不等=路由漂移,fail-loud);
+     * 反序列化 event → 本地 sink 回调(1:1 无损镜像,设计 §3.2)。
+     */
+    handleUpdate(frame: DelegateUpdateFrame): void;
+    /** 连接关闭/重生:拒绝全部在飞 delegation(禁悬挂;调用方据 reject 决定重派)。 */
+    dispose(reason?: string): void;
+    /** 帧 → 本地 SupervisorEventSink 回调(去 member 的 event 重新盖回权威 frame.member,1:1 无损)。 */
+    private dispatchToSink;
+    private forget;
+    private settleResolve;
+    private settleReject;
+}

package/dist/types/transport/host-capability-client.d.ts

@@ -0,0 +1,21 @@
+/** Thin, read-only Capability facade over the coordinator-owned HostRequestClient. */
+import { type HostCapabilityRequestParams, type HostApplyCuratorPlanResult, type HostCuratorTransition, type HostFinalizeSkillInstallResult, type HostPrepareSkillInstallParams, type HostPrepareSkillInstallResult, type HostSkillFileResponse, type HostSkillInvocationResult, type HostSkillMutation, type HostSkillMutationResult, type HostSkillSnapshotResponse } from "../host-contract/index.js";
+export interface HostCapabilityRequester {
+    request(params: HostCapabilityRequestParams): Promise<unknown>;
+}
+export interface HostCapabilityClientConfig {
+    client: HostCapabilityRequester;
+}
+export declare class HostCapabilityClient {
+    private readonly config;
+    constructor(config: HostCapabilityClientConfig);
+    getSkillSnapshot(projectId?: string, knownRevision?: string): Promise<HostSkillSnapshotResponse>;
+    readSkillFile(name: string, relativePath?: string, expectedRevision?: string): Promise<HostSkillFileResponse>;
+    recordSkillInvocation(name: string, success: boolean): Promise<HostSkillInvocationResult>;
+    commitSkillMutation<T extends HostSkillMutation>(mutation: T): Promise<Extract<HostSkillMutationResult, {
+        kind: T["kind"];
+    }>>;
+    applyCuratorPlan(expectedRevision: string, transitions: HostCuratorTransition[]): Promise<HostApplyCuratorPlanResult>;
+    prepareSkillInstall(params: HostPrepareSkillInstallParams): Promise<HostPrepareSkillInstallResult>;
+    finalizeSkillInstall(installationId: string, action: "adopt" | "discard"): Promise<HostFinalizeSkillInstallResult>;
+}

package/dist/types/transport/host-feedback-client.d.ts

@@ -0,0 +1,25 @@
+/** Thin D2 feedback/telemetry facade over the coordinator-owned HostRequestClient. */
+import { type HostDistillableFeedbackEvent, type HostFeedbackRequestParams, type HostFeedbackSweepResult } from "../host-contract/index.js";
+export interface HostFeedbackRequester {
+    request(params: HostFeedbackRequestParams): Promise<unknown>;
+}
+export declare class HostFeedbackClient {
+    private readonly config;
+    constructor(config: {
+        client: HostFeedbackRequester;
+    });
+    commitTurnTelemetry(params: Extract<HostFeedbackRequestParams, {
+        method: "commitTurnTelemetry";
+    }>["params"]): Promise<{
+        ok: true;
+    }>;
+    listDistillableFeedback(projectId: string): Promise<HostDistillableFeedbackEvent[]>;
+    markFeedbackDistilled(projectId: string, turnId: string, info: {
+        clusterKey: string;
+        idempotencyKey: string;
+    }): Promise<{
+        ok: true;
+        updated: boolean;
+    }>;
+    runUploadSweep(projectId: string): Promise<HostFeedbackSweepResult>;
+}

package/dist/types/transport/host-profile-client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Thin profile facade over the coordinator-owned HostRequestClient.
+ * It owns no transport, request ids, timers, or pending table.
+ */
+import type { HostProfileRequestParams } from "../host-contract/index.js";
+export interface HostProfileRequester {
+    request(params: HostProfileRequestParams): Promise<unknown>;
+}
+export interface HostProfileClientConfig {
+    client: HostProfileRequester;
+}
+export declare class HostProfileClient {
+    private readonly config;
+    constructor(config: HostProfileClientConfig);
+    getTunables(): Promise<Record<string, unknown>>;
+    updateTunable(key: string, value: unknown): Promise<void>;
+    clearTunable(key: string): Promise<void>;
+    appendDirectoryAllowRule(pathPrefix: string): Promise<void>;
+}

package/dist/types/transport/host-project-client.d.ts

@@ -0,0 +1,16 @@
+/** Thin project-registry facade over the coordinator-owned HostRequestClient. */
+import { type HostProjectInfo, type HostProjectMutationResult, type HostProjectRequestParams, type HostProjectSnapshotResult } from "../host-contract/index.js";
+export interface HostProjectRequester {
+    request(params: HostProjectRequestParams): Promise<unknown>;
+}
+export declare class HostProjectClient {
+    private readonly client;
+    constructor(client: HostProjectRequester);
+    getSnapshot(): Promise<HostProjectSnapshotResult>;
+    create(params: Extract<HostProjectRequestParams, {
+        method: "create";
+    }>["params"]): Promise<HostProjectMutationResult>;
+    switch(projectIdOrQuery: string): Promise<HostProjectMutationResult>;
+    update(projectId: string, patch: Partial<Pick<HostProjectInfo, "planStatus" | "planAgents" | "planWinnerId" | "leaderSessionId" | "primaryWorkflowId">>): Promise<HostProjectMutationResult>;
+    private mutation;
+}

package/dist/types/transport/host-request-client.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Unary agent-to-host request client over the existing ACP/stdio transport.
+ * Memory/profile requests have no implicit timeout; callers with bounded work
+ * (notably preview) provide a per-request timeout explicitly.
+ */
+import { type HostRequestParams } from "../host-contract/index.js";
+import type { AcpJsonRpcNotification, AcpJsonRpcRequest, AcpJsonRpcResponse } from "../protocol/wire/index.js";
+export type HostRequestRpcError = Error & {
+    code?: number;
+    data?: unknown;
+};
+export interface HostRequestClientTransport {
+    send(msg: AcpJsonRpcRequest | AcpJsonRpcNotification): void;
+    hostRequestCapability(): unknown;
+}
+export interface HostRequestClientOptions {
+    log?: (line: string) => void;
+}
+export interface HostRequestOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare class HostRequestClient {
+    private readonly transport;
+    private readonly byRpcId;
+    private readonly log;
+    private disposedReason;
+    constructor(transport: HostRequestClientTransport, options?: HostRequestClientOptions);
+    request(params: HostRequestParams, opts?: HostRequestOptions): Promise<unknown>;
+    get pendingCount(): number;
+    handleResponse(msg: AcpJsonRpcResponse): boolean;
+    /** Cancel only one service lane; preview follows turn cancellation while durable store work does not. */
+    cancelByService(service: HostRequestParams["service"], reason?: string): void;
+    dispose(reason?: string): void;
+    private cleanup;
+    private settleResolve;
+    private settleReject;
+}

package/dist/types/transport/host-session-client.d.ts

@@ -0,0 +1,29 @@
+/** Thin Session persistence facade over the coordinator-owned HostRequestClient. */
+import { type HostSessionAppendResult, type HostSessionGroupSplitResult, type HostSessionLoadForResumeResult, type HostSessionMutationResult, type HostSessionRequestParams } from "../host-contract/index.js";
+export interface HostSessionRequester {
+    request(params: HostSessionRequestParams): Promise<unknown>;
+}
+export interface HostSessionClientConfig {
+    client: HostSessionRequester;
+}
+type AppendParams = Extract<HostSessionRequestParams, {
+    method: "appendTranscript";
+}>["params"];
+type StateUsage = Extract<HostSessionRequestParams, {
+    method: "saveState";
+}>["params"]["usage"];
+type SplitParams = Extract<HostSessionRequestParams, {
+    method: "groupSplit";
+}>["params"];
+export declare class HostSessionClient {
+    private readonly config;
+    constructor(config: HostSessionClientConfig);
+    loadForResume(sessionId: string, projectId?: string, includeMessages?: boolean): Promise<HostSessionLoadForResumeResult>;
+    appendTranscript(params: AppendParams): Promise<HostSessionAppendResult>;
+    updateTitle(sessionId: string, operationId: string, title: string): Promise<HostSessionMutationResult>;
+    saveState(sessionId: string, turnId: string, operationId: string, usage: StateUsage, model?: string): Promise<HostSessionMutationResult>;
+    saveTaskSummary(sessionId: string, operationId: string, summary: string, generatedAtTurn: number): Promise<HostSessionMutationResult>;
+    groupSplit(sessionId: string, operationId: string, reason: SplitParams["reason"], cas?: Pick<SplitParams, "expectedLastActiveAt" | "expectedTurnCount">): Promise<HostSessionGroupSplitResult>;
+    private mutation;
+}
+export {};

package/dist/types/tunables.d.ts

@@ -0,0 +1,2 @@
+export { coerceTunableValue, getTunableDefaults, validateTunableKey, validateTunableUpdate, } from "./runtime/config/tunable-defaults.js";
+export type { TunableDefaults, TunableKey, } from "./runtime/config/tunable-defaults.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-  "version": "2.18.6",
+  "version": "2.18.8",
   "description": "XiaozhiClaw Agent CLI — subprocess architecture (JSON-RPC over stdio)",
   "type": "module",
   "main": "dist/index.js",
@@ -32,9 +32,21 @@
       "types": "./dist/types/permissions.d.ts",
       "default": "./dist/permissions.js"
     },
+    "./tunables": {
+      "types": "./dist/types/tunables.d.ts",
+      "default": "./dist/tunables.js"
+    },
     "./pet-contracts": {
       "types": "./dist/types/pet-contracts.d.ts",
       "default": "./dist/pet-contracts.js"
+    },
+    "./host-contract": {
+      "types": "./dist/types/host-contract/index.d.ts",
+      "default": "./dist/host-contract.js"
+    },
+    "./plugin-marketplace-compute": {
+      "types": "./dist/types/skills/plugins/plugin-marketplace.d.ts",
+      "default": "./dist/plugin-marketplace-compute.js"
     }
   },
   "files": [
@@ -57,8 +69,17 @@
       "permissions": [
         "./dist/types/permissions.d.ts"
       ],
+      "tunables": [
+        "./dist/types/tunables.d.ts"
+      ],
       "pet-contracts": [
         "./dist/types/pet-contracts.d.ts"
+      ],
+      "host-contract": [
+        "./dist/types/host-contract/index.d.ts"
+      ],
+      "plugin-marketplace-compute": [
+        "./dist/types/skills/plugins/plugin-marketplace.d.ts"
       ]
     }
   },
@@ -70,7 +91,7 @@
     "start": "node dist/cli.js",
     "test": "vitest run",
     "test:replay": "vitest run benchmarks/transcript-replay",
-    "check": "pnpm run check:encoding-corruption && pnpm run check:mechanical-rules && pnpm run check:windows-hide && tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
+    "check": "pnpm run check:encoding-corruption && pnpm run check:mechanical-rules && pnpm run check:windows-hide && tsc --noEmit && pnpm test && pnpm run check:architecture-boundaries && pnpm run check:route-a-teardown && pnpm run check:transcript-tool-persistence && pnpm run check:provider-core-boundary && pnpm run check:provider-core-release-sync && pnpm run check:pet-core-boundary && pnpm run check:workspace-hygiene && pnpm run check:package-artifact",
     "test:watch": "vitest",
     "benchmark:hermes-superiority": "tsx benchmarks/hermes-superiority/runner.ts",
     "lint": "oxlint .",
@@ -78,6 +99,8 @@
     "check:mechanical-rules": "node scripts/check-mechanical-rules.mjs",
     "check:windows-hide": "node scripts/check-windows-hide.mjs src",
     "check:architecture-boundaries": "node scripts/check-architecture-boundaries.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",
     "check:provider-core-release-sync": "node scripts/check-provider-core-release-sync.mjs",
     "check:pet-core-boundary": "node scripts/check-pet-core-boundary.mjs",
@@ -96,7 +119,7 @@
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
     "@xiaozhiclaw/pet-core": "0.1.3",
-    "@xiaozhiclaw/provider-core": "^0.1.21",
+    "@xiaozhiclaw/provider-core": "^0.1.25",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",
     "ioredis": "^5.11.1",

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

@@ -1,19 +0,0 @@
-import { type AgentRpcError, type AgentRpcRequest } from "../../protocol/wire/index.js";
-export interface SettingsHandlerHost {
-    sendError?(id: string | number, code: number, message: string): void;
-    sendResponse(id: string | number, result?: unknown, error?: AgentRpcError): void;
-    writeClipboard?(text: string): Promise<void>;
-}
-export declare function handleSettingsListProviders(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSettingsAddKey(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSettingsRemoveKey(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSettingsGetKey(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSettingsCopyKey(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSettingsToggleKey(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSettingsToggleModel(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSettingsListModels(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSettingsSetActiveModel(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSettingsGetActiveModel(this: SettingsHandlerHost, msg: AgentRpcRequest): void;
-export declare function handleSettingsGetOverview(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSettingsRefreshModels(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;
-export declare function handleSettingsValidateKey(this: SettingsHandlerHost, msg: AgentRpcRequest): Promise<void>;

package/dist/types/cli/permission-rule-persistence.d.ts

@@ -1,16 +0,0 @@
-/**
- * Persist "始终允许此文件夹" approvals into the USER-level settings.json
- * (`~/.qlogicagent/profiles/<owner>/settings.json` → permissions.rules).
- *
- * Same file config.update writes and the settings-watcher's user layer reads,
- * so a persisted rule survives restarts via loadInitialSettings/watchSettings.
- * turn-permission-sync leaves rules alone when a frame carries only `{ mode }`,
- * so desktop turns cannot wipe these entries.
- */
-/**
- * Append an allow rule for `pathPrefix` to the user settings, preserving the rest
- * of the file. Idempotent: an existing allow rule with the same prefix is kept as-is.
- */
-export declare function persistUserDirectoryAllowRule(rule: {
-    pathPrefix: string;
-}): Promise<void>;

package/dist/types/cli/tunable-store.d.ts

@@ -1,26 +0,0 @@
-/**
- * Tunable override store — the SINGLE write/read path for settings.tunables.
- *
- * Shared by the config.updateTunable RPC (UI settings page) and the `config`
- * tool (conversational tuning), so both go through identical validation,
- * persistence, and runtime sync. Values are hot: ModelRegistry.getTunable()
- * re-reads settings.json on every call, so a persisted override takes effect
- * on the next read with no restart.
- */
-import { type TunableDefaults } from "../runtime/config/tunable-defaults.js";
-/** Read the current override map from settings.json (missing file → empty). */
-export declare function readTunableOverrides(settingsPath: string): Record<string, unknown>;
-/**
- * Validate a tunable update against the declared defaults.
- * Returns an error message, or null when the update is acceptable.
- * Coercible values ("3" → 3, "true" → true) are NOT accepted here —
- * callers wanting leniency must coerce before validating.
- */
-export declare function validateTunableUpdate(key: string, value: unknown): string | null;
-/** Coerce a string value toward the tunable's declared type ("3"→3, "true"→true). */
-export declare function coerceTunableValue(key: string, value: unknown): unknown;
-/** Persist one override into settings.json and sync live runtime state. */
-export declare function writeTunableOverride(settingsPath: string, key: string, value: unknown): Promise<void>;
-/** Remove one override (value falls back to the declared default). */
-export declare function clearTunableOverride(settingsPath: string, key: string): Promise<void>;
-export type { TunableDefaults };

package/dist/types/skills/permissions/settings-watcher.d.ts

@@ -1,26 +0,0 @@
-/**
- * Settings watcher for canonical qlogicagent permission settings.
- *
- * Two layers (CC settings semantics):
- *   - user level    ~/.qlogicagent/profiles/<owner>/settings.json  — where config.update persists
- *   - project level <projectRoot>/.qlogicagent/settings.json       — repo-local overrides
- * The project file's `permissions` object, when present, overrides the user file's.
- * Both layers are watched; either changing re-resolves the effective permissions.
- * (写读同源:此前 config.update 写用户级、watcher 只读项目级,重启后持久模式永远丢失。)
- *
- * Only the `permissions` object is accepted. Removed top-level aliases such as
- * `permissionMode`, `permissionRules`, and `defaultBehavior` must fail loudly.
- */
-import type { HookRegistry } from "../../contracts/hooks.js";
-import type { PermissionRuleEnginePort } from "../../runtime/ports/index.js";
-export interface SettingsFile {
-    permissions?: unknown;
-}
-export interface SettingsWatcherDeps {
-    projectRoot: string;
-    ruleEngine: PermissionRuleEnginePort;
-    hooks?: HookRegistry;
-    log?: (msg: string) => void;
-}
-export declare function watchSettings(deps: SettingsWatcherDeps): () => void;
-export declare function loadInitialSettings(projectRoot: string, ruleEngine: PermissionRuleEnginePort): Promise<SettingsFile | null>;