@a3s-lab/code 1.7.2 → 1.8.0

package/README.md

@@ -28,35 +28,18 @@ main().catch(console.error)
 
 `session.tool(...)` returns a `ToolResult` enriched with parsed metadata helpers.
 
-### Document Runtime
-
-```js
-const { parseDocumentRuntime } = require('@a3s-lab/code')
-
-const tool = await session.tool('agentic_parse', { path: 'docs/scanned.pdf' })
-console.log(tool.metadata)
-console.log(tool.documentRuntime)
-
-const runtime = parseDocumentRuntime(tool)
-if (runtime?.ocr) {
-  console.log(runtime.ocr.provider, runtime.ocr.model, runtime.ocr.dpi)
-}
-```
-
 ### Agentic Parse LLM Blocks
 
 When `agentic_parse` runs with a query, the SDK exposes the exact structured
 document blocks selected for the LLM input.
 
 ```js
-const { parseAgenticParseLlmBlocks } = require('@a3s-lab/code')
-
 const tool = await session.tool('agentic_parse', {
   path: 'docs/scanned.pdf',
   query: 'overview',
 })
 
-for (const block of tool.agenticParseLlmBlocks ?? parseAgenticParseLlmBlocks(tool) ?? []) {
+for (const block of tool.agenticParseLlmBlocks ?? []) {
   console.log(block.index, block.kind, block.label, block.location?.display)
 }
 ```
@@ -67,14 +50,12 @@ for (const block of tool.agenticParseLlmBlocks ?? parseAgenticParseLlmBlocks(too
 locators derived from `CompositeDocumentParser` blocks.
 
 ```js
-const { parseAgenticSearchResults } = require('@a3s-lab/code')
-
 const search = await session.tool('agentic_search', {
   query: 'overview',
   mode: 'fast',
 })
 
-for (const result of search.agenticSearchResults ?? parseAgenticSearchResults(search) ?? []) {
+for (const result of search.agenticSearchResults ?? []) {
   for (const match of result.matches ?? []) {
     console.log(match.lineNumber, match.locator, match.content)
   }
@@ -89,59 +70,15 @@ const deep = await session.tool('agentic_search', {
   mode: 'deep',
 })
 
-for (const result of deep.agenticSearchResults ?? parseAgenticSearchResults(deep) ?? []) {
+for (const result of deep.agenticSearchResults ?? []) {
   for (const sampled of result.sampledLines ?? []) {
     console.log(sampled.lineNumber, sampled.locator, sampled.distance, sampled.weight)
   }
 }
 ```
 
-## OCR Backend For Better Context Extraction
-
-Use `documentOcrProvider` when you want `agentic_search` and `agentic_parse`
-to recover context from scanned PDFs or images via a JavaScript OCR callback.
-
-```js
-const {
-  Agent,
-  DocumentParserRegistry,
-} = require('@a3s-lab/code')
-
-async function main() {
-  const agent = await Agent.create('agent.hcl')
-
-  const session = agent.session('.', {
-    documentParserRegistry: new DocumentParserRegistry({
-      ocr: {
-        enabled: true,
-        model: 'openai/gpt-4.1-mini',
-        maxImages: 2,
-        dpi: 144,
-      },
-    }),
-    documentOcrProvider: {
-      name: 'node-mock-ocr',
-      formats: ['pdf', 'image'],
-      handler(request) {
-        console.log(request.path, request.format, request.config)
-        return 'Recovered OCR text from Node backend.'
-      },
-    },
-  })
-
-  const tool = await session.tool('agentic_parse', { path: 'docs/scanned.pdf' })
-  console.log(tool.documentRuntime)
-}
-
-main().catch(console.error)
-```
-
-If you do not inject a backend, the Rust core can also auto-detect local
-`tesseract` and `pdftoppm` installations for the same context-extraction fallback.
-
 ## Examples
 
-- `examples/test-document-ocr-provider.js`
 - `examples/test-agentic-parse-llm-blocks.js`
 - `examples/test-agentic-search-locators.js`
 - `examples/test-agentic-search-sampled-lines.js`

package/index.d.ts

@@ -142,36 +142,6 @@ export interface AhpEventContext {
   currentTask?: string
   capabilities?: Record<string, string>
 }
-/** A single match within an agentic search result. */
-export interface AgenticSearchMatch {
-  lineNumber?: number
-  content?: string
-  locator?: string
-  contextBefore: Array<string>
-  contextAfter: Array<string>
-}
-/** A sampled line from an agentic search result. */
-export interface AgenticSearchSampledLine {
-  lineNumber?: number
-  content?: string
-  locator?: string
-  distance?: number
-  weight?: number
-}
-/** An agentic search result with scoring and matches. */
-export interface AgenticSearchResult {
-  path?: string
-  fileType?: string
-  relevance?: number
-  evidenceScore?: number
-  matchCount?: number
-  sampledLineCount?: number
-  score?: number
-  matches: Array<AgenticSearchMatch>
-  sampledLines: Array<AgenticSearchSampledLine>
-}
-/** Parse a JSON string or object into AgenticSearchResult objects. */
-export declare function parseAgenticSearchResults(json: any): Array<AgenticSearchResult>
 export interface AgentResult {
   text: string
   toolCallsCount: number
@@ -216,6 +186,8 @@ export interface ToolResult {
   exitCode: number
   /** Raw JSON-encoded tool metadata returned by the Rust core API. */
   metadataJson?: string
+  /** Convenience JSON view of `metadata.document_runtime` when present. */
+  documentRuntimeJson?: string
 }
 /** Result of a single `EventStream.next()` call. */
 export interface NextResult {
@@ -580,16 +552,38 @@ export interface SkillInfo {
  * Each entry has `name`, `description`, and `kind` (instruction, tool, or agent).
  */
 export declare function builtinSkills(): Array<SkillInfo>
+/** Role of a team member. */
+export const enum TeamRole {
+  /** Decomposes goals into tasks, assigns work. */
+  Lead = 0,
+  /** Executes assigned tasks. */
+  Worker = 1,
+  /** Reviews completed work, provides feedback. */
+  Reviewer = 2
+}
+/** Task status on the team task board. */
+export const enum TeamTaskStatus {
+  /** Waiting to be claimed. */
+  Open = 0,
+  /** Claimed by a worker. */
+  InProgress = 1,
+  /** Work done, awaiting review. */
+  InReview = 2,
+  /** Approved by reviewer. */
+  Done = 3,
+  /** Rejected, needs rework. */
+  Rejected = 4
+}
 /** Team configuration. */
 export interface TeamConfig {
   /** Maximum concurrent tasks on the board (default: 50). */
-  maxTasks: number
+  maxTasks?: number
   /** Message channel buffer size (default: 128). */
-  channelBuffer: number
+  channelBuffer?: number
   /** Maximum coordinator rounds before `runUntilDone` exits (default: 10). */
-  maxRounds: number
+  maxRounds?: number
   /** Worker/Reviewer polling interval in milliseconds (default: 200). */
-  pollIntervalMs: number
+  pollIntervalMs?: number
 }
 /** A task snapshot from the team board (read-only). */
 export interface TeamTask {
@@ -597,7 +591,7 @@ export interface TeamTask {
   description: string
   postedBy: string
   assignedTo?: string
-  /** Task status: "open", "in_progress", "in_review", "done", or "rejected". */
+  /** Task status. */
   status: string
   result?: string
   createdAt: number
@@ -1089,7 +1083,7 @@ export declare class Session {
   /** Search file contents with a regex pattern. */
   grep(pattern: string): Promise<string>
   /** Execute a git command (status, log, branch, checkout, diff, stash, remote, worktree). */
-  git(command: string, subcommand?: string, name?: string, path?: string, newBranch?: boolean, base?: string, force?: boolean, maxCount?: number, message?: string, includeUntracked?: boolean, target?: string, reference?: string): Promise<ToolResult>
+  git(command: string, subcommand?: string | undefined | null, name?: string | undefined | null, path?: string | undefined | null, newBranch?: boolean | undefined | null, base?: string | undefined | null, force?: boolean | undefined | null, maxCount?: number | undefined | null, message?: string | undefined | null, includeUntracked?: boolean | undefined | null, target?: string | undefined | null, reference?: string | undefined | null): Promise<ToolResult>
   /** Check if this session has a lane queue configured. */
   hasQueue(): boolean
   /**
@@ -1396,12 +1390,8 @@ export declare class TeamTaskBoard {
   reject(taskId: string): boolean
   /** Get a task by ID. */
   get(taskId: string): TeamTask | null
-  /**
-   * Get all tasks with the given status string.
-   *
-   * @param status - "open", "in_progress", "in_review", "done", or "rejected"
-   */
-  byStatus(status: string): Array<TeamTask>
+  /** Get all tasks with the given status. */
+  byStatus(status: TeamTaskStatus): Array<TeamTask>
   /** Get all tasks assigned to a member. */
   byAssignee(memberId: string): Array<TeamTask>
   /** Summary stats as `{ open, inProgress, inReview, done, rejected }`. */
@@ -1419,9 +1409,9 @@ export declare class TeamTaskBoard {
  * @example
  * ```js
  * const team = new Team("refactor-auth");
- * team.addMember("lead", "lead");
- * team.addMember("worker-1", "worker");
- * team.addMember("reviewer", "reviewer");
+ * team.addMember("lead", TeamRole.Lead);
+ * team.addMember("worker-1", TeamRole.Worker);
+ * team.addMember("reviewer", TeamRole.Reviewer);
  * const runner = new TeamRunner(team);
  * runner.bindSession("lead", leadSession);
  * const result = await runner.runUntilDone("Refactor the auth module");
@@ -1439,9 +1429,9 @@ export declare class Team {
    * Add a member to the team.
    *
    * @param memberId - Unique member identifier
-   * @param role - "lead", "worker", or "reviewer"
+   * @param role - TeamRole: Lead, Worker, or Reviewer
    */
-  addMember(memberId: string, role: string): void
+  addMember(memberId: string, role: TeamRole): void
   /** Remove a member. Returns true if the member was found. */
   removeMember(memberId: string): boolean
   /** Number of registered members. */

package/index.js

@@ -118,6 +118,18 @@ switch (platform) {
       break
     } catch {}
     switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'index.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./index.darwin-x64.node')
+          } else {
+            nativeBinding = require('@a3s-lab/code-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
       case 'arm64':
         localFileExisted = existsSync(
           join(__dirname, 'index.darwin-arm64.node')
@@ -133,7 +145,7 @@ switch (platform) {
         }
         break
       default:
-        throw new Error(`Unsupported architecture on macOS: ${arch}. Only arm64 is supported.`)
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
     }
     break
   case 'freebsd':
@@ -298,18 +310,13 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { parseDocumentRuntime, parseAgenticSearchResults, parseAgenticParseLlmBlocks, enrichToolResult, EventStream, FileMemoryStore, FileSessionStore, MemorySessionStore, DefaultSecurityProvider, DocumentParserRegistry, SkillPlugin, StdioTransport, HttpTransport, WebSocketTransport, UnixSocketTransport, Agent, Session, builtinSkills, TeamTaskBoard, Team, TeamRunner, SubAgentHandle, SubAgentEventStream, Orchestrator } = nativeBinding
+const { EventStream, FileMemoryStore, FileSessionStore, MemorySessionStore, DefaultSecurityProvider, SkillPlugin, StdioTransport, HttpTransport, WebSocketTransport, UnixSocketTransport, Agent, Session, builtinSkills, TeamRole, TeamTaskStatus, TeamTaskBoard, Team, TeamRunner, SubAgentHandle, SubAgentEventStream, Orchestrator } = nativeBinding
 
-module.exports.parseDocumentRuntime = parseDocumentRuntime
-module.exports.parseAgenticSearchResults = parseAgenticSearchResults
-module.exports.parseAgenticParseLlmBlocks = parseAgenticParseLlmBlocks
-module.exports.enrichToolResult = enrichToolResult
 module.exports.EventStream = EventStream
 module.exports.FileMemoryStore = FileMemoryStore
 module.exports.FileSessionStore = FileSessionStore
 module.exports.MemorySessionStore = MemorySessionStore
 module.exports.DefaultSecurityProvider = DefaultSecurityProvider
-module.exports.DocumentParserRegistry = DocumentParserRegistry
 module.exports.SkillPlugin = SkillPlugin
 module.exports.StdioTransport = StdioTransport
 module.exports.HttpTransport = HttpTransport
@@ -318,6 +325,8 @@ module.exports.UnixSocketTransport = UnixSocketTransport
 module.exports.Agent = Agent
 module.exports.Session = Session
 module.exports.builtinSkills = builtinSkills
+module.exports.TeamRole = TeamRole
+module.exports.TeamTaskStatus = TeamTaskStatus
 module.exports.TeamTaskBoard = TeamTaskBoard
 module.exports.Team = Team
 module.exports.TeamRunner = TeamRunner

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/code",
-  "version": "1.7.2",
+  "version": "1.8.0",
   "description": "A3S Code - Native AI coding agent library for Node.js",
   "main": "index.js",
   "types": "index.d.ts",
@@ -41,15 +41,14 @@
     "test:agentic-search-locators": "node examples/test-agentic-search-locators.js",
     "test:agentic-search-sampled-lines": "node examples/test-agentic-search-sampled-lines.js",
     "test:agentic-parse-llm-blocks": "node examples/test-agentic-parse-llm-blocks.js",
-    "test:loop": "tsx --tsconfig examples/tsconfig.json examples/test_loop_commands.ts",
-    "test:ocr-provider-example": "node examples/test-document-ocr-provider.js"
+    "test:loop": "tsx --tsconfig examples/tsconfig.json examples/test_loop_commands.ts"
   },
   "optionalDependencies": {
-    "@a3s-lab/code-darwin-arm64": "1.7.2",
-    "@a3s-lab/code-linux-x64-gnu": "1.7.2",
-    "@a3s-lab/code-linux-x64-musl": "1.7.2",
-    "@a3s-lab/code-linux-arm64-gnu": "1.7.2",
-    "@a3s-lab/code-linux-arm64-musl": "1.7.2",
-    "@a3s-lab/code-win32-x64-msvc": "1.7.2"
+    "@a3s-lab/code-darwin-arm64": "1.8.0",
+    "@a3s-lab/code-linux-x64-gnu": "1.8.0",
+    "@a3s-lab/code-linux-x64-musl": "1.8.0",
+    "@a3s-lab/code-linux-arm64-gnu": "1.8.0",
+    "@a3s-lab/code-linux-arm64-musl": "1.8.0",
+    "@a3s-lab/code-win32-x64-msvc": "1.8.0"
   }
 }