portercode 0.1.0

package/dist/tool/image.d.ts

@@ -0,0 +1,23 @@
+import z from "zod";
+import { Tool } from "./tool";
+export declare const ImageTool: Tool.Info<z.ZodObject<{
+    prompt: z.ZodString;
+    filename: z.ZodString;
+    directory: z.ZodOptional<z.ZodString>;
+    aspectRatio: z.ZodOptional<z.ZodEnum<["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "5:4", "4:5", "21:9"]>>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    filename: string;
+    directory?: string | undefined;
+    aspectRatio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "5:4" | "4:5" | "21:9" | undefined;
+}, {
+    prompt: string;
+    filename: string;
+    directory?: string | undefined;
+    aspectRatio?: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "5:4" | "4:5" | "21:9" | undefined;
+}>, {
+    path: string;
+    size: number;
+    duration: string;
+    aspectRatio: "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "5:4" | "4:5" | "21:9";
+}>;

package/dist/tool/index.d.ts

@@ -0,0 +1,11 @@
+export { Tool } from "./tool";
+export { ToolRegistry } from "./registry";
+export { ReadTool } from "./read";
+export { GlobTool } from "./glob";
+export { GrepTool } from "./grep";
+export { BashTool } from "./bash";
+export { WriteTool } from "./write";
+export { EditTool } from "./edit";
+export { LsTool } from "./ls";
+export { TodoTool, TodoEvent, getTodos, clearTodos, type TodoItem } from "./todo";
+export { ImageTool } from "./image";

package/dist/tool/ls.d.ts

@@ -0,0 +1,14 @@
+import z from "zod";
+import { Tool } from "./tool";
+export declare const LsTool: Tool.Info<z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    depth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    depth?: number | undefined;
+}, {
+    path?: string | undefined;
+    depth?: number | undefined;
+}>, {
+    count: number;
+}>;

package/dist/tool/read.d.ts

@@ -0,0 +1,17 @@
+import z from "zod";
+import { Tool } from "./tool";
+export declare const ReadTool: Tool.Info<z.ZodObject<{
+    filePath: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    filePath: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>, {
+    preview: string;
+}>;

package/dist/tool/registry.d.ts

@@ -0,0 +1,30 @@
+import { Tool } from "./tool";
+export declare namespace ToolRegistry {
+    /**
+     * Get all registered tools
+     */
+    function all(): readonly Tool.Info<any, any>[];
+    /**
+     * Get a tool by its ID
+     */
+    function get(id: string): Tool.Info<any, any> | undefined;
+    /**
+     * Check if a tool exists
+     */
+    function has(id: string): boolean;
+    /**
+     * Get all tool IDs
+     */
+    function ids(): string[];
+    /**
+     * Initialize all tools and return their definitions
+     * This is used when setting up the LLM with available tools
+     * Conditional tools that return null during init are skipped
+     */
+    function initialize(ctx?: Tool.InitContext): Promise<Tool.Initialized[]>;
+    /**
+     * Initialize a specific subset of tools
+     * Conditional tools that return null during init are skipped
+     */
+    function initializeSubset(ids: string[], ctx?: Tool.InitContext): Promise<Tool.Initialized[]>;
+}

package/dist/tool/todo.d.ts

@@ -0,0 +1,76 @@
+import z from "zod";
+import { Tool } from "./tool";
+/**
+ * Todo Tool
+ *
+ * Allows the agent to create and manage a task list for tracking progress.
+ * Tasks are displayed in the UI and help users understand what the agent is doing.
+ */
+export interface TodoItem {
+    content: string;
+    status: "pending" | "in_progress" | "completed";
+    activeForm: string;
+}
+export declare const TodoEvent: {
+    Updated: {
+        type: "todo.updated";
+        properties: z.ZodObject<{
+            todos: z.ZodArray<z.ZodObject<{
+                content: z.ZodString;
+                status: z.ZodEnum<["pending", "in_progress", "completed"]>;
+                activeForm: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                status: "completed" | "pending" | "in_progress";
+                content: string;
+                activeForm: string;
+            }, {
+                status: "completed" | "pending" | "in_progress";
+                content: string;
+                activeForm: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            todos: {
+                status: "completed" | "pending" | "in_progress";
+                content: string;
+                activeForm: string;
+            }[];
+        }, {
+            todos: {
+                status: "completed" | "pending" | "in_progress";
+                content: string;
+                activeForm: string;
+            }[];
+        }>;
+    };
+};
+export declare function getTodos(sessionId: string): TodoItem[];
+export declare function clearTodos(sessionId: string): void;
+export declare const TodoTool: Tool.Info<z.ZodObject<{
+    todos: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        status: z.ZodEnum<["pending", "in_progress", "completed"]>;
+        activeForm: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: "completed" | "pending" | "in_progress";
+        content: string;
+        activeForm: string;
+    }, {
+        status: "completed" | "pending" | "in_progress";
+        content: string;
+        activeForm: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    todos: {
+        status: "completed" | "pending" | "in_progress";
+        content: string;
+        activeForm: string;
+    }[];
+}, {
+    todos: {
+        status: "completed" | "pending" | "in_progress";
+        content: string;
+        activeForm: string;
+    }[];
+}>, {
+    todosCount: number;
+}>;

package/dist/tool/tool.d.ts

@@ -0,0 +1,65 @@
+import z from "zod";
+export declare namespace Tool {
+    interface Metadata {
+        [key: string]: any;
+    }
+    export interface InitContext {
+        agent?: any;
+    }
+    export type Context<M extends Metadata = Metadata> = {
+        sessionID: string;
+        messageID: string;
+        agent: string;
+        abort: AbortSignal;
+        callID?: string;
+        extra?: {
+            [key: string]: any;
+        };
+        metadata(input: {
+            title?: string;
+            metadata?: M;
+        }): void;
+    };
+    export interface FilePart {
+        id: string;
+        sessionID: string;
+        messageID: string;
+        type: "file";
+        mime: string;
+        url: string;
+    }
+    export interface ToolDefinition<Parameters extends z.ZodType = z.ZodType, M extends Metadata = Metadata> {
+        description: string;
+        parameters: Parameters;
+        execute(args: z.infer<Parameters>, ctx: Context): Promise<{
+            title: string;
+            metadata: M;
+            output: string;
+            attachments?: FilePart[];
+        }>;
+        formatValidationError?(error: z.ZodError): string;
+    }
+    export interface Info<Parameters extends z.ZodType = z.ZodType, M extends Metadata = Metadata> {
+        id: string;
+        init: (ctx?: InitContext) => Promise<ToolDefinition<Parameters, M> | null>;
+    }
+    export type InferParameters<T extends Info> = T extends Info<infer P> ? z.infer<P> : never;
+    export type InferMetadata<T extends Info> = T extends Info<any, infer M> ? M : never;
+    /**
+     * Represents an initialized tool ready for use
+     */
+    export interface Initialized<P extends z.ZodType = z.ZodType, M extends Metadata = Metadata> {
+        id: string;
+        description: string;
+        parameters: P;
+        execute(args: z.infer<P>, ctx: Context): Promise<{
+            title: string;
+            metadata: M;
+            output: string;
+            attachments?: FilePart[];
+        }>;
+        formatValidationError?(error: z.ZodError): string;
+    }
+    export function define<Parameters extends z.ZodType, Result extends Metadata>(id: string, init: Info<Parameters, Result>["init"] | ToolDefinition<Parameters, Result> | null): Info<Parameters, Result>;
+    export {};
+}

package/dist/tool/write.d.ts

@@ -0,0 +1,16 @@
+import z from "zod";
+import { Tool } from "./tool";
+export declare const WriteTool: Tool.Info<z.ZodObject<{
+    filePath: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    filePath: string;
+}, {
+    content: string;
+    filePath: string;
+}>, {
+    action: string;
+    lines: number;
+    preview: string;
+}>;

package/dist/tui/App.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Main TUI Application Component
+ *
+ * Root React component that manages routing and global state.
+ */
+import type { TuiOptions } from "./index";
+interface AppProps extends TuiOptions {
+}
+export declare function App({ sessionId: initialSessionId, onExit }: AppProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Header.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Header Component
+ *
+ * Displays the app title, mode indicator, and session title.
+ */
+type Mode = "auto" | "plan" | "ask";
+interface HeaderProps {
+    title?: string;
+    mode: Mode;
+}
+export declare function Header({ title, mode }: HeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Message/AssistantMessage.d.ts

@@ -0,0 +1,10 @@
+/**
+ * AssistantMessage Component
+ *
+ * Displays an assistant message with markdown rendering.
+ */
+interface AssistantMessageProps {
+    content: string;
+}
+export declare function AssistantMessage({ content }: AssistantMessageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Message/ReasoningMessage.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ReasoningMessage Component
+ *
+ * Displays agent reasoning/thinking in a compact format.
+ */
+import React from "react";
+interface ReasoningMessageProps {
+    content: string;
+    label?: string;
+    streaming?: boolean;
+    termWidth?: number;
+}
+export declare const ReasoningMessage: React.NamedExoticComponent<ReasoningMessageProps>;
+/**
+ * Compact version for message history
+ */
+export declare function ReasoningHistoryMessage({ content }: {
+    content: string;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Message/ToolCallMessage.d.ts

@@ -0,0 +1,25 @@
+/**
+ * ToolCallMessage Component
+ *
+ * Displays a tool call with IN/OUT format.
+ * For edit/write tools, shows a compact diff preview.
+ */
+import React from "react";
+type ToolStatus = "pending" | "running" | "completed" | "failed";
+interface ToolCallMessageProps {
+    name: string;
+    args?: Record<string, any>;
+    status: ToolStatus;
+    output?: string;
+    termWidth?: number;
+}
+export declare const ToolCallMessage: React.NamedExoticComponent<ToolCallMessageProps>;
+/**
+ * Compact version for message history (tool results)
+ */
+export declare function ToolResultMessage({ toolName, input, output, }: {
+    toolName?: string;
+    input?: Record<string, any>;
+    output?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Message/UserMessage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * UserMessage Component
+ *
+ * Displays a user message in the conversation.
+ * Long messages are truncated to 3 lines with a count indicator.
+ */
+interface UserMessageProps {
+    content: string;
+}
+export declare function UserMessage({ content }: UserMessageProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Message/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Message Component
+ *
+ * Dispatcher that renders the appropriate message component based on type.
+ */
+import type { MessageWithParts } from "../../../session/types";
+interface MessageProps {
+    message: MessageWithParts;
+}
+export declare function Message({ message }: MessageProps): import("react/jsx-runtime").JSX.Element;
+export { UserMessage } from "./UserMessage";
+export { AssistantMessage } from "./AssistantMessage";
+export { ToolCallMessage, ToolResultMessage } from "./ToolCallMessage";

package/dist/tui/components/PermissionPrompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PermissionPrompt Component
+ *
+ * Displays permission requests and handles user responses.
+ */
+export declare function PermissionPrompt(): import("react/jsx-runtime").JSX.Element | null;

package/dist/tui/components/PromptInput.d.ts

@@ -0,0 +1,32 @@
+/**
+ * PromptInput Component
+ *
+ * Multiline text input for the terminal with cursor management.
+ * Supports:
+ * - Multiline input:
+ *   - Ctrl+J: insert newline (most reliable, works in all terminals)
+ *   - Ctrl+O: insert newline
+ *   - Backslash at end of line + Enter: continue on next line
+ *   - Shift+Enter: insert newline (requires CSI u mode - Kitty, WezTerm, iTerm2 with setting)
+ *   - Meta+Enter: insert newline (if terminal supports it)
+ * - Cursor navigation (arrows, home, end)
+ * - Word navigation (Ctrl+arrows)
+ * - History navigation (up/down when at first/last line)
+ * - Paste detection
+ *
+ * Note on Shift+Enter:
+ * Most terminal emulators (Terminal.app, default iTerm2) don't distinguish Shift+Enter
+ * from regular Enter. To enable Shift+Enter support:
+ * - iTerm2: Preferences > Profiles > Keys > Report modifiers using CSI u
+ * - Kitty/WezTerm: Enabled by default
+ * - Other terminals: Use Ctrl+J as a reliable alternative
+ */
+interface PromptInputProps {
+    onSubmit: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    history?: string[];
+    queued?: number;
+}
+export declare function PromptInput({ onSubmit, placeholder, disabled, history, queued, }: PromptInputProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/REPL.d.ts

@@ -0,0 +1,17 @@
+/**
+ * REPL Component
+ *
+ * Main session view that displays messages, handles input, and manages LLM interaction.
+ */
+type Mode = "auto" | "plan" | "ask";
+interface REPLProps {
+    sessionId?: string;
+    mode: Mode;
+    ctrlCPressed: boolean;
+    onNewSession: () => void;
+    onSessionCreated?: (sessionId: string) => void;
+    onSwitchSession?: (sessionId: string) => void;
+    onModeChange?: (mode: Mode) => void;
+}
+export declare function REPL({ sessionId, mode, ctrlCPressed, onNewSession, onSessionCreated, onSwitchSession, onModeChange }: REPLProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/Spinner.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Spinner Component
+ *
+ * Simple animated loading indicator for the terminal.
+ */
+import React from "react";
+interface SpinnerProps {
+    message?: string;
+    color?: string;
+    showTime?: boolean;
+}
+export declare const Spinner: React.NamedExoticComponent<SpinnerProps>;
+export {};

package/dist/tui/components/StatusBar.d.ts

@@ -0,0 +1,12 @@
+/**
+ * StatusBar Component
+ *
+ * Bottom status bar with shortcuts and connection status.
+ */
+type Mode = "auto" | "plan" | "ask";
+interface StatusBarProps {
+    mode: Mode;
+    contextUsage?: number;
+}
+export declare function StatusBar({ mode, contextUsage }: StatusBarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/TodoList.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TodoList Component
+ *
+ * Displays the current task list with status indicators.
+ */
+import React from "react";
+import type { TodoItem } from "../../tool/todo";
+interface TodoListProps {
+    todos: TodoItem[];
+    termWidth?: number;
+}
+export declare const TodoList: React.NamedExoticComponent<TodoListProps>;
+/**
+ * Compact inline version for status bar
+ */
+export declare function TodoStatus({ todos }: TodoListProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/tui/components/WelcomeBox.d.ts

@@ -0,0 +1,13 @@
+/**
+ * WelcomeBox Component
+ *
+ * Welcome screen displayed on startup with product info and tips.
+ */
+interface WelcomeBoxProps {
+    user?: string;
+    model?: string;
+    provider?: string;
+    cwd: string;
+}
+export declare function WelcomeBox({ user, model, provider, cwd }: WelcomeBoxProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/dialogs/DiagnosticsPanel.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DiagnosticsPanel Dialog
+ *
+ * System diagnostics and health check for /doctor command.
+ * Displays environment info, API status, and configuration checks.
+ */
+interface DiagnosticsProps {
+    sessionId?: string;
+    onClose: () => void;
+}
+export declare function DiagnosticsPanel({ sessionId, onClose }: DiagnosticsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/dialogs/HelpPanel.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HelpPanel Dialog
+ *
+ * Interactive help panel for /help command.
+ * Shows available commands grouped by category with descriptions.
+ */
+interface HelpPanelProps {
+    onClose: () => void;
+}
+export declare function HelpPanel({ onClose }: HelpPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/dialogs/ModelSelector.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ModelSelector Dialog
+ *
+ * Interactive model selection for /model command.
+ * Allows users to browse and select AI models from available providers.
+ */
+interface ModelSelectorProps {
+    currentModel?: string;
+    availableProviders: string[];
+    onSelect: (providerId: string, modelId: string) => void;
+    onCancel: () => void;
+}
+export declare function ModelSelector({ currentModel, availableProviders, onSelect, onCancel, }: ModelSelectorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/dialogs/PermissionPrompt.d.ts

@@ -0,0 +1,17 @@
+/**
+ * PermissionPrompt Dialog
+ *
+ * Interactive permission request dialog for ask mode.
+ * Displays when an operation requires user approval.
+ * Options: Allow, Allow (don't ask again), Deny, Other
+ */
+import React from "react";
+import type { PermissionRequest } from "../../../permission/types";
+interface PermissionPromptProps {
+    request: PermissionRequest;
+    onRespond: (granted: boolean, pattern?: string, switchToAuto?: boolean) => void;
+    onOtherSelected?: (selected: boolean) => void;
+    termWidth?: number;
+}
+export declare const PermissionPrompt: React.NamedExoticComponent<PermissionPromptProps>;
+export {};

package/dist/tui/components/dialogs/SessionPicker.d.ts

@@ -0,0 +1,15 @@
+/**
+ * SessionPicker Dialog
+ *
+ * Interactive session selection for /resume command.
+ * Groups sessions by date: Today, Yesterday, This Week, Earlier.
+ * Shows session titles based on first user prompt.
+ * Features windowed scrolling (5 visible items) and Tab section navigation.
+ */
+interface SessionPickerProps {
+    currentSessionId?: string;
+    onSelect: (sessionId: string) => void;
+    onCancel: () => void;
+}
+export declare function SessionPicker({ currentSessionId, onSelect, onCancel, }: SessionPickerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/dialogs/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Dialog Components
+ *
+ * Interactive panels and dialogs for commands.
+ */
+export { ModelSelector } from "./ModelSelector";
+export { HelpPanel } from "./HelpPanel";
+export { DiagnosticsPanel } from "./DiagnosticsPanel";
+export { PermissionPrompt } from "./PermissionPrompt";
+export { SessionPicker } from "./SessionPicker";

package/dist/tui/components/diff/DiffHunk.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DiffHunk Component
+ *
+ * Displays a hunk (section) of diff with header and lines.
+ */
+import type { DiffHunk as DiffHunkType } from "../../../diff";
+interface DiffHunkProps {
+    hunk: DiffHunkType;
+    showLineNumbers?: boolean;
+}
+export declare function DiffHunk({ hunk, showLineNumbers }: DiffHunkProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/diff/DiffLine.d.ts

@@ -0,0 +1,14 @@
+/**
+ * DiffLine Component
+ *
+ * Displays a single line of diff with proper styling.
+ * Supports word-level highlighting for modified lines.
+ */
+import type { DiffLine as DiffLineType } from "../../../diff";
+interface DiffLineProps {
+    line: DiffLineType;
+    showLineNumbers?: boolean;
+    lineNumberWidth?: number;
+}
+export declare function DiffLine({ line, showLineNumbers, lineNumberWidth }: DiffLineProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/diff/DiffStats.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DiffStats Component
+ *
+ * Displays diff statistics (additions/deletions) with visual bar.
+ */
+interface DiffStatsProps {
+    additions: number;
+    deletions: number;
+    maxWidth?: number;
+}
+export declare function DiffStats({ additions, deletions, maxWidth }: DiffStatsProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/diff/DiffView.d.ts

@@ -0,0 +1,15 @@
+/**
+ * DiffView Component
+ *
+ * Main component for displaying file diffs in the TUI.
+ * Shows file header, stats, and all hunks.
+ */
+import type { DiffResult } from "../../../diff";
+interface DiffViewProps {
+    diff: DiffResult;
+    showLineNumbers?: boolean;
+    showStats?: boolean;
+    collapsed?: boolean;
+}
+export declare function DiffView({ diff, showLineNumbers, showStats, collapsed, }: DiffViewProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/tui/components/diff/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Diff TUI Components
+ *
+ * React/Ink components for rendering diffs in the terminal.
+ */
+export { DiffView } from "./DiffView";
+export { DiffHunk } from "./DiffHunk";
+export { DiffLine } from "./DiffLine";
+export { DiffStats } from "./DiffStats";