@a3s-lab/code 1.11.0 → 2.0.1

package/README.md

@@ -14,7 +14,7 @@ npm install @a3s-lab/code
 const { Agent } = require('@a3s-lab/code')
 
 async function main() {
-  const agent = await Agent.create('agent.hcl')
+  const agent = await Agent.create('agent.acl')
   const session = agent.session('/my-project')
 
   const result = await session.send('What files handle authentication?')
@@ -28,6 +28,32 @@ main().catch(console.error)
 
 `session.tool(...)` returns a `ToolResult` enriched with parsed metadata helpers.
 
+## Programmatic Tool Calling
+
+`session.program(...)` runs a bounded JavaScript script in the embedded QuickJS
+runtime. It is the SDK-friendly wrapper around the core `program` tool.
+
+```js
+const result = await session.program({
+  source: `
+    export default async function run(ctx, inputs) {
+      const hits = await ctx.grep(inputs.query, { glob: '*.ts' })
+      const files = await ctx.glob('src/**/*.ts')
+      return { hits, files: files.slice(0, 10) }
+    }
+  `,
+  inputs: { query: 'PermissionPolicy' },
+  allowedTools: ['grep', 'glob'],
+  limits: { timeoutMs: 30000, maxToolCalls: 20, maxOutputBytes: 65536 },
+})
+
+console.log(result.output)
+```
+
+Omit `allowedTools` to allow every registered session tool except `program`.
+Scripts can also be loaded from workspace-relative `.js` or `.mjs` files with
+`{ path: 'scripts/ptc/search.js' }`.
+
 ### Agentic Parse LLM Blocks
 
 When `agentic_parse` runs with a query, the SDK exposes the exact structured

package/index.d.ts

@@ -3,106 +3,6 @@
 
 /* auto-generated by NAPI-RS */
 
-/** Unique task identifier (UUID string in JavaScript). */
-export interface TaskId {
-  /** The task ID as a string */
-  id: string
-}
-/** Task execution status. */
-export interface TaskStatus {
-  /** Status string: "pending", "running", "completed", "failed", "killed" */
-  status: string
-}
-/** Task type variants. */
-export interface TaskType {
-  /** Type string: "tool", "agent", "remote_agent", "in_process_teammate", "workflow", "coordinator", "monitor_mcp", "idle" */
-  type: string
-  /** JSON-encoded data for the variant */
-  data?: string
-}
-/** Base task with lifecycle management. */
-export interface Task {
-  id: string
-  kind: TaskType
-  status: TaskStatus
-  description: string
-  toolUseId?: string
-  parentId?: string
-  childIds: Array<string>
-  error?: string
-}
-/** Result of a completed task. */
-export interface TaskResult {
-  taskId: string
-  output?: string
-  durationMs: number
-}
-/** Token usage statistics for a task. */
-export interface TaskTokenUsage {
-  inputTokens: number
-  outputTokens: number
-  cacheReadTokens: number
-  cacheWriteTokens: number
-}
-/** Record of a single tool activity. */
-export interface ToolActivity {
-  toolName: string
-  timestamp: string
-  argsSummary: string
-  success: boolean
-}
-/** Snapshot of agent execution progress. */
-export interface AgentProgress {
-  toolCounts: Record<string, number>
-  totalToolCalls: number
-  tokenUsage: TaskTokenUsage
-  recentActivities: Array<ToolActivity>
-  elapsedMs: number
-  running: boolean
-}
-/** Phase of an idle task. */
-export interface IdlePhase {
-  /** Phase string: "starting", "consolidating", "updating", "completed" */
-  phase: string
-}
-/** Tool call recorded during an idle turn. */
-export interface IdleToolCall {
-  name: string
-  argsSummary: string
-  success: boolean
-}
-/** A single turn in idle execution. */
-export interface IdleTurn {
-  text: string
-  toolCalls: Array<IdleToolCall>
-  touchedFiles: Array<string>
-  inputTokens: number
-  outputTokens: number
-}
-/** Memory update produced by idle completion. */
-export interface MemoryUpdate {
-  semanticFacts: Array<string>
-  episodicEntries: Array<EpisodicEntry>
-  proceduralUpdates: Array<string>
-  totalTokens: number
-  durationMs: number
-}
-/** Episodic memory entry from idle. */
-export interface EpisodicEntry {
-  timestamp: string
-  description: string
-  relatedFiles: Array<string>
-  importance: number
-}
-/** Idle (memory consolidation) task state. */
-export interface IdleTask {
-  id: string
-  phase: IdlePhase
-  reason: string
-  turns: Array<IdleTurn>
-  touchedFiles: Array<string>
-  error?: string
-}
 /** AHP event type. */
 export interface AhpEventType {
   /** Event type string: "handshake", "pre_action", "post_action", "pre_prompt", "post_response", "session_start", "session_end", "error", "query", "heartbeat", "idle" */
@@ -148,7 +48,14 @@ export interface AgentResult {
   promptTokens: number
   completionTokens: number
   totalTokens: number
-}
+  verificationStatus: string
+  pendingVerificationCount: number
+  failedVerificationCount: number
+  verificationReportCount: number
+  verificationSummaryJson: string
+  verificationSummaryText: string
+}
+export declare function formatVerificationSummary(summary: any): string
 /**
  * Result of a `/btw` ephemeral side question.
  *
@@ -175,6 +82,8 @@ export interface AgentEvent {
   prompt?: string
   error?: string
   totalTokens?: number
+  verificationSummaryJson?: string
+  verificationSummaryText?: string
   /** For btw_answer event: the original question */
   question?: string
   /** For btw_answer event: the LLM's answer */
@@ -182,6 +91,14 @@ export interface AgentEvent {
   /** Extra data for events that don't map to standard fields (JSON-encoded) */
   data?: string
 }
+export interface VerificationCommand {
+  id: string
+  kind: string
+  description: string
+  command: string
+  required?: boolean
+  timeoutMs?: number
+}
 export interface ToolResult {
   name: string
   output: string
@@ -191,6 +108,26 @@ export interface ToolResult {
   /** Convenience JSON view of `metadata.document_runtime` when present. */
   documentRuntimeJson?: string
 }
+export interface ProgramScriptLimits {
+  /** Wall-clock timeout for the embedded QuickJS script. */
+  timeoutMs?: number
+  /** Maximum number of ctx tool calls the script may perform. */
+  maxToolCalls?: number
+  /** Maximum bytes returned in the program result output. */
+  maxOutputBytes?: number
+}
+export interface ProgramScriptOptions {
+  /** Inline JavaScript source. Define `async function run(ctx, inputs)` or export it as default. */
+  source?: string
+  /** Workspace-relative `.js` or `.mjs` script path. */
+  path?: string
+  /** JSON-serializable inputs passed to `run(ctx, inputs)`. */
+  inputs?: any
+  /** Optional tool allow-list. Defaults to every registered tool except `program`. */
+  allowedTools?: Array<string>
+  /** Execution limits for the script. */
+  limits?: ProgramScriptLimits
+}
 /** Parameters for the web_search tool. */
 export interface JsWebSearchParams {
   /** The search query. */
@@ -262,6 +199,18 @@ export interface JsAhpTransport {
   authToken?: string
   path?: string
 }
+export interface PermissionPolicy {
+  /** Tool invocation patterns that are always denied first. */
+  deny?: Array<string>
+  /** Tool invocation patterns that are auto-approved. */
+  allow?: Array<string>
+  /** Tool invocation patterns that always require confirmation. */
+  ask?: Array<string>
+  /** Default decision when no rule matches: "allow", "deny", or "ask". */
+  defaultDecision?: string
+  /** Whether this policy is enabled. Defaults to true. */
+  enabled?: boolean
+}
 export interface SessionOptions {
   /** Override the default model. Format: "provider/model" (e.g., "openai/gpt-4o"). */
   model?: string
@@ -271,10 +220,14 @@ export interface SessionOptions {
   skillDirs?: Array<string>
   /** Extra directories to scan for agent files. */
   agentDirs?: Array<string>
-  /** Optional queue configuration for lane-based tool execution. */
+  /**
+   * Optional advanced queue configuration for explicit external/hybrid lane dispatch.
+   *
+   * Ordinary sessions are queue-free unless this is provided.
+   */
   queueConfig?: SessionQueueConfig
-  /** Allow all tools without HITL confirmation (default: false). */
-  permissive?: boolean
+  /** Explicit permission policy for tool execution. */
+  permissionPolicy?: PermissionPolicy
   /** Enable planning mode (default: false). */
   planning?: boolean
   /** Enable goal tracking (default: false). */
@@ -431,7 +384,12 @@ export interface AttachmentObject {
   /** MIME type (e.g., "image/jpeg", "image/png"). */
   mediaType: string
 }
-/** Configuration for the session lane queue. */
+/**
+ * Configuration for the optional advanced session lane queue.
+ *
+ * Ordinary sessions do not initialize queue infrastructure. Use this only for
+ * explicit external/hybrid dispatch, priority experiments, or operational integrations.
+ */
 export interface SessionQueueConfig {
   /** Max concurrency for Query lane (default: 4). */
   queryConcurrency?: number
@@ -510,28 +468,13 @@ export interface CommandContext {
 }
 /** Metadata about a registered slash command. */
 export interface CommandInfo {
-  /** Command name without the leading `/` (e.g., `"loop"`, `"help"`) */
+  /** Command name without the leading `/` (e.g., `"help"`, `"model"`) */
   name: string
   /** Short description shown in `/help` */
   description: string
-  /** Optional usage hint (e.g., `"/loop [interval] <prompt> [every <interval>]"`) */
+  /** Optional usage hint (e.g., `"/model <provider/model>"`) */
   usage?: string
 }
-/** Info about an active scheduled task. */
-export interface ScheduledTaskInfo {
-  /** 8-char hex task ID */
-  id: string
-  /** The prompt sent at each interval */
-  prompt: string
-  /** Interval between fires in seconds */
-  intervalSecs: number
-  /** Whether the task repeats (always `true` for tasks created via `/loop`) */
-  recurring: boolean
-  /** Number of times this task has fired so far */
-  fireCount: number
-  /** Seconds until the next fire (0 if overdue) */
-  nextFireInSecs: number
-}
 /** Matcher for filtering which events trigger a hook. */
 export interface HookMatcherObject {
   /** Match specific tool name (exact match) */
@@ -569,118 +512,6 @@ 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
-  /** Message channel buffer size (default: 128). */
-  channelBuffer?: number
-  /** Maximum coordinator rounds before `runUntilDone` exits (default: 10). */
-  maxRounds?: number
-  /** Worker/Reviewer polling interval in milliseconds (default: 200). */
-  pollIntervalMs?: number
-}
-/** A task snapshot from the team board (read-only). */
-export interface TeamTask {
-  id: string
-  description: string
-  postedBy: string
-  assignedTo?: string
-  /** Task status. */
-  status: string
-  result?: string
-  createdAt: number
-  updatedAt: number
-}
-/** Result returned by `TeamRunner.runUntilDone()`. */
-export interface TeamRunResult {
-  doneTasks: Array<TeamTask>
-  rejectedTasks: Array<TeamTask>
-  rounds: number
-}
-/**
- * Per-member overrides for `TeamRunner.addLead`, `addWorker`, and `addReviewer`.
- *
- * All fields are optional. Unset fields inherit from the agent definition
- * file (role-level config) and ultimately from the `Agent` base config:
- *
- * ```
- * TeamMemberOptions  →  AgentDefinition (.yaml/.md)  →  Agent (config.hcl)
- * ```
- *
- * Specifically:
- * - `model`: unset → inherits agent definition model → inherits Agent default model
- * - `extra`: unset → inherits agent definition `prompt` field
- * - `role`, `guidelines`, `responseStyle`: unset → empty (no definition-level equivalent)
- * - `workspace`: unset → inherits the workspace passed to `TeamRunner.create`
- * - `maxToolRounds`: unset → inherits agent definition `max_steps` → inherits Agent config
- */
-export interface TeamMemberOptions {
-  /**
-   * Override the workspace for this member.
-   *
-   * Set this to an isolated git worktree path so concurrent workers do not
-   * conflict with each other on the filesystem.
-   * Falls back to the workspace supplied to `TeamRunner.create`.
-   */
-  workspace?: string
-  /**
-   * Model override. Format: `"provider/model"` (e.g. `"openai/gpt-4o"`).
-   * Falls back to the agent definition model, then the Agent default model.
-   */
-  model?: string
-  /**
-   * Custom role/identity prepended before the core agentic prompt.
-   *
-   * Example: `"You are a senior Python developer specializing in FastAPI."`
-   * No definition-level default — omit to use the standard agent identity.
-   */
-  role?: string
-  /**
-   * Custom coding guidelines appended after the core prompt.
-   *
-   * Example: `"Always write unit tests. Follow PEP 8."`
-   * No definition-level default — omit to use no extra guidelines.
-   */
-  guidelines?: string
-  /**
-   * Custom response style (replaces the default Response Format section).
-   * No definition-level default — omit to use the standard response format.
-   */
-  responseStyle?: string
-  /**
-   * Freeform extra instructions appended at the very end of the system prompt.
-   * Falls back to the agent definition `prompt` field when unset.
-   */
-  extra?: string
-  /**
-   * Override maximum number of tool-call rounds for this member's session.
-   * Falls back to the agent definition `max_steps`, then the Agent config.
-   */
-  maxToolRounds?: number
-}
 /** Configuration for a search engine. */
 export interface SearchEngineConfig {
   enabled: boolean
@@ -700,6 +531,7 @@ export interface HeadlessConfig {
   browserPath?: string
   maxTabs?: number
   launchArgs?: Array<string>
+  proxyUrl?: string
 }
 /** Health monitor configuration for search engines. */
 export interface SearchHealthConfig {
@@ -713,7 +545,7 @@ export interface SearchConfig {
   engines: Record<string, SearchEngineConfig>
   headless?: HeadlessConfig
 }
-/** SubAgent configuration for orchestrator. */
+/** SubAgent configuration for the advanced orchestrator control plane. */
 export interface SubAgentConfig {
   /** Agent type (general, explore, plan, etc.) */
   agentType: string
@@ -721,10 +553,6 @@ export interface SubAgentConfig {
   description: string
   /** Execution prompt */
   prompt: string
-  /** Enable permissive mode (bypass HITL) */
-  permissive: boolean
-  /** Deny rules to enforce even in permissive mode (e.g., ["mcp__longvt__*"]) */
-  permissiveDeny?: Array<string>
   /** Maximum execution steps */
   maxSteps?: number
   /** Execution timeout (milliseconds) */
@@ -737,45 +565,6 @@ export interface SubAgentConfig {
   agentDirs?: Array<string>
   /** Extra directories to scan for skill definition files */
   skillDirs?: Array<string>
-  /**
-   * Lane queue config for External/Hybrid tool dispatch.
-   * When set, tools in the specified lanes are routed to external workers.
-   */
-  laneConfig?: SessionQueueConfig
-}
-/**
- * Unified agent slot — used for both standalone subagents and team members.
- *
- * When `role` is `undefined` the slot describes a standalone subagent.
- * Valid role values: `"lead"`, `"worker"`, `"reviewer"`.
- */
-export interface AgentSlot {
-  /** Agent type (general, explore, plan, etc.) */
-  agentType: string
-  /** Team role: "lead", "worker", or "reviewer". Omit for standalone. */
-  role?: string
-  /** Task description */
-  description: string
-  /** Execution prompt */
-  prompt: string
-  /** Enable permissive mode (bypass HITL) */
-  permissive: boolean
-  /** Deny rules to enforce even in permissive mode (e.g., ["mcp__longvt__*"]) */
-  permissiveDeny?: Array<string>
-  /** Maximum execution steps */
-  maxSteps?: number
-  /** Execution timeout (milliseconds) */
-  timeoutMs?: number
-  /** Parent SubAgent ID (for nesting) */
-  parentId?: string
-  /** Workspace directory (defaults to ".") */
-  workspace?: string
-  /** Extra directories to scan for agent definition files */
-  agentDirs?: Array<string>
-  /** Extra directories to scan for skill definition files */
-  skillDirs?: Array<string>
-  /** Lane queue config for External/Hybrid tool dispatch */
-  laneConfig?: SessionQueueConfig
 }
 /** SubAgent activity type */
 export interface SubAgentActivity {
@@ -805,17 +594,6 @@ export interface SubAgentStateEntry {
   id: string
   state: string
 }
-/** A pending external task waiting for a remote worker to process. */
-export interface PendingExternalTask {
-  /** Unique task identifier — pass this to `completeExternalTask()` */
-  taskId: string
-  /** Tool type: "bash", "write", "edit", etc. */
-  commandType: string
-  /** JSON-encoded tool arguments */
-  payload: string
-  /** Lane name: "Execute", "Query", etc. */
-  lane: string
-}
 /** Streaming event iterator. Use `for await (const event of stream)` or call `.next()` manually. */
 export declare class EventStream {
   /**
@@ -994,10 +772,10 @@ export declare class Agent {
   /**
    * Create an Agent from a config file path or inline config string.
    *
-   * Accepts HCL (.hcl), JSON (.json), ACL (.acl), or inline config strings.
-   * For inline strings: JSON starts with '{', ACL starts with 'providers "', otherwise HCL.
+   * Accepts ACL-compatible config files (.acl) or inline config strings.
+   * JSON config is not supported.
    *
-   * @param configSource - Path to a config file (.hcl/.json/.acl), or inline config string
+   * @param configSource - Path to a config file (.acl), or inline config string
    */
   static create(configSource: string): Promise<Agent>
   /**
@@ -1071,6 +849,8 @@ export declare class Session {
    * Send a prompt and get a streaming event iterator.
    *
    * Returns an `EventStream`. Use `for await (const event of stream)` or call `.next()` manually.
+   * When `history` is omitted, the session history and verification evidence are
+   * updated after the stream completes. Supplying `history` keeps the stream isolated.
    *
    * @param prompt - The prompt to send
    * @param history - Optional conversation history
@@ -1087,6 +867,9 @@ export declare class Session {
   /**
    * Stream a prompt with image attachments.
    *
+   * When `history` is omitted, the session history and verification evidence are
+   * updated after the stream completes. Supplying `history` keeps the stream isolated.
+   *
    * @param prompt - The prompt to send
    * @param attachments - Array of `{ data: Buffer, mediaType: string }`
    * @param history - Optional conversation history
@@ -1096,19 +879,8 @@ export declare class Session {
   history(): Array<MessageObject>
   /** Execute a tool by name, bypassing the LLM. */
   tool(name: string, args: any): Promise<ToolResult>
-  /**
-   * Run a goal through the built-in `run_team` tool.
-   *
-   * Spawns a Lead → Worker → Reviewer team as child subagents: the Lead
-   * decomposes `goal` into tasks, Workers execute them concurrently, and the
-   * Reviewer approves or rejects each result (rejected tasks are retried).
-   *
-   * This is a typed convenience wrapper over `session.tool("run_team", {...})`.
-   * All agent-type arguments default to `"general"` when omitted.
-   *
-   * @returns `ToolResult` whose `output` contains the formatted team run summary.
-   */
-  runTeam(goal: string, leadAgent?: string | undefined | null, workerAgent?: string | undefined | null, reviewerAgent?: string | undefined | null, maxSteps?: number | undefined | null): Promise<ToolResult>
+  /** Run a bounded JavaScript script through the embedded QuickJS `program` tool. */
+  program(options: ProgramScriptOptions): Promise<ToolResult>
   /** Read a file from the workspace. */
   readFile(path: string): Promise<string>
   /** Execute a bash command in the workspace. */
@@ -1121,48 +893,40 @@ export declare class Session {
   webSearch(params: JsWebSearchParams): Promise<ToolResult>
   /** Execute a git command (status, log, branch, checkout, diff, stash, remote, worktree). */
   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. */
+  /** Check if this session has an advanced lane queue configured. */
   hasQueue(): boolean
   /**
-   * Configure a lane's handler mode.
+   * Configure a lane's handler mode for explicit external/hybrid dispatch.
    *
    * @param lane - "control", "query", "execute", or "generate"
    * @param config - { mode: "internal"|"external"|"hybrid", timeoutMs?: number }
    */
   setLaneHandler(lane: string, config: LaneHandlerConfig): Promise<void>
   /**
-   * Complete an external task by ID.
+   * Complete an external queue task by ID.
    *
    * @param taskId - The task identifier
    * @param result - { success: boolean, result?: any, error?: string }
    * @returns true if found, false if not found
    */
   completeExternalTask(taskId: string, result: ExternalTaskResult): Promise<boolean>
-  /** Get pending external tasks. */
+  /** Get pending external queue tasks. */
   pendingExternalTasks(): Promise<any>
-  /** Get queue statistics. */
+  /** Get optional queue statistics. */
   queueStats(): Promise<QueueStats>
-  /**
-   * Submit a JSON payload as a command to the session's lane queue.
-   *
-   * The payload is stored and returned as-is when the queue schedules the
-   * command. Returns a Promise that resolves to the payload value.
-   *
-   * @param lane - "control", "query", "execute", or "generate"
-   * @param payload - Any JSON-serializable value
-   */
-  submit(lane: string, payload: any): Promise<any>
-  /**
-   * Submit multiple JSON payloads as a batch to the session's lane queue.
-   *
-   * More efficient than calling `submit()` in a loop. Returns a Promise that
-   * resolves to an array of results in the same order as the input payloads.
-   *
-   * @param lane - "control", "query", "execute", or "generate"
-   * @param payloads - Array of JSON-serializable values
-   */
-  submitBatch(lane: string, payloads: Array<any>): Promise<Array<any>>
-  /** Get dead letters from the DLQ. */
+  /** Return compact execution trace events recorded for this session. */
+  traceEvents(): any
+  /** Return structured verification reports recorded for this session. */
+  verificationReports(): any
+  /** Return a structured verification summary for this session. */
+  verificationSummary(): any
+  /** Return a concise human-readable verification summary for this session. */
+  verificationSummaryText(): string
+  /** Run verification commands and return a structured verification report. */
+  verifyCommands(subject: string, commands: Array<VerificationCommand>): Promise<any>
+  /** Return project-aware verification command presets for this workspace. */
+  verificationPresets(): any
+  /** Get dead letters from the optional queue's DLQ. */
   deadLetters(): Promise<any>
   /**
    * Get a detailed metrics snapshot from the queue.
@@ -1362,30 +1126,6 @@ export declare class Session {
    * @returns Array of CommandInfo objects sorted by name
    */
   listCommands(): Array<CommandInfo>
-  /**
-   * Schedule a recurring prompt to fire at a given interval.
-   *
-   * This is the programmatic equivalent of `/loop <interval>s <prompt>`.
-   * The scheduled prompt runs automatically after each `send()` call when it is due.
-   *
-   * @param prompt - The prompt to send at each interval
-   * @param intervalSecs - Interval in seconds (minimum: 1)
-   * @returns 8-char hex task ID (use with `cancelScheduledTask`)
-   */
-  scheduleTask(prompt: string, intervalSecs: number): string
-  /**
-   * List all active scheduled tasks for this session.
-   *
-   * @returns Array of ScheduledTaskInfo objects sorted by task ID
-   */
-  listScheduledTasks(): Array<ScheduledTaskInfo>
-  /**
-   * Cancel a scheduled task by ID.
-   *
-   * @param id - Task ID returned by `scheduleTask` or listed by `listScheduledTasks`
-   * @returns `true` if the task was found and cancelled
-   */
-  cancelScheduledTask(id: string): boolean
   /**
    * Cancel the current ongoing operation (send/stream).
    *
@@ -1396,200 +1136,13 @@ export declare class Session {
    */
   cancel(): boolean
   /**
-   * Close the session and stop background tasks such as the cron ticker.
+   * Close the session and cancel any active operation.
    *
    * Call this when the session will no longer be used so Node.js can exit
    * cleanly without waiting on session-scoped background workers.
    */
   close(): void
 }
-/**
- * Shared task board for team coordination.
- *
- * Use `Team.taskBoard()` or `TeamRunner.taskBoard()` to access the board.
- */
-export declare class TeamTaskBoard {
-  /**
-   * Post a new task. Returns the task ID, or null if the board is full.
-   *
-   * @param description - Task description
-   * @param postedBy - Member ID posting the task
-   * @param assignTo - Optional member ID to pre-assign the task to
-   */
-  post(description: string, postedBy: string, assignTo?: string | undefined | null): string | null
-  /** Claim the next open or rejected task for a member. */
-  claim(memberId: string): TeamTask | null
-  /** Mark a task as complete with a result. Returns true if found. */
-  complete(taskId: string, result: string): boolean
-  /** Approve a task (reviewer action). Returns true if the task was in InReview state. */
-  approve(taskId: string): boolean
-  /** Reject a task back to open (reviewer action). Returns true if found. */
-  reject(taskId: string): boolean
-  /** Get a task by ID. */
-  get(taskId: string): TeamTask | null
-  /** 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 }`. */
-  stats(): any
-  /** Total number of tasks on the board. */
-  get len(): number
-  /** True if the board has no tasks. */
-  get isEmpty(): boolean
-}
-/**
- * Multi-agent team coordinator.
- *
- * Create the team, add members, then pass it to `TeamRunner` to execute.
- *
- * @example
- * ```js
- * const team = new Team("refactor-auth");
- * 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");
- * ```
- */
-export declare class Team {
-  /**
-   * Create a new team.
-   *
-   * @param name - Team name
-   * @param config - Optional `TeamConfig` (uses defaults if omitted)
-   */
-  constructor(name: string, config?: TeamConfig | undefined | null)
-  /**
-   * Add a member to the team.
-   *
-   * @param memberId - Unique member identifier
-   * @param role - TeamRole: Lead, Worker, or Reviewer
-   */
-  addMember(memberId: string, role: TeamRole): void
-  /** Remove a member. Returns true if the member was found. */
-  removeMember(memberId: string): boolean
-  /** Number of registered members. */
-  get memberCount(): number
-  /** Get the shared task board for inspection. */
-  taskBoard(): TeamTaskBoard
-}
-/**
- * Binds an agent team to real `Session` executors and runs the workflow.
- *
- * The team object is consumed on construction.
- *
- * @example
- * ```js
- * const runner = new TeamRunner(team);
- * runner.bindSession("lead", leadSession);
- * runner.bindSession("worker-1", workerSession);
- * runner.bindSession("reviewer", reviewerSession);
- * const result = await runner.runUntilDone("Build the feature");
- * for (const task of result.doneTasks) {
- *   console.log(task.id, task.result);
- * }
- * ```
- */
-export declare class TeamRunner {
-  /**
-   * Create a runner from a team.
-   *
-   * The team is consumed: further calls on the original `Team` object will throw.
-   */
-  constructor(team: Team)
-  /**
-   * Create a runner with a default agent context.
-   *
-   * Stores the agent, workspace, and agent directories once so that
-   * subsequent calls to `addLead`, `addWorker`, and `addReviewer` do not
-   * need to repeat them.
-   *
-   * @param agent - The `Agent` to create sessions from
-   * @param workspace - Path to the workspace directory shared by all members
-   * @param agentDirs - Directories to scan for agent definition files
-   */
-  static create(agent: Agent, workspace: string, agentDirs?: Array<string> | undefined | null): TeamRunner
-  /**
-   * Add a Lead member bound to the named agent definition.
-   *
-   * Requires the runner to have been created with `TeamRunner.create(...)`.
-   * The member ID is fixed to `"lead"`.
-   *
-   * Unset fields in `opts` inherit from the agent definition, then from the
-   * `Agent` base config (see `TeamMemberOptions` for the full inheritance chain).
-   *
-   * @param agentName - Name of the agent definition (e.g. `"orchestrator"`)
-   * @param opts - Optional per-member overrides; omit to use agent definition defaults
-   */
-  addLead(agentName: string, opts?: TeamMemberOptions | undefined | null): void
-  /**
-   * Add a Worker member bound to the named agent definition.
-   *
-   * Requires the runner to have been created with `TeamRunner.create(...)`.
-   * Member IDs are auto-generated as `"worker-1"`, `"worker-2"`, etc.
-   * Call this multiple times to add concurrent workers.
-   *
-   * Set `opts.workspace` to a git worktree path to give each worker an
-   * isolated filesystem so concurrent writes do not conflict.
-   * Unset fields inherit from the agent definition, then from the `Agent`
-   * base config (see `TeamMemberOptions` for the full inheritance chain).
-   *
-   * @param agentName - Name of the agent definition (e.g. `"general"`)
-   * @param opts - Optional per-member overrides; omit to use agent definition defaults
-   */
-  addWorker(agentName: string, opts?: TeamMemberOptions | undefined | null): void
-  /**
-   * Add a Reviewer member bound to the named agent definition.
-   *
-   * Requires the runner to have been created with `TeamRunner.create(...)`.
-   * The member ID is fixed to `"reviewer"`.
-   *
-   * Unset fields in `opts` inherit from the agent definition, then from the
-   * `Agent` base config (see `TeamMemberOptions` for the full inheritance chain).
-   *
-   * @param agentName - Name of the agent definition (e.g. `"reviewer"`)
-   * @param opts - Optional per-member overrides; omit to use agent definition defaults
-   */
-  addReviewer(agentName: string, opts?: TeamMemberOptions | undefined | null): void
-  /**
-   * Bind a `Session` to a team member.
-   *
-   * @param memberId - The member ID (must match a member added to the team)
-   * @param session - A `Session` object from `Agent.session()`
-   */
-  bindSession(memberId: string, session: Session): void
-  /**
-   * Bind a team member to a named agent definition.
-   *
-   * Loads the agent by name from built-in agents and optionally from
-   * additional directories, then creates and binds a session with the
-   * agent's permissions, system prompt, model, and step limit applied.
-   *
-   * @param memberId - The member ID (must match a member added to the team)
-   * @param agent - The `Agent` to create the session from
-   * @param workspace - Path to the workspace directory
-   * @param agentName - Name of the agent to load (e.g. "explore", "general")
-   * @param agentDirs - Optional directories to scan for agent files
-   */
-  bindAgent(memberId: string, agent: Agent, workspace: string, agentName: string, agentDirs?: Array<string> | undefined | null): void
-  /** Get the shared task board for inspection. */
-  taskBoard(): TeamTaskBoard
-  /**
-   * Run the Lead → Worker → Reviewer workflow until all tasks are done.
-   *
-   * 1. The Lead member decomposes `goal` into tasks via JSON response.
-   * 2. Worker members concurrently claim and execute tasks.
-   * 3. The Reviewer member approves or rejects completed tasks.
-   * 4. Rejected tasks re-enter the work queue for retry.
-   *
-   * @param goal - High-level goal to decompose and execute
-   * @returns `TeamRunResult` with `doneTasks`, `rejectedTasks`, and `rounds`
-   */
-  runUntilDone(goal: string): Promise<TeamRunResult>
-}
 /** SubAgent handle for control and monitoring. */
 export declare class SubAgentHandle {
   /** Get SubAgent ID */
@@ -1614,36 +1167,21 @@ export declare class SubAgentEventStream {
   /** Receive the next sub-agent event, or `null` on timeout / end-of-stream. */
   recv(timeoutMs?: number | undefined | null): Promise<any | null>
 }
-/** Agent Orchestrator for main-sub agent coordination. */
+/**
+ * Advanced orchestrator for explicit SubAgent lifecycle control.
+ *
+ * Routine multi-agent work should use `task` / `parallelTask` delegation; this
+ * API is for monitoring and controlling long-running SubAgents directly.
+ */
 export declare class Orchestrator {
   /**
    * Create a new orchestrator.
    *
-   * @param agent - Optional `Agent` instance. When provided, spawned SubAgents
-   *                execute real LLM calls using the agent's configuration.
-   *                When omitted, SubAgents run in placeholder mode.
+   * @param agent - `Agent` instance used to execute spawned SubAgents.
    */
-  static create(agent?: Agent | undefined | null): Orchestrator
+  static create(agent: Agent): Orchestrator
   /** Spawn a new SubAgent */
   spawnSubagent(config: SubAgentConfig): SubAgentHandle
-  /**
-   * Spawn a subagent from a unified `AgentSlot` declaration.
-   *
-   * Convenience wrapper over `spawnSubagent` that accepts the unified slot
-   * type.  The `role` field is ignored for standalone spawning — use
-   * `runTeam` for team-based workflows.
-   */
-  spawn(slot: AgentSlot): SubAgentHandle
-  /**
-   * Run a goal through a Lead → Worker → Reviewer team built from AgentSlots.
-   *
-   * Requires `Orchestrator.create(agent)` mode — returns an error if no backing
-   * Agent is configured.  Each slot's `role` field determines its position in the
-   * team; slots without a role default to Worker.
-   *
-   * @returns `TeamRunResult` with `doneTasks`, `rejectedTasks`, and `rounds`.
-   */
-  runTeam(goal: string, workspace: string, slots: Array<AgentSlot>): Promise<TeamRunResult>
   /** Get active SubAgent count */
   activeCount(): number
   /** Get all SubAgent information list */
@@ -1662,17 +1200,4 @@ export declare class Orchestrator {
   cancelSubagent(id: string): void
   /** Wait for all SubAgents to complete */
   waitAll(): void
-  /**
-   * Return any external tasks currently waiting for the given SubAgent.
-   *
-   * Returns an empty array when no tasks are pending or the SubAgent is not found.
-   */
-  pendingExternalTasksFor(subagentId: string): Array<PendingExternalTask>
-  /**
-   * Complete an external task dispatched to a remote worker.
-   *
-   * Returns `true` if the task was found and completed, `false` if no
-   * session with the given `subagent_id` is currently registered.
-   */
-  completeExternalTask(subagentId: string, taskId: string, result: ExternalTaskResult): boolean
 }

package/index.js

@@ -310,8 +310,9 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-const { EventStream, FileMemoryStore, FileSessionStore, MemorySessionStore, DefaultSecurityProvider, SkillPlugin, StdioTransport, HttpTransport, WebSocketTransport, UnixSocketTransport, Agent, Session, builtinSkills, TeamRole, TeamTaskStatus, TeamTaskBoard, Team, TeamRunner, BrowserBackend, SubAgentHandle, SubAgentEventStream, Orchestrator } = nativeBinding
+const { formatVerificationSummary, EventStream, FileMemoryStore, FileSessionStore, MemorySessionStore, DefaultSecurityProvider, SkillPlugin, StdioTransport, HttpTransport, WebSocketTransport, UnixSocketTransport, Agent, Session, builtinSkills, BrowserBackend, SubAgentHandle, SubAgentEventStream, Orchestrator } = nativeBinding
 
+module.exports.formatVerificationSummary = formatVerificationSummary
 module.exports.EventStream = EventStream
 module.exports.FileMemoryStore = FileMemoryStore
 module.exports.FileSessionStore = FileSessionStore
@@ -325,11 +326,6 @@ 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
 module.exports.BrowserBackend = BrowserBackend
 module.exports.SubAgentHandle = SubAgentHandle
 module.exports.SubAgentEventStream = SubAgentEventStream

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@a3s-lab/code",
-  "version": "1.11.0",
-  "description": "A3S Code - Native AI coding agent library for Node.js",
+  "version": "2.0.1",
+  "description": "A3S Code - Native Node.js bindings for the coding-agent runtime",
   "main": "index.js",
   "types": "index.d.ts",
   "napi": {
@@ -38,17 +38,16 @@
     "prepublishOnly": "napi prepublish -t npm",
     "test": "node test.mjs",
     "test:helpers": "node test-helpers.mjs",
-    "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:agentic-search-locators": "node examples/search/test-agentic-search-locators.js",
+    "test:agentic-search-sampled-lines": "node examples/search/test-agentic-search-sampled-lines.js",
+    "test:agentic-parse-llm-blocks": "node examples/search/test-agentic-parse-llm-blocks.js"
   },
   "optionalDependencies": {
-    "@a3s-lab/code-darwin-arm64": "1.11.0",
-    "@a3s-lab/code-linux-x64-gnu": "1.11.0",
-    "@a3s-lab/code-linux-x64-musl": "1.11.0",
-    "@a3s-lab/code-linux-arm64-gnu": "1.11.0",
-    "@a3s-lab/code-linux-arm64-musl": "1.11.0",
-    "@a3s-lab/code-win32-x64-msvc": "1.11.0"
+    "@a3s-lab/code-darwin-arm64": "2.0.1",
+    "@a3s-lab/code-linux-x64-gnu": "2.0.1",
+    "@a3s-lab/code-linux-x64-musl": "2.0.1",
+    "@a3s-lab/code-linux-arm64-gnu": "2.0.1",
+    "@a3s-lab/code-linux-arm64-musl": "2.0.1",
+    "@a3s-lab/code-win32-x64-msvc": "2.0.1"
   }
-}
+}