@mclawnet/agent 0.6.21 → 0.6.23

package/dist/hub-connection.d.ts

@@ -1,6 +1,15 @@
 import type { AgentClientMessage, AgentGenericRequest } from "@mclawnet/shared";
 import type { SessionManager } from "./session-manager.js";
 import type { SwarmCoordinator } from "@mclawnet/swarm";
+/**
+ * Structural type for the schedule runtime; declared locally so hub-connection
+ * does not import from `./schedule-runtime.js` (which itself imports
+ * `./session-manager.js`) — keeps this module's import graph stable and avoids
+ * accidental cycles.
+ */
+interface ScheduleRuntimeBridge {
+    handleHubMessage(msg: unknown): void;
+}
 export interface HubConnectionOptions {
     hubUrl: string;
     token: string;
@@ -37,6 +46,8 @@ export declare class HubConnection {
     private sessionManager;
     /** Swarm coordinator — set after construction via setSwarmCoordinator() */
     private swarmCoordinator;
+    /** Schedule runtime — set after construction via setScheduleRuntime() */
+    private scheduleRuntime;
     /** Namespace-based generic message handlers */
     private namespaceHandlers;
     private onMessage?;
@@ -46,6 +57,7 @@ export declare class HubConnection {
     constructor(opts: HubConnectionOptions);
     setSessionManager(manager: SessionManager): void;
     setSwarmCoordinator(coordinator: SwarmCoordinator): void;
+    setScheduleRuntime(runtime: ScheduleRuntimeBridge): void;
     registerNamespace(namespace: string, handler: (msg: AgentGenericRequest) => Promise<Record<string, unknown>>): void;
     sendPush(namespace: string, event: string, data: Record<string, unknown>): void;
     sendSkillList(skills: Array<{
@@ -67,4 +79,5 @@ export declare class HubConnection {
     private cleanup;
     private cleanupConnection;
 }
+export {};
 //# sourceMappingURL=hub-connection.d.ts.map

package/dist/hub-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hub-connection.d.ts","sourceRoot":"","sources":["../src/hub-connection.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAEV,kBAAkB,EAClB,mBAAmB,EAEpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOxD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAID,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAwB;IAEzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IAEnC,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE9B,iFAAiF;IACjF,OAAO,CAAC,cAAc,CAAqB;IAE3C,uEAAuE;IACvE,OAAO,CAAC,cAAc,CAA+B;IAErD,2EAA2E;IAC3E,OAAO,CAAC,gBAAgB,CAAiC;IAEzD,+CAA+C;IAC/C,OAAO,CAAC,iBAAiB,CAGrB;IAEJ,OAAO,CAAC,SAAS,CAAC,CAA0B;IAC5C,OAAO,CAAC,WAAW,CAAC,CAA4B;IAChD,OAAO,CAAC,YAAY,CAAC,CAAyC;IAC9D,OAAO,CAAC,OAAO,CAAC,CAAuB;gBAE3B,IAAI,EAAE,oBAAoB;IAetC,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,mBAAmB,CAAC,WAAW,EAAE,gBAAgB,GAAG,IAAI;IAIxD,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKzE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASxE,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAOlE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,IAAI,IAAI;IA0Ef,IAAI,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO;IASvC,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,oBAAoB;IA0X5B,OAAO,CAAC,gBAAgB;IA0BxB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,iBAAiB;CAc1B"}
+{"version":3,"file":"hub-connection.d.ts","sourceRoot":"","sources":["../src/hub-connection.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   HubConnection,
   SessionManager,
   startAgent
-} from "./chunk-RIK7IXSW.js";
+} from "./chunk-WJWCYGLQ.js";
 import {
   loadConfig,
   saveConfig

package/dist/schedule-runtime.d.ts

@@ -0,0 +1,125 @@
+import { JsonScheduleRepository, type Schedule, type ScheduleRun, type ScheduleExecutor, type SpawnFn, type SwarmStarter, type TypedEventEmitter, type SchedulerEvents } from "@mclawnet/scheduler";
+import type { SessionManager } from "./session-manager.js";
+import type { SwarmCoordinator } from "@mclawnet/swarm";
+/**
+ * Minimal hub send surface; mirrors HubConnection.send() but kept structural so
+ * the runtime is unit-testable without spinning up a real WebSocket.
+ */
+export interface ScheduleHubSink {
+    send(msg: unknown): boolean;
+}
+/**
+ * Optional repo surface used by ScheduleRuntime — kept structural so tests can
+ * inject a vi.fn-backed fake without subclassing JsonScheduleRepository.
+ */
+export interface ScheduleRepoLike {
+    create: JsonScheduleRepository["create"];
+    update: JsonScheduleRepository["update"];
+    delete: JsonScheduleRepository["delete"];
+    getById: JsonScheduleRepository["getById"];
+    listAll: JsonScheduleRepository["listAll"];
+    listByCwd: JsonScheduleRepository["listByCwd"];
+    listRuns: JsonScheduleRepository["listRuns"];
+    readRunLogs: JsonScheduleRepository["readRunLogs"];
+}
+/**
+ * Optional scheduler surface — same rationale as ScheduleRepoLike. The real
+ * SchedulerService satisfies this implicitly.
+ */
+export interface SchedulerLike {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    register(s: Schedule): void;
+    unregister(id: string): void;
+    triggerNow(id: string): Promise<ScheduleRun>;
+    cancel(runId: string): boolean;
+    events: TypedEventEmitter<SchedulerEvents>;
+}
+export interface ScheduleRuntimeOptions {
+    hub: ScheduleHubSink;
+    /** Real swarm bootstrap deps; only needed when wiring real executors. */
+    sessionManager?: SessionManager;
+    swarmCoordinator?: SwarmCoordinator;
+    /** DI overrides for tests. */
+    repo?: ScheduleRepoLike;
+    scheduler?: SchedulerLike;
+    executors?: {
+        oneshot?: ScheduleExecutor;
+        swarm?: ScheduleExecutor;
+    };
+}
+/**
+ * Bridges Hub WS schedule:* messages to a local SchedulerService + repository,
+ * and lifts SchedulerService events back to the Hub. Construction is fully
+ * dependency-injected so unit tests can run without the real cron/fs layers.
+ *
+ * NOTE (Phase 7+): the hub-side broadcast handler currently routes only the
+ * three push events ({@link Schedule}/{@link ScheduleRun} / `schedule:removed`).
+ * The `:result` and `:error` envelopes sent here are correct on the wire but
+ * will be dropped at the hub until PR-B teaches `schedule-broadcast.ts` to
+ * route them back to the originating user. See plan Task 6.x notes.
+ */
+export declare class ScheduleRuntime {
+    private readonly hub;
+    private readonly repo;
+    private readonly scheduler;
+    private started;
+    private readonly inflight;
+    private readonly onChange;
+    private readonly onRun;
+    constructor(opts: ScheduleRuntimeOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Wraps `hub.send` with a started-flag guard so handlers that race against
+     * `stop()` can't emit phantom messages after the runtime has shut down.
+     */
+    private safeSend;
+    /**
+     * Records `p` in the in-flight set so `stop()` can wait for it, and removes
+     * it on settle. Returns the same promise so callers can `void track(...)`.
+     */
+    private track;
+    /**
+     * Entry point for any `schedule:*` message arriving from the Hub. Always
+     * returns synchronously; per-branch async work runs on its own microtask
+     * chain and reports results back to the hub.
+     */
+    handleHubMessage(msg: unknown): void;
+    private handleCreate;
+    private handleUpdate;
+    private handleDelete;
+    private handlePauseResume;
+    private handleTrigger;
+    private handleList;
+    private handleRuns;
+    private handleLog;
+    private sendError;
+}
+/**
+ * Best-effort SpawnFn for the OneShot executor. Streams stdout/stderr into
+ * bounded buffers, parses stream-json lines (with chunk-boundary safety) to
+ * extract the last assistant text, and honours an external AbortSignal.
+ *
+ * NOTE: tests do NOT exercise the spawn path itself (the binary lookup +
+ * child_process invocation); chunk-boundary parsing and byte-cap behaviour
+ * ARE covered via __tests__/schedule-runtime-spawn.test.ts which mocks
+ * node:child_process.spawn.
+ */
+export declare function makeRealOneShotSpawn(): SpawnFn;
+/**
+ * Placeholder swarm starter. Wiring this to the real swarm runtime requires
+ * piping a one-shot prompt through SwarmCoordinator + SessionManager and
+ * extracting a final summary, which has no precedent yet — left for Phase 7+
+ * once the UI surfaces a "trigger swarm schedule now" affordance.
+ *
+ * TODO(plan Task 6.x follow-up): wire to SwarmCoordinator.create() + listen
+ * for queen completion to resolve { swarmId, sessionId, summary, exitCode }.
+ * See packages/@clawnet/agent/src/schedule-runtime.ts:makeRealSwarmStarter
+ * (this function).
+ */
+export declare function makeRealSwarmStarter(_deps: {
+    sessionManager?: SessionManager;
+    swarmCoordinator?: SwarmCoordinator;
+}): SwarmStarter;
+//# sourceMappingURL=schedule-runtime.d.ts.map

package/dist/schedule-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-runtime.d.ts","sourceRoot":"","sources":["../src/schedule-runtime.ts"],"names":[],"mappings":"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"}

package/dist/session-manager.d.ts

@@ -1,4 +1,6 @@
 import type { BackendAdapter, SpawnOptions } from "./backend-adapter.js";
+import { type SessionKind } from "./errors.js";
+import { type RecoveryReport } from "./checkpoint.js";
 /**
  * Manages active sessions, mapping ClawNet session IDs to BackendProcess instances.
  *
@@ -11,13 +13,31 @@ import type { BackendAdapter, SpawnOptions } from "./backend-adapter.js";
 export declare class SessionManager {
     private sessions;
     private conversationBuffer;
+    private sessionMeta;
+    private activelyExecuting;
     private aborting;
+    private idleSweepTimer;
+    private idleTtlMs;
+    private idleSweepIntervalMs;
+    private checkpointPath;
+    private checkpointDebounceMs;
+    private checkpointDebouncer;
+    private agentStartedAt;
+    private hasRecovered;
+    /**
+     * Carry-over ladder indices from the previous run's checkpoint. Populated by
+     * `recoverFromCheckpoint`, drained one-shot by `createSession`. Without this
+     * a SIGTERM right after escalating to 16k would silently revert the next
+     * spawn back to 32k and re-hit the 168k wall on its first turn.
+     */
+    private recoveredLadderIndex;
     private adapter;
     private onOutput;
     private onTurnComplete;
     private onSessionError;
     private onSessionStarted?;
     private onBeforeClose?;
+    private classify;
     constructor(options: {
         adapter: BackendAdapter;
         onOutput: (sessionId: string, data: unknown) => void;
@@ -38,6 +58,16 @@ export declare class SessionManager {
             role: string;
             content: string;
         }>) => Promise<void>;
+        classify?: (sessionId: string) => SessionKind;
+        /**
+         * (PR-C) Where to write the agent-sessions.json checkpoint. Pass `null`
+         * (or omit) to disable checkpointing entirely — useful for tests and for
+         * the rare embedded use case where there's no writable directory. When
+         * set, the file is written via temp+rename on debounced structural events.
+         */
+        checkpointPath?: string | null;
+        /** (PR-C) Override the 5s debounce window. Tests use ~50ms. */
+        checkpointDebounceMs?: number;
     });
     createSession(options: SpawnOptions): Promise<string>;
     sendInput(sessionId: string, input: string): void;
@@ -54,5 +84,77 @@ export declare class SessionManager {
     isHealthy(sessionId: string): boolean;
     get activeSessionCount(): number;
     getActiveSessionIds(): string[];
+    /**
+     * Recommended `CLAUDE_CODE_MAX_OUTPUT_TOKENS` for the *next* spawn of this
+     * session. Returns `undefined` for unknown sessions OR sessions still at
+     * ladder index 0 — callers omit the env override in that case so the CLI
+     * picks its own default. Returning `undefined` (instead of `32_000`) keeps
+     * env composition free of redundant overrides for the common path.
+     *
+     * Used by hub-connection.spawnAndSend on every reuse / fresh-resume
+     * branch — without that wiring the ladder change in meta would be inert.
+     */
+    getRecommendedMaxOutputTokens(sessionId: string): number | undefined;
+    /**
+     * Start the periodic idle sweeper. Idempotent: a second call is a no-op.
+     * Disabled (no-op) when effective TTL is `<= 0` — set via env
+     * `CLAWNET_CHAT_IDLE_TTL_MS=0` or via the `ttlMs` override.
+     *
+     * The timer is `unref()`-ed so it never blocks process exit.
+     *
+     * @param overrides - test/ops hook to override env-derived defaults.
+     */
+    startIdleSweeper(overrides?: {
+        ttlMs?: number;
+        intervalMs?: number;
+    }): void;
+    stopIdleSweeper(): void;
+    /**
+     * One sweep tick. Exposed for tests (so they can drive sweeps deterministically
+     * without faking interval timers) and for ops scripts. Safe to call concurrently
+     * with normal traffic — the sweeper only ever calls closeSession, which itself
+     * is idempotent on missing IDs.
+     */
+    sweepIdleSessions(): Promise<void>;
+    /**
+     * Build the SessionPoolSnapshot attached to a SessionLimitReachedError.
+     *
+     * "Idle" here means "not currently executing a turn". A session whose
+     * lastActivityAt is hours old but is mid-turn (long-running deep-research)
+     * is intentionally NOT a candidate — pointing the user at it would be
+     * misleading. The selection mirrors `sweepIdleSessions` filters minus the
+     * TTL gate (since at saturation we report the LRU regardless of TTL).
+     */
+    private snapshotPoolForError;
+    /**
+     * Schedule a debounced flush of the in-memory pool to the checkpoint file.
+     *
+     * Burst protection: if a debounce timer is already pending, this is a no-op
+     * — the flush captures the pool state at firing time, so all events in the
+     * 5s window are observable in the eventual snapshot. This collapses the
+     * "create + onSessionStarted + close" 3-event sequence into one disk write.
+     */
+    scheduleCheckpoint(): void;
+    /**
+     * Flush the current pool to the checkpoint file via temp+rename. Public
+     * for tests and for the graceful-shutdown final-flush in `closeAll`.
+     *
+     * Sessions whose underlying BackendProcess has no `pid` (e.g., in-process
+     * mock backends) are skipped — without a pid the recovery probe can't
+     * distinguish dead from alive, and writing them in would just generate
+     * spurious session.died notifications on restart.
+     */
+    flushCheckpoint(): Promise<void>;
+    /**
+     * Read the previous-run checkpoint, classify each entry as `dead` or
+     * `orphan` via pid probe, then reset the file to the current (empty)
+     * truth. Caller (start.ts) is expected to forward `dead` entries to hub
+     * via `session.died` so db's processState clears.
+     *
+     * Returns `{dead: [], orphan: []}` on first boot (no file). Throws on
+     * file-system error or JSON parse failure — start.ts catches and logs so a
+     * corrupt checkpoint does not block agent startup.
+     */
+    recoverFromCheckpoint(): Promise<RecoveryReport>;
 }
 //# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAkB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAOzF;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,kBAAkB,CAA+D;IAKzF,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,cAAc,CAQZ;IACV,OAAO,CAAC,cAAc,CAA6C;IACnE,OAAO,CAAC,gBAAgB,CAAC,CAAiE;IAC1F,OAAO,CAAC,aAAa,CAAC,CAA2F;gBAErG,OAAO,EAAE;QACnB,OAAO,EAAE,cAAc,CAAC;QACxB,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;QACrD,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;YACJ,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,YAAY,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC;SAChD,KACE,IAAI,CAAC;QACV,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QAC3D,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;YAAE,eAAe,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,CAAC;QAClF,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC1G;IASK,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAwH3D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAa3C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;;;;OAKG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMrC,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,mBAAmB,IAAI,MAAM,EAAE;CAGhC"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"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"}

package/dist/skill-loader.d.ts

@@ -35,4 +35,24 @@ export interface PendingNotification {
  * Returns null if there are no pending proposals or the file is unreadable.
  */
 export declare function getPendingNotification(): PendingNotification | null;
+/**
+ * Ensure ~/.clawnet/mcp.json registers the unified `clawnet-mcp` server.
+ *
+ * Behaviour matrix (designed to safely upgrade pre-existing installs):
+ * - File missing                              → write fresh config with clawnet-mcp.
+ * - File present, no clawnet-mcp entry        → add clawnet-mcp; preserve other servers.
+ * - File present, clawnet-mcp at stale path   → rewrite args to current server.js.
+ * - File present, clawnet-mcp already correct → no-op (no disk write).
+ * - File present, malformed JSON              → leave alone, warn (do not destroy user state).
+ * - File present, missing `mcpServers` field  → inject mcpServers without dropping siblings.
+ *
+ * We also drop a legacy `clawnet-memory` entry IF (and only if) it points at
+ * the auto-generated path inside `@mclawnet/agent/node_modules/@mclawnet/memory`.
+ * That path is what older agent versions used to write; the unified clawnet-mcp
+ * supersedes it. A `clawnet-memory` entry pointing elsewhere is treated as
+ * user customization and preserved.
+ *
+ * Exported for testability — tests drive the function directly with mocked fs.
+ */
+export declare function ensureMcpConfig(): void;
 //# sourceMappingURL=skill-loader.d.ts.map

package/dist/skill-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAkJvE;AA6CD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;GAEG;AACH,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAmCxC;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,IAAI,SAAS,EAAE,CAE1C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAmBnE"}
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../src/skill-loader.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhD;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAkJvE;AA6CD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;GAEG;AACH,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAmCxC;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,IAAI,SAAS,EAAE,CAE1C;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,GAAG,IAAI,CAmBnE;AAiBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAiFtC"}

package/dist/start.d.ts

@@ -1,5 +1,6 @@
 import { type AgentConfig } from "./config.js";
 import { HubConnection } from "./hub-connection.js";
+import { ScheduleRuntime } from "./schedule-runtime.js";
 import { SessionManager } from "./session-manager.js";
 import { SwarmCoordinator } from "@mclawnet/swarm";
 import { BrainBridge } from "./brain-bridge.js";
@@ -16,6 +17,7 @@ export declare function startAgent(options: StartOptions): Promise<{
     hub: HubConnection;
     sessionManager: SessionManager;
     swarmCoordinator: SwarmCoordinator;
+    scheduleRuntime: ScheduleRuntime;
     brainBridge: BrainBridge;
     fsBridge: FsBridge;
 }>;

package/dist/start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAa,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmB3D,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAC/D,GAAG,EAAE,aAAa,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC,CAyLD"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAa,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmB3D,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAC/D,GAAG,EAAE,aAAa,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,eAAe,CAAC;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC;CACpB,CAAC,CA4PD"}

package/dist/start.js

@@ -1,6 +1,6 @@
 import {
   startAgent
-} from "./chunk-RIK7IXSW.js";
+} from "./chunk-WJWCYGLQ.js";
 import "./chunk-PJ5M6Q36.js";
 export {
   startAgent

package/dist/swarm-cli-client.d.ts

@@ -0,0 +1,24 @@
+export interface SendControlMessageOptions {
+    hubUrl: string;
+    token: string;
+    hostname?: string;
+    version?: string;
+    capabilities?: string[];
+    /** Total budget for connect+auth+send. Default 5000ms. */
+    timeoutMs?: number;
+    /** How long to wait after sending the post-auth msg before closing. Default 200ms. */
+    postSendDelayMs?: number;
+}
+/**
+ * Open a short-lived authenticated WS to the hub, send a single post-auth
+ * control message, then close. Used by `clawnet-agent swarm new/resume`.
+ *
+ * The connection lifecycle:
+ *   1. Connect → wait for {type:"auth_required"}
+ *   2. Reply with {type:"auth", token, hostname, ...}
+ *   3. Wait for {type:"registered"} — auth confirmed
+ *   4. Send the user-supplied post-auth message
+ *   5. Wait postSendDelayMs (default 200ms) so hub can route, then close
+ */
+export declare function sendControlMessage(msg: object, opts: SendControlMessageOptions): Promise<void>;
+//# sourceMappingURL=swarm-cli-client.d.ts.map

package/dist/swarm-cli-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-cli-client.d.ts","sourceRoot":"","sources":["../src/swarm-cli-client.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA4Ff"}

package/dist/swarm-cli-client.js

@@ -0,0 +1,83 @@
+// src/swarm-cli-client.ts
+import { hostname as osHostname } from "os";
+import WebSocket from "ws";
+import { createLogger } from "@mclawnet/logger";
+var log = createLogger({ module: "swarm-cli-client" });
+function sendControlMessage(msg, opts) {
+  const timeoutMs = opts.timeoutMs ?? 5e3;
+  const postSendDelayMs = opts.postSendDelayMs ?? 200;
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    let authState = "pending";
+    const ws = new WebSocket(opts.hubUrl);
+    const timer = setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      log.warn({ hubUrl: opts.hubUrl, authState }, "control message timed out");
+      try {
+        ws.close();
+      } catch {
+      }
+      reject(new Error(`Timed out after ${timeoutMs}ms (state: ${authState})`));
+    }, timeoutMs);
+    const finish = (err) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      try {
+        ws.close();
+      } catch {
+      }
+      if (err) reject(err);
+      else resolve();
+    };
+    ws.on("open", () => {
+      log.debug({ hubUrl: opts.hubUrl }, "ws opened");
+    });
+    ws.on("message", (raw) => {
+      let data;
+      try {
+        data = JSON.parse(raw.toString());
+      } catch {
+        return;
+      }
+      if (authState === "pending" && data?.type === "auth_required") {
+        authState = "authenticating";
+        const authMsg = {
+          type: "auth",
+          token: opts.token,
+          hostname: opts.hostname ?? osHostname()
+        };
+        if (opts.version !== void 0) authMsg.version = opts.version;
+        if (opts.capabilities !== void 0) authMsg.capabilities = opts.capabilities;
+        ws.send(JSON.stringify(authMsg));
+        return;
+      }
+      if (authState === "authenticating" && data?.type === "registered") {
+        authState = "authenticated";
+        log.info({ agentId: data.agentId }, "registered, sending control message");
+        ws.send(JSON.stringify(msg));
+        setTimeout(() => finish(), postSendDelayMs);
+        return;
+      }
+    });
+    ws.on("close", (code) => {
+      if (settled) return;
+      if (authState !== "authenticated") {
+        finish(new Error(`Hub closed connection during auth (code ${code})`));
+      } else {
+        finish();
+      }
+    });
+    ws.on("error", (err) => {
+      log.error({ err: err.message, authState }, "ws error");
+      if (authState !== "authenticated") {
+        finish(new Error(err.message || "ws connection error"));
+      }
+    });
+  });
+}
+export {
+  sendControlMessage
+};
+//# sourceMappingURL=swarm-cli-client.js.map

package/dist/swarm-cli-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/swarm-cli-client.ts"],"sourcesContent":["import { hostname as osHostname } from \"node:os\";\nimport WebSocket from \"ws\";\nimport { createLogger } from \"@mclawnet/logger\";\n\nconst log = createLogger({ module: \"swarm-cli-client\" });\n\nexport interface SendControlMessageOptions {\n  hubUrl: string;\n  token: string;\n  hostname?: string;\n  version?: string;\n  capabilities?: string[];\n  /** Total budget for connect+auth+send. Default 5000ms. */\n  timeoutMs?: number;\n  /** How long to wait after sending the post-auth msg before closing. Default 200ms. */\n  postSendDelayMs?: number;\n}\n\n/**\n * Open a short-lived authenticated WS to the hub, send a single post-auth\n * control message, then close. Used by `clawnet-agent swarm new/resume`.\n *\n * The connection lifecycle:\n *   1. Connect → wait for {type:\"auth_required\"}\n *   2. Reply with {type:\"auth\", token, hostname, ...}\n *   3. Wait for {type:\"registered\"} — auth confirmed\n *   4. Send the user-supplied post-auth message\n *   5. Wait postSendDelayMs (default 200ms) so hub can route, then close\n */\nexport function sendControlMessage(\n  msg: object,\n  opts: SendControlMessageOptions,\n): Promise<void> {\n  const timeoutMs = opts.timeoutMs ?? 5000;\n  const postSendDelayMs = opts.postSendDelayMs ?? 200;\n\n  return new Promise<void>((resolve, reject) => {\n    let settled = false;\n    let authState: \"pending\" | \"authenticating\" | \"authenticated\" = \"pending\";\n\n    const ws = new WebSocket(opts.hubUrl);\n\n    const timer = setTimeout(() => {\n      if (settled) return;\n      settled = true;\n      log.warn({ hubUrl: opts.hubUrl, authState }, \"control message timed out\");\n      try {\n        ws.close();\n      } catch {\n        // ignore\n      }\n      reject(new Error(`Timed out after ${timeoutMs}ms (state: ${authState})`));\n    }, timeoutMs);\n\n    const finish = (err?: Error) => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      try {\n        ws.close();\n      } catch {\n        // ignore\n      }\n      if (err) reject(err);\n      else resolve();\n    };\n\n    ws.on(\"open\", () => {\n      log.debug({ hubUrl: opts.hubUrl }, \"ws opened\");\n    });\n\n    ws.on(\"message\", (raw) => {\n      let data: any;\n      try {\n        data = JSON.parse(raw.toString());\n      } catch {\n        return;\n      }\n\n      if (authState === \"pending\" && data?.type === \"auth_required\") {\n        authState = \"authenticating\";\n        const authMsg: Record<string, unknown> = {\n          type: \"auth\",\n          token: opts.token,\n          hostname: opts.hostname ?? osHostname(),\n        };\n        if (opts.version !== undefined) authMsg.version = opts.version;\n        if (opts.capabilities !== undefined) authMsg.capabilities = opts.capabilities;\n        ws.send(JSON.stringify(authMsg));\n        return;\n      }\n\n      if (authState === \"authenticating\" && data?.type === \"registered\") {\n        authState = \"authenticated\";\n        log.info({ agentId: data.agentId }, \"registered, sending control message\");\n        ws.send(JSON.stringify(msg));\n        // Give hub a brief moment to route before we close.\n        setTimeout(() => finish(), postSendDelayMs);\n        return;\n      }\n    });\n\n    ws.on(\"close\", (code: number) => {\n      if (settled) return;\n      if (authState !== \"authenticated\") {\n        finish(new Error(`Hub closed connection during auth (code ${code})`));\n      } else {\n        // Closed after success — treat as resolved.\n        finish();\n      }\n    });\n\n    ws.on(\"error\", (err: Error) => {\n      log.error({ err: err.message, authState }, \"ws error\");\n      // Pre-auth errors reject immediately. Once authenticated, defer to the\n      // close handler so the resolution path stays single-source: either the\n      // post-send delay timer resolves first (settled=true makes us idempotent)\n      // or close fires with the final code/reason. The settled flag inside\n      // finish() makes the two paths safe to interleave.\n      if (authState !== \"authenticated\") {\n        finish(new Error(err.message || \"ws connection error\"));\n      }\n    });\n  });\n}\n"],"mappings":";AAAA,SAAS,YAAY,kBAAkB;AACvC,OAAO,eAAe;AACtB,SAAS,oBAAoB;AAE7B,IAAM,MAAM,aAAa,EAAE,QAAQ,mBAAmB,CAAC;AAyBhD,SAAS,mBACd,KACA,MACe;AACf,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,kBAAkB,KAAK,mBAAmB;AAEhD,SAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC5C,QAAI,UAAU;AACd,QAAI,YAA4D;AAEhE,UAAM,KAAK,IAAI,UAAU,KAAK,MAAM;AAEpC,UAAM,QAAQ,WAAW,MAAM;AAC7B,UAAI,QAAS;AACb,gBAAU;AACV,UAAI,KAAK,EAAE,QAAQ,KAAK,QAAQ,UAAU,GAAG,2BAA2B;AACxE,UAAI;AACF,WAAG,MAAM;AAAA,MACX,QAAQ;AAAA,MAER;AACA,aAAO,IAAI,MAAM,mBAAmB,SAAS,cAAc,SAAS,GAAG,CAAC;AAAA,IAC1E,GAAG,SAAS;AAEZ,UAAM,SAAS,CAAC,QAAgB;AAC9B,UAAI,QAAS;AACb,gBAAU;AACV,mBAAa,KAAK;AAClB,UAAI;AACF,WAAG,MAAM;AAAA,MACX,QAAQ;AAAA,MAER;AACA,UAAI,IAAK,QAAO,GAAG;AAAA,UACd,SAAQ;AAAA,IACf;AAEA,OAAG,GAAG,QAAQ,MAAM;AAClB,UAAI,MAAM,EAAE,QAAQ,KAAK,OAAO,GAAG,WAAW;AAAA,IAChD,CAAC;AAED,OAAG,GAAG,WAAW,CAAC,QAAQ;AACxB,UAAI;AACJ,UAAI;AACF,eAAO,KAAK,MAAM,IAAI,SAAS,CAAC;AAAA,MAClC,QAAQ;AACN;AAAA,MACF;AAEA,UAAI,cAAc,aAAa,MAAM,SAAS,iBAAiB;AAC7D,oBAAY;AACZ,cAAM,UAAmC;AAAA,UACvC,MAAM;AAAA,UACN,OAAO,KAAK;AAAA,UACZ,UAAU,KAAK,YAAY,WAAW;AAAA,QACxC;AACA,YAAI,KAAK,YAAY,OAAW,SAAQ,UAAU,KAAK;AACvD,YAAI,KAAK,iBAAiB,OAAW,SAAQ,eAAe,KAAK;AACjE,WAAG,KAAK,KAAK,UAAU,OAAO,CAAC;AAC/B;AAAA,MACF;AAEA,UAAI,cAAc,oBAAoB,MAAM,SAAS,cAAc;AACjE,oBAAY;AACZ,YAAI,KAAK,EAAE,SAAS,KAAK,QAAQ,GAAG,qCAAqC;AACzE,WAAG,KAAK,KAAK,UAAU,GAAG,CAAC;AAE3B,mBAAW,MAAM,OAAO,GAAG,eAAe;AAC1C;AAAA,MACF;AAAA,IACF,CAAC;AAED,OAAG,GAAG,SAAS,CAAC,SAAiB;AAC/B,UAAI,QAAS;AACb,UAAI,cAAc,iBAAiB;AACjC,eAAO,IAAI,MAAM,2CAA2C,IAAI,GAAG,CAAC;AAAA,MACtE,OAAO;AAEL,eAAO;AAAA,MACT;AAAA,IACF,CAAC;AAED,OAAG,GAAG,SAAS,CAAC,QAAe;AAC7B,UAAI,MAAM,EAAE,KAAK,IAAI,SAAS,UAAU,GAAG,UAAU;AAMrD,UAAI,cAAc,iBAAiB;AACjC,eAAO,IAAI,MAAM,IAAI,WAAW,qBAAqB,CAAC;AAAA,MACxD;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}

package/dist/swarm-control-dispatch.d.ts

@@ -0,0 +1,47 @@
+import type { SwarmCoordinator } from "@mclawnet/swarm";
+export interface SwarmSpawnMsg {
+    type: "swarm_spawn";
+    teamName: string;
+    msg?: string;
+    workDir?: string;
+    /** Optional caller-provided id; falls back to randomUUID when absent. */
+    swarmId?: string;
+}
+export interface SwarmResumeMsg {
+    type: "swarm_resume";
+    swarmId: string;
+}
+export type SwarmControlMsg = SwarmSpawnMsg | SwarmResumeMsg;
+export interface DispatchOptions {
+    /** Fallback workDir when CLI omits one. */
+    defaultWorkDir: string;
+    /**
+     * Optional override for the user-home root (no `.clawnet` suffix). Threaded
+     * to InboxStore so process-launched inbox seeds land in the same tree the
+     * coordinator watches. When omitted, falls back to `CLAWNET_HOME` env var
+     * then `homedir()` inside InboxStore.
+     */
+    home?: string;
+}
+export interface DispatchResult {
+    ok: boolean;
+    swarmId?: string;
+    error?: string;
+}
+/**
+ * Coordinator surface used by this dispatcher. The real SwarmCoordinator
+ * implements all of these (getSwarm is a thin lookup over its private map;
+ * findQueenInstance identifies the queen by `definition.type === "queen"`
+ * so custom queen roles with non-default names are also recognised).
+ */
+type CoordLike = Pick<SwarmCoordinator, "create" | "recover" | "inboxRelay"> & {
+    getSwarm?: (id: string) => {
+        workDir?: string;
+    } | undefined;
+    findQueenInstance?: (id: string) => {
+        instanceId: string;
+    } | undefined;
+};
+export declare function handleSwarmControl(coord: CoordLike, msg: SwarmControlMsg, opts: DispatchOptions): Promise<DispatchResult>;
+export {};
+//# sourceMappingURL=swarm-control-dispatch.d.ts.map

package/dist/swarm-control-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-control-dispatch.d.ts","sourceRoot":"","sources":["../src/swarm-control-dispatch.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIxD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,cAAc,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,KAAK,SAAS,GAAG,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,SAAS,GAAG,YAAY,CAAC,GAAG;IAC7E,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5D,iBAAiB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACxE,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CAqDzB"}

package/dist/swarm-session-bridge.d.ts

@@ -0,0 +1,22 @@
+import type { SwarmCoordinator } from "@mclawnet/swarm";
+/**
+ * Build the SessionManager.onSessionStarted handler used by start.ts.
+ *
+ * Two responsibilities:
+ *   1. Forward the early `claude.session_started` frame to the hub so the
+ *      central db can backfill `claude_session_id` (existing behavior).
+ *   2. If the sessionId belongs to an in-process swarm role (convention
+ *      `${swarmId}::${instanceId}`), also push the claudeSessionId into the
+ *      local SwarmCoordinator so it's captured in the snapshot — without
+ *      having to wait for the hub round-trip. This is what lets a restarted
+ *      agent `--resume` the right per-role conversation (Task 4).
+ */
+export declare function createSwarmAwareSessionStartedHandler(deps: {
+    hub: {
+        send: (msg: any) => unknown;
+    };
+    swarmCoordinator: Pick<SwarmCoordinator, "setRoleClaudeSessionIdBySession" | "isSwarmSession">;
+}): (sessionId: string, info: {
+    claudeSessionId: string;
+}) => void;
+//# sourceMappingURL=swarm-session-bridge.d.ts.map

package/dist/swarm-session-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-session-bridge.d.ts","sourceRoot":"","sources":["../src/swarm-session-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD;;;;;;;;;;;GAWG;AACH,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,GAAG,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAA;KAAE,CAAC;IACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,iCAAiC,GAAG,gBAAgB,CAAC,CAAC;CAChG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAyBjE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mclawnet/agent",
-  "version": "0.6.21",
+  "version": "0.6.23",
   "type": "module",
   "exports": {
     ".": {
@@ -22,13 +22,15 @@
   "dependencies": {
     "commander": "^14.0.3",
     "ws": "^8.19.0",
-    "@mclawnet/claude-adapter": "0.1.14",
-    "@mclawnet/logger": "0.1.5",
-    "@mclawnet/memory": "0.1.4",
+    "@mclawnet/scheduler": "0.1.1",
+    "@mclawnet/claude-adapter": "0.1.15",
     "@mclawnet/shared": "0.1.2",
+    "@mclawnet/skill-manager": "0.1.3",
+    "@mclawnet/logger": "0.1.5",
     "@mclawnet/mcp-server": "0.1.3",
+    "@mclawnet/task": "0.1.1",
     "@mclawnet/swarm": "0.1.4",
-    "@mclawnet/skill-manager": "0.1.3"
+    "@mclawnet/memory": "0.1.4"
   },
   "devDependencies": {
     "@types/node": "^22",