@crouton-kit/crouter 0.3.66 → 0.3.67

package/dist/clients/attach/attach-cmd.d.ts

@@ -1,7 +1,35 @@
 import { CombinedAutocompleteProvider } from '@earendil-works/pi-tui';
 import type { BranchDef } from '../../core/command.js';
-import type { BrokerSnapshot } from '../../core/runtime/broker-protocol.js';
+import type { BrokerSnapshot, ClientRole } from '../../core/runtime/broker-protocol.js';
 import { type AttachPalette } from './config-load.js';
+export type Mode = 'normal' | 'spec' | 'plan';
+/** Resolve the mode badge's initial state. Remote never reads the local
+ *  mode-switch `current` file for `nodeId` — always starts 'normal'. */
+export declare function resolveInitialMode(cwd: string, nodeId: string, remote: boolean, readMode?: (cwd: string, nodeId: string) => Mode | undefined): Mode;
+/** Handle Alt+M's mode-cycle request. Remote no-ops entirely (returns `false`,
+ *  so the caller leaves `modeState`/the badge untouched) — there is no
+ *  remote-safe mode-switch protocol, and writing the local `request.json` for a
+ *  remote node id would target the wrong (or a colliding local) node. */
+export declare function requestModeSwitch(cwd: string, nodeId: string, remote: boolean, mode: Mode, writeRequest?: (cwd: string, nodeId: string, mode: Mode) => void): boolean;
+/** Tag/untag the attach pane with `nodeId` so the host-agnostic `nodeInPane()`
+ *  (Alt+C cycle/recycle/close/demote) resolves this broker-hosted node from its
+ *  viewer pane — LOCAL ONLY. Remote never sets `@crtr_node`, so local Alt+C
+ *  lifecycle can never resolve a remote id (or a local id it collides with)
+ *  from this pane. */
+export declare function tagAttachPane(remote: boolean, pane: string | undefined, nodeId: string, setOpt?: (pane: string, name: string, value: string) => void): void;
+export declare function untagAttachPane(remote: boolean, pane: string | undefined, setOpt?: (pane: string, name: string, value: string) => void): void;
+/** A clean detach reaps an empty LOCAL node (an AI-output-free shell the user
+ *  walked away from) — LOCAL ONLY. `reapIfEmpty` deletes a local canvas.db row;
+ *  remote never calls it, so a remote attach can never delete a local node on
+ *  detach even when the remote id collides with one. */
+export declare function reapOnDetach(remote: boolean, nodeId: string, reap?: (nodeId: string) => void): void;
+/** The hello handshake's initial role. A REMOTE attach (`--canvas`) is a
+ *  strictly VIEW-ONLY surface (Phase 3 review Major 1) — it must claim
+ *  observer regardless of `--observer`, never controller. Local attach keeps
+ *  today's exact behavior: controller unless `--observer`. Exported pure so
+ *  the "remote is always observer" contract is unit-testable without
+ *  constructing a real hello/socket. */
+export declare function resolveHelloRole(remote: boolean, observer: boolean): ClientRole;
 /** Derive the shell-mode cue from the editor contents. Leading whitespace is
  *  ignored so pasted commands and indented text still toggle correctly. */
 export declare function deriveBashMode(text: string): 0 | 1 | 2;
@@ -13,7 +41,7 @@ export declare function resolveEditorFrameStyles(bashMode: 0 | 1 | 2, thinkingLe
 export declare function buildAttachAutocompleteProvider(cwd: string, fdPath: string | null, commands?: ReadonlyArray<{
     name: string;
     description?: string;
-}>, createProvider?: (items: ReadonlyArray<{
+}>, remote?: boolean, createProvider?: (items: ReadonlyArray<{
     name: string;
     description?: string;
 }>, cwd: string, fdPath: string | null) => CombinedAutocompleteProvider): CombinedAutocompleteProvider;