@a3s-lab/code 0.3.1 → 0.4.0

package/dist/message.js

@@ -0,0 +1,279 @@
+/**
+ * UIMessage / ModelMessage Conversion Layer
+ *
+ * Vercel AI SDK-style message types for frontend ↔ backend conversion.
+ *
+ * - UIMessage: Frontend format with id, createdAt, parts (for rendering)
+ * - ModelMessage: Backend format with role, content (for LLM)
+ *
+ * @example
+ * ```typescript
+ * import { convertToModelMessages, convertToUIMessages } from '@a3s-lab/code';
+ *
+ * // Frontend → Backend (before calling generateText/streamText)
+ * const modelMessages = convertToModelMessages(uiMessages);
+ * const { text } = await generateText({ model, messages: modelMessages });
+ *
+ * // Backend → Frontend (after receiving response)
+ * const uiMessages = convertToUIMessages(modelMessages);
+ * ```
+ */
+// ============================================================================
+// Conversion: UIMessage → ModelMessage
+// ============================================================================
+/**
+ * Convert a single UIMessage to one or more ModelMessages.
+ *
+ * A single UIMessage may produce multiple ModelMessages when it contains
+ * tool invocations (assistant message + tool result messages).
+ */
+function uiMessageToModelMessages(uiMessage) {
+    const messages = [];
+    if (uiMessage.role === 'system') {
+        messages.push({ role: 'system', content: uiMessage.content });
+        return messages;
+    }
+    if (uiMessage.role === 'user') {
+        // Extract text from parts, fall back to content
+        const text = uiMessage.parts
+            .filter((p) => p.type === 'text')
+            .map(p => p.text)
+            .join('\n') || uiMessage.content;
+        messages.push({ role: 'user', content: text });
+        return messages;
+    }
+    // Assistant message — may contain text + tool invocations
+    if (uiMessage.role === 'assistant') {
+        const textParts = uiMessage.parts.filter((p) => p.type === 'text');
+        const toolParts = uiMessage.parts.filter((p) => p.type === 'tool-invocation');
+        const text = textParts.map(p => p.text).join('\n') || uiMessage.content;
+        // Build tool calls from tool invocation parts
+        const toolCalls = toolParts
+            .filter(p => p.toolInvocation.state === 'call' || p.toolInvocation.state === 'result')
+            .map(p => ({
+            id: p.toolInvocation.toolCallId,
+            name: p.toolInvocation.toolName,
+            arguments: JSON.stringify(p.toolInvocation.args),
+            result: p.toolInvocation.state === 'result' && p.toolInvocation.result
+                ? {
+                    success: true,
+                    output: typeof p.toolInvocation.result === 'string'
+                        ? p.toolInvocation.result
+                        : JSON.stringify(p.toolInvocation.result),
+                    error: '',
+                    metadata: {},
+                }
+                : undefined,
+        }));
+        const assistantMsg = {
+            role: 'assistant',
+            content: text,
+        };
+        if (toolCalls.length > 0) {
+            assistantMsg.toolCalls = toolCalls;
+        }
+        messages.push(assistantMsg);
+        // Add tool result messages for completed invocations
+        for (const tp of toolParts) {
+            if (tp.toolInvocation.state === 'result' && tp.toolInvocation.result !== undefined) {
+                messages.push({
+                    role: 'tool',
+                    content: typeof tp.toolInvocation.result === 'string'
+                        ? tp.toolInvocation.result
+                        : JSON.stringify(tp.toolInvocation.result),
+                    toolCallId: tp.toolInvocation.toolCallId,
+                    toolName: tp.toolInvocation.toolName,
+                });
+            }
+        }
+    }
+    return messages;
+}
+/**
+ * Convert UIMessage[] to ModelMessage[] for use with generateText/streamText.
+ *
+ * This is the primary conversion function for frontend → backend message flow.
+ *
+ * @example
+ * ```typescript
+ * import { convertToModelMessages, generateText } from '@a3s-lab/code';
+ *
+ * // In your API route handler:
+ * const modelMessages = convertToModelMessages(uiMessages);
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   messages: modelMessages,
+ * });
+ * ```
+ */
+export function convertToModelMessages(uiMessages) {
+    return uiMessages.flatMap(uiMessageToModelMessages);
+}
+// ============================================================================
+// Conversion: ModelMessage → UIMessage
+// ============================================================================
+let _idCounter = 0;
+function generateId() {
+    return `msg-${Date.now()}-${++_idCounter}`;
+}
+/**
+ * Convert ModelMessage[] to UIMessage[] for frontend rendering.
+ *
+ * Groups assistant messages with their tool results into single UIMessages
+ * with structured parts.
+ *
+ * @example
+ * ```typescript
+ * import { convertToUIMessages } from '@a3s-lab/code';
+ *
+ * const uiMessages = convertToUIMessages(response.messages);
+ * // Render uiMessages in your chat UI
+ * ```
+ */
+export function convertToUIMessages(modelMessages) {
+    const uiMessages = [];
+    let i = 0;
+    while (i < modelMessages.length) {
+        const msg = modelMessages[i];
+        if (msg.role === 'system') {
+            uiMessages.push({
+                id: generateId(),
+                role: 'system',
+                content: msg.content,
+                parts: [{ type: 'text', text: msg.content }],
+                createdAt: new Date(),
+            });
+            i++;
+            continue;
+        }
+        if (msg.role === 'user') {
+            uiMessages.push({
+                id: generateId(),
+                role: 'user',
+                content: msg.content,
+                parts: [{ type: 'text', text: msg.content }],
+                createdAt: new Date(),
+            });
+            i++;
+            continue;
+        }
+        if (msg.role === 'assistant') {
+            const parts = [];
+            // Add text part
+            if (msg.content) {
+                parts.push({ type: 'text', text: msg.content });
+            }
+            // Add tool invocation parts
+            if (msg.toolCalls) {
+                for (const tc of msg.toolCalls) {
+                    const args = tc.arguments ? JSON.parse(tc.arguments) : {};
+                    // Look ahead for matching tool result
+                    let result = undefined;
+                    let state = 'call';
+                    for (let j = i + 1; j < modelMessages.length; j++) {
+                        const next = modelMessages[j];
+                        if (next.role === 'tool' && next.toolCallId === tc.id) {
+                            try {
+                                result = JSON.parse(next.content);
+                            }
+                            catch {
+                                result = next.content;
+                            }
+                            state = 'result';
+                            break;
+                        }
+                        if (next.role !== 'tool')
+                            break;
+                    }
+                    parts.push({
+                        type: 'tool-invocation',
+                        toolInvocation: {
+                            toolCallId: tc.id,
+                            toolName: tc.name,
+                            args,
+                            state,
+                            result,
+                        },
+                    });
+                }
+            }
+            uiMessages.push({
+                id: generateId(),
+                role: 'assistant',
+                content: msg.content,
+                parts,
+                createdAt: new Date(),
+            });
+            i++;
+            // Skip consumed tool result messages
+            while (i < modelMessages.length && modelMessages[i].role === 'tool') {
+                i++;
+            }
+            continue;
+        }
+        // Standalone tool message (shouldn't happen normally, but handle gracefully)
+        if (msg.role === 'tool') {
+            i++;
+            continue;
+        }
+        i++;
+    }
+    return uiMessages;
+}
+// ============================================================================
+// Conversion: A3S Message ↔ ModelMessage
+// ============================================================================
+/**
+ * Convert A3S Message to ModelMessage.
+ */
+export function a3sMessageToModel(msg) {
+    switch (msg.role) {
+        case 'system':
+            return { role: 'system', content: msg.content };
+        case 'user':
+            return { role: 'user', content: msg.content };
+        case 'assistant':
+            return { role: 'assistant', content: msg.content };
+        case 'tool':
+            return { role: 'tool', content: msg.content };
+        default:
+            return { role: 'user', content: msg.content };
+    }
+}
+/**
+ * Convert ModelMessage to A3S Message.
+ */
+export function modelMessageToA3s(msg) {
+    return {
+        role: msg.role,
+        content: msg.content,
+    };
+}
+/**
+ * Convert A3S Message[] to ModelMessage[].
+ */
+export function a3sMessagesToModel(messages) {
+    return messages.map(a3sMessageToModel);
+}
+/**
+ * Convert ModelMessage[] to A3S Message[].
+ */
+export function modelMessagesToA3s(messages) {
+    return messages.map(modelMessageToA3s);
+}
+// ============================================================================
+// Conversion: A3S Message ↔ UIMessage (shorthand)
+// ============================================================================
+/**
+ * Convert A3S Message[] to UIMessage[] (shorthand for a3sMessagesToModel + convertToUIMessages).
+ */
+export function a3sMessagesToUI(messages) {
+    return convertToUIMessages(a3sMessagesToModel(messages));
+}
+/**
+ * Convert UIMessage[] to A3S Message[] (shorthand for convertToModelMessages + modelMessagesToA3s).
+ */
+export function uiMessagesToA3s(uiMessages) {
+    return modelMessagesToA3s(convertToModelMessages(uiMessages));
+}
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

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

package/dist/provider.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Provider Factory
+ *
+ * Vercel AI SDK-style provider abstraction for A3S Code.
+ *
+ * @example
+ * ```typescript
+ * import { createProvider } from '@a3s-lab/code';
+ *
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ * const kimi = createProvider({ name: 'kimi', apiKey: 'sk-xxx', baseUrl: 'http://xxx/v1' });
+ *
+ * // Use as model selector
+ * const model = openai('gpt-4o');
+ * const model2 = kimi('k2.5');
+ * ```
+ */
+import type { LLMConfig } from './client.js';
+/**
+ * Provider configuration
+ */
+export interface ProviderOptions {
+    /** Provider name (e.g., 'openai', 'anthropic', 'kimi') */
+    name: string;
+    /** API key */
+    apiKey: string;
+    /** Base URL override */
+    baseUrl?: string;
+}
+/**
+ * Model reference — a resolved provider + model pair
+ */
+export interface ModelRef {
+    provider: string;
+    model: string;
+    apiKey: string;
+    baseUrl?: string;
+}
+/**
+ * Model selector function returned by createProvider()
+ */
+export type ModelSelector = (modelId: string) => ModelRef;
+/**
+ * Create a provider factory that returns model references.
+ *
+ * @example
+ * ```typescript
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ * const model = openai('gpt-4o');
+ * ```
+ */
+export declare function createProvider(options: ProviderOptions): ModelSelector;
+/**
+ * Shorthand: create a provider and select a model in one call.
+ *
+ * @example
+ * ```typescript
+ * const model = model({ provider: 'openai', model: 'gpt-4o', apiKey: 'sk-xxx' });
+ * ```
+ */
+export declare function model(config: LLMConfig): ModelRef;
+/** Convert ModelRef to LLMConfig for the underlying client */
+export declare function modelRefToLLMConfig(ref: ModelRef): LLMConfig;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../ts/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,QAAQ,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAOtE;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAOjD;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,CAO5D"}

package/dist/provider.js

@@ -0,0 +1,60 @@
+/**
+ * Provider Factory
+ *
+ * Vercel AI SDK-style provider abstraction for A3S Code.
+ *
+ * @example
+ * ```typescript
+ * import { createProvider } from '@a3s-lab/code';
+ *
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ * const kimi = createProvider({ name: 'kimi', apiKey: 'sk-xxx', baseUrl: 'http://xxx/v1' });
+ *
+ * // Use as model selector
+ * const model = openai('gpt-4o');
+ * const model2 = kimi('k2.5');
+ * ```
+ */
+/**
+ * Create a provider factory that returns model references.
+ *
+ * @example
+ * ```typescript
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ * const model = openai('gpt-4o');
+ * ```
+ */
+export function createProvider(options) {
+    return (modelId) => ({
+        provider: options.name,
+        model: modelId,
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+    });
+}
+/**
+ * Shorthand: create a provider and select a model in one call.
+ *
+ * @example
+ * ```typescript
+ * const model = model({ provider: 'openai', model: 'gpt-4o', apiKey: 'sk-xxx' });
+ * ```
+ */
+export function model(config) {
+    return {
+        provider: config.provider,
+        model: config.model,
+        apiKey: config.apiKey || '',
+        baseUrl: config.baseUrl,
+    };
+}
+/** Convert ModelRef to LLMConfig for the underlying client */
+export function modelRefToLLMConfig(ref) {
+    return {
+        provider: ref.provider,
+        model: ref.model,
+        apiKey: ref.apiKey,
+        baseUrl: ref.baseUrl,
+    };
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../ts/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA+BH;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IACrD,OAAO,CAAC,OAAe,EAAY,EAAE,CAAC,CAAC;QACrC,QAAQ,EAAE,OAAO,CAAC,IAAI;QACtB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,MAAiB;IACrC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,mBAAmB,CAAC,GAAa;IAC/C,OAAO;QACL,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC"}