@edwardlee5423/magi 0.1.0-alpha.0

package/dist/providers/ir.d.ts

@@ -0,0 +1,84 @@
+export type MagiMessageRole = "system" | "user" | "assistant" | "tool";
+export interface MagiTextPart {
+    type: "text";
+    text: string;
+}
+export interface MagiToolResultPart {
+    type: "tool-result";
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+    retryable?: boolean;
+}
+export interface MagiToolUsePart {
+    type: "tool-use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * An image attached to a message. Base64-encoded data with a MIME type
+ * (image/png, image/jpeg, image/gif, image/webp). Each provider adapter
+ * is responsible for translating into its own representation.
+ */
+export interface MagiImagePart {
+    type: "image";
+    mimeType: string;
+    /** Base64-encoded image bytes (without the data: URL prefix). */
+    data: string;
+}
+export type MagiContentPart = MagiTextPart | MagiToolResultPart | MagiToolUsePart | MagiImagePart;
+export interface MagiMessage {
+    role: MagiMessageRole;
+    content: MagiContentPart[];
+}
+export interface MagiToolDefinition {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface ProviderRequest {
+    model: string;
+    messages: MagiMessage[];
+    tools?: MagiToolDefinition[];
+    temperature?: number;
+    maxOutputTokens?: number;
+    signal?: AbortSignal;
+}
+export interface ProviderUsage {
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface ProviderResponse {
+    text: string;
+    toolUses?: MagiToolUsePart[];
+    usage?: ProviderUsage;
+    raw?: unknown;
+}
+export type ProviderStreamEvent = {
+    type: "text-delta";
+    text: string;
+} | {
+    type: "usage";
+    usage: ProviderUsage;
+} | {
+    type: "done";
+};
+export interface ProviderAdapter {
+    readonly name: string;
+    complete(request: ProviderRequest): Promise<ProviderResponse>;
+    stream?(request: ProviderRequest): AsyncGenerator<ProviderStreamEvent, ProviderResponse>;
+}
+export declare function textMessage(role: MagiMessageRole, text: string): MagiMessage;
+export declare function messageText(message: MagiMessage): string;
+export declare function encodePromptWithImages(prompt: string, images: Array<{
+    mimeType: string;
+    data: string;
+}>): string;
+/**
+ * Parse a prompt string that may contain encoded image blocks and return
+ * a list of MagiContentParts (text and image). Used by the agent loop to
+ * convert string prompts (which is the channel everywhere) back into
+ * structured messages for vision-capable providers.
+ */
+export declare function parsePromptIntoParts(prompt: string): MagiContentPart[];

package/dist/providers/ir.js

@@ -0,0 +1,76 @@
+export function textMessage(role, text) {
+    return {
+        role,
+        content: [{ type: "text", text }]
+    };
+}
+export function messageText(message) {
+    return message.content
+        .map((part) => {
+        if (part.type === "text") {
+            return part.text;
+        }
+        if (part.type === "tool-use") {
+            return JSON.stringify({ id: part.id, name: part.name, input: part.input });
+        }
+        if (part.type === "image") {
+            return `[image ${part.mimeType}]`;
+        }
+        return part.content;
+    })
+        .join("");
+}
+/**
+ * Magic prefix for encoding images in a string-only prompt channel.
+ * Format: <IMAGE_PREFIX>mimeType|base64data<IMAGE_SUFFIX>
+ * Multiple images may be concatenated. Anything else is text.
+ */
+const IMAGE_PREFIX = "<<MAGI_IMAGE:";
+const IMAGE_SUFFIX = ":MAGI_IMAGE>>";
+export function encodePromptWithImages(prompt, images) {
+    if (images.length === 0)
+        return prompt;
+    const blocks = images.map(img => `${IMAGE_PREFIX}${img.mimeType}|${img.data}${IMAGE_SUFFIX}`);
+    return blocks.join("") + prompt;
+}
+/**
+ * Parse a prompt string that may contain encoded image blocks and return
+ * a list of MagiContentParts (text and image). Used by the agent loop to
+ * convert string prompts (which is the channel everywhere) back into
+ * structured messages for vision-capable providers.
+ */
+export function parsePromptIntoParts(prompt) {
+    const parts = [];
+    let cursor = 0;
+    while (cursor < prompt.length) {
+        const startIdx = prompt.indexOf(IMAGE_PREFIX, cursor);
+        if (startIdx === -1) {
+            const remaining = prompt.slice(cursor);
+            if (remaining.length > 0)
+                parts.push({ type: "text", text: remaining });
+            break;
+        }
+        if (startIdx > cursor) {
+            parts.push({ type: "text", text: prompt.slice(cursor, startIdx) });
+        }
+        const endIdx = prompt.indexOf(IMAGE_SUFFIX, startIdx + IMAGE_PREFIX.length);
+        if (endIdx === -1) {
+            // Malformed — treat the rest as text
+            parts.push({ type: "text", text: prompt.slice(startIdx) });
+            break;
+        }
+        const body = prompt.slice(startIdx + IMAGE_PREFIX.length, endIdx);
+        const sep = body.indexOf("|");
+        if (sep > 0) {
+            const mimeType = body.slice(0, sep);
+            const data = body.slice(sep + 1);
+            parts.push({ type: "image", mimeType, data });
+        }
+        cursor = endIdx + IMAGE_SUFFIX.length;
+    }
+    if (parts.length === 0) {
+        parts.push({ type: "text", text: prompt });
+    }
+    return parts;
+}
+//# sourceMappingURL=ir.js.map

package/dist/providers/ir.js.map

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

package/dist/providers/messages-compatible.d.ts

@@ -0,0 +1,19 @@
+import { ProviderConfig } from "../config.js";
+import { FetchLike } from "./http.js";
+import { ProviderAdapter, ProviderRequest, ProviderResponse, ProviderStreamEvent } from "./ir.js";
+export declare class MessagesCompatibleAdapter implements ProviderAdapter {
+    readonly name: string;
+    private readonly config;
+    private readonly env;
+    private readonly fetchImpl;
+    constructor(input: {
+        name: string;
+        config: ProviderConfig;
+        env?: NodeJS.ProcessEnv;
+        fetchImpl?: FetchLike;
+    });
+    complete(request: ProviderRequest): Promise<ProviderResponse>;
+    stream(request: ProviderRequest): AsyncGenerator<ProviderStreamEvent, ProviderResponse>;
+    private completeAnthropicMessages;
+    private streamAnthropicMessages;
+}