@a3s-lab/code 0.5.0 → 0.7.0

package/index.d.ts

@@ -0,0 +1,87 @@
+/* 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
+}
+
+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 */
+  readFile(path: string): Promise<string>
+  /** 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 */
+  grep(pattern: string): Promise<string>
+}

package/index.js

@@ -0,0 +1,128 @@
+/* eslint-disable */
+/* auto-generated by napi-rs */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 12, use os.release() to detect musl
+  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 {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'darwin':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'a3s-code.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./a3s-code.darwin-x64.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'a3s-code.darwin-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./a3s-code.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-x64-musl.node'))
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./a3s-code.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-x64-gnu.node'))
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./a3s-code.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-arm64-musl.node'))
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./a3s-code.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(join(__dirname, 'a3s-code.linux-arm64-gnu.node'))
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./a3s-code.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@a3s-lab/code-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { Agent } = nativeBinding
+
+module.exports.Agent = Agent

package/package.json

@@ -1,43 +1,36 @@
 {
   "name": "@a3s-lab/code",
-  "version": "0.5.0",
-  "description": "TypeScript SDK for A3S Code Agent Service",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "files": [
-    "dist",
-    "proto"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "@grpc/grpc-js": "^1.9.0",
-    "@grpc/proto-loader": "^0.7.0"
-  },
-  "devDependencies": {
-    "@vitest/coverage-v8": "^1.6.1",
-    "prettier": "^3.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
+  "version": "0.7.0",
+  "description": "A3S Code - Native AI coding agent library for Node.js",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "binaryName": "a3s-code",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu"
+    ]
   },
-  "keywords": [
-    "a3s",
-    "code-agent",
-    "grpc",
-    "sdk"
-  ],
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/a3s-lab/a3s"
+    "url": "https://github.com/A3S-Lab/Code"
+  },
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "*.node"
+  ],
+  "devDependencies": {
+    "@napi-rs/cli": "^2"
   },
-  "engines": {
-    "node": ">=18.0.0"
+  "scripts": {
+    "artifacts": "napi artifacts",
+    "build": "napi build --platform --release --js index.js --dts index.d.ts",
+    "build:debug": "napi build --platform --js index.js --dts index.d.ts",
+    "prepublishOnly": "napi prepublish -t npm",
+    "test": "node test.mjs"
   }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 A3S Lab
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.