@code-yeongyu/senpi 2026.9.27-4 → 2026.9.28

package/dist/modes/interactive/session-failure-info.d.ts

@@ -0,0 +1,3 @@
+import type { SessionFailureReport } from "../../core/session-failure-report.ts";
+export declare function formatSessionFailureInfo(report: SessionFailureReport | undefined): string;
+//# sourceMappingURL=session-failure-info.d.ts.map

package/dist/modes/interactive/session-failure-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-failure-info.d.ts","sourceRoot":"","sources":["../../../src/modes/interactive/session-failure-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAIjF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,GAAG,MAAM,CAezF"}

package/dist/modes/interactive/session-failure-info.js

@@ -0,0 +1,21 @@
+import { formatDuration } from "../../utils/duration.js";
+import { theme } from "./theme/theme.js";
+export function formatSessionFailureInfo(report) {
+    if (!report)
+        return "";
+    const failed = report.erroredRequests + report.abortedRequests;
+    if (failed === 0)
+        return "";
+    const label = (text) => theme.fg("dim", text);
+    const share = `${(report.failureShare * 100).toFixed(1)}% failed`;
+    let info = `\n${theme.bold("Failures")}\n`;
+    info += `${label("Requests:")} ${report.requests} ${label(`(${report.erroredRequests} errored, ${report.abortedRequests} aborted, ${share})`)}\n`;
+    info += `${label("Time in failed requests:")} ${formatDuration(report.failedDurationMs)}\n`;
+    if (report.postFailureRequests > 0) {
+        const misses = report.postFailureFullMissRequests;
+        const tokens = report.postFailureFullMissInputTokens.toLocaleString();
+        info += `${label("Retries after a failure with no cache hit:")} ${misses} of ${report.postFailureRequests} ${label(`(${tokens} uncached input tokens)`)}\n`;
+    }
+    return info;
+}
+//# sourceMappingURL=session-failure-info.js.map

package/dist/modes/interactive/session-failure-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-failure-info.js","sourceRoot":"","sources":["../../../src/modes/interactive/session-failure-info.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,UAAU,wBAAwB,CAAC,MAAwC;IAChF,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAC/D,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;IAClE,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC3C,IAAI,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,eAAe,aAAa,MAAM,CAAC,eAAe,aAAa,KAAK,GAAG,CAAC,IAAI,CAAC;IAClJ,IAAI,IAAI,GAAG,KAAK,CAAC,0BAA0B,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC;IAC5F,IAAI,MAAM,CAAC,mBAAmB,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,CAAC,2BAA2B,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,CAAC,8BAA8B,CAAC,cAAc,EAAE,CAAC;QACtE,IAAI,IAAI,GAAG,KAAK,CAAC,4CAA4C,CAAC,IAAI,MAAM,OAAO,MAAM,CAAC,mBAAmB,IAAI,KAAK,CAAC,IAAI,MAAM,yBAAyB,CAAC,IAAI,CAAC;IAC7J,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["import type { SessionFailureReport } from \"../../core/session-failure-report.ts\";\nimport { formatDuration } from \"../../utils/duration.ts\";\nimport { theme } from \"./theme/theme.ts\";\n\nexport function formatSessionFailureInfo(report: SessionFailureReport | undefined): string {\n\tif (!report) return \"\";\n\tconst failed = report.erroredRequests + report.abortedRequests;\n\tif (failed === 0) return \"\";\n\tconst label = (text: string) => theme.fg(\"dim\", text);\n\tconst share = `${(report.failureShare * 100).toFixed(1)}% failed`;\n\tlet info = `\\n${theme.bold(\"Failures\")}\\n`;\n\tinfo += `${label(\"Requests:\")} ${report.requests} ${label(`(${report.erroredRequests} errored, ${report.abortedRequests} aborted, ${share})`)}\\n`;\n\tinfo += `${label(\"Time in failed requests:\")} ${formatDuration(report.failedDurationMs)}\\n`;\n\tif (report.postFailureRequests > 0) {\n\t\tconst misses = report.postFailureFullMissRequests;\n\t\tconst tokens = report.postFailureFullMissInputTokens.toLocaleString();\n\t\tinfo += `${label(\"Retries after a failure with no cache hit:\")} ${misses} of ${report.postFailureRequests} ${label(`(${tokens} uncached input tokens)`)}\\n`;\n\t}\n\treturn info;\n}\n"]}

package/dist/modes/interactive/tips/catalog/model-tips.d.ts

@@ -4,19 +4,19 @@ export declare const MODEL_TIPS: ({
     render: (keys: (binding: import("@earendil-works/pi-tui").Keybinding) => string) => string;
     requiresCommand?: undefined;
 } | {
+    id: string;
+    bindings: never[];
+    requiresCommand: string;
+    render: () => string;
+} | {
+    requiresCommand?: undefined;
     id: string;
     bindings: ("app.model.cycleBackward" | "app.model.cycleForward")[];
     render: (keys: (binding: import("@earendil-works/pi-tui").Keybinding) => string) => string;
-    requiresCommand?: undefined;
 } | {
+    requiresCommand?: undefined;
     id: string;
     bindings: ("app.model.select" | "app.models.toggleFavorite")[];
     render: (keys: (binding: import("@earendil-works/pi-tui").Keybinding) => string) => string;
-    requiresCommand?: undefined;
-} | {
-    id: string;
-    bindings: never[];
-    requiresCommand: string;
-    render: () => string;
 })[];
 //# sourceMappingURL=model-tips.d.ts.map

package/dist/modes/interactive/tips/catalog/model-tips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-tips.d.ts","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/model-tips.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;IAwDa,CAAC"}
+{"version":3,"file":"model-tips.d.ts","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/model-tips.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;IAgEa,CAAC"}

package/dist/modes/interactive/tips/catalog/model-tips.js

@@ -3,7 +3,13 @@ export const MODEL_TIPS = [
     {
         id: "thinking-level",
         bindings: ["app.thinking.cycle"],
-        render: (keys) => `Use ${keys("app.thinking.cycle")} to cycle the model's thinking level.`,
+        render: (keys) => `Use /thinking <level> to set the thinking level, /thinking to pick one, or ${keys("app.thinking.cycle")} to cycle through them.`,
+    },
+    {
+        id: "efforts-command",
+        bindings: [],
+        requiresCommand: "efforts",
+        render: () => "Use /efforts <level> to set the reasoning effort for the current model; /efforts alone lists the levels it supports.",
     },
     {
         id: "favorite-model-rotation",

package/dist/modes/interactive/tips/catalog/model-tips.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-tips.js","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/model-tips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,CAAC,oBAAoB,CAAC;QAChC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,CAAC,oBAAoB,CAAC,uCAAuC;KAC1F;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;QAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,uCAAuC,IAAI,CAAC,wBAAwB,CAAC,sBAAsB,IAAI,CAAC,yBAAyB,CAAC,GAAG;KAC9H;IACD;QACC,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EAAE,CAAC,kBAAkB,EAAE,2BAA2B,CAAC;QAC3D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,gCAAgC,IAAI,CAAC,kBAAkB,CAAC,cAAc,IAAI,CAAC,2BAA2B,CAAC,sCAAsC;KAC9I;IACD;QACC,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,4FAA4F;KAC1G;IACD;QACC,EAAE,EAAE,qBAAqB;QACzB,QAAQ,EAAE,CAAC,wBAAwB,CAAC;QACpC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,SAAS,QAAQ,6DAA6D,IAAI,CAAC,wBAAwB,CAAC,kBAAkB;KAC/H;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,6FAA6F;KAC3G;IACD;QACC,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,iGAAiG;KAC/G;IACD;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,iGAAiG;KAC/G;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CACZ,oHAAoH;KACrH;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,UAAU;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,qFAAqF;KACnG;CACkC,CAAC","sourcesContent":["import { APP_NAME } from \"../../../../config.ts\";\nimport type { TipDefinition } from \"./types.ts\";\n\nexport const MODEL_TIPS = [\n\t{\n\t\tid: \"thinking-level\",\n\t\tbindings: [\"app.thinking.cycle\"],\n\t\trender: (keys) => `Use ${keys(\"app.thinking.cycle\")} to cycle the model's thinking level.`,\n\t},\n\t{\n\t\tid: \"favorite-model-rotation\",\n\t\tbindings: [\"app.model.cycleForward\", \"app.model.cycleBackward\"],\n\t\trender: (keys) =>\n\t\t\t`Rotate through favorite models with ${keys(\"app.model.cycleForward\")}; go backward with ${keys(\"app.model.cycleBackward\")}.`,\n\t},\n\t{\n\t\tid: \"model-selector-favorites\",\n\t\tbindings: [\"app.model.select\", \"app.models.toggleFavorite\"],\n\t\trender: (keys) =>\n\t\t\t`Open the model selector with ${keys(\"app.model.select\")}, then use ${keys(\"app.models.toggleFavorite\")} to toggle the highlighted favorite.`,\n\t},\n\t{\n\t\tid: \"model-command-search\",\n\t\tbindings: [],\n\t\trender: () => \"Use /model to open the selector, or /model <pattern> to jump straight to a matching model.\",\n\t},\n\t{\n\t\tid: \"model-cycling-scope\",\n\t\tbindings: [\"app.model.cycleForward\"],\n\t\trender: (keys) =>\n\t\t\t`Start ${APP_NAME} with --models \"anthropic/*,gpt-5*\" to limit which models ${keys(\"app.model.cycleForward\")} cycles through.`,\n\t},\n\t{\n\t\tid: \"thinking-budgets\",\n\t\tbindings: [],\n\t\trender: () => \"Set thinkingBudgets in settings.json to choose the token budget behind each thinking level.\",\n\t},\n\t{\n\t\tid: \"prompt-preset\",\n\t\tbindings: [],\n\t\trender: () => \"Set promptPreset in settings.json when a model does not auto-detect the system prompt you want.\",\n\t},\n\t{\n\t\tid: \"provider-login\",\n\t\tbindings: [],\n\t\trender: () => \"Use /login to add a subscription or API-key provider, and /logout to remove stored credentials.\",\n\t},\n\t{\n\t\tid: \"fallback-chains-setting\",\n\t\tbindings: [],\n\t\trender: () =>\n\t\t\t\"retry.fallbackChains in settings.json maps a model to ordered fallbacks, so a failed turn retries on the next one.\",\n\t},\n\t{\n\t\tid: \"fallback-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"fallback\",\n\t\trender: () => \"Use /fallback to inspect and manage the retry fallback chain for the current model.\",\n\t},\n] satisfies readonly TipDefinition[];\n"]}
+{"version":3,"file":"model-tips.js","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/model-tips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,CAAC,oBAAoB,CAAC;QAChC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,8EAA8E,IAAI,CAAC,oBAAoB,CAAC,yBAAyB;KAClI;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,SAAS;QAC1B,MAAM,EAAE,GAAG,EAAE,CACZ,sHAAsH;KACvH;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;QAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,uCAAuC,IAAI,CAAC,wBAAwB,CAAC,sBAAsB,IAAI,CAAC,yBAAyB,CAAC,GAAG;KAC9H;IACD;QACC,EAAE,EAAE,0BAA0B;QAC9B,QAAQ,EAAE,CAAC,kBAAkB,EAAE,2BAA2B,CAAC;QAC3D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,gCAAgC,IAAI,CAAC,kBAAkB,CAAC,cAAc,IAAI,CAAC,2BAA2B,CAAC,sCAAsC;KAC9I;IACD;QACC,EAAE,EAAE,sBAAsB;QAC1B,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,4FAA4F;KAC1G;IACD;QACC,EAAE,EAAE,qBAAqB;QACzB,QAAQ,EAAE,CAAC,wBAAwB,CAAC;QACpC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAChB,SAAS,QAAQ,6DAA6D,IAAI,CAAC,wBAAwB,CAAC,kBAAkB;KAC/H;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,6FAA6F;KAC3G;IACD;QACC,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,iGAAiG;KAC/G;IACD;QACC,EAAE,EAAE,gBAAgB;QACpB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,iGAAiG;KAC/G;IACD;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CACZ,oHAAoH;KACrH;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,EAAE;QACZ,eAAe,EAAE,UAAU;QAC3B,MAAM,EAAE,GAAG,EAAE,CAAC,qFAAqF;KACnG;CACkC,CAAC","sourcesContent":["import { APP_NAME } from \"../../../../config.ts\";\nimport type { TipDefinition } from \"./types.ts\";\n\nexport const MODEL_TIPS = [\n\t{\n\t\tid: \"thinking-level\",\n\t\tbindings: [\"app.thinking.cycle\"],\n\t\trender: (keys) =>\n\t\t\t`Use /thinking <level> to set the thinking level, /thinking to pick one, or ${keys(\"app.thinking.cycle\")} to cycle through them.`,\n\t},\n\t{\n\t\tid: \"efforts-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"efforts\",\n\t\trender: () =>\n\t\t\t\"Use /efforts <level> to set the reasoning effort for the current model; /efforts alone lists the levels it supports.\",\n\t},\n\t{\n\t\tid: \"favorite-model-rotation\",\n\t\tbindings: [\"app.model.cycleForward\", \"app.model.cycleBackward\"],\n\t\trender: (keys) =>\n\t\t\t`Rotate through favorite models with ${keys(\"app.model.cycleForward\")}; go backward with ${keys(\"app.model.cycleBackward\")}.`,\n\t},\n\t{\n\t\tid: \"model-selector-favorites\",\n\t\tbindings: [\"app.model.select\", \"app.models.toggleFavorite\"],\n\t\trender: (keys) =>\n\t\t\t`Open the model selector with ${keys(\"app.model.select\")}, then use ${keys(\"app.models.toggleFavorite\")} to toggle the highlighted favorite.`,\n\t},\n\t{\n\t\tid: \"model-command-search\",\n\t\tbindings: [],\n\t\trender: () => \"Use /model to open the selector, or /model <pattern> to jump straight to a matching model.\",\n\t},\n\t{\n\t\tid: \"model-cycling-scope\",\n\t\tbindings: [\"app.model.cycleForward\"],\n\t\trender: (keys) =>\n\t\t\t`Start ${APP_NAME} with --models \"anthropic/*,gpt-5*\" to limit which models ${keys(\"app.model.cycleForward\")} cycles through.`,\n\t},\n\t{\n\t\tid: \"thinking-budgets\",\n\t\tbindings: [],\n\t\trender: () => \"Set thinkingBudgets in settings.json to choose the token budget behind each thinking level.\",\n\t},\n\t{\n\t\tid: \"prompt-preset\",\n\t\tbindings: [],\n\t\trender: () => \"Set promptPreset in settings.json when a model does not auto-detect the system prompt you want.\",\n\t},\n\t{\n\t\tid: \"provider-login\",\n\t\tbindings: [],\n\t\trender: () => \"Use /login to add a subscription or API-key provider, and /logout to remove stored credentials.\",\n\t},\n\t{\n\t\tid: \"fallback-chains-setting\",\n\t\tbindings: [],\n\t\trender: () =>\n\t\t\t\"retry.fallbackChains in settings.json maps a model to ordered fallbacks, so a failed turn retries on the next one.\",\n\t},\n\t{\n\t\tid: \"fallback-command\",\n\t\tbindings: [],\n\t\trequiresCommand: \"fallback\",\n\t\trender: () => \"Use /fallback to inspect and manage the retry fallback chain for the current model.\",\n\t},\n] satisfies readonly TipDefinition[];\n"]}

package/dist/modes/interactive/tips/catalog/session-tips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-tips.d.ts","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/session-tips.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY;;;;GAoDW,CAAC"}
+{"version":3,"file":"session-tips.d.ts","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/session-tips.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY;;;;GAqDW,CAAC"}

package/dist/modes/interactive/tips/catalog/session-tips.js

@@ -23,7 +23,7 @@ export const SESSION_TIPS = [
     {
         id: "continue-session",
         bindings: [],
-        render: () => `${APP_NAME} -c continues your most recent session; ${APP_NAME} -r opens the session picker.`,
+        render: () => `Use /resume or /sessions to reopen a past session; from the shell, ${APP_NAME} -r opens the same picker and ${APP_NAME} -c continues the most recent one.`,
     },
     {
         id: "session-name",

package/dist/modes/interactive/tips/catalog/session-tips.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-tips.js","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/session-tips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,yEAAyE;KACvF;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,0EAA0E;KACxF;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,sEAAsE;KACpF;IACD;QACC,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,gGAAgG;KAC9G;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,2CAA2C,QAAQ,+BAA+B;KAC3G;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,2FAA2F;KACzG;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,4EAA4E;KAC1F;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,mGAAmG;KACjH;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,gGAAgG;KAC9G;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CACZ,0HAA0H;KAC3H;CACkC,CAAC","sourcesContent":["import { APP_NAME } from \"../../../../config.ts\";\nimport type { TipDefinition } from \"./types.ts\";\n\nexport const SESSION_TIPS = [\n\t{\n\t\tid: \"favorite-models-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /favorite-models to choose and reorder the models in your rotation.\",\n\t},\n\t{\n\t\tid: \"tree-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /tree to revisit earlier points and switch between session branches.\",\n\t},\n\t{\n\t\tid: \"fork-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /fork to create a separate session from an earlier user message.\",\n\t},\n\t{\n\t\tid: \"clone-session\",\n\t\tbindings: [],\n\t\trender: () => \"Use /clone to duplicate the current branch into its own session before trying something risky.\",\n\t},\n\t{\n\t\tid: \"continue-session\",\n\t\tbindings: [],\n\t\trender: () => `${APP_NAME} -c continues your most recent session; ${APP_NAME} -r opens the session picker.`,\n\t},\n\t{\n\t\tid: \"session-name\",\n\t\tbindings: [],\n\t\trender: () => \"Use /rename [name] to label a session so it is easy to spot in the footer and in /resume.\",\n\t},\n\t{\n\t\tid: \"session-info\",\n\t\tbindings: [],\n\t\trender: () => \"Use /session to see the session file, id, message count, tokens, and cost.\",\n\t},\n\t{\n\t\tid: \"export-share\",\n\t\tbindings: [],\n\t\trender: () => \"Use /export to write the session to HTML or JSONL, or /share to upload it as a private gist link.\",\n\t},\n\t{\n\t\tid: \"compact-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /compact to compact context now, or /compact <prompt> to tell the summarizer what to keep.\",\n\t},\n\t{\n\t\tid: \"auto-compaction\",\n\t\tbindings: [],\n\t\trender: () =>\n\t\t\t\"Auto-compaction is on by default - the (auto) marker in the footer shows it; tune it with compaction.* in settings.json.\",\n\t},\n] satisfies readonly TipDefinition[];\n"]}
+{"version":3,"file":"session-tips.js","sourceRoot":"","sources":["../../../../../src/modes/interactive/tips/catalog/session-tips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B;QACC,EAAE,EAAE,yBAAyB;QAC7B,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,yEAAyE;KACvF;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,0EAA0E;KACxF;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,sEAAsE;KACpF;IACD;QACC,EAAE,EAAE,eAAe;QACnB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,gGAAgG;KAC9G;IACD;QACC,EAAE,EAAE,kBAAkB;QACtB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CACZ,sEAAsE,QAAQ,iCAAiC,QAAQ,oCAAoC;KAC5J;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,2FAA2F;KACzG;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,4EAA4E;KAC1F;IACD;QACC,EAAE,EAAE,cAAc;QAClB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,mGAAmG;KACjH;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CAAC,gGAAgG;KAC9G;IACD;QACC,EAAE,EAAE,iBAAiB;QACrB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,EAAE,CACZ,0HAA0H;KAC3H;CACkC,CAAC","sourcesContent":["import { APP_NAME } from \"../../../../config.ts\";\nimport type { TipDefinition } from \"./types.ts\";\n\nexport const SESSION_TIPS = [\n\t{\n\t\tid: \"favorite-models-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /favorite-models to choose and reorder the models in your rotation.\",\n\t},\n\t{\n\t\tid: \"tree-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /tree to revisit earlier points and switch between session branches.\",\n\t},\n\t{\n\t\tid: \"fork-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /fork to create a separate session from an earlier user message.\",\n\t},\n\t{\n\t\tid: \"clone-session\",\n\t\tbindings: [],\n\t\trender: () => \"Use /clone to duplicate the current branch into its own session before trying something risky.\",\n\t},\n\t{\n\t\tid: \"continue-session\",\n\t\tbindings: [],\n\t\trender: () =>\n\t\t\t`Use /resume or /sessions to reopen a past session; from the shell, ${APP_NAME} -r opens the same picker and ${APP_NAME} -c continues the most recent one.`,\n\t},\n\t{\n\t\tid: \"session-name\",\n\t\tbindings: [],\n\t\trender: () => \"Use /rename [name] to label a session so it is easy to spot in the footer and in /resume.\",\n\t},\n\t{\n\t\tid: \"session-info\",\n\t\tbindings: [],\n\t\trender: () => \"Use /session to see the session file, id, message count, tokens, and cost.\",\n\t},\n\t{\n\t\tid: \"export-share\",\n\t\tbindings: [],\n\t\trender: () => \"Use /export to write the session to HTML or JSONL, or /share to upload it as a private gist link.\",\n\t},\n\t{\n\t\tid: \"compact-command\",\n\t\tbindings: [],\n\t\trender: () => \"Use /compact to compact context now, or /compact <prompt> to tell the summarizer what to keep.\",\n\t},\n\t{\n\t\tid: \"auto-compaction\",\n\t\tbindings: [],\n\t\trender: () =>\n\t\t\t\"Auto-compaction is on by default - the (auto) marker in the footer shows it; tune it with compaction.* in settings.json.\",\n\t},\n] satisfies readonly TipDefinition[];\n"]}

package/dist/modes/rpc/host-attach-hold.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The ensuring client's claim on a host between `ensureHost()` proving it ready and that client's
+ * own attach. It is the very connection the readiness answer arrived on, kept open, so the
+ * supervisor counts it as an attachment and never measures idle time across the gap: a transient
+ * host with a short idle window cannot exit before the client that asked for it has attached.
+ *
+ * The claim ends when the caller releases it, and the operating system ends it when the ensuring
+ * process dies, so an abandoned ensure never pins a host. It never keeps its own process alive.
+ */
+import type { Socket } from "node:net";
+export interface HostAttachHold {
+    /** Ends the claim. Idempotent; call it once the client's own connection is attached. */
+    release(): void;
+}
+export declare function holdAttachment(socket: Socket): HostAttachHold;
+//# sourceMappingURL=host-attach-hold.d.ts.map

package/dist/modes/rpc/host-attach-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-attach-hold.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/host-attach-hold.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC9B,wFAAwF;IACxF,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAO7D"}

package/dist/modes/rpc/host-attach-hold.js

@@ -0,0 +1,9 @@
+export function holdAttachment(socket) {
+    // A host broadcasts lifecycle records to every connection; drain them so the pipe never backs up.
+    socket.removeAllListeners("data");
+    socket.resume();
+    socket.on("error", () => socket.destroy());
+    socket.unref();
+    return { release: () => socket.destroy() };
+}
+//# sourceMappingURL=host-attach-hold.js.map

package/dist/modes/rpc/host-attach-hold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-attach-hold.js","sourceRoot":"","sources":["../../../src/modes/rpc/host-attach-hold.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,cAAc,CAAC,MAAc;IAC5C,kGAAkG;IAClG,MAAM,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;AAC5C,CAAC","sourcesContent":["/**\n * The ensuring client's claim on a host between `ensureHost()` proving it ready and that client's\n * own attach. It is the very connection the readiness answer arrived on, kept open, so the\n * supervisor counts it as an attachment and never measures idle time across the gap: a transient\n * host with a short idle window cannot exit before the client that asked for it has attached.\n *\n * The claim ends when the caller releases it, and the operating system ends it when the ensuring\n * process dies, so an abandoned ensure never pins a host. It never keeps its own process alive.\n */\nimport type { Socket } from \"node:net\";\n\nexport interface HostAttachHold {\n\t/** Ends the claim. Idempotent; call it once the client's own connection is attached. */\n\trelease(): void;\n}\n\nexport function holdAttachment(socket: Socket): HostAttachHold {\n\t// A host broadcasts lifecycle records to every connection; drain them so the pipe never backs up.\n\tsocket.removeAllListeners(\"data\");\n\tsocket.resume();\n\tsocket.on(\"error\", () => socket.destroy());\n\tsocket.unref();\n\treturn { release: () => socket.destroy() };\n}\n"]}

package/dist/modes/rpc/host-cleanup-paths.d.ts

@@ -0,0 +1,20 @@
+/**
+ * What a host child removes when its supervisor dies without cleaning up, in the order it removes
+ * them. The registration pointer comes LAST: every reader takes "no pointer" to mean "this endpoint
+ * has no host", so the pointer may only disappear once everything it describes is already gone
+ * (senpi#2241).
+ */
+export interface HostCleanupTargets {
+    readonly pointerFile: string;
+    readonly generationPidFile: string;
+    readonly settingsFile: string;
+    readonly publicSocket: string;
+    /**
+     * A successor writes no registration of its own until the ensure that spawned it does, and the
+     * files under these paths still describe the generation being replaced.
+     */
+    readonly successor: boolean;
+    readonly platform: NodeJS.Platform;
+}
+export declare function hostCrashCleanupPaths(targets: HostCleanupTargets): string[];
+//# sourceMappingURL=host-cleanup-paths.d.ts.map

package/dist/modes/rpc/host-cleanup-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-cleanup-paths.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/host-cleanup-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;CACnC;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAU3E"}

package/dist/modes/rpc/host-cleanup-paths.js

@@ -0,0 +1,13 @@
+export function hostCrashCleanupPaths(targets) {
+    // POSIX public sockets are removed ownership-checked by the host child
+    // (token: the scratch-directory sidecar plus HOST_PUBLIC_SOCKET_ENV),
+    // never by path from a crash-path cleanup: a blind removal here would
+    // unlink a newer host's freshly published entry after a takeover.
+    // Windows named pipes have no filesystem entry to own, so they stay
+    // listed for the crash-path cleanup.
+    const publicEntry = targets.platform === "win32" ? [targets.publicSocket] : [];
+    if (targets.successor)
+        return publicEntry;
+    return [targets.generationPidFile, targets.settingsFile, ...publicEntry, targets.pointerFile];
+}
+//# sourceMappingURL=host-cleanup-paths.js.map

package/dist/modes/rpc/host-cleanup-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-cleanup-paths.js","sourceRoot":"","sources":["../../../src/modes/rpc/host-cleanup-paths.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAChE,uEAAuE;IACvE,sEAAsE;IACtE,sEAAsE;IACtE,kEAAkE;IAClE,oEAAoE;IACpE,qCAAqC;IACrC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,IAAI,OAAO,CAAC,SAAS;QAAE,OAAO,WAAW,CAAC;IAC1C,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,YAAY,EAAE,GAAG,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;AAC/F,CAAC","sourcesContent":["/**\n * What a host child removes when its supervisor dies without cleaning up, in the order it removes\n * them. The registration pointer comes LAST: every reader takes \"no pointer\" to mean \"this endpoint\n * has no host\", so the pointer may only disappear once everything it describes is already gone\n * (senpi#2241).\n */\nexport interface HostCleanupTargets {\n\treadonly pointerFile: string;\n\treadonly generationPidFile: string;\n\treadonly settingsFile: string;\n\treadonly publicSocket: string;\n\t/**\n\t * A successor writes no registration of its own until the ensure that spawned it does, and the\n\t * files under these paths still describe the generation being replaced.\n\t */\n\treadonly successor: boolean;\n\treadonly platform: NodeJS.Platform;\n}\n\nexport function hostCrashCleanupPaths(targets: HostCleanupTargets): string[] {\n\t// POSIX public sockets are removed ownership-checked by the host child\n\t// (token: the scratch-directory sidecar plus HOST_PUBLIC_SOCKET_ENV),\n\t// never by path from a crash-path cleanup: a blind removal here would\n\t// unlink a newer host's freshly published entry after a takeover.\n\t// Windows named pipes have no filesystem entry to own, so they stay\n\t// listed for the crash-path cleanup.\n\tconst publicEntry = targets.platform === \"win32\" ? [targets.publicSocket] : [];\n\tif (targets.successor) return publicEntry;\n\treturn [targets.generationPidFile, targets.settingsFile, ...publicEntry, targets.pointerFile];\n}\n"]}

package/dist/modes/rpc/host-client-occupancy.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The supervisor's view of its public-socket clients, split by what they mean for idle exit. A socket
+ * host applies the same view to its own connections for its empty-exit window.
+ *
+ * A client is UNCLASSIFIED until its first request line arrives, an OBSERVER while every line it has
+ * sent is an observing read (`host-observe-request.ts`), and ATTACHED from the first line that is
+ * anything else - or from a first line too long to be a read. Only attached clients are occupancy.
+ * An unclassified client neither counts nor lets the host exit: its first line may be the readiness
+ * probe of an ensure that is about to open a session.
+ */
+import type { Socket } from "node:net";
+export declare class ClientOccupancy {
+    private readonly clients;
+    private readonly observers;
+    private readonly attached;
+    private readonly onAttach;
+    constructor(onAttach: () => void);
+    get attachedCount(): number;
+    get unclassifiedCount(): number;
+    admit(client: Socket): void;
+    release(client: Socket): void;
+    destroyAll(): void;
+}
+//# sourceMappingURL=host-client-occupancy.d.ts.map

package/dist/modes/rpc/host-client-occupancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-client-occupancy.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/host-client-occupancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAMvC,qBAAa,eAAe;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IAEtC,YAAY,QAAQ,EAAE,MAAM,IAAI,EAE/B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAwB1B;IAED,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI5B;IAED,UAAU,IAAI,IAAI,CAEjB;CACD"}

package/dist/modes/rpc/host-client-occupancy.js

@@ -0,0 +1,53 @@
+import { isObservingRequest } from "./host-observe-request.js";
+const MAX_CLASSIFIED_LINE_BYTES = 64 * 1024;
+const NEWLINE = 0x0a;
+export class ClientOccupancy {
+    constructor(onAttach) {
+        this.clients = new Set();
+        this.observers = new Set();
+        this.attached = new Set();
+        this.onAttach = onAttach;
+    }
+    get attachedCount() {
+        return this.attached.size;
+    }
+    get unclassifiedCount() {
+        return this.clients.size - this.observers.size - this.attached.size;
+    }
+    admit(client) {
+        this.clients.add(client);
+        let pending = Buffer.alloc(0);
+        const attach = () => {
+            client.off("data", classify);
+            pending = Buffer.alloc(0);
+            this.observers.delete(client);
+            this.attached.add(client);
+            this.onAttach();
+        };
+        const classify = (chunk) => {
+            pending = Buffer.concat([pending, chunk]);
+            for (let newline = pending.indexOf(NEWLINE); newline !== -1; newline = pending.indexOf(NEWLINE)) {
+                const line = pending.subarray(0, newline).toString("utf8");
+                pending = pending.subarray(newline + 1);
+                if (!isObservingRequest(line)) {
+                    attach();
+                    return;
+                }
+                this.observers.add(client);
+            }
+            if (pending.length > MAX_CLASSIFIED_LINE_BYTES)
+                attach();
+        };
+        client.on("data", classify);
+    }
+    release(client) {
+        this.clients.delete(client);
+        this.observers.delete(client);
+        this.attached.delete(client);
+    }
+    destroyAll() {
+        for (const client of this.clients)
+            client.destroy();
+    }
+}
+//# sourceMappingURL=host-client-occupancy.js.map

package/dist/modes/rpc/host-client-occupancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-client-occupancy.js","sourceRoot":"","sources":["../../../src/modes/rpc/host-client-occupancy.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,yBAAyB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC5C,MAAM,OAAO,GAAG,IAAI,CAAC;AAErB,MAAM,OAAO,eAAe;IAM3B,YAAY,QAAoB;QALf,YAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAC5B,cAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,aAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAI7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,IAAI,iBAAiB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,IAAI,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,GAAS,EAAE;YACzB,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7B,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAQ,EAAE;YACxC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC1C,KAAK,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjG,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAC3D,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACxC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,MAAM,EAAE,CAAC;oBACT,OAAO;gBACR,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC5B,CAAC;YACD,IAAI,OAAO,CAAC,MAAM,GAAG,yBAAyB;gBAAE,MAAM,EAAE,CAAC;QAC1D,CAAC,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,MAAc;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,UAAU;QACT,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC;CACD","sourcesContent":["/**\n * The supervisor's view of its public-socket clients, split by what they mean for idle exit. A socket\n * host applies the same view to its own connections for its empty-exit window.\n *\n * A client is UNCLASSIFIED until its first request line arrives, an OBSERVER while every line it has\n * sent is an observing read (`host-observe-request.ts`), and ATTACHED from the first line that is\n * anything else - or from a first line too long to be a read. Only attached clients are occupancy.\n * An unclassified client neither counts nor lets the host exit: its first line may be the readiness\n * probe of an ensure that is about to open a session.\n */\nimport type { Socket } from \"node:net\";\nimport { isObservingRequest } from \"./host-observe-request.ts\";\n\nconst MAX_CLASSIFIED_LINE_BYTES = 64 * 1024;\nconst NEWLINE = 0x0a;\n\nexport class ClientOccupancy {\n\tprivate readonly clients = new Set<Socket>();\n\tprivate readonly observers = new Set<Socket>();\n\tprivate readonly attached = new Set<Socket>();\n\tprivate readonly onAttach: () => void;\n\n\tconstructor(onAttach: () => void) {\n\t\tthis.onAttach = onAttach;\n\t}\n\n\tget attachedCount(): number {\n\t\treturn this.attached.size;\n\t}\n\n\tget unclassifiedCount(): number {\n\t\treturn this.clients.size - this.observers.size - this.attached.size;\n\t}\n\n\tadmit(client: Socket): void {\n\t\tthis.clients.add(client);\n\t\tlet pending = Buffer.alloc(0);\n\t\tconst attach = (): void => {\n\t\t\tclient.off(\"data\", classify);\n\t\t\tpending = Buffer.alloc(0);\n\t\t\tthis.observers.delete(client);\n\t\t\tthis.attached.add(client);\n\t\t\tthis.onAttach();\n\t\t};\n\t\tconst classify = (chunk: Buffer): void => {\n\t\t\tpending = Buffer.concat([pending, chunk]);\n\t\t\tfor (let newline = pending.indexOf(NEWLINE); newline !== -1; newline = pending.indexOf(NEWLINE)) {\n\t\t\t\tconst line = pending.subarray(0, newline).toString(\"utf8\");\n\t\t\t\tpending = pending.subarray(newline + 1);\n\t\t\t\tif (!isObservingRequest(line)) {\n\t\t\t\t\tattach();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tthis.observers.add(client);\n\t\t\t}\n\t\t\tif (pending.length > MAX_CLASSIFIED_LINE_BYTES) attach();\n\t\t};\n\t\tclient.on(\"data\", classify);\n\t}\n\n\trelease(client: Socket): void {\n\t\tthis.clients.delete(client);\n\t\tthis.observers.delete(client);\n\t\tthis.attached.delete(client);\n\t}\n\n\tdestroyAll(): void {\n\t\tfor (const client of this.clients) client.destroy();\n\t}\n}\n"]}

package/dist/modes/rpc/host-daemon-paths.d.ts

@@ -4,14 +4,18 @@ export declare const HOST_DAEMON_LAYOUT = 2;
 export declare const HOST_DAEMON_DIR_ENV = "SENPI_RPC_HOST_DAEMON_DIR";
 export declare const HOST_STATE_FILE_MODE = 384;
 export interface HostDaemonPaths {
+    /** The endpoint these paths belong to, exactly as its directory name was derived from. */
+    readonly socket: string;
     /** `<agentDir>/rpc-host-daemon`: shared by every endpoint, and by any legacy host's own state. */
     readonly flatDir: string;
     /** The only file this build writes into the flat directory: `{ layout, dir }`. */
     readonly layoutMarker: string;
     /** A LEGACY host's registration. Read-only evidence that another host may be running. */
     readonly legacyPidFile: string;
-    /** This endpoint's state directory, `<flatDir>/<sha256(socket)[:16]>`. */
+    /** This endpoint's state directory, `<flatDir>/<sha256(canonical socket)[:16]>`. */
     readonly dir: string;
+    /** Durable identity `{ layout, socket, created_at }`: survives every generation's release. */
+    readonly endpointFile: string;
     /** The pointer at the current generation. Deliberately unparseable as a legacy pidfile. */
     readonly pointerFile: string;
     /** Cross-version ensure lock for this endpoint (the endpoint lock itself lives in the temp dir). */
@@ -21,6 +25,8 @@ export interface HostDaemonPaths {
     readonly generationsDir: string;
     readonly reservationsDir: string;
 }
+/** The files inside one endpoint's directory, for a reader that has the directory but not its socket. */
+export type HostDaemonDirectory = Omit<HostDaemonPaths, "socket" | "flatDir" | "layoutMarker" | "legacyPidFile">;
 export interface HostGenerationPaths {
     readonly dir: string;
     /** Where the pointer names this generation: relative to the daemon directory holding it. */
@@ -30,13 +36,44 @@ export interface HostGenerationPaths {
     readonly scratchDir: string;
 }
 /**
- * The directory name every client recomputes from the socket alone: `sha256(<canonical endpoint>)`,
- * where the canonical endpoint is the socket path on POSIX and the normalized lower-cased path on
- * win32 (the same canonicalization the pipe name is derived from, so two spellings of one endpoint
- * share one directory). Deliberately total: naming a directory must never fail on a path shape the
- * transport would reject, or a client could not even report WHERE it was looking.
+ * The one spelling of an endpoint every client derives the same way. On POSIX that is the socket path
+ * with its directory resolved through its deepest existing ancestor (`/tmp` vs `/private/tmp`, a
+ * symlinked agent directory) - the identity the ensure lock is keyed by - and a path already spelled
+ * that way comes back unchanged. On win32 it is the normalized lower-cased path the pipe name is derived
+ * from. An abstract socket has no directory to resolve. Deliberately total: naming a directory must never
+ * fail on a path shape the transport would reject, or a client could not even report WHERE it was looking.
+ */
+export declare function canonicalEndpointPath(socket: string, platform?: NodeJS.Platform): string;
+/**
+ * The directory name every client recomputes from the socket alone: `sha256(<canonical endpoint>)`, so
+ * every spelling of one endpoint shares one directory, and a canonical spelling keeps the name it had
+ * when the name was hashed from the spelling itself.
  */
 export declare function daemonDirectoryName(socket: string, platform?: NodeJS.Platform): string;
+/** Whether two spellings name one endpoint. */
+export declare function sameEndpoint(socket: string, other: string): boolean;
+/**
+ * Whether a record naming `socket` belongs in the directory called `name`: the canonical name, or the
+ * name a build that hashed the spelling itself gave it - that directory has to stay listable, and
+ * therefore collectable by `host gc`, after the upgrade.
+ */
+export declare function socketNamesDirectory(socket: string, name: string): boolean;
+/**
+ * The owner-keyed shard naming contract every client computes identically - senpi, omo (library
+ * import) and the Desktop (a local mirror checked against `senpi host shard-path`): `p` shards belong
+ * to a parent session, `i` shards to an interactive thread. The key is `sha256("<kind>:<owner>")` in
+ * hex, first 16 characters; the socket is `<root>/<kind>-<key>.sock`.
+ */
+export type ShardKind = "p" | "i";
+export declare function shardKey(kind: ShardKind, ownerId: string): string;
+/** The socket of a shard whose key is already known. No hashing: the key IS the name. */
+export declare function shardSocketPathForKey(root: string, kind: ShardKind, key: string): string;
+export declare function shardSocketPath(root: string, kind: ShardKind, ownerId: string): string;
+/** Which shard a socket names, from its basename alone; `null` for any other endpoint. */
+export declare function parseShardSocket(socket: string): {
+    readonly kind: ShardKind;
+    readonly key: string;
+} | null;
 /**
  * The daemon directory of ONE endpoint. Both fields are named rather than positional on purpose:
  * two strings in a row is exactly the call a refactor silently swaps, and swapping these two would
@@ -52,8 +89,8 @@ export declare function createHostDaemonPaths(target: {
  * The names live here alone, so the directory a client recomputes and the one a host is handed
  * can never drift apart.
  */
-export declare function hostDaemonDirectoryPaths(dir: string): Omit<HostDaemonPaths, "flatDir" | "layoutMarker" | "legacyPidFile">;
-export declare function generationPaths(paths: HostDaemonPaths, instanceId: string): HostGenerationPaths;
+export declare function hostDaemonDirectoryPaths(dir: string): HostDaemonDirectory;
+export declare function generationPaths(paths: HostDaemonDirectory, instanceId: string): HostGenerationPaths;
 /** A daemon directory that cannot be created or written, named so the caller can say WHICH path failed. */
 export declare class HostDaemonStateError extends Error {
     readonly path: string;
@@ -65,6 +102,22 @@ export declare class HostDaemonStateError extends Error {
  * created with - and this one holds the evidence that decides who may signal the daemon.
  */
 export declare function createDaemonDirectories(paths: HostDaemonPaths): Promise<void>;
+/**
+ * Writes `endpoint.json` when it is absent and never rewrites a valid one: the first writer's
+ * `created_at` is the endpoint's birth. The file is written whole to a temporary name and LINKED
+ * into place, so a reader never sees it half-written and a second writer racing the first loses on
+ * the link rather than replacing it. `repair` - asserted only by an ensure under this socket's ensure
+ * lock, where `gc` cannot be deciding about the directory - also replaces a file that does not name a
+ * socket of this directory (torn by a crash of an older build, or foreign), which would otherwise
+ * leave the endpoint unaddressable, and never `gc`-able, for good.
+ *
+ * A filesystem without hard links (exFAT/FAT, some network and FUSE mounts: `link()` fails with
+ * ENOTSUP, EPERM, ENOSYS...) gets the exclusive create of the final file instead. That write is not
+ * atomic, but the first writer still wins, and a file torn by a crash is exactly what `repair` rewrites.
+ */
+export declare function ensureEndpointIdentity(paths: HostDaemonPaths, socket: string, options?: {
+    readonly repair?: boolean;
+}): Promise<void>;
 /** Creates one generation's private directory. Same failure shape as the daemon directory itself. */
 export declare function createGenerationDirectory(generation: HostGenerationPaths): Promise<void>;
 //# sourceMappingURL=host-daemon-paths.d.ts.map

package/dist/modes/rpc/host-daemon-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-daemon-paths.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/host-daemon-paths.ts"],"names":[],"mappings":"AAgCA,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,mGAAmG;AACnG,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAG/D,eAAO,MAAM,oBAAoB,MAAQ,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC/B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAGxG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,eAAe,CAQlB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACvC,GAAG,EAAE,MAAM,GACT,IAAI,CAAC,eAAe,EAAE,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC,CAUrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAS/F;AAED,2GAA2G;AAC3G,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAMvC;CACD;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBnF;AAED,qGAAqG;AACrG,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9F"}
+{"version":3,"file":"host-daemon-paths.d.ts","sourceRoot":"","sources":["../../../src/modes/rpc/host-daemon-paths.ts"],"names":[],"mappings":"AAwCA,qGAAqG;AACrG,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,mGAAmG;AACnG,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAG/D,eAAO,MAAM,oBAAoB,MAAQ,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,oGAAoG;IACpG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACjC;AAED,yGAAyG;AACzG,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC,CAAC;AAEjH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAI1G;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAExG;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1E;AAMD;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;AAElC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,yFAAyF;AACzF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtF;AAID,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK1G;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,eAAe,CASlB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAWzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,mBAAmB,CASnG;AAED,2GAA2G;AAC3G,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,YAAY,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAMvC;CACD;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACzC,OAAO,CAAC,IAAI,CAAC,CAkBf;AAgCD,qGAAqG;AACrG,wBAAsB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAO9F"}