apex-code 0.0.1-alpha.8 → 0.0.4

package/dist/core/extensions/types.d.ts

@@ -21,13 +21,14 @@ import type { KeybindingsManager } from "../keybindings.ts";
 import type { CustomMessage } from "../messages.ts";
 import type { ModelRegistry } from "../model-registry.ts";
 import type { ScopedModel } from "../model-resolver.ts";
+import type { PermissionPreview } from "../permissions/responder.ts";
 import type { BranchSummaryEntry, CompactionEntry, CustomEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.ts";
 import type { SlashCommandInfo } from "../slash-commands.ts";
 import type { SourceInfo } from "../source-info.ts";
 import type { BuildSystemPromptOptions } from "../system-prompt.ts";
 import type { BashOperations } from "../tools/bash.ts";
 import type { EditToolDetails } from "../tools/edit.ts";
-import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
+import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, PowerShellToolDetails, PowerShellToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
 export type { ExecOptions, ExecResult } from "../exec.ts";
 export type { BuildSystemPromptOptions } from "../system-prompt.ts";
 export type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode };
@@ -38,6 +39,8 @@ export interface ExtensionUIDialogOptions {
     signal?: AbortSignal;
     /** Timeout in milliseconds. Dialog auto-dismisses with live countdown display. */
     timeout?: number;
+    /** What the prompt is about to authorize, drawn above the choices. */
+    preview?: PermissionPreview;
 }
 /** Placement for extension widgets. */
 export type WidgetPlacement = "aboveEditor" | "belowEditor";
@@ -101,8 +104,8 @@ export interface ExtensionUIContext {
     /** Set a custom footer component, or undefined to restore the built-in footer.
      *
      * The factory receives a FooterDataProvider for data not otherwise accessible:
-     * git branch and extension statuses from setStatus(). Token stats, model info,
-     * etc. are available via ctx.sessionManager and ctx.model.
+     * git branch and extension statuses from setStatus(). Context usage is on
+     * ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
      */
     setFooter(factory: ((tui: TUI, theme: Theme, footerData: ReadonlyFooterDataProvider) => Component & {
         dispose?(): void;
@@ -450,7 +453,7 @@ export interface SessionBeforeCompactEvent {
     willRetry: boolean;
     signal: AbortSignal;
 }
-/** Fired after context compaction */
+/** Fired after context compaction succeeds */
 export interface SessionCompactEvent {
     type: "session_compact";
     compactionEntry: CompactionEntry;
@@ -460,6 +463,20 @@ export interface SessionCompactEvent {
     /** True when the aborted turn is retried after this compaction (overflow recovery) */
     willRetry: boolean;
 }
+/** Fired after context compaction fails or is aborted */
+export interface SessionCompactFailedEvent {
+    type: "session_compact_failed";
+    /** What triggered the compaction: manual /compact, the context threshold, or context overflow recovery */
+    reason: "manual" | "threshold" | "overflow";
+    /** Error text when compaction failed for a non-abort reason. */
+    errorMessage?: string;
+    /** True when compaction was cancelled or aborted. */
+    aborted: boolean;
+    /** True when the aborted turn would have been retried after this compaction (overflow recovery) */
+    willRetry: boolean;
+    /** True when the failing compaction content came from a session_before_compact handler. */
+    fromExtension: boolean;
+}
 /** Fired before an extension runtime is torn down due to quit, reload, or session replacement. */
 export interface SessionShutdownEvent {
     type: "session_shutdown";
@@ -495,7 +512,7 @@ export interface SessionTreeEvent {
     summaryEntry?: BranchSummaryEntry;
     fromExtension?: boolean;
 }
-export type SessionEvent = SessionStartEvent | SessionInfoChangedEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent;
+export type SessionEvent = SessionStartEvent | SessionInfoChangedEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionCompactFailedEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent;
 /** Fired before each LLM call. Can modify messages. */
 export interface ContextEvent {
     type: "context";
@@ -546,6 +563,21 @@ export interface AgentEndEvent {
 export interface AgentSettledEvent {
     type: "agent_settled";
 }
+export type UIPromptKind = "select" | "confirm" | "input" | "editor" | "custom";
+/** Fired when Pi starts waiting on a blocking user-facing extension UI prompt. */
+export interface UIPromptStartEvent {
+    type: "ui_prompt_start";
+    reason: "ui_prompt";
+    kind: UIPromptKind;
+    title?: string;
+}
+/** Fired when Pi is no longer waiting on a blocking user-facing extension UI prompt. */
+export interface UIPromptEndEvent {
+    type: "ui_prompt_end";
+    reason: "ui_prompt";
+    kind: UIPromptKind;
+    title?: string;
+}
 /** Fired at the start of each turn */
 export interface TurnStartEvent {
     type: "turn_start";
@@ -623,7 +655,7 @@ export interface UserBashEvent {
     cwd: string;
 }
 /** Source of user input */
-export type InputSource = "interactive" | "rpc" | "extension";
+export type InputSource = "interactive" | "rpc" | "extension" | "acp";
 /** Fired when user input is received, before agent processing */
 export interface InputEvent {
     type: "input";
@@ -654,6 +686,10 @@ export interface BashToolCallEvent extends ToolCallEventBase {
     toolName: "bash";
     input: BashToolInput;
 }
+export interface PowerShellToolCallEvent extends ToolCallEventBase {
+    toolName: "powershell";
+    input: PowerShellToolInput;
+}
 export interface ReadToolCallEvent extends ToolCallEventBase {
     toolName: "read";
     input: ReadToolInput;
@@ -688,7 +724,7 @@ export interface CustomToolCallEvent extends ToolCallEventBase {
  * `event.input` is mutable. Mutate it in place to patch tool arguments before execution.
  * Later `tool_call` handlers see earlier mutations. No re-validation is performed after mutation.
  */
-export type ToolCallEvent = BashToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | GrepToolCallEvent | FindToolCallEvent | LsToolCallEvent | CustomToolCallEvent;
+export type ToolCallEvent = BashToolCallEvent | PowerShellToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | GrepToolCallEvent | FindToolCallEvent | LsToolCallEvent | CustomToolCallEvent;
 interface ToolResultEventBase {
     type: "tool_result";
     toolCallId: string;
@@ -702,6 +738,10 @@ export interface BashToolResultEvent extends ToolResultEventBase {
     toolName: "bash";
     details: BashToolDetails | undefined;
 }
+export interface PowerShellToolResultEvent extends ToolResultEventBase {
+    toolName: "powershell";
+    details: PowerShellToolDetails | undefined;
+}
 export interface ReadToolResultEvent extends ToolResultEventBase {
     toolName: "read";
     details: ReadToolDetails | undefined;
@@ -731,8 +771,9 @@ export interface CustomToolResultEvent extends ToolResultEventBase {
     details: unknown;
 }
 /** Fired after a tool executes. Can modify result. */
-export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | GrepToolResultEvent | FindToolResultEvent | LsToolResultEvent | CustomToolResultEvent;
+export type ToolResultEvent = BashToolResultEvent | PowerShellToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | GrepToolResultEvent | FindToolResultEvent | LsToolResultEvent | CustomToolResultEvent;
 export declare function isBashToolResult(e: ToolResultEvent): e is BashToolResultEvent;
+export declare function isPowerShellToolResult(e: ToolResultEvent): e is PowerShellToolResultEvent;
 export declare function isReadToolResult(e: ToolResultEvent): e is ReadToolResultEvent;
 export declare function isEditToolResult(e: ToolResultEvent): e is EditToolResultEvent;
 export declare function isWriteToolResult(e: ToolResultEvent): e is WriteToolResultEvent;
@@ -760,6 +801,7 @@ export declare function isLsToolResult(e: ToolResultEvent): e is LsToolResultEve
  * CustomToolCallEvent.toolName is `string` which overlaps with all literals.
  */
 export declare function isToolCallEventType(toolName: "bash", event: ToolCallEvent): event is BashToolCallEvent;
+export declare function isToolCallEventType(toolName: "powershell", event: ToolCallEvent): event is PowerShellToolCallEvent;
 export declare function isToolCallEventType(toolName: "read", event: ToolCallEvent): event is ReadToolCallEvent;
 export declare function isToolCallEventType(toolName: "edit", event: ToolCallEvent): event is EditToolCallEvent;
 export declare function isToolCallEventType(toolName: "write", event: ToolCallEvent): event is WriteToolCallEvent;
@@ -771,7 +813,7 @@ export declare function isToolCallEventType<TName extends string, TInput extends
     input: TInput;
 };
 /** Union of all event types */
-export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | BeforeProviderHeadersEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | AgentSettledEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
+export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | BeforeProviderHeadersEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | AgentSettledEvent | UIPromptStartEvent | UIPromptEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
 export interface ContextEventResult {
     messages?: AgentMessage[];
 }
@@ -873,6 +915,7 @@ export interface ExtensionAPI {
     on(event: "session_before_fork", handler: ExtensionHandler<SessionBeforeForkEvent, SessionBeforeForkResult>): void;
     on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): void;
     on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): void;
+    on(event: "session_compact_failed", handler: ExtensionHandler<SessionCompactFailedEvent>): void;
     on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): void;
     on(event: "session_before_tree", handler: ExtensionHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): void;
     on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
@@ -884,6 +927,8 @@ export interface ExtensionAPI {
     on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
     on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
     on(event: "agent_settled", handler: ExtensionHandler<AgentSettledEvent>): void;
+    on(event: "ui_prompt_start", handler: ExtensionHandler<UIPromptStartEvent>): void;
+    on(event: "ui_prompt_end", handler: ExtensionHandler<UIPromptEndEvent>): void;
     on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): void;
     on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
     on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;
@@ -910,8 +955,12 @@ export interface ExtensionAPI {
     /** Register a CLI flag. */
     registerFlag(name: string, options: {
         description?: string;
-        type: "boolean" | "string";
-        default?: boolean | string;
+        type: "boolean";
+        default?: boolean;
+    } | {
+        description?: string;
+        type: "string";
+        default?: string;
     }): void;
     /** Get the value of a registered CLI flag. */
     getFlag(name: string): boolean | string | undefined;