@zihanw/pi-forge 0.5.4 → 0.5.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 (228) hide show
  1. package/CHANGELOG.md +71 -0
  2. package/README.md +67 -103
  3. package/README.zh-CN.md +67 -95
  4. package/assets/pi-forge-header-concept-1.png +0 -0
  5. package/assets/readme/PROVENANCE.md +95 -0
  6. package/assets/readme/en/capability-tools.gif +0 -0
  7. package/assets/readme/en/context-composition.gif +0 -0
  8. package/assets/readme/en/context-toggle.gif +0 -0
  9. package/assets/readme/en/draft-diff.png +0 -0
  10. package/assets/readme/en/edit-draft-diff.gif +0 -0
  11. package/assets/readme/en/editor-overview-v3.png +0 -0
  12. package/assets/readme/en/editor-overview.png +0 -0
  13. package/assets/readme/en/mode-tools.gif +0 -0
  14. package/assets/readme/en/regex-transforms.gif +0 -0
  15. package/assets/readme/en/tool-selection.gif +0 -0
  16. package/assets/readme/tui-quickstart.gif +0 -0
  17. package/assets/readme/zh-CN/capability-tools.gif +0 -0
  18. package/assets/readme/zh-CN/context-composition.gif +0 -0
  19. package/assets/readme/zh-CN/context-toggle.gif +0 -0
  20. package/assets/readme/zh-CN/draft-diff.png +0 -0
  21. package/assets/readme/zh-CN/edit-draft-diff.gif +0 -0
  22. package/assets/readme/zh-CN/editor-overview-v3.png +0 -0
  23. package/assets/readme/zh-CN/editor-overview.png +0 -0
  24. package/assets/readme/zh-CN/mode-tools.gif +0 -0
  25. package/assets/readme/zh-CN/regex-transforms.gif +0 -0
  26. package/assets/readme/zh-CN/tool-selection.gif +0 -0
  27. package/dist/active-state.d.ts +148 -0
  28. package/dist/active-state.d.ts.map +1 -0
  29. package/dist/active-state.js +374 -0
  30. package/dist/active-state.js.map +1 -0
  31. package/dist/agent-profile.d.ts.map +1 -1
  32. package/dist/agent-profile.js +11 -0
  33. package/dist/agent-profile.js.map +1 -1
  34. package/dist/capabilities.d.ts +39 -0
  35. package/dist/capabilities.d.ts.map +1 -0
  36. package/dist/capabilities.js +160 -0
  37. package/dist/capabilities.js.map +1 -0
  38. package/dist/capability-anchors.d.ts +45 -0
  39. package/dist/capability-anchors.d.ts.map +1 -0
  40. package/dist/capability-anchors.js +263 -0
  41. package/dist/capability-anchors.js.map +1 -0
  42. package/dist/capability-command.d.ts +4 -0
  43. package/dist/capability-command.d.ts.map +1 -0
  44. package/dist/capability-command.js +164 -0
  45. package/dist/capability-command.js.map +1 -0
  46. package/dist/capability-events.d.ts +79 -0
  47. package/dist/capability-events.d.ts.map +1 -0
  48. package/dist/capability-events.js +478 -0
  49. package/dist/capability-events.js.map +1 -0
  50. package/dist/capability-projection.d.ts +22 -0
  51. package/dist/capability-projection.d.ts.map +1 -0
  52. package/dist/capability-projection.js +273 -0
  53. package/dist/capability-projection.js.map +1 -0
  54. package/dist/capability-protocol.d.ts +21 -0
  55. package/dist/capability-protocol.d.ts.map +1 -0
  56. package/dist/capability-protocol.js +15 -0
  57. package/dist/capability-protocol.js.map +1 -0
  58. package/dist/capability-state.d.ts +74 -0
  59. package/dist/capability-state.d.ts.map +1 -0
  60. package/dist/capability-state.js +43 -0
  61. package/dist/capability-state.js.map +1 -0
  62. package/dist/capability-tool.d.ts +11 -0
  63. package/dist/capability-tool.d.ts.map +1 -0
  64. package/dist/capability-tool.js +25 -0
  65. package/dist/capability-tool.js.map +1 -0
  66. package/dist/capability-web-host.d.ts +11 -0
  67. package/dist/capability-web-host.d.ts.map +1 -0
  68. package/dist/capability-web-host.js +105 -0
  69. package/dist/capability-web-host.js.map +1 -0
  70. package/dist/codecs/capability.d.ts +71 -0
  71. package/dist/codecs/capability.d.ts.map +1 -0
  72. package/dist/codecs/capability.js +363 -0
  73. package/dist/codecs/capability.js.map +1 -0
  74. package/dist/codecs/prompt-stack.d.ts +1 -1
  75. package/dist/codecs/prompt-stack.d.ts.map +1 -1
  76. package/dist/codecs/prompt-stack.js +140 -13
  77. package/dist/codecs/prompt-stack.js.map +1 -1
  78. package/dist/command-contribution/index.d.ts +21 -0
  79. package/dist/command-contribution/index.d.ts.map +1 -0
  80. package/dist/command-contribution/index.js +14 -0
  81. package/dist/command-contribution/index.js.map +1 -0
  82. package/dist/compile-cycle.d.ts +1 -0
  83. package/dist/compile-cycle.d.ts.map +1 -1
  84. package/dist/compile-cycle.js.map +1 -1
  85. package/dist/compiler.d.ts.map +1 -1
  86. package/dist/compiler.js +70 -17
  87. package/dist/compiler.js.map +1 -1
  88. package/dist/forge-command.d.ts +10 -0
  89. package/dist/forge-command.d.ts.map +1 -0
  90. package/dist/forge-command.js +106 -0
  91. package/dist/forge-command.js.map +1 -0
  92. package/dist/index.d.ts +2 -2
  93. package/dist/index.d.ts.map +1 -1
  94. package/dist/index.js +54 -5
  95. package/dist/index.js.map +1 -1
  96. package/dist/json-fingerprint.d.ts +11 -0
  97. package/dist/json-fingerprint.d.ts.map +1 -0
  98. package/dist/json-fingerprint.js +66 -0
  99. package/dist/json-fingerprint.js.map +1 -0
  100. package/dist/lifecycle.d.ts +14 -0
  101. package/dist/lifecycle.d.ts.map +1 -1
  102. package/dist/lifecycle.js +167 -67
  103. package/dist/lifecycle.js.map +1 -1
  104. package/dist/payload-command.d.ts +2 -2
  105. package/dist/payload-command.d.ts.map +1 -1
  106. package/dist/payload-command.js +80 -26
  107. package/dist/payload-command.js.map +1 -1
  108. package/dist/payload-state.d.ts +1 -0
  109. package/dist/payload-state.d.ts.map +1 -1
  110. package/dist/payload-state.js +1 -0
  111. package/dist/payload-state.js.map +1 -1
  112. package/dist/policy.d.ts +2 -1
  113. package/dist/policy.d.ts.map +1 -1
  114. package/dist/policy.js +3 -0
  115. package/dist/policy.js.map +1 -1
  116. package/dist/preset-command.d.ts.map +1 -1
  117. package/dist/preset-command.js +92 -35
  118. package/dist/preset-command.js.map +1 -1
  119. package/dist/preview-text.d.ts +5 -0
  120. package/dist/preview-text.d.ts.map +1 -0
  121. package/dist/preview-text.js +27 -0
  122. package/dist/preview-text.js.map +1 -0
  123. package/dist/preview.d.ts +18 -1
  124. package/dist/preview.d.ts.map +1 -1
  125. package/dist/preview.js +132 -97
  126. package/dist/preview.js.map +1 -1
  127. package/dist/profile-command.js +68 -9
  128. package/dist/profile-command.js.map +1 -1
  129. package/dist/regex.d.ts.map +1 -1
  130. package/dist/regex.js +5 -0
  131. package/dist/regex.js.map +1 -1
  132. package/dist/render-helpers.d.ts.map +1 -1
  133. package/dist/render-helpers.js +2 -0
  134. package/dist/render-helpers.js.map +1 -1
  135. package/dist/repositories/capability.d.ts +53 -0
  136. package/dist/repositories/capability.d.ts.map +1 -0
  137. package/dist/repositories/capability.js +294 -0
  138. package/dist/repositories/capability.js.map +1 -0
  139. package/dist/runtime/capability-runtime.d.ts +91 -0
  140. package/dist/runtime/capability-runtime.d.ts.map +1 -0
  141. package/dist/runtime/capability-runtime.js +967 -0
  142. package/dist/runtime/capability-runtime.js.map +1 -0
  143. package/dist/runtime/tool-policy-runtime.d.ts +8 -0
  144. package/dist/runtime/tool-policy-runtime.d.ts.map +1 -1
  145. package/dist/runtime/tool-policy-runtime.js +171 -30
  146. package/dist/runtime/tool-policy-runtime.js.map +1 -1
  147. package/dist/session-adapter.d.ts +13 -0
  148. package/dist/session-adapter.d.ts.map +1 -1
  149. package/dist/session-adapter.js +110 -0
  150. package/dist/session-adapter.js.map +1 -1
  151. package/dist/session-usage.d.ts +65 -0
  152. package/dist/session-usage.d.ts.map +1 -0
  153. package/dist/session-usage.js +134 -0
  154. package/dist/session-usage.js.map +1 -0
  155. package/dist/subagent/fingerprints.d.ts +3 -15
  156. package/dist/subagent/fingerprints.d.ts.map +1 -1
  157. package/dist/subagent/fingerprints.js +5 -69
  158. package/dist/subagent/fingerprints.js.map +1 -1
  159. package/dist/subagent/index.d.ts +2 -0
  160. package/dist/subagent/index.d.ts.map +1 -1
  161. package/dist/subagent/index.js +2 -0
  162. package/dist/subagent/index.js.map +1 -1
  163. package/dist/subagent-host.d.ts +2 -2
  164. package/dist/subagent-host.d.ts.map +1 -1
  165. package/dist/subagent-host.js +13 -1
  166. package/dist/subagent-host.js.map +1 -1
  167. package/dist/types.d.ts +6 -1
  168. package/dist/types.d.ts.map +1 -1
  169. package/dist/types.js.map +1 -1
  170. package/dist/web-editor/client-script.generated.d.ts.map +1 -1
  171. package/dist/web-editor/client-script.generated.js +1 -1
  172. package/dist/web-editor/client-script.generated.js.map +1 -1
  173. package/dist/web-editor/client-styles.generated.d.ts.map +1 -1
  174. package/dist/web-editor/client-styles.generated.js +1 -1
  175. package/dist/web-editor/client-styles.generated.js.map +1 -1
  176. package/dist/web-editor/server.d.ts.map +1 -1
  177. package/dist/web-editor/server.js +152 -4
  178. package/dist/web-editor/server.js.map +1 -1
  179. package/dist/web-editor/styles.d.ts.map +1 -1
  180. package/dist/web-editor/styles.js +476 -149
  181. package/dist/web-editor/styles.js.map +1 -1
  182. package/dist/web-editor/types.d.ts +81 -1
  183. package/dist/web-editor/types.d.ts.map +1 -1
  184. package/dist/web-host.d.ts +7 -0
  185. package/dist/web-host.d.ts.map +1 -1
  186. package/dist/web-host.js +168 -5
  187. package/dist/web-host.js.map +1 -1
  188. package/dist/workspace.d.ts +11 -0
  189. package/dist/workspace.d.ts.map +1 -1
  190. package/dist/workspace.js +63 -5
  191. package/dist/workspace.js.map +1 -1
  192. package/docs/README.md +4 -0
  193. package/docs/design/README.md +3 -1
  194. package/docs/design/architecture-0.5.md +22 -0
  195. package/docs/design/archive/2026-09-12-system-update-design.md +229 -0
  196. package/docs/design/pi-forge-system-update-design-notes.md +157 -229
  197. package/docs/development/release.md +20 -20
  198. package/docs/development/roadmap.md +17 -2
  199. package/docs/development/scoped-global-profiles-stacks.md +1 -1
  200. package/docs/development/setup.md +1 -1
  201. package/docs/getting-started.md +1 -1
  202. package/docs/guides/delegation.md +22 -20
  203. package/docs/guides/migrating-to-0.5.md +29 -0
  204. package/docs/guides/use-cases.md +6 -2
  205. package/docs/guides/web-editor.md +73 -5
  206. package/docs/reference/active-state.md +77 -0
  207. package/docs/reference/capabilities.md +259 -0
  208. package/docs/reference/commands.md +52 -24
  209. package/docs/reference/configuration.md +4 -2
  210. package/docs/reference/features.md +70 -4
  211. package/docs/reference/provider-support.md +67 -0
  212. package/docs/reference/public-api.md +49 -3
  213. package/docs/reference/session-cache.md +112 -0
  214. package/docs/reference/stack-schema.md +18 -4
  215. package/docs/reference/subagent-host-port.md +8 -0
  216. package/docs/zh-CN/README.md +3 -0
  217. package/docs/zh-CN/getting-started.md +1 -1
  218. package/docs/zh-CN/guides/delegation.md +22 -10
  219. package/docs/zh-CN/guides/migrating-to-0.5.md +29 -0
  220. package/docs/zh-CN/guides/web-editor.md +74 -7
  221. package/docs/zh-CN/reference/capabilities.md +259 -0
  222. package/docs/zh-CN/reference/commands.md +61 -33
  223. package/docs/zh-CN/reference/provider-support.md +67 -0
  224. package/docs/zh-CN/reference/session-cache.md +112 -0
  225. package/examples/capabilities/review.json +12 -0
  226. package/examples/capabilities/write-tools.json +15 -0
  227. package/examples/read-first-worker-prompt-stack.json +49 -0
  228. package/package.json +16 -9
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability-web-host.js","sourceRoot":"","sources":["../src/capability-web-host.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ import { type ResourceKey, type ResourceScope } from "../resource-identity.ts";
2
+ export declare const CAPABILITY_TYPE: "pi-forge.capability";
3
+ export declare const MAX_CONTENT_LENGTH = 100000;
4
+ export declare const MAX_TOOL_ARRAY_LENGTH = 256;
5
+ export declare const MAX_TOOL_NAME_LENGTH = 128;
6
+ export declare const MAX_CAPABILITY_NAME_LENGTH = 1000;
7
+ export interface CapabilityToolPatch {
8
+ add: string[];
9
+ remove: string[];
10
+ }
11
+ export interface Capability {
12
+ schemaVersion: 1;
13
+ type: typeof CAPABILITY_TYPE;
14
+ id: string;
15
+ name?: string;
16
+ description?: string;
17
+ content: string;
18
+ tools: CapabilityToolPatch;
19
+ }
20
+ export interface CapabilityOverrides {
21
+ content?: string;
22
+ appendContent?: string;
23
+ tools?: {
24
+ add?: string[];
25
+ remove?: string[];
26
+ };
27
+ }
28
+ export interface CapabilityBinding {
29
+ ref: string;
30
+ id?: string;
31
+ modelCallable?: boolean;
32
+ overrides?: CapabilityOverrides;
33
+ }
34
+ export type DiagnosticLevel = "error" | "warning" | "info";
35
+ export interface Diagnostic {
36
+ level: DiagnosticLevel;
37
+ message: string;
38
+ field?: string;
39
+ }
40
+ export interface LoadedCapability {
41
+ /** Raw source revision from the same bytes as capability; never persisted into the resource. */
42
+ sourceRevision?: string;
43
+ capability: Capability;
44
+ filePath: string;
45
+ scope: ResourceScope;
46
+ key: ResourceKey;
47
+ diagnostics: Diagnostic[];
48
+ }
49
+ /** Check if tool name is non-empty, contains no whitespace/control/wildcards, and is <= 128 chars. */
50
+ export declare function isValidToolName(name: string): boolean;
51
+ /** Check if loaded capability has no error diagnostics. */
52
+ export declare function isUsableCapability(loaded: LoadedCapability): boolean;
53
+ /** Build a fail-closed LoadedCapability when reading or parsing fails. */
54
+ export declare function createCapabilityFault(filePath: string, scope: ResourceScope, message: string): LoadedCapability;
55
+ /** Single canonical serializer for capabilities. */
56
+ export declare function serializeCapability(capability: Capability): string;
57
+ /** Parse, normalize, and validate a capability from serialized JSON text. */
58
+ export declare function parseCapability(source: string, filePath: string, scope: ResourceScope): LoadedCapability;
59
+ /** Validate a capability or raw candidate object. */
60
+ export declare function validateCapability(capability: unknown): Diagnostic[];
61
+ /** Validate a capability binding against scope and reference rules. */
62
+ export declare function validateCapabilityBinding(raw: unknown, ownerScope: ResourceScope): Diagnostic[];
63
+ /** Apply limited capability overrides immutably. Fails closed if the base capability is invalid. */
64
+ export declare function applyCapabilityOverrides(capability: Capability, overrides?: CapabilityOverrides): {
65
+ ok: true;
66
+ capability: Capability;
67
+ } | {
68
+ ok: false;
69
+ diagnostics: Diagnostic[];
70
+ };
71
+ //# sourceMappingURL=capability.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/codecs/capability.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,363 @@
1
+ import { basename } from "node:path";
2
+ import { isValidResourceId, parseResourceSelector, } from "../resource-identity.js";
3
+ export const CAPABILITY_TYPE = "pi-forge.capability";
4
+ export const MAX_CONTENT_LENGTH = 100_000;
5
+ export const MAX_TOOL_ARRAY_LENGTH = 256;
6
+ export const MAX_TOOL_NAME_LENGTH = 128;
7
+ export const MAX_CAPABILITY_NAME_LENGTH = 1000;
8
+ const CAPABILITY_FIELDS = new Set(["schemaVersion", "type", "id", "name", "description", "content", "tools"]);
9
+ const TOOLS_FIELDS = new Set(["add", "remove"]);
10
+ const BINDING_FIELDS = new Set(["ref", "id", "modelCallable", "overrides"]);
11
+ const OVERRIDES_FIELDS = new Set(["content", "appendContent", "tools"]);
12
+ /** Check if tool name is non-empty, contains no whitespace/control/wildcards, and is <= 128 chars. */
13
+ export function isValidToolName(name) {
14
+ if (typeof name !== "string")
15
+ return false;
16
+ if (name.length === 0 || name.length > MAX_TOOL_NAME_LENGTH)
17
+ return false;
18
+ if (/\s/.test(name) || /[\x00-\x1F\x7F]/.test(name) || /[*?]/.test(name))
19
+ return false;
20
+ return true;
21
+ }
22
+ /** Check if loaded capability has no error diagnostics. */
23
+ export function isUsableCapability(loaded) {
24
+ return !loaded.diagnostics.some((d) => d.level === "error");
25
+ }
26
+ /** Build a fail-closed LoadedCapability when reading or parsing fails. */
27
+ export function createCapabilityFault(filePath, scope, message) {
28
+ const id = basename(filePath, ".json");
29
+ return {
30
+ filePath,
31
+ scope,
32
+ key: { scope, id },
33
+ capability: fallbackCapability(filePath),
34
+ diagnostics: [{ level: "error", message }],
35
+ };
36
+ }
37
+ /** Single canonical serializer for capabilities. */
38
+ export function serializeCapability(capability) {
39
+ return `${JSON.stringify(capability, null, 2)}\n`;
40
+ }
41
+ /** Parse, normalize, and validate a capability from serialized JSON text. */
42
+ export function parseCapability(source, filePath, scope) {
43
+ let raw;
44
+ try {
45
+ raw = JSON.parse(source);
46
+ }
47
+ catch (error) {
48
+ return createCapabilityFault(filePath, scope, `Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`);
49
+ }
50
+ const { capability, diagnostics } = decodeCapability(raw, basename(filePath, ".json"));
51
+ return { filePath, scope, key: { scope, id: capability.id }, capability, diagnostics };
52
+ }
53
+ /** Validate a capability or raw candidate object. */
54
+ export function validateCapability(capability) {
55
+ return decodeCapability(capability).diagnostics;
56
+ }
57
+ /** Validate a capability binding against scope and reference rules. */
58
+ export function validateCapabilityBinding(raw, ownerScope) {
59
+ const diagnostics = [];
60
+ if (!isPlainObject(raw)) {
61
+ return [{ level: "error", message: "Capability binding must be an object." }];
62
+ }
63
+ for (const field of Object.keys(raw)) {
64
+ if (!BINDING_FIELDS.has(field)) {
65
+ diagnostics.push({ level: "error", field, message: `Unsupported binding field: ${field}` });
66
+ }
67
+ }
68
+ if (raw.ref === undefined) {
69
+ diagnostics.push({ level: "error", field: "ref", message: "Binding ref is required." });
70
+ }
71
+ else if (typeof raw.ref !== "string" || !raw.ref.trim()) {
72
+ diagnostics.push({ level: "error", field: "ref", message: "Binding ref must be a non-empty string." });
73
+ }
74
+ else {
75
+ const parsed = parseResourceSelector(raw.ref);
76
+ if (!parsed.ok) {
77
+ diagnostics.push({ level: "error", field: "ref", message: parsed.error });
78
+ }
79
+ else if (ownerScope === "global" && parsed.selector.scope === "project") {
80
+ diagnostics.push({
81
+ level: "error",
82
+ field: "ref",
83
+ message: `Global binding cannot reference project capability: ${raw.ref}.`,
84
+ });
85
+ }
86
+ }
87
+ if (raw.id !== undefined && (typeof raw.id !== "string" || !isValidResourceId(raw.id))) {
88
+ diagnostics.push({ level: "error", field: "id", message: "Binding id must be a valid resource id." });
89
+ }
90
+ if (raw.modelCallable !== undefined && typeof raw.modelCallable !== "boolean") {
91
+ diagnostics.push({ level: "error", field: "modelCallable", message: "modelCallable must be a boolean when provided." });
92
+ }
93
+ if (raw.overrides !== undefined) {
94
+ diagnostics.push(...validateCapabilityOverrides(raw.overrides));
95
+ }
96
+ return dedupeDiagnostics(diagnostics);
97
+ }
98
+ /** Apply limited capability overrides immutably. Fails closed if the base capability is invalid. */
99
+ export function applyCapabilityOverrides(capability, overrides) {
100
+ const baseResult = decodeCapability(capability);
101
+ if (baseResult.diagnostics.some((d) => d.level === "error")) {
102
+ return { ok: false, diagnostics: baseResult.diagnostics };
103
+ }
104
+ if (overrides === undefined) {
105
+ return {
106
+ ok: true,
107
+ capability: {
108
+ ...baseResult.capability,
109
+ tools: {
110
+ add: [...baseResult.capability.tools.add],
111
+ remove: [...baseResult.capability.tools.remove],
112
+ },
113
+ },
114
+ };
115
+ }
116
+ const overrideDiags = validateCapabilityOverrides(overrides);
117
+ if (overrideDiags.some((d) => d.level === "error")) {
118
+ return { ok: false, diagnostics: overrideDiags };
119
+ }
120
+ let content = baseResult.capability.content;
121
+ if (overrides.content !== undefined) {
122
+ content = overrides.content;
123
+ }
124
+ else if (overrides.appendContent !== undefined) {
125
+ content = baseResult.capability.content
126
+ ? (overrides.appendContent ? `${baseResult.capability.content}\n\n${overrides.appendContent}` : baseResult.capability.content)
127
+ : overrides.appendContent;
128
+ }
129
+ const candidate = {
130
+ schemaVersion: 1,
131
+ type: CAPABILITY_TYPE,
132
+ id: baseResult.capability.id,
133
+ ...(baseResult.capability.name !== undefined ? { name: baseResult.capability.name } : {}),
134
+ ...(baseResult.capability.description !== undefined ? { description: baseResult.capability.description } : {}),
135
+ content,
136
+ tools: {
137
+ add: overrides.tools?.add !== undefined ? [...overrides.tools.add] : [...baseResult.capability.tools.add],
138
+ remove: overrides.tools?.remove !== undefined ? [...overrides.tools.remove] : [...baseResult.capability.tools.remove],
139
+ },
140
+ };
141
+ const candidateResult = decodeCapability(candidate);
142
+ if (candidateResult.diagnostics.some((d) => d.level === "error")) {
143
+ return { ok: false, diagnostics: candidateResult.diagnostics };
144
+ }
145
+ return { ok: true, capability: candidate };
146
+ }
147
+ function decodeCapability(raw, fallbackId) {
148
+ const diagnostics = [];
149
+ if (!isPlainObject(raw)) {
150
+ diagnostics.push({ level: "error", message: "Capability capability root must be a JSON object." });
151
+ return { capability: fallbackCapability(fallbackId ?? "unknown"), diagnostics };
152
+ }
153
+ for (const field of Object.keys(raw)) {
154
+ if (!CAPABILITY_FIELDS.has(field)) {
155
+ diagnostics.push({ level: "error", field, message: `Unsupported capability field: ${field}` });
156
+ }
157
+ }
158
+ if (raw.schemaVersion !== 1) {
159
+ diagnostics.push({ level: "error", field: "schemaVersion", message: "schemaVersion must be 1." });
160
+ }
161
+ if (raw.type !== CAPABILITY_TYPE) {
162
+ diagnostics.push({ level: "error", field: "type", message: `type must be "${CAPABILITY_TYPE}".` });
163
+ }
164
+ let id = fallbackId ?? "";
165
+ if (typeof raw.id !== "string" || !isValidResourceId(raw.id)) {
166
+ diagnostics.push({
167
+ level: "error",
168
+ field: "id",
169
+ message: "Capability capability id must start with a letter or number and contain only letters, numbers, dots, underscores, and hyphens.",
170
+ });
171
+ if (typeof raw.id === "string" && raw.id)
172
+ id = raw.id;
173
+ }
174
+ else {
175
+ id = raw.id;
176
+ }
177
+ let name = undefined;
178
+ if (raw.name !== undefined) {
179
+ if (typeof raw.name !== "string") {
180
+ diagnostics.push({ level: "error", field: "name", message: "name must be a string when provided." });
181
+ }
182
+ else if (raw.name.length > MAX_CAPABILITY_NAME_LENGTH) {
183
+ diagnostics.push({
184
+ level: "error",
185
+ field: "name",
186
+ message: `name exceeds maximum length of ${MAX_CAPABILITY_NAME_LENGTH} characters.`,
187
+ });
188
+ }
189
+ else {
190
+ name = raw.name;
191
+ }
192
+ }
193
+ const description = typeof raw.description === "string" ? raw.description : undefined;
194
+ if (raw.description !== undefined && typeof raw.description !== "string") {
195
+ diagnostics.push({ level: "error", field: "description", message: "description must be a string when provided." });
196
+ }
197
+ let content = "";
198
+ const hasValidContent = typeof raw.content === "string";
199
+ if (!hasValidContent) {
200
+ diagnostics.push({ level: "error", field: "content", message: "content must be a string." });
201
+ }
202
+ else {
203
+ content = raw.content;
204
+ if (content.length > MAX_CONTENT_LENGTH) {
205
+ diagnostics.push({
206
+ level: "error",
207
+ field: "content",
208
+ message: `content exceeds maximum length of ${MAX_CONTENT_LENGTH} characters.`,
209
+ });
210
+ }
211
+ }
212
+ let tools = { add: [], remove: [] };
213
+ if (raw.tools !== undefined) {
214
+ if (!isPlainObject(raw.tools)) {
215
+ diagnostics.push({ level: "error", field: "tools", message: "tools must be an object." });
216
+ }
217
+ else {
218
+ for (const field of Object.keys(raw.tools)) {
219
+ if (!TOOLS_FIELDS.has(field)) {
220
+ diagnostics.push({ level: "error", field: `tools.${field}`, message: `Unsupported tools field: ${field}` });
221
+ }
222
+ }
223
+ const add = raw.tools.add !== undefined ? validateToolList(raw.tools.add, "tools.add", diagnostics) : [];
224
+ const remove = raw.tools.remove !== undefined ? validateToolList(raw.tools.remove, "tools.remove", diagnostics) : [];
225
+ tools = { add, remove };
226
+ }
227
+ }
228
+ if (hasValidContent && content.trim().length === 0 && tools.add.length === 0 && tools.remove.length === 0) {
229
+ diagnostics.push({
230
+ level: "error",
231
+ message: "Capability capability must have non-empty content or at least one tool effect (add or remove).",
232
+ });
233
+ }
234
+ const capability = {
235
+ schemaVersion: 1,
236
+ type: CAPABILITY_TYPE,
237
+ id,
238
+ ...(name !== undefined ? { name } : {}),
239
+ ...(description !== undefined ? { description } : {}),
240
+ content,
241
+ tools,
242
+ };
243
+ return { capability, diagnostics: dedupeDiagnostics(diagnostics) };
244
+ }
245
+ function validateCapabilityOverrides(raw) {
246
+ const diagnostics = [];
247
+ if (!isPlainObject(raw)) {
248
+ return [{ level: "error", field: "overrides", message: "overrides must be an object." }];
249
+ }
250
+ for (const field of Object.keys(raw)) {
251
+ if (!OVERRIDES_FIELDS.has(field)) {
252
+ diagnostics.push({ level: "error", field: `overrides.${field}`, message: `Unsupported override field: ${field}` });
253
+ }
254
+ }
255
+ if (raw.content !== undefined && raw.appendContent !== undefined) {
256
+ diagnostics.push({ level: "error", field: "overrides", message: "Cannot specify both content and appendContent in overrides." });
257
+ }
258
+ for (const key of ["content", "appendContent"]) {
259
+ const val = raw[key];
260
+ if (val !== undefined) {
261
+ if (typeof val !== "string") {
262
+ diagnostics.push({ level: "error", field: `overrides.${key}`, message: `overrides.${key} must be a string.` });
263
+ }
264
+ else if (val.length > MAX_CONTENT_LENGTH) {
265
+ diagnostics.push({
266
+ level: "error",
267
+ field: `overrides.${key}`,
268
+ message: `overrides.${key} exceeds maximum length of ${MAX_CONTENT_LENGTH} characters.`,
269
+ });
270
+ }
271
+ }
272
+ }
273
+ if (raw.tools !== undefined) {
274
+ if (!isPlainObject(raw.tools)) {
275
+ diagnostics.push({ level: "error", field: "overrides.tools", message: "overrides.tools must be an object." });
276
+ }
277
+ else {
278
+ for (const field of Object.keys(raw.tools)) {
279
+ if (!TOOLS_FIELDS.has(field)) {
280
+ diagnostics.push({
281
+ level: "error",
282
+ field: `overrides.tools.${field}`,
283
+ message: `Unsupported tools field in overrides: ${field}`,
284
+ });
285
+ }
286
+ }
287
+ if (raw.tools.add !== undefined)
288
+ validateToolList(raw.tools.add, "overrides.tools.add", diagnostics);
289
+ if (raw.tools.remove !== undefined)
290
+ validateToolList(raw.tools.remove, "overrides.tools.remove", diagnostics);
291
+ }
292
+ }
293
+ return dedupeDiagnostics(diagnostics);
294
+ }
295
+ function validateToolList(list, fieldName, diagnostics) {
296
+ if (!Array.isArray(list)) {
297
+ diagnostics.push({ level: "error", field: fieldName, message: `${fieldName} must be an array of tool names.` });
298
+ return [];
299
+ }
300
+ if (list.length > MAX_TOOL_ARRAY_LENGTH) {
301
+ diagnostics.push({
302
+ level: "error",
303
+ field: fieldName,
304
+ message: `${fieldName} cannot exceed ${MAX_TOOL_ARRAY_LENGTH} tools (got ${list.length}).`,
305
+ });
306
+ }
307
+ const validated = [];
308
+ for (let i = 0; i < list.length; i++) {
309
+ const item = list[i];
310
+ const field = `${fieldName}[${i}]`;
311
+ if (typeof item !== "string") {
312
+ diagnostics.push({ level: "error", field, message: `Tool name at index ${i} must be a string.` });
313
+ }
314
+ else if (item.length === 0) {
315
+ diagnostics.push({ level: "error", field, message: `Tool name at index ${i} cannot be empty.` });
316
+ }
317
+ else if (item.length > MAX_TOOL_NAME_LENGTH) {
318
+ diagnostics.push({ level: "error", field, message: `Tool name at index ${i} exceeds maximum length of ${MAX_TOOL_NAME_LENGTH} characters.` });
319
+ }
320
+ else if (/\s/.test(item)) {
321
+ diagnostics.push({ level: "error", field, message: `Tool name at index ${i} ("${item}") cannot contain whitespace.` });
322
+ }
323
+ else if (/[\x00-\x1F\x7F]/.test(item)) {
324
+ diagnostics.push({ level: "error", field, message: `Tool name at index ${i} cannot contain control characters.` });
325
+ }
326
+ else if (/[*?]/.test(item)) {
327
+ diagnostics.push({ level: "error", field, message: `Tool name at index ${i} ("${item}") cannot contain wildcard characters (* or ?).` });
328
+ }
329
+ else {
330
+ validated.push(item);
331
+ }
332
+ }
333
+ return validated;
334
+ }
335
+ function fallbackCapability(filePath) {
336
+ return {
337
+ schemaVersion: 1,
338
+ type: CAPABILITY_TYPE,
339
+ id: basename(filePath, ".json"),
340
+ content: "",
341
+ tools: { add: [], remove: [] },
342
+ };
343
+ }
344
+ function dedupeDiagnostics(diagnostics) {
345
+ const seen = new Set();
346
+ const result = [];
347
+ for (const d of diagnostics) {
348
+ const key = `${d.level}\0${d.field ?? ""}\0${d.message}`;
349
+ if (seen.has(key))
350
+ continue;
351
+ seen.add(key);
352
+ result.push(d);
353
+ }
354
+ return result;
355
+ }
356
+ function isPlainObject(value) {
357
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
358
+ return false;
359
+ }
360
+ const proto = Object.getPrototypeOf(value);
361
+ return proto === Object.prototype || proto === null;
362
+ }
363
+ //# sourceMappingURL=capability.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability.js","sourceRoot":"","sources":["../../src/codecs/capability.ts"],"names":[],"mappings":"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"}
@@ -14,5 +14,5 @@ export declare function createPromptStackFault(filePath: string, scope: PromptSt
14
14
  * output stays identical across all write paths.
15
15
  */
16
16
  export declare function serializePromptStack(stack: PromptStack): string;
17
- export declare function validatePromptStack(stack: PromptStack): PromptStackDiagnostic[];
17
+ export declare function validatePromptStack(stack: PromptStack, scope?: PromptStackScope): PromptStackDiagnostic[];
18
18
  //# sourceMappingURL=prompt-stack.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"prompt-stack.d.ts","sourceRoot":"","sources":["../../src/codecs/prompt-stack.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACX,iBAAiB,EAEjB,WAAW,EACX,qBAAqB,EAIrB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAKpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAiC7G;AAcD,sFAAsF;AACtF,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACb,iBAAiB,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AAuGD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,EAAE,CA0E/E"}
1
+ {"version":3,"file":"prompt-stack.d.ts","sourceRoot":"","sources":["../../src/codecs/prompt-stack.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACX,iBAAiB,EAEjB,WAAW,EAEX,qBAAqB,EAIrB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,CAAC;AAKpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAiC7G;AAcD,sFAAsF;AACtF,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,MAAM,GACb,iBAAiB,CAQnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE/D;AA+HD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,qBAAqB,EAAE,CA2EzG"}