portercode 0.1.0 → 0.1.2

package/dist/prompt/index.d.ts

@@ -1,4 +1,4 @@
-export { SystemPrompt } from "./system";
+export { SystemPrompt, type OperationMode } from "./system";
 export { default as PROMPT_TITLE } from "./title.txt";
 export { default as PROMPT_SUMMARY } from "./summary.txt";
 export { default as PROMPT_CONTEXT_OPTIMIZATION } from "./context-optimization.txt";

package/dist/prompt/system.d.ts

@@ -4,7 +4,12 @@
  * Assembles system prompts from templates, environment info, and custom rules.
  * Different prompts are used based on the model provider for optimal behavior.
  */
+export type OperationMode = "ask" | "auto" | "plan";
 export declare namespace SystemPrompt {
+    /**
+     * Get planning mode prompt
+     */
+    function forPlanMode(): string[];
     /**
      * Get provider-specific prompt template
      */
@@ -20,5 +25,5 @@ export declare namespace SystemPrompt {
     /**
      * Assemble complete system prompt for a model
      */
-    function assemble(modelId: string): Promise<string[]>;
+    function assemble(modelId: string, mode?: OperationMode): Promise<string[]>;
 }

package/dist/server/index.d.ts

@@ -0,0 +1,21 @@
+export interface ServerInfo {
+    port: number;
+    projectDir: string;
+    startedAt: number;
+}
+/**
+ * Start the HTTP server
+ */
+export declare function startServer(port?: number): Promise<ServerInfo>;
+/**
+ * Stop the HTTP server
+ */
+export declare function stopServer(): void;
+/**
+ * Get current server info
+ */
+export declare function getServerInfo(): ServerInfo | null;
+/**
+ * Get the SSE emitter for broadcasting events
+ */
+export { SSEEmitter } from "./sse/emitter";

package/dist/server/routes/api.d.ts

@@ -0,0 +1,2 @@
+import { Hono } from "hono";
+export declare const apiRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/server/routes/events.d.ts

@@ -0,0 +1,2 @@
+import { Hono } from "hono";
+export declare const eventsRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/server/routes/health.d.ts

@@ -0,0 +1,2 @@
+import { Hono } from "hono";
+export declare const healthRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

package/dist/server/routes/sessions.d.ts

@@ -0,0 +1,2 @@
+import { Hono } from "hono";
+export declare const sessionsRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;

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

@@ -0,0 +1,29 @@
+/**
+ * Agent Service
+ *
+ * Handles LLM invocation and streaming for the HTTP API.
+ * Extracted from TUI REPL for reuse.
+ */
+export type AgentMode = "ask" | "auto" | "plan";
+export declare namespace AgentService {
+    interface ImageAttachment {
+        data: string;
+        mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+        filename?: string;
+    }
+    interface RunOptions {
+        sessionId: string;
+        content: string;
+        requestId: string;
+        images?: ImageAttachment[];
+        mode?: AgentMode;
+    }
+    /**
+     * Run the agent for a prompt
+     */
+    function run(options: RunOptions): Promise<void>;
+    /**
+     * Cancel an active generation
+     */
+    function cancel(sessionId: string): boolean;
+}

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

@@ -0,0 +1,43 @@
+/**
+ * Permission Service
+ *
+ * Manages permission requests for tool execution in "ask" mode.
+ * Tools wait for user approval before executing.
+ */
+export type PermissionResponse = "allow" | "allow_always" | "deny" | "deny_with_message";
+export interface PermissionRequest {
+    id: string;
+    sessionId: string;
+    requestId: string;
+    toolName: string;
+    toolCallId: string;
+    args: Record<string, unknown>;
+    description?: string;
+    createdAt: number;
+}
+export declare namespace PermissionService {
+    /**
+     * Request permission for a tool execution
+     * Returns a promise that resolves when the user responds
+     */
+    function request(sessionId: string, requestId: string, toolName: string, toolCallId: string, args: Record<string, unknown>, description?: string): Promise<{
+        allowed: boolean;
+        message?: string;
+    }>;
+    /**
+     * Respond to a pending permission request
+     */
+    function respond(permissionId: string, response: PermissionResponse, message?: string): boolean;
+    /**
+     * Cancel a pending permission request
+     */
+    function cancel(permissionId: string): boolean;
+    /**
+     * Cancel all pending permissions for a session
+     */
+    function cancelSession(sessionId: string): number;
+    /**
+     * Get all pending permissions for a session
+     */
+    function getPending(sessionId: string): PermissionRequest[];
+}

package/dist/server/sse/emitter.d.ts

@@ -0,0 +1,57 @@
+export interface SSEClient {
+    id: string;
+    controller: ReadableStreamDefaultController<Uint8Array>;
+    connectedAt: number;
+}
+export interface SSEEvent {
+    type: string;
+    data: unknown;
+    id?: string;
+}
+declare class SSEEmitterClass {
+    private clients;
+    private heartbeatInterval;
+    private encoder;
+    /**
+     * Start heartbeat to keep connections alive
+     */
+    startHeartbeat(intervalMs?: number): void;
+    /**
+     * Stop heartbeat
+     */
+    stopHeartbeat(): void;
+    /**
+     * Add a new SSE client
+     */
+    addClient(id: string, controller: ReadableStreamDefaultController<Uint8Array>): void;
+    /**
+     * Remove an SSE client
+     */
+    removeClient(id: string): void;
+    /**
+     * Send event to a specific client
+     */
+    sendToClient(clientId: string, event: SSEEvent): void;
+    /**
+     * Broadcast event to all connected clients
+     */
+    broadcast(event: SSEEvent): void;
+    /**
+     * Format event for SSE protocol
+     */
+    private formatSSE;
+    /**
+     * Get connected client count
+     */
+    get clientCount(): number;
+    /**
+     * Get all client IDs
+     */
+    getClientIds(): string[];
+    /**
+     * Reset emitter state (for testing)
+     */
+    reset(): void;
+}
+export declare const SSEEmitter: SSEEmitterClass;
+export {};

package/dist/session/index.d.ts

@@ -2,3 +2,4 @@ export * from "./types";
 export { Session } from "./session";
 export { LLM } from "./llm";
 export { ContextOptimization } from "./context-optimization";
+export { TitleGenerator } from "./title-generator";

package/dist/session/llm.d.ts

@@ -1,4 +1,5 @@
 import { streamText, type ModelMessage, type Tool } from "ai";
+import { type OperationMode } from "../prompt";
 import type { ModelInfo } from "../provider/types";
 export declare namespace LLM {
     interface StreamOptions {
@@ -10,6 +11,7 @@ export declare namespace LLM {
         temperature?: number;
         maxTokens?: number;
         signal?: AbortSignal;
+        mode?: OperationMode;
     }
     interface StreamResult {
         stream: AsyncIterable<any>;

package/dist/session/session.d.ts

@@ -226,6 +226,14 @@ export declare namespace Session {
                     input?: Record<string, any> | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
+                } | {
+                    type: "image";
+                    id: string;
+                    sessionId: string;
+                    messageId: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+                    data: string;
+                    filename?: string | undefined;
                 }, z.ZodTypeDef, {
                     type: "text";
                     id: string;
@@ -257,6 +265,14 @@ export declare namespace Session {
                     input?: Record<string, any> | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
+                } | {
+                    type: "image";
+                    id: string;
+                    sessionId: string;
+                    messageId: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+                    data: string;
+                    filename?: string | undefined;
                 }>;
                 delta: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
@@ -291,6 +307,14 @@ export declare namespace Session {
                     input?: Record<string, any> | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
+                } | {
+                    type: "image";
+                    id: string;
+                    sessionId: string;
+                    messageId: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+                    data: string;
+                    filename?: string | undefined;
                 };
                 delta?: string | undefined;
             }, {
@@ -325,6 +349,14 @@ export declare namespace Session {
                     input?: Record<string, any> | undefined;
                     toolName?: string | undefined;
                     metadata?: Record<string, any> | undefined;
+                } | {
+                    type: "image";
+                    id: string;
+                    sessionId: string;
+                    messageId: string;
+                    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+                    data: string;
+                    filename?: string | undefined;
                 };
                 delta?: string | undefined;
             }>;
@@ -366,7 +398,7 @@ export declare namespace Session {
      */
     function touch(sessionId: string): Promise<void>;
     /**
-     * List all sessions for current project
+     * List all sessions for current project, sorted by updatedAt (most recent first)
      */
     function list(): Promise<SessionInfo[]>;
     /**

package/dist/session/title-generator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Title Generator
+ *
+ * Generates session titles from the first 5 words of the user's message.
+ */
+export declare namespace TitleGenerator {
+    /**
+     * Generate a title from the first 5 words of the message
+     */
+    function generateTitle(message: string): string;
+}

package/dist/session/types.d.ts

@@ -155,6 +155,35 @@ export declare const ToolResultPart: z.ZodObject<{
     metadata?: Record<string, any> | undefined;
 }>;
 export type ToolResultPart = z.infer<typeof ToolResultPart>;
+/**
+ * Image content part (for vision models)
+ */
+export declare const ImagePart: z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    id: z.ZodString;
+    messageId: z.ZodString;
+    sessionId: z.ZodString;
+    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/gif", "image/webp"]>;
+    data: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    id: string;
+    sessionId: string;
+    messageId: string;
+    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+    data: string;
+    filename?: string | undefined;
+}, {
+    type: "image";
+    id: string;
+    sessionId: string;
+    messageId: string;
+    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+    data: string;
+    filename?: string | undefined;
+}>;
+export type ImagePart = z.infer<typeof ImagePart>;
 /**
  * All message part types
  */
@@ -251,6 +280,30 @@ export declare const MessagePart: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     input?: Record<string, any> | undefined;
     toolName?: string | undefined;
     metadata?: Record<string, any> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    id: z.ZodString;
+    messageId: z.ZodString;
+    sessionId: z.ZodString;
+    mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/gif", "image/webp"]>;
+    data: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    id: string;
+    sessionId: string;
+    messageId: string;
+    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+    data: string;
+    filename?: string | undefined;
+}, {
+    type: "image";
+    id: string;
+    sessionId: string;
+    messageId: string;
+    mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+    data: string;
+    filename?: string | undefined;
 }>]>;
 export type MessagePart = z.infer<typeof MessagePart>;
 /**
@@ -398,6 +451,30 @@ export declare const MessageWithParts: z.ZodObject<{
         input?: Record<string, any> | undefined;
         toolName?: string | undefined;
         metadata?: Record<string, any> | undefined;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        id: z.ZodString;
+        messageId: z.ZodString;
+        sessionId: z.ZodString;
+        mimeType: z.ZodEnum<["image/png", "image/jpeg", "image/gif", "image/webp"]>;
+        data: z.ZodString;
+        filename: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "image";
+        id: string;
+        sessionId: string;
+        messageId: string;
+        mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+        data: string;
+        filename?: string | undefined;
+    }, {
+        type: "image";
+        id: string;
+        sessionId: string;
+        messageId: string;
+        mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+        data: string;
+        filename?: string | undefined;
     }>]>, "many">;
 }, "strip", z.ZodTypeAny, {
     info: {
@@ -439,6 +516,14 @@ export declare const MessageWithParts: z.ZodObject<{
         input?: Record<string, any> | undefined;
         toolName?: string | undefined;
         metadata?: Record<string, any> | undefined;
+    } | {
+        type: "image";
+        id: string;
+        sessionId: string;
+        messageId: string;
+        mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+        data: string;
+        filename?: string | undefined;
     })[];
 }, {
     info: {
@@ -480,6 +565,14 @@ export declare const MessageWithParts: z.ZodObject<{
         input?: Record<string, any> | undefined;
         toolName?: string | undefined;
         metadata?: Record<string, any> | undefined;
+    } | {
+        type: "image";
+        id: string;
+        sessionId: string;
+        messageId: string;
+        mimeType: "image/png" | "image/jpeg" | "image/gif" | "image/webp";
+        data: string;
+        filename?: string | undefined;
     })[];
 }>;
 export type MessageWithParts = z.infer<typeof MessageWithParts>;

package/dist/tool/image.d.ts

@@ -6,13 +6,13 @@ export declare const ImageTool: Tool.Info<z.ZodObject<{
     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;
+    prompt: 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;
+    prompt: 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;
 }>, {

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "portercode",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "AI-powered coding assistant CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,13 @@
     "test": "bun test",
     "typecheck": "tsc --noEmit"
   },
-  "keywords": ["cli", "ai", "coding-assistant", "llm"],
-  "author": "Porter Metrics Inc. <alexis@portermetrics.com>",
+  "keywords": [
+    "cli",
+    "ai",
+    "coding-assistant",
+    "llm"
+  ],
+  "author": "Carlos Alexis Gomez Ruiz <alexisg.0207@gmail.com>",
   "license": "SEE LICENSE IN LICENSE",
   "devDependencies": {
     "@tsconfig/bun": "^1.0.7",
@@ -55,6 +60,7 @@
     "diff": "^7.0.0",
     "figures": "^6.0.1",
     "gray-matter": "^4.0.3",
+    "hono": "^4.11.3",
     "ignore": "^7.0.5",
     "ink": "^5.0.1",
     "jsonc-parser": "^3.3.1",