pi-freerouter 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Type re-exports for pi-freerouter.
+ *
+ * All extension types come from @earendil-works/pi-coding-agent.
+ * The AI-layer types (AssistantMessageEventStream, Context, Model, etc.) are
+ * NOT re-exported by the top-level pi-coding-agent package — they live in the
+ * bundled @earendil-works/pi-ai sub-package.  We declare them here as local
+ * types that are structurally compatible, derived from the published .d.ts
+ * files inspected at /node_modules/.../pi-ai/dist/utils/event-stream.d.ts and
+ * /node_modules/.../pi-ai/dist/types.d.ts.
+ */
+export type { ExtensionAPI, ExtensionFactory, ExtensionContext, ProviderConfig, ProviderModelConfig, SessionStartEvent, } from "@earendil-works/pi-coding-agent";
+/** Supported input types for a message. */
+export interface TextContent {
+    type: "text";
+    text: string;
+}
+export interface ImageContent {
+    type: "image";
+    data: string;
+    mimeType: string;
+}
+export interface ToolCall {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ThinkingContent {
+    type: "thinking";
+    thinking: string;
+}
+export interface Usage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    totalTokens: number;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        total: number;
+    };
+}
+export type StopReason = "stop" | "length" | "toolUse" | "error" | "aborted";
+export interface UserMessage {
+    role: "user";
+    content: string | (TextContent | ImageContent)[];
+    timestamp: number;
+}
+export interface AssistantMessage {
+    role: "assistant";
+    content: (TextContent | ThinkingContent | ToolCall)[];
+    api: string;
+    provider: string;
+    model: string;
+    usage: Usage;
+    stopReason: StopReason;
+    timestamp: number;
+    errorMessage?: string;
+}
+export interface ToolResultMessage {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: (TextContent | ImageContent)[];
+    isError: boolean;
+    timestamp: number;
+}
+export type Message = UserMessage | AssistantMessage | ToolResultMessage;
+/** Context passed to streamSimple (and the ProviderConfig.streamSimple callback). */
+export interface Context {
+    systemPrompt?: string;
+    messages: Message[];
+    tools?: Array<{
+        name: string;
+        description: string;
+        parameters: unknown;
+    }>;
+}
+/** Minimal Model shape used by streamSimple. */
+export interface Model {
+    id: string;
+    name: string;
+    api: string;
+    provider: string;
+    baseUrl: string;
+    reasoning: boolean;
+    input: ("text" | "image")[];
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    contextWindow: number;
+    maxTokens: number;
+    headers?: Record<string, string>;
+}
+export type ThinkingLevel = "minimal" | "low" | "medium" | "high" | "xhigh";
+/** Options passed to ProviderConfig.streamSimple. */
+export interface SimpleStreamOptions {
+    temperature?: number;
+    maxTokens?: number;
+    signal?: AbortSignal;
+    apiKey?: string;
+    reasoning?: ThinkingLevel;
+}
+/**
+ * Async-iterable event stream returned by ProviderConfig.streamSimple.
+ * Structurally compatible with AssistantMessageEventStream from pi-ai.
+ */
+export type AssistantMessageEvent = {
+    type: "start";
+    partial: AssistantMessage;
+} | {
+    type: "text_start";
+    contentIndex: number;
+    partial: AssistantMessage;
+} | {
+    type: "text_delta";
+    contentIndex: number;
+    delta: string;
+    partial: AssistantMessage;
+} | {
+    type: "text_end";
+    contentIndex: number;
+    content: string;
+    partial: AssistantMessage;
+} | {
+    type: "thinking_start";
+    contentIndex: number;
+    partial: AssistantMessage;
+} | {
+    type: "thinking_delta";
+    contentIndex: number;
+    delta: string;
+    partial: AssistantMessage;
+} | {
+    type: "thinking_end";
+    contentIndex: number;
+    content: string;
+    partial: AssistantMessage;
+} | {
+    type: "toolcall_start";
+    contentIndex: number;
+    partial: AssistantMessage;
+} | {
+    type: "toolcall_delta";
+    contentIndex: number;
+    delta: string;
+    partial: AssistantMessage;
+} | {
+    type: "toolcall_end";
+    contentIndex: number;
+    toolCall: ToolCall;
+    partial: AssistantMessage;
+} | {
+    type: "done";
+    reason: "stop" | "length" | "toolUse";
+    message: AssistantMessage;
+} | {
+    type: "error";
+    reason: "aborted" | "error";
+    error: AssistantMessage;
+};
+export interface AssistantMessageEventStream extends AsyncIterable<AssistantMessageEvent> {
+    push(event: AssistantMessageEvent): void;
+    end(result?: AssistantMessage): void;
+    result(): Promise<AssistantMessage>;
+}
+/**
+ * Factory function for AssistantMessageEventStream.
+ *
+ * NOTE: The real implementation lives in @earendil-works/pi-ai, which is a
+ * bundled sub-dependency not directly importable from extension code.  Pi
+ * injects its own stream factory through the ProviderConfig.streamSimple
+ * callback signature — extensions never need to instantiate the stream
+ * themselves.  If you do need a concrete implementation for testing, create
+ * one that satisfies the AsyncIterable interface above.
+ *
+ * @internal — for testing only. Pi runtime provides the real factory via streamSimple context.
+ */
+export declare function createAssistantMessageEventStream(): AssistantMessageEventStream;

package/dist/types.js

@@ -0,0 +1,88 @@
+/**
+ * Type re-exports for pi-freerouter.
+ *
+ * All extension types come from @earendil-works/pi-coding-agent.
+ * The AI-layer types (AssistantMessageEventStream, Context, Model, etc.) are
+ * NOT re-exported by the top-level pi-coding-agent package — they live in the
+ * bundled @earendil-works/pi-ai sub-package.  We declare them here as local
+ * types that are structurally compatible, derived from the published .d.ts
+ * files inspected at /node_modules/.../pi-ai/dist/utils/event-stream.d.ts and
+ * /node_modules/.../pi-ai/dist/types.d.ts.
+ */
+/**
+ * Factory function for AssistantMessageEventStream.
+ *
+ * NOTE: The real implementation lives in @earendil-works/pi-ai, which is a
+ * bundled sub-dependency not directly importable from extension code.  Pi
+ * injects its own stream factory through the ProviderConfig.streamSimple
+ * callback signature — extensions never need to instantiate the stream
+ * themselves.  If you do need a concrete implementation for testing, create
+ * one that satisfies the AsyncIterable interface above.
+ *
+ * @internal — for testing only. Pi runtime provides the real factory via streamSimple context.
+ */
+export function createAssistantMessageEventStream() {
+    const queue = [];
+    const waiters = [];
+    let isDone = false;
+    let finalResult;
+    let resolveResult;
+    const resultPromise = new Promise((r) => (resolveResult = r));
+    const stream = {
+        push(event) {
+            if (isDone)
+                return;
+            if (waiters.length > 0) {
+                waiters.shift()({ value: event, done: false });
+            }
+            else {
+                queue.push(event);
+            }
+            if (event.type === "done") {
+                finalResult = event.message;
+                resolveResult(event.message);
+                isDone = true;
+                while (waiters.length > 0) {
+                    waiters.shift()({ value: undefined, done: true });
+                }
+            }
+            else if (event.type === "error") {
+                finalResult = event.error;
+                resolveResult(event.error);
+                isDone = true;
+                while (waiters.length > 0) {
+                    waiters.shift()({ value: undefined, done: true });
+                }
+            }
+        },
+        end(result) {
+            isDone = true;
+            if (result && !finalResult)
+                resolveResult(result);
+            while (waiters.length > 0) {
+                waiters.shift()({ value: undefined, done: true });
+            }
+        },
+        result() {
+            return resultPromise;
+        },
+        [Symbol.asyncIterator]() {
+            return {
+                next() {
+                    if (queue.length > 0) {
+                        return Promise.resolve({ value: queue.shift(), done: false });
+                    }
+                    if (isDone) {
+                        return Promise.resolve({
+                            value: undefined,
+                            done: true,
+                        });
+                    }
+                    return new Promise((resolve) => waiters.push(resolve));
+                },
+            };
+        },
+    };
+    return stream;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "pi-freerouter",
+  "version": "0.1.0",
+  "description": "Pi coding agent extension — auto-routes to free OpenRouter models",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "tsc && node --test dist/**/*.test.js"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "latest",
+    "typescript": "^5.0.0"
+  },
+  "keywords": ["pi", "pi-coding-agent", "openrouter"],
+  "license": "MIT"
+}