@bastani/atomic 0.9.54 → 0.9.55-alpha.1

package/dist/builtin/intercom/recoverable-disconnect.ts

@@ -22,6 +22,12 @@
  * A broker that accepts the socket but does not answer a registration in time is
  * saturated, not gone. Its timeout is recoverable for the same reason, and a
  * background relay that sees it keeps quiet unless the outage persists.
+ *
+ * A broker that retires (idle for its window, asked to shut down, or replaced)
+ * can end a connection that is still registering. That is a lost race, not a
+ * failure of this client: the broker either says so with `broker_retiring`
+ * before it closes, or is gone by the time the client looks. The client spawns
+ * and connects to the replacement.
  */
 
 import { IntercomLiveRouteRefusedError } from "./live-route-refusal.js";
@@ -61,9 +67,27 @@ export class IntercomBrokerTimeoutError extends Error implements RecoverableDisc
 	}
 }
 
+/** The `registration_failed` code a retiring broker answers a registration with before it closes. */
+export const BROKER_RETIRING_CODE = "broker_retiring";
+export const BROKER_RETIRING_REASON = "Intercom broker is retiring; connect to its replacement";
+
+/**
+ * Raised when the broker a client was registering with retired first: it answered `broker_retiring`, or it ended
+ * the connection before answering and no longer answers on its socket. A replacement broker can be spawned and the
+ * registration tried again.
+ */
+export class IntercomBrokerRetiringError extends Error implements RecoverableDisconnectMarker {
+	readonly intercomRecoverableDisconnect = true;
+
+	constructor(message: string = BROKER_RETIRING_REASON, options?: ErrorOptions) {
+		super(message, options);
+		this.name = "IntercomBrokerRetiringError";
+	}
+}
+
 /**
- * True for an `IntercomClientDisconnectedError`, an `IntercomBrokerTimeoutError`, or a transient
- * `IntercomLiveRouteRefusedError`, directly or as a bounded `cause` ancestor.
+ * True for an `IntercomClientDisconnectedError`, an `IntercomBrokerTimeoutError`, an `IntercomBrokerRetiringError`,
+ * or a transient `IntercomLiveRouteRefusedError`, directly or as a bounded `cause` ancestor.
  */
 export function isRecoverableIntercomDisconnect(error: unknown): boolean {
 	let current: unknown = error;
@@ -71,6 +95,7 @@ export function isRecoverableIntercomDisconnect(error: unknown): boolean {
 		if (!(current instanceof Error)) return false;
 		if (current instanceof IntercomClientDisconnectedError) return true;
 		if (current instanceof IntercomBrokerTimeoutError) return true;
+		if (current instanceof IntercomBrokerRetiringError) return true;
 		if (current instanceof IntercomLiveRouteRefusedError) return current.transient;
 		current = current.cause;
 	}
@@ -87,3 +112,14 @@ export function isIntercomBrokerTimeout(error: unknown): boolean {
 	}
 	return false;
 }
+
+/** True for an `IntercomBrokerRetiringError`, directly or as a bounded `cause` ancestor. */
+export function isIntercomBrokerRetiring(error: unknown): boolean {
+	let current: unknown = error;
+	for (let depth = 0; depth <= MAX_CAUSE_DEPTH; depth += 1) {
+		if (!(current instanceof Error)) return false;
+		if (current instanceof IntercomBrokerRetiringError) return true;
+		current = current.cause;
+	}
+	return false;
+}

package/dist/builtin/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/mcp",
-  "version": "0.9.54",
+  "version": "0.9.55-alpha.1",
   "private": true,
   "description": "Atomic's pi-compatible MCP integration for server connections, OAuth, tools, resources, and terminal management.",
   "contributors": [

package/dist/builtin/subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/subagents",
-  "version": "0.9.54",
+  "version": "0.9.55-alpha.1",
   "private": true,
   "description": "Atomic extension for delegating tasks to subagents with parallel execution. Fork of: https://github.com/nicobailon/pi-subagents",
   "contributors": [

package/dist/builtin/web-access/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/web-access",
-  "version": "0.9.54",
+  "version": "0.9.55-alpha.1",
   "private": true,
   "description": "Atomic extension for web search, URL fetching, GitHub repo cloning, PDF/video extraction. Fork of: https://github.com/nicobailon/pi-web-access",
   "contributors": [

package/dist/builtin/workflows/CHANGELOG.md

@@ -6,6 +6,32 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.9.55] - 2026-10-30
+
+Local worker pools on remote databases, and sturdier start-up on busy and Windows machines.
+
+- **Worker pools on any journal:** local worker pools (`workflows.localWorkers`) now run when the workflow journal is a libSQL or Turso database or another journal adapter, not only the default local SQLite file. Runs and events go to the journal; the pool's queue, leases and pooled-stage sessions stay in a local database on your machine ([#4128](https://github.com/bastani-inc/atomic/pull/4128))
+- **Intercom that starts when the machine is busy:** a new broker gets 30 seconds to start (`brokerStartupTimeoutMs`), a broker that crashes at start-up is reported at once on Windows too, and a session that connects as its broker retires reconnects instead of failing ([#4126](https://github.com/bastani-inc/atomic/pull/4126))
+- **Session writes on Windows:** a session lock directory Windows won't remove at once no longer fails a write or holds up the next one for ten seconds ([#4124](https://github.com/bastani-inc/atomic/pull/4124))
+- **libSQL files shared between processes:** a `file:` database opened through `@bastani/atomic-storage-libsql` waits for another process's lock instead of failing
+
+### Added
+
+- Local worker pools (`workflows.localWorkers`, `RunOpts.localWorkers`) now work when the workflow journal is not the default local SQLite file: a libSQL or Turso database, any other storage adapter, or a SQLite file with a custom prefix. The workers open the same journal the root uses, and the pool keeps its work queue, leases, admission state and worker logs in a SQLite file under `~/.atomic/workflows/pool/`. A pooled root on such a journal resumes on the machine where it ran; resuming it elsewhere fails with an error naming that machine. A memory journal and a journal passed to the SDK as an object still cannot host workers.
+
+## [0.9.55-alpha.1] - 2026-10-30
+
+Local worker pools on remote databases, and sturdier start-up on busy and Windows machines.
+
+- **Worker pools on any journal:** local worker pools (`workflows.localWorkers`) now run when the workflow journal is a libSQL or Turso database or another journal adapter, not only the default local SQLite file. Runs and events go to the journal; the pool's queue, leases and pooled-stage sessions stay in a local database on your machine ([#4128](https://github.com/bastani-inc/atomic/pull/4128))
+- **Intercom that starts when the machine is busy:** a new broker gets 30 seconds to start (`brokerStartupTimeoutMs`), a broker that crashes at start-up is reported at once on Windows too, and a session that connects as its broker retires reconnects instead of failing ([#4126](https://github.com/bastani-inc/atomic/pull/4126))
+- **Session writes on Windows:** a session lock directory Windows won't remove at once no longer fails a write or holds up the next one for ten seconds ([#4124](https://github.com/bastani-inc/atomic/pull/4124))
+- **libSQL files shared between processes:** a `file:` database opened through `@bastani/atomic-storage-libsql` waits for another process's lock instead of failing
+
+### Added
+
+- Local worker pools (`workflows.localWorkers`, `RunOpts.localWorkers`) now work when the workflow journal is not the default local SQLite file: a libSQL or Turso database, any other storage adapter, or a SQLite file with a custom prefix. The workers open the same journal the root uses, and the pool keeps its work queue, leases, admission state and worker logs in a SQLite file under `~/.atomic/workflows/pool/`. A pooled root on such a journal resumes on the machine where it ran; resuming it elsewhere fails with an error naming that machine. A memory journal and a journal passed to the SDK as an object still cannot host workers.
+
 ## [0.9.52] - 2026-10-29
 
 Stage chats show their own status lines, and web search keeps its results.

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.54",
+  "version": "0.9.55-alpha.1",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [

package/dist/builtin/workflows/src/durable/journal/resolution.d.ts

@@ -19,5 +19,12 @@ export interface RunJournalResolutionOptions {
 }
 export declare function selectRunJournal(options?: RunJournalResolutionOptions): StorageSelection | RunJournal;
 export declare function resolveRunJournal(options?: RunJournalResolutionOptions): Promise<RunJournal>;
+/** The storage selection a journal was opened from, so another process can open the same journal. */
+export interface RunJournalOrigin {
+    readonly selection: StorageSelection;
+    readonly agentDir: string;
+}
+/** Where a journal came from; undefined for a journal an SDK caller passed as an object, which no other process can open. */
+export declare function runJournalOrigin(journal: RunJournal): RunJournalOrigin | undefined;
 export declare function openSelectedRunJournal(selection: StorageSelection | RunJournal, agentDir?: string): Promise<RunJournal>;
 export declare function withRunJournalConfigSource<T>(selection: StorageSelection | RunJournal, open: () => Promise<T>): Promise<T>;