portercode 0.1.4 → 0.1.11

package/dist/prompt/template.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Prompt Template System
+ *
+ * Replaces brand placeholders in prompt templates with actual brand values
+ */
+export declare namespace PromptTemplate {
+    /**
+     * Render a prompt template by replacing brand placeholders
+     *
+     * Supported placeholders:
+     * - {PRODUCT_NAME} - Product name (e.g., "Porter")
+     * - {PRODUCT_COMMAND} - Command name (e.g., "porter")
+     * - {CONFIG_DIR} - Config directory (e.g., ".porter")
+     * - {CONFIG_FILE} - Config file (e.g., "porter.jsonc")
+     * - {RULES_FILE} - Rules file (e.g., "PORTER.md")
+     * - {ENV_PREFIX} - Environment variable prefix (e.g., "PORTER_")
+     */
+    function render(template: string): string;
+    /**
+     * Render a prompt template synchronously
+     * @deprecated Use render() instead - it's now synchronous
+     */
+    function renderSync(template: string): string;
+}

package/dist/provider/models.d.ts

@@ -1,7 +1,4 @@
 import type { ModelInfo, ProviderInfo } from "./types";
-/**
- * Built-in provider definitions
- */
 export declare const PROVIDERS: Record<string, ProviderInfo>;
 /**
  * Get all models from a provider

package/dist/provider/provider.d.ts

@@ -1,5 +1,5 @@
 import z from "zod";
-import type { LanguageModel } from "ai";
+import type { LanguageModel, ImageModel } from "ai";
 import type { ModelInfo, ProviderInfo } from "./types";
 /**
  * Provider System
@@ -20,6 +20,10 @@ export declare namespace Provider {
      * Get a language model instance
      */
     function getLanguageModel(providerId: string, modelId: string): Promise<LanguageModel>;
+    /**
+     * Get an image model instance
+     */
+    function getImageModel(providerId: string, modelId: string): Promise<ImageModel>;
     /**
      * Get model info
      */

package/dist/server/services/agent.d.ts

@@ -26,4 +26,15 @@ export declare namespace AgentService {
      * Cancel an active generation
      */
     function cancel(sessionId: string): boolean;
+    /**
+     * Optimize context for a session by generating a summary
+     */
+    function optimizeContext(options: {
+        sessionId: string;
+        requestId: string;
+    }): Promise<void>;
+    /**
+     * Cancel an active context optimization
+     */
+    function cancelOptimization(sessionId: string): boolean;
 }

package/dist/session/context-cache.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Context Memoization Cache
+ *
+ * Caches frequently-accessed context information to reduce redundant tool calls:
+ * - Git status
+ * - README contents
+ * - Directory structure
+ *
+ * Cache is cleared when:
+ * - /optimize command is executed
+ * - Session is restarted
+ * - Manual invalidation
+ */
+export interface CachedContext {
+    gitStatus?: {
+        output: string;
+        timestamp: number;
+    };
+    readme?: {
+        content: string;
+        path: string;
+        timestamp: number;
+    };
+    dirStructure?: {
+        output: string;
+        depth: number;
+        timestamp: number;
+    };
+}
+/**
+ * Context Cache - Memoizes expensive context operations
+ */
+export declare class ContextCache {
+    private static cache;
+    private static sessionCaches;
+    /**
+     * Get cached value for a session
+     */
+    static get<T>(sessionId: string, key: string): T | undefined;
+    /**
+     * Set cached value for a session
+     */
+    static set<T>(sessionId: string, key: string, value: T): void;
+    /**
+     * Check if key exists in cache
+     */
+    static has(sessionId: string, key: string): boolean;
+    /**
+     * Clear cache for specific session
+     */
+    static clearSession(sessionId: string): void;
+    /**
+     * Clear specific key for session
+     */
+    static clearKey(sessionId: string, key: string): void;
+    /**
+     * Clear all caches
+     */
+    static clearAll(): void;
+    /**
+     * Get cache statistics
+     */
+    static stats(): {
+        sessions: number;
+        totalEntries: number;
+    };
+}
+/**
+ * Cache keys for common context operations
+ */
+export declare const CacheKeys: {
+    readonly GIT_STATUS: "git:status";
+    readonly README: "readme:content";
+    readonly DIR_STRUCTURE: "dir:structure";
+};

package/dist/session/context-optimization.d.ts

@@ -156,5 +156,10 @@ export declare const ContextOptimization: {
      * Create a compacted message from a summary
      */
     createCompactedMessage(summary: string): CompactedMessage;
+    /**
+     * Generate a summary of messages using LLM
+     * Always uses Sonnet 4.5 for cost efficiency
+     */
+    compact(messages: SimpleMessage[]): Promise<CompactedMessage>;
 };
 export type { OverflowCheckOptions as ContextOverflowOptions };

package/dist/session/llm.d.ts

@@ -22,10 +22,47 @@ export declare namespace LLM {
      */
     function stream(options: StreamOptions): Promise<ReturnType<typeof streamText>>;
     /**
-     * Calculate token usage cost
+     * Token usage breakdown including cache-specific counts
+     */
+    interface TokenUsage {
+        /** Regular input tokens (not from cache) */
+        input: number;
+        /** Output tokens generated */
+        output: number;
+        /** Tokens read from cache (cache hits) */
+        cacheRead: number;
+        /** Tokens written to cache (cache creation) */
+        cacheWrite: number;
+        /** Total tokens (input + output + cache operations) */
+        total: number;
+    }
+    /**
+     * Count tokens including cache-specific breakdown
+     */
+    function countTokens(usage: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cachedInputTokens?: number;
+        cacheCreationInputTokens?: number;
+    }): TokenUsage;
+    /**
+     * Count only cached tokens (reads and writes)
+     */
+    function countCachedTokens(usage: {
+        cachedInputTokens?: number;
+        cacheCreationInputTokens?: number;
+    }): {
+        read: number;
+        write: number;
+        total: number;
+    };
+    /**
+     * Calculate token usage cost including cache tokens
      */
     function calculateCost(model: ModelInfo, usage: {
         inputTokens?: number;
         outputTokens?: number;
+        cachedInputTokens?: number;
+        cacheCreationInputTokens?: number;
     }): number;
 }

package/dist/session/message-optimizer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Message Optimization Module
+ *
+ * Optimizes messages before sending to LLM:
+ * - Merges consecutive tool_results to reduce message count
+ * - Filters out progress messages that add noise
+ */
+import type { ModelMessage } from "ai";
+/**
+ * Merge consecutive tool result messages
+ */
+export declare function mergeToolResults(messages: ModelMessage[]): ModelMessage[];
+/**
+ * Filter out progress messages
+ */
+export declare function filterProgressMessages(messages: ModelMessage[]): ModelMessage[];
+/**
+ * Optimize messages for LLM
+ */
+export declare function optimizeMessages(messages: ModelMessage[], options?: {
+    mergeToolResults?: boolean;
+    filterProgress?: boolean;
+}): ModelMessage[];
+/**
+ * Statistics about message optimization
+ */
+export declare function getOptimizationStats(original: ModelMessage[], optimized: ModelMessage[]): {
+    originalCount: number;
+    optimizedCount: number;
+    reduction: number;
+    reductionPercent: number;
+};

package/dist/session/session.d.ts

@@ -21,6 +21,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 }, z.ZodTypeDef, {
                     id: string;
                     directory: string;
@@ -29,6 +34,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 }>;
             }, "strip", z.ZodTypeAny, {
                 info: {
@@ -39,6 +49,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 };
             }, {
                 info: {
@@ -49,6 +64,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 };
             }>;
         };
@@ -63,6 +83,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 }, z.ZodTypeDef, {
                     id: string;
                     directory: string;
@@ -71,6 +96,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 }>;
             }, "strip", z.ZodTypeAny, {
                 info: {
@@ -81,6 +111,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 };
             }, {
                 info: {
@@ -91,6 +126,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 };
             }>;
         };
@@ -105,6 +145,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 }, z.ZodTypeDef, {
                     id: string;
                     directory: string;
@@ -113,6 +158,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 }>;
             }, "strip", z.ZodTypeAny, {
                 info: {
@@ -123,6 +173,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 };
             }, {
                 info: {
@@ -133,6 +188,11 @@ export declare namespace Session {
                     createdAt: number;
                     updatedAt: number;
                     parentId?: string | undefined;
+                    promptHistory?: string[] | undefined;
+                    tokens?: {
+                        input: number;
+                        output: number;
+                    } | undefined;
                 };
             }>;
         };
@@ -201,21 +261,24 @@ export declare namespace Session {
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "reasoning";
                     id: string;
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
+                    state: "completed" | "pending" | "running" | "failed";
                     type: "tool-call";
                     id: string;
-                    state: "completed" | "pending" | "running" | "failed";
                     input: Record<string, any>;
                     sessionId: string;
                     toolId: string;
                     messageId: string;
                     toolName: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "tool-result";
                     id: string;
@@ -224,15 +287,17 @@ export declare namespace Session {
                     messageId: string;
                     toolCallId: string;
                     input?: Record<string, any> | undefined;
+                    sequence?: number | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
                 } | {
                     type: "image";
                     id: string;
+                    data: string;
                     sessionId: string;
                     messageId: string;
                     mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
-                    data: string;
+                    sequence?: number | undefined;
                     filename?: string | undefined;
                 }, z.ZodTypeDef, {
                     type: "text";
@@ -240,21 +305,24 @@ export declare namespace Session {
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "reasoning";
                     id: string;
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
+                    state: "completed" | "pending" | "running" | "failed";
                     type: "tool-call";
                     id: string;
-                    state: "completed" | "pending" | "running" | "failed";
                     input: Record<string, any>;
                     sessionId: string;
                     toolId: string;
                     messageId: string;
                     toolName: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "tool-result";
                     id: string;
@@ -263,15 +331,17 @@ export declare namespace Session {
                     messageId: string;
                     toolCallId: string;
                     input?: Record<string, any> | undefined;
+                    sequence?: number | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
                 } | {
                     type: "image";
                     id: string;
+                    data: string;
                     sessionId: string;
                     messageId: string;
                     mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
-                    data: string;
+                    sequence?: number | undefined;
                     filename?: string | undefined;
                 }>;
                 delta: z.ZodOptional<z.ZodString>;
@@ -282,21 +352,24 @@ export declare namespace Session {
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "reasoning";
                     id: string;
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
+                    state: "completed" | "pending" | "running" | "failed";
                     type: "tool-call";
                     id: string;
-                    state: "completed" | "pending" | "running" | "failed";
                     input: Record<string, any>;
                     sessionId: string;
                     toolId: string;
                     messageId: string;
                     toolName: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "tool-result";
                     id: string;
@@ -305,15 +378,17 @@ export declare namespace Session {
                     messageId: string;
                     toolCallId: string;
                     input?: Record<string, any> | undefined;
+                    sequence?: number | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
                 } | {
                     type: "image";
                     id: string;
+                    data: string;
                     sessionId: string;
                     messageId: string;
                     mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
-                    data: string;
+                    sequence?: number | undefined;
                     filename?: string | undefined;
                 };
                 delta?: string | undefined;
@@ -324,21 +399,24 @@ export declare namespace Session {
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "reasoning";
                     id: string;
                     sessionId: string;
                     content: string;
                     messageId: string;
+                    sequence?: number | undefined;
                 } | {
+                    state: "completed" | "pending" | "running" | "failed";
                     type: "tool-call";
                     id: string;
-                    state: "completed" | "pending" | "running" | "failed";
                     input: Record<string, any>;
                     sessionId: string;
                     toolId: string;
                     messageId: string;
                     toolName: string;
+                    sequence?: number | undefined;
                 } | {
                     type: "tool-result";
                     id: string;
@@ -347,15 +425,17 @@ export declare namespace Session {
                     messageId: string;
                     toolCallId: string;
                     input?: Record<string, any> | undefined;
+                    sequence?: number | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
                 } | {
                     type: "image";
                     id: string;
+                    data: string;
                     sessionId: string;
                     messageId: string;
                     mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
-                    data: string;
+                    sequence?: number | undefined;
                     filename?: string | undefined;
                 };
                 delta?: string | undefined;
@@ -397,6 +477,16 @@ export declare namespace Session {
      * Touch a session (update timestamp)
      */
     function touch(sessionId: string): Promise<void>;
+    /**
+     * Add a prompt to session history
+     * Most recent prompts are at the end of the array
+     */
+    function addPromptToHistory(sessionId: string, prompt: string): Promise<void>;
+    /**
+     * Get prompt history for a session
+     * Returns array with most recent prompts at the end
+     */
+    function getPromptHistory(sessionId: string): Promise<string[]>;
     /**
      * List all sessions for current project, sorted by updatedAt (most recent first)
      */
@@ -423,8 +513,10 @@ export declare namespace Session {
     function removePart(sessionId: string, messageId: string, partId: string): Promise<void>;
     /**
      * Get all messages for a session
+     * @param sessionId - The session ID
+     * @param limit - Optional limit to return only the last N messages (for performance)
      */
-    function messages(sessionId: string): Promise<MessageWithParts[]>;
+    function messages(sessionId: string, limit?: number): Promise<MessageWithParts[]>;
     /**
      * Get the most recent session
      */