@michengai/dsh-pua 0.3.8

package/lib/args.d.ts

@@ -0,0 +1,34 @@
+import { type FlavorId } from './flavors.js';
+import { type PuaMode } from './content.js';
+import { type ConfigurationPatch } from './configuration.js';
+export type Action = {
+    readonly kind: 'configure';
+    readonly patch: ConfigurationPatch;
+} | {
+    readonly kind: 'activate' | 'review';
+    readonly task: string;
+} | {
+    readonly kind: 'flavor';
+    readonly flavor: FlavorId | 'auto';
+} | {
+    readonly kind: 'mode';
+    readonly mode: PuaMode;
+    readonly task: string;
+} | {
+    readonly kind: 'loop';
+    readonly task: string;
+    readonly maxIterations: number;
+    readonly verify?: string;
+    readonly verificationTimeout?: number;
+} | {
+    readonly kind: 'again' | 'done-check' | 'evidence' | 'kpi' | 'survey';
+    readonly task?: string;
+} | {
+    readonly kind: 'on' | 'off' | 'offline' | 'status' | 'help' | 'flavors' | 'cancel-pua-loop' | 'team-status' | 'reap-orphans' | 'teardown-all';
+};
+/** 解析 /pua 后的文本；普通命令限 8 KiB；结构化配置保留 128 KiB 传输上限并按字段校验。 */
+export declare function parseArgs(raw: string, loopDefaults?: {
+    maxIterations: number;
+    verify: string;
+    verificationTimeout: number;
+}): Action;

package/lib/args.js

@@ -0,0 +1,149 @@
+import { resolveFlavor } from './flavors.js';
+import { MODES } from './content.js';
+import { CONFIG_KEYS, loopStartSchema, parsePatch } from './configuration.js';
+/** 解析 /pua 后的文本；普通命令限 8 KiB；结构化配置保留 128 KiB 传输上限并按字段校验。 */
+export function parseArgs(raw, loopDefaults) {
+    if (Buffer.byteLength(raw, 'utf8') > (/^\s*(?:config|loop-json)\s/u.test(raw) ? 131072 : 8192))
+        throw new Error('输入超过长度限制，请缩短任务或验收命令。');
+    if (/[\u0000-\u0008\u000b\u000c\u000e-\u001f\u007f]/u.test(raw))
+        throw new Error('输入包含不支持的控制字符。');
+    let input = raw.trim();
+    // 兼容用户从帮助中再次粘贴 /pua，但不递归吞掉任意多个前缀。
+    if (/^\/?pua(?::|\s|$)/i.test(input)) {
+        input = input.replace(/^\/?pua(?::|\s+|$)/i, '').trim();
+        if (!input || /^\/?pua(?::|\s|$)/i.test(input))
+            throw new Error('请只输入一次 /pua 前缀，例如 /pua flavor。');
+    }
+    if (!input)
+        return { kind: 'activate', task: '' };
+    const aliases = {
+        '换个方法': { kind: 'again' }, '再试试': { kind: 'again' },
+        '证据呢': { kind: 'evidence' }, '数据在哪': { kind: 'evidence' },
+        '没跑测试别说完成': { kind: 'done-check' }, '验收': { kind: 'done-check' },
+    };
+    if (Object.hasOwn(aliases, input))
+        return aliases[input];
+    if (/^(?:你来)?(?:审查|评估|分析)(?:一下)?(?:这个|当前)?(?:项目|仓库|代码)[。！!?？]?$/u.test(input))
+        return { kind: 'review', task: input };
+    const first = /^(\S+)(?:\s+([\s\S]*))?$/.exec(input);
+    const command = first[1].toLowerCase();
+    const rest = (first[2] ?? '').trim();
+    if (command === 'loop-json') {
+        const { verify, ...value } = loopStartSchema.parse(parseJson(rest));
+        return { kind: 'loop', ...value, ...(verify.trim() ? { verify } : {}) };
+    }
+    if (command === 'config')
+        return { kind: 'configure', patch: parsePatch(parseJson(rest)) };
+    if (command === 'reset') {
+        if (rest && !CONFIG_KEYS.includes(rest))
+            throw new Error('未知配置项。');
+        return { kind: 'configure', patch: Object.fromEntries((rest ? [rest] : CONFIG_KEYS).map(key => [key, null])) };
+    }
+    if (command === '--') {
+        if (!rest)
+            throw new Error('-- 后需要任务描述。');
+        return { kind: 'activate', task: rest };
+    }
+    if (command.startsWith('-'))
+        throw new Error('不支持此选项。输入 /pua help 查看用法。');
+    if (command === 'flavor' || command === '味道' || command === '风味') {
+        if (!rest)
+            return { kind: 'flavors' };
+        if (rest === 'auto' || rest === '自动')
+            return { kind: 'flavor', flavor: 'auto' };
+        const flavor = resolveFlavor(rest);
+        if (!flavor)
+            throw new Error('未知风味。输入 /pua flavor 查看可用名称。');
+        return { kind: 'flavor', flavor };
+    }
+    if (command === 'review')
+        return { kind: 'review', task: rest || '审查当前项目' };
+    if (['ding', '钉味', '置身钉内', '置身钉外', '每日一包', '薛定谔的用户', '病态敏捷', '望舒行动'].includes(command))
+        return { kind: 'mode', mode: 'pua', task: `使用钉内/钉外味。${rest}` };
+    if (command === 'loop' || command === 'pua-loop')
+        return parseLoop(rest, loopDefaults);
+    if (MODES.includes(command))
+        return { kind: 'mode', mode: command, task: rest };
+    const typos = { in: 'on', onn: 'on', of: 'off', offn: 'off', flavour: 'flavor', flaver: 'flavor', falvor: 'flavor', stauts: 'status', stats: 'status', agian: 'again' };
+    if (Object.hasOwn(typos, command) && (!rest || command.length >= 4))
+        throw new Error(`可能想输入 /pua ${typos[command]}。若确实要把原文作为任务，请使用 /pua -- ${input}。`);
+    switch (command) {
+        case 'again':
+        case 'done-check':
+        case 'evidence':
+        case 'kpi':
+        case 'survey':
+            return rest ? { kind: command, task: rest } : { kind: command };
+        case 'on':
+        case 'off':
+        case 'offline':
+        case 'status':
+        case 'help':
+        case 'cancel-pua-loop':
+        case 'team-status':
+        case 'reap-orphans':
+        case 'teardown-all':
+            if (rest)
+                throw new Error(`${command} 不接受额外参数；任务以此单词开头时请使用 /pua -- 任务描述。`);
+            return { kind: command };
+        default:
+            return { kind: 'activate', task: input };
+    }
+}
+/** 循环配置从用户原生命令读取，模型不能通过输出修改独立验证条件。 */
+function parseLoop(input, defaults) {
+    const tokens = [];
+    const lexer = /\s*(?:"((?:\\"|[^"])*)"|'([^']*)'|([^\s"']+))(?=\s|$)/gyu;
+    let offset = 0;
+    while (offset < input.trimEnd().length) {
+        lexer.lastIndex = offset;
+        const match = lexer.exec(input);
+        if (!match)
+            throw new Error('Loop 参数引号未闭合或格式无效，请将任务和完整验证命令分别放在引号中。');
+        tokens.push(match[1] !== undefined ? match[1].replaceAll('\\"', '"') : (match[2] ?? match[3]));
+        offset = lexer.lastIndex;
+    }
+    const seen = new Set();
+    let maxIterations = defaults?.maxIterations ?? 0;
+    let verify = defaults?.verify.trim() || undefined;
+    const task = [];
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token === '--max-iterations') {
+            if (seen.has(token))
+                throw new Error('--max-iterations 不能重复。');
+            seen.add(token);
+            const value = tokens[++i];
+            if (!value || !/^\d+$/.test(value) || Number(value) > 10000)
+                throw new Error('--max-iterations 必须为 0–10000；0 表示按原版不限轮次。');
+            maxIterations = Number(value);
+        }
+        else if (token === '--verify') {
+            if (seen.has(token))
+                throw new Error('--verify 不能重复。');
+            seen.add(token);
+            const value = tokens[++i];
+            if (value === undefined || value.startsWith('--'))
+                throw new Error('--verify 后需要带引号的验证命令。');
+            verify = value;
+            if (!verify.trim())
+                throw new Error('验证命令不能为空。');
+        }
+        else if (token.startsWith('--'))
+            throw new Error(`不支持循环选项：${token}`);
+        else
+            task.push(token);
+    }
+    if (!task.join(' ').trim())
+        throw new Error('loop 需要任务描述，例如 /pua loop "修复测试" --verify "npm test" --max-iterations 10。');
+    return { kind: 'loop', task: task.join(' ').trim(), maxIterations, ...(verify === undefined ? {} : { verify }), ...(defaults ? { verificationTimeout: defaults.verificationTimeout } : {}) };
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error('配置 JSON 格式无效，请检查引号、逗号和括号。');
+    }
+}
+//# sourceMappingURL=args.js.map

package/lib/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolveFlavor, type FlavorId } from './flavors.js';\nimport { MODES, type PuaMode } from './content.js';\nimport { CONFIG_KEYS, loopStartSchema, parsePatch, type ConfigurationPatch } from './configuration.js';\n\nexport type Action =\n  | { readonly kind: 'configure'; readonly patch: ConfigurationPatch }\n  | { readonly kind: 'activate' | 'review'; readonly task: string }\n  | { readonly kind: 'flavor'; readonly flavor: FlavorId | 'auto' }\n  | { readonly kind: 'mode'; readonly mode: PuaMode; readonly task: string }\n  | { readonly kind: 'loop'; readonly task: string; readonly maxIterations: number; readonly verify?: string; readonly verificationTimeout?: number }\n  | { readonly kind: 'again' | 'done-check' | 'evidence' | 'kpi' | 'survey'; readonly task?: string }\n  | { readonly kind: 'on' | 'off' | 'offline' | 'status' | 'help' | 'flavors' | 'cancel-pua-loop' | 'team-status' | 'reap-orphans' | 'teardown-all' };\n\n/** 解析 /pua 后的文本；普通命令限 8 KiB；结构化配置保留 128 KiB 传输上限并按字段校验。 */\nexport function parseArgs(raw: string, loopDefaults?: { maxIterations: number; verify: string; verificationTimeout: number }): Action {\n  if (Buffer.byteLength(raw, 'utf8') > (/^\\s*(?:config|loop-json)\\s/u.test(raw) ? 131072 : 8192)) throw new Error('输入超过长度限制，请缩短任务或验收命令。');\n  if (/[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]/u.test(raw)) throw new Error('输入包含不支持的控制字符。');\n  let input = raw.trim();\n  // 兼容用户从帮助中再次粘贴 /pua，但不递归吞掉任意多个前缀。\n  if (/^\\/?pua(?::|\\s|$)/i.test(input)) {\n    input = input.replace(/^\\/?pua(?::|\\s+|$)/i, '').trim();\n    if (!input || /^\\/?pua(?::|\\s|$)/i.test(input)) throw new Error('请只输入一次 /pua 前缀，例如 /pua flavor。');\n  }\n  if (!input) return { kind: 'activate', task: '' };\n  const aliases: Record<string, Action> = {\n    '换个方法': { kind: 'again' }, '再试试': { kind: 'again' },\n    '证据呢': { kind: 'evidence' }, '数据在哪': { kind: 'evidence' },\n    '没跑测试别说完成': { kind: 'done-check' }, '验收': { kind: 'done-check' },\n  };\n  if (Object.hasOwn(aliases, input)) return aliases[input]!;\n  if (/^(?:你来)?(?:审查|评估|分析)(?:一下)?(?:这个|当前)?(?:项目|仓库|代码)[。！!?？]?$/u.test(input)) return { kind: 'review', task: input };\n  const first = /^(\\S+)(?:\\s+([\\s\\S]*))?$/.exec(input)!;\n  const command = first[1]!.toLowerCase();\n  const rest = (first[2] ?? '').trim();\n  if (command === 'loop-json') {\n    const { verify, ...value } = loopStartSchema.parse(parseJson(rest));\n    return { kind: 'loop', ...value, ...(verify.trim() ? { verify } : {}) };\n  }\n  if (command === 'config') return { kind: 'configure', patch: parsePatch(parseJson(rest)) };\n  if (command === 'reset') {\n    if (rest && !CONFIG_KEYS.includes(rest as typeof CONFIG_KEYS[number])) throw new Error('未知配置项。');\n    return { kind: 'configure', patch: Object.fromEntries((rest ? [rest] : CONFIG_KEYS).map(key => [key, null])) };\n  }\n  if (command === '--') {\n    if (!rest) throw new Error('-- 后需要任务描述。');\n    return { kind: 'activate', task: rest };\n  }\n  if (command.startsWith('-')) throw new Error('不支持此选项。输入 /pua help 查看用法。');\n  if (command === 'flavor' || command === '味道' || command === '风味') {\n    if (!rest) return { kind: 'flavors' };\n    if (rest === 'auto' || rest === '自动') return { kind: 'flavor', flavor: 'auto' };\n    const flavor = resolveFlavor(rest);\n    if (!flavor) throw new Error('未知风味。输入 /pua flavor 查看可用名称。');\n    return { kind: 'flavor', flavor };\n  }\n  if (command === 'review') return { kind: 'review', task: rest || '审查当前项目' };\n  if (['ding', '钉味', '置身钉内', '置身钉外', '每日一包', '薛定谔的用户', '病态敏捷', '望舒行动'].includes(command)) return { kind: 'mode', mode: 'pua', task: `使用钉内/钉外味。${rest}` };\n  if (command === 'loop' || command === 'pua-loop') return parseLoop(rest, loopDefaults);\n  if (MODES.includes(command as PuaMode)) return { kind: 'mode', mode: command as PuaMode, task: rest };\n  const typos: Record<string, string> = { in: 'on', onn: 'on', of: 'off', offn: 'off', flavour: 'flavor', flaver: 'flavor', falvor: 'flavor', stauts: 'status', stats: 'status', agian: 'again' };\n  if (Object.hasOwn(typos, command) && (!rest || command.length >= 4)) throw new Error(`可能想输入 /pua ${typos[command]}。若确实要把原文作为任务，请使用 /pua -- ${input}。`);\n  switch (command) {\n    case 'again': case 'done-check': case 'evidence': case 'kpi': case 'survey':\n      return rest ? { kind: command, task: rest } : { kind: command };\n    case 'on': case 'off': case 'offline': case 'status': case 'help': case 'cancel-pua-loop': case 'team-status': case 'reap-orphans': case 'teardown-all':\n      if (rest) throw new Error(`${command} 不接受额外参数；任务以此单词开头时请使用 /pua -- 任务描述。`);\n      return { kind: command };\n    default:\n      return { kind: 'activate', task: input };\n  }\n}\n\n/** 循环配置从用户原生命令读取，模型不能通过输出修改独立验证条件。 */\nfunction parseLoop(input: string, defaults?: { maxIterations: number; verify: string; verificationTimeout: number }): Action {\n  const tokens: string[] = [];\n  const lexer = /\\s*(?:\"((?:\\\\\"|[^\"])*)\"|'([^']*)'|([^\\s\"']+))(?=\\s|$)/gyu;\n  let offset = 0;\n  while (offset < input.trimEnd().length) {\n    lexer.lastIndex = offset;\n    const match = lexer.exec(input);\n    if (!match) throw new Error('Loop 参数引号未闭合或格式无效，请将任务和完整验证命令分别放在引号中。');\n    tokens.push(match[1] !== undefined ? match[1].replaceAll('\\\\\"', '\"') : (match[2] ?? match[3])!);\n    offset = lexer.lastIndex;\n  }\n  const seen = new Set<string>();\n  let maxIterations = defaults?.maxIterations ?? 0;\n  let verify: string | undefined = defaults?.verify.trim() || undefined;\n  const task: string[] = [];\n  for (let i = 0; i < tokens.length; i++) {\n    const token = tokens[i]!;\n    if (token === '--max-iterations') {\n      if (seen.has(token)) throw new Error('--max-iterations 不能重复。');\n      seen.add(token);\n      const value = tokens[++i];\n      if (!value || !/^\\d+$/.test(value) || Number(value) > 10000) throw new Error('--max-iterations 必须为 0–10000；0 表示按原版不限轮次。');\n      maxIterations = Number(value);\n    } else if (token === '--verify') {\n      if (seen.has(token)) throw new Error('--verify 不能重复。');\n      seen.add(token);\n      const value = tokens[++i];\n      if (value === undefined || value.startsWith('--')) throw new Error('--verify 后需要带引号的验证命令。');\n      verify = value;\n      if (!verify.trim()) throw new Error('验证命令不能为空。');\n    } else if (token.startsWith('--')) throw new Error(`不支持循环选项：${token}`);\n    else task.push(token);\n  }\n  if (!task.join(' ').trim()) throw new Error('loop 需要任务描述，例如 /pua loop \"修复测试\" --verify \"npm test\" --max-iterations 10。');\n  return { kind: 'loop', task: task.join(' ').trim(), maxIterations, ...(verify === undefined ? {} : { verify }), ...(defaults ? { verificationTimeout: defaults.verificationTimeout } : {}) };\n}\n\nfunction parseJson(text: string): unknown {\n  try { return JSON.parse(text); }\n  catch { throw new Error('配置 JSON 格式无效，请检查引号、逗号和括号。'); }\n}\n"]}

package/lib/client-refresh.d.ts

@@ -0,0 +1,6 @@
+import type { ConfigurationSnapshot, PuaRemoteApi } from './remote-contract.js';
+/** 聊天入口独立读取全局可见性；新会话未就绪时快速重试，稳定后低频同步。 */
+export declare function watchComposerConfiguration(remote: Pick<PuaRemoteApi, 'getGlobal' | 'getSession'>, sessionId: string, onGlobal: (enabled: boolean) => void, onSession: (snapshot: ConfigurationSnapshot) => void, onError?: (message: string) => void): {
+    refresh: () => void;
+    dispose: () => void;
+};

package/lib/client-refresh.js

@@ -0,0 +1,41 @@
+/** 聊天入口独立读取全局可见性；新会话未就绪时快速重试，稳定后低频同步。 */
+export function watchComposerConfiguration(remote, sessionId, onGlobal, onSession, onError = () => { }) {
+    let active = true;
+    let pending = false;
+    let retryDelay = 250;
+    let timer;
+    const refresh = () => {
+        if (!active || pending)
+            return;
+        clearTimeout(timer);
+        pending = true;
+        let failed = false;
+        // 不用 Promise.all 将可见性绑在 Agent 的加载生命周期上。
+        const global = Promise.resolve().then(() => remote.getGlobal()).then(result => {
+            if (!result.ok)
+                throw new Error(result.error.message);
+            if (active) {
+                onGlobal(result.value.values.enabled);
+                onError('');
+            }
+        }).catch(() => { failed = true; if (active)
+            onError('无法读取全局配置，请检查连接或打开插件配置页重试。'); });
+        const session = Promise.resolve().then(() => remote.getSession(sessionId)).then(result => {
+            if (!result.ok)
+                throw new Error(result.error.message);
+            if (active)
+                onSession(result.value);
+        }).catch(() => { failed = true; });
+        void Promise.all([global, session]).then(() => {
+            pending = false;
+            if (!active)
+                return;
+            const delay = failed ? retryDelay : 4000;
+            retryDelay = failed ? Math.min(retryDelay * 2, 4000) : 250;
+            timer = setTimeout(refresh, delay);
+        });
+    };
+    refresh();
+    return { refresh, dispose: () => { active = false; clearTimeout(timer); } };
+}
+//# sourceMappingURL=client-refresh.js.map

package/lib/client-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-refresh.js","sourceRoot":"","sources":["../src/client-refresh.ts"],"names":[],"mappings":"AAEA,yCAAyC;AACzC,MAAM,UAAU,0BAA0B,CACxC,MAAsD,EACtD,SAAiB,EACjB,QAAoC,EACpC,SAAoD,EACpD,UAAqC,GAAG,EAAE,GAAE,CAAC;IAE7C,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,UAAU,GAAG,GAAG,CAAC;IACrB,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,CAAC,MAAM,IAAI,OAAO;YAAE,OAAO;QAC/B,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,wCAAwC;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YAC5E,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,MAAM,EAAE,CAAC;gBAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;QACrE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,MAAM;YAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;YACvF,IAAI,CAAC,MAAM,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACtD,IAAI,MAAM;gBAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5C,OAAO,GAAG,KAAK,CAAC;YAChB,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;YACzC,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC3D,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC","sourcesContent":["import type { ConfigurationSnapshot, PuaRemoteApi } from './remote-contract.js';\n\n/** 聊天入口独立读取全局可见性；新会话未就绪时快速重试，稳定后低频同步。 */\nexport function watchComposerConfiguration(\n  remote: Pick<PuaRemoteApi, 'getGlobal' | 'getSession'>,\n  sessionId: string,\n  onGlobal: (enabled: boolean) => void,\n  onSession: (snapshot: ConfigurationSnapshot) => void,\n  onError: (message: string) => void = () => {},\n): { refresh: () => void; dispose: () => void } {\n  let active = true;\n  let pending = false;\n  let retryDelay = 250;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const refresh = () => {\n    if (!active || pending) return;\n    clearTimeout(timer);\n    pending = true;\n    let failed = false;\n    // 不用 Promise.all 将可见性绑在 Agent 的加载生命周期上。\n    const global = Promise.resolve().then(() => remote.getGlobal()).then(result => {\n      if (!result.ok) throw new Error(result.error.message);\n      if (active) { onGlobal(result.value.values.enabled); onError(''); }\n    }).catch(() => { failed = true; if (active) onError('无法读取全局配置，请检查连接或打开插件配置页重试。'); });\n    const session = Promise.resolve().then(() => remote.getSession(sessionId)).then(result => {\n      if (!result.ok) throw new Error(result.error.message);\n      if (active) onSession(result.value);\n    }).catch(() => { failed = true; });\n    void Promise.all([global, session]).then(() => {\n      pending = false;\n      if (!active) return;\n      const delay = failed ? retryDelay : 4000;\n      retryDelay = failed ? Math.min(retryDelay * 2, 4000) : 250;\n      timer = setTimeout(refresh, delay);\n    });\n  };\n  refresh();\n  return { refresh, dispose: () => { active = false; clearTimeout(timer); } };\n}\n"]}

package/lib/client.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+import type { TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import { type PuaRemoteApi } from './remote-contract.js';
+interface ClientContext {
+    slots: {
+        inject(name: string, register: () => () => void): () => void;
+        register(options: {
+            name: string;
+            id?: string;
+            key?: string;
+            order?: number;
+            label?: string;
+        }, render: (props: {
+            sessionId?: string;
+        }) => React.ReactNode): () => void;
+    };
+    remote: {
+        $mount(contribution: TypertRemoteContribution): Promise<() => void>;
+    };
+    get(name: string): unknown;
+    effect(callback: () => () => void): void;
+}
+export declare const inject: string[];
+/** 两个入口共享字段与校验；会话入口永远不调用全局写入方法。 */
+export declare function ConfigurationPanel({ remote, sessionId }: {
+    remote: PuaRemoteApi;
+    sessionId?: string | undefined;
+}): React.ReactElement;
+export declare function apply(ctx: ClientContext): Promise<() => void>;
+export {};