@a3s-lab/code 0.3.1 → 0.4.1

package/dist/generate.js

@@ -0,0 +1,283 @@
+/**
+ * High-Level AI Functions (Convenience Wrappers)
+ *
+ * Vercel AI SDK-style standalone functions that auto-manage session lifecycle.
+ * These create a temporary session, run the operation, and clean up.
+ *
+ * For multi-turn or long-lived usage, prefer creating a Session directly:
+ * ```typescript
+ * const session = await client.createSession({ model: openai('gpt-4o') });
+ * const { text } = await session.generateText({ prompt: 'Hello' });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { generateText, streamText, createProvider } from '@a3s-lab/code';
+ *
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ *
+ * // One-shot generation (auto session)
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   prompt: 'Explain this codebase',
+ *   workspace: '/project',
+ * });
+ * ```
+ */
+import { A3sClient } from './client.js';
+// ============================================================================
+// Standalone Functions (auto session lifecycle)
+// ============================================================================
+/**
+ * Generate text from a language model (auto session).
+ *
+ * Creates a temporary session, generates text, and cleans up.
+ * For multi-turn usage, create a Session directly instead.
+ *
+ * @example
+ * ```typescript
+ * const { text } = await generateText({
+ *   model: openai('gpt-4o'),
+ *   prompt: 'Summarize this file',
+ *   workspace: '/project',
+ * });
+ * ```
+ */
+export async function generateText(options) {
+    const client = new A3sClient(options.server);
+    const session = await client.createSession({
+        model: options.model,
+        workspace: options.workspace,
+        system: options.system,
+    });
+    try {
+        return await session.generateText({
+            prompt: options.prompt,
+            messages: options.messages,
+            tools: options.tools,
+            maxSteps: options.maxSteps,
+            onStepFinish: options.onStepFinish,
+            onToolCall: options.onToolCall,
+        });
+    }
+    finally {
+        await session.close();
+        client.close();
+    }
+}
+/**
+ * Stream text from a language model (auto session).
+ *
+ * Returns immediately with stream handles. Session is cleaned up when stream ends.
+ *
+ * @example
+ * ```typescript
+ * const { textStream } = streamText({
+ *   model: openai('gpt-4o'),
+ *   prompt: 'Explain this codebase',
+ * });
+ * for await (const chunk of textStream) {
+ *   process.stdout.write(chunk);
+ * }
+ * ```
+ */
+export function streamText(options) {
+    const client = new A3sClient(options.server);
+    let session = null;
+    // We need to create the session first, then delegate to session.streamText()
+    // Since streamText returns synchronously, we wrap with a deferred pattern
+    let resolveText;
+    let resolveUsage;
+    let resolveFinishReason;
+    let resolveSteps;
+    let rejectAll;
+    const textPromise = new Promise((res, rej) => {
+        resolveText = res;
+        rejectAll = rej;
+    });
+    const usagePromise = new Promise((res) => { resolveUsage = res; });
+    const finishReasonPromise = new Promise((res) => { resolveFinishReason = res; });
+    const stepsPromise = new Promise((res) => { resolveSteps = res; });
+    const chunks = [];
+    let streamDone = false;
+    const waiters = [];
+    function notify() {
+        for (const w of waiters.splice(0))
+            w();
+    }
+    const produce = (async () => {
+        try {
+            session = await client.createSession({
+                model: options.model,
+                workspace: options.workspace,
+                system: options.system,
+            });
+            const result = session.streamText({
+                prompt: options.prompt,
+                messages: options.messages,
+                tools: options.tools,
+                maxSteps: options.maxSteps,
+                onStepFinish: options.onStepFinish,
+                onToolCall: options.onToolCall,
+            });
+            // Pipe fullStream into our chunks buffer
+            for await (const chunk of result.fullStream) {
+                chunks.push(chunk);
+                notify();
+            }
+            resolveText(await result.text);
+            resolveUsage(await result.usage);
+            resolveFinishReason(await result.finishReason);
+            resolveSteps(await result.steps);
+        }
+        catch (err) {
+            rejectAll(err);
+        }
+        finally {
+            streamDone = true;
+            notify();
+            if (session)
+                await session.close();
+            client.close();
+        }
+    })();
+    produce.catch(() => { });
+    function createIterator(transform) {
+        return {
+            [Symbol.asyncIterator]() {
+                let index = 0;
+                return {
+                    async next() {
+                        while (true) {
+                            if (index < chunks.length) {
+                                const val = transform(chunks[index++]);
+                                if (val !== null)
+                                    return { value: val, done: false };
+                                continue;
+                            }
+                            if (streamDone) {
+                                return { value: undefined, done: true };
+                            }
+                            await new Promise((r) => waiters.push(r));
+                        }
+                    },
+                };
+            },
+        };
+    }
+    return {
+        textStream: createIterator((c) => (c.content ? c.content : null)),
+        fullStream: createIterator((c) => c),
+        toolStream: createIterator((c) => (c.toolCall ? c.toolCall : null)),
+        text: textPromise,
+        usage: usagePromise,
+        finishReason: finishReasonPromise,
+        steps: stepsPromise,
+    };
+}
+/**
+ * Generate a structured object from a language model (auto session).
+ *
+ * @example
+ * ```typescript
+ * const { object } = await generateObject({
+ *   model: openai('gpt-4o'),
+ *   schema: JSON.stringify({ type: 'object', properties: { summary: { type: 'string' } } }),
+ *   prompt: 'Summarize this project',
+ * });
+ * ```
+ */
+export async function generateObject(options) {
+    const client = new A3sClient(options.server);
+    const session = await client.createSession({
+        model: options.model,
+        workspace: options.workspace,
+        system: options.system,
+    });
+    try {
+        return await session.generateObject({
+            prompt: options.prompt,
+            messages: options.messages,
+            schema: options.schema,
+        });
+    }
+    finally {
+        await session.close();
+        client.close();
+    }
+}
+/**
+ * Stream a structured object from a language model (auto session).
+ *
+ * @example
+ * ```typescript
+ * const { partialStream, object } = streamObject({
+ *   model: openai('gpt-4o'),
+ *   schema: '{"type":"object","properties":{"items":{"type":"array"}}}',
+ *   prompt: 'List project files',
+ * });
+ * for await (const partial of partialStream) {
+ *   console.log('partial:', partial);
+ * }
+ * const result = await object;
+ * ```
+ */
+export function streamObject(options) {
+    const client = new A3sClient(options.server);
+    let session = null;
+    let resolveObject;
+    let resolveData;
+    let rejectAll;
+    const objectPromise = new Promise((res, rej) => {
+        resolveObject = res;
+        rejectAll = rej;
+    });
+    const dataPromise = new Promise((res) => {
+        resolveData = res;
+    });
+    const partialStream = {
+        [Symbol.asyncIterator]() {
+            let started = false;
+            let innerIter;
+            return {
+                async next() {
+                    if (!started) {
+                        started = true;
+                        session = await client.createSession({
+                            model: options.model,
+                            workspace: options.workspace,
+                            system: options.system,
+                        });
+                        const result = session.streamObject({
+                            prompt: options.prompt,
+                            messages: options.messages,
+                            schema: options.schema,
+                        });
+                        innerIter = result.partialStream[Symbol.asyncIterator]();
+                        // Wire up the promises
+                        result.object.then((v) => resolveObject(v), (e) => rejectAll(e));
+                        result.data.then((v) => resolveData(v));
+                    }
+                    try {
+                        const r = await innerIter.next();
+                        if (r.done) {
+                            if (session)
+                                await session.close();
+                            client.close();
+                            return { value: undefined, done: true };
+                        }
+                        return r;
+                    }
+                    catch (err) {
+                        if (session)
+                            await session.close();
+                        client.close();
+                        throw err;
+                    }
+                },
+            };
+        },
+    };
+    return { partialStream, object: objectPromise, data: dataPromise };
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/index.d.ts

@@ -1,11 +1,52 @@
 /**
  * A3S Code Agent TypeScript SDK
  *
- * This module exports the main client and configuration utilities
- * for interacting with the A3S Code Agent Service.
+ * Session-based AI coding agent SDK with AgenticLoop, Skills, HITL, and Lane Queue.
+ *
+ * @example Quick Start
+ * ```typescript
+ * import { A3sClient, createProvider } from '@a3s-lab/code';
+ *
+ * const client = new A3sClient();
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ *
+ * await using session = await client.createSession({
+ *   model: openai('gpt-4o'),
+ *   workspace: '/project',
+ *   system: 'You are a senior software engineer.',
+ *   confirmation: { requireConfirmation: ['Bash', 'Write'] },
+ * });
+ *
+ * // Simple question
+ * const { text } = await session.send('What is TypeScript?');
+ *
+ * // Complex task — auto-enters AgenticLoop
+ * const { text, steps, toolCalls } = await session.send(
+ *   'Refactor the auth module to use JWT',
+ * );
+ *
+ * // Streaming with real-time events
+ * const { eventStream } = session.sendStream('Fix all TODOs in src/');
+ * for await (const event of eventStream) {
+ *   if (event.type === 'text') process.stdout.write(event.content);
+ *   if (event.type === 'tool_call') console.log(`🔧 ${event.toolName}`);
+ * }
+ * ```
  */
+export { Session } from './session.js';
+export type { SessionCreateOptions, MessageInput, StepResult, ToolCallEvent, SessionGenerateTextOptions, SessionGenerateObjectOptions, GenerateTextResult, StreamTextResult, GenerateObjectResult, StreamObjectResult, SendOptions, SendResult, SendStreamResult, AgentLoopEvent, ConfirmationRequest, ConfirmationConfig, PermissionConfig, SkillDefinition, SkillInfo, AgentDefinition, AgentInfo, LaneName, LaneConfig, LaneStats, QueueStats, ExternalTaskResult, SessionStats, } from './session.js';
+export { generateText, streamText, generateObject, streamObject } from './generate.js';
+export type { BaseGenerateOptions, GenerateTextOptions, GenerateObjectOptions, } from './generate.js';
+export { createChat } from './chat.js';
+export type { ChatOptions, ChatSendResult, ChatStreamResult, Chat, } from './chat.js';
+export { createProvider, model } from './provider.js';
+export type { ProviderOptions, ModelRef, ModelSelector, } from './provider.js';
+export { tool } from './tool.js';
+export type { JsonSchema, ToolExecutionOptions, ToolDefinition, ToolSet, } from './tool.js';
+export { convertToModelMessages, convertToUIMessages, a3sMessageToModel, modelMessageToA3s, a3sMessagesToModel, modelMessagesToA3s, a3sMessagesToUI, uiMessagesToA3s, } from './message.js';
+export type { UIMessage, UIMessagePart, UIMessageTextPart, UIMessageToolInvocationPart, UIMessageStepBoundaryPart, UIMessageReasoningPart, ModelMessage, SystemModelMessage, UserModelMessage, AssistantModelMessage, ToolModelMessage, } from './message.js';
 export { A3sClient, StorageType, SessionLane, TimeoutAction, TaskHandlerMode, CronJobStatusEnum, CronExecutionStatusEnum } from './client.js';
-export type { A3sClientOptions, HealthStatus, HealthCheckResponse, AgentInfo, ToolCapability, ModelCapability, ResourceLimits, GetCapabilitiesResponse, InitializeResponse, ShutdownResponse, StorageTypeString, LLMConfig, SessionConfig, ContextUsage, SessionState, Session, CreateSessionResponse, DestroySessionResponse, ListSessionsResponse, GetSessionResponse, ConfigureSessionResponse, MessageRole, Message, TextContent, ToolUseContent, ToolResultContent, ContentBlock, ConversationMessage, GetMessagesResponse, ToolResult, ToolCall, Usage, FinishReason, GenerateResponse, ChunkType, GenerateChunk, GenerateStructuredResponse, GenerateStructuredChunk, Skill, ClaudeCodeSkill, GetClaudeCodeSkillsResponse, LoadSkillResponse, UnloadSkillResponse, ListSkillsResponse, GetContextUsageResponse, CompactContextResponse, ClearContextResponse, EventType, AgentEvent, CancelResponse, PauseResponse, ResumeResponse, SessionLaneType, TimeoutActionType, ConfirmationPolicy, ConfirmToolExecutionResponse, SetConfirmationPolicyResponse, GetConfirmationPolicyResponse, TaskHandlerModeType, LaneHandlerConfig, ExternalTask, SetLaneHandlerResponse, GetLaneHandlerResponse, CompleteExternalTaskResponse, ListPendingExternalTasksResponse, PermissionDecision, PermissionRule, PermissionPolicy, SetPermissionPolicyResponse, GetPermissionPolicyResponse, CheckPermissionResponse, AddPermissionRuleResponse, Todo, GetTodosResponse, SetTodosResponse, ModelCostInfo, ModelLimitInfo, ModelModalitiesInfo, ModelInfo, ProviderInfo, ListProvidersResponse, GetProviderResponse, AddProviderResponse, UpdateProviderResponse, RemoveProviderResponse, SetDefaultModelResponse, GetDefaultModelResponse, Complexity, StepStatus, PlanStep, ExecutionPlan, AgentGoal, CreatePlanResponse, GetPlanResponse, ExtractGoalResponse, CheckGoalAchievementResponse, MemoryType, MemoryItem, MemoryStats, StoreMemoryResponse, RetrieveMemoryResponse, SearchMemoriesResponse, GetMemoryStatsResponse, ClearMemoriesResponse, McpStdioTransport, McpHttpTransport, McpTransport, McpServerConfig, McpServerInfo, McpToolInfo, RegisterMcpServerResponse, ConnectMcpServerResponse, DisconnectMcpServerResponse, ListMcpServersResponse, GetMcpToolsResponse, LspServerInfo, LspPosition, LspRange, LspLocation, LspSymbol, LspDiagnostic, StartLspServerResponse, StopLspServerResponse, ListLspServersResponse, LspHoverResponse, LspDefinitionResponse, LspReferencesResponse, LspSymbolsResponse, LspDiagnosticsResponse, CronJobStatus, CronExecutionStatus, CronJob, CronExecution, ListCronJobsResponse, CreateCronJobResponse, GetCronJobResponse, UpdateCronJobResponse, PauseCronJobResponse, ResumeCronJobResponse, DeleteCronJobResponse, GetCronHistoryResponse, RunCronJobResponse, ParseCronScheduleResponse, } from './client.js';
+export type { A3sClientOptions, HealthStatus, HealthCheckResponse, ToolCapability, ModelCapability, ResourceLimits, GetCapabilitiesResponse, InitializeResponse, ShutdownResponse, StorageTypeString, LLMConfig, SessionConfig, ContextUsage, SessionState, SessionInfo, CreateSessionResponse, DestroySessionResponse, ListSessionsResponse, GetSessionResponse, ConfigureSessionResponse, MessageRole, Message, TextContent, ToolUseContent, ToolResultContent, ContentBlock, ConversationMessage, GetMessagesResponse, ToolResult, ToolCall, Usage, FinishReason, GenerateResponse, ChunkType, GenerateChunk, GenerateStructuredResponse, GenerateStructuredChunk, Skill, GetSkillResponse, LoadSkillResponse, UnloadSkillResponse, ListSkillsResponse, GetContextUsageResponse, CompactContextResponse, ClearContextResponse, EventType, AgentEvent, CancelResponse, PauseResponse, ResumeResponse, SessionLaneType, TimeoutActionType, ConfirmationPolicy, ConfirmToolExecutionResponse, SetConfirmationPolicyResponse, GetConfirmationPolicyResponse, TaskHandlerModeType, LaneHandlerConfig, ExternalTask, SetLaneHandlerResponse, GetLaneHandlerResponse, CompleteExternalTaskResponse, ListPendingExternalTasksResponse, PermissionDecision, PermissionRule, PermissionPolicy, SetPermissionPolicyResponse, GetPermissionPolicyResponse, CheckPermissionResponse, AddPermissionRuleResponse, Todo, GetTodosResponse, SetTodosResponse, ModelCostInfo, ModelLimitInfo, ModelModalitiesInfo, ModelInfo, ProviderInfo, ListProvidersResponse, GetProviderResponse, AddProviderResponse, UpdateProviderResponse, RemoveProviderResponse, SetDefaultModelResponse, GetDefaultModelResponse, Complexity, StepStatus, PlanStep, ExecutionPlan, AgentGoal, CreatePlanResponse, GetPlanResponse, ExtractGoalResponse, CheckGoalAchievementResponse, MemoryType, MemoryItem, MemoryStats, StoreMemoryResponse, RetrieveMemoryResponse, SearchMemoriesResponse, GetMemoryStatsResponse, ClearMemoriesResponse, McpStdioTransport, McpHttpTransport, McpTransport, McpServerConfig, McpServerInfo, McpToolInfo, RegisterMcpServerResponse, ConnectMcpServerResponse, DisconnectMcpServerResponse, ListMcpServersResponse, GetMcpToolsResponse, LspServerInfo, LspPosition, LspRange, LspLocation, LspSymbol, LspDiagnostic, StartLspServerResponse, StopLspServerResponse, ListLspServersResponse, LspHoverResponse, LspDefinitionResponse, LspReferencesResponse, LspSymbolsResponse, LspDiagnosticsResponse, CronJobStatus, CronExecutionStatus, CronJob, CronExecution, ListCronJobsResponse, CreateCronJobResponse, GetCronJobResponse, UpdateCronJobResponse, PauseCronJobResponse, ResumeCronJobResponse, DeleteCronJobResponse, GetCronHistoryResponse, RunCronJobResponse, ParseCronScheduleResponse, ToolStats, GetToolMetricsResponse, ModelCostBreakdown, DayCostBreakdown, GetCostSummaryResponse, } from './client.js';
 export { getConfig, getModelConfig, getDefaultModel, printConfig, loadConfigFromFile, loadConfigFromDir, loadDefaultConfig, } from './config.js';
 export type { A3sConfig, ProviderConfig, ModelConfigEntry, ModelConfig, } from './config.js';
 export { openAIRoleToA3S, a3sRoleToOpenAI, openAIMessageToA3S, a3sMessageToOpenAI, openAIMessagesToA3S, normalizeMessage, normalizeMessages, a3sResponseToOpenAI, a3sChunkToOpenAI, isOpenAIFormat, isTextContent, isImageContent, } from './openai-compat.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,oBAAoB,EACpB,YAAY,EACZ,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAElB,WAAW,EACX,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,eAAe,EACf,SAAS,EACT,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,YAAY,GACb,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvF,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,IAAI,GACL,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EACV,eAAe,EACf,QAAQ,EACR,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,cAAc,EACd,OAAO,GACR,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,2BAA2B,EAC3B,yBAAyB,EACzB,sBAAsB,EACtB,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAMtB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC9I,YAAY,EACV,gBAAgB,EAEhB,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,gBAAgB,EAEhB,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EAExB,WAAW,EACX,OAAO,EACP,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EAEnB,UAAU,EACV,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,0BAA0B,EAC1B,uBAAuB,EAEvB,KAAK,EACL,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAElB,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EAEpB,SAAS,EACT,UAAU,EAEV,cAAc,EACd,aAAa,EACb,cAAc,EAEd,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,4BAA4B,EAC5B,6BAA6B,EAC7B,6BAA6B,EAE7B,mBAAmB,EACnB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,gCAAgC,EAEhC,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EAEzB,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAEhB,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EAEvB,UAAU,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,4BAA4B,EAE5B,UAAU,EACV,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EAErB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,wBAAwB,EACxB,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EAEnB,aAAa,EACb,WAAW,EACX,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EAEtB,aAAa,EACb,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EAEzB,SAAS,EACT,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,aAAa,CAAC;AAGrB,OAAO,EAEL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAEhB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAEV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,9 +1,54 @@
 /**
  * A3S Code Agent TypeScript SDK
  *
- * This module exports the main client and configuration utilities
- * for interacting with the A3S Code Agent Service.
+ * Session-based AI coding agent SDK with AgenticLoop, Skills, HITL, and Lane Queue.
+ *
+ * @example Quick Start
+ * ```typescript
+ * import { A3sClient, createProvider } from '@a3s-lab/code';
+ *
+ * const client = new A3sClient();
+ * const openai = createProvider({ name: 'openai', apiKey: 'sk-xxx' });
+ *
+ * await using session = await client.createSession({
+ *   model: openai('gpt-4o'),
+ *   workspace: '/project',
+ *   system: 'You are a senior software engineer.',
+ *   confirmation: { requireConfirmation: ['Bash', 'Write'] },
+ * });
+ *
+ * // Simple question
+ * const { text } = await session.send('What is TypeScript?');
+ *
+ * // Complex task — auto-enters AgenticLoop
+ * const { text, steps, toolCalls } = await session.send(
+ *   'Refactor the auth module to use JWT',
+ * );
+ *
+ * // Streaming with real-time events
+ * const { eventStream } = session.sendStream('Fix all TODOs in src/');
+ * for await (const event of eventStream) {
+ *   if (event.type === 'text') process.stdout.write(event.content);
+ *   if (event.type === 'tool_call') console.log(`🔧 ${event.toolName}`);
+ * }
+ * ```
  */
+// ============================================================================
+// Session (Core API)
+// ============================================================================
+export { Session } from './session.js';
+// ============================================================================
+// High-Level API (Vercel AI SDK-style convenience wrappers)
+// ============================================================================
+export { generateText, streamText, generateObject, streamObject } from './generate.js';
+export { createChat } from './chat.js';
+export { createProvider, model } from './provider.js';
+export { tool } from './tool.js';
+// UIMessage / ModelMessage Conversion
+export { convertToModelMessages, convertToUIMessages, a3sMessageToModel, modelMessageToA3s, a3sMessagesToModel, modelMessagesToA3s, a3sMessagesToUI, uiMessagesToA3s, } from './message.js';
+// ============================================================================
+// Low-Level Client (for advanced usage)
+// ============================================================================
 export { A3sClient, StorageType, SessionLane, TimeoutAction, TaskHandlerMode, CronJobStatusEnum, CronExecutionStatusEnum } from './client.js';
 export { getConfig, getModelConfig, getDefaultModel, printConfig, loadConfigFromFile, loadConfigFromDir, loadDefaultConfig, } from './config.js';
 // OpenAI-Compatible Types and Utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAqK9I,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AASrB,wCAAwC;AACxC,OAAO;AACL,uBAAuB;AACvB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB;AAChB,cAAc;AACd,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../ts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAgCvC,+EAA+E;AAC/E,4DAA4D;AAC5D,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAOvF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQvC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAOtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,sCAAsC;AACtC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAetB,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAE/E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAyK9I,OAAO,EACL,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AASrB,wCAAwC;AACxC,OAAO;AACL,uBAAuB;AACvB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB;AAChB,cAAc;AACd,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/message.d.ts

@@ -0,0 +1,157 @@
+/**
+ * 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);
+ * ```
+ */
+import type { Message, ToolCall } from './client.js';
+/** Text part in a UIMessage */
+export interface UIMessageTextPart {
+    type: 'text';
+    text: string;
+}
+/** Tool invocation part in a UIMessage */
+export interface UIMessageToolInvocationPart {
+    type: 'tool-invocation';
+    toolInvocation: {
+        toolCallId: string;
+        toolName: string;
+        args: Record<string, unknown>;
+        state: 'call' | 'result' | 'partial-call';
+        result?: unknown;
+    };
+}
+/** Step boundary part in a UIMessage */
+export interface UIMessageStepBoundaryPart {
+    type: 'step-boundary';
+    stepIndex: number;
+}
+/** Reasoning part in a UIMessage */
+export interface UIMessageReasoningPart {
+    type: 'reasoning';
+    reasoning: string;
+}
+/** Union of all UIMessage part types */
+export type UIMessagePart = UIMessageTextPart | UIMessageToolInvocationPart | UIMessageStepBoundaryPart | UIMessageReasoningPart;
+/**
+ * UIMessage — Frontend-friendly message format.
+ *
+ * Contains id, timestamps, and structured parts for rendering in chat UIs.
+ * This is the format used by frontend hooks (like useChat in Vercel AI SDK).
+ */
+export interface UIMessage<TMetadata = Record<string, unknown>> {
+    /** Unique message identifier */
+    id: string;
+    /** Message role */
+    role: 'user' | 'assistant' | 'system';
+    /** Message content (plain text, for backward compatibility) */
+    content: string;
+    /** Structured parts for rich rendering */
+    parts: UIMessagePart[];
+    /** Creation timestamp */
+    createdAt?: Date;
+    /** Custom metadata */
+    metadata?: TMetadata;
+}
+/** System message for LLM */
+export interface SystemModelMessage {
+    role: 'system';
+    content: string;
+}
+/** User message for LLM */
+export interface UserModelMessage {
+    role: 'user';
+    content: string;
+}
+/** Assistant message for LLM (may include tool calls) */
+export interface AssistantModelMessage {
+    role: 'assistant';
+    content: string;
+    toolCalls?: ToolCall[];
+}
+/** Tool result message for LLM */
+export interface ToolModelMessage {
+    role: 'tool';
+    content: string;
+    toolCallId?: string;
+    toolName?: string;
+}
+/**
+ * ModelMessage — Backend message format for LLM.
+ *
+ * This is the format passed to generateText(), streamText(), and the
+ * underlying A3S client. It maps directly to the A3S proto Message type.
+ */
+export type ModelMessage = SystemModelMessage | UserModelMessage | AssistantModelMessage | ToolModelMessage;
+/**
+ * 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 declare function convertToModelMessages(uiMessages: UIMessage[]): ModelMessage[];
+/**
+ * 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 declare function convertToUIMessages(modelMessages: ModelMessage[]): UIMessage[];
+/**
+ * Convert A3S Message to ModelMessage.
+ */
+export declare function a3sMessageToModel(msg: Message): ModelMessage;
+/**
+ * Convert ModelMessage to A3S Message.
+ */
+export declare function modelMessageToA3s(msg: ModelMessage): Message;
+/**
+ * Convert A3S Message[] to ModelMessage[].
+ */
+export declare function a3sMessagesToModel(messages: Message[]): ModelMessage[];
+/**
+ * Convert ModelMessage[] to A3S Message[].
+ */
+export declare function modelMessagesToA3s(messages: ModelMessage[]): Message[];
+/**
+ * Convert A3S Message[] to UIMessage[] (shorthand for a3sMessagesToModel + convertToUIMessages).
+ */
+export declare function a3sMessagesToUI(messages: Message[]): UIMessage[];
+/**
+ * Convert UIMessage[] to A3S Message[] (shorthand for convertToModelMessages + modelMessagesToA3s).
+ */
+export declare function uiMessagesToA3s(uiMessages: UIMessage[]): Message[];
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

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