@selesai/code 0.9.6 → 0.9.8

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `@selesai/code` will be documented in this file.
 
+## [0.9.8] - 2026-08-25
+
+### Added
+- **RPC session handoff.** RPC clients can now use `handoff_new` to summarize the current session and start a clean child session seeded with the generated handoff, optionally tailored to a goal.
+
+### Changed
+- **Shared handoff generation.** Handoff context and summary generation now live in reusable core code shared by the TUI extension and RPC mode.
+
+## [0.9.7] - 2026-08-25
+
+### Added
+- **RPC queue state and replacement.** RPC `get_state` now exposes pending steering and follow-up messages, and the new `replace_queue` command replaces both queues while preserving their routing. Parent sessions created through RPC are now passed directly to the session manager.
+
 ## [0.9.6] - 2026-08-23
 
 ### Fixed

package/dist/cli/credential-print.js

@@ -7,10 +7,10 @@ export function isCredentialPrintHelp(args) {
     return (args[0] === "auth" && (args[1] === undefined || args[1] === "help" || args[1] === "--help" || args[1] === "-h"));
 }
 export function printCredentialPrintHelp() {
-    console.log(`Usage:
-  ${APP_NAME} auth print-api-key --model <model> [--provider <provider>]
-  ${APP_NAME} auth print-bearer-token --model <model> [--provider <provider>] [--min-expiry <duration>]
-
+    console.log(`Usage:
+  ${APP_NAME} auth print-api-key --model <model> [--provider <provider>]
+  ${APP_NAME} auth print-bearer-token --model <model> [--provider <provider>] [--min-expiry <duration>]
+
 Prints the configured credential alone on stdout. Provider inference uses configured credentials; specify --provider to select explicitly. Bearer tokens have a 30-minute minimum expiry by default. --min-expiry accepts ms, s, m, or h (for example, 30m).`);
 }
 /** Parse the auth command surface before normal startup. */

package/dist/core/agent-session-runtime.js

@@ -152,11 +152,8 @@ export class AgentSessionRuntime {
         const previousSessionFile = this.session.sessionFile;
         const sessionDir = this.session.sessionManager.getSessionDir();
         const sessionManager = this.session.sessionManager.isPersisted()
-            ? SessionManager.create(this.cwd, sessionDir)
+            ? SessionManager.create(this.cwd, sessionDir, { parentSession: options?.parentSession })
             : SessionManager.inMemory(this.cwd);
-        if (options?.parentSession) {
-            sessionManager.newSession({ parentSession: options.parentSession });
-        }
         await this.teardownCurrent("new", sessionManager.getSessionFile());
         this.apply(await this.createRuntime({
             cwd: this.cwd,

package/dist/core/agent-session.d.ts

@@ -458,6 +458,8 @@ export declare class AgentSession {
         steering: string[];
         followUp: string[];
     };
+    /** Replace pending messages without changing their steer/follow-up routing. */
+    replaceQueue(steering: readonly string[], followUp: readonly string[]): void;
     /** Number of pending messages (includes both steering and follow-up) */
     get pendingMessageCount(): number;
     /** Get pending steering messages (read-only) */

package/dist/core/agent-session.js

@@ -972,6 +972,21 @@ export class AgentSession {
                 this._systemPromptOverride = undefined;
                 this.agent.state.systemPrompt = this._baseSystemPrompt;
             }
+            // Another prompt may have started while this one was preflighting (auth
+            // checks, compaction, and extension events can take seconds). The agent is
+            // now streaming, so queue instead of racing the active run: the RPC layer
+            // has already reported preflight success, so throwing here would silently
+            // drop the message. Default to a follow-up so it runs after the current turn.
+            if (this.isStreaming) {
+                if (options?.streamingBehavior === "steer") {
+                    await this._queueSteer(expandedText, currentImages);
+                }
+                else {
+                    await this._queueFollowUp(expandedText, currentImages);
+                }
+                preflightResult?.(true);
+                return;
+            }
         }
         catch (error) {
             preflightResult?.(false);
@@ -1363,6 +1378,17 @@ export class AgentSession {
         this._emitQueueUpdate();
         return { steering, followUp };
     }
+    /** Replace pending messages without changing their steer/follow-up routing. */
+    replaceQueue(steering, followUp) {
+        this._steeringMessages = [...steering];
+        this._followUpMessages = [...followUp];
+        this.agent.clearAllQueues();
+        for (const text of steering)
+            this.agent.steer({ role: "user", content: [{ type: "text", text }], timestamp: Date.now() });
+        for (const text of followUp)
+            this.agent.followUp({ role: "user", content: [{ type: "text", text }], timestamp: Date.now() });
+        this._emitQueueUpdate();
+    }
     /** Number of pending messages (includes both steering and follow-up) */
     get pendingMessageCount() {
         return this._steeringMessages.length + this._followUpMessages.length;

package/dist/core/compaction/branch-summarization.js

@@ -146,37 +146,37 @@ export function prepareBranchEntries(entries, tokenBudget = 0) {
 // ============================================================================
 // Summary Generation
 // ============================================================================
-const BRANCH_SUMMARY_PREAMBLE = `The user explored a different conversation branch before returning here.
-Summary of that exploration:
-
+const BRANCH_SUMMARY_PREAMBLE = `The user explored a different conversation branch before returning here.
+Summary of that exploration:
+
 `;
-const BRANCH_SUMMARY_PROMPT = `Create a structured summary of this conversation branch for context when returning later.
-
-Use this EXACT format:
-
-## Goal
-[What was the user trying to accomplish in this branch?]
-
-## Constraints & Preferences
-- [Any constraints, preferences, or requirements mentioned]
-- [Or "(none)" if none were mentioned]
-
-## Progress
-### Done
-- [x] [Completed tasks/changes]
-
-### In Progress
-- [ ] [Work that was started but not finished]
-
-### Blocked
-- [Issues preventing progress, if any]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale]
-
-## Next Steps
-1. [What should happen next to continue this work]
-
+const BRANCH_SUMMARY_PROMPT = `Create a structured summary of this conversation branch for context when returning later.
+
+Use this EXACT format:
+
+## Goal
+[What was the user trying to accomplish in this branch?]
+
+## Constraints & Preferences
+- [Any constraints, preferences, or requirements mentioned]
+- [Or "(none)" if none were mentioned]
+
+## Progress
+### Done
+- [x] [Completed tasks/changes]
+
+### In Progress
+- [ ] [Work that was started but not finished]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [What should happen next to continue this work]
+
 Keep each section concise. Preserve exact file paths, function names, and error messages.`;
 /**
  * Generate a summary of abandoned branch entries.

package/dist/core/compaction/compaction.js

@@ -353,75 +353,75 @@ export function findCutPoint(entries, startIndex, endIndex, keepRecentTokens) {
 // ============================================================================
 // Summarization
 // ============================================================================
-const SUMMARIZATION_PROMPT = `The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.
-
-Use this EXACT format:
-
-## Goal
-[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]
-
-## Constraints & Preferences
-- [Any constraints, preferences, or requirements mentioned by user]
-- [Or "(none)" if none were mentioned]
-
-## Progress
-### Done
-- [x] [Completed tasks/changes]
-
-### In Progress
-- [ ] [Current work]
-
-### Blocked
-- [Issues preventing progress, if any]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale]
-
-## Next Steps
-1. [Ordered list of what should happen next]
-
-## Critical Context
-- [Any data, examples, or references needed to continue]
-- [Or "(none)" if not applicable]
-
+const SUMMARIZATION_PROMPT = `The messages above are a conversation to summarize. Create a structured context checkpoint summary that another LLM will use to continue the work.
+
+Use this EXACT format:
+
+## Goal
+[What is the user trying to accomplish? Can be multiple items if the session covers different tasks.]
+
+## Constraints & Preferences
+- [Any constraints, preferences, or requirements mentioned by user]
+- [Or "(none)" if none were mentioned]
+
+## Progress
+### Done
+- [x] [Completed tasks/changes]
+
+### In Progress
+- [ ] [Current work]
+
+### Blocked
+- [Issues preventing progress, if any]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale]
+
+## Next Steps
+1. [Ordered list of what should happen next]
+
+## Critical Context
+- [Any data, examples, or references needed to continue]
+- [Or "(none)" if not applicable]
+
 Keep each section concise. Preserve exact file paths, function names, and error messages.`;
-const UPDATE_SUMMARIZATION_PROMPT = `The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
-
-Update the existing structured summary with new information. RULES:
-- PRESERVE all existing information from the previous summary
-- ADD new progress, decisions, and context from the new messages
-- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
-- UPDATE "Next Steps" based on what was accomplished
-- PRESERVE exact file paths, function names, and error messages
-- If something is no longer relevant, you may remove it
-
-Use this EXACT format:
-
-## Goal
-[Preserve existing goals, add new ones if the task expanded]
-
-## Constraints & Preferences
-- [Preserve existing, add new ones discovered]
-
-## Progress
-### Done
-- [x] [Include previously done items AND newly completed items]
-
-### In Progress
-- [ ] [Current work - update based on progress]
-
-### Blocked
-- [Current blockers - remove if resolved]
-
-## Key Decisions
-- **[Decision]**: [Brief rationale] (preserve all previous, add new)
-
-## Next Steps
-1. [Update based on current state]
-
-## Critical Context
-- [Preserve important context, add new if needed]
-
+const UPDATE_SUMMARIZATION_PROMPT = `The messages above are NEW conversation messages to incorporate into the existing summary provided in <previous-summary> tags.
+
+Update the existing structured summary with new information. RULES:
+- PRESERVE all existing information from the previous summary
+- ADD new progress, decisions, and context from the new messages
+- UPDATE the Progress section: move items from "In Progress" to "Done" when completed
+- UPDATE "Next Steps" based on what was accomplished
+- PRESERVE exact file paths, function names, and error messages
+- If something is no longer relevant, you may remove it
+
+Use this EXACT format:
+
+## Goal
+[Preserve existing goals, add new ones if the task expanded]
+
+## Constraints & Preferences
+- [Preserve existing, add new ones discovered]
+
+## Progress
+### Done
+- [x] [Include previously done items AND newly completed items]
+
+### In Progress
+- [ ] [Current work - update based on progress]
+
+### Blocked
+- [Current blockers - remove if resolved]
+
+## Key Decisions
+- **[Decision]**: [Brief rationale] (preserve all previous, add new)
+
+## Next Steps
+1. [Update based on current state]
+
+## Critical Context
+- [Preserve important context, add new if needed]
+
 Keep each section concise. Preserve exact file paths, function names, and error messages.`;
 function createSummarizationOptions(model, maxTokens, apiKey, headers, env, signal, thinkingLevel) {
     const options = { maxTokens, signal, apiKey, headers, env };
@@ -559,19 +559,19 @@ export function prepareCompaction(pathEntries, settings) {
 // ============================================================================
 // Main compaction function
 // ============================================================================
-const TURN_PREFIX_SUMMARIZATION_PROMPT = `This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
-
-Summarize the prefix to provide context for the retained suffix:
-
-## Original Request
-[What did the user ask for in this turn?]
-
-## Early Progress
-- [Key decisions and work done in the prefix]
-
-## Context for Suffix
-- [Information needed to understand the retained recent work]
-
+const TURN_PREFIX_SUMMARIZATION_PROMPT = `This is the PREFIX of a turn that was too large to keep. The SUFFIX (recent work) is retained.
+
+Summarize the prefix to provide context for the retained suffix:
+
+## Original Request
+[What did the user ask for in this turn?]
+
+## Early Progress
+- [Key decisions and work done in the prefix]
+
+## Context for Suffix
+- [Information needed to understand the retained recent work]
+
 Be concise. Focus on what's needed to understand the kept suffix.`;
 /**
  * Generate summaries for compaction using prepared data.

package/dist/core/compaction/utils.js

@@ -136,6 +136,6 @@ export function serializeConversation(messages) {
 // ============================================================================
 // Summarization System Prompt
 // ============================================================================
-export const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, then produce a structured summary following the exact format specified.
-
+export const SUMMARIZATION_SYSTEM_PROMPT = `You are a context summarization assistant. Your task is to read a conversation between a user and an AI assistant, then produce a structured summary following the exact format specified.
+
 Do NOT continue the conversation. Do NOT respond to any questions in the conversation. ONLY output the structured summary.`;