@jx-grxf/patchpilot 0.2.1 → 0.3.1-beta

package/dist/core/types.d.ts

@@ -5,11 +5,12 @@ export type ChatMessage = {
 };
 export type ModelProvider = "ollama" | "gemini" | "codex" | "openrouter" | "nvidia";
 export type ReasoningEffort = "low" | "medium" | "high" | "xhigh";
+export type ProviderReasoningEffort = ReasoningEffort | "none";
 export type ModelChatOptions = {
     model: string;
     messages: ChatMessage[];
     formatJson?: boolean;
-    reasoningEffort?: ReasoningEffort;
+    reasoningEffort?: ProviderReasoningEffort;
     signal?: AbortSignal;
 };
 export type ModelChatResult = {
@@ -20,11 +21,33 @@ export type ModelClient = {
     chat(options: ModelChatOptions): Promise<ModelChatResult>;
     listModels(): Promise<string[]>;
 };
-export type AgentToolName = "list_files" | "read_file" | "search_text" | "inspect_document" | "write_file" | "run_shell";
+export type AgentWorkState = "idle" | "inspecting" | "planning" | "reading" | "editing" | "verifying" | "waiting_approval" | "done" | "error";
+export type AgentToolName = "list_files" | "read_file" | "read_range" | "file_info" | "search_text" | "inspect_document" | "git_status" | "git_diff" | "list_changed_files" | "list_scripts" | "write_file" | "apply_patch" | "run_script" | "run_tests" | "run_shell";
 export type AgentToolCall = {
     name: AgentToolName;
     arguments: Record<string, unknown>;
 };
+export type ToolRisk = "low" | "medium" | "high";
+export type ToolSideEffect = "none" | "write" | "shell";
+export type ToolPermission = "none" | "write" | "shell";
+export type ToolCategory = "read" | "search" | "write" | "shell" | "git" | "test" | "document";
+export type ToolSpec = {
+    name: AgentToolName;
+    description: string;
+    risk: ToolRisk;
+    sideEffects: ToolSideEffect;
+    permission: ToolPermission;
+    category: ToolCategory;
+};
+export type PermissionDecision = "allow_once" | "allow_session" | "deny";
+export type ApprovalRequest = {
+    id: string;
+    tool: AgentToolName;
+    permission: Exclude<ToolPermission, "none">;
+    risk: ToolRisk;
+    preview: string;
+    arguments: Record<string, unknown>;
+};
 export type AgentResponse = {
     action: "tools";
     message: string;
@@ -37,33 +60,111 @@ export type SubagentRole = "planner" | "reviewer" | "explorer";
 export type AgentEvent = {
     type: "status";
     message: string;
+    workState: AgentWorkState;
 } | {
     type: "metrics";
     metrics: ModelTelemetry;
+    workState: AgentWorkState;
 } | {
     type: "assistant";
     message: string;
+    workState: AgentWorkState;
 } | {
     type: "subagent";
     role: SubagentRole;
     message: string;
     metrics: ModelTelemetry;
+    workState: AgentWorkState;
 } | {
     type: "tool";
     name: AgentToolName;
     summary: string;
     ok: boolean;
+    workState: AgentWorkState;
+    toolCallId?: string;
+    category?: ToolCategory;
+    preview?: string;
+    metadata?: Record<string, unknown>;
+} | {
+    type: "approval";
+    request: ApprovalRequest;
+    decision: PermissionDecision;
+    workState: AgentWorkState;
 } | {
     type: "final";
     message: string;
+    workState: AgentWorkState;
 } | {
     type: "error";
     message: string;
+    workState: AgentWorkState;
 };
 export type ToolResult = {
     ok: boolean;
     summary: string;
     content: string;
+    tool?: AgentToolName;
+    category?: ToolCategory;
+    preview?: string;
+    approval?: {
+        request: ApprovalRequest;
+        decision: PermissionDecision;
+    };
+    metadata?: Record<string, unknown>;
+};
+export type SessionEvent = {
+    type: "session.created";
+    sessionId: string;
+    workspace: string;
+    createdAt: string;
+} | {
+    type: "run.started";
+    runId: string;
+    task: string;
+    provider: ModelProvider;
+    model: string;
+    startedAt: string;
+} | {
+    type: "model.request";
+    runId: string;
+    workState: AgentWorkState;
+    provider: ModelProvider;
+    model: string;
+    step: number;
+    createdAt: string;
+} | {
+    type: "tool.requested";
+    runId: string;
+    toolCallId: string;
+    tool: AgentToolName;
+    arguments: Record<string, unknown>;
+    workState: AgentWorkState;
+    createdAt: string;
+} | {
+    type: "approval.requested";
+    runId: string;
+    request: ApprovalRequest;
+    decision: PermissionDecision;
+    createdAt: string;
+} | {
+    type: "tool.completed";
+    runId: string;
+    toolCallId: string;
+    tool: AgentToolName;
+    ok: boolean;
+    summary: string;
+    workState: AgentWorkState;
+    createdAt: string;
+} | {
+    type: "run.completed";
+    runId: string;
+    message: string;
+    completedAt: string;
+} | {
+    type: "run.failed";
+    runId: string;
+    message: string;
+    failedAt: string;
 };
 export type ModelTelemetry = {
     promptTokens: number;

package/dist/core/workspace.d.ts

@@ -1,11 +1,14 @@
-import type { AgentToolCall, ToolResult } from "./types.js";
+import type { AgentToolCall, AgentToolName, ApprovalRequest, PermissionDecision, ToolResult, ToolSpec } from "./types.js";
 export type WorkspaceToolsOptions = {
     root: string;
     allowWrite: boolean;
     allowShell: boolean;
     timeoutMs?: number;
     signal?: AbortSignal;
+    approvalHandler?: (request: ApprovalRequest) => Promise<PermissionDecision>;
 };
+export declare const toolSpecs: Record<AgentToolName, ToolSpec>;
+export declare function getToolSpec(name: AgentToolName): ToolSpec;
 export declare class WorkspaceTools {
     readonly root: string;
     private readonly rootRealPath;
@@ -13,16 +16,29 @@ export declare class WorkspaceTools {
     private readonly allowShell;
     private readonly timeoutMs;
     private readonly signal?;
+    private readonly approvalHandler?;
+    private readonly sessionApprovals;
     constructor(options: WorkspaceToolsOptions);
     execute(call: AgentToolCall): Promise<ToolResult>;
     resolveInsideWorkspace(requestedPath: string): string;
     normalizeWorkspaceRelativePath(requestedPath: string): string;
     private listFiles;
     private readFile;
+    private readRange;
+    private fileInfo;
     private inspectDocument;
     private searchText;
     private writeFile;
+    private gitStatus;
+    private gitDiff;
+    private listChangedFiles;
+    private listScripts;
+    private applyPatch;
+    private runScript;
+    private runTests;
     private runShell;
+    private readPackageScripts;
+    private requestApproval;
     private resolveReadPath;
     private resolveWritePath;
 }