@oh-my-pi/pi-coding-agent 17.2.5 → 17.2.7

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 (201) hide show
  1. package/CHANGELOG.md +35 -1
  2. package/dist/{CHANGELOG-q2w43aw3.md → CHANGELOG-1p8yvde7.md} +35 -1
  3. package/dist/cli.js +3340 -3339
  4. package/dist/types/advisor/advise-tool.d.ts +10 -4
  5. package/dist/types/autoresearch/tools/init-experiment.d.ts +19 -7
  6. package/dist/types/autoresearch/tools/log-experiment.d.ts +19 -11
  7. package/dist/types/autoresearch/tools/run-experiment.d.ts +4 -2
  8. package/dist/types/autoresearch/tools/update-notes.d.ts +5 -2
  9. package/dist/types/cli/gc-cli.d.ts +1 -0
  10. package/dist/types/commit/agentic/tools/analyze-file.d.ts +5 -2
  11. package/dist/types/commit/agentic/tools/git-file-diff.d.ts +5 -2
  12. package/dist/types/commit/agentic/tools/git-hunk.d.ts +6 -2
  13. package/dist/types/commit/agentic/tools/git-overview.d.ts +5 -2
  14. package/dist/types/commit/agentic/tools/propose-changelog.d.ts +29 -7
  15. package/dist/types/commit/agentic/tools/propose-commit.d.ts +14 -4
  16. package/dist/types/commit/agentic/tools/recent-commits.d.ts +4 -2
  17. package/dist/types/commit/agentic/tools/schemas.d.ts +7 -3
  18. package/dist/types/commit/agentic/tools/split-commit.d.ts +37 -10
  19. package/dist/types/commit/changelog/generate.d.ts +13 -3
  20. package/dist/types/commit/shared-llm.d.ts +13 -4
  21. package/dist/types/config/config-file.d.ts +1 -1
  22. package/dist/types/config/models-config-schema-bundle.d.ts +1992 -981
  23. package/dist/types/config/models-config-schema.d.ts +1201 -580
  24. package/dist/types/config/models-config.d.ts +355 -371
  25. package/dist/types/edit/hashline/params.d.ts +4 -2
  26. package/dist/types/edit/modes/apply-patch.d.ts +4 -2
  27. package/dist/types/edit/modes/patch.d.ts +16 -5
  28. package/dist/types/edit/modes/replace.d.ts +8 -3
  29. package/dist/types/eval/bridge-timeout.d.ts +5 -2
  30. package/dist/types/eval/completion-bridge.d.ts +13 -0
  31. package/dist/types/eval/py/tool-bridge.d.ts +12 -0
  32. package/dist/types/extensibility/custom-commands/types.d.ts +4 -4
  33. package/dist/types/extensibility/custom-tools/types.d.ts +4 -4
  34. package/dist/types/extensibility/extensions/types.d.ts +4 -4
  35. package/dist/types/extensibility/hooks/types.d.ts +4 -4
  36. package/dist/types/extensibility/legacy-pi-ai-shim.d.ts +1 -1
  37. package/dist/types/extensibility/legacy-pi-coding-agent-shim.d.ts +1 -1
  38. package/dist/types/extensibility/legacy-typebox.d.ts +8 -0
  39. package/dist/types/extensibility/plugins/legacy-pi-compat.d.ts +6 -13
  40. package/dist/types/goals/tools/goal-tool.d.ts +12 -4
  41. package/dist/types/launch/client.d.ts +9 -1
  42. package/dist/types/launch/protocol.d.ts +17 -0
  43. package/dist/types/lsp/index.d.ts +15 -5
  44. package/dist/types/lsp/types.d.ts +15 -5
  45. package/dist/types/modes/components/btw-panel.d.ts +3 -0
  46. package/dist/types/modes/controllers/btw-controller.d.ts +2 -0
  47. package/dist/types/modes/controllers/command-controller.d.ts +1 -0
  48. package/dist/types/modes/interactive-mode.d.ts +4 -1
  49. package/dist/types/modes/types.d.ts +3 -1
  50. package/dist/types/security/contracts/schemas.d.ts +1115 -537
  51. package/dist/types/security/publication.d.ts +92 -34
  52. package/dist/types/session/agent-session-types.d.ts +5 -0
  53. package/dist/types/session/agent-session.d.ts +26 -2
  54. package/dist/types/session/launch-completion.d.ts +10 -0
  55. package/dist/types/session/session-entries.d.ts +15 -1
  56. package/dist/types/session/session-manager.d.ts +7 -0
  57. package/dist/types/session/yield-queue.d.ts +6 -1
  58. package/dist/types/task/types.d.ts +63 -18
  59. package/dist/types/tools/ask.d.ts +34 -8
  60. package/dist/types/tools/ast-edit.d.ts +16 -4
  61. package/dist/types/tools/ast-grep.d.ts +12 -4
  62. package/dist/types/tools/bash.d.ts +20 -11
  63. package/dist/types/tools/browser.d.ts +64 -20
  64. package/dist/types/tools/checkpoint.d.ts +16 -8
  65. package/dist/types/tools/computer.d.ts +1 -1
  66. package/dist/types/tools/debug.d.ts +118 -48
  67. package/dist/types/tools/eval.d.ts +11 -5
  68. package/dist/types/tools/gh.d.ts +74 -26
  69. package/dist/types/tools/glob.d.ts +16 -6
  70. package/dist/types/tools/grep.d.ts +18 -6
  71. package/dist/types/tools/hub/index.d.ts +116 -46
  72. package/dist/types/tools/image-gen.d.ts +25 -8
  73. package/dist/types/tools/index.d.ts +9 -0
  74. package/dist/types/tools/inspect-image.d.ts +10 -4
  75. package/dist/types/tools/learn.d.ts +26 -8
  76. package/dist/types/tools/manage-skill.d.ts +16 -6
  77. package/dist/types/tools/memory-edit.d.ts +18 -6
  78. package/dist/types/tools/memory-recall.d.ts +8 -4
  79. package/dist/types/tools/memory-reflect.d.ts +10 -4
  80. package/dist/types/tools/memory-retain.d.ts +14 -4
  81. package/dist/types/tools/read.d.ts +8 -4
  82. package/dist/types/tools/security-scan.d.ts +82 -30
  83. package/dist/types/tools/todo.d.ts +30 -10
  84. package/dist/types/tools/tts.d.ts +12 -5
  85. package/dist/types/tools/vibe.d.ts +42 -18
  86. package/dist/types/tools/write.d.ts +10 -4
  87. package/dist/types/web/search/index.d.ts +20 -6
  88. package/package.json +13 -13
  89. package/scripts/legacy-pi-virtual-module.ts +2 -2
  90. package/src/advisor/advise-tool.ts +1 -1
  91. package/src/advisor/config.ts +1 -1
  92. package/src/autoresearch/tools/init-experiment.ts +1 -2
  93. package/src/autoresearch/tools/log-experiment.ts +1 -2
  94. package/src/autoresearch/tools/run-experiment.ts +1 -1
  95. package/src/autoresearch/tools/update-notes.ts +1 -1
  96. package/src/cli/gc-cli.ts +641 -21
  97. package/src/commit/agentic/tools/analyze-file.ts +1 -1
  98. package/src/commit/agentic/tools/git-file-diff.ts +1 -1
  99. package/src/commit/agentic/tools/git-hunk.ts +1 -1
  100. package/src/commit/agentic/tools/git-overview.ts +1 -1
  101. package/src/commit/agentic/tools/propose-changelog.ts +1 -1
  102. package/src/commit/agentic/tools/propose-commit.ts +1 -1
  103. package/src/commit/agentic/tools/recent-commits.ts +1 -1
  104. package/src/commit/agentic/tools/schemas.ts +1 -1
  105. package/src/commit/agentic/tools/split-commit.ts +1 -1
  106. package/src/commit/analysis/summary.ts +1 -1
  107. package/src/commit/changelog/generate.ts +1 -1
  108. package/src/config/config-file.ts +2 -2
  109. package/src/config/model-discovery.ts +14 -14
  110. package/src/config/model-registry.ts +10 -8
  111. package/src/config/models-config-schema-bundle.ts +1 -8
  112. package/src/config/settings.ts +1 -1
  113. package/src/discovery/codex.ts +22 -9
  114. package/src/edit/hashline/params.ts +1 -1
  115. package/src/edit/modes/apply-patch.ts +1 -1
  116. package/src/edit/modes/patch.ts +1 -1
  117. package/src/edit/modes/replace.ts +2 -1
  118. package/src/eval/agent-bridge.ts +4 -2
  119. package/src/eval/bridge-timeout.ts +5 -2
  120. package/src/eval/completion-bridge.ts +3 -2
  121. package/src/eval/executor-base.ts +20 -1
  122. package/src/eval/js/context-manager.ts +94 -6
  123. package/src/eval/py/tool-bridge.ts +29 -9
  124. package/src/export/html/index.ts +10 -3
  125. package/src/export/share.ts +4 -0
  126. package/src/extensibility/custom-commands/loader.ts +3 -3
  127. package/src/extensibility/custom-commands/types.ts +4 -4
  128. package/src/extensibility/custom-tools/loader.ts +3 -3
  129. package/src/extensibility/custom-tools/types.ts +5 -4
  130. package/src/extensibility/extensions/loader.ts +3 -3
  131. package/src/extensibility/extensions/types.ts +5 -4
  132. package/src/extensibility/hooks/loader.ts +3 -3
  133. package/src/extensibility/hooks/types.ts +4 -4
  134. package/src/extensibility/legacy-pi-ai-shim.ts +1 -1
  135. package/src/extensibility/legacy-pi-coding-agent-shim.ts +2 -2
  136. package/src/extensibility/legacy-typebox.ts +101 -0
  137. package/src/extensibility/plugins/legacy-pi-compat.ts +13 -22
  138. package/src/goals/tools/goal-tool.ts +1 -1
  139. package/src/launch/broker.ts +222 -6
  140. package/src/launch/client.ts +161 -9
  141. package/src/launch/protocol.ts +52 -0
  142. package/src/lsp/types.ts +1 -1
  143. package/src/main.ts +13 -6
  144. package/src/mcp/config-writer.ts +1 -1
  145. package/src/modes/components/btw-panel.ts +41 -4
  146. package/src/modes/controllers/btw-controller.ts +55 -7
  147. package/src/modes/controllers/command-controller.ts +31 -0
  148. package/src/modes/controllers/input-controller.ts +24 -7
  149. package/src/modes/interactive-mode.ts +16 -2
  150. package/src/modes/theme/theme.ts +3 -3
  151. package/src/modes/types.ts +8 -1
  152. package/src/prompts/session/launch-completion.md +1 -0
  153. package/src/sdk.ts +15 -0
  154. package/src/security/contracts/schemas.ts +202 -184
  155. package/src/security/contracts/validation.ts +6 -2
  156. package/src/security/publication.ts +1 -1
  157. package/src/security/store.ts +2 -2
  158. package/src/session/agent-session-types.ts +6 -0
  159. package/src/session/agent-session.ts +190 -14
  160. package/src/session/launch-completion.ts +37 -0
  161. package/src/session/session-context.ts +26 -0
  162. package/src/session/session-entries.ts +17 -1
  163. package/src/session/session-manager.ts +21 -0
  164. package/src/session/yield-queue.ts +121 -16
  165. package/src/slash-commands/builtin-registry.ts +10 -1
  166. package/src/task/types.ts +1 -1
  167. package/src/tools/ask.ts +1 -1
  168. package/src/tools/ast-edit.ts +1 -1
  169. package/src/tools/ast-grep.ts +1 -1
  170. package/src/tools/bash.ts +61 -3
  171. package/src/tools/browser/cmux/cmux-tab.ts +92 -4
  172. package/src/tools/browser.ts +1 -1
  173. package/src/tools/checkpoint.ts +1 -1
  174. package/src/tools/computer.ts +1 -1
  175. package/src/tools/debug.ts +1 -1
  176. package/src/tools/eval.ts +1 -1
  177. package/src/tools/gh.ts +1 -2
  178. package/src/tools/glob.ts +1 -1
  179. package/src/tools/grep.ts +1 -1
  180. package/src/tools/hub/index.ts +1 -1
  181. package/src/tools/hub/launch.ts +122 -6
  182. package/src/tools/image-gen.ts +1 -1
  183. package/src/tools/index.ts +9 -0
  184. package/src/tools/inspect-image.ts +1 -1
  185. package/src/tools/learn.ts +1 -1
  186. package/src/tools/manage-skill.ts +1 -1
  187. package/src/tools/memory-edit.ts +1 -1
  188. package/src/tools/memory-recall.ts +1 -1
  189. package/src/tools/memory-reflect.ts +1 -1
  190. package/src/tools/memory-retain.ts +1 -1
  191. package/src/tools/read.ts +1 -1
  192. package/src/tools/security-scan.ts +1 -1
  193. package/src/tools/todo.ts +1 -1
  194. package/src/tools/tts.ts +1 -1
  195. package/src/tools/vibe.ts +2 -1
  196. package/src/tools/write.ts +1 -1
  197. package/src/web/search/index.ts +2 -1
  198. package/dist/types/config/file-lock.d.ts +0 -29
  199. package/dist/types/extensibility/typebox.d.ts +0 -181
  200. package/src/config/file-lock.ts +0 -164
  201. package/src/extensibility/typebox.ts +0 -958
@@ -1,65 +1,123 @@
1
1
  import type { ToolDefinition } from "../extensibility/extensions/index.js";
2
2
  import type { SecurityScanBundle, SecurityScanPlan } from "./contracts/index.js";
3
3
  import { type SecurityStore } from "./store.js";
4
- export declare const securityPublishSchema: import("arktype/internal/variants/object.ts").ObjectType<{
4
+ export declare const securityPublishSchema: import("@oh-my-pi/omptype").FluentType<{
5
+ coverage: {
6
+ completeness: "complete" | "partial" | "unknown";
7
+ deferred?: {
8
+ paths?: string[] | undefined;
9
+ reason: string;
10
+ surface_ids?: string[] | undefined;
11
+ }[] | undefined;
12
+ explicit_exclusions?: {
13
+ pattern: string;
14
+ reason: string;
15
+ }[] | undefined;
16
+ open_questions?: {
17
+ follow_up_prompt?: string | undefined;
18
+ question: string;
19
+ }[] | undefined;
20
+ surfaces?: {
21
+ disposition: "needs_follow_up" | "no_issue_found" | "not_applicable" | "rejected" | "reported";
22
+ label: string;
23
+ notes?: string | undefined;
24
+ receipt_refs?: string[] | undefined;
25
+ risk_area?: string | undefined;
26
+ }[] | undefined;
27
+ };
5
28
  findings: {
6
- rule_id: string;
7
- title: string;
8
- summary: string;
9
- severity: "critical" | "high" | "informational" | "low" | "medium";
10
- confidence: "high" | "low" | "medium";
11
- category: string;
12
29
  anchor?: string | undefined;
30
+ category: string;
31
+ confidence: "high" | "low" | "medium";
13
32
  cwe?: string[] | undefined;
14
- locations: {
15
- path: string;
16
- start_line: number;
17
- end_line?: number | undefined;
18
- start_column?: number | undefined;
19
- end_column?: number | undefined;
20
- role?: string | undefined;
21
- }[];
22
33
  evidence?: {
23
- label: string;
24
- explanation: string;
25
34
  excerpt?: string | undefined;
35
+ explanation: string;
36
+ label: string;
26
37
  location?: {
27
- path: string;
28
- start_line: number;
29
- end_line?: number | undefined;
30
- start_column?: number | undefined;
31
38
  end_column?: number | undefined;
39
+ end_line?: number | undefined;
40
+ path: string;
32
41
  role?: string | undefined;
42
+ start_column?: number | undefined;
43
+ start_line: number;
33
44
  } | undefined;
34
45
  }[] | undefined;
46
+ locations: {
47
+ end_column?: number | undefined;
48
+ end_line?: number | undefined;
49
+ path: string;
50
+ role?: string | undefined;
51
+ start_column?: number | undefined;
52
+ start_line: number;
53
+ }[];
35
54
  remediation?: string | undefined;
55
+ rule_id: string;
56
+ severity: "critical" | "high" | "informational" | "low" | "medium";
57
+ summary: string;
58
+ title: string;
36
59
  validation?: "partial" | "unvalidated" | "validated" | undefined;
37
60
  }[];
61
+ report: string;
62
+ }, {
38
63
  coverage: {
39
64
  completeness: "complete" | "partial" | "unknown";
40
- surfaces?: {
41
- label: string;
42
- disposition: "needs_follow_up" | "no_issue_found" | "not_applicable" | "rejected" | "reported";
43
- risk_area?: string | undefined;
44
- notes?: string | undefined;
45
- receipt_refs?: string[] | undefined;
65
+ deferred?: {
66
+ paths?: string[] | undefined;
67
+ reason: string;
68
+ surface_ids?: string[] | undefined;
46
69
  }[] | undefined;
47
70
  explicit_exclusions?: {
48
71
  pattern: string;
49
72
  reason: string;
50
73
  }[] | undefined;
51
- deferred?: {
52
- reason: string;
53
- paths?: string[] | undefined;
54
- surface_ids?: string[] | undefined;
55
- }[] | undefined;
56
74
  open_questions?: {
57
- question: string;
58
75
  follow_up_prompt?: string | undefined;
76
+ question: string;
77
+ }[] | undefined;
78
+ surfaces?: {
79
+ disposition: "needs_follow_up" | "no_issue_found" | "not_applicable" | "rejected" | "reported";
80
+ label: string;
81
+ notes?: string | undefined;
82
+ receipt_refs?: string[] | undefined;
83
+ risk_area?: string | undefined;
59
84
  }[] | undefined;
60
85
  };
86
+ findings: {
87
+ anchor?: string | undefined;
88
+ category: string;
89
+ confidence: "high" | "low" | "medium";
90
+ cwe?: string[] | undefined;
91
+ evidence?: {
92
+ excerpt?: string | undefined;
93
+ explanation: string;
94
+ label: string;
95
+ location?: {
96
+ end_column?: number | undefined;
97
+ end_line?: number | undefined;
98
+ path: string;
99
+ role?: string | undefined;
100
+ start_column?: number | undefined;
101
+ start_line: number;
102
+ } | undefined;
103
+ }[] | undefined;
104
+ locations: {
105
+ end_column?: number | undefined;
106
+ end_line?: number | undefined;
107
+ path: string;
108
+ role?: string | undefined;
109
+ start_column?: number | undefined;
110
+ start_line: number;
111
+ }[];
112
+ remediation?: string | undefined;
113
+ rule_id: string;
114
+ severity: "critical" | "high" | "informational" | "low" | "medium";
115
+ summary: string;
116
+ title: string;
117
+ validation?: "partial" | "unvalidated" | "validated" | undefined;
118
+ }[];
61
119
  report: string;
62
- }, {}>;
120
+ }>;
63
121
  export type SecurityPublishParams = typeof securityPublishSchema.infer;
64
122
  export interface SecurityPublishDetails {
65
123
  scanId: string;
@@ -357,6 +357,11 @@ export interface FreshSessionResult {
357
357
  sessionId: string;
358
358
  closedProviderSessions: number;
359
359
  }
360
+ /** Outcome of an in-place `/clear` conversation-context reset. */
361
+ export interface ResetSessionContextResult {
362
+ /** Number of live messages dropped from the model's context. */
363
+ droppedCount: number;
364
+ }
360
365
  /** Queued user content restored to the editor. */
361
366
  export type RestoredQueuedMessage = {
362
367
  text: string;
@@ -37,6 +37,7 @@ import { GoalRuntime } from "../goals/runtime.js";
37
37
  import type { GoalModeState } from "../goals/state.js";
38
38
  import type { HindsightSessionState } from "../hindsight/state.js";
39
39
  import type { IrcMessage } from "../irc/bus.js";
40
+ import type { DaemonCompletionNotification } from "../launch/protocol.js";
40
41
  import { type MnemopiSessionState } from "../mnemopi/state.js";
41
42
  import { type PlanApprovalDetails } from "../plan-mode/approved-plan.js";
42
43
  import type { PlanModeState } from "../plan-mode/state.js";
@@ -49,7 +50,7 @@ import type { TodoPhase } from "../tools/todo.js";
49
50
  import type { InspectImageMode } from "../utils/inspect-image-mode.js";
50
51
  import type { VibeModeState } from "../vibe/state.js";
51
52
  import type { AgentSessionEventListener } from "./agent-session-events.js";
52
- import type { AgentSessionConfig, AgentSessionDisposeOptions, AsyncJobSnapshot, CommandMetadataChangedListener, ContextUsageBreakdown, FollowUpOptions, FreshSessionResult, HandoffResult, ModelCycleResult, Prewalk, PromptOptions, ResolvedRoleModel, RestoredQueuedMessage, RoleModelCycle, RoleModelCycleResult, SessionHandoffOptions, SessionOAuthAccountList, SessionStats, UsageFallbackConfirmation } from "./agent-session-types.js";
53
+ import type { AgentSessionConfig, AgentSessionDisposeOptions, AsyncJobSnapshot, CommandMetadataChangedListener, ContextUsageBreakdown, FollowUpOptions, FreshSessionResult, HandoffResult, ModelCycleResult, Prewalk, PromptOptions, ResetSessionContextResult, ResolvedRoleModel, RestoredQueuedMessage, RoleModelCycle, RoleModelCycleResult, SessionHandoffOptions, SessionOAuthAccountList, SessionStats, UsageFallbackConfirmation } from "./agent-session-types.js";
53
54
  import type { ClientBridge } from "./client-bridge.js";
54
55
  import { type CustomMessage, type CustomMessagePayload } from "./messages.js";
55
56
  import { type AdvisorStats } from "./session-advisors.js";
@@ -180,6 +181,8 @@ export declare class AgentSession {
180
181
  * Multiple listeners can be added. Returns unsubscribe function for this listener.
181
182
  */
182
183
  subscribe(listener: AgentSessionEventListener): () => void;
184
+ /** Register cleanup that runs when this AgentSession adopts a different session ID. */
185
+ registerSessionChangeCallback(callback: () => void): () => void;
183
186
  subscribeCommandMetadataChanged(listener: CommandMetadataChangedListener): () => void;
184
187
  /** Run one abortable auto-learn capture outside the primary agent loop. */
185
188
  runAutolearnCapture(capture: (signal: AbortSignal) => Promise<void>): Promise<void>;
@@ -199,6 +202,25 @@ export declare class AgentSession {
199
202
  beginDispose(): void;
200
203
  dispose(options?: AgentSessionDisposeOptions): Promise<void>;
201
204
  freshSession(): FreshSessionResult | undefined;
205
+ /**
206
+ * Reset the current conversation in place: drop every message, queued turn,
207
+ * and pending tool call from the model's context while keeping the session
208
+ * itself — its id, title, cwd, model, settings, and on-disk transcript all
209
+ * survive. The next turn is sent with only the base system prompt plus the
210
+ * project rules/AGENTS.md.
211
+ *
212
+ * This is the in-place sibling of {@link newSession}: it reuses the same
213
+ * conversation-boundary teardown (drop the conversation, rotate provider-side
214
+ * session state so providers that keep history server-side resume nothing,
215
+ * re-prime the advisors, and undo any memory promotion) but skips minting a
216
+ * new session id and opening a fresh transcript file. Unlike
217
+ * {@link freshSession} (which only rotates provider stream state) it also
218
+ * clears the conversation.
219
+ *
220
+ * Returns `undefined` without mutating anything while a response is
221
+ * streaming or a foreground bash/python execution is in flight.
222
+ */
223
+ resetSessionContext(): Promise<ResetSessionContextResult | undefined>;
202
224
  /** Full agent state */
203
225
  get state(): AgentState;
204
226
  /** Current model (may be undefined if not yet selected) */
@@ -476,6 +498,7 @@ export declare class AgentSession {
476
498
  */
477
499
  followUp(text: string, images?: ImageContent[], options?: FollowUpOptions): Promise<void>;
478
500
  queueDeferredMessage(message: CustomMessage): void;
501
+ queueLaunchCompletion(notification: DaemonCompletionNotification): Promise<void>;
479
502
  /**
480
503
  * Send a custom message to the session. Creates a CustomMessageEntry.
481
504
  *
@@ -805,7 +828,8 @@ export declare class AgentSession {
805
828
  selectedImages: ImageContent[];
806
829
  cancelled: boolean;
807
830
  }>;
808
- branchFromBtw(question: string, assistantMessage: AssistantMessage): Promise<{
831
+ /** Promotes a completed /btw answer from the explicitly authorized session and leaf. */
832
+ branchFromBtw(question: string, assistantMessage: AssistantMessage, leafId: string, sessionId: string): Promise<{
809
833
  cancelled: boolean;
810
834
  sessionFile: string | undefined;
811
835
  }>;
@@ -0,0 +1,10 @@
1
+ import type { DaemonCompletionNotification } from "../launch/protocol.js";
2
+ import type { CustomMessage } from "./messages.js";
3
+ /** Yield-queue kind for broker-owned supervised process completions. */
4
+ export declare const LAUNCH_COMPLETION_MESSAGE_TYPE = "launch-completion";
5
+ /** One broker completion awaiting injection into its owning session. */
6
+ export type LaunchCompletionEntry = DaemonCompletionNotification;
7
+ /** Whether a broker completion belongs to the primary session or its advisor. */
8
+ export declare function isLaunchCompletionOwner(owner: string, sessionId: string): boolean;
9
+ /** Build one model-visible notification per terminal supervised process exit. */
10
+ export declare function buildLaunchCompletionBatchMessage(entries: LaunchCompletionEntry[]): CustomMessage;
@@ -31,6 +31,8 @@ export interface SessionHeader {
31
31
  */
32
32
  additionalDirectories?: string[];
33
33
  parentSession?: string;
34
+ /** Prior absolute JSONL locations recorded by successful session moves. */
35
+ previousSessionFiles?: string[];
34
36
  /** Provider prompt-cache identity inherited by exact-route full forks. */
35
37
  providerPromptCacheKey?: string;
36
38
  }
@@ -102,6 +104,17 @@ export interface BranchSummaryEntry<T = unknown> extends SessionEntryBase {
102
104
  /** True if generated by an extension, false if pi-generated */
103
105
  fromExtension?: boolean;
104
106
  }
107
+ /**
108
+ * Pure marker entry recorded by `/clear` (resetSessionContext). It carries no
109
+ * payload — its presence on the branch is a durable boundary the collapsed
110
+ * live transcript and the model-context rebuild start emission after, so a
111
+ * rebuild (theme change, focus attach, /shake, resume) does not resurrect the
112
+ * pre-reset conversation. The on-disk record and the plain `transcript:true`
113
+ * export path keep the full pre-reset history.
114
+ */
115
+ export interface ResetBoundaryEntry extends SessionEntryBase {
116
+ type: "reset_boundary";
117
+ }
105
118
  /**
106
119
  * Custom entry for extensions to store extension-specific data in the session.
107
120
  * Use customType to identify your extension's entries.
@@ -135,6 +148,7 @@ declare module "@oh-my-pi/pi-agent-core/compaction/entries" {
135
148
  interface CustomCompactionSessionEntries {
136
149
  titleChange: TitleChangeEntry;
137
150
  credentialPin: CredentialPinEntry;
151
+ resetBoundary: ResetBoundaryEntry;
138
152
  }
139
153
  }
140
154
  /** TTSR injection entry - tracks which time-traveling rules have been injected this session. */
@@ -210,7 +224,7 @@ export interface CustomMessageEntry<T = unknown> extends SessionEntryBase {
210
224
  attribution?: MessageAttribution;
211
225
  }
212
226
  /** Session entry - has id/parentId for tree structure (returned by "read" methods in SessionManager) */
213
- export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TitleChangeEntry | TtsrInjectionEntry | SessionInitEntry | ModeChangeEntry | CredentialPinEntry;
227
+ export type SessionEntry = SessionMessageEntry | ThinkingLevelChangeEntry | ModelChangeEntry | ServiceTierChangeEntry | CompactionEntry | BranchSummaryEntry | CustomEntry | CustomMessageEntry | LabelEntry | TitleChangeEntry | TtsrInjectionEntry | SessionInitEntry | ModeChangeEntry | CredentialPinEntry | ResetBoundaryEntry;
214
228
  /** Raw logical file entry after loaders strip any fixed-width title slot. */
215
229
  export type FileEntry = SessionHeader | SessionEntry;
216
230
  /** Physical JSONL entry before slot-aware loaders fold the title slot. */
@@ -233,6 +233,13 @@ export declare class SessionManager {
233
233
  readSummarize?: boolean;
234
234
  }): string;
235
235
  appendCompaction<T = unknown>(summary: string, shortSummary: string | undefined, firstKeptEntryId: string, tokensBefore: number, details?: T, fromExtension?: boolean, preserveData?: Record<string, unknown>): string;
236
+ /**
237
+ * Append the durable conversation boundary recorded by `/clear`. The
238
+ * collapsed live transcript and the model-context rebuild start after the
239
+ * latest one, while the full history stays on disk (the plain
240
+ * `transcript:true` export walks it unchanged).
241
+ */
242
+ appendResetBoundary(): string;
236
243
  appendCustomEntry(customType: string, data?: unknown): string;
237
244
  /**
238
245
  * Rewrite the session file after in-place entry updates (e.g. pruning old tool
@@ -1,4 +1,4 @@
1
- import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
1
+ import { type AgentMessage } from "@oh-my-pi/pi-agent-core";
2
2
  export interface YieldDispatcher<P> {
3
3
  /** Drop entries already delivered through another path. Called per-entry at flush time. */
4
4
  isStale?(entry: P): boolean;
@@ -19,7 +19,10 @@ export declare class YieldQueue {
19
19
  constructor(options: YieldQueueOptions);
20
20
  register<P>(kind: string, dispatcher: YieldDispatcher<P>): () => void;
21
21
  enqueue<P>(kind: string, entry: P): void;
22
+ enqueueWithReceipt<P>(kind: string, entry: P): Promise<void>;
22
23
  has(kind?: string): boolean;
24
+ /** Arrange an idle flush for entries queued near the end of a streaming run. */
25
+ requestIdleFlush(): void;
23
26
  flush(mode: YieldFlushMode): Promise<void>;
24
27
  /**
25
28
  * Snapshot and remove all queued entries, returning one lazy thunk per kind.
@@ -33,5 +36,7 @@ export declare class YieldQueue {
33
36
  /** Drop queued entries. With `kind`, drop only that kind's entries (leaving
34
37
  * any pending idle-flush for other kinds intact); otherwise drop everything. */
35
38
  clear(kind?: string): void;
39
+ /** Clear a scheduled-flush latch when its host task is cancelled before running. */
40
+ cancelIdleFlushScheduling(): void;
36
41
  }
37
42
  export {};
@@ -1,5 +1,5 @@
1
+ import { type BaseType } from "@oh-my-pi/omptype";
1
2
  import type { Usage } from "@oh-my-pi/pi-ai";
2
- import { type BaseType } from "arktype";
3
3
  import type { AgentSessionEvent } from "../session/agent-session.js";
4
4
  import type { ConfiguredThinkingLevel, TaskEffort } from "../thinking.js";
5
5
  import type { NestedRepoPatch } from "./worktree.js";
@@ -79,13 +79,19 @@ export interface SubagentLifecyclePayload {
79
79
  }
80
80
  /** Display cap for a normalized one-line label (roster line, registry `displayName`, prompt field). */
81
81
  export declare const LABEL_MAX = 80;
82
- export declare const taskItemSchema: import("arktype/internal/variants/object.ts").ObjectType<{
82
+ export declare const taskItemSchema: import("@oh-my-pi/omptype").FluentType<{
83
+ agent: string;
83
84
  name?: string | undefined;
84
- agent: import("arktype/internal/attributes.ts").Default<string, "task">;
85
+ outputSchema?: string | boolean | object | null | undefined;
86
+ schemaMode?: "permissive" | "strict" | undefined;
85
87
  task: string;
88
+ }, {
89
+ agent?: string | undefined;
90
+ name?: string | undefined;
86
91
  outputSchema?: string | boolean | object | null | undefined;
87
92
  schemaMode?: "permissive" | "strict" | undefined;
88
- }, {}>;
93
+ task: string;
94
+ }>;
89
95
  /** Single task item. Fields are optional defensively: args stream in token by token. */
90
96
  export interface TaskItem {
91
97
  /** Stable agent name; becomes the registry/IRC id. Default = generated AdjectiveNoun. */
@@ -103,47 +109,86 @@ export interface TaskItem {
103
109
  /** Run this spawn in an isolated worktree (batch form; flat form carries it top-level). */
104
110
  isolated?: boolean;
105
111
  }
106
- export declare const taskSchema: import("arktype/internal/variants/object.ts").ObjectType<{
112
+ export declare const taskSchema: import("@oh-my-pi/omptype").FluentType<{
113
+ agent: string;
114
+ isolated?: boolean | undefined;
107
115
  name?: string | undefined;
108
- agent: import("arktype/internal/attributes.ts").Default<string, "task">;
109
- task: string;
110
116
  outputSchema?: string | boolean | object | null | undefined;
111
117
  schemaMode?: "permissive" | "strict" | undefined;
118
+ task: string;
119
+ }, {
120
+ agent?: string | undefined;
112
121
  isolated?: boolean | undefined;
113
- }, {}>;
114
- declare const ALL_TASK_SCHEMAS: readonly [import("arktype/internal/variants/object.ts").ObjectType<{
115
122
  name?: string | undefined;
116
- agent: import("arktype/internal/attributes.ts").Default<string, "task">;
123
+ outputSchema?: string | boolean | object | null | undefined;
124
+ schemaMode?: "permissive" | "strict" | undefined;
117
125
  task: string;
126
+ }>;
127
+ declare const ALL_TASK_SCHEMAS: readonly [import("@oh-my-pi/omptype").FluentType<{
128
+ agent: string;
129
+ isolated?: boolean | undefined;
130
+ name?: string | undefined;
118
131
  outputSchema?: string | boolean | object | null | undefined;
119
132
  schemaMode?: "permissive" | "strict" | undefined;
133
+ task: string;
134
+ }, {
135
+ agent?: string | undefined;
120
136
  isolated?: boolean | undefined;
121
- }, {}>, import("arktype/internal/variants/object.ts").ObjectType<{
122
137
  name?: string | undefined;
123
- agent: import("arktype/internal/attributes.ts").Default<string, "task">;
138
+ outputSchema?: string | boolean | object | null | undefined;
139
+ schemaMode?: "permissive" | "strict" | undefined;
124
140
  task: string;
141
+ }>, import("@oh-my-pi/omptype").FluentType<{
142
+ agent: string;
143
+ name?: string | undefined;
125
144
  outputSchema?: string | boolean | object | null | undefined;
126
145
  schemaMode?: "permissive" | "strict" | undefined;
127
- }, {}>, import("arktype/internal/variants/object.ts").ObjectType<{
146
+ task: string;
147
+ }, {
148
+ agent?: string | undefined;
149
+ name?: string | undefined;
150
+ outputSchema?: string | boolean | object | null | undefined;
151
+ schemaMode?: "permissive" | "strict" | undefined;
152
+ task: string;
153
+ }>, import("@oh-my-pi/omptype").FluentType<{
128
154
  context: string;
129
155
  tasks: {
156
+ agent: string;
157
+ isolated?: boolean | undefined;
130
158
  name?: string | undefined;
131
- agent: import("arktype/internal/attributes.ts").Default<string, "task">;
132
- task: string;
133
159
  outputSchema?: string | boolean | object | null | undefined;
134
160
  schemaMode?: "permissive" | "strict" | undefined;
161
+ task: string;
162
+ }[];
163
+ }, {
164
+ context: string;
165
+ tasks: {
166
+ agent?: string | undefined;
135
167
  isolated?: boolean | undefined;
168
+ name?: string | undefined;
169
+ outputSchema?: string | boolean | object | null | undefined;
170
+ schemaMode?: "permissive" | "strict" | undefined;
171
+ task: string;
136
172
  }[];
137
- }, {}>, import("arktype/internal/variants/object.ts").ObjectType<{
173
+ }>, import("@oh-my-pi/omptype").FluentType<{
138
174
  context: string;
139
175
  tasks: {
176
+ agent: string;
140
177
  name?: string | undefined;
141
- agent: import("arktype/internal/attributes.ts").Default<string, "task">;
178
+ outputSchema?: string | boolean | object | null | undefined;
179
+ schemaMode?: "permissive" | "strict" | undefined;
142
180
  task: string;
181
+ }[];
182
+ }, {
183
+ context: string;
184
+ tasks: {
185
+ agent?: string | undefined;
186
+ name?: string | undefined;
143
187
  outputSchema?: string | boolean | object | null | undefined;
144
188
  schemaMode?: "permissive" | "strict" | undefined;
189
+ task: string;
145
190
  }[];
146
- }, {}>];
191
+ }>];
147
192
  type DynamicTaskSchema = (typeof ALL_TASK_SCHEMAS)[number];
148
193
  export type TaskSchema = typeof taskSchema;
149
194
  /** Active task tool parameter schema for the current isolation / batch flags */
@@ -20,20 +20,33 @@ import { type Component } from "@oh-my-pi/pi-tui";
20
20
  import type { RenderResultOptions } from "../extensibility/custom-tools/types.js";
21
21
  import { type Theme } from "../modes/theme/theme.js";
22
22
  import type { ToolSession } from "./index.js";
23
- declare const askSchema: import("arktype/internal/variants/object.ts").ObjectType<{
23
+ declare const askSchema: import("@oh-my-pi/omptype").FluentType<{
24
24
  questions: {
25
+ header?: string | undefined;
25
26
  id: string;
27
+ multi?: boolean | undefined;
28
+ options: {
29
+ description?: string | undefined;
30
+ label: string;
31
+ preview?: string | undefined;
32
+ }[];
26
33
  question: string;
34
+ recommended?: number | undefined;
35
+ }[];
36
+ }, {
37
+ questions: {
27
38
  header?: string | undefined;
39
+ id: string;
40
+ multi?: boolean | undefined;
28
41
  options: {
29
- label: string;
30
42
  description?: string | undefined;
43
+ label: string;
31
44
  preview?: string | undefined;
32
45
  }[];
33
- multi?: boolean | undefined;
46
+ question: string;
34
47
  recommended?: number | undefined;
35
48
  }[];
36
- }, {}>;
49
+ }>;
37
50
  export type AskToolInput = typeof askSchema.infer;
38
51
  /**
39
52
  * Recover a validated `questions` payload from a persisted `ask` toolCall's
@@ -90,20 +103,33 @@ export declare class AskTool implements AgentTool<typeof askSchema, AskToolDetai
90
103
  readonly label = "Ask";
91
104
  readonly summary = "Ask the user a clarifying question";
92
105
  readonly description: string;
93
- readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
106
+ readonly parameters: import("@oh-my-pi/omptype").FluentType<{
94
107
  questions: {
108
+ header?: string | undefined;
95
109
  id: string;
110
+ multi?: boolean | undefined;
111
+ options: {
112
+ description?: string | undefined;
113
+ label: string;
114
+ preview?: string | undefined;
115
+ }[];
96
116
  question: string;
117
+ recommended?: number | undefined;
118
+ }[];
119
+ }, {
120
+ questions: {
97
121
  header?: string | undefined;
122
+ id: string;
123
+ multi?: boolean | undefined;
98
124
  options: {
99
- label: string;
100
125
  description?: string | undefined;
126
+ label: string;
101
127
  preview?: string | undefined;
102
128
  }[];
103
- multi?: boolean | undefined;
129
+ question: string;
104
130
  recommended?: number | undefined;
105
131
  }[];
106
- }, {}>;
132
+ }>;
107
133
  readonly strict = true;
108
134
  readonly examples: readonly ToolExample<typeof askSchema.infer>[];
109
135
  readonly concurrency = "exclusive";
@@ -5,13 +5,19 @@ import type { RenderResultOptions } from "../extensibility/custom-tools/types.js
5
5
  import type { Theme } from "../modes/theme/theme.js";
6
6
  import type { ToolSession } from "./index.js";
7
7
  import type { OutputMeta } from "./output-meta.js";
8
- declare const astEditSchema: import("arktype/internal/variants/object.ts").ObjectType<{
8
+ declare const astEditSchema: import("@oh-my-pi/omptype").FluentType<{
9
9
  ops: {
10
+ out: string;
10
11
  pat: string;
12
+ }[];
13
+ paths: string[];
14
+ }, {
15
+ ops: {
11
16
  out: string;
17
+ pat: string;
12
18
  }[];
13
19
  paths: string[];
14
- }, {}>;
20
+ }>;
15
21
  export interface AstEditToolDetails {
16
22
  totalReplacements: number;
17
23
  filesTouched: number;
@@ -47,13 +53,19 @@ export declare class AstEditTool implements AgentTool<typeof astEditSchema, AstE
47
53
  readonly label = "AST Edit";
48
54
  readonly summary = "Perform AST-aware code edits (structural refactoring)";
49
55
  readonly description: string;
50
- readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
56
+ readonly parameters: import("@oh-my-pi/omptype").FluentType<{
51
57
  ops: {
58
+ out: string;
52
59
  pat: string;
60
+ }[];
61
+ paths: string[];
62
+ }, {
63
+ ops: {
53
64
  out: string;
65
+ pat: string;
54
66
  }[];
55
67
  paths: string[];
56
- }, {}>;
68
+ }>;
57
69
  readonly strict = true;
58
70
  readonly examples: readonly ToolExample<AstEditSchemaInfer>[];
59
71
  readonly deferrable = true;
@@ -5,11 +5,15 @@ import type { RenderResultOptions } from "../extensibility/custom-tools/types.js
5
5
  import type { Theme } from "../modes/theme/theme.js";
6
6
  import type { ToolSession } from "./index.js";
7
7
  import type { OutputMeta } from "./output-meta.js";
8
- declare const astGrepSchema: import("arktype/internal/variants/object.ts").ObjectType<{
8
+ declare const astGrepSchema: import("@oh-my-pi/omptype").FluentType<{
9
9
  pat: string;
10
10
  path?: string | undefined;
11
11
  skip?: number | undefined;
12
- }, {}>;
12
+ }, {
13
+ pat: string;
14
+ path?: string | undefined;
15
+ skip?: number | undefined;
16
+ }>;
13
17
  export interface AstGrepToolDetails {
14
18
  matchCount: number;
15
19
  fileCount: number;
@@ -42,11 +46,15 @@ export declare class AstGrepTool implements AgentTool<typeof astGrepSchema, AstG
42
46
  readonly label = "AST Grep";
43
47
  readonly summary = "Search code with AST patterns (structural grep)";
44
48
  get description(): string;
45
- readonly parameters: import("arktype/internal/variants/object.ts").ObjectType<{
49
+ readonly parameters: import("@oh-my-pi/omptype").FluentType<{
46
50
  pat: string;
47
51
  path?: string | undefined;
48
52
  skip?: number | undefined;
49
- }, {}>;
53
+ }, {
54
+ pat: string;
55
+ path?: string | undefined;
56
+ skip?: number | undefined;
57
+ }>;
50
58
  readonly strict = true;
51
59
  readonly examples: readonly ToolExample<typeof astGrepSchema.inferIn>[];
52
60
  readonly loadMode = "discoverable";