@sideboard-ai/core 0.1.56 → 0.1.59

package/dist/index.d.cts

@@ -855,6 +855,8 @@ declare function run(file: string, args: string[], opts?: {
     cwd?: string;
     reject?: boolean;
     env?: Record<string, string>;
+    /** Kill the child after this many ms (execa `timeout`). */
+    timeoutMs?: number;
 }): Promise<{
     stdout: string;
     stderr: string;
@@ -865,6 +867,8 @@ declare function git(args: string[], cwd: string, opts?: {
     env?: Record<string, string>;
     /** Passed as `git -c key=value` (e.g. authenticated HTTPS via http.extraHeader). */
     config?: Record<string, string>;
+    /** Kill after this many ms — critical for MCP so a stuck fetch cannot pin the stdio server. */
+    timeoutMs?: number;
 }): Promise<{
     stdout: string;
     stderr: string;
@@ -872,6 +876,7 @@ declare function git(args: string[], cwd: string, opts?: {
 }>;
 declare function gh(args: string[], cwd: string, opts?: {
     reject?: boolean;
+    timeoutMs?: number;
 }): Promise<{
     stdout: string;
     stderr: string;
@@ -1274,10 +1279,10 @@ interface AgentAdapter {
     }>>;
 }
 declare const PLAN_MODE_INSTRUCTION = "Plan mode is active and must remain active until the user turns Plan mode off in the UI (or Approves / Hands off the plan). Analyze the codebase, search and read files as needed, and produce or refine a clear implementation plan. Do not modify, create, or delete any project files except via Sideboard MCP present_plan (writes .context/attachments/plan.md). When you need a clarifying decision (approach forks, auth choice, scope): (1) first write a short chat message that explains the decision and what each option means (tradeoffs, when to pick it) \u2014 do not leave the user staring at bare labels; (2) then call Sideboard MCP ask_user with the same options, including a description on every option. Sideboard shows questions in the composer and mirrors them in chat. After ask_user, wait for the user's next message with their answers before finalizing the plan. When the plan is ready for approval: (1) call present_plan with the full markdown plan (title + content) so Sideboard saves .context/attachments/plan.md and shows it in chat for Approve / Hand off / Copy; (2) Claude should also call ExitPlanMode after present_plan. Do not skip present_plan \u2014 the plan must be a markdown file, not only chat prose.";
-declare function permissionMode(thread: Pick<Thread, 'autonomy' | 'planMode'>): {
+declare function permissionMode(thread: Pick<Thread, 'autonomy' | 'planMode' | 'sourceType'>): {
     claude: string;
     opencodePermission: string;
-    codexSandbox: 'read-only' | 'workspace-write';
+    codexSandbox: 'read-only' | 'workspace-write' | 'danger-full-access';
 };
 
 /**
@@ -1606,7 +1611,7 @@ declare function formatAgentInstructions(files: AgentInstructionFile[]): string
 declare function withAgentInstructions(prompt: string, files: AgentInstructionFile[]): string;
 
 declare function detectAgents(): Promise<AgentStatus[]>;
-declare function requireAgent(agent: AgentStatus['agent'], opts?: {
+declare function requireAgent(agent: AgentKind, opts?: {
     requireLinear?: boolean;
 }): Promise<AgentStatus>;
 
@@ -2231,7 +2236,19 @@ declare class Orchestrator {
          * real app/CLI startup recovery.
          */
         reclaimStaleTurns?: boolean;
+        /**
+         * When false, skip draining persisted queues. MCP stdio boots must not
+         * steal the whole fleet into a short-lived process (desktop adopts instead).
+         * Default true for desktop/CLI.
+         */
+        drainQueues?: boolean;
     }): Promise<void>;
+    /**
+     * Adopt queues persisted by another process (MCP stdio / CLI) into this
+     * orchestrator's drain loops. Desktop calls this on thread-store changes so
+     * MCP-created review threads don't stay `queued` after the MCP child exits.
+     */
+    adoptPersistedQueues(): void;
     private clearQuotaResumeTimer;
     /** Schedule (or fire) auto-retry after a provider session/usage limit reset. */
     private scheduleQuotaResume;
@@ -2493,7 +2510,7 @@ declare const REVIEW_REQUEST_PATH = ".context/attachments/Review request.md";
 declare const LEGACY_REVIEW_REQUEST_PATH = ".sideboard/attachments/Review request.md";
 declare const REVIEW_REQUEST_NAME = "Review request.md";
 /** Short chat message — guidelines live in the attached review file. */
-declare const REVIEW_REQUEST_PREFILL = "Review.";
+declare const REVIEW_REQUEST_PREFILL = "Review changes in this workspace.";
 type ReviewGuidelinesSource = 'repo' | 'local' | 'stock';
 interface ResolvedReviewGuidelines {
     path: string;
@@ -2538,7 +2555,7 @@ interface RequestReviewResult {
 }
 type SendFn = (threadRef: string, prompt: string) => Promise<Thread>;
 /**
- * Open a fresh "Review" chat tab, attach resolved guidelines, send "Review."
+ * Open a fresh "Review" chat tab, attach resolved guidelines, send the review prefill.
  */
 declare function requestReview(threadRef: string, send: SendFn): Promise<RequestReviewResult>;
 
@@ -2663,8 +2680,12 @@ declare function coordinatorTurnReminder(opts: {
 /**
  * Write durable CLAUDE.md / AGENTS.md into the global synthetic cwd so Claude
  * (and other agents that load AGENTS.md) keep orchestrator identity on resume.
+ * When `orchestratorThreadId` is set, embed that uuid so Codex/Claude resume
+ * cannot invent a stale parentThreadId.
  */
-declare function ensureGlobalCoordinatorCwd(): string;
+declare function ensureGlobalCoordinatorCwd(opts?: {
+    orchestratorThreadId?: string | null;
+}): string;
 declare function coordinatorSystemPrompt(opts: {
     goal: string;
     parentId: string;

package/dist/index.d.ts

@@ -855,6 +855,8 @@ declare function run(file: string, args: string[], opts?: {
     cwd?: string;
     reject?: boolean;
     env?: Record<string, string>;
+    /** Kill the child after this many ms (execa `timeout`). */
+    timeoutMs?: number;
 }): Promise<{
     stdout: string;
     stderr: string;
@@ -865,6 +867,8 @@ declare function git(args: string[], cwd: string, opts?: {
     env?: Record<string, string>;
     /** Passed as `git -c key=value` (e.g. authenticated HTTPS via http.extraHeader). */
     config?: Record<string, string>;
+    /** Kill after this many ms — critical for MCP so a stuck fetch cannot pin the stdio server. */
+    timeoutMs?: number;
 }): Promise<{
     stdout: string;
     stderr: string;
@@ -872,6 +876,7 @@ declare function git(args: string[], cwd: string, opts?: {
 }>;
 declare function gh(args: string[], cwd: string, opts?: {
     reject?: boolean;
+    timeoutMs?: number;
 }): Promise<{
     stdout: string;
     stderr: string;
@@ -1274,10 +1279,10 @@ interface AgentAdapter {
     }>>;
 }
 declare const PLAN_MODE_INSTRUCTION = "Plan mode is active and must remain active until the user turns Plan mode off in the UI (or Approves / Hands off the plan). Analyze the codebase, search and read files as needed, and produce or refine a clear implementation plan. Do not modify, create, or delete any project files except via Sideboard MCP present_plan (writes .context/attachments/plan.md). When you need a clarifying decision (approach forks, auth choice, scope): (1) first write a short chat message that explains the decision and what each option means (tradeoffs, when to pick it) \u2014 do not leave the user staring at bare labels; (2) then call Sideboard MCP ask_user with the same options, including a description on every option. Sideboard shows questions in the composer and mirrors them in chat. After ask_user, wait for the user's next message with their answers before finalizing the plan. When the plan is ready for approval: (1) call present_plan with the full markdown plan (title + content) so Sideboard saves .context/attachments/plan.md and shows it in chat for Approve / Hand off / Copy; (2) Claude should also call ExitPlanMode after present_plan. Do not skip present_plan \u2014 the plan must be a markdown file, not only chat prose.";
-declare function permissionMode(thread: Pick<Thread, 'autonomy' | 'planMode'>): {
+declare function permissionMode(thread: Pick<Thread, 'autonomy' | 'planMode' | 'sourceType'>): {
     claude: string;
     opencodePermission: string;
-    codexSandbox: 'read-only' | 'workspace-write';
+    codexSandbox: 'read-only' | 'workspace-write' | 'danger-full-access';
 };
 
 /**
@@ -1606,7 +1611,7 @@ declare function formatAgentInstructions(files: AgentInstructionFile[]): string
 declare function withAgentInstructions(prompt: string, files: AgentInstructionFile[]): string;
 
 declare function detectAgents(): Promise<AgentStatus[]>;
-declare function requireAgent(agent: AgentStatus['agent'], opts?: {
+declare function requireAgent(agent: AgentKind, opts?: {
     requireLinear?: boolean;
 }): Promise<AgentStatus>;
 
@@ -2231,7 +2236,19 @@ declare class Orchestrator {
          * real app/CLI startup recovery.
          */
         reclaimStaleTurns?: boolean;
+        /**
+         * When false, skip draining persisted queues. MCP stdio boots must not
+         * steal the whole fleet into a short-lived process (desktop adopts instead).
+         * Default true for desktop/CLI.
+         */
+        drainQueues?: boolean;
     }): Promise<void>;
+    /**
+     * Adopt queues persisted by another process (MCP stdio / CLI) into this
+     * orchestrator's drain loops. Desktop calls this on thread-store changes so
+     * MCP-created review threads don't stay `queued` after the MCP child exits.
+     */
+    adoptPersistedQueues(): void;
     private clearQuotaResumeTimer;
     /** Schedule (or fire) auto-retry after a provider session/usage limit reset. */
     private scheduleQuotaResume;
@@ -2493,7 +2510,7 @@ declare const REVIEW_REQUEST_PATH = ".context/attachments/Review request.md";
 declare const LEGACY_REVIEW_REQUEST_PATH = ".sideboard/attachments/Review request.md";
 declare const REVIEW_REQUEST_NAME = "Review request.md";
 /** Short chat message — guidelines live in the attached review file. */
-declare const REVIEW_REQUEST_PREFILL = "Review.";
+declare const REVIEW_REQUEST_PREFILL = "Review changes in this workspace.";
 type ReviewGuidelinesSource = 'repo' | 'local' | 'stock';
 interface ResolvedReviewGuidelines {
     path: string;
@@ -2538,7 +2555,7 @@ interface RequestReviewResult {
 }
 type SendFn = (threadRef: string, prompt: string) => Promise<Thread>;
 /**
- * Open a fresh "Review" chat tab, attach resolved guidelines, send "Review."
+ * Open a fresh "Review" chat tab, attach resolved guidelines, send the review prefill.
  */
 declare function requestReview(threadRef: string, send: SendFn): Promise<RequestReviewResult>;
 
@@ -2663,8 +2680,12 @@ declare function coordinatorTurnReminder(opts: {
 /**
  * Write durable CLAUDE.md / AGENTS.md into the global synthetic cwd so Claude
  * (and other agents that load AGENTS.md) keep orchestrator identity on resume.
+ * When `orchestratorThreadId` is set, embed that uuid so Codex/Claude resume
+ * cannot invent a stale parentThreadId.
  */
-declare function ensureGlobalCoordinatorCwd(): string;
+declare function ensureGlobalCoordinatorCwd(opts?: {
+    orchestratorThreadId?: string | null;
+}): string;
 declare function coordinatorSystemPrompt(opts: {
     goal: string;
     parentId: string;