@zihanw/pi-forge 0.3.2 → 0.4.0

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 (231) hide show
  1. package/CHANGELOG.md +196 -0
  2. package/PUBLIC_API.md +5 -0
  3. package/README.md +93 -478
  4. package/README.zh-CN.md +88 -461
  5. package/SUBAGENT_ADAPTER_CONTRACT.md +5 -0
  6. package/dist/agent-profile.d.ts +71 -0
  7. package/dist/agent-profile.d.ts.map +1 -0
  8. package/dist/agent-profile.js +303 -0
  9. package/dist/agent-profile.js.map +1 -0
  10. package/dist/forge-config.d.ts +88 -0
  11. package/dist/forge-config.d.ts.map +1 -0
  12. package/dist/forge-config.js +290 -0
  13. package/dist/forge-config.js.map +1 -0
  14. package/dist/forge-extensions.d.ts.map +1 -1
  15. package/dist/forge-extensions.js +19 -3
  16. package/dist/forge-extensions.js.map +1 -1
  17. package/dist/index.d.ts +4 -0
  18. package/dist/index.d.ts.map +1 -1
  19. package/dist/index.js +97 -358
  20. package/dist/index.js.map +1 -1
  21. package/dist/lifecycle.d.ts +11 -3
  22. package/dist/lifecycle.d.ts.map +1 -1
  23. package/dist/lifecycle.js +90 -4
  24. package/dist/lifecycle.js.map +1 -1
  25. package/dist/loader.d.ts.map +1 -1
  26. package/dist/loader.js +116 -5
  27. package/dist/loader.js.map +1 -1
  28. package/dist/payload-capture.d.ts.map +1 -1
  29. package/dist/payload-capture.js +27 -0
  30. package/dist/payload-capture.js.map +1 -1
  31. package/dist/payload-command.d.ts +3 -3
  32. package/dist/payload-command.d.ts.map +1 -1
  33. package/dist/payload-command.js.map +1 -1
  34. package/dist/preview.d.ts +2 -2
  35. package/dist/preview.d.ts.map +1 -1
  36. package/dist/preview.js +2 -3
  37. package/dist/preview.js.map +1 -1
  38. package/dist/profile-command.d.ts +12 -0
  39. package/dist/profile-command.d.ts.map +1 -0
  40. package/dist/profile-command.js +291 -0
  41. package/dist/profile-command.js.map +1 -0
  42. package/dist/profile-service.d.ts +103 -0
  43. package/dist/profile-service.d.ts.map +1 -0
  44. package/dist/profile-service.js +220 -0
  45. package/dist/profile-service.js.map +1 -0
  46. package/dist/runtime/profile-runtime.d.ts +13 -0
  47. package/dist/runtime/profile-runtime.d.ts.map +1 -0
  48. package/dist/runtime/profile-runtime.js +47 -0
  49. package/dist/runtime/profile-runtime.js.map +1 -0
  50. package/dist/runtime/prompt-stack-runtime.d.ts +22 -0
  51. package/dist/runtime/prompt-stack-runtime.d.ts.map +1 -0
  52. package/dist/runtime/prompt-stack-runtime.js +104 -0
  53. package/dist/runtime/prompt-stack-runtime.js.map +1 -0
  54. package/dist/runtime/subagent-runtime.d.ts +45 -0
  55. package/dist/runtime/subagent-runtime.d.ts.map +1 -0
  56. package/dist/runtime/subagent-runtime.js +335 -0
  57. package/dist/runtime/subagent-runtime.js.map +1 -0
  58. package/dist/runtime/tool-policy-runtime.d.ts +15 -0
  59. package/dist/runtime/tool-policy-runtime.d.ts.map +1 -0
  60. package/dist/runtime/tool-policy-runtime.js +170 -0
  61. package/dist/runtime/tool-policy-runtime.js.map +1 -0
  62. package/dist/runtime/web-editor-runtime.d.ts +9 -0
  63. package/dist/runtime/web-editor-runtime.d.ts.map +1 -0
  64. package/dist/runtime/web-editor-runtime.js +131 -0
  65. package/dist/runtime/web-editor-runtime.js.map +1 -0
  66. package/dist/runtime-state.d.ts +4 -0
  67. package/dist/runtime-state.d.ts.map +1 -1
  68. package/dist/runtime-state.js +2 -0
  69. package/dist/runtime-state.js.map +1 -1
  70. package/dist/storage.d.ts +4 -0
  71. package/dist/storage.d.ts.map +1 -1
  72. package/dist/storage.js +24 -1
  73. package/dist/storage.js.map +1 -1
  74. package/dist/subagent/canonical.d.ts +22 -0
  75. package/dist/subagent/canonical.d.ts.map +1 -0
  76. package/dist/subagent/canonical.js +24 -0
  77. package/dist/subagent/canonical.js.map +1 -0
  78. package/dist/subagent/context.d.ts +8 -0
  79. package/dist/subagent/context.d.ts.map +1 -0
  80. package/dist/subagent/context.js +125 -0
  81. package/dist/subagent/context.js.map +1 -0
  82. package/dist/subagent/contract.d.ts +10 -0
  83. package/dist/subagent/contract.d.ts.map +1 -0
  84. package/dist/subagent/contract.js +10 -0
  85. package/dist/subagent/contract.js.map +1 -0
  86. package/dist/subagent/index.d.ts +14 -0
  87. package/dist/subagent/index.d.ts.map +1 -0
  88. package/dist/subagent/index.js +14 -0
  89. package/dist/subagent/index.js.map +1 -0
  90. package/dist/subagent/plan.d.ts +18 -0
  91. package/dist/subagent/plan.d.ts.map +1 -0
  92. package/dist/subagent/plan.js +157 -0
  93. package/dist/subagent/plan.js.map +1 -0
  94. package/dist/subagent/preflight.d.ts +4 -0
  95. package/dist/subagent/preflight.d.ts.map +1 -0
  96. package/dist/subagent/preflight.js +108 -0
  97. package/dist/subagent/preflight.js.map +1 -0
  98. package/dist/subagent/request.d.ts +4 -0
  99. package/dist/subagent/request.d.ts.map +1 -0
  100. package/dist/subagent/request.js +122 -0
  101. package/dist/subagent/request.js.map +1 -0
  102. package/dist/subagent/response.d.ts +8 -0
  103. package/dist/subagent/response.d.ts.map +1 -0
  104. package/dist/subagent/response.js +155 -0
  105. package/dist/subagent/response.js.map +1 -0
  106. package/dist/subagent/tools.d.ts +4 -0
  107. package/dist/subagent/tools.d.ts.map +1 -0
  108. package/dist/subagent/tools.js +42 -0
  109. package/dist/subagent/tools.js.map +1 -0
  110. package/dist/subagent/types.d.ts +268 -0
  111. package/dist/subagent/types.d.ts.map +1 -0
  112. package/dist/subagent/types.js +3 -0
  113. package/dist/subagent/types.js.map +1 -0
  114. package/dist/subagent/validation.d.ts +35 -0
  115. package/dist/subagent/validation.d.ts.map +1 -0
  116. package/dist/subagent/validation.js +314 -0
  117. package/dist/subagent/validation.js.map +1 -0
  118. package/dist/subagent-command.d.ts +4 -0
  119. package/dist/subagent-command.d.ts.map +1 -0
  120. package/dist/subagent-command.js +246 -0
  121. package/dist/subagent-command.js.map +1 -0
  122. package/dist/subagent-host.d.ts +44 -0
  123. package/dist/subagent-host.d.ts.map +1 -0
  124. package/dist/subagent-host.js +292 -0
  125. package/dist/subagent-host.js.map +1 -0
  126. package/dist/subagent-profile-tool.d.ts +49 -0
  127. package/dist/subagent-profile-tool.d.ts.map +1 -0
  128. package/dist/subagent-profile-tool.js +124 -0
  129. package/dist/subagent-profile-tool.js.map +1 -0
  130. package/dist/subagent-tool.d.ts +53 -0
  131. package/dist/subagent-tool.d.ts.map +1 -0
  132. package/dist/subagent-tool.js +456 -0
  133. package/dist/subagent-tool.js.map +1 -0
  134. package/dist/web-editor/client-script.d.ts +2 -0
  135. package/dist/web-editor/client-script.d.ts.map +1 -0
  136. package/dist/web-editor/client-script.generated.d.ts +2 -0
  137. package/dist/web-editor/client-script.generated.d.ts.map +1 -0
  138. package/dist/web-editor/client-script.generated.js +3 -0
  139. package/dist/web-editor/client-script.generated.js.map +1 -0
  140. package/dist/web-editor/client-script.js +2 -0
  141. package/dist/web-editor/client-script.js.map +1 -0
  142. package/dist/web-editor/client-styles.d.ts +2 -0
  143. package/dist/web-editor/client-styles.d.ts.map +1 -0
  144. package/dist/web-editor/client-styles.generated.d.ts +2 -0
  145. package/dist/web-editor/client-styles.generated.d.ts.map +1 -0
  146. package/dist/web-editor/client-styles.generated.js +3 -0
  147. package/dist/web-editor/client-styles.generated.js.map +1 -0
  148. package/dist/web-editor/client-styles.js +2 -0
  149. package/dist/web-editor/client-styles.js.map +1 -0
  150. package/dist/web-editor/page.d.ts +2 -0
  151. package/dist/web-editor/page.d.ts.map +1 -1
  152. package/dist/web-editor/page.js +14 -3319
  153. package/dist/web-editor/page.js.map +1 -1
  154. package/dist/web-editor/server.d.ts.map +1 -1
  155. package/dist/web-editor/server.js +148 -0
  156. package/dist/web-editor/server.js.map +1 -1
  157. package/dist/web-editor/styles.d.ts +2 -0
  158. package/dist/web-editor/styles.d.ts.map +1 -0
  159. package/dist/web-editor/styles.js +1053 -0
  160. package/dist/web-editor/styles.js.map +1 -0
  161. package/dist/web-editor/types.d.ts +79 -0
  162. package/dist/web-editor/types.d.ts.map +1 -1
  163. package/dist/web-host.d.ts +16 -5
  164. package/dist/web-host.d.ts.map +1 -1
  165. package/dist/web-host.js +307 -0
  166. package/dist/web-host.js.map +1 -1
  167. package/docs/README.md +41 -0
  168. package/docs/concepts/agent-profiles.md +60 -0
  169. package/docs/concepts/prompt-stacks.md +90 -0
  170. package/docs/design/README.md +17 -0
  171. package/docs/design/roadmap-0.4-archive.md +216 -0
  172. package/docs/design/subagents/design-review.md +220 -0
  173. package/docs/design/subagents/interface-design.md +274 -0
  174. package/docs/design/subagents/sdk-spike-findings.md +117 -0
  175. package/docs/development/complexity-review.md +86 -0
  176. package/docs/development/release.md +31 -0
  177. package/docs/development/roadmap.md +42 -0
  178. package/docs/development/setup.md +75 -0
  179. package/docs/getting-started.md +93 -0
  180. package/docs/guides/custom-macros-and-slots.md +68 -0
  181. package/docs/guides/debugging.md +39 -0
  182. package/docs/guides/delegation.md +99 -0
  183. package/docs/guides/sillytavern-import.md +47 -0
  184. package/docs/guides/use-cases.md +65 -0
  185. package/docs/guides/web-editor.md +75 -0
  186. package/docs/reference/commands.md +60 -0
  187. package/docs/reference/configuration.md +64 -0
  188. package/docs/reference/features.md +279 -0
  189. package/docs/reference/macros-and-slots.md +82 -0
  190. package/docs/reference/public-api.md +28 -0
  191. package/docs/reference/stack-schema.md +167 -0
  192. package/docs/reference/subagent-adapter.md +204 -0
  193. package/docs/zh-CN/README.md +37 -0
  194. package/docs/zh-CN/concepts/agent-profiles.md +44 -0
  195. package/docs/zh-CN/concepts/prompt-stacks.md +40 -0
  196. package/docs/zh-CN/getting-started.md +79 -0
  197. package/docs/zh-CN/guides/delegation.md +66 -0
  198. package/docs/zh-CN/guides/web-editor.md +45 -0
  199. package/docs/zh-CN/reference/commands.md +58 -0
  200. package/package.json +55 -13
  201. package/src/compiler.ts +0 -578
  202. package/src/extension-registry.ts +0 -33
  203. package/src/forge-extensions.ts +0 -223
  204. package/src/index.ts +0 -445
  205. package/src/lifecycle.ts +0 -171
  206. package/src/loader.ts +0 -394
  207. package/src/macro-engine.ts +0 -358
  208. package/src/payload-capture.ts +0 -85
  209. package/src/payload-command.ts +0 -138
  210. package/src/policy.ts +0 -42
  211. package/src/preset-command.ts +0 -280
  212. package/src/preview.ts +0 -226
  213. package/src/regex.ts +0 -500
  214. package/src/render-helpers.ts +0 -169
  215. package/src/runtime-state.ts +0 -40
  216. package/src/sillytavern-importer/items.ts +0 -98
  217. package/src/sillytavern-importer/macros.ts +0 -159
  218. package/src/sillytavern-importer/prompt-order.ts +0 -54
  219. package/src/sillytavern-importer/regex.ts +0 -270
  220. package/src/sillytavern-importer/report.ts +0 -202
  221. package/src/sillytavern-importer/types.ts +0 -120
  222. package/src/sillytavern-importer.ts +0 -152
  223. package/src/slot-renderers.ts +0 -414
  224. package/src/stack-migration.ts +0 -159
  225. package/src/storage.ts +0 -45
  226. package/src/types.ts +0 -209
  227. package/src/web-editor/index.ts +0 -2
  228. package/src/web-editor/page.ts +0 -3330
  229. package/src/web-editor/server.ts +0 -294
  230. package/src/web-editor/types.ts +0 -98
  231. package/src/web-host.ts +0 -232
package/src/types.ts DELETED
@@ -1,209 +0,0 @@
1
- import type { AgentMessage } from "@earendil-works/pi-agent-core";
2
- import type { BuildSystemPromptOptions, ExtensionContext } from "@earendil-works/pi-coding-agent";
3
-
4
- export type PromptStackMode = "replace" | "append" | "prepend";
5
-
6
- export type PromptStackRole = "system" | "user" | "assistant" | "custom";
7
-
8
- export type PromptStackSlot =
9
- | "chat-history"
10
- | "tools"
11
- | "tool-guidelines"
12
- | "skills"
13
- | "project-context"
14
- | "append-system-prompt"
15
- | "date"
16
- | "cwd"
17
- | "date-cwd"
18
- | "active-model"
19
- | "pi-docs"
20
- | "variables";
21
-
22
- export type PromptStackSlotFormat = "xml" | "json" | "plain";
23
-
24
- export type PromptRegexStage = "history" | "compiled";
25
-
26
- export type PromptRegexEffect = "outgoing" | "display" | "both" | "finalize";
27
-
28
- export type PromptRegexTarget = "system" | "messages";
29
-
30
- export interface PromptRegexRule {
31
- id: string;
32
- name?: string;
33
- enabled?: boolean;
34
- stage: PromptRegexStage;
35
- effect?: PromptRegexEffect;
36
- pattern: string;
37
- flags?: string;
38
- replace?: string;
39
- trimStrings?: string[];
40
- roles?: string[];
41
- targets?: PromptRegexTarget[];
42
- maxMessages?: number;
43
- maxChars?: number;
44
- minDepth?: number;
45
- maxDepth?: number;
46
- source?: Record<string, unknown>;
47
- }
48
-
49
- export interface PromptRegexConfig {
50
- schemaVersion?: 1;
51
- rules?: PromptRegexRule[];
52
- }
53
-
54
- export type PromptResourcePolicy =
55
- | { allow?: string[]; deny?: never }
56
- | { allow?: never; deny?: string[] };
57
-
58
- export interface PromptStackDefaults {
59
- syntheticMessagesVisible?: boolean;
60
- unresolvedMacroPolicy?: "warn" | "keep" | "error";
61
- }
62
-
63
- export interface PromptStackContextOptions {
64
- allowDuplicateChatHistory?: boolean;
65
- }
66
-
67
- export interface PromptStackBaseItem {
68
- kind: "block" | "slot";
69
- id: string;
70
- name?: string;
71
- enabled?: boolean;
72
- role?: PromptStackRole;
73
- tags?: string[];
74
- source?: Record<string, unknown>;
75
- }
76
-
77
- export interface PromptStackBlockItem extends PromptStackBaseItem {
78
- kind: "block";
79
- content: string;
80
- }
81
-
82
- export interface VariablesSlotOptions {
83
- /** Include static stack variables. Default: true. */
84
- includeStatic?: boolean;
85
- /** Include session variables. Default: true. */
86
- includeSession?: boolean;
87
- /** Include turn variables. Default: true. */
88
- includeTurn?: boolean;
89
- /** Render format. Default: xml. */
90
- format?: Exclude<PromptStackSlotFormat, "json">;
91
- }
92
-
93
- export interface PromptStackSlotOptions {
94
- /** For chat-history: include the latest user message in the expanded history. Default: true. */
95
- includeLastUserMessage?: boolean;
96
- /** For chat-history: remove assistant thinking content blocks from inserted history. Default: false. */
97
- stripAssistantThinking?: boolean;
98
- /** For chat-history: keep only messages with these roles. Default: all roles. */
99
- roles?: string[];
100
- /** For chat-history: include Pi branch/compaction summaries. Default: true. */
101
- includeSummaries?: boolean;
102
- /** For chat-history: keep or drop tool-call/tool-result history. Default: keep. */
103
- toolMode?: "keep" | "drop";
104
- /** For chat-history: keep only the most recent N messages after filtering. */
105
- maxMessages?: number;
106
- /** For chat-history: keep only the most recent messages within an approximate character budget. */
107
- maxChars?: number;
108
- /** For variables: control which variable scopes are included. */
109
- includeStatic?: boolean;
110
- includeSession?: boolean;
111
- includeTurn?: boolean;
112
- format?: PromptStackSlotFormat;
113
- /** For tools: only render tools that provide prompt snippets, matching Pi's default prompt builder. */
114
- onlyWithSnippets?: boolean;
115
- /** For date/date-cwd: include the exact current time. Default: false. */
116
- includeTime?: boolean;
117
- /** For tool-guidelines: override the plain-format section heading. */
118
- heading?: string;
119
- /** For tool-guidelines: include Pi's default concise/file-path guideline bullets. */
120
- includePiDefaultGuidelines?: boolean;
121
- /** For tool-guidelines: match Pi's default wording where it differs from pi-forge's generic wording. */
122
- piStyle?: boolean;
123
- /** For skills: omit the skills section unless the read tool is active, matching Pi's default prompt builder. */
124
- requireReadTool?: boolean;
125
- [key: string]: unknown;
126
- }
127
-
128
- export interface PromptStackSlotItem extends PromptStackBaseItem {
129
- kind: "slot";
130
- slot: PromptStackSlot | string;
131
- options?: PromptStackSlotOptions;
132
- }
133
-
134
- export type PromptStackItem = PromptStackBlockItem | PromptStackSlotItem;
135
-
136
- export type PromptVariablePrimitive = string | number | boolean | null;
137
-
138
- export type PromptVariableValue = PromptVariablePrimitive | PromptVariableValue[] | { [key: string]: PromptVariableValue };
139
-
140
- export interface PromptStack {
141
- schemaVersion: 1;
142
- type?: "pi-forge.prompt-stack";
143
- id: string;
144
- name?: string;
145
- description?: string;
146
- autoActivate?: boolean;
147
- mode?: PromptStackMode;
148
- defaults?: PromptStackDefaults;
149
- context?: PromptStackContextOptions;
150
- tools?: PromptResourcePolicy;
151
- skills?: PromptResourcePolicy;
152
- variables?: Record<string, string>;
153
- regex?: PromptRegexConfig;
154
- items: PromptStackItem[];
155
- import?: Record<string, unknown>;
156
- }
157
-
158
- export interface LoadedPromptStack {
159
- stack: PromptStack;
160
- filePath: string;
161
- diagnostics: PromptStackDiagnostic[];
162
- }
163
-
164
- export type PromptStackDiagnosticLevel = "error" | "warning" | "info";
165
-
166
- export interface PromptStackDiagnostic {
167
- level: PromptStackDiagnosticLevel;
168
- message: string;
169
- itemId?: string;
170
- }
171
-
172
- export interface PromptVariableStore {
173
- turn: Record<string, PromptVariableValue>;
174
- session: Record<string, PromptVariableValue>;
175
- sessionDirty?: boolean;
176
- }
177
-
178
- export interface PromptRuntime {
179
- options: BuildSystemPromptOptions;
180
- ctx?: ExtensionContext;
181
- latestUserMessage?: string;
182
- now: Date;
183
- variables?: PromptVariableStore;
184
- }
185
-
186
- export interface CompileSystemPromptResult {
187
- systemPrompt: string;
188
- diagnostics: PromptStackDiagnostic[];
189
- }
190
-
191
- export type CompileMessageSourceKind = "stack-item" | "chat-history" | "implicit-history";
192
-
193
- export interface CompileMessageSource {
194
- kind: CompileMessageSourceKind;
195
- itemId?: string;
196
- itemName?: string;
197
- slot?: string;
198
- historyIndex?: number;
199
- historyCount?: number;
200
- role?: string;
201
- }
202
-
203
- export interface CompileMessagesResult {
204
- messages: AgentMessage[];
205
- messageSources: CompileMessageSource[];
206
- diagnostics: PromptStackDiagnostic[];
207
- }
208
-
209
- export { SUPPORTED_SLOTS } from "./slot-renderers.ts";
@@ -1,2 +0,0 @@
1
- export { DEFAULT_WEB_EDITOR_PORT, startWebEditorServer } from "./server.ts";
2
- export type * from "./types.ts";