@a3s-lab/code 4.0.0 → 4.2.0

package/README.md

@@ -320,6 +320,25 @@ console.log(await session.mcps())
 The positional `addMcpServer(...)` overload and longer
 `addMcpServerConfig(...)` alias remain for compatibility.
 
+## Filesystem-First Agents
+
+Define a durable agent as a **directory** — `instructions.md` (required) plus
+optional `agent.acl`, `skills/`, `schedules/` (cron), and `tools/` (`kind: mcp` or
+`kind: script` sandboxed QuickJS) — and serve its schedules. Each fire is a full
+harness turn (context, tool visibility, safety gate, verification). Returns a
+handle you must keep and stop explicitly.
+
+```js
+const handle = await agent.serveAgentDir('./my-agent', './workspace', {
+  // Optional: pass a sessionStore so each schedule resumes its accumulated
+  // context across daemon restarts.
+  sessionStore: new FileSessionStore('./sessions'),
+})
+// ... runs in the background until:
+await handle.stop()
+console.log(handle.isStopped()) // true
+```
+
 ## HITL Confirmations
 
 Use `permissionPolicy` to decide which tools ask, then `confirmationPolicy` to

package/generated.d.ts

@@ -413,6 +413,13 @@ export interface SessionOptions {
   builtinSkills?: boolean
   /** Extra directories to scan for skill files (.md with YAML frontmatter). */
   skillDirs?: Array<string>
+  /**
+   * Whether active skill allowed-tools restrict ordinary session tool calls.
+   *
+   * Defaults to false. Set true to restore the legacy global active-skill
+   * restriction before permission policy, hooks, HITL, or AHP run.
+   */
+  enforceActiveSkillToolRestrictions?: boolean
   /** Extra directories to scan for agent files. */
   agentDirs?: Array<string>
   /** Reproducible disposable workers to register for task delegation. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/code",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "description": "A3S Code - Native Node.js bindings for the coding-agent runtime",
   "main": "index.js",
   "types": "index.d.ts",
@@ -43,11 +43,11 @@
     "test:helpers": "node test-helpers.mjs"
   },
   "optionalDependencies": {
-    "@a3s-lab/code-darwin-arm64": "4.0.0",
-    "@a3s-lab/code-linux-x64-gnu": "4.0.0",
-    "@a3s-lab/code-linux-x64-musl": "4.0.0",
-    "@a3s-lab/code-linux-arm64-gnu": "4.0.0",
-    "@a3s-lab/code-linux-arm64-musl": "4.0.0",
-    "@a3s-lab/code-win32-x64-msvc": "4.0.0"
+    "@a3s-lab/code-darwin-arm64": "4.2.0",
+    "@a3s-lab/code-linux-x64-gnu": "4.2.0",
+    "@a3s-lab/code-linux-x64-musl": "4.2.0",
+    "@a3s-lab/code-linux-arm64-gnu": "4.2.0",
+    "@a3s-lab/code-linux-arm64-musl": "4.2.0",
+    "@a3s-lab/code-win32-x64-msvc": "4.2.0"
   }
 }