@a3s-lab/code 0.3.1 → 0.4.0

package/dist/chat.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,179 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../ts/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA+ExC,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAmB,IAAI,CAAC;IACnC,IAAI,WAAW,GAAyB,IAAI,CAAC;IAE7C,KAAK,UAAU,aAAa;QAC1B,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAC5B,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;gBACxB,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;oBACnC,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC,CAAC;YACL,CAAC,CAAC,EAAE,CAAC;QACP,CAAC;QACD,MAAM,WAAW,CAAC;QAClB,OAAO,OAAQ,CAAC;IAClB,CAAC;IAED,SAAS,UAAU,CAAC,KAA8B;QAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,IAAI,GAAS;QACjB,IAAI,SAAS;YACX,OAAO,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAA8B;YACvC,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;YAChC,OAAO,CAAC,CAAC,YAAY,CAAC;gBACpB,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;gBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,KAA8B;YACnC,gDAAgD;YAChD,kDAAkD;YAClD,IAAI,WAAgC,CAAC;YACrC,IAAI,SAA+B,CAAC;YACpC,IAAI,YAAuC,CAAC;YAE5C,MAAM,WAAW,GAAG,IAAI,OAAO,CAAS,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACnD,WAAW,GAAG,GAAG,CAAC;gBAClB,SAAS,GAAG,GAAG,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,OAAO,CAAe,CAAC,GAAG,EAAE,EAAE;gBACrD,YAAY,GAAG,GAAG,CAAC;YACrB,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAU,EAAE,CAAC;YACzB,IAAI,IAAI,GAAG,KAAK,CAAC;YACjB,MAAM,OAAO,GAAsB,EAAE,CAAC;YAEtC,SAAS,MAAM;gBACb,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;oBAAE,CAAC,EAAE,CAAC;YACzC,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;gBAC1B,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;oBAChC,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC;wBAC1B,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;wBAC3B,KAAK,EAAE,OAAO,CAAC,KAAK;wBACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;wBAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;wBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;qBAC/B,CAAC,CAAC;oBAEH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;wBAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACnB,MAAM,EAAE,CAAC;oBACX,CAAC;oBAED,WAAY,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;oBAChC,YAAa,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,SAAU,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC;wBAAS,CAAC;oBACT,IAAI,GAAG,IAAI,CAAC;oBACZ,MAAM,EAAE,CAAC;gBACX,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAExB,SAAS,OAAO,CACd,SAA+B;gBAE/B,OAAO;oBACL,CAAC,MAAM,CAAC,aAAa,CAAC;wBACpB,IAAI,CAAC,GAAG,CAAC,CAAC;wBACV,OAAO;4BACL,KAAK,CAAC,IAAI;gCACR,OAAO,IAAI,EAAE,CAAC;oCACZ,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;wCACtB,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;wCACjC,IAAI,CAAC,KAAK,IAAI;4CAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;wCACjD,SAAS;oCACX,CAAC;oCACD,IAAI,IAAI,EAAE,CAAC;wCACT,OAAO,EAAE,KAAK,EAAE,SAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;oCAC/C,CAAC;oCACD,MAAM,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gCAClD,CAAC;4BACH,CAAC;yBACF,CAAC;oBACJ,CAAC;iBACF,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC1D,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;gBAC7B,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC5D,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,YAAY;aACpB,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,QAAQ;YACZ,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;YAChC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;YAChC,MAAM,CAAC,CAAC,cAAc,EAAE,CAAC;QAC3B,CAAC;QAED,KAAK,CAAC,KAAK;YACT,MAAM,CAAC,GAAG,MAAM,aAAa,EAAE,CAAC;YAChC,MAAM,CAAC,CAAC,YAAY,EAAE,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,KAAK;YACT,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACxB,CAAC;YACD,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/client.d.ts

@@ -4,6 +4,8 @@
  * Full implementation of the CodeAgentService interface.
  */
 import { type OpenAIMessage, type OpenAIChatCompletion, type OpenAIChatCompletionChunk } from './openai-compat.js';
+import { Session as CodeSession } from './session.js';
+import type { SessionCreateOptions } from './session.js';
 export type HealthStatus = 'STATUS_UNKNOWN' | 'STATUS_HEALTHY' | 'STATUS_DEGRADED' | 'STATUS_UNHEALTHY';
 export type SessionState = 'SESSION_STATE_UNKNOWN' | 'SESSION_STATE_ACTIVE' | 'SESSION_STATE_PAUSED' | 'SESSION_STATE_COMPLETED' | 'SESSION_STATE_ERROR';
 export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
@@ -114,7 +116,7 @@ export interface ContextUsage {
     completionTokens: number;
     messageCount: number;
 }
-export interface Session {
+export interface SessionInfo {
     sessionId: string;
     config?: SessionConfig;
     state: SessionState;
@@ -122,21 +124,23 @@ export interface Session {
     createdAt: number;
     updatedAt: number;
 }
+/** @deprecated Use SessionInfo instead */
+export type Session = SessionInfo;
 export interface CreateSessionResponse {
     sessionId: string;
-    session?: Session;
+    session?: SessionInfo;
 }
 export interface DestroySessionResponse {
     success: boolean;
 }
 export interface ListSessionsResponse {
-    sessions: Session[];
+    sessions: SessionInfo[];
 }
 export interface GetSessionResponse {
-    session?: Session;
+    session?: SessionInfo;
 }
 export interface ConfigureSessionResponse {
-    session?: Session;
+    session?: SessionInfo;
 }
 export interface Message {
     role: MessageRole;
@@ -221,29 +225,22 @@ export interface GenerateStructuredChunk {
 export interface Skill {
     name: string;
     description: string;
-    tools: string[];
+    allowedTools?: string;
+    disableModelInvocation: boolean;
+    content: string;
     metadata: Record<string, string>;
 }
 export interface LoadSkillResponse {
     success: boolean;
-    toolNames: string[];
 }
 export interface UnloadSkillResponse {
     success: boolean;
-    removedTools: string[];
 }
 export interface ListSkillsResponse {
     skills: Skill[];
 }
-export interface ClaudeCodeSkill {
-    name: string;
-    description: string;
-    allowedTools?: string;
-    disableModelInvocation: boolean;
-    content: string;
-}
-export interface GetClaudeCodeSkillsResponse {
-    skills: ClaudeCodeSkill[];
+export interface GetSkillResponse {
+    skills: Skill[];
 }
 export interface GetContextUsageResponse {
     usage?: ContextUsage;
@@ -693,6 +690,118 @@ export interface ParseCronScheduleResponse {
     description: string;
     error: string;
 }
+export interface ToolStats {
+    toolName: string;
+    callCount: number;
+    successCount: number;
+    failureCount: number;
+    totalDurationMs: number;
+    avgDurationMs: number;
+    minDurationMs: number;
+    maxDurationMs: number;
+}
+export interface GetToolMetricsResponse {
+    tools: ToolStats[];
+    totalCalls: number;
+    totalDurationMs: number;
+}
+export interface ModelCostBreakdown {
+    model: string;
+    costUsd: number;
+    promptTokens: number;
+    completionTokens: number;
+    callCount: number;
+}
+export interface DayCostBreakdown {
+    date: string;
+    costUsd: number;
+    callCount: number;
+}
+export interface GetCostSummaryResponse {
+    totalCostUsd: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    totalTokens: number;
+    callCount: number;
+    byModel: ModelCostBreakdown[];
+    byDay: DayCostBreakdown[];
+}
+export type AgenticStrategyType = 'AGENTIC_STRATEGY_AUTO' | 'AGENTIC_STRATEGY_DIRECT' | 'AGENTIC_STRATEGY_PLANNED' | 'AGENTIC_STRATEGY_ITERATIVE' | 'AGENTIC_STRATEGY_PARALLEL';
+export interface AgenticStep {
+    stepIndex: number;
+    text: string;
+    toolCalls: ToolCall[];
+    toolResults: ToolResult[];
+    usage?: Usage;
+    finishReason?: string;
+}
+export interface AgenticGenerateResponse {
+    sessionId: string;
+    text: string;
+    steps: AgenticStep[];
+    toolCalls: ToolCall[];
+    usage?: Usage;
+    finishReason: string;
+    plan?: ExecutionPlan;
+}
+export interface AgenticGenerateEvent {
+    type: string;
+    sessionId: string;
+    content?: string;
+    toolCall?: ToolCall;
+    toolResult?: ToolResult;
+    toolCallId?: string;
+    stepIndex?: number;
+    stepText?: string;
+    plan?: ExecutionPlan;
+    confidence?: number;
+    shouldRetry?: boolean;
+    insight?: string;
+    confirmationId?: string;
+    toolName?: string;
+    toolArgs?: string;
+    timeoutMs?: number;
+    approved?: boolean;
+    agentName?: string;
+    agentTask?: string;
+    agentSessionId?: string;
+    agentResult?: string;
+    beforeTokens?: number;
+    afterTokens?: number;
+    externalTask?: ExternalTask;
+    errorMessage?: string;
+    recoverable?: boolean;
+    finishReason?: string;
+    usage?: Usage;
+}
+export interface DelegateResponse {
+    sessionId: string;
+    agentSessionId: string;
+    text: string;
+    steps: AgenticStep[];
+    toolCalls: ToolCall[];
+    usage?: Usage;
+    finishReason: string;
+}
+export interface ProtoLaneStats {
+    pending: number;
+    active: number;
+    external: number;
+    completed: number;
+    failed: number;
+}
+export interface GetQueueStatsResponse {
+    control?: ProtoLaneStats;
+    query?: ProtoLaneStats;
+    execute?: ProtoLaneStats;
+    generate?: ProtoLaneStats;
+    deadLetters: number;
+}
+export interface LoadSkillsFromDirResponse {
+    success: boolean;
+    loadedSkills: string[];
+    errors: string[];
+}
 export interface A3sClientOptions {
     /** gRPC server address (default: localhost:4088) */
     address?: string;
@@ -759,12 +868,28 @@ export declare class A3sClient {
     /**
      * Create a new session.
      *
-     * @param config - Session configuration. The `workspace` field controls
-     *   per-session tool sandboxing: each session gets its own ToolContext
-     *   scoped to the given workspace directory. If omitted or empty, the
-     *   server falls back to its default workspace.
-     * @param sessionId - Optional session ID. If omitted, the server generates one.
-     * @param initialContext - Optional messages to seed the session context.
+     * Accepts either high-level options (with `model` from createProvider) or
+     * low-level SessionConfig. Returns a Session object with send(),
+     * sendStream(), generateText(), streamText(), etc.
+     *
+     * @example
+     * ```typescript
+     * // High-level (recommended)
+     * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+     * await using session = await client.createSession({
+     *   model: openai('gpt-4o'),
+     *   workspace: '/project',
+     *   system: 'You are a helpful assistant',
+     *   confirmation: { requireConfirmation: ['Bash', 'Write'] },
+     *   lanes: { execute: { mode: 'external', timeout: 120_000 } },
+     * });
+     * const { text } = await session.send('Refactor the auth module');
+     * ```
+     */
+    createSession(options: SessionCreateOptions): Promise<CodeSession>;
+    /**
+     * Create a new session (low-level).
+     * @deprecated Use the high-level overload with `model` instead.
      */
     createSession(config?: SessionConfig, sessionId?: string, initialContext?: Message[]): Promise<CreateSessionResponse>;
     /**
@@ -860,9 +985,9 @@ export declare class A3sClient {
      */
     listSkills(sessionId?: string): Promise<ListSkillsResponse>;
     /**
-     * Get Claude Code skills
+     * Get skills by name or all skills
      */
-    getClaudeCodeSkills(name?: string): Promise<GetClaudeCodeSkillsResponse>;
+    getSkill(name?: string): Promise<GetSkillResponse>;
     /**
      * Get context usage for a session
      */
@@ -1116,6 +1241,55 @@ export declare class A3sClient {
      * @param input Natural language or cron expression
      */
     parseCronSchedule(input: string): Promise<ParseCronScheduleResponse>;
+    getToolMetrics(sessionId?: string, toolName?: string): Promise<GetToolMetricsResponse>;
+    getCostSummary(options?: {
+        sessionId?: string;
+        model?: string;
+        startDate?: string;
+        endDate?: string;
+    }): Promise<GetCostSummaryResponse>;
+    /**
+     * Run the server-side AgenticLoop (non-streaming).
+     * The server executes the full loop: generate → tool call → execute → reflect → repeat.
+     */
+    agenticGenerate(sessionId: string, prompt: string, options?: {
+        strategy?: string;
+        maxSteps?: number;
+        reflection?: boolean;
+        planning?: boolean;
+    }): Promise<AgenticGenerateResponse>;
+    /**
+     * Stream the server-side AgenticLoop.
+     * Returns a stream of AgenticGenerateEvent for real-time UI updates.
+     */
+    streamAgenticGenerate(sessionId: string, prompt: string, options?: {
+        strategy?: string;
+        maxSteps?: number;
+        reflection?: boolean;
+        planning?: boolean;
+    }): AsyncIterable<AgenticGenerateEvent>;
+    /**
+     * Delegate a task to a built-in or custom subagent (non-streaming).
+     */
+    delegateToAgent(sessionId: string, agentName: string, task: string, options?: {
+        maxSteps?: number;
+        allowedTools?: string[];
+    }): Promise<DelegateResponse>;
+    /**
+     * Delegate a task to a subagent with streaming events.
+     */
+    streamDelegateToAgent(sessionId: string, agentName: string, task: string, options?: {
+        maxSteps?: number;
+        allowedTools?: string[];
+    }): AsyncIterable<AgenticGenerateEvent>;
+    /**
+     * Get per-lane queue statistics for a session.
+     */
+    getQueueStats(sessionId: string): Promise<GetQueueStatsResponse>;
+    /**
+     * Load all skills from a directory.
+     */
+    loadSkillsFromDir(sessionId: string, directory: string, recursive?: boolean): Promise<LoadSkillsFromDirResponse>;
     private streamToAsyncIterable;
 }
 //# sourceMappingURL=client.d.ts.map