@kasenri/dsh-orbit 0.5.3 → 0.5.5

package/lib/activation.js

@@ -1,15 +1,13 @@
 /**
- * Deterministic `/agent-orbit` activation.
+ * Deterministic Orbit activation.
  *
- * Two routes converge on the same tiny pre-step directive:
- * - a closed-namespace DSH host command for surfaces with command adjudication
- *   (the Web GUI slash menu), and
- * - a strict genuine-user-message gesture boundary for headless/CLI surfaces
- *   without one.
- *
- * Neither route creates an execution entry of its own: the directive only
- * states that activation is explicit, and the existing `orbit_controller`
- * tool + `OrbitService` + Supervisor remain the sole Orbit runtime.
+ * - `/agent-orbit` (host command or genuine-message gesture) keeps its explicit
+ *   directive; the existing `orbit_controller` tool + `OrbitService` remain the
+ *   runtime.
+ * - A Session whose toggle is ON hands every ordinary user message straight to
+ *   `OrbitService`: the pre-step boundary consumes the turn (no parent model
+ *   call, no parent mutation) and the host starts or resumes the run. The model
+ *   never decides whether Orbit runs.
  */
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { ORBIT_TOGGLE_COMMAND, parseOrbitToggle } from "./session-state.js";
@@ -70,17 +68,6 @@ export function buildOrbitActivationDirective(goal) {
         : `Goal: ${goal}`);
     return lines.join('\n');
 }
-/**
- * The directive for a Session whose toggle is ON: an ordinary user message
- * becomes the Orbit goal without changing the activation machinery.
- */
-export function buildOrbitSessionDirective(goal) {
-    return [
-        'Orbit is enabled for this chat, so treat this ordinary user message as the requested goal. Start or resume Orbit through the existing orbit_controller tool; do not ask the user to confirm the mode.',
-        'Use the message as the goal, without summarizing or rewriting it.',
-        `Goal: ${goal}`,
-    ].join('\n');
-}
 /**
  * Register the closed-namespace `/agent-orbit` host command.
  *
@@ -135,15 +122,13 @@ export function registerOrbitToggleCommand(ctx) {
     }), 'dsh-orbit: /orbit-toggle host command');
 }
 /**
- * Install the gesture boundary. It runs for every proposed step and injects
- * the activation directive once, for the step that carries the genuine user
- * message. The in-step guard keeps a step that already holds an Orbit
- * directive from gaining a second one, without any durable state.
+ * Install the gesture boundary. It runs for every proposed step.
  *
  * An explicit `/agent-orbit` always wins and always activates, whatever the
- * Session toggle says. Only when no explicit activation is present does the
- * Session toggle (when the composition provides it) promote an ordinary user
- * message into an Orbit goal.
+ * Session toggle says: it keeps the existing activation directive and the
+ * `orbit_controller` tool. Otherwise, an enabled Session hands the ordinary
+ * user message to Orbit directly — the step is consumed with no model call and
+ * the message stays in the conversation as durable history.
  */
 export function installOrbitGestureBoundary(ctx, options = {}) {
     ctx.on('agent/pre-step', async ({ agent, messages, signal }, next) => {
@@ -153,25 +138,31 @@ export function installOrbitGestureBoundary(ctx, options = {}) {
         if (decision.messages.some((message) => message.source.kind === 'orbit-command'))
             return decision;
         const explicit = invokedOrbitActivation(messages);
-        const implicit = explicit === undefined && options.sessionEnabled?.(agent.session) === true
-            ? invokedOrbitMessage(messages)
-            : undefined;
-        if (explicit === undefined && implicit === undefined)
+        if (explicit !== undefined) {
+            signal.throwIfAborted();
+            return {
+                kind: 'enter',
+                messages: [
+                    ...decision.messages,
+                    createUserMessage({
+                        content: [{ type: 'text', text: buildOrbitActivationDirective(explicit.goal) }],
+                        source: { kind: 'orbit-command', ...(explicit.goal === '' ? {} : { goal: explicit.goal }) },
+                    }),
+                ],
+            };
+        }
+        if (options.sessionEnabled?.(agent.session) !== true)
+            return decision;
+        const ordinary = invokedOrbitMessage(messages);
+        const activate = options.activate;
+        if (ordinary === undefined || activate === undefined)
             return decision;
         signal.throwIfAborted();
-        const activation = explicit ?? implicit ?? { goal: '' };
-        const directive = explicit === undefined
-            ? buildOrbitSessionDirective(activation.goal)
-            : buildOrbitActivationDirective(activation.goal);
-        return {
-            kind: 'enter',
-            messages: [
-                ...decision.messages,
-                createUserMessage({
-                    content: [{ type: 'text', text: directive }],
-                    source: { kind: 'orbit-command', ...(activation.goal === '' ? {} : { goal: activation.goal }) },
-                }),
-            ],
-        };
+        // The claimed batch enters the conversation exactly once: the loop commits
+        // `decision.messages`, which this path leaves empty.
+        for (const message of messages)
+            agent.session.append('user/message', message, { surfaceOp: 'append' });
+        await activate(agent, ordinary.goal, signal);
+        return { kind: 'enter', messages: [] };
     });
 }

package/lib/client.js

@@ -122,7 +122,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:/root/code/dsh-pi-parity/packages/orbit/client/OrbitModelSelect.module.css.mjs
-		const css = ".f77nca_panel{z-index:60;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-specific-menu);min-width:260px;max-width:420px;max-height:min(55vh,420px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;padding:6px;font-size:13px;line-height:1.4;display:flex;position:fixed;overflow:auto}.f77nca_title{color:var(--dsw-alias-label-tertiary);letter-spacing:.04em;text-transform:uppercase;padding:6px 8px 2px;font-size:11px}.f77nca_group{color:var(--dsw-alias-label-tertiary);padding:8px 8px 2px;font-size:11px}.f77nca_row{width:100%;color:inherit;font:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:8px;align-items:center;gap:8px;padding:7px 8px;display:flex}.f77nca_row:hover{background:var(--dsw-alias-interactive-bg-hover)}.f77nca_switchRow{align-items:center;gap:8px;padding:4px 8px 6px;display:flex}.f77nca_switchControl{margin-left:auto}.f77nca_rowLabel{flex:none}.f77nca_rowValue{max-width:190px;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;margin-left:auto;overflow:hidden}.f77nca_rowValueActive{color:var(--dsw-alias-label-primary)}.f77nca_rowDetail{color:var(--dsw-alias-label-tertiary);margin-left:auto;font-size:11px}.f77nca_check{color:var(--dsw-alias-state-business-primary);flex:none;margin-left:6px}.f77nca_chevron{color:var(--dsw-alias-label-tertiary);flex:none;margin-left:6px}.f77nca_separator{background:var(--dsw-alias-border-l1);height:1px;margin:6px 4px}.f77nca_hint{color:var(--dsw-alias-label-tertiary);padding:6px 8px;font-size:11px}.f77nca_error{color:var(--dsw-alias-state-error-primary);align-items:center;gap:8px;padding:8px;font-size:12px;display:flex}.f77nca_back{width:100%;color:var(--dsw-alias-label-tertiary);font:inherit;text-align:left;cursor:pointer;background:0 0;border:0;align-items:center;gap:6px;padding:6px 8px 8px;font-size:12px;display:flex}";
+		const css = ".f77nca_panel{z-index:60;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-specific-menu);min-width:260px;max-width:420px;max-height:min(55vh,420px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;padding:6px;font-size:13px;line-height:1.4;display:flex;position:fixed;overflow:auto}.f77nca_title{color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;padding:6px 8px 2px;font-size:11px;overflow:hidden}.f77nca_group{color:var(--dsw-alias-label-tertiary);padding:8px 8px 2px;font-size:11px}.f77nca_row{width:100%;color:inherit;font:inherit;text-align:left;cursor:pointer;background:0 0;border:0;border-radius:8px;align-items:center;gap:8px;padding:7px 8px;display:flex}.f77nca_row:hover{background:var(--dsw-alias-interactive-bg-hover)}.f77nca_switchRow{align-items:center;gap:8px;padding:4px 8px 6px;display:flex}.f77nca_switchControl{margin-left:auto}.f77nca_rowLabel{flex:none}.f77nca_rowValue{max-width:190px;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;margin-left:auto;overflow:hidden}.f77nca_rowValueActive{color:var(--dsw-alias-label-primary)}.f77nca_rowDetail{color:var(--dsw-alias-label-tertiary);margin-left:auto;font-size:11px}.f77nca_check{color:var(--dsw-alias-state-business-primary);flex:none;margin-left:6px}.f77nca_chevron{color:var(--dsw-alias-label-tertiary);flex:none;margin-left:6px}.f77nca_separator{background:var(--dsw-alias-border-l1);height:1px;margin:6px 4px}.f77nca_hint{color:var(--dsw-alias-label-tertiary);padding:6px 8px;font-size:11px}.f77nca_error{color:var(--dsw-alias-state-error-primary);align-items:center;gap:8px;padding:8px;font-size:12px;display:flex}.f77nca_back{width:100%;color:var(--dsw-alias-label-tertiary);font:inherit;text-align:left;cursor:pointer;background:0 0;border:0;align-items:center;gap:6px;padding:6px 8px 8px;font-size:12px;display:flex}";
 		const tagId = "@kasenri/dsh-orbit/OrbitModelSelect.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -132,22 +132,22 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var OrbitModelSelect_module_css_default = {
-			"error": "f77nca_error",
-			"chevron": "f77nca_chevron",
-			"back": "f77nca_back",
-			"rowValueActive": "f77nca_rowValueActive",
-			"hint": "f77nca_hint",
+			"check": "f77nca_check",
 			"switchControl": "f77nca_switchControl",
-			"group": "f77nca_group",
-			"panel": "f77nca_panel",
-			"separator": "f77nca_separator",
-			"title": "f77nca_title",
 			"switchRow": "f77nca_switchRow",
-			"rowValue": "f77nca_rowValue",
 			"rowDetail": "f77nca_rowDetail",
-			"check": "f77nca_check",
+			"title": "f77nca_title",
+			"panel": "f77nca_panel",
 			"row": "f77nca_row",
-			"rowLabel": "f77nca_rowLabel"
+			"rowLabel": "f77nca_rowLabel",
+			"group": "f77nca_group",
+			"error": "f77nca_error",
+			"rowValueActive": "f77nca_rowValueActive",
+			"separator": "f77nca_separator",
+			"chevron": "f77nca_chevron",
+			"rowValue": "f77nca_rowValue",
+			"back": "f77nca_back",
+			"hint": "f77nca_hint"
 		};
 		//#endregion
 		//#region client/OrbitModelSelect.tsx
@@ -249,6 +249,7 @@ window.__ModuleLoader__.load({
 			};
 			const currentRouteOf = (role) => role === "commander" ? config.commander : role === "watchdog" ? config.watchdog : executorRoute;
 			const roleLabelOf = (role) => role === "commander" ? commanderLabel : role === "watchdog" ? watchdogLabel : executorLabel;
+			const roleModelLabelOf = (role) => t(role === "commander" ? "commanderModel" : role === "executor" ? "executorModel" : "watchdogModel");
 			const roleEffortLabelOf = (role) => role === "commander" ? commanderEffort : role === "watchdog" ? watchdogEffort : executorEffort;
 			const commitEffort = async (role, route, effort) => {
 				const next = {
@@ -371,7 +372,7 @@ window.__ModuleLoader__.load({
 							className: OrbitModelSelect_module_css_default.switchRow,
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: OrbitModelSelect_module_css_default.rowLabel,
-								children: t("orbit")
+								children: t("enableLongRun")
 							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
 								className: OrbitModelSelect_module_css_default.switchControl,
 								checked: orbitEnabled,
@@ -467,10 +468,6 @@ window.__ModuleLoader__.load({
 						})
 					] }) : null,
 					pane.kind === "role" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
-						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-							className: OrbitModelSelect_module_css_default.group,
-							children: t(pane.role)
-						}),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 							type: "button",
 							role: "menuitem",
@@ -485,7 +482,7 @@ window.__ModuleLoader__.load({
 							children: [
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: OrbitModelSelect_module_css_default.rowLabel,
-									children: t("models")
+									children: roleModelLabelOf(pane.role)
 								}),
 								/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 									className: OrbitModelSelect_module_css_default.rowValue,
@@ -564,7 +561,7 @@ window.__ModuleLoader__.load({
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: OrbitModelSelect_module_css_default.separator }),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: OrbitModelSelect_module_css_default.hint,
-						children: t("nextRunOnly")
+						children: t("applyOnNextSend")
 					})
 				]
 			}), document.body) : null] });
@@ -576,13 +573,16 @@ window.__ModuleLoader__.load({
 		const en = {
 			triggerFallback: "Orbit",
 			tooltip: "Orbit model configuration",
-			title: "Orbit",
-			orbit: "Orbit",
+			title: "Orbit — Self-reviewing continuous execution",
+			enableLongRun: "Enable long-running execution",
 			orbitOff: "Orbit Off",
 			orbitSwitchLabel: "Orbit for this chat",
 			commander: "Commander",
 			executor: "Executor",
 			watchdog: "Watchdog",
+			commanderModel: "Commander model",
+			executorModel: "Executor model",
+			watchdogModel: "Watchdog model",
 			followsSession: "Follows current session model",
 			models: "Model",
 			effort: "Reasoning effort",
@@ -592,19 +592,22 @@ window.__ModuleLoader__.load({
 			loadFailed: "Failed to load models",
 			settingsFailed: "Failed to load Orbit settings",
 			saveFailed: "Failed to save Orbit settings",
-			nextRunOnly: "Changes apply to the next Orbit run"
+			applyOnNextSend: "Changes apply to the next message"
 		};
 		/** Chinese strings. */
 		const zh = {
 			triggerFallback: "Orbit",
 			tooltip: "Orbit 模型配置",
-			title: "Orbit",
-			orbit: "Orbit",
+			title: "Orbit 让AI自我审核连续执行",
+			enableLongRun: "启用一键长执行",
 			orbitOff: "Orbit Off",
 			orbitSwitchLabel: "本会话 Orbit 开关",
 			commander: "指挥官",
 			executor: "执行员",
 			watchdog: "监控模型",
+			commanderModel: "指挥官模型",
+			executorModel: "执行员模型",
+			watchdogModel: "监控模型",
 			followsSession: "跟随当前会话模型",
 			models: "模型",
 			effort: "推理等级",
@@ -614,7 +617,7 @@ window.__ModuleLoader__.load({
 			loadFailed: "模型列表加载失败",
 			settingsFailed: "Orbit 设置加载失败",
 			saveFailed: "Orbit 设置保存失败",
-			nextRunOnly: "更改应用于下一个新的 Orbit 运行"
+			applyOnNextSend: "更改将会在下一次发送时生效"
 		};
 		//#endregion
 		//#region client/index.ts

package/lib/index.js

@@ -1,10 +1,18 @@
 import z from '@deepseek-ai/schemastery';
 import { installOrbitGestureBoundary, registerOrbitCommand, registerOrbitToggleCommand } from "./activation.js";
+import { estimateLoopCount } from "./kernel.js";
 import { createOrbitPreExecuteHandler } from "./pipeline-guard.js";
 import { resolveEffectiveRoutes, sessionSelectionOf } from "./routes.js";
 import { installOrbitSessionProjection, orbitEnabledOf } from "./session-state.js";
 import { OrbitService } from "./service.js";
 import { createOrbitTool } from "./tool.js";
+/**
+ * Minimum loop budget for a hard-activated run. The Commander is asked for a
+ * 2-5 step plan and every executed step consumes one loop slot, so the host
+ * must grant a budget that can finish a full plan; the goal complexity
+ * estimate raises it further when the goal asks for more.
+ */
+const HARD_ACTIVATION_MIN_LOOPS = 5;
 export const name = 'dsh-orbit';
 export const inject = ['tools', 'agents', 'subagents'];
 const Route = z.object({
@@ -117,6 +125,21 @@ export function apply(ctx, config) {
         });
         installOrbitGestureBoundary(ctx, {
             sessionEnabled: (session) => orbitEnabledOf(ctx, session),
+            activate: async (agent, goal, signal) => {
+                const cwd = agent.session.header.cwd ?? process.cwd();
+                try {
+                    // The initiator scope makes the run's children belong to this Agent;
+                    // the parent model is never asked to decide or to run the task.
+                    await ctx.agents.withInitiator(agent, () => service.run({
+                        goal,
+                        approved_loop_count: Math.max(estimateLoopCount(goal), HARD_ACTIVATION_MIN_LOOPS),
+                    }, cwd, signal));
+                }
+                catch {
+                    // Durable run state owns failure reporting; a takeover failure must
+                    // not fail the consumed parent turn.
+                }
+            },
         });
     }
     // Per-Session Orbit enable state: natively durable through the Session log

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kasenri/dsh-orbit",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "type": "module",
   "description": "Deterministic engineering orchestration for DeepSeek Harness with Commander, Executor, Smart Watchdog, bounded recovery and durable execution state.",
   "license": "MIT",