@a3s-lab/code 0.5.0 → 0.7.0

package/dist/chat.d.ts

@@ -1,97 +0,0 @@
-/**
- * Chat — Multi-turn Conversation (Convenience Wrapper)
- *
- * A thin wrapper around Session for backward compatibility.
- * For new code, prefer using Session directly:
- *
- * ```typescript
- * const session = await client.createSession({ model: openai('gpt-4o') });
- * const { text } = await session.generateText({ prompt: 'Hello' });
- * const { text: reply } = await session.generateText({ prompt: 'Follow up' });
- * ```
- *
- * @example
- * ```typescript
- * import { createChat, createProvider, tool } from '@a3s-lab/code';
- *
- * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
- *
- * const chat = createChat({
- *   model: openai('gpt-4o'),
- *   workspace: '/project',
- *   system: 'You are a helpful code assistant',
- * });
- *
- * const { text } = await chat.send('Hello');
- * const { textStream } = chat.stream('Follow up');
- * for await (const chunk of textStream) {
- *   process.stdout.write(chunk);
- * }
- * await chat.close();
- * ```
- */
-import type { A3sClientOptions, ContextUsage } from './client.js';
-import type { ModelRef } from './provider.js';
-import type { ToolSet } from './tool.js';
-import type { MessageInput, StepResult, ToolCallEvent } from './session.js';
-/** Options for creating a chat */
-export interface ChatOptions {
-    /** Model reference from createProvider() */
-    model: ModelRef;
-    /** Working directory for tool sandboxing */
-    workspace?: string;
-    /** System prompt */
-    system?: string;
-    /** gRPC server connection options */
-    server?: A3sClientOptions;
-    /** Client-side tool definitions */
-    tools?: ToolSet;
-    /** Maximum steps per send/stream call. @default 1 */
-    maxSteps?: number;
-    /** Called when each step completes */
-    onStepFinish?: (step: StepResult) => void | Promise<void>;
-    /** Called when the model invokes a tool */
-    onToolCall?: (event: ToolCallEvent) => void | unknown | Promise<void | unknown>;
-}
-/** Result from chat.send() */
-export interface ChatSendResult {
-    text: string;
-    usage?: any;
-    finishReason: any;
-    toolCalls: any[];
-    steps: StepResult[];
-}
-/** Result from chat.stream() */
-export interface ChatStreamResult {
-    textStream: AsyncIterable<string>;
-    fullStream: AsyncIterable<any>;
-    toolStream: AsyncIterable<any>;
-    text: Promise<string>;
-    steps: Promise<StepResult[]>;
-}
-/** Chat instance for multi-turn conversations */
-export interface Chat {
-    /** Send a message and get a complete response */
-    send(prompt: string): Promise<ChatSendResult>;
-    send(messages: MessageInput[]): Promise<ChatSendResult>;
-    /** Send a message and stream the response */
-    stream(prompt: string): ChatStreamResult;
-    stream(messages: MessageInput[]): ChatStreamResult;
-    /** Get context usage for this chat session */
-    getUsage(): Promise<ContextUsage | undefined>;
-    /** Compact the conversation context */
-    compact(): Promise<void>;
-    /** Clear conversation history */
-    clear(): Promise<void>;
-    /** Get the underlying session ID */
-    readonly sessionId: string;
-    /** Close the chat and clean up resources */
-    close(): Promise<void>;
-}
-/**
- * Create a multi-turn chat session (convenience wrapper).
- *
- * For new code, prefer `client.createSession()` directly.
- */
-export declare function createChat(options: ChatOptions): Chat;
-//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../ts/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,cAAc,CAAC;AAMtB,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,KAAK,EAAE,QAAQ,CAAC;IAChB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,mCAAmC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,2CAA2C;IAC3C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC;CACjF;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,YAAY,EAAE,GAAG,CAAC;IAClB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClC,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,IAAI;IACnB,iDAAiD;IACjD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAExD,6CAA6C;IAC7C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACzC,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC;IAEnD,8CAA8C;IAC9C,QAAQ,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAE9C,uCAAuC;IACvC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAuJrD"}

package/dist/chat.js

@@ -1,179 +0,0 @@
-/**
- * Chat — Multi-turn Conversation (Convenience Wrapper)
- *
- * A thin wrapper around Session for backward compatibility.
- * For new code, prefer using Session directly:
- *
- * ```typescript
- * const session = await client.createSession({ model: openai('gpt-4o') });
- * const { text } = await session.generateText({ prompt: 'Hello' });
- * const { text: reply } = await session.generateText({ prompt: 'Follow up' });
- * ```
- *
- * @example
- * ```typescript
- * import { createChat, createProvider, tool } from '@a3s-lab/code';
- *
- * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
- *
- * const chat = createChat({
- *   model: openai('gpt-4o'),
- *   workspace: '/project',
- *   system: 'You are a helpful code assistant',
- * });
- *
- * const { text } = await chat.send('Hello');
- * const { textStream } = chat.stream('Follow up');
- * for await (const chunk of textStream) {
- *   process.stdout.write(chunk);
- * }
- * await chat.close();
- * ```
- */
-import { A3sClient } from './client.js';
-// ============================================================================
-// Implementation
-// ============================================================================
-/**
- * Create a multi-turn chat session (convenience wrapper).
- *
- * For new code, prefer `client.createSession()` directly.
- */
-export function createChat(options) {
-    const client = new A3sClient(options.server);
-    let session = null;
-    let initPromise = null;
-    async function ensureSession() {
-        if (session)
-            return session;
-        if (!initPromise) {
-            initPromise = (async () => {
-                session = await client.createSession({
-                    model: options.model,
-                    workspace: options.workspace,
-                    system: options.system,
-                });
-            })();
-        }
-        await initPromise;
-        return session;
-    }
-    function toMessages(input) {
-        if (typeof input === 'string') {
-            return [{ role: 'user', content: input }];
-        }
-        return input;
-    }
-    const chat = {
-        get sessionId() {
-            return session?.id ?? '';
-        },
-        async send(input) {
-            const s = await ensureSession();
-            return s.generateText({
-                messages: toMessages(input),
-                tools: options.tools,
-                maxSteps: options.maxSteps,
-                onStepFinish: options.onStepFinish,
-                onToolCall: options.onToolCall,
-            });
-        },
-        stream(input) {
-            // We need the session to exist before streaming
-            // Use a deferred pattern to handle the async init
-            let resolveText;
-            let rejectAll;
-            let resolveSteps;
-            const textPromise = new Promise((res, rej) => {
-                resolveText = res;
-                rejectAll = rej;
-            });
-            const stepsPromise = new Promise((res) => {
-                resolveSteps = res;
-            });
-            const chunks = [];
-            let done = false;
-            const waiters = [];
-            function notify() {
-                for (const w of waiters.splice(0))
-                    w();
-            }
-            const produce = (async () => {
-                try {
-                    const s = await ensureSession();
-                    const result = s.streamText({
-                        messages: toMessages(input),
-                        tools: options.tools,
-                        maxSteps: options.maxSteps,
-                        onStepFinish: options.onStepFinish,
-                        onToolCall: options.onToolCall,
-                    });
-                    for await (const chunk of result.fullStream) {
-                        chunks.push(chunk);
-                        notify();
-                    }
-                    resolveText(await result.text);
-                    resolveSteps(await result.steps);
-                }
-                catch (err) {
-                    rejectAll(err);
-                }
-                finally {
-                    done = true;
-                    notify();
-                }
-            })();
-            produce.catch(() => { });
-            function iterate(transform) {
-                return {
-                    [Symbol.asyncIterator]() {
-                        let i = 0;
-                        return {
-                            async next() {
-                                while (true) {
-                                    if (i < chunks.length) {
-                                        const v = transform(chunks[i++]);
-                                        if (v !== null)
-                                            return { value: v, done: false };
-                                        continue;
-                                    }
-                                    if (done) {
-                                        return { value: undefined, done: true };
-                                    }
-                                    await new Promise((r) => waiters.push(r));
-                                }
-                            },
-                        };
-                    },
-                };
-            }
-            return {
-                textStream: iterate((c) => (c.content ? c.content : null)),
-                fullStream: iterate((c) => c),
-                toolStream: iterate((c) => (c.toolCall ? c.toolCall : null)),
-                text: textPromise,
-                steps: stepsPromise,
-            };
-        },
-        async getUsage() {
-            const s = await ensureSession();
-            return s.getContextUsage();
-        },
-        async compact() {
-            const s = await ensureSession();
-            await s.compactContext();
-        },
-        async clear() {
-            const s = await ensureSession();
-            await s.clearContext();
-        },
-        async close() {
-            if (session) {
-                await session.close();
-            }
-            client.close();
-        },
-    };
-    return chat;
-}
-//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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