@a3s-lab/code 0.7.0 → 0.7.2

package/index.d.ts

@@ -1,87 +1,103 @@
+/* tslint:disable */
 /* eslint-disable */
-/* auto-generated by napi-rs */
 
-export interface AgentOptions {
-  /** LLM model identifier (e.g., "claude-sonnet-4-20250514", "gpt-4o") */
-  model: string
-  /** API key for the LLM provider */
-  apiKey: string
-  /** Path to the workspace directory (sandbox root) */
-  workspace?: string
-  /** System prompt for the agent */
-  systemPrompt?: string
-  /** Base URL override for the LLM API */
-  baseUrl?: string
-  /** Maximum tool execution rounds per turn */
-  maxToolRounds?: number
-}
+/* auto-generated by NAPI-RS */
 
 export interface AgentResult {
-  /** The final text response from the agent */
   text: string
-  /** Number of tool calls made during execution */
   toolCallsCount: number
-  /** Total prompt tokens used */
   promptTokens: number
-  /** Total completion tokens used */
   completionTokens: number
-  /** Total tokens used */
   totalTokens: number
 }
-
 export interface AgentEvent {
-  /** Event type: "start", "text_delta", "tool_start", "tool_end", "turn_start", "turn_end", "end", "error" */
   type: string
-  /** Text content (for text_delta and end events) */
   text?: string
-  /** Tool name (for tool_start and tool_end events) */
   toolName?: string
-  /** Tool ID (for tool_start and tool_end events) */
   toolId?: string
-  /** Tool output (for tool_end events) */
   toolOutput?: string
-  /** Exit code (for tool_end events) */
   exitCode?: number
-  /** Turn number (for turn_start and turn_end events) */
   turn?: number
-  /** Prompt text (for start events) */
   prompt?: string
-  /** Error message (for error events) */
   error?: string
-  /** Token usage (for turn_end and end events) */
   totalTokens?: number
 }
-
 export interface ToolResult {
-  /** Tool name */
   name: string
-  /** Tool output text */
   output: string
-  /** Exit code (0 = success) */
   exitCode: number
 }
-
-/**
- * AI coding agent with tool execution capabilities.
- *
- * Create an Agent by providing a model name, API key, and workspace path.
- * The agent auto-detects whether to use the Anthropic or OpenAI API based
- * on the model name.
- */
-export class Agent {
-  constructor(options: AgentOptions)
-  /** Send a prompt and wait for the complete response */
-  send(prompt: string): Promise<AgentResult>
-  /** Send a prompt and get all streaming events as an array */
-  stream(prompt: string): Promise<AgentEvent[]>
-  /** Execute a tool by name, bypassing the LLM */
-  tool(name: string, args: Record<string, unknown>): Promise<ToolResult>
-  /** Read a file from the workspace */
+export interface SessionOptions {
+  /** Override the default model. Format: "provider/model" (e.g., "openai/gpt-4o"). */
+  model?: string
+  /** Extra directories to scan for skill files (.md with YAML frontmatter). */
+  skillDirs?: Array<string>
+  /** Extra directories to scan for agent files. */
+  agentDirs?: Array<string>
+}
+export interface MessageObject {
+  role: string
+  content: Array<ContentBlockObject>
+}
+export interface ContentBlockObject {
+  type: string
+  /** Text content (for "text" blocks). */
+  text?: string
+  /** Tool use ID (for "tool_use" blocks). */
+  id?: string
+  /** Tool name (for "tool_use" blocks). */
+  name?: string
+  /** Tool input (for "tool_use" blocks). */
+  input?: any
+  /** Tool use ID reference (for "tool_result" blocks). */
+  toolUseId?: string
+  /** Tool result content (for "tool_result" blocks). */
+  resultContent?: string
+  /** Whether this is an error result (for "tool_result" blocks). */
+  isError?: boolean
+}
+/** AI coding agent. Create with `Agent.create()`, then call `agent.session()`. */
+export declare class Agent {
+  /**
+   * Create an Agent from a config file path or inline config string.
+   *
+   * @param configSource - Path to .hcl/.json file, or inline JSON/HCL string
+   */
+  static create(configSource: string): Promise<Agent>
+  /**
+   * Bind to a workspace directory, returning a Session.
+   *
+   * @param workspace - Path to the workspace directory
+   * @param options - Optional session overrides (model, skillDirs, agentDirs)
+   */
+  session(workspace: string, options?: SessionOptions | undefined | null): Session
+}
+/** Workspace-bound session. All LLM and tool operations happen here. */
+export declare class Session {
+  /**
+   * Send a prompt and wait for the complete response.
+   *
+   * @param prompt - The prompt to send
+   * @param history - Optional conversation history
+   */
+  send(prompt: string, history?: Array<MessageObject> | undefined | null): Promise<AgentResult>
+  /**
+   * Send a prompt and get a stream of events.
+   *
+   * @param prompt - The prompt to send
+   * @param history - Optional conversation history
+   */
+  stream(prompt: string, history?: Array<MessageObject> | undefined | null): Promise<Array<AgentEvent>>
+  /** Return the session's conversation history. */
+  history(): Array<MessageObject>
+  /** Execute a tool by name, bypassing the LLM. */
+  tool(name: string, args: any): Promise<ToolResult>
+  /** Read a file from the workspace. */
   readFile(path: string): Promise<string>
-  /** Execute a bash command in the workspace */
+  /** Execute a bash command in the workspace. */
   bash(command: string): Promise<string>
-  /** Search for files matching a glob pattern */
-  glob(pattern: string): Promise<string[]>
-  /** Search file contents with a regex pattern */
+  /** Search for files matching a glob pattern. */
+  glob(pattern: string): Promise<Array<string>>
+  /** Search file contents with a regex pattern. */
   grep(pattern: string): Promise<string>
 }

package/index.js

@@ -1,5 +1,8 @@
+/* tslint:disable */
 /* eslint-disable */
-/* auto-generated by napi-rs */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
 
 const { existsSync, readFileSync } = require('fs')
 const { join } = require('path')
@@ -11,12 +14,12 @@ let localFileExisted = false
 let loadError = null
 
 function isMusl() {
-  // For Node 12, use os.release() to detect musl
+  // For Node 10
   if (!process.report || typeof process.report.getReport !== 'function') {
     try {
       const lddPath = require('child_process').execSync('which ldd').toString().trim()
       return readFileSync(lddPath, 'utf8').includes('musl')
-    } catch {
+    } catch (e) {
       return true
     }
   } else {
@@ -26,13 +29,100 @@ function isMusl() {
 }
 
 switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm64.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'index.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
   case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'index.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.darwin-universal.node')
+      } else {
+        nativeBinding = require('@a3s-lab/code-darwin-universal')
+      }
+      break
+    } catch {}
     switch (arch) {
       case 'x64':
-        localFileExisted = existsSync(join(__dirname, 'a3s-code.darwin-x64.node'))
+        localFileExisted = existsSync(join(__dirname, 'index.darwin-x64.node'))
         try {
           if (localFileExisted) {
-            nativeBinding = require('./a3s-code.darwin-x64.node')
+            nativeBinding = require('./index.darwin-x64.node')
           } else {
             nativeBinding = require('@a3s-lab/code-darwin-x64')
           }
@@ -41,10 +131,12 @@ switch (platform) {
         }
         break
       case 'arm64':
-        localFileExisted = existsSync(join(__dirname, 'a3s-code.darwin-arm64.node'))
+        localFileExisted = existsSync(
+          join(__dirname, 'index.darwin-arm64.node')
+        )
         try {
           if (localFileExisted) {
-            nativeBinding = require('./a3s-code.darwin-arm64.node')
+            nativeBinding = require('./index.darwin-arm64.node')
           } else {
             nativeBinding = require('@a3s-lab/code-darwin-arm64')
           }
@@ -56,14 +148,31 @@ switch (platform) {
         throw new Error(`Unsupported architecture on macOS: ${arch}`)
     }
     break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'index.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./index.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@a3s-lab/code-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
   case 'linux':
     switch (arch) {
       case 'x64':
         if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-x64-musl.node'))
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-musl.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./a3s-code.linux-x64-musl.node')
+              nativeBinding = require('./index.linux-x64-musl.node')
             } else {
               nativeBinding = require('@a3s-lab/code-linux-x64-musl')
             }
@@ -71,10 +180,12 @@ switch (platform) {
             loadError = e
           }
         } else {
-          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-x64-gnu.node'))
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-x64-gnu.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./a3s-code.linux-x64-gnu.node')
+              nativeBinding = require('./index.linux-x64-gnu.node')
             } else {
               nativeBinding = require('@a3s-lab/code-linux-x64-gnu')
             }
@@ -85,10 +196,12 @@ switch (platform) {
         break
       case 'arm64':
         if (isMusl()) {
-          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-arm64-musl.node'))
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-musl.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./a3s-code.linux-arm64-musl.node')
+              nativeBinding = require('./index.linux-arm64-musl.node')
             } else {
               nativeBinding = require('@a3s-lab/code-linux-arm64-musl')
             }
@@ -96,10 +209,12 @@ switch (platform) {
             loadError = e
           }
         } else {
-          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-arm64-gnu.node'))
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm64-gnu.node')
+          )
           try {
             if (localFileExisted) {
-              nativeBinding = require('./a3s-code.linux-arm64-gnu.node')
+              nativeBinding = require('./index.linux-arm64-gnu.node')
             } else {
               nativeBinding = require('@a3s-lab/code-linux-arm64-gnu')
             }
@@ -108,6 +223,78 @@ switch (platform) {
           }
         }
         break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'index.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./index.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'index.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
       default:
         throw new Error(`Unsupported architecture on Linux: ${arch}`)
     }
@@ -123,6 +310,7 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { Agent } = nativeBinding
+const { Agent, Session } = nativeBinding
 
 module.exports.Agent = Agent
+module.exports.Session = Session

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/code",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "A3S Code - Native AI coding agent library for Node.js",
   "main": "index.js",
   "types": "index.d.ts",