@mclawnet/agent 0.6.35 → 0.6.36

package/dist/hub-connection.d.ts

@@ -1,6 +1,13 @@
 import type { AgentClientMessage, AgentGenericRequest } from "@mclawnet/shared";
 import type { SessionManager } from "./session-manager.js";
-import type { SwarmCoordinator } from "@mclawnet/swarm";
+import type { SwarmCoordinator, WorkspaceManager } from "@mclawnet/swarm";
+/**
+ * Test-only re-exports. Production code MUST NOT import these — they exist
+ * to let the wake-watch regression test pin the values without widening the
+ * public module surface.
+ */
+export declare const __TEST_ONLY_WAKE_WATCH_INTERVAL_MS = 1000;
+export declare const __TEST_ONLY_WAKE_WATCH_JUMP_THRESHOLD_MS = 15000;
 /**
  * Structural type for the schedule runtime; declared locally so hub-connection
  * does not import from `./schedule-runtime.js` (which itself imports
@@ -23,6 +30,20 @@ export interface HubConnectionOptions {
     onConnect?: (agentId: string) => void;
     onDisconnect?: (code: number, reason: string) => void;
     onError?: (err: Error) => void;
+    /**
+     * M7.3: invoked on every inbound authenticated message (after `registered`,
+     * before dispatch) so the AlwaysOnManager can defer ticks while the user
+     * is in the loop. Pure side-effect; throws are swallowed.
+     */
+    onActivity?: () => void;
+    /**
+     * (N5) Shared WorkspaceManager — used by session.create when `useWorktree`
+     * is set, to prepare an isolated workspace before SessionManager.createSession
+     * runs. Optional so that test harnesses can omit it (sessions without
+     * `useWorktree` never touch it). When omitted, useWorktree:true silently
+     * degrades to direct workDir.
+     */
+    workspaceManager?: WorkspaceManager;
 }
 export declare class HubConnection {
     private ws;
@@ -63,6 +84,9 @@ export declare class HubConnection {
     private onConnectCb?;
     private onDisconnect?;
     private onError?;
+    private onActivity?;
+    /** (N5) Shared WorkspaceManager for chat `useWorktree` flow. */
+    private workspaceManager?;
     constructor(opts: HubConnectionOptions);
     setSessionManager(manager: SessionManager): void;
     setSwarmCoordinator(coordinator: SwarmCoordinator): void;

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

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

package/dist/ideas-rest-client.d.ts

@@ -0,0 +1,25 @@
+import type { IdeasClient } from "@mclawnet/swarm";
+export interface IdeasRestClientOptions {
+    /**
+     * Hub URL. Accepts either ws(s):// (the agent's primary connection URL,
+     * /ws/agent suffix is stripped automatically) or http(s):// — the client
+     * normalises to http(s):// for fetch.
+     */
+    hubUrl: string;
+    /**
+     * Returns the token to send as `Authorization: Bearer <token>`. Sync or
+     * async. Returning null/undefined makes the client throw — IdeaTodoSource
+     * treats that as "no ideas" and the cascade falls through.
+     */
+    getAuthToken: () => string | null | undefined | Promise<string | null | undefined>;
+    /** Optional fetch override (tests). Defaults to globalThis.fetch. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Convert an agent hubUrl into the REST base. The agent typically holds a
+ * ws(s):// URL ending in /ws/agent; we strip that suffix and switch protocol.
+ * Plain http(s):// URLs pass through unchanged.
+ */
+export declare function normalizeHubUrlToHttp(hubUrl: string): string;
+export declare function createIdeasRestClient(opts: IdeasRestClientOptions): IdeasClient;
+//# sourceMappingURL=ideas-rest-client.d.ts.map

package/dist/ideas-rest-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ideas-rest-client.d.ts","sourceRoot":"","sources":["../src/ideas-rest-client.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAyB,WAAW,EAA+B,MAAM,iBAAiB,CAAC;AAEvG,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACnF,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAWD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ5D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,WAAW,CA8E/E"}

package/dist/index.js

@@ -4,15 +4,15 @@ import {
   HubConnection,
   SessionManager,
   startAgent
-} from "./chunk-B733MQCA.js";
+} from "./chunk-GOCWMRBB.js";
 import {
   __resetBackendFactoryCache,
   createBackendAdapter
-} from "./chunk-FYM7CXUI.js";
+} from "./chunk-VAEFJLPL.js";
 import {
   loadConfig,
   saveConfig
-} from "./chunk-PJ5M6Q36.js";
+} from "./chunk-376QZ7JB.js";
 
 // src/index.ts
 import {

package/dist/{linux-IHA4O633.js → linux-MBU6ERXL.js}

@@ -4,8 +4,8 @@ import {
   getLogDir,
   getNodePath,
   loadServiceConfig
-} from "./chunk-M2CDVPQF.js";
-import "./chunk-PJ5M6Q36.js";
+} from "./chunk-JH6RGJBQ.js";
+import "./chunk-376QZ7JB.js";
 
 // src/service/linux.ts
 import { execSync, spawn } from "child_process";
@@ -173,4 +173,4 @@ export {
   generateUnit,
   getUnitPath
 };
-//# sourceMappingURL=linux-IHA4O633.js.map
+//# sourceMappingURL=linux-MBU6ERXL.js.map

package/dist/{macos-G4VK2253.js → macos-I2DUWFUH.js}

@@ -4,8 +4,8 @@ import {
   getLogDir,
   getNodePath,
   loadServiceConfig
-} from "./chunk-M2CDVPQF.js";
-import "./chunk-PJ5M6Q36.js";
+} from "./chunk-JH6RGJBQ.js";
+import "./chunk-376QZ7JB.js";
 
 // src/service/macos.ts
 import { execSync, spawn } from "child_process";
@@ -194,4 +194,4 @@ export {
   generatePlist,
   getPlistPath
 };
-//# sourceMappingURL=macos-G4VK2253.js.map
+//# sourceMappingURL=macos-I2DUWFUH.js.map

package/dist/projects-handler.d.ts

@@ -1,5 +1,20 @@
+import type { ShipmentListEntry, AlwaysOnConfig as WireAlwaysOnConfig, AlwaysOnSnapshot, AlwaysOnTickRecord, ProjectsEnsureProjectResult } from "@mclawnet/shared";
+import { type ShipmentActionKind, type ProjectSummary, type AlwaysOnConfig, type AlwaysOnPersistedConfig } from "@mclawnet/swarm";
+type ProjectWorkdirErrorCode = NonNullable<NonNullable<ProjectsEnsureProjectResult["error"]>["code"]>;
+type ProjectEnsureError = {
+    status: number;
+    message: string;
+    code?: ProjectWorkdirErrorCode;
+    details?: Record<string, unknown>;
+};
+export declare function handleWorkdirMkdir(workDirInput: string): Promise<{
+    ok: boolean;
+    workDir?: string;
+    created?: boolean;
+    error: ProjectEnsureError | null;
+}>;
 export declare function handleProjectsList(): Promise<{
-    projects: import("@mclawnet/swarm").ProjectSummary[];
+    projects: ProjectSummary[];
 }>;
 export declare function handleProjectsGet(encodedCwd: string): Promise<{
     project: null;
@@ -14,6 +29,16 @@ export declare function handleProjectsGet(encodedCwd: string): Promise<{
         taskCounts: import("@mclawnet/swarm").TaskCounts;
     };
 }>;
+export declare function handleProjectsEnsureProject(workDirInput: string, opts?: {
+    createDir?: boolean;
+}): Promise<{
+    ok: boolean;
+    project: ProjectSummary | null;
+    encodedCwd?: string;
+    workDir?: string;
+    createdMeta?: boolean;
+    error: ProjectEnsureError | null;
+}>;
 export declare function handleProjectsTasks(encodedCwd: string, filters?: {
     status?: string;
     swarmId?: string;
@@ -123,4 +148,124 @@ export declare function handleProjectsFileWrite(encodedCwd: string, relPath: str
         details?: undefined;
     };
 }>;
+export declare function handleProjectsShipmentGet(encodedCwd: string, swarmId: string): Promise<{
+    projectFound: boolean;
+    shipment: import("@mclawnet/swarm").ShipmentResult | null;
+    diffContent?: string;
+    reportContent?: string;
+}>;
+/**
+ * M6.2 hotfix S4: return the FULL diff.patch (no 1 MiB inline cap). Used by
+ * the hub's `GET .../shipment/diff` route to serve `text/plain` so the user
+ * can download the patch when the inline DiffViewer truncates at 5000 lines.
+ *
+ * Returns `content: null` (with `projectFound: true`) when the swarm exists
+ * but never shipped a diff (strategy=pr only, skipped, etc.) — hub maps to
+ * 404. `projectFound: false` is the missing-project 404.
+ */
+export declare function handleProjectsShipmentDiffFull(encodedCwd: string, swarmId: string): Promise<{
+    projectFound: boolean;
+    content: string | null;
+}>;
+export declare function handleProjectsShipmentAction(encodedCwd: string, swarmId: string, action: ShipmentActionKind, force?: boolean): Promise<{
+    projectFound: boolean;
+    ok: boolean;
+    message?: string;
+    newBranchName?: string;
+    error?: string;
+}>;
+/**
+ * M6.3: cross-swarm shipment history listing. Scans every
+ * `<projectsDir>/<encoded>/swarms/<id>/shipment.json` and returns the parsed
+ * snapshot per swarm so the UI can render a "Shipments" tab in MyProjectPage
+ * without N round-trips. Corrupt JSON files are skipped with a warn so one
+ * bad swarm directory can't break the whole list.
+ *
+ * Sort order: `createdAt` desc (newest first). When `createdAt` is missing
+ * (legacy M6.1 shipments wrote without the field) the entry sinks to the
+ * bottom — fine for back-compat, the UI shows "—" for the time column.
+ *
+ * `projectFound: false` distinguishes "project doesn't exist" (404) from
+ * "no swarms / no shipments yet" (200 + empty list). Missing `swarms/` dir
+ * is the latter — a freshly opened project before its first run.
+ */
+export declare function handleProjectsShipmentsList(encodedCwd: string): Promise<{
+    projectFound: boolean;
+    shipments: ShipmentListEntry[];
+}>;
+interface AlwaysOnHooks {
+    /** Returns the live snapshot for the project, or null when no scheduler is wired. */
+    getSnapshot(workDir: string): AlwaysOnSnapshot | null;
+    /** Called after a config write so the runner can resize timers / re-arm pause. */
+    applyConfig(workDir: string, config: AlwaysOnPersistedConfig): void;
+    /**
+     * M7.3: called on every inbound hub message so the userActive gate can
+     * defer ticks while the user is still in the loop. Pure side-effect — no
+     * return value, never throws (manager swallows on its end).
+     */
+    recordActivity(): void;
+    /**
+     * B6 — dev-only force-tick. Returns the TickRecord + post-tick snapshot
+     * for the project, or null when no scheduler is booted (the handler will
+     * surface this as projectFound=false). Optional so the no-op fallback can
+     * leave it undefined.
+     */
+    forceTick?(workDir: string): Promise<{
+        record: AlwaysOnTickRecord;
+        snapshot: AlwaysOnSnapshot;
+    } | null>;
+}
+/**
+ * Wire a real DiscoveryScheduler / WorkCycleRunner into the projects-handler.
+ * Intended for M7.3's `start.ts` to call once at agent boot. Passing partial
+ * hooks is allowed; missing hooks fall back to the no-op defaults so the
+ * caller never has to provide all of them.
+ */
+export declare function _registerAlwaysOnHooks(hooks: Partial<AlwaysOnHooks>): void;
+/** Test-only reset; M7.3 won't need this in production. */
+export declare function _resetAlwaysOnHooks(): void;
+/** Test/agent helper: forward an activity ping to whichever manager is wired. */
+export declare function _recordAlwaysOnActivity(): void;
+export declare function handleProjectsAlwaysOnGet(encodedCwd: string): Promise<{
+    projectFound: boolean;
+    config: WireAlwaysOnConfig;
+    snapshot: AlwaysOnSnapshot;
+}>;
+export declare function handleProjectsAlwaysOnSet(encodedCwd: string, patch: Omit<Partial<AlwaysOnConfig>, "pausedUntil"> & {
+    pausedUntil?: string | null;
+}): Promise<{
+    projectFound: boolean;
+    config: WireAlwaysOnConfig;
+    snapshot: AlwaysOnSnapshot;
+    error?: string;
+}>;
+/**
+ * B6 — dev-only force-tick handler. Hub gates the corresponding HTTP route
+ * on `NODE_ENV !== "production"` so prod never reaches here. Defense in
+ * depth: if no forceTick hook is wired we still return a safe shape rather
+ * than crash.
+ *
+ * Error classification (PR-A2 follow-up):
+ *   - `workDir` unresolvable      → projectFound:false (hub → 404)
+ *   - forceTick hook absent       → projectFound:true + "manager not wired"
+ *   - forceTick throws "no scheduler for ..."
+ *                                 → projectFound:true + "scheduler not booted ..."
+ *                                   (actionable: tells dev to PATCH /always-on first)
+ *   - forceTick throws "tick is already in progress"
+ *                                 → projectFound:true + "another tick in flight ..."
+ *                                   (actionable: tells dev to wait or check the runner)
+ *   - any other throw             → projectFound:true + "force-tick failed: <msg>"
+ *
+ * The previous version caught everything as "scheduler not booted", which
+ * actively misled dev tools (e.g. when the real cause was an in-flight
+ * tick, the error said "enable via PATCH" which was already done).
+ */
+export declare function handleProjectsAlwaysOnTickNow(encodedCwd: string): Promise<{
+    projectFound: boolean;
+    decision?: string;
+    gateBreakdown?: AlwaysOnTickRecord["gateBreakdown"];
+    snapshot?: AlwaysOnSnapshot;
+    error?: string;
+}>;
+export {};
 //# sourceMappingURL=projects-handler.d.ts.map

package/dist/projects-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projects-handler.d.ts","sourceRoot":"","sources":["../src/projects-handler.ts"],"names":[],"mappings":"AAqBA,wBAAsB,kBAAkB;;GAEvC;AAED,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;GAMzD;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO;;GAWpE;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;GAM1E;AAED,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM;;GAK5D;AAED,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;GAQ5E;AAID,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;;GAmC9E;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM;;;;;;;;;;;;GAenB;AAGD,wBAAsB,4BAA4B,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;GAOrF;AAED,wBAAsB,uBAAuB,CAAC,UAAU,EAAE,MAAM;;;GAK/D;AAED,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;GAqB/E;AAED,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;GAsBrB"}
+{"version":3,"file":"projects-handler.d.ts","sourceRoot":"","sources":["../src/projects-handler.ts"],"names":[],"mappings":"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"}

package/dist/service/index.js

@@ -9,22 +9,22 @@ import {
   mergeServiceConfig,
   saveServiceConfig,
   validateServiceConfig
-} from "../chunk-M2CDVPQF.js";
-import "../chunk-PJ5M6Q36.js";
+} from "../chunk-JH6RGJBQ.js";
+import "../chunk-376QZ7JB.js";
 
 // src/service/index.ts
 async function getServiceManager() {
   switch (process.platform) {
     case "darwin": {
-      const { MacOSServiceManager } = await import("../macos-G4VK2253.js");
+      const { MacOSServiceManager } = await import("../macos-I2DUWFUH.js");
       return new MacOSServiceManager();
     }
     case "linux": {
-      const { LinuxServiceManager } = await import("../linux-IHA4O633.js");
+      const { LinuxServiceManager } = await import("../linux-MBU6ERXL.js");
       return new LinuxServiceManager();
     }
     case "win32": {
-      const { WindowsServiceManager } = await import("../windows-P6U3JLUZ.js");
+      const { WindowsServiceManager } = await import("../windows-PEJ3KOLC.js");
       return new WindowsServiceManager();
     }
     default:

package/dist/session-manager.d.ts

@@ -1,3 +1,4 @@
+import type { WorkspaceHandle } from "@mclawnet/swarm";
 import type { BackendAdapter, PermissionDecision, PermissionRequest, SpawnOptions } from "./backend-adapter.js";
 import { type SessionKind } from "./errors.js";
 import { type RecoveryReport } from "./checkpoint.js";
@@ -14,6 +15,7 @@ export declare class SessionManager {
     private sessions;
     private conversationBuffer;
     private sessionMeta;
+    private stickyState;
     private activelyExecuting;
     private aborting;
     private expectedExits;
@@ -63,6 +65,14 @@ export declare class SessionManager {
      */
     private onSessionExit?;
     private onPermissionRequest?;
+    /**
+     * (N5) Fires when `closeSession` runs against a session that had a
+     * workspace handle attached via {@link SessionManager.attachWorkspace}.
+     * Receives the original handle so the host can dispose it (keep=true) and
+     * notify hub via `session.worktree_closed`. Never blocks the close path —
+     * exceptions are caught and logged.
+     */
+    private onWorkspaceClose?;
     private classify;
     constructor(options: {
         adapter: BackendAdapter;
@@ -97,6 +107,12 @@ export declare class SessionManager {
          * Use {@link SessionManager.respondToPermission} to deliver the decision back.
          */
         onPermissionRequest?: (sessionId: string, req: PermissionRequest) => void;
+        /**
+         * (N5) Invoked synchronously from {@link SessionManager.closeSession} when
+         * the session had a workspace handle attached. Caller typically disposes
+         * the handle (keep=true) and sends `session.worktree_closed` to hub.
+         */
+        onWorkspaceClose?: (sessionId: string, handle: WorkspaceHandle) => void;
         classify?: (sessionId: string) => SessionKind;
         /**
          * (PR-C) Where to write the agent-sessions.json checkpoint. Pass `null`
@@ -117,6 +133,48 @@ export declare class SessionManager {
      * block the user's turn on memory.
      */
     sendUserInput(sessionId: string, content: string): Promise<void>;
+    /**
+     * (N2/N3) Update sticky model/mode on a session. Survives abort/respawn
+     * because it writes to `stickyState`, which is independent of `sessionMeta`
+     * (cleared on abort). Partial: fields with `undefined` are not touched.
+     *
+     * Valid use cases:
+     * - patch sticky on a live session (mutates meta + stickyState)
+     * - stage sticky BEFORE the first session.create lands (writes only to
+     *   stickyState — meta is created later by createSession, which mirrors
+     *   from stickyState)
+     *
+     * No-throw on missing session; this method is best-effort state staging.
+     */
+    updateSticky(sessionId: string, sticky: {
+        model?: string;
+        mode?: string;
+    }): void;
+    /**
+     * (N2/N3) Stage a per-turn override for the very next spawn. Consumed
+     * (and deleted from stickyState) by the next `createSession` for this
+     * sessionId. Survives abort/respawn until consumed — so a hub-side
+     * abort+recreate driven by a model switch still carries the override.
+     *
+     * No-throw on missing session: same staging-before-alive use case as
+     * `updateSticky`.
+     */
+    setTurnOverride(sessionId: string, override: {
+        model?: string;
+        mode?: string;
+    }): void;
+    /**
+     * (N5) Attach a workspace handle to an existing session's meta so that a
+     * later `closeSession` can fire `onWorkspaceClose` with it. Idempotent: a
+     * second call overwrites the existing handle (acceptable since the host
+     * never adopts two workspaces for the same session in practice). No-op
+     * with a warn when the session is unknown — the caller's prepare succeeded
+     * before createSession failed, so the workspace is already cleaning itself
+     * up via the error path in hub-connection.
+     */
+    attachWorkspace(sessionId: string, handle: WorkspaceHandle): void;
+    /** (N5) Inspect the attached workspace handle for a session, if any. */
+    getWorkspaceHandle(sessionId: string): WorkspaceHandle | undefined;
     abortSession(sessionId: string): Promise<void>;
     /**
      * M3.S2b — Deliver a permission decision back to the adapter for the named

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

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

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,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAuD,MAAM,iBAAiB,CAAC;AAGxG,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAqB3D,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;IACnB,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,CAAC,CA6TD"}
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAGA,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;AAEtD,OAAO,EAAE,gBAAgB,EAAsU,MAAM,iBAAiB,CAAC;AAIvX,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAsB3D,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;IACnB,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,CAAC,CAwgBD"}

package/dist/start.js

@@ -1,7 +1,8 @@
 import {
   startAgent
-} from "./chunk-B733MQCA.js";
-import "./chunk-PJ5M6Q36.js";
+} from "./chunk-GOCWMRBB.js";
+import "./chunk-VAEFJLPL.js";
+import "./chunk-376QZ7JB.js";
 export {
   startAgent
 };

package/dist/{windows-P6U3JLUZ.js → windows-PEJ3KOLC.js}

@@ -5,8 +5,8 @@ import {
   getLogDir,
   getNodePath,
   loadServiceConfig
-} from "./chunk-M2CDVPQF.js";
-import "./chunk-PJ5M6Q36.js";
+} from "./chunk-JH6RGJBQ.js";
+import "./chunk-376QZ7JB.js";
 
 // src/service/windows.ts
 import { execSync, spawn } from "child_process";
@@ -162,4 +162,4 @@ export {
   generateEcosystem,
   getEcosystemPath
 };
-//# sourceMappingURL=windows-P6U3JLUZ.js.map
+//# sourceMappingURL=windows-PEJ3KOLC.js.map

package/dist/worktree-bridge.d.ts

@@ -0,0 +1,51 @@
+import type { AgentGenericRequest } from "@mclawnet/shared";
+import type { HubConnection } from "./hub-connection.js";
+/**
+ * Generic.request handler for the `worktree` namespace. Provides chat-session
+ * lifecycle operations on worktrees prepared by WorkspaceManager (PR-A):
+ *
+ * - `delete`  → remove worktree + branch (force-delete unmerged branches when
+ *               caller passes force=true)
+ * - `ship`    → commit + push + open PR via shipment pipeline (added separately
+ *               in PR-A task #8; this file holds the dispatch skeleton)
+ *
+ * Unlike SwarmCoordinator-driven dispose (which goes through WorkspaceManager
+ * + per-swarm handle index), the delete action operates directly on the on-disk
+ * path so it survives agent restarts that lost the in-memory handle map. The
+ * trade-off: caller (hub/UI) must pass the exact worktree path & branch name,
+ * which it has via chat_sessions.worktree_path / .worktree_branch.
+ *
+ * Security: rejects any path outside the calling user's workspace tree. We
+ * approximate this with two cheap checks — absolute path required, and the
+ * basename must start with the per-session prefix `chat-` (see GitWorktreeProvider).
+ * Anything else (random "/etc", a sibling worktree from another agent, etc.) is
+ * rejected up front rather than relying on `git -C` to refuse.
+ */
+export declare class WorktreeBridge {
+    private hub;
+    constructor(hub: HubConnection);
+    handle(msg: AgentGenericRequest): Promise<Record<string, unknown>>;
+    private deleteWorktree;
+    /**
+     * Emit a session.worktree_deleted push frame after a successful delete so
+     * the hub can clear the DB columns and broadcast to other tabs. Caller
+     * passes sessionId via params; missing sessionId silently skips the push
+     * (delete still works — just no DB sync, used by cleanup tooling that
+     * doesn't have a session context).
+     */
+    private maybeEmitDeleted;
+    /**
+     * Ship a chat-session worktree: stage all changes, commit if dirty, then
+     * either push + open draft PR (when `gh` CLI is available) or fall back to
+     * writing diff.patch + report.md inside the worktree for manual `git apply`.
+     *
+     * Result shape mirrors M6 swarm ShipmentResult so the UI can render both
+     * with the same component (Banner + future shipment list view).
+     *
+     * No LLM involvement (chat sessions don't have a queen role to generate
+     * report bodies). Title/body are caller-provided (UI) or default to the
+     * branch name + short stat summary.
+     */
+    private shipWorktree;
+}
+//# sourceMappingURL=worktree-bridge.d.ts.map

package/dist/worktree-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-bridge.d.ts","sourceRoot":"","sources":["../src/worktree-bridge.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAKhC,MAAM,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAY1D,cAAc;IAwE5B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;;;;;;;;;OAWG;YACW,YAAY;CAkJ3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mclawnet/agent",
-  "version": "0.6.35",
+  "version": "0.6.36",
   "type": "module",
   "exports": {
     ".": {
@@ -23,15 +23,16 @@
     "commander": "^14.0.3",
     "smol-toml": "^1.6.1",
     "ws": "^8.19.0",
-    "@mclawnet/claude-adapter": "0.1.24",
+    "@mclawnet/backend-types": "0.1.0",
+    "@mclawnet/claude-adapter": "0.1.25",
+    "@mclawnet/mcp-server": "0.1.9",
     "@mclawnet/logger": "0.1.7",
-    "@mclawnet/memory": "0.1.7",
-    "@mclawnet/scheduler": "0.1.3",
-    "@mclawnet/shared": "0.1.8",
+    "@mclawnet/swarm": "0.1.14",
     "@mclawnet/skill-manager": "0.1.6",
-    "@mclawnet/task": "0.1.2",
-    "@mclawnet/mcp-server": "0.1.8",
-    "@mclawnet/swarm": "0.1.13"
+    "@mclawnet/shared": "0.1.9",
+    "@mclawnet/task": "0.1.3",
+    "@mclawnet/scheduler": "0.1.4",
+    "@mclawnet/memory": "0.1.7"
   },
   "optionalDependencies": {
     "@mclawnet/codex-adapter": "0.1.0"

package/dist/backend-factory-VRPU3534.js

@@ -1,9 +0,0 @@
-import {
-  __resetBackendFactoryCache,
-  createBackendAdapter
-} from "./chunk-FYM7CXUI.js";
-export {
-  __resetBackendFactoryCache,
-  createBackendAdapter
-};
-//# sourceMappingURL=backend-factory-VRPU3534.js.map