plugin-agent-orchestrator 1.1.3 → 1.1.5

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 (218) hide show
  1. package/README.md +204 -114
  2. package/dist/client/index.js +1 -1
  3. package/dist/client-v2/117.7565cff57c39318a.js +10 -0
  4. package/dist/client-v2/214.106635011859dede.js +10 -0
  5. package/dist/client-v2/253.59577b40d9875be0.js +10 -0
  6. package/dist/client-v2/264.7ed8bee71fa5935c.js +10 -0
  7. package/dist/client-v2/{41.ba6e080cc0488143.js → 41.3deb9e57a0f64fc4.js} +1 -1
  8. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  9. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  10. package/dist/client-v2/619.0a2144aaffefe018.js +10 -0
  11. package/dist/client-v2/{70.bda9518881c05360.js → 70.ffff2997c10fd4b0.js} +1 -1
  12. package/dist/client-v2/{794.9bbb8d3a61b2bdf2.js → 794.a67a2614405ba627.js} +1 -1
  13. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  14. package/dist/client-v2/{993.82778b6fd6db3cb1.js → 993.b0688fdc5ccb000a.js} +1 -1
  15. package/dist/client-v2/index.js +1 -1
  16. package/dist/externalVersion.js +8 -7
  17. package/dist/locale/en-US.json +199 -123
  18. package/dist/locale/vi-VN.json +199 -123
  19. package/dist/locale/zh-CN.json +199 -123
  20. package/dist/server/collections/agent-execution-spans.js +55 -0
  21. package/dist/server/collections/agent-harness-profile-versions.js +56 -0
  22. package/dist/server/collections/agent-harness-profiles.js +12 -0
  23. package/dist/server/collections/agent-loop-action-approvals.js +69 -0
  24. package/dist/server/collections/agent-loop-artifacts.js +55 -0
  25. package/dist/server/collections/agent-loop-circuit-states.js +53 -0
  26. package/dist/server/collections/agent-loop-control-settings.js +51 -0
  27. package/dist/server/collections/agent-loop-events.js +27 -0
  28. package/dist/server/collections/agent-loop-path-locks.js +57 -0
  29. package/dist/server/collections/agent-loop-patterns.js +72 -0
  30. package/dist/server/collections/agent-loop-runs.js +170 -3
  31. package/dist/server/collections/agent-loop-steps.js +76 -0
  32. package/dist/server/collections/agent-loop-usage-buckets.js +52 -0
  33. package/dist/server/collections/agent-loop-worktrees.js +55 -0
  34. package/dist/server/collections/skill-executions.js +8 -0
  35. package/dist/server/migrations/{20260427000000-change-packages-to-text.js → 20260427000002-change-packages-to-text.js} +2 -0
  36. package/dist/server/migrations/20260429000000-add-llm-fields.js +3 -2
  37. package/dist/server/migrations/{20260429000000-fix-inputargs-json-to-text.js → 20260429000001-fix-inputargs-json-to-text.js} +14 -6
  38. package/dist/server/migrations/20260503000000-add-orchestrator-trace-fields.js +2 -1
  39. package/dist/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.js +2 -1
  40. package/dist/server/migrations/20260803010000-backfill-loop-control-plane-data.js +262 -0
  41. package/dist/server/plugin.js +54 -150
  42. package/dist/server/resources/agent-harness-profile.js +117 -0
  43. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  44. package/dist/server/resources/agent-loop-approval.js +108 -0
  45. package/dist/server/resources/agent-loop-artifact.js +86 -0
  46. package/dist/server/resources/agent-loop-events-stream.js +130 -0
  47. package/dist/server/resources/agent-loop.js +183 -139
  48. package/dist/server/resources/resource-helpers.js +63 -0
  49. package/dist/server/resources/tracing.js +121 -107
  50. package/dist/server/services/AgentMemoryContextService.js +34 -0
  51. package/dist/server/services/DurableCircuitBreakerService.js +229 -0
  52. package/dist/server/services/HarnessCompiler.js +175 -0
  53. package/dist/server/services/HarnessProfileService.js +233 -0
  54. package/dist/server/services/HarnessSchema.js +194 -0
  55. package/dist/server/services/LoopBudgetService.js +269 -0
  56. package/dist/server/services/LoopControlService.js +139 -0
  57. package/dist/server/services/LoopPatternSchema.js +195 -0
  58. package/dist/server/services/LoopPatternService.js +132 -0
  59. package/dist/server/services/LoopRunRepository.js +285 -0
  60. package/dist/server/services/LoopRunStateMachine.js +478 -0
  61. package/dist/server/services/LoopSchedulerService.js +193 -0
  62. package/dist/server/services/LoopTriggerService.js +165 -0
  63. package/dist/server/services/LoopWorkerService.js +699 -0
  64. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  65. package/dist/server/services/PathLockService.js +288 -0
  66. package/dist/server/services/PluginAiRuntimeAdapter.js +226 -0
  67. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  68. package/dist/server/services/VerificationSchema.js +59 -0
  69. package/dist/server/services/VerificationService.js +235 -0
  70. package/dist/server/services/harness-runtime-policy.js +139 -0
  71. package/dist/server/skill-hub/actions/git-import.js +13 -7
  72. package/dist/server/skill-hub/plugin.js +36 -3
  73. package/dist/server/skill-hub/services/RegistrySkillSnapshotService.js +1 -5
  74. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  75. package/dist/server/utils/ensure-indexes.js +111 -0
  76. package/dist/server/utils/loop-pattern-context.js +56 -0
  77. package/package.json +53 -53
  78. package/src/client/ApprovalsTab.tsx +2 -0
  79. package/src/client/OrchestratorSettings.tsx +55 -0
  80. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  81. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  82. package/src/client/skill-hub/index.tsx +0 -52
  83. package/src/client-v2/components/AgentRunsTab.tsx +100 -18
  84. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  85. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -100
  86. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -125
  87. package/src/client-v2/components/TracingTab.tsx +160 -77
  88. package/src/client-v2/hooks/useApiRequest.ts +28 -8
  89. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  90. package/src/client-v2/plugin.tsx +6 -6
  91. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +11 -6
  92. package/src/locale/en-US.json +199 -123
  93. package/src/locale/vi-VN.json +199 -123
  94. package/src/locale/zh-CN.json +199 -123
  95. package/src/server/__tests__/circuit-breaker.test.ts +248 -169
  96. package/src/server/__tests__/harness-compiler.test.ts +214 -0
  97. package/src/server/__tests__/harness-profile-service.test.ts +167 -0
  98. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  99. package/src/server/__tests__/harness-tool-plan.test.ts +172 -0
  100. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  101. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  102. package/src/server/__tests__/loop-budget-service.test.ts +255 -0
  103. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -0
  104. package/src/server/__tests__/loop-pattern-schema.test.ts +73 -0
  105. package/src/server/__tests__/loop-pattern-service.test.ts +148 -0
  106. package/src/server/__tests__/loop-run-state-machine.test.ts +101 -0
  107. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  108. package/src/server/__tests__/loop-worker-claim.test.ts +341 -0
  109. package/src/server/__tests__/loop-worker-execution.test.ts +317 -0
  110. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  111. package/src/server/__tests__/path-lock-service.test.ts +254 -0
  112. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  113. package/src/server/__tests__/smoke.test.ts +162 -121
  114. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  115. package/src/server/collections/agent-execution-spans.ts +55 -0
  116. package/src/server/collections/agent-harness-profile-versions.ts +26 -0
  117. package/src/server/collections/agent-harness-profiles.ts +71 -59
  118. package/src/server/collections/agent-loop-action-approvals.ts +39 -0
  119. package/src/server/collections/agent-loop-artifacts.ts +25 -0
  120. package/src/server/collections/agent-loop-circuit-states.ts +23 -0
  121. package/src/server/collections/agent-loop-control-settings.ts +21 -0
  122. package/src/server/collections/agent-loop-events.ts +98 -71
  123. package/src/server/collections/agent-loop-path-locks.ts +27 -0
  124. package/src/server/collections/agent-loop-patterns.ts +42 -0
  125. package/src/server/collections/agent-loop-runs.ts +170 -3
  126. package/src/server/collections/agent-loop-steps.ts +76 -0
  127. package/src/server/collections/agent-loop-usage-buckets.ts +22 -0
  128. package/src/server/collections/agent-loop-worktrees.ts +25 -0
  129. package/src/server/collections/skill-executions.ts +8 -0
  130. package/src/server/migrations/{20260427000000-change-packages-to-text.ts → 20260427000002-change-packages-to-text.ts} +52 -49
  131. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -46
  132. package/src/server/migrations/{20260429000000-fix-inputargs-json-to-text.ts → 20260429000001-fix-inputargs-json-to-text.ts} +45 -38
  133. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -32
  134. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -30
  135. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -0
  136. package/src/server/plugin.ts +55 -167
  137. package/src/server/resources/agent-harness-profile.ts +94 -0
  138. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  139. package/src/server/resources/agent-loop-approval.ts +84 -0
  140. package/src/server/resources/agent-loop-artifact.ts +56 -0
  141. package/src/server/resources/agent-loop-events-stream.ts +105 -0
  142. package/src/server/resources/agent-loop.ts +204 -143
  143. package/src/server/resources/agent-monitor.ts +482 -482
  144. package/src/server/resources/resource-helpers.ts +33 -0
  145. package/src/server/resources/tracing.ts +266 -258
  146. package/src/server/services/AgentMemoryContextService.ts +44 -0
  147. package/src/server/services/DurableCircuitBreakerService.ts +239 -0
  148. package/src/server/services/ExecutionSpanService.ts +2 -0
  149. package/src/server/services/HarnessCompiler.ts +170 -0
  150. package/src/server/services/HarnessProfileService.ts +239 -0
  151. package/src/server/services/HarnessSchema.ts +194 -0
  152. package/src/server/services/LoopBudgetService.ts +275 -0
  153. package/src/server/services/LoopControlService.ts +124 -0
  154. package/src/server/services/LoopPatternSchema.ts +185 -0
  155. package/src/server/services/LoopPatternService.ts +143 -0
  156. package/src/server/services/LoopRunRepository.ts +336 -0
  157. package/src/server/services/LoopRunStateMachine.ts +529 -0
  158. package/src/server/services/LoopSchedulerService.ts +199 -0
  159. package/src/server/services/LoopTriggerService.ts +157 -0
  160. package/src/server/services/LoopWorkerService.ts +822 -0
  161. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  162. package/src/server/services/PathLockService.ts +321 -0
  163. package/src/server/services/PluginAiRuntimeAdapter.ts +332 -0
  164. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  165. package/src/server/services/VerificationSchema.ts +31 -0
  166. package/src/server/services/VerificationService.ts +264 -0
  167. package/src/server/services/harness-runtime-policy.ts +141 -0
  168. package/src/server/skill-hub/actions/__tests__/git-import.test.ts +15 -1
  169. package/src/server/skill-hub/actions/git-import.ts +9 -3
  170. package/src/server/skill-hub/plugin.ts +41 -3
  171. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -239
  172. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -63
  173. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  174. package/src/server/utils/ensure-indexes.ts +96 -0
  175. package/src/server/utils/logging.ts +62 -63
  176. package/src/server/utils/loop-pattern-context.ts +20 -0
  177. package/dist/client-v2/214.79650a549273f163.js +0 -10
  178. package/dist/client-v2/253.9f0537713cee9e6c.js +0 -10
  179. package/dist/client-v2/264.718a107e43fc163c.js +0 -10
  180. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  181. package/dist/client-v2/418.ce8f5b2b8a229d1d.js +0 -10
  182. package/dist/client-v2/53.7c29c28043e9112d.js +0 -10
  183. package/dist/client-v2/619.bd3c5698b40705c3.js +0 -10
  184. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  185. package/dist/client-v2/925.f5370de8f6632d65.js +0 -10
  186. package/dist/server/services/AgentHarness.js +0 -81
  187. package/dist/server/services/AgentLoopController.js +0 -1023
  188. package/dist/server/services/AgentLoopRepository.js +0 -192
  189. package/dist/server/services/AgentLoopService.js +0 -142
  190. package/dist/server/services/AgentPlanValidator.js +0 -99
  191. package/dist/server/services/AgentPlannerService.js +0 -99
  192. package/dist/server/services/CircuitBreaker.js +0 -125
  193. package/dist/server/services/ContextAggregator.js +0 -201
  194. package/dist/server/services/PlanningPromptService.js +0 -95
  195. package/dist/server/tools/agent-loop.js +0 -373
  196. package/dist/server/tools/orchestrator-plan.js +0 -254
  197. package/src/client/AIEmployeeSelect.tsx +0 -47
  198. package/src/client/AIEmployeesContext.tsx +0 -102
  199. package/src/client/RulesTab.tsx +0 -2
  200. package/src/client/TracingTab.tsx +0 -436
  201. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  202. package/src/client-v2/components/RulesTab.tsx +0 -2
  203. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
  204. package/src/server/__tests__/agent-loop-controller.test.ts +0 -375
  205. package/src/server/__tests__/context-aggregator.test.ts +0 -222
  206. package/src/server/__tests__/parallel-execution.test.ts +0 -318
  207. package/src/server/__tests__/planning-prompt-service.test.ts +0 -23
  208. package/src/server/services/AgentHarness.ts +0 -67
  209. package/src/server/services/AgentLoopController.ts +0 -1263
  210. package/src/server/services/AgentLoopRepository.ts +0 -178
  211. package/src/server/services/AgentLoopService.ts +0 -177
  212. package/src/server/services/AgentPlanValidator.ts +0 -73
  213. package/src/server/services/AgentPlannerService.ts +0 -80
  214. package/src/server/services/CircuitBreaker.ts +0 -126
  215. package/src/server/services/ContextAggregator.ts +0 -239
  216. package/src/server/services/PlanningPromptService.ts +0 -72
  217. package/src/server/tools/agent-loop.ts +0 -360
  218. package/src/server/tools/orchestrator-plan.ts +0 -255
@@ -1,239 +1,235 @@
1
- import { createHash } from 'crypto';
2
-
3
- import type { Database } from '@nocobase/database';
4
-
5
- type JsonValue = boolean | number | string | null | JsonValue[] | { [key: string]: JsonValue };
6
-
7
- export interface RegistrySkillSnapshotSummary {
8
- id: string;
9
- }
10
-
11
- export interface RegistrySkillSnapshot {
12
- id: string;
13
- name: string;
14
- title: string;
15
- description: string;
16
- language: 'python' | 'node';
17
- suggestedVersion?: string;
18
- inputSchema: JsonValue;
19
- instructions: string;
20
- files: Array<{ path: string; content: Buffer }>;
21
- portable: boolean;
22
- reason?: string;
23
- revision: string;
24
- dependencies: JsonValue;
25
- }
26
-
27
- type DefinitionModel = {
28
- get(attribute: string): unknown;
29
- };
30
-
31
- function positiveLimit(value: string | undefined, fallback: number, maximum: number): number {
32
- const parsed = Number(value);
33
- return Number.isSafeInteger(parsed) && parsed > 0 && parsed <= maximum ? parsed : fallback;
34
- }
35
-
36
- const MAX_REGISTRY_SKILL_SNAPSHOTS = positiveLimit(
37
- process.env.SKILL_REGISTRY_MAX_SOURCE_ITEMS,
38
- 1000,
39
- 10_000,
40
- );
41
- const MAX_REGISTRY_TEXT_BYTES = 10 * 1024 * 1024;
42
-
43
- const registryExportFilter = {
44
- registryPackageId: null,
45
- registryVersionId: null,
46
- registryInstallationId: null,
47
- registryInstallStatus: null,
48
- registryExportEnabled: true,
49
- };
50
-
51
- export const REGISTRY_EXPORT_NOT_GRANTED = 'REGISTRY_EXPORT_NOT_GRANTED';
52
- export const REGISTRY_EXPORT_LIMIT_EXCEEDED = 'REGISTRY_EXPORT_LIMIT_EXCEEDED';
53
-
54
- export class RegistryExportNotGrantedError extends Error {
55
- readonly code = REGISTRY_EXPORT_NOT_GRANTED;
56
-
57
- constructor() {
58
- super('Registry export is not enabled for this Skill Hub definition.');
59
- this.name = 'RegistryExportNotGrantedError';
60
- }
61
- }
62
-
63
- export class RegistryExportLimitError extends Error {
64
- readonly code = REGISTRY_EXPORT_LIMIT_EXCEEDED;
65
-
66
- constructor(message: string) {
67
- super(message);
68
- this.name = 'RegistryExportLimitError';
69
- }
70
- }
71
-
72
- function value(model: DefinitionModel, attribute: string): unknown {
73
- return model.get(attribute);
74
- }
75
-
76
- function text(model: DefinitionModel, attribute: string, fallback = ''): string {
77
- const raw = value(model, attribute);
78
- return typeof raw === 'string' ? raw : raw === null || raw === undefined ? fallback : String(raw);
79
- }
80
-
81
- function parseJson(raw: unknown, fallback: JsonValue): JsonValue {
82
- if (raw === null || typeof raw === 'string' || typeof raw === 'boolean') {
83
- if (typeof raw !== 'string') {
84
- return raw;
85
- }
86
- try {
87
- return JSON.parse(raw) as JsonValue;
88
- } catch {
89
- return fallback;
90
- }
91
- }
92
- if (typeof raw === 'number' && Number.isFinite(raw)) {
93
- return raw;
94
- }
95
- if (Array.isArray(raw) || (typeof raw === 'object' && raw !== null)) {
96
- return raw as JsonValue;
97
- }
98
- return fallback;
99
- }
100
-
101
- function stableJson(value: JsonValue): string {
102
- if (value === null || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number') {
103
- return JSON.stringify(value);
104
- }
105
- if (Array.isArray(value)) {
106
- return `[${value.map(stableJson).join(',')}]`;
107
- }
108
- return `{${Object.keys(value)
109
- .sort()
110
- .map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`)
111
- .join(',')}}`;
112
- }
113
-
114
- function digest(value: JsonValue): string {
115
- return `sha256:${createHash('sha256').update(stableJson(value)).digest('hex')}`;
116
- }
117
-
118
- function asPortableSnapshot(model: DefinitionModel): RegistrySkillSnapshot {
119
- const id = text(model, 'id');
120
- const name = text(model, 'name');
121
- const storageType = text(model, 'storageType', 'database');
122
- const codeTemplate = text(model, 'codeTemplate');
123
- const language = text(model, 'language', 'python') === 'node' ? 'node' : 'python';
124
- const inputSchema = parseJson(value(model, 'inputSchema'), { type: 'object', properties: {} });
125
- const dependencies = parseJson(value(model, 'packages'), []);
126
- const instructions = text(model, 'instructions');
127
- if (
128
- Buffer.byteLength(codeTemplate, 'utf8') > MAX_REGISTRY_TEXT_BYTES ||
129
- Buffer.byteLength(instructions, 'utf8') > MAX_REGISTRY_TEXT_BYTES
130
- ) {
131
- throw new RegistryExportLimitError('Skill Hub definition exceeds the registry source-file limit.');
132
- }
133
- const revisionInput = {
134
- id,
135
- name,
136
- storageType,
137
- codeTemplate,
138
- language,
139
- inputSchema,
140
- dependencies,
141
- instructions,
142
- title: text(model, 'title'),
143
- description: text(model, 'description'),
144
- };
145
- if (storageType === 'plugin') {
146
- return {
147
- id,
148
- name,
149
- title: text(model, 'title', name),
150
- description: text(model, 'description'),
151
- language,
152
- inputSchema,
153
- instructions,
154
- files: [],
155
- portable: false,
156
- reason: 'Plugin-backed skills require an explicit portable export bundle.',
157
- revision: digest(revisionInput),
158
- dependencies,
159
- };
160
- }
161
- if (!codeTemplate.trim()) {
162
- return {
163
- id,
164
- name,
165
- title: text(model, 'title', name),
166
- description: text(model, 'description'),
167
- language,
168
- inputSchema,
169
- instructions,
170
- files: [],
171
- portable: false,
172
- reason: 'Skill has no inline code bundle to export.',
173
- revision: digest(revisionInput),
174
- dependencies,
175
- };
176
- }
177
- const entrypoint = language === 'node' ? 'src/index.js' : 'src/index.py';
178
- const skillMarkdown = [
179
- '---',
180
- `name: ${name}`,
181
- `title: ${text(model, 'title', name)}`,
182
- `description: ${text(model, 'description').replace(/\r?\n/g, ' ')}`,
183
- `language: ${language}`,
184
- '---',
185
- '',
186
- instructions,
187
- ].join('\n');
188
- return {
189
- id,
190
- name,
191
- title: text(model, 'title', name),
192
- description: text(model, 'description'),
193
- language,
194
- inputSchema,
195
- instructions,
196
- files: [
197
- { path: 'SKILL.md', content: Buffer.from(skillMarkdown, 'utf8') },
198
- { path: entrypoint, content: Buffer.from(codeTemplate, 'utf8') },
199
- ],
200
- portable: true,
201
- revision: digest(revisionInput),
202
- dependencies,
203
- };
204
- }
205
-
206
- export class RegistrySkillSnapshotService {
207
- constructor(private readonly database: Database) {}
208
-
209
- async listSkillSnapshots(): Promise<RegistrySkillSnapshotSummary[]> {
210
- // Registry-installed rows are local runtime projections of an immutable
211
- // registry package. Exporting them back through Skill Hub would let the
212
- // registry re-discover and publish its own installed artifacts.
213
- const definitions = await this.database.getRepository('skillDefinitions').find({
214
- fields: ['id'],
215
- filter: registryExportFilter,
216
- sort: ['id'],
217
- limit: MAX_REGISTRY_SKILL_SNAPSHOTS + 1,
218
- });
219
- if (definitions.length > MAX_REGISTRY_SKILL_SNAPSHOTS) {
220
- throw new RegistryExportLimitError('Skill Hub registry export exceeds the configured source-item limit.');
221
- }
222
- return definitions.map((definition) => ({ id: String(definition.get('id')) }));
223
- }
224
-
225
- async getSkillSnapshot(skillDefinitionId: string): Promise<RegistrySkillSnapshot> {
226
- const definition = await this.database.getRepository('skillDefinitions').findOne({
227
- filter: {
228
- id: skillDefinitionId,
229
- ...registryExportFilter,
230
- },
231
- });
232
- if (!definition) {
233
- // Use one result for missing and ungranted definitions so the internal
234
- // service cannot be used to enumerate private Skill Hub content.
235
- throw new RegistryExportNotGrantedError();
236
- }
237
- return asPortableSnapshot(definition as unknown as DefinitionModel);
238
- }
239
- }
1
+ import { createHash } from 'crypto';
2
+
3
+ import type { Database } from '@nocobase/database';
4
+
5
+ type JsonValue = boolean | number | string | null | JsonValue[] | { [key: string]: JsonValue };
6
+
7
+ export interface RegistrySkillSnapshotSummary {
8
+ id: string;
9
+ }
10
+
11
+ export interface RegistrySkillSnapshot {
12
+ id: string;
13
+ name: string;
14
+ title: string;
15
+ description: string;
16
+ language: 'python' | 'node';
17
+ suggestedVersion?: string;
18
+ inputSchema: JsonValue;
19
+ instructions: string;
20
+ files: Array<{ path: string; content: Buffer }>;
21
+ portable: boolean;
22
+ reason?: string;
23
+ revision: string;
24
+ dependencies: JsonValue;
25
+ }
26
+
27
+ type DefinitionModel = {
28
+ get(attribute: string): unknown;
29
+ };
30
+
31
+ function positiveLimit(value: string | undefined, fallback: number, maximum: number): number {
32
+ const parsed = Number(value);
33
+ return Number.isSafeInteger(parsed) && parsed > 0 && parsed <= maximum ? parsed : fallback;
34
+ }
35
+
36
+ const MAX_REGISTRY_SKILL_SNAPSHOTS = positiveLimit(process.env.SKILL_REGISTRY_MAX_SOURCE_ITEMS, 1000, 10_000);
37
+ const MAX_REGISTRY_TEXT_BYTES = 10 * 1024 * 1024;
38
+
39
+ const registryExportFilter = {
40
+ registryPackageId: null,
41
+ registryVersionId: null,
42
+ registryInstallationId: null,
43
+ registryInstallStatus: null,
44
+ registryExportEnabled: true,
45
+ };
46
+
47
+ export const REGISTRY_EXPORT_NOT_GRANTED = 'REGISTRY_EXPORT_NOT_GRANTED';
48
+ export const REGISTRY_EXPORT_LIMIT_EXCEEDED = 'REGISTRY_EXPORT_LIMIT_EXCEEDED';
49
+
50
+ export class RegistryExportNotGrantedError extends Error {
51
+ readonly code = REGISTRY_EXPORT_NOT_GRANTED;
52
+
53
+ constructor() {
54
+ super('Registry export is not enabled for this Skill Hub definition.');
55
+ this.name = 'RegistryExportNotGrantedError';
56
+ }
57
+ }
58
+
59
+ export class RegistryExportLimitError extends Error {
60
+ readonly code = REGISTRY_EXPORT_LIMIT_EXCEEDED;
61
+
62
+ constructor(message: string) {
63
+ super(message);
64
+ this.name = 'RegistryExportLimitError';
65
+ }
66
+ }
67
+
68
+ function value(model: DefinitionModel, attribute: string): unknown {
69
+ return model.get(attribute);
70
+ }
71
+
72
+ function text(model: DefinitionModel, attribute: string, fallback = ''): string {
73
+ const raw = value(model, attribute);
74
+ return typeof raw === 'string' ? raw : raw === null || raw === undefined ? fallback : String(raw);
75
+ }
76
+
77
+ function parseJson(raw: unknown, fallback: JsonValue): JsonValue {
78
+ if (raw === null || typeof raw === 'string' || typeof raw === 'boolean') {
79
+ if (typeof raw !== 'string') {
80
+ return raw;
81
+ }
82
+ try {
83
+ return JSON.parse(raw) as JsonValue;
84
+ } catch {
85
+ return fallback;
86
+ }
87
+ }
88
+ if (typeof raw === 'number' && Number.isFinite(raw)) {
89
+ return raw;
90
+ }
91
+ if (Array.isArray(raw) || (typeof raw === 'object' && raw !== null)) {
92
+ return raw as JsonValue;
93
+ }
94
+ return fallback;
95
+ }
96
+
97
+ function stableJson(value: JsonValue): string {
98
+ if (value === null || typeof value === 'string' || typeof value === 'boolean' || typeof value === 'number') {
99
+ return JSON.stringify(value);
100
+ }
101
+ if (Array.isArray(value)) {
102
+ return `[${value.map(stableJson).join(',')}]`;
103
+ }
104
+ return `{${Object.keys(value)
105
+ .sort()
106
+ .map((key) => `${JSON.stringify(key)}:${stableJson(value[key])}`)
107
+ .join(',')}}`;
108
+ }
109
+
110
+ function digest(value: JsonValue): string {
111
+ return `sha256:${createHash('sha256').update(stableJson(value)).digest('hex')}`;
112
+ }
113
+
114
+ function asPortableSnapshot(model: DefinitionModel): RegistrySkillSnapshot {
115
+ const id = text(model, 'id');
116
+ const name = text(model, 'name');
117
+ const storageType = text(model, 'storageType', 'database');
118
+ const codeTemplate = text(model, 'codeTemplate');
119
+ const language = text(model, 'language', 'python') === 'node' ? 'node' : 'python';
120
+ const inputSchema = parseJson(value(model, 'inputSchema'), { type: 'object', properties: {} });
121
+ const dependencies = parseJson(value(model, 'packages'), []);
122
+ const instructions = text(model, 'instructions');
123
+ if (
124
+ Buffer.byteLength(codeTemplate, 'utf8') > MAX_REGISTRY_TEXT_BYTES ||
125
+ Buffer.byteLength(instructions, 'utf8') > MAX_REGISTRY_TEXT_BYTES
126
+ ) {
127
+ throw new RegistryExportLimitError('Skill Hub definition exceeds the registry source-file limit.');
128
+ }
129
+ const revisionInput = {
130
+ id,
131
+ name,
132
+ storageType,
133
+ codeTemplate,
134
+ language,
135
+ inputSchema,
136
+ dependencies,
137
+ instructions,
138
+ title: text(model, 'title'),
139
+ description: text(model, 'description'),
140
+ };
141
+ if (storageType === 'plugin') {
142
+ return {
143
+ id,
144
+ name,
145
+ title: text(model, 'title', name),
146
+ description: text(model, 'description'),
147
+ language,
148
+ inputSchema,
149
+ instructions,
150
+ files: [],
151
+ portable: false,
152
+ reason: 'Plugin-backed skills require an explicit portable export bundle.',
153
+ revision: digest(revisionInput),
154
+ dependencies,
155
+ };
156
+ }
157
+ if (!codeTemplate.trim()) {
158
+ return {
159
+ id,
160
+ name,
161
+ title: text(model, 'title', name),
162
+ description: text(model, 'description'),
163
+ language,
164
+ inputSchema,
165
+ instructions,
166
+ files: [],
167
+ portable: false,
168
+ reason: 'Skill has no inline code bundle to export.',
169
+ revision: digest(revisionInput),
170
+ dependencies,
171
+ };
172
+ }
173
+ const entrypoint = language === 'node' ? 'src/index.js' : 'src/index.py';
174
+ const skillMarkdown = [
175
+ '---',
176
+ `name: ${name}`,
177
+ `title: ${text(model, 'title', name)}`,
178
+ `description: ${text(model, 'description').replace(/\r?\n/g, ' ')}`,
179
+ `language: ${language}`,
180
+ '---',
181
+ '',
182
+ instructions,
183
+ ].join('\n');
184
+ return {
185
+ id,
186
+ name,
187
+ title: text(model, 'title', name),
188
+ description: text(model, 'description'),
189
+ language,
190
+ inputSchema,
191
+ instructions,
192
+ files: [
193
+ { path: 'SKILL.md', content: Buffer.from(skillMarkdown, 'utf8') },
194
+ { path: entrypoint, content: Buffer.from(codeTemplate, 'utf8') },
195
+ ],
196
+ portable: true,
197
+ revision: digest(revisionInput),
198
+ dependencies,
199
+ };
200
+ }
201
+
202
+ export class RegistrySkillSnapshotService {
203
+ constructor(private readonly database: Database) {}
204
+
205
+ async listSkillSnapshots(): Promise<RegistrySkillSnapshotSummary[]> {
206
+ // Registry-installed rows are local runtime projections of an immutable
207
+ // registry package. Exporting them back through Skill Hub would let the
208
+ // registry re-discover and publish its own installed artifacts.
209
+ const definitions = await this.database.getRepository('skillDefinitions').find({
210
+ fields: ['id'],
211
+ filter: registryExportFilter,
212
+ sort: ['id'],
213
+ limit: MAX_REGISTRY_SKILL_SNAPSHOTS + 1,
214
+ });
215
+ if (definitions.length > MAX_REGISTRY_SKILL_SNAPSHOTS) {
216
+ throw new RegistryExportLimitError('Skill Hub registry export exceeds the configured source-item limit.');
217
+ }
218
+ return definitions.map((definition) => ({ id: String(definition.get('id')) }));
219
+ }
220
+
221
+ async getSkillSnapshot(skillDefinitionId: string): Promise<RegistrySkillSnapshot> {
222
+ const definition = await this.database.getRepository('skillDefinitions').findOne({
223
+ filter: {
224
+ id: skillDefinitionId,
225
+ ...registryExportFilter,
226
+ },
227
+ });
228
+ if (!definition) {
229
+ // Use one result for missing and ungranted definitions so the internal
230
+ // service cannot be used to enumerate private Skill Hub content.
231
+ throw new RegistryExportNotGrantedError();
232
+ }
233
+ return asPortableSnapshot(definition as unknown as DefinitionModel);
234
+ }
235
+ }
@@ -1,63 +1,61 @@
1
- import type { Database } from '@nocobase/database';
2
-
3
- import { RegistrySkillSnapshotService } from '../RegistrySkillSnapshotService';
4
-
5
- describe('RegistrySkillSnapshotService', () => {
6
- it('does not expose registry-installed local projections as Skill Hub sources', async () => {
7
- const find = vi.fn().mockResolvedValue([{ get: () => 42 }]);
8
- const database = {
9
- getRepository: vi.fn().mockReturnValue({ find }),
10
- } as unknown as Database;
11
- const service = new RegistrySkillSnapshotService(database);
12
-
13
- await expect(service.listSkillSnapshots()).resolves.toEqual([{ id: '42' }]);
14
- expect(find).toHaveBeenCalledWith({
15
- fields: ['id'],
16
- filter: {
17
- registryPackageId: null,
18
- registryVersionId: null,
19
- registryInstallationId: null,
20
- registryInstallStatus: null,
21
- registryExportEnabled: true,
22
- },
23
- sort: ['id'],
24
- limit: 1001,
25
- });
26
- });
27
-
28
- it('does not return a snapshot without a provider-owned export grant', async () => {
29
- const findOne = vi.fn().mockResolvedValue(null);
30
- const database = {
31
- getRepository: vi.fn().mockReturnValue({ findOne }),
32
- } as unknown as Database;
33
- const service = new RegistrySkillSnapshotService(database);
34
-
35
- await expect(service.getSkillSnapshot('42')).rejects.toMatchObject({
36
- code: 'REGISTRY_EXPORT_NOT_GRANTED',
37
- });
38
- expect(findOne).toHaveBeenCalledWith({
39
- filter: {
40
- id: '42',
41
- registryPackageId: null,
42
- registryVersionId: null,
43
- registryInstallationId: null,
44
- registryInstallStatus: null,
45
- registryExportEnabled: true,
46
- },
47
- });
48
- });
49
-
50
- it('bounds provider discovery before returning an unbounded definition list', async () => {
51
- const find = vi
52
- .fn()
53
- .mockResolvedValue(Array.from({ length: 1001 }, (_, id) => ({ get: () => id + 1 })));
54
- const database = {
55
- getRepository: vi.fn().mockReturnValue({ find }),
56
- } as unknown as Database;
57
- const service = new RegistrySkillSnapshotService(database);
58
-
59
- await expect(service.listSkillSnapshots()).rejects.toThrow(
60
- 'Skill Hub registry export exceeds the configured source-item limit.',
61
- );
62
- });
63
- });
1
+ import type { Database } from '@nocobase/database';
2
+
3
+ import { RegistrySkillSnapshotService } from '../RegistrySkillSnapshotService';
4
+
5
+ describe('RegistrySkillSnapshotService', () => {
6
+ it('does not expose registry-installed local projections as Skill Hub sources', async () => {
7
+ const find = vi.fn().mockResolvedValue([{ get: () => 42 }]);
8
+ const database = {
9
+ getRepository: vi.fn().mockReturnValue({ find }),
10
+ } as unknown as Database;
11
+ const service = new RegistrySkillSnapshotService(database);
12
+
13
+ await expect(service.listSkillSnapshots()).resolves.toEqual([{ id: '42' }]);
14
+ expect(find).toHaveBeenCalledWith({
15
+ fields: ['id'],
16
+ filter: {
17
+ registryPackageId: null,
18
+ registryVersionId: null,
19
+ registryInstallationId: null,
20
+ registryInstallStatus: null,
21
+ registryExportEnabled: true,
22
+ },
23
+ sort: ['id'],
24
+ limit: 1001,
25
+ });
26
+ });
27
+
28
+ it('does not return a snapshot without a provider-owned export grant', async () => {
29
+ const findOne = vi.fn().mockResolvedValue(null);
30
+ const database = {
31
+ getRepository: vi.fn().mockReturnValue({ findOne }),
32
+ } as unknown as Database;
33
+ const service = new RegistrySkillSnapshotService(database);
34
+
35
+ await expect(service.getSkillSnapshot('42')).rejects.toMatchObject({
36
+ code: 'REGISTRY_EXPORT_NOT_GRANTED',
37
+ });
38
+ expect(findOne).toHaveBeenCalledWith({
39
+ filter: {
40
+ id: '42',
41
+ registryPackageId: null,
42
+ registryVersionId: null,
43
+ registryInstallationId: null,
44
+ registryInstallStatus: null,
45
+ registryExportEnabled: true,
46
+ },
47
+ });
48
+ });
49
+
50
+ it('bounds provider discovery before returning an unbounded definition list', async () => {
51
+ const find = vi.fn().mockResolvedValue(Array.from({ length: 1001 }, (_, id) => ({ get: () => id + 1 })));
52
+ const database = {
53
+ getRepository: vi.fn().mockReturnValue({ find }),
54
+ } as unknown as Database;
55
+ const service = new RegistrySkillSnapshotService(database);
56
+
57
+ await expect(service.listSkillSnapshots()).rejects.toThrow(
58
+ 'Skill Hub registry export exceeds the configured source-item limit.',
59
+ );
60
+ });
61
+ });