@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.
- package/CHANGELOG.md +196 -0
- package/PUBLIC_API.md +5 -0
- package/README.md +93 -478
- package/README.zh-CN.md +88 -461
- package/SUBAGENT_ADAPTER_CONTRACT.md +5 -0
- package/dist/agent-profile.d.ts +71 -0
- package/dist/agent-profile.d.ts.map +1 -0
- package/dist/agent-profile.js +303 -0
- package/dist/agent-profile.js.map +1 -0
- package/dist/forge-config.d.ts +88 -0
- package/dist/forge-config.d.ts.map +1 -0
- package/dist/forge-config.js +290 -0
- package/dist/forge-config.js.map +1 -0
- package/dist/forge-extensions.d.ts.map +1 -1
- package/dist/forge-extensions.js +19 -3
- package/dist/forge-extensions.js.map +1 -1
- package/dist/index.d.ts +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +97 -358
- package/dist/index.js.map +1 -1
- package/dist/lifecycle.d.ts +11 -3
- package/dist/lifecycle.d.ts.map +1 -1
- package/dist/lifecycle.js +90 -4
- package/dist/lifecycle.js.map +1 -1
- package/dist/loader.d.ts.map +1 -1
- package/dist/loader.js +116 -5
- package/dist/loader.js.map +1 -1
- package/dist/payload-capture.d.ts.map +1 -1
- package/dist/payload-capture.js +27 -0
- package/dist/payload-capture.js.map +1 -1
- package/dist/payload-command.d.ts +3 -3
- package/dist/payload-command.d.ts.map +1 -1
- package/dist/payload-command.js.map +1 -1
- package/dist/preview.d.ts +2 -2
- package/dist/preview.d.ts.map +1 -1
- package/dist/preview.js +2 -3
- package/dist/preview.js.map +1 -1
- package/dist/profile-command.d.ts +12 -0
- package/dist/profile-command.d.ts.map +1 -0
- package/dist/profile-command.js +291 -0
- package/dist/profile-command.js.map +1 -0
- package/dist/profile-service.d.ts +103 -0
- package/dist/profile-service.d.ts.map +1 -0
- package/dist/profile-service.js +220 -0
- package/dist/profile-service.js.map +1 -0
- package/dist/runtime/profile-runtime.d.ts +13 -0
- package/dist/runtime/profile-runtime.d.ts.map +1 -0
- package/dist/runtime/profile-runtime.js +47 -0
- package/dist/runtime/profile-runtime.js.map +1 -0
- package/dist/runtime/prompt-stack-runtime.d.ts +22 -0
- package/dist/runtime/prompt-stack-runtime.d.ts.map +1 -0
- package/dist/runtime/prompt-stack-runtime.js +104 -0
- package/dist/runtime/prompt-stack-runtime.js.map +1 -0
- package/dist/runtime/subagent-runtime.d.ts +45 -0
- package/dist/runtime/subagent-runtime.d.ts.map +1 -0
- package/dist/runtime/subagent-runtime.js +335 -0
- package/dist/runtime/subagent-runtime.js.map +1 -0
- package/dist/runtime/tool-policy-runtime.d.ts +15 -0
- package/dist/runtime/tool-policy-runtime.d.ts.map +1 -0
- package/dist/runtime/tool-policy-runtime.js +170 -0
- package/dist/runtime/tool-policy-runtime.js.map +1 -0
- package/dist/runtime/web-editor-runtime.d.ts +9 -0
- package/dist/runtime/web-editor-runtime.d.ts.map +1 -0
- package/dist/runtime/web-editor-runtime.js +131 -0
- package/dist/runtime/web-editor-runtime.js.map +1 -0
- package/dist/runtime-state.d.ts +4 -0
- package/dist/runtime-state.d.ts.map +1 -1
- package/dist/runtime-state.js +2 -0
- package/dist/runtime-state.js.map +1 -1
- package/dist/storage.d.ts +4 -0
- package/dist/storage.d.ts.map +1 -1
- package/dist/storage.js +24 -1
- package/dist/storage.js.map +1 -1
- package/dist/subagent/canonical.d.ts +22 -0
- package/dist/subagent/canonical.d.ts.map +1 -0
- package/dist/subagent/canonical.js +24 -0
- package/dist/subagent/canonical.js.map +1 -0
- package/dist/subagent/context.d.ts +8 -0
- package/dist/subagent/context.d.ts.map +1 -0
- package/dist/subagent/context.js +125 -0
- package/dist/subagent/context.js.map +1 -0
- package/dist/subagent/contract.d.ts +10 -0
- package/dist/subagent/contract.d.ts.map +1 -0
- package/dist/subagent/contract.js +10 -0
- package/dist/subagent/contract.js.map +1 -0
- package/dist/subagent/index.d.ts +14 -0
- package/dist/subagent/index.d.ts.map +1 -0
- package/dist/subagent/index.js +14 -0
- package/dist/subagent/index.js.map +1 -0
- package/dist/subagent/plan.d.ts +18 -0
- package/dist/subagent/plan.d.ts.map +1 -0
- package/dist/subagent/plan.js +157 -0
- package/dist/subagent/plan.js.map +1 -0
- package/dist/subagent/preflight.d.ts +4 -0
- package/dist/subagent/preflight.d.ts.map +1 -0
- package/dist/subagent/preflight.js +108 -0
- package/dist/subagent/preflight.js.map +1 -0
- package/dist/subagent/request.d.ts +4 -0
- package/dist/subagent/request.d.ts.map +1 -0
- package/dist/subagent/request.js +122 -0
- package/dist/subagent/request.js.map +1 -0
- package/dist/subagent/response.d.ts +8 -0
- package/dist/subagent/response.d.ts.map +1 -0
- package/dist/subagent/response.js +155 -0
- package/dist/subagent/response.js.map +1 -0
- package/dist/subagent/tools.d.ts +4 -0
- package/dist/subagent/tools.d.ts.map +1 -0
- package/dist/subagent/tools.js +42 -0
- package/dist/subagent/tools.js.map +1 -0
- package/dist/subagent/types.d.ts +268 -0
- package/dist/subagent/types.d.ts.map +1 -0
- package/dist/subagent/types.js +3 -0
- package/dist/subagent/types.js.map +1 -0
- package/dist/subagent/validation.d.ts +35 -0
- package/dist/subagent/validation.d.ts.map +1 -0
- package/dist/subagent/validation.js +314 -0
- package/dist/subagent/validation.js.map +1 -0
- package/dist/subagent-command.d.ts +4 -0
- package/dist/subagent-command.d.ts.map +1 -0
- package/dist/subagent-command.js +246 -0
- package/dist/subagent-command.js.map +1 -0
- package/dist/subagent-host.d.ts +44 -0
- package/dist/subagent-host.d.ts.map +1 -0
- package/dist/subagent-host.js +292 -0
- package/dist/subagent-host.js.map +1 -0
- package/dist/subagent-profile-tool.d.ts +49 -0
- package/dist/subagent-profile-tool.d.ts.map +1 -0
- package/dist/subagent-profile-tool.js +124 -0
- package/dist/subagent-profile-tool.js.map +1 -0
- package/dist/subagent-tool.d.ts +53 -0
- package/dist/subagent-tool.d.ts.map +1 -0
- package/dist/subagent-tool.js +456 -0
- package/dist/subagent-tool.js.map +1 -0
- package/dist/web-editor/client-script.d.ts +2 -0
- package/dist/web-editor/client-script.d.ts.map +1 -0
- package/dist/web-editor/client-script.generated.d.ts +2 -0
- package/dist/web-editor/client-script.generated.d.ts.map +1 -0
- package/dist/web-editor/client-script.generated.js +3 -0
- package/dist/web-editor/client-script.generated.js.map +1 -0
- package/dist/web-editor/client-script.js +2 -0
- package/dist/web-editor/client-script.js.map +1 -0
- package/dist/web-editor/client-styles.d.ts +2 -0
- package/dist/web-editor/client-styles.d.ts.map +1 -0
- package/dist/web-editor/client-styles.generated.d.ts +2 -0
- package/dist/web-editor/client-styles.generated.d.ts.map +1 -0
- package/dist/web-editor/client-styles.generated.js +3 -0
- package/dist/web-editor/client-styles.generated.js.map +1 -0
- package/dist/web-editor/client-styles.js +2 -0
- package/dist/web-editor/client-styles.js.map +1 -0
- package/dist/web-editor/page.d.ts +2 -0
- package/dist/web-editor/page.d.ts.map +1 -1
- package/dist/web-editor/page.js +14 -3319
- package/dist/web-editor/page.js.map +1 -1
- package/dist/web-editor/server.d.ts.map +1 -1
- package/dist/web-editor/server.js +148 -0
- package/dist/web-editor/server.js.map +1 -1
- package/dist/web-editor/styles.d.ts +2 -0
- package/dist/web-editor/styles.d.ts.map +1 -0
- package/dist/web-editor/styles.js +1053 -0
- package/dist/web-editor/styles.js.map +1 -0
- package/dist/web-editor/types.d.ts +79 -0
- package/dist/web-editor/types.d.ts.map +1 -1
- package/dist/web-host.d.ts +16 -5
- package/dist/web-host.d.ts.map +1 -1
- package/dist/web-host.js +307 -0
- package/dist/web-host.js.map +1 -1
- package/docs/README.md +41 -0
- package/docs/concepts/agent-profiles.md +60 -0
- package/docs/concepts/prompt-stacks.md +90 -0
- package/docs/design/README.md +17 -0
- package/docs/design/roadmap-0.4-archive.md +216 -0
- package/docs/design/subagents/design-review.md +220 -0
- package/docs/design/subagents/interface-design.md +274 -0
- package/docs/design/subagents/sdk-spike-findings.md +117 -0
- package/docs/development/complexity-review.md +86 -0
- package/docs/development/release.md +31 -0
- package/docs/development/roadmap.md +42 -0
- package/docs/development/setup.md +75 -0
- package/docs/getting-started.md +93 -0
- package/docs/guides/custom-macros-and-slots.md +68 -0
- package/docs/guides/debugging.md +39 -0
- package/docs/guides/delegation.md +99 -0
- package/docs/guides/sillytavern-import.md +47 -0
- package/docs/guides/use-cases.md +65 -0
- package/docs/guides/web-editor.md +75 -0
- package/docs/reference/commands.md +60 -0
- package/docs/reference/configuration.md +64 -0
- package/docs/reference/features.md +279 -0
- package/docs/reference/macros-and-slots.md +82 -0
- package/docs/reference/public-api.md +28 -0
- package/docs/reference/stack-schema.md +167 -0
- package/docs/reference/subagent-adapter.md +204 -0
- package/docs/zh-CN/README.md +37 -0
- package/docs/zh-CN/concepts/agent-profiles.md +44 -0
- package/docs/zh-CN/concepts/prompt-stacks.md +40 -0
- package/docs/zh-CN/getting-started.md +79 -0
- package/docs/zh-CN/guides/delegation.md +66 -0
- package/docs/zh-CN/guides/web-editor.md +45 -0
- package/docs/zh-CN/reference/commands.md +58 -0
- package/package.json +55 -13
- package/src/compiler.ts +0 -578
- package/src/extension-registry.ts +0 -33
- package/src/forge-extensions.ts +0 -223
- package/src/index.ts +0 -445
- package/src/lifecycle.ts +0 -171
- package/src/loader.ts +0 -394
- package/src/macro-engine.ts +0 -358
- package/src/payload-capture.ts +0 -85
- package/src/payload-command.ts +0 -138
- package/src/policy.ts +0 -42
- package/src/preset-command.ts +0 -280
- package/src/preview.ts +0 -226
- package/src/regex.ts +0 -500
- package/src/render-helpers.ts +0 -169
- package/src/runtime-state.ts +0 -40
- package/src/sillytavern-importer/items.ts +0 -98
- package/src/sillytavern-importer/macros.ts +0 -159
- package/src/sillytavern-importer/prompt-order.ts +0 -54
- package/src/sillytavern-importer/regex.ts +0 -270
- package/src/sillytavern-importer/report.ts +0 -202
- package/src/sillytavern-importer/types.ts +0 -120
- package/src/sillytavern-importer.ts +0 -152
- package/src/slot-renderers.ts +0 -414
- package/src/stack-migration.ts +0 -159
- package/src/storage.ts +0 -45
- package/src/types.ts +0 -209
- package/src/web-editor/index.ts +0 -2
- package/src/web-editor/page.ts +0 -3330
- package/src/web-editor/server.ts +0 -294
- package/src/web-editor/types.ts +0 -98
- 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";
|
package/src/web-editor/index.ts
DELETED