apex-code 0.0.1-alpha.0 → 0.0.1-alpha.10

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

@@ -27,7 +27,7 @@ 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 };
@@ -101,8 +101,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;
@@ -301,6 +301,7 @@ export interface ReplacedSessionContext extends ExtensionCommandContext {
     }): Promise<void>;
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
+        expandPromptTemplates?: boolean;
     }): Promise<void>;
 }
 /** Rendering options for tool results */
@@ -449,7 +450,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;
@@ -459,6 +460,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";
@@ -494,7 +509,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";
@@ -653,6 +668,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;
@@ -687,7 +706,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;
@@ -701,6 +720,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;
@@ -730,8 +753,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;
@@ -759,6 +783,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;
@@ -872,6 +897,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;
@@ -909,8 +935,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;
@@ -928,9 +958,11 @@ export interface ExtensionAPI {
     /**
      * Send a user message to the agent. Always triggers a turn.
      * When the agent is streaming, use deliverAs to specify how to queue the message.
+     * Set expandPromptTemplates to dispatch extension commands and expand skill commands and prompt templates.
      */
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
+        expandPromptTemplates?: boolean;
     }): void;
     /** Append a custom entry to the session for state persistence (not sent to LLM). */
     appendEntry<T = unknown>(customType: string, data?: T): void;
@@ -1133,6 +1165,7 @@ export type SendMessageHandler = <T = unknown>(message: Pick<CustomMessage<T>, "
 }) => void;
 export type SendUserMessageHandler = (content: string | (TextContent | ImageContent)[], options?: {
     deliverAs?: "steer" | "followUp";
+    expandPromptTemplates?: boolean;
 }) => void;
 export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
 export type SetSessionNameHandler = (name: string) => void;
@@ -1141,6 +1174,8 @@ export type GetActiveToolsHandler = () => string[];
 /** Tool info with name, description, parameter schema, prompt guidelines, and source metadata. */
 export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines"> & {
     sourceInfo: SourceInfo;
+    /** True when a foreign tool receives the conservative UNCLASSIFIED contract. */
+    unclassified: boolean;
 };
 export type GetAllToolsHandler = () => ToolInfo[];
 export type GetCommandsHandler = () => SlashCommandInfo[];