@zihanw/pi-forge 0.3.2 → 0.4.0-beta.1

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 (244) hide show
  1. package/CHANGELOG.md +160 -0
  2. package/PUBLIC_API.md +28 -0
  3. package/README.md +137 -11
  4. package/README.zh-CN.md +137 -11
  5. package/SUBAGENT_ADAPTER_CONTRACT.md +199 -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 +8 -0
  11. package/dist/forge-config.d.ts.map +1 -0
  12. package/dist/forge-config.js +40 -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 +7 -0
  18. package/dist/index.d.ts.map +1 -1
  19. package/dist/index.js +75 -361
  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 +215 -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 +30 -0
  55. package/dist/runtime/subagent-runtime.d.ts.map +1 -0
  56. package/dist/runtime/subagent-runtime.js +114 -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 +3 -0
  71. package/dist/storage.d.ts.map +1 -1
  72. package/dist/storage.js +9 -0
  73. package/dist/storage.js.map +1 -1
  74. package/dist/subagent/backend-registry.d.ts +75 -0
  75. package/dist/subagent/backend-registry.d.ts.map +1 -0
  76. package/dist/subagent/backend-registry.js +463 -0
  77. package/dist/subagent/backend-registry.js.map +1 -0
  78. package/dist/subagent/canonical.d.ts +10 -0
  79. package/dist/subagent/canonical.d.ts.map +1 -0
  80. package/dist/subagent/canonical.js +52 -0
  81. package/dist/subagent/canonical.js.map +1 -0
  82. package/dist/subagent/context.d.ts +8 -0
  83. package/dist/subagent/context.d.ts.map +1 -0
  84. package/dist/subagent/context.js +125 -0
  85. package/dist/subagent/context.js.map +1 -0
  86. package/dist/subagent/contract.d.ts +11 -0
  87. package/dist/subagent/contract.d.ts.map +1 -0
  88. package/dist/subagent/contract.js +11 -0
  89. package/dist/subagent/contract.js.map +1 -0
  90. package/dist/subagent/diagnostics.d.ts +3 -0
  91. package/dist/subagent/diagnostics.d.ts.map +1 -0
  92. package/dist/subagent/diagnostics.js +5 -0
  93. package/dist/subagent/diagnostics.js.map +1 -0
  94. package/dist/subagent/index.d.ts +13 -0
  95. package/dist/subagent/index.d.ts.map +1 -0
  96. package/dist/subagent/index.js +13 -0
  97. package/dist/subagent/index.js.map +1 -0
  98. package/dist/subagent/pi-model-runtime.d.ts +8 -0
  99. package/dist/subagent/pi-model-runtime.d.ts.map +1 -0
  100. package/dist/subagent/pi-model-runtime.js +22 -0
  101. package/dist/subagent/pi-model-runtime.js.map +1 -0
  102. package/dist/subagent/pi-sdk-backend.d.ts +23 -0
  103. package/dist/subagent/pi-sdk-backend.d.ts.map +1 -0
  104. package/dist/subagent/pi-sdk-backend.js +383 -0
  105. package/dist/subagent/pi-sdk-backend.js.map +1 -0
  106. package/dist/subagent/pi-subprocess-backend.d.ts +72 -0
  107. package/dist/subagent/pi-subprocess-backend.d.ts.map +1 -0
  108. package/dist/subagent/pi-subprocess-backend.js +756 -0
  109. package/dist/subagent/pi-subprocess-backend.js.map +1 -0
  110. package/dist/subagent/plan.d.ts +14 -0
  111. package/dist/subagent/plan.d.ts.map +1 -0
  112. package/dist/subagent/plan.js +160 -0
  113. package/dist/subagent/plan.js.map +1 -0
  114. package/dist/subagent/preflight.d.ts +4 -0
  115. package/dist/subagent/preflight.d.ts.map +1 -0
  116. package/dist/subagent/preflight.js +108 -0
  117. package/dist/subagent/preflight.js.map +1 -0
  118. package/dist/subagent/request.d.ts +4 -0
  119. package/dist/subagent/request.d.ts.map +1 -0
  120. package/dist/subagent/request.js +122 -0
  121. package/dist/subagent/request.js.map +1 -0
  122. package/dist/subagent/response.d.ts +8 -0
  123. package/dist/subagent/response.d.ts.map +1 -0
  124. package/dist/subagent/response.js +155 -0
  125. package/dist/subagent/response.js.map +1 -0
  126. package/dist/subagent/subprocess-bridge.d.ts +21 -0
  127. package/dist/subagent/subprocess-bridge.d.ts.map +1 -0
  128. package/dist/subagent/subprocess-bridge.js +87 -0
  129. package/dist/subagent/subprocess-bridge.js.map +1 -0
  130. package/dist/subagent/subprocess-report.d.ts +4 -0
  131. package/dist/subagent/subprocess-report.d.ts.map +1 -0
  132. package/dist/subagent/subprocess-report.js +55 -0
  133. package/dist/subagent/subprocess-report.js.map +1 -0
  134. package/dist/subagent/tools.d.ts +4 -0
  135. package/dist/subagent/tools.d.ts.map +1 -0
  136. package/dist/subagent/tools.js +42 -0
  137. package/dist/subagent/tools.js.map +1 -0
  138. package/dist/subagent/types.d.ts +384 -0
  139. package/dist/subagent/types.d.ts.map +1 -0
  140. package/dist/subagent/types.js +3 -0
  141. package/dist/subagent/types.js.map +1 -0
  142. package/dist/subagent/validation.d.ts +35 -0
  143. package/dist/subagent/validation.d.ts.map +1 -0
  144. package/dist/subagent/validation.js +500 -0
  145. package/dist/subagent/validation.js.map +1 -0
  146. package/dist/subagent-command.d.ts +4 -0
  147. package/dist/subagent-command.d.ts.map +1 -0
  148. package/dist/subagent-command.js +153 -0
  149. package/dist/subagent-command.js.map +1 -0
  150. package/dist/subagent-contract.d.ts +8 -0
  151. package/dist/subagent-contract.d.ts.map +1 -0
  152. package/dist/subagent-contract.js +8 -0
  153. package/dist/subagent-contract.js.map +1 -0
  154. package/dist/subagent-host.d.ts +44 -0
  155. package/dist/subagent-host.d.ts.map +1 -0
  156. package/dist/subagent-host.js +291 -0
  157. package/dist/subagent-host.js.map +1 -0
  158. package/dist/subagent-profile-tool.d.ts +26 -0
  159. package/dist/subagent-profile-tool.d.ts.map +1 -0
  160. package/dist/subagent-profile-tool.js +93 -0
  161. package/dist/subagent-profile-tool.js.map +1 -0
  162. package/dist/subagent-tool.d.ts +50 -0
  163. package/dist/subagent-tool.d.ts.map +1 -0
  164. package/dist/subagent-tool.js +385 -0
  165. package/dist/subagent-tool.js.map +1 -0
  166. package/dist/web-editor/client/api.d.ts +9 -0
  167. package/dist/web-editor/client/api.d.ts.map +1 -0
  168. package/dist/web-editor/client/api.js +26 -0
  169. package/dist/web-editor/client/api.js.map +1 -0
  170. package/dist/web-editor/client/dom.d.ts +13 -0
  171. package/dist/web-editor/client/dom.d.ts.map +1 -0
  172. package/dist/web-editor/client/dom.js +30 -0
  173. package/dist/web-editor/client/dom.js.map +1 -0
  174. package/dist/web-editor/client/inspector.d.ts +22 -0
  175. package/dist/web-editor/client/inspector.d.ts.map +1 -0
  176. package/dist/web-editor/client/inspector.js +226 -0
  177. package/dist/web-editor/client/inspector.js.map +1 -0
  178. package/dist/web-editor/client/main.d.ts +2 -0
  179. package/dist/web-editor/client/main.d.ts.map +1 -0
  180. package/dist/web-editor/client/main.js +1468 -0
  181. package/dist/web-editor/client/main.js.map +1 -0
  182. package/dist/web-editor/client/policy-editor.d.ts +16 -0
  183. package/dist/web-editor/client/policy-editor.d.ts.map +1 -0
  184. package/dist/web-editor/client/policy-editor.js +330 -0
  185. package/dist/web-editor/client/policy-editor.js.map +1 -0
  186. package/dist/web-editor/client/regex-editor.d.ts +19 -0
  187. package/dist/web-editor/client/regex-editor.d.ts.map +1 -0
  188. package/dist/web-editor/client/regex-editor.js +281 -0
  189. package/dist/web-editor/client/regex-editor.js.map +1 -0
  190. package/dist/web-editor/client/types.d.ts +60 -0
  191. package/dist/web-editor/client/types.d.ts.map +1 -0
  192. package/dist/web-editor/client/types.js +2 -0
  193. package/dist/web-editor/client/types.js.map +1 -0
  194. package/dist/web-editor/client-script.d.ts +2 -0
  195. package/dist/web-editor/client-script.d.ts.map +1 -0
  196. package/dist/web-editor/client-script.generated.d.ts +2 -0
  197. package/dist/web-editor/client-script.generated.d.ts.map +1 -0
  198. package/dist/web-editor/client-script.generated.js +3 -0
  199. package/dist/web-editor/client-script.generated.js.map +1 -0
  200. package/dist/web-editor/client-script.js +2 -0
  201. package/dist/web-editor/client-script.js.map +1 -0
  202. package/dist/web-editor/page.d.ts.map +1 -1
  203. package/dist/web-editor/page.js +6 -3249
  204. package/dist/web-editor/page.js.map +1 -1
  205. package/dist/web-editor/styles.d.ts +2 -0
  206. package/dist/web-editor/styles.d.ts.map +1 -0
  207. package/dist/web-editor/styles.js +996 -0
  208. package/dist/web-editor/styles.js.map +1 -0
  209. package/dist/web-host.d.ts +3 -3
  210. package/dist/web-host.d.ts.map +1 -1
  211. package/dist/web-host.js +6 -0
  212. package/dist/web-host.js.map +1 -1
  213. package/package.json +42 -14
  214. package/src/compiler.ts +0 -578
  215. package/src/extension-registry.ts +0 -33
  216. package/src/forge-extensions.ts +0 -223
  217. package/src/index.ts +0 -445
  218. package/src/lifecycle.ts +0 -171
  219. package/src/loader.ts +0 -394
  220. package/src/macro-engine.ts +0 -358
  221. package/src/payload-capture.ts +0 -85
  222. package/src/payload-command.ts +0 -138
  223. package/src/policy.ts +0 -42
  224. package/src/preset-command.ts +0 -280
  225. package/src/preview.ts +0 -226
  226. package/src/regex.ts +0 -500
  227. package/src/render-helpers.ts +0 -169
  228. package/src/runtime-state.ts +0 -40
  229. package/src/sillytavern-importer/items.ts +0 -98
  230. package/src/sillytavern-importer/macros.ts +0 -159
  231. package/src/sillytavern-importer/prompt-order.ts +0 -54
  232. package/src/sillytavern-importer/regex.ts +0 -270
  233. package/src/sillytavern-importer/report.ts +0 -202
  234. package/src/sillytavern-importer/types.ts +0 -120
  235. package/src/sillytavern-importer.ts +0 -152
  236. package/src/slot-renderers.ts +0 -414
  237. package/src/stack-migration.ts +0 -159
  238. package/src/storage.ts +0 -45
  239. package/src/types.ts +0 -209
  240. package/src/web-editor/index.ts +0 -2
  241. package/src/web-editor/page.ts +0 -3330
  242. package/src/web-editor/server.ts +0 -294
  243. package/src/web-editor/types.ts +0 -98
  244. 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";