@jmfederico/pi-web 1.202607.1 → 1.202607.2

package/dist/server/sessions/sessionUnreadStore.js

@@ -0,0 +1,520 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { piWebDataDir } from "../../config.js";
+import { SESSION_UNREAD_CATALOG_ID_MAX_LENGTH, SESSION_UNREAD_COMPLETED_AT_MAX_LENGTH, SESSION_UNREAD_CWD_MAX_LENGTH, SESSION_UNREAD_LIMIT, SESSION_UNREAD_SESSION_ID_MAX_LENGTH, } from "../../shared/apiTypes.js";
+const SESSION_UNREAD_STATE_VERSION = 1;
+const SESSION_UNREAD_FILE_MODE = 0o600;
+/**
+ * Daemon-owned unread completion catalog.
+ *
+ * Completion orders are global and never reused within a catalog epoch. An
+ * acknowledgement must carry both the epoch and the observed completion order,
+ * so neither an old completion nor a client from reset state can clear newer
+ * work.
+ */
+export class SessionUnreadStore {
+    constructor(options = {}) {
+        this.unreadByIdentity = new Map();
+        this.activeByIdentity = new Map();
+        this.excludedByIdentity = new Map();
+        this.catalogRevision = 0;
+        this.nextCompletionOrder = 0;
+        this.persistenceGeneration = 0;
+        this.durablePersistenceGeneration = 0;
+        this.now = options.now ?? (() => new Date());
+        this.persistence = options.persistence;
+        this.createCatalogId = options.createCatalogId ?? randomUUID;
+        this.onPersistenceError = options.onPersistenceError ?? (() => undefined);
+        this.loaded = this.persistence === undefined;
+        // A persisted store receives its epoch from disk or creates one during
+        // load; synchronous in-memory stores are ready immediately.
+        this.catalogId = this.loaded ? this.freshCatalogId() : "";
+    }
+    load() {
+        if (this.loaded)
+            return Promise.resolve();
+        if (this.loadPromise !== undefined)
+            return this.loadPromise;
+        const loadPromise = this.loadPersistedState();
+        this.loadPromise = loadPromise;
+        return loadPromise;
+    }
+    /** Current in-memory state. Transport boundaries should use `durableCatalogSnapshot`. */
+    catalogSnapshot() {
+        this.requireLoaded();
+        return {
+            catalogId: this.catalogId,
+            catalogRevision: this.catalogRevision,
+            sessions: [...this.unreadByIdentity.values()]
+                .sort((left, right) => right.completionOrder - left.completionOrder)
+                .map((summary) => ({ ...summary })),
+        };
+    }
+    observeActivityState(sessionId, cwd, active) {
+        this.requireLoaded();
+        const identity = requireIdentity(sessionId, cwd);
+        const key = sessionIdentityKey(identity);
+        if (this.excludedByIdentity.has(key)) {
+            this.activeByIdentity.delete(key);
+            return [];
+        }
+        if (active) {
+            this.activeByIdentity.set(key, identity);
+            return [];
+        }
+        if (!this.activeByIdentity.has(key))
+            return [];
+        const completionOrder = incrementSafe(this.nextCompletionOrder, "Session unread completion order exhausted");
+        const willExceedLimit = !this.unreadByIdentity.has(key) && this.unreadByIdentity.size >= SESSION_UNREAD_LIMIT;
+        this.assertRevisionCapacity(willExceedLimit ? 2 : 1);
+        const completedAt = this.now().toISOString();
+        this.activeByIdentity.delete(key);
+        this.nextCompletionOrder = completionOrder;
+        const summary = {
+            sessionId,
+            cwd,
+            completionOrder,
+            completedAt,
+        };
+        // Reinsert existing identities so map order remains completion order.
+        this.unreadByIdentity.delete(key);
+        this.unreadByIdentity.set(key, summary);
+        const mutations = [this.mutation(identity, summary), ...this.trimToLimit()];
+        this.schedulePersist();
+        return mutations;
+    }
+    /** Clear only the transient active latch for a runtime that is closing or rebinding. */
+    forgetActivity(sessionId, cwd) {
+        this.requireLoaded();
+        const identity = requireIdentity(sessionId, cwd);
+        this.activeByIdentity.delete(sessionIdentityKey(identity));
+    }
+    /**
+     * Suppress unread tracking until this identity is explicitly forgotten and
+     * remove state recorded before it was verified as a tracked sub-session.
+     */
+    excludeSession(sessionId, cwd) {
+        this.requireLoaded();
+        const identity = requireIdentity(sessionId, cwd);
+        const key = sessionIdentityKey(identity);
+        const current = this.unreadByIdentity.get(key);
+        this.assertRevisionCapacity(current === undefined ? 0 : 1);
+        this.excludedByIdentity.set(key, identity);
+        this.activeByIdentity.delete(key);
+        if (current === undefined)
+            return [];
+        this.unreadByIdentity.delete(key);
+        const mutations = [this.mutation(identity, null)];
+        this.schedulePersist();
+        return mutations;
+    }
+    acknowledge(sessionId, request) {
+        this.requireLoaded();
+        const identity = requireIdentity(sessionId, request.cwd);
+        requireCatalogId(request.catalogId);
+        requirePositiveSafeInteger(request.throughCompletionOrder, "throughCompletionOrder");
+        if (request.catalogId !== this.catalogId)
+            return { mutations: [] };
+        const key = sessionIdentityKey(identity);
+        const current = this.unreadByIdentity.get(key);
+        if (current === undefined || current.completionOrder > request.throughCompletionOrder) {
+            return { mutations: [] };
+        }
+        this.assertRevisionCapacity(1);
+        this.unreadByIdentity.delete(key);
+        const mutations = [this.mutation(identity, null)];
+        this.schedulePersist();
+        return { mutations };
+    }
+    /** Remove durable unread and all transient lifecycle state for one identity. */
+    forgetSession(sessionId, cwd) {
+        this.requireLoaded();
+        const identity = requireIdentity(sessionId, cwd);
+        const key = sessionIdentityKey(identity);
+        const current = this.unreadByIdentity.get(key);
+        this.assertRevisionCapacity(current === undefined ? 0 : 1);
+        this.activeByIdentity.delete(key);
+        this.excludedByIdentity.delete(key);
+        if (current === undefined)
+            return [];
+        this.unreadByIdentity.delete(key);
+        const mutations = [this.mutation(identity, null)];
+        this.schedulePersist();
+        return mutations;
+    }
+    reconcileCwd(cwd, sessionIds) {
+        this.requireLoaded();
+        const boundedCwd = requireBoundedNonEmptyString(cwd, "cwd", SESSION_UNREAD_CWD_MAX_LENGTH);
+        const retained = new Set(sessionIds);
+        const removed = [...this.unreadByIdentity.entries()]
+            .filter(([, summary]) => summary.cwd === boundedCwd && !retained.has(summary.sessionId));
+        this.assertRevisionCapacity(removed.length);
+        for (const [key, identity] of this.activeByIdentity) {
+            if (identity.cwd === boundedCwd && !retained.has(identity.sessionId))
+                this.activeByIdentity.delete(key);
+        }
+        for (const [key, identity] of this.excludedByIdentity) {
+            if (identity.cwd === boundedCwd && !retained.has(identity.sessionId))
+                this.excludedByIdentity.delete(key);
+        }
+        const mutations = [];
+        for (const [key, summary] of removed) {
+            this.unreadByIdentity.delete(key);
+            mutations.push(this.mutation(summary, null));
+        }
+        if (mutations.length > 0)
+            this.schedulePersist();
+        return mutations;
+    }
+    /** Wait until all currently queued state is durably represented or throw. */
+    async flush() {
+        this.requireLoaded();
+        await this.waitForPersistenceWorker();
+        if (this.persistenceFailure === undefined
+            && this.persistenceGeneration === this.durablePersistenceGeneration)
+            return;
+        // Retry the latest complete snapshot once. Failed/intermediate snapshots
+        // are coalesced because completion orders and revisions are cumulative.
+        this.ensurePersistenceWorker();
+        await this.waitForPersistenceWorker();
+        this.throwIfPersistenceFailed();
+    }
+    /** Snapshot safe to expose to a client that may subsequently acknowledge it. */
+    async durableCatalogSnapshot() {
+        let snapshot;
+        do {
+            await this.flush();
+            snapshot = this.catalogSnapshot();
+        } while (this.persistenceGeneration !== this.durablePersistenceGeneration);
+        return snapshot;
+    }
+    async loadPersistedState() {
+        const persistence = this.persistence;
+        if (persistence === undefined) {
+            this.loaded = true;
+            return;
+        }
+        let value;
+        let resetState = false;
+        try {
+            value = await persistence.load();
+        }
+        catch (error) {
+            this.reportPersistenceError("load", error);
+            if (!(error instanceof SessionUnreadPersistenceCorruptionError))
+                throw error;
+            resetState = true;
+        }
+        if (!resetState && value !== undefined) {
+            try {
+                this.installPersistedState(parsePersistedState(value));
+            }
+            catch (error) {
+                this.reportPersistenceError("load", error);
+                resetState = true;
+            }
+        }
+        else if (value === undefined) {
+            resetState = true;
+        }
+        if (resetState) {
+            this.resetInMemoryState();
+            // Persist even an empty epoch so the catalog identity itself survives a
+            // clean daemon restart and a corrupt file is repaired once.
+            this.schedulePersist();
+            await this.waitForPersistenceWorker();
+            try {
+                this.throwIfPersistenceFailed();
+            }
+            catch (error) {
+                this.loaded = false;
+                throw error;
+            }
+        }
+        this.loaded = true;
+    }
+    resetInMemoryState() {
+        this.catalogId = this.freshCatalogId();
+        this.catalogRevision = 0;
+        this.nextCompletionOrder = 0;
+        this.unreadByIdentity.clear();
+        this.activeByIdentity.clear();
+        this.excludedByIdentity.clear();
+    }
+    mutation(identity, unread) {
+        this.catalogRevision = incrementSafe(this.catalogRevision, "Session unread catalog revision exhausted");
+        return {
+            event: {
+                type: "sessions.unread",
+                catalogId: this.catalogId,
+                catalogRevision: this.catalogRevision,
+                sessionId: identity.sessionId,
+                cwd: identity.cwd,
+                unread: unread === null ? null : { ...unread },
+            },
+        };
+    }
+    trimToLimit() {
+        const mutations = [];
+        while (this.unreadByIdentity.size > SESSION_UNREAD_LIMIT) {
+            let oldestKey;
+            let oldest;
+            for (const [key, summary] of this.unreadByIdentity) {
+                if (oldest === undefined || summary.completionOrder < oldest.completionOrder) {
+                    oldestKey = key;
+                    oldest = summary;
+                }
+            }
+            if (oldestKey === undefined || oldest === undefined)
+                break;
+            this.unreadByIdentity.delete(oldestKey);
+            mutations.push(this.mutation(oldest, null));
+        }
+        return mutations;
+    }
+    assertRevisionCapacity(count) {
+        if (!Number.isSafeInteger(this.catalogRevision + count)) {
+            throw new Error("Session unread catalog revision exhausted");
+        }
+    }
+    schedulePersist() {
+        if (this.persistence === undefined)
+            return;
+        const generation = incrementSafe(this.persistenceGeneration, "Session unread persistence generation exhausted");
+        this.persistenceGeneration = generation;
+        this.pendingPersistence = { generation, state: this.persistedState() };
+        // Once a save fails, mutations continue replacing the one pending snapshot
+        // but do not hammer storage; the service's backoff (or an explicit flush)
+        // owns the next retry attempt.
+        if (this.persistenceFailure === undefined)
+            this.ensurePersistenceWorker();
+    }
+    ensurePersistenceWorker() {
+        if (this.persistence === undefined || this.persistenceWorker !== undefined || this.pendingPersistence === undefined)
+            return;
+        const worker = this.runPersistenceWorker();
+        this.persistenceWorker = worker;
+        void worker.finally(() => {
+            if (this.persistenceWorker === worker)
+                this.persistenceWorker = undefined;
+        });
+    }
+    async runPersistenceWorker() {
+        const persistence = this.persistence;
+        if (persistence === undefined)
+            return;
+        while (this.pendingPersistence !== undefined) {
+            const pending = this.pendingPersistence;
+            this.pendingPersistence = undefined;
+            try {
+                await persistence.save(pending.state);
+                this.durablePersistenceGeneration = pending.generation;
+                this.persistenceFailure = undefined;
+            }
+            catch (error) {
+                // A newer pending snapshot subsumes this failed one. Otherwise retain
+                // this exact snapshot so a later flush can retry without a new mutation.
+                this.pendingPersistence ??= pending;
+                this.persistenceFailure = { error };
+                this.reportPersistenceError("save", error);
+                return;
+            }
+        }
+    }
+    async waitForPersistenceWorker() {
+        let worker = this.persistenceWorker;
+        while (worker !== undefined) {
+            await worker;
+            worker = this.persistenceWorker;
+        }
+    }
+    throwIfPersistenceFailed() {
+        const failure = this.persistenceFailure;
+        if (failure !== undefined)
+            throw failure.error;
+    }
+    persistedState() {
+        return {
+            version: SESSION_UNREAD_STATE_VERSION,
+            catalogId: this.catalogId,
+            catalogRevision: this.catalogRevision,
+            nextCompletionOrder: this.nextCompletionOrder,
+            sessions: [...this.unreadByIdentity.values()].map((summary) => ({ ...summary })),
+        };
+    }
+    installPersistedState(state) {
+        this.catalogId = state.catalogId;
+        this.catalogRevision = state.catalogRevision;
+        this.nextCompletionOrder = state.nextCompletionOrder;
+        this.unreadByIdentity.clear();
+        for (const summary of [...state.sessions].sort((left, right) => left.completionOrder - right.completionOrder)) {
+            this.unreadByIdentity.set(sessionIdentityKey(summary), { ...summary });
+        }
+    }
+    freshCatalogId() {
+        return requireCatalogId(this.createCatalogId());
+    }
+    requireLoaded() {
+        if (!this.loaded)
+            throw new Error("Session unread store must be loaded before use");
+    }
+    reportPersistenceError(operation, error) {
+        try {
+            this.onPersistenceError(operation, error);
+        }
+        catch {
+            // Error reporting must not poison future serialized persistence work.
+        }
+    }
+}
+class SessionUnreadPersistenceCorruptionError extends Error {
+    constructor(cause) {
+        super("Session unread persistence contains invalid JSON", { cause });
+    }
+}
+export class FileSessionUnreadPersistence {
+    constructor(filePath = defaultSessionUnreadFilePath()) {
+        this.filePath = filePath;
+    }
+    async load() {
+        let source;
+        try {
+            source = await readFile(this.filePath, "utf8");
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                return undefined;
+            throw error;
+        }
+        try {
+            const value = JSON.parse(source);
+            return value;
+        }
+        catch (error) {
+            throw new SessionUnreadPersistenceCorruptionError(error);
+        }
+    }
+    async save(state) {
+        await mkdir(dirname(this.filePath), { recursive: true });
+        const tempPath = `${this.filePath}.${process.pid.toString()}-${randomUUID()}.tmp`;
+        try {
+            await writeFile(tempPath, `${JSON.stringify(state, null, 2)}\n`, {
+                encoding: "utf8",
+                mode: SESSION_UNREAD_FILE_MODE,
+                flag: "wx",
+            });
+            await rename(tempPath, this.filePath);
+        }
+        finally {
+            await rm(tempPath, { force: true }).catch(() => undefined);
+        }
+    }
+}
+export function defaultSessionUnreadFilePath(env = process.env, cwd = process.cwd()) {
+    return join(piWebDataDir(env, cwd), "session-unread.json");
+}
+function parsePersistedState(value) {
+    const record = requireRecord(value, "Session unread state must be an object");
+    if (record["version"] !== SESSION_UNREAD_STATE_VERSION)
+        throw new Error("Unsupported session unread state version");
+    const catalogId = requireCatalogId(record["catalogId"]);
+    const catalogRevision = requireNonNegativeSafeInteger(record["catalogRevision"], "catalogRevision");
+    const nextCompletionOrder = requireNonNegativeSafeInteger(record["nextCompletionOrder"], "nextCompletionOrder");
+    const rawSessions = record["sessions"];
+    if (!Array.isArray(rawSessions))
+        throw new Error("Session unread sessions must be an array");
+    if (rawSessions.length > SESSION_UNREAD_LIMIT)
+        throw new Error("Session unread state exceeds its session limit");
+    const sessions = rawSessions.map(parseSummary);
+    const identities = new Set();
+    const orders = new Set();
+    for (const summary of sessions) {
+        const key = sessionIdentityKey(summary);
+        if (identities.has(key))
+            throw new Error("Duplicate session unread identity");
+        if (orders.has(summary.completionOrder))
+            throw new Error("Duplicate session unread completion order");
+        identities.add(key);
+        orders.add(summary.completionOrder);
+    }
+    const maxOrder = sessions.reduce((maximum, summary) => Math.max(maximum, summary.completionOrder), 0);
+    if (nextCompletionOrder < maxOrder)
+        throw new Error("Session unread completion order is inconsistent");
+    if (catalogRevision < nextCompletionOrder)
+        throw new Error("Session unread catalog revision is inconsistent");
+    return {
+        version: SESSION_UNREAD_STATE_VERSION,
+        catalogId,
+        catalogRevision,
+        nextCompletionOrder,
+        sessions,
+    };
+}
+function parseSummary(value) {
+    const record = requireRecord(value, "Session unread summary must be an object");
+    const completedAt = requireBoundedNonEmptyString(record["completedAt"], "completedAt", SESSION_UNREAD_COMPLETED_AT_MAX_LENGTH);
+    const completedDate = new Date(completedAt);
+    if (!Number.isFinite(completedDate.getTime()) || completedDate.toISOString() !== completedAt) {
+        throw new Error("Session unread completedAt must be a canonical ISO timestamp");
+    }
+    return {
+        sessionId: requireBoundedNonEmptyString(record["sessionId"], "sessionId", SESSION_UNREAD_SESSION_ID_MAX_LENGTH),
+        cwd: requireBoundedNonEmptyString(record["cwd"], "cwd", SESSION_UNREAD_CWD_MAX_LENGTH),
+        completionOrder: requirePositiveSafeInteger(record["completionOrder"], "completionOrder"),
+        completedAt,
+    };
+}
+function requireRecord(value, message) {
+    if (!isRecord(value))
+        throw new Error(message);
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireNonEmptyString(value, field) {
+    if (typeof value !== "string" || value === "")
+        throw new Error(`Session unread ${field} must be a non-empty string`);
+    return value;
+}
+function requireBoundedNonEmptyString(value, field, maxLength) {
+    const parsed = requireNonEmptyString(value, field);
+    if (parsed.length > maxLength)
+        throw new Error(`Session unread ${field} exceeds its length limit`);
+    return parsed;
+}
+function requireCatalogId(value) {
+    return requireBoundedNonEmptyString(value, "catalogId", SESSION_UNREAD_CATALOG_ID_MAX_LENGTH);
+}
+function requireNonNegativeSafeInteger(value, field) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`Session unread ${field} must be a non-negative safe integer`);
+    }
+    return value;
+}
+function requirePositiveSafeInteger(value, field) {
+    const parsed = requireNonNegativeSafeInteger(value, field);
+    if (parsed === 0)
+        throw new Error(`Session unread ${field} must be positive`);
+    return parsed;
+}
+function requireIdentity(sessionId, cwd) {
+    return {
+        sessionId: requireBoundedNonEmptyString(sessionId, "sessionId", SESSION_UNREAD_SESSION_ID_MAX_LENGTH),
+        cwd: requireBoundedNonEmptyString(cwd, "cwd", SESSION_UNREAD_CWD_MAX_LENGTH),
+    };
+}
+function sessionIdentityKey(identity) {
+    return JSON.stringify([identity.sessionId, identity.cwd]);
+}
+function incrementSafe(value, message) {
+    const next = value + 1;
+    if (!Number.isSafeInteger(next))
+        throw new Error(message);
+    return next;
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=sessionUnreadStore.js.map

package/dist/server/sessions/sessionUnreadStore.js.map

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

package/dist/server/sessions/spawnSessionTool.js

@@ -18,8 +18,8 @@ export function createSpawnSessionToolDefinition(spawningCwd, deps) {
     return defineTool({
         name: "spawn_session",
         label: "Spawn session",
-        description: "Start a new independent pi-web session and send it an initial prompt. The session is not tracked by the caller, can be opened by a human, and runs without returning its later output to the caller.",
-        promptSnippet: "spawn_session: start a new independent session with a first prompt",
+        description: "Start a fully independent session; its transcript and results are unavailable here. Use only when the user or active workflow explicitly requests a separate session.",
+        promptSnippet: "spawn_session: independent session; results unavailable here; explicit requests only",
         parameters: SpawnSessionParams,
         async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
             // Failures throw: the agent loop turns the thrown message into an error

package/dist/server/sessions/spawnSessionTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawnSessionTool.js","sourceRoot":"","sources":["../../../src/server/sessions/spawnSessionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAyB,MAAM,iCAAiC,CAAC;AAuBpF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,gIAAgI;KAC9I,CAAC;IACF,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7B,WAAW,EAAE,mKAAmK;KACjL,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,WAAmB,EAAE,IAA0B;IAC9F,OAAO,UAAU,CAAqD;QACpE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,sMAAsM;QACnN,aAAa,EAAE,oEAAoE;QACnF,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG;YACxD,wEAAwE;YACxE,2EAA2E;YAC3E,sCAAsC;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;gBAC9B,WAAW;gBACX,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,MAAM,CAAC,SAAS,OAAO,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;gBACtG,OAAO,EAAE,MAAM;aAChB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"spawnSessionTool.js","sourceRoot":"","sources":["../../../src/server/sessions/spawnSessionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAyB,MAAM,iCAAiC,CAAC;AAuBpF,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,WAAW,EAAE,gIAAgI;KAC9I,CAAC;IACF,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC7B,WAAW,EAAE,mKAAmK;KACjL,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,WAAmB,EAAE,IAA0B;IAC9F,OAAO,UAAU,CAAqD;QACpE,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,uKAAuK;QACpL,aAAa,EAAE,sFAAsF;QACrG,UAAU,EAAE,kBAAkB;QAC9B,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG;YACxD,wEAAwE;YACxE,2EAA2E;YAC3E,sCAAsC;YACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC;gBAC9B,WAAW;gBACX,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;aACzD,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,MAAM,CAAC,SAAS,OAAO,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;gBACtG,OAAO,EAAE,MAAM;aAChB,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/server/sessions/spawnSubsessionTool.js

@@ -44,7 +44,7 @@ function statusLine(summary) {
     return `- ${summary.sessionId} [${summary.status}] in ${summary.cwd}`;
 }
 function workingInspectionGuidance(sessionId) {
-    return `Subsession ${sessionId} is working; partial output is withheld. Continue independent work, or call yield_to_subsessions alone and last at the join point. Completion notices wake you; do not poll.`;
+    return `Subsession ${sessionId} is working; partial output is withheld. Continue other work, or call yield_to_subsessions alone and last at the join point. Completion notices wake you; do not poll.`;
 }
 function renderEntry(entry) {
     const header = `#${String(entry.index)} ${entry.role}`;
@@ -96,18 +96,18 @@ function renderTranscript(result) {
  * Tools that let an agent spawn *tracked* child sessions, inspect them, and
  * explicitly yield at a join point.
  *
- * Unlike `spawn_session` (fire-and-forget peers), a subsession records its
- * parent in its session header, the parent is notified when it stops working,
- * and the parent may read its transcript/result. The tools are constructed
- * per-session, carrying the spawning cwd for project-scope validation; the
- * parent's identity is taken from the live extension context at call time.
+ * A subsession records its parent in its session header, the parent is notified
+ * when it stops working, and the parent may read its transcript/result. The
+ * tools are constructed per-session, carrying the spawning cwd for
+ * project-scope validation; the parent's identity is taken from the live
+ * extension context at call time.
  */
 export function createSubsessionToolDefinitions(spawningCwd, deps) {
     const spawnTool = defineTool({
         name: "spawn_subsession",
         label: "Spawn subsession",
-        description: "Start a tracked child and return immediately. Continue independent work, then use yield_to_subsessions at the join point. Completion notices wake you; do not poll.",
-        promptSnippet: "spawn_subsession: tracked parallel work; continue, then join with yield_to_subsessions",
+        description: "Start a tracked child session to carry out part of the current task and return immediately. Its transcript and result are available here after it finishes.",
+        promptSnippet: "spawn_subsession: tracked child work for the current task; result available after completion",
         parameters: SpawnSubsessionParams,
         async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
             const parentSessionId = ctx.sessionManager.getSessionId();
@@ -121,7 +121,7 @@ export function createSubsessionToolDefinitions(spawningCwd, deps) {
                 ...(ctx.model === undefined ? {} : { model: ctx.model }),
             });
             return {
-                content: [{ type: "text", text: `Started tracked subsession ${result.sessionId} in ${result.cwd}. Continue independent work, then join with yield_to_subsessions; do not poll.` }],
+                content: [{ type: "text", text: `Started tracked subsession ${result.sessionId} in ${result.cwd}. Continue other work, then join with yield_to_subsessions; do not poll.` }],
                 details: result,
             };
         },
@@ -188,9 +188,7 @@ export function createSubsessionToolDefinitions(spawningCwd, deps) {
         description: "At a join point, end this run while tracked children work; completion notices wake you. If none work, continue. Call alone and last; do not poll.",
         promptSnippet: "yield_to_subsessions: end the run at a join point; call alone and last",
         promptGuidelines: [
-            "After independent work, yield only at a join point; use spawn_session for fire-and-forget work.",
-            "Call alone and last; a mixed tool batch may continue the run.",
-            "Completion notices wake you; do not poll inspection tools.",
+            "After calling spawn_subsession, you can continue with other work. At the join point, call yield_to_subsessions alone and last; completion notices wake you, so do not poll.",
         ],
         parameters: YieldToSubsessionsParams,
         async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {