@octopi-agent/engine 0.90.11 → 0.97.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/dist/config-admin/agent-presets.d.ts +70 -0
  2. package/dist/config-admin/agent-presets.js +243 -0
  3. package/dist/config-admin/discover.d.ts +30 -0
  4. package/dist/config-admin/discover.js +48 -0
  5. package/dist/config-admin/env.d.ts +22 -0
  6. package/dist/config-admin/env.js +41 -0
  7. package/dist/config-admin/index.d.ts +20 -0
  8. package/dist/config-admin/index.js +15 -0
  9. package/dist/config-admin/model-presets.d.ts +75 -0
  10. package/dist/config-admin/model-presets.js +249 -0
  11. package/dist/config-admin/name-guard.d.ts +14 -0
  12. package/dist/config-admin/name-guard.js +24 -0
  13. package/dist/config-admin/patch.d.ts +56 -0
  14. package/dist/config-admin/patch.js +201 -0
  15. package/dist/config-admin/port.d.ts +68 -0
  16. package/dist/config-admin/port.js +21 -0
  17. package/dist/config-admin/redact.d.ts +39 -0
  18. package/dist/config-admin/redact.js +42 -0
  19. package/dist/config-schema/agent.d.ts +43 -1
  20. package/dist/config-schema/context.d.ts +6 -1
  21. package/dist/config-schema/context.js +8 -0
  22. package/dist/config-schema/engine.d.ts +106 -4
  23. package/dist/config-schema/governance.d.ts +43 -1
  24. package/dist/config-schema/governance.js +157 -0
  25. package/dist/config-schema/models.d.ts +5 -2
  26. package/dist/config-schema/models.js +4 -1
  27. package/dist/config-schema/observability.d.ts +9 -0
  28. package/dist/config-schema/observability.js +29 -0
  29. package/dist/config-schema/run.d.ts +3 -0
  30. package/dist/config-schema/run.js +14 -0
  31. package/dist/config.d.ts +29 -4
  32. package/dist/config.js +15 -4
  33. package/dist/harness/activation/dispatcher.d.ts +8 -2
  34. package/dist/harness/activation/dispatcher.js +33 -5
  35. package/dist/harness/activation/inbox.d.ts +87 -0
  36. package/dist/harness/activation/inbox.js +169 -0
  37. package/dist/harness/activation/runtime.d.ts +9 -8
  38. package/dist/harness/activation/runtime.js +100 -8
  39. package/dist/harness/activation/types.d.ts +19 -0
  40. package/dist/harness/activation/types.js +2 -0
  41. package/dist/harness/agent/builder.d.ts +15 -1
  42. package/dist/harness/agent/builder.js +31 -10
  43. package/dist/harness/agent/config-bridge.d.ts +5 -0
  44. package/dist/harness/agent/config-bridge.js +3 -0
  45. package/dist/harness/agent/config-integrity.d.ts +72 -0
  46. package/dist/harness/agent/config-integrity.js +146 -0
  47. package/dist/harness/agent/wire-agent-builder.js +2 -1
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -1
  49. package/dist/harness/collaboration/delegation/child-run.js +21 -5
  50. package/dist/harness/collaboration/delegation/notifier.js +4 -3
  51. package/dist/harness/collaboration/delegation/service.js +2 -3
  52. package/dist/harness/collaboration/delegation/wiring.js +6 -5
  53. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.d.ts +1 -1
  54. package/dist/harness/collaboration/orchestration/reflector/llm-reflector.js +1 -1
  55. package/dist/harness/context/capabilities/compact/engine.d.ts +30 -0
  56. package/dist/harness/context/capabilities/compact/engine.js +198 -46
  57. package/dist/harness/context/capabilities/compact/handover.d.ts +78 -0
  58. package/dist/harness/context/capabilities/compact/handover.js +107 -0
  59. package/dist/harness/context/capabilities/compact/index.d.ts +3 -1
  60. package/dist/harness/context/capabilities/compact/index.js +2 -1
  61. package/dist/harness/context/capabilities/compact/types.d.ts +30 -1
  62. package/dist/harness/context/capabilities/summary/executor.js +2 -1
  63. package/dist/harness/context/capabilities/summary/policies.js +8 -5
  64. package/dist/harness/context/constitution/default-agents.md +11 -10
  65. package/dist/harness/context/default-context-engine.d.ts +34 -4
  66. package/dist/harness/context/default-context-engine.js +194 -49
  67. package/dist/harness/context/hybrid-compressor.js +6 -0
  68. package/dist/harness/context/llm-summarizer.d.ts +2 -8
  69. package/dist/harness/context/llm-summarizer.js +69 -91
  70. package/dist/harness/context/message-selector.js +4 -3
  71. package/dist/harness/context/summarize.d.ts +2 -0
  72. package/dist/harness/context/summarize.js +7 -2
  73. package/dist/harness/context/truncate-compressor.js +7 -0
  74. package/dist/harness/context/turn-envelope.d.ts +3 -2
  75. package/dist/harness/context/turn-envelope.js +3 -2
  76. package/dist/harness/context/types.d.ts +33 -1
  77. package/dist/harness/extension/execution-environment/dangerous-commands.d.ts +28 -0
  78. package/dist/harness/extension/execution-environment/dangerous-commands.js +129 -0
  79. package/dist/harness/extension/execution-environment/effect-policy.d.ts +127 -8
  80. package/dist/harness/extension/execution-environment/effect-policy.js +244 -19
  81. package/dist/harness/extension/execution-environment/index.d.ts +4 -2
  82. package/dist/harness/extension/execution-environment/index.js +2 -1
  83. package/dist/harness/extension/execution-environment/kill-switch.d.ts +34 -0
  84. package/dist/harness/extension/execution-environment/kill-switch.js +46 -0
  85. package/dist/harness/extension/execution-environment/ops-audit.d.ts +200 -0
  86. package/dist/harness/extension/execution-environment/ops-audit.js +338 -0
  87. package/dist/harness/extension/execution-environment/privileged-exec.d.ts +158 -0
  88. package/dist/harness/extension/execution-environment/privileged-exec.js +418 -0
  89. package/dist/harness/extension/execution-environment/process-info.d.ts +180 -0
  90. package/dist/harness/extension/execution-environment/process-info.js +466 -0
  91. package/dist/harness/extension/execution-environment/process-isolation.d.ts +7 -0
  92. package/dist/harness/extension/execution-environment/process-isolation.js +9 -0
  93. package/dist/harness/extension/execution-environment/sandbox.d.ts +109 -0
  94. package/dist/harness/extension/execution-environment/sandbox.js +228 -21
  95. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +1 -1
  96. package/dist/harness/extension/execution-environment/tool-capabilities.js +6 -0
  97. package/dist/harness/extension/execution-environment/types.d.ts +19 -0
  98. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +5 -0
  99. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +33 -0
  100. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +4 -5
  101. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +5 -15
  102. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +3 -0
  103. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +53 -2
  104. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  105. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  106. package/dist/harness/extension/plugin-ecosystem/tools/privileged-tool.d.ts +43 -0
  107. package/dist/harness/extension/plugin-ecosystem/tools/privileged-tool.js +350 -0
  108. package/dist/harness/extension/plugin-ecosystem/tools/process-tools.d.ts +30 -0
  109. package/dist/harness/extension/plugin-ecosystem/tools/process-tools.js +137 -0
  110. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +54 -4
  111. package/dist/harness/governance/human-in-the-loop/decision-cache.js +42 -16
  112. package/dist/harness/governance/security/temp-path.d.ts +9 -0
  113. package/dist/harness/governance/security/temp-path.js +13 -2
  114. package/dist/harness/governance/session-acl/seed-roles.js +14 -0
  115. package/dist/harness/index.d.ts +2 -0
  116. package/dist/harness/index.js +2 -0
  117. package/dist/harness/knowledge/fts.js +1 -2
  118. package/dist/harness/knowledge/index-store.js +59 -9
  119. package/dist/harness/memory/sqlite/keyword-search.d.ts +1 -0
  120. package/dist/harness/memory/sqlite/keyword-search.js +4 -3
  121. package/dist/harness/observability/observer/hub.js +8 -0
  122. package/dist/harness/observability/observer/run-snapshot.js +1 -0
  123. package/dist/harness/observability/observer/types.d.ts +4 -0
  124. package/dist/harness/run/agent/agent.d.ts +7 -0
  125. package/dist/harness/run/agent/agent.js +23 -1
  126. package/dist/harness/run/reliability/fallback-provider.d.ts +117 -5
  127. package/dist/harness/run/reliability/fallback-provider.js +262 -22
  128. package/dist/harness/run/reliability/harness-events.d.ts +24 -1
  129. package/dist/harness/run/reliability/model-error-policy.d.ts +32 -0
  130. package/dist/harness/run/reliability/model-error-policy.js +42 -0
  131. package/dist/harness/run/reliability/provider-wrapper.js +29 -2
  132. package/dist/harness/run/reliability/refusal-guard.d.ts +20 -0
  133. package/dist/harness/run/reliability/refusal-guard.js +102 -0
  134. package/dist/harness/run/reliability/run-agent.js +231 -33
  135. package/dist/harness/run/run-guard/default-run-guard.js +1 -1
  136. package/dist/harness/run/run-scope.d.ts +31 -0
  137. package/dist/harness/run/runner.d.ts +116 -2
  138. package/dist/harness/run/runner.js +547 -41
  139. package/dist/harness/session/attachments/llm-intent.js +2 -1
  140. package/dist/harness/session/tasks/render.d.ts +4 -1
  141. package/dist/harness/session/tasks/render.js +10 -7
  142. package/dist/harness/shared/events/agent-event-map.d.ts +66 -0
  143. package/dist/harness/shared/events/agent-event-map.js +5 -0
  144. package/dist/index.d.ts +3 -3
  145. package/dist/index.js +2 -2
  146. package/dist/integration/agent-runtime/channel-message-source.js +19 -1
  147. package/dist/integration/index.d.ts +2 -0
  148. package/dist/integration/index.js +1 -0
  149. package/dist/integration/observability/loop-watchdog.d.ts +56 -0
  150. package/dist/integration/observability/loop-watchdog.js +177 -0
  151. package/dist/integration/observability/metrics.d.ts +3 -0
  152. package/dist/integration/observability/metrics.js +18 -7
  153. package/dist/integration/providers/anthropic.d.ts +23 -0
  154. package/dist/integration/providers/anthropic.js +97 -12
  155. package/dist/integration/providers/fetch-timeout.d.ts +42 -0
  156. package/dist/integration/providers/fetch-timeout.js +51 -0
  157. package/dist/integration/providers/openai.d.ts +10 -0
  158. package/dist/integration/providers/openai.js +58 -11
  159. package/dist/integration/providers/provider-diagnostics.d.ts +80 -0
  160. package/dist/integration/providers/provider-diagnostics.js +89 -0
  161. package/dist/integration/providers/timeout-coherence.d.ts +52 -0
  162. package/dist/integration/providers/timeout-coherence.js +68 -0
  163. package/dist/integration/providers/wire-dump.d.ts +62 -0
  164. package/dist/integration/providers/wire-dump.js +111 -2
  165. package/dist/integration/storage/jsonl.js +4 -1
  166. package/dist/subsystems/cognition-steward/conceptualize/handler.js +1 -1
  167. package/dist/subsystems/memory-steward/backfill/handler.js +1 -1
  168. package/dist/subsystems/wisdom-steward/formation/handler.js +1 -1
  169. package/package.json +3 -2
@@ -0,0 +1,70 @@
1
+ /**
2
+ * agent 角色模板 —「生成器 + 表单默认值」(arch/config-hot-reload.md §5.2)
3
+ *
4
+ * 核心原则(同 provider 预设):角色模板只在**创建时**渲染出标准 AGENTS.md 初稿
5
+ * 与推荐默认值,确认后落盘;`loadPersona` 零改动,运行时零新概念。
6
+ * 插槽 `{{agentName}}`(agent 名)、`{{addressToUser}}`(对用户的称谓)。
7
+ *
8
+ * @module
9
+ */
10
+ /** 安全组推荐(effectPolicy.mode 四选一) */
11
+ export type EffectMode = 'workspace' | 'project' | 'host' | 'untrusted';
12
+ /** agent 角色模板 */
13
+ export interface AgentRolePreset {
14
+ /** 角色 id */
15
+ id: string;
16
+ /** 展示名 */
17
+ label: string;
18
+ /** 角色说明(向导卡片) */
19
+ description: string;
20
+ /** AGENTS.md 模板(含 {{agentName}} / {{addressToUser}} 插槽) */
21
+ template: string;
22
+ /** 推荐安全组(effectPolicy.mode) */
23
+ recommendedEffectMode: EffectMode;
24
+ /** 推荐默认模型档(models.level 名,可选) */
25
+ recommendedModelLevel?: string;
26
+ /** 推荐特质标签(委派发现用) */
27
+ recommendedTraits?: string[];
28
+ }
29
+ /** 模板插槽 */
30
+ export interface AgentRoleSlots {
31
+ /** agent 名(写入身份段) */
32
+ agentName: string;
33
+ /** 对用户的称谓(写入「Your Human」段) */
34
+ addressToUser: string;
35
+ }
36
+ /** 渲染结果 */
37
+ export interface RenderedAgentRole {
38
+ /** 渲染后的 AGENTS.md 全文(可继续手改后落盘) */
39
+ agentsMd: string;
40
+ recommendedEffectMode: EffectMode;
41
+ recommendedModelLevel?: string;
42
+ recommendedTraits?: string[];
43
+ }
44
+ /** 内置角色模板(随发行版维护;新增角色直接扩表) */
45
+ export declare const BUILTIN_AGENT_ROLE_PRESETS: readonly AgentRolePreset[];
46
+ /**
47
+ * 按 id 取角色模板
48
+ *
49
+ * @param id - 角色 id
50
+ * @returns 模板;未知 id 返回 undefined
51
+ */
52
+ export declare function getAgentRolePreset(id: string): AgentRolePreset | undefined;
53
+ /**
54
+ * 渲染角色模板(生成器语义:产出标准 AGENTS.md 初稿 + 推荐默认值)
55
+ *
56
+ * @param presetId - 内置角色 id
57
+ * @param slots - 插槽值(agent 名、对用户的称谓)
58
+ * @returns 渲染结果(可继续手改后落盘)
59
+ * @throws 未知 presetId 或插槽为空时抛错(fail-loud)
60
+ */
61
+ export declare function renderAgentRole(presetId: string, slots: AgentRoleSlots): RenderedAgentRole;
62
+ /**
63
+ * 渲染任意角色模板(内置或自定义模板共用核心)
64
+ *
65
+ * @param preset - 角色模板
66
+ * @param slots - 插槽值(agent 名、对用户的称谓)
67
+ * @returns 渲染结果
68
+ * @throws 插槽为空时抛错(fail-loud)
69
+ */
70
+ export declare function renderRolePreset(preset: AgentRolePreset, slots: AgentRoleSlots): RenderedAgentRole;
@@ -0,0 +1,243 @@
1
+ /**
2
+ * agent 角色模板 —「生成器 + 表单默认值」(arch/config-hot-reload.md §5.2)
3
+ *
4
+ * 核心原则(同 provider 预设):角色模板只在**创建时**渲染出标准 AGENTS.md 初稿
5
+ * 与推荐默认值,确认后落盘;`loadPersona` 零改动,运行时零新概念。
6
+ * 插槽 `{{agentName}}`(agent 名)、`{{addressToUser}}`(对用户的称谓)。
7
+ *
8
+ * @module
9
+ */
10
+ /** 内置角色模板(随发行版维护;新增角色直接扩表) */
11
+ export const BUILTIN_AGENT_ROLE_PRESETS = [
12
+ {
13
+ id: 'general',
14
+ label: '通用助手',
15
+ description: '全能型日常助手:问答、写作、整理、轻量任务,性格亲切可靠。',
16
+ recommendedEffectMode: 'workspace',
17
+ recommendedModelLevel: 'standard',
18
+ recommendedTraits: ['generalist'],
19
+ template: `# AGENTS.md — {{agentName}}
20
+
21
+ ## Identity
22
+
23
+ You are **{{agentName}}**, a general-purpose AI assistant. Reliable, friendly, and practical.
24
+
25
+ ## Voice
26
+
27
+ - Friendly and natural; concise but never curt.
28
+ - Explain "why", not just "how". Offer options when a decision is needed.
29
+ - Be honest about limitations; never fake completion.
30
+
31
+ ## Your Human
32
+
33
+ - **What to call them:** {{addressToUser}}
34
+ - **Timezone:** follow {{addressToUser}}'s local time for any scheduling.
35
+
36
+ ## Workflow
37
+
38
+ - Understand the request before acting; ask when key information is missing.
39
+ - Break complex work into steps and report progress in phases.
40
+ - Prefer small, reversible steps; confirm before anything irreversible.
41
+ `,
42
+ },
43
+ {
44
+ id: 'researcher',
45
+ label: '研究员',
46
+ description: '深度调研与资料分析:检索、比对、综述、溯源引用,结论谨慎可核查。',
47
+ recommendedEffectMode: 'workspace',
48
+ recommendedModelLevel: 'pro',
49
+ recommendedTraits: ['research', 'analysis'],
50
+ template: `# AGENTS.md — {{agentName}}
51
+
52
+ ## Identity
53
+
54
+ You are **{{agentName}}**, a research analyst. You dig into sources, cross-check facts, and synthesize clear, well-grounded findings.
55
+
56
+ ## Voice
57
+
58
+ - Precise and evidence-first: cite sources, distinguish "documented" from "inferred".
59
+ - Surface uncertainty honestly; never pad weak evidence into confident claims.
60
+ - Structure findings as: conclusion → evidence → caveats.
61
+
62
+ ## Research Discipline
63
+
64
+ - Triangulate: prefer multiple independent sources over a single one.
65
+ - Keep a trail: record where each claim came from so {{addressToUser}} can verify.
66
+ - Contradictory evidence is reported, not buried.
67
+
68
+ ## Your Human
69
+
70
+ - **What to call them:** {{addressToUser}}
71
+ `,
72
+ },
73
+ {
74
+ id: 'coder',
75
+ label: '工程师',
76
+ description: '软件工程主力:设计、实现、调试、重构,重视根因与可维护性。',
77
+ recommendedEffectMode: 'project',
78
+ recommendedModelLevel: 'pro',
79
+ recommendedTraits: ['engineering', 'debugging'],
80
+ template: `# AGENTS.md — {{agentName}}
81
+
82
+ ## Identity
83
+
84
+ You are **{{agentName}}**, a senior software engineer. You design, implement, debug, and review code with discipline.
85
+
86
+ ## Engineering Mindset
87
+
88
+ - **Semantics are contracts**: never blur data categories or smuggle one thing through another's channel.
89
+ - **Causal chains**: state symptom ← mechanism ← root cause before fixing; suppressing symptoms is not a fix.
90
+ - **Evidence, not vibes**: verify with tests and real runs; green tests are evidence, not proof.
91
+ - **Root-cause fixes**: a bug is fixed only when the root cause is removed AND intended behavior stays complete.
92
+
93
+ ## Voice
94
+
95
+ - Technical and concrete: show code, explain trade-offs (maintainability > short-term convenience).
96
+ - Review your own diff line by line before calling work done.
97
+ - When a quick fix and a real fix diverge, say so out loud.
98
+
99
+ ## Your Human
100
+
101
+ - **What to call them:** {{addressToUser}}
102
+ - Discuss large changes (options + trade-offs) before writing code when {{addressToUser}} asks to.
103
+ `,
104
+ },
105
+ {
106
+ id: 'reviewer',
107
+ label: '审查员',
108
+ description: '代码/文档审查专精:逐行挑毛病、验证声明、按严重度输出 findings。',
109
+ recommendedEffectMode: 'workspace',
110
+ recommendedModelLevel: 'pro',
111
+ recommendedTraits: ['review', 'quality'],
112
+ template: `# AGENTS.md — {{agentName}}
113
+
114
+ ## Identity
115
+
116
+ You are **{{agentName}}**, a rigorous reviewer. Your output is findings, not fixes: you verify claims against the actual code/docs.
117
+
118
+ ## Review Discipline
119
+
120
+ - A review report is claims to verify, not orders to obey — check each finding yourself first.
121
+ - For every finding: severity (blocker/major/minor/nit) + location + what's wrong + why it matters + suggested fix.
122
+ - Look for: correctness bugs, broken contracts, consumer/blast-radius misses, security leaks, dead semantics.
123
+ - If something looks wrong but context is insufficient, list it as "to verify" — don't guess.
124
+
125
+ ## Voice
126
+
127
+ - Adversarial but constructive; never soften a blocker, never inflate a nit.
128
+ - Quote the exact code line you are judging.
129
+
130
+ ## Your Human
131
+
132
+ - **What to call them:** {{addressToUser}}
133
+ `,
134
+ },
135
+ {
136
+ id: 'writer',
137
+ label: '写作助手',
138
+ description: '文字打磨:起草、润色、翻译、结构化表达,风格可调。',
139
+ recommendedEffectMode: 'workspace',
140
+ recommendedModelLevel: 'standard',
141
+ recommendedTraits: ['writing', 'editing'],
142
+ template: `# AGENTS.md — {{agentName}}
143
+
144
+ ## Identity
145
+
146
+ You are **{{agentName}}**, a writing assistant. You draft, edit, translate, and structure text with a feel for audience and tone.
147
+
148
+ ## Voice
149
+
150
+ - Match the requested register (formal / casual / technical) precisely; ask if unclear.
151
+ - Cut filler ruthlessly; every sentence should earn its place.
152
+ - When editing {{addressToUser}}'s text, preserve their voice — improve clarity, don't rewrite identity.
153
+
154
+ ## Workflow
155
+
156
+ - Confirm audience, purpose, and length before drafting long pieces.
157
+ - Offer 2–3 alternative phrasings for headline/opening choices.
158
+ - Keep terminology consistent across a document.
159
+
160
+ ## Your Human
161
+
162
+ - **What to call them:** {{addressToUser}}
163
+ `,
164
+ },
165
+ {
166
+ id: 'analyst',
167
+ label: '数据分析师',
168
+ description: '数据视角:指标拆解、趋势解读、报表与洞察,结论量化可追溯。',
169
+ recommendedEffectMode: 'workspace',
170
+ recommendedModelLevel: 'pro',
171
+ recommendedTraits: ['data', 'analysis'],
172
+ template: `# AGENTS.md — {{agentName}}
173
+
174
+ ## Identity
175
+
176
+ You are **{{agentName}}**, a data analyst. You turn numbers into decisions: metrics, trends, and quantified insights.
177
+
178
+ ## Analytical Discipline
179
+
180
+ - Define the metric before analyzing it: what exactly is counted, over what window.
181
+ - Separate correlation from causation; state assumptions explicitly.
182
+ - Show the calculation path: {{addressToUser}} must be able to re-derive any number.
183
+
184
+ ## Voice
185
+
186
+ - Lead with the insight, then the evidence. Tables/charts descriptions over raw dumps.
187
+ - Round sensibly; never fake precision the data doesn't have.
188
+
189
+ ## Your Human
190
+
191
+ - **What to call them:** {{addressToUser}}
192
+ `,
193
+ },
194
+ ];
195
+ /**
196
+ * 按 id 取角色模板
197
+ *
198
+ * @param id - 角色 id
199
+ * @returns 模板;未知 id 返回 undefined
200
+ */
201
+ export function getAgentRolePreset(id) {
202
+ return BUILTIN_AGENT_ROLE_PRESETS.find((p) => p.id === id);
203
+ }
204
+ /**
205
+ * 渲染角色模板(生成器语义:产出标准 AGENTS.md 初稿 + 推荐默认值)
206
+ *
207
+ * @param presetId - 内置角色 id
208
+ * @param slots - 插槽值(agent 名、对用户的称谓)
209
+ * @returns 渲染结果(可继续手改后落盘)
210
+ * @throws 未知 presetId 或插槽为空时抛错(fail-loud)
211
+ */
212
+ export function renderAgentRole(presetId, slots) {
213
+ const preset = getAgentRolePreset(presetId);
214
+ if (!preset) {
215
+ throw new Error(`unknown agent role preset: ${presetId}`);
216
+ }
217
+ return renderRolePreset(preset, slots);
218
+ }
219
+ /**
220
+ * 渲染任意角色模板(内置或自定义模板共用核心)
221
+ *
222
+ * @param preset - 角色模板
223
+ * @param slots - 插槽值(agent 名、对用户的称谓)
224
+ * @returns 渲染结果
225
+ * @throws 插槽为空时抛错(fail-loud)
226
+ */
227
+ export function renderRolePreset(preset, slots) {
228
+ const agentName = slots.agentName.trim();
229
+ const addressToUser = slots.addressToUser.trim();
230
+ if (!agentName)
231
+ throw new Error('agentName is required');
232
+ if (!addressToUser)
233
+ throw new Error('addressToUser is required');
234
+ const agentsMd = preset.template
235
+ .replaceAll('{{agentName}}', agentName)
236
+ .replaceAll('{{addressToUser}}', addressToUser);
237
+ return {
238
+ agentsMd,
239
+ recommendedEffectMode: preset.recommendedEffectMode,
240
+ recommendedModelLevel: preset.recommendedModelLevel,
241
+ recommendedTraits: preset.recommendedTraits ? [...preset.recommendedTraits] : undefined,
242
+ };
243
+ }
@@ -0,0 +1,30 @@
1
+ /**
2
+ * 模型清单拉取式发现(arch/config-hot-reload.md §5.1,P1)
3
+ *
4
+ * 连通测试 = 拉取模型列表:成功即证明 baseUrl/key 有效,顺手填充表单清单。
5
+ * openai-completions → `GET {baseUrl}/models`(Bearer);
6
+ * anthropic-messages → `GET {baseUrl}/v1/models`(x-api-key + anthropic-version)。
7
+ *
8
+ * @module
9
+ */
10
+ /** 发现请求 */
11
+ export interface DiscoverModelsRequest {
12
+ baseUrl: string;
13
+ apiKey: string;
14
+ api: 'openai-completions' | 'anthropic-messages';
15
+ /** 超时(毫秒),缺省 10s */
16
+ timeoutMs?: number;
17
+ }
18
+ /** 发现结果(失败不抛错:UI 需要展示原因) */
19
+ export interface DiscoverModelsResult {
20
+ ok: boolean;
21
+ /** 发现的模型 id 清单(ok=false 时为空) */
22
+ models: Array<{
23
+ id: string;
24
+ name?: string;
25
+ }>;
26
+ /** 失败原因(ok=true 时 undefined) */
27
+ error?: string;
28
+ }
29
+ /** 拉取模型清单(连通测试同源) */
30
+ export declare function discoverProviderModels(req: DiscoverModelsRequest): Promise<DiscoverModelsResult>;
@@ -0,0 +1,48 @@
1
+ /**
2
+ * 模型清单拉取式发现(arch/config-hot-reload.md §5.1,P1)
3
+ *
4
+ * 连通测试 = 拉取模型列表:成功即证明 baseUrl/key 有效,顺手填充表单清单。
5
+ * openai-completions → `GET {baseUrl}/models`(Bearer);
6
+ * anthropic-messages → `GET {baseUrl}/v1/models`(x-api-key + anthropic-version)。
7
+ *
8
+ * @module
9
+ */
10
+ /** 拉取模型清单(连通测试同源) */
11
+ export async function discoverProviderModels(req) {
12
+ const base = req.baseUrl.replace(/\/+$/, '');
13
+ const url = req.api === 'anthropic-messages' ? `${base}/v1/models` : `${base}/models`;
14
+ const headers = {};
15
+ if (req.api === 'anthropic-messages') {
16
+ if (req.apiKey)
17
+ headers['x-api-key'] = req.apiKey;
18
+ headers['anthropic-version'] = '2023-06-01';
19
+ }
20
+ else if (req.apiKey) {
21
+ headers['Authorization'] = `Bearer ${req.apiKey}`;
22
+ }
23
+ const controller = new AbortController();
24
+ const timer = setTimeout(() => controller.abort(), req.timeoutMs ?? 10_000);
25
+ try {
26
+ const res = await fetch(url, { headers, signal: controller.signal });
27
+ if (!res.ok) {
28
+ return { ok: false, models: [], error: `HTTP ${res.status} ${res.statusText}` };
29
+ }
30
+ const body = (await res.json());
31
+ // openai 兼容为 { data: [...] };anthropic 为 { models: [...] }
32
+ const items = body.data ?? body.models ?? [];
33
+ const models = items
34
+ .filter((m) => typeof m?.id === 'string' && m.id.length > 0)
35
+ .map((m) => ({ id: m.id, name: m.name ?? m.display_name }));
36
+ return { ok: true, models };
37
+ }
38
+ catch (err) {
39
+ return {
40
+ ok: false,
41
+ models: [],
42
+ error: err instanceof Error ? err.message : String(err),
43
+ };
44
+ }
45
+ finally {
46
+ clearTimeout(timer);
47
+ }
48
+ }
@@ -0,0 +1,22 @@
1
+ /**
2
+ * `${ENV}` 占位符展开 — 根包 loadConfig/FileConfigService 与 gateway 热应用共用
3
+ * (唯一实现点;gateway 不能 import 根包,故置 engine)
4
+ *
5
+ * @module
6
+ */
7
+ /**
8
+ * 展开文本中的 `${ENV_VAR}` / `${ENV_VAR:-default}` 占位符
9
+ *
10
+ * @param text - 含占位符的文本(或整份配置原文)
11
+ * @returns 展开后的文本;未设置且无默认值 → 空串(apiKey 等字段由校验兜底)
12
+ */
13
+ export declare function expandEnvPlaceholders(text: string): string;
14
+ /**
15
+ * 递归展开对象/数组内所有字符串值的 `${ENV}`(blocker 修复:热应用路径的 provider
16
+ * 配置必须用展开形态——`createProviderFromConfig` 不做展开,raw 字面量会直接进
17
+ * Authorization 头。盘上写回仍保持 raw 占位符形态,仅运行时实例用本函数。)
18
+ *
19
+ * @param value - 任意配置值
20
+ * @returns 展开后的副本(原对象不被修改)
21
+ */
22
+ export declare function expandEnvValues<T>(value: T): T;
@@ -0,0 +1,41 @@
1
+ /**
2
+ * `${ENV}` 占位符展开 — 根包 loadConfig/FileConfigService 与 gateway 热应用共用
3
+ * (唯一实现点;gateway 不能 import 根包,故置 engine)
4
+ *
5
+ * @module
6
+ */
7
+ const ENV_PATTERN = /\$\{(\w+)(?::-(.*?))?\}/g;
8
+ /**
9
+ * 展开文本中的 `${ENV_VAR}` / `${ENV_VAR:-default}` 占位符
10
+ *
11
+ * @param text - 含占位符的文本(或整份配置原文)
12
+ * @returns 展开后的文本;未设置且无默认值 → 空串(apiKey 等字段由校验兜底)
13
+ */
14
+ export function expandEnvPlaceholders(text) {
15
+ return text.replace(ENV_PATTERN, (_, key, defaultVal) => {
16
+ const val = process.env[key];
17
+ if (val !== undefined)
18
+ return val;
19
+ if (defaultVal !== undefined)
20
+ return defaultVal;
21
+ return '';
22
+ });
23
+ }
24
+ /**
25
+ * 递归展开对象/数组内所有字符串值的 `${ENV}`(blocker 修复:热应用路径的 provider
26
+ * 配置必须用展开形态——`createProviderFromConfig` 不做展开,raw 字面量会直接进
27
+ * Authorization 头。盘上写回仍保持 raw 占位符形态,仅运行时实例用本函数。)
28
+ *
29
+ * @param value - 任意配置值
30
+ * @returns 展开后的副本(原对象不被修改)
31
+ */
32
+ export function expandEnvValues(value) {
33
+ if (typeof value === 'string')
34
+ return expandEnvPlaceholders(value);
35
+ if (Array.isArray(value))
36
+ return value.map((v) => expandEnvValues(v));
37
+ if (value !== null && typeof value === 'object') {
38
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, expandEnvValues(v)]));
39
+ }
40
+ return value;
41
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * config-admin — 配置管理面纯逻辑(arch/config-hot-reload.md)
3
+ *
4
+ * 段级 raw JSON 读写 / 乐观锁 hash / 脱敏 / provider 预设展开。
5
+ * 文件 IO 在根包 FileConfigService;本模块纯函数无 IO,可独立测试。
6
+ *
7
+ * @module
8
+ */
9
+ export { assertSafeConfigName } from './name-guard.js';
10
+ export { BUILTIN_AGENT_ROLE_PRESETS, getAgentRolePreset, renderAgentRole, } from './agent-presets.js';
11
+ export type { AgentRolePreset, AgentRoleSlots, RenderedAgentRole, EffectMode, } from './agent-presets.js';
12
+ export { BUILTIN_MODEL_PRESETS, getProviderPreset, listProviderPresets, expandProviderPreset, } from './model-presets.js';
13
+ export type { ModelPresetModel, ProviderPreset } from './model-presets.js';
14
+ export { redactSecret, redactProvider } from './redact.js';
15
+ export type { RedactedSecret, RedactedProvider } from './redact.js';
16
+ export { computeConfigHash, getJsonPath, setJsonPath, deleteJsonPath, findProviderReferences, } from './patch.js';
17
+ export { ConfigConflictError } from './port.js';
18
+ export type { ConfigAdminPort, ConfigAdminSnapshot, ConfigAdminWriteResult, } from './port.js';
19
+ export { discoverProviderModels } from './discover.js';
20
+ export type { DiscoverModelsRequest, DiscoverModelsResult } from './discover.js';
@@ -0,0 +1,15 @@
1
+ /**
2
+ * config-admin — 配置管理面纯逻辑(arch/config-hot-reload.md)
3
+ *
4
+ * 段级 raw JSON 读写 / 乐观锁 hash / 脱敏 / provider 预设展开。
5
+ * 文件 IO 在根包 FileConfigService;本模块纯函数无 IO,可独立测试。
6
+ *
7
+ * @module
8
+ */
9
+ export { assertSafeConfigName } from './name-guard.js';
10
+ export { BUILTIN_AGENT_ROLE_PRESETS, getAgentRolePreset, renderAgentRole, } from './agent-presets.js';
11
+ export { BUILTIN_MODEL_PRESETS, getProviderPreset, listProviderPresets, expandProviderPreset, } from './model-presets.js';
12
+ export { redactSecret, redactProvider } from './redact.js';
13
+ export { computeConfigHash, getJsonPath, setJsonPath, deleteJsonPath, findProviderReferences, } from './patch.js';
14
+ export { ConfigConflictError } from './port.js';
15
+ export { discoverProviderModels } from './discover.js';
@@ -0,0 +1,75 @@
1
+ /**
2
+ * provider 预设清单 —「生成器 + 表单默认值」(arch/config-hot-reload.md §5.1)
3
+ *
4
+ * 核心原则:预设只在**创建时**把表单预填成 `ModelProviderConfig` 片段,
5
+ * 确认后展开写入 octopi.json,与手写配置完全同构。预设不是运行时配置源,
6
+ * 不引入第二真相源——运行时不感知本模块。
7
+ *
8
+ * 模型参数(contextWindow / maxTokens)为**参考值**,以厂商文档为准;
9
+ * 表单允许逐字段覆盖,错了不致命(只影响路由与截断预算)。
10
+ *
11
+ * @module
12
+ */
13
+ /** 预设中的单个模型条目(参数为参考值,可改) */
14
+ export interface ModelPresetModel {
15
+ /** 模型 id(请求时的 model 字段) */
16
+ id: string;
17
+ /** 展示名 */
18
+ name: string;
19
+ /** 是否推理模型 */
20
+ reasoning?: boolean;
21
+ /** 输入模态 */
22
+ input?: Array<'text' | 'image' | 'audio' | 'video'>;
23
+ /** 上下文窗口(参考值) */
24
+ contextWindow?: number;
25
+ /** 单次最大输出 tokens(参考值) */
26
+ maxTokens?: number;
27
+ }
28
+ /** provider 预设条目 */
29
+ export interface ProviderPreset {
30
+ /** 预设 id(= 创建后的默认 provider 名) */
31
+ id: string;
32
+ /** 展示名 */
33
+ label: string;
34
+ /** API 协议 */
35
+ api: 'openai-completions' | 'anthropic-messages';
36
+ /** 默认 baseUrl */
37
+ baseUrl: string;
38
+ /** 建议的 apiKey 环境变量名(表单提示用,非绑定) */
39
+ apiKeyEnvHint: string;
40
+ /** 厂商文档链接 */
41
+ docsUrl?: string;
42
+ /** 预置模型清单(参考值) */
43
+ models: ModelPresetModel[];
44
+ /** 自定义模板(空预设):只给骨架,模型清单由用户填写 */
45
+ custom?: boolean;
46
+ }
47
+ /** 内置预设清单(随发行版维护;新增厂商直接扩表) */
48
+ export declare const BUILTIN_MODEL_PRESETS: readonly ProviderPreset[];
49
+ /**
50
+ * 按 id 取预设
51
+ *
52
+ * @param id - 预设 id
53
+ * @returns 预设条目;未知 id 返回 undefined
54
+ */
55
+ export declare function getProviderPreset(id: string): ProviderPreset | undefined;
56
+ /**
57
+ * 列出全部内置预设
58
+ *
59
+ * @returns 预设清单(只读)
60
+ */
61
+ export declare function listProviderPresets(): readonly ProviderPreset[];
62
+ /**
63
+ * 预设展开为 `ModelProviderConfig` 表单默认值(生成器语义)
64
+ *
65
+ * - apiKey 缺省给 `${ENV_HINT}` 引用形态(写回保留占位符,见 arch/config-hot-reload.md §0);
66
+ * 无 env 提示(如 ollama)时为 `''`(不发鉴权)。
67
+ * - `custom` 预设不带默认 models(表单强制用户填写)。
68
+ * - `overrides` 为用户已编辑的表单值,逐字段覆盖预设默认值。
69
+ *
70
+ * @param presetId - 预设 id
71
+ * @param overrides - 用户表单覆盖值(可选)
72
+ * @returns 可写入 octopi.json 的 provider 配置片段
73
+ * @throws 未知 presetId 时抛错(fail-loud,不做静默空对象)
74
+ */
75
+ export declare function expandProviderPreset(presetId: string, overrides?: Partial<import('../config.js').ModelProviderConfig>): import('../config.js').ModelProviderConfig;