@kasenri/dsh-orbit 0.5.2 → 0.5.3

package/lib/activation.js

@@ -12,6 +12,7 @@
  * tool + `OrbitService` + Supervisor remain the sole Orbit runtime.
  */
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { ORBIT_TOGGLE_COMMAND, parseOrbitToggle } from "./session-state.js";
 export const AGENT_ORBIT_COMMAND = 'agent-orbit';
 /** Strict gesture: the command must begin a genuine user message line. */
 const GESTURE = /^\/agent-orbit(?=$|[\t\n\r ])/u;
@@ -38,6 +39,22 @@ export function invokedOrbitActivation(messages) {
     }
     return undefined;
 }
+/** The newest genuine user message text, as the implicit activation's goal. */
+export function invokedOrbitMessage(messages) {
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message === undefined || message.source.kind !== 'user')
+            continue;
+        const text = message.content
+            .filter((block) => block.type === 'text')
+            .map((block) => block.text)
+            .join('\n')
+            .trim();
+        if (text !== '')
+            return { goal: text };
+    }
+    return undefined;
+}
 /**
  * The one deterministic directive injected for an explicit activation. It only
  * states the activation and carries the goal verbatim; every Orbit rule still
@@ -53,6 +70,17 @@ 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.
  *
@@ -79,29 +107,68 @@ export function registerOrbitCommand(ctx) {
         },
     }), 'dsh-orbit: /agent-orbit host command');
 }
+/**
+ * Register the `/orbit-toggle on|off` host command.
+ *
+ * The command writes nothing itself: the commands runtime logs its own
+ * `command/run` record, and the `orbitSession` projection folds that record
+ * into the per-Session state the toggle UI reads. Registering it also gives
+ * CLI surfaces the same switch.
+ */
+export function registerOrbitToggleCommand(ctx) {
+    ctx.effect(() => ctx.commands.register({
+        name: ORBIT_TOGGLE_COMMAND,
+        description: 'Turn the per-chat Orbit default on or off without starting a run',
+        input: { hint: 'on or off' },
+        handler(invocation) {
+            const enabled = parseOrbitToggle(invocation.rawInput);
+            if (enabled === undefined) {
+                return { kind: 'error', text: `Usage: /${ORBIT_TOGGLE_COMMAND} on|off — 请输入 on 或 off。` };
+            }
+            return {
+                kind: 'success',
+                text: enabled
+                    ? 'Orbit is on for this chat — ordinary messages will enter Orbit.'
+                    : 'Orbit is off for this chat — ordinary messages stay native.',
+            };
+        },
+    }), '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.
+ *
+ * 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.
  */
-export function installOrbitGestureBoundary(ctx) {
-    ctx.on('agent/pre-step', async ({ messages, signal }, next) => {
+export function installOrbitGestureBoundary(ctx, options = {}) {
+    ctx.on('agent/pre-step', async ({ agent, messages, signal }, next) => {
         const decision = await next();
         if (decision.kind === 'reject')
             return decision;
         if (decision.messages.some((message) => message.source.kind === 'orbit-command'))
             return decision;
-        const activation = invokedOrbitActivation(messages);
-        if (activation === undefined)
+        const explicit = invokedOrbitActivation(messages);
+        const implicit = explicit === undefined && options.sessionEnabled?.(agent.session) === true
+            ? invokedOrbitMessage(messages)
+            : undefined;
+        if (explicit === undefined && implicit === 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: buildOrbitActivationDirective(activation.goal) }],
+                    content: [{ type: 'text', text: directive }],
                     source: { kind: 'orbit-command', ...(activation.goal === '' ? {} : { goal: activation.goal }) },
                 }),
             ],

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_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);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 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,20 +132,22 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var OrbitModelSelect_module_css_default = {
-			"hint": "f77nca_hint",
+			"error": "f77nca_error",
+			"chevron": "f77nca_chevron",
 			"back": "f77nca_back",
-			"rowValue": "f77nca_rowValue",
 			"rowValueActive": "f77nca_rowValueActive",
-			"title": "f77nca_title",
+			"hint": "f77nca_hint",
+			"switchControl": "f77nca_switchControl",
+			"group": "f77nca_group",
 			"panel": "f77nca_panel",
-			"row": "f77nca_row",
-			"rowDetail": "f77nca_rowDetail",
 			"separator": "f77nca_separator",
-			"error": "f77nca_error",
-			"group": "f77nca_group",
-			"rowLabel": "f77nca_rowLabel",
+			"title": "f77nca_title",
+			"switchRow": "f77nca_switchRow",
+			"rowValue": "f77nca_rowValue",
+			"rowDetail": "f77nca_rowDetail",
 			"check": "f77nca_check",
-			"chevron": "f77nca_chevron"
+			"row": "f77nca_row",
+			"rowLabel": "f77nca_rowLabel"
 		};
 		//#endregion
 		//#region client/OrbitModelSelect.tsx
@@ -178,9 +180,23 @@ window.__ModuleLoader__.load({
 		* @param props - injected directory/settings faces plus the locale seat.
 		* @returns the trigger and, while open, the panel.
 		*/
-		function OrbitModelSelect({ t, available, directory, settings, loadModels, selectModel, writeRole, reloadSettings }) {
+		function OrbitModelSelect({ t, available, directory, settings, loadModels, selectModel, writeRole, setOrbitEnabled, reloadSettings, useProjection }) {
 			const dir = (0, react.useSyncExternalStore)((listener) => directory.subscribe(listener), () => directory.getSnapshot());
 			const config = (0, react.useSyncExternalStore)((listener) => settings.subscribe(listener), () => settings.getSnapshot());
+			const orbitSession = useProjection("orbitSession");
+			const [orbitOverride, setOrbitOverride] = (0, react.useState)(null);
+			const [orbitPending, setOrbitPending] = (0, react.useState)(false);
+			const orbitEnabled = orbitOverride ?? orbitSession?.enabled === true;
+			(0, react.useEffect)(() => {
+				if (orbitOverride !== null && orbitSession?.enabled === orbitOverride) setOrbitOverride(null);
+			}, [orbitOverride, orbitSession?.enabled]);
+			const toggleOrbit = async (next) => {
+				setOrbitOverride(next);
+				setOrbitPending(true);
+				const ok = await setOrbitEnabled(next);
+				setOrbitPending(false);
+				if (!ok) setOrbitOverride(null);
+			};
 			const [open, setOpen] = (0, react.useState)(false);
 			const [pane, setPane] = (0, react.useState)({ kind: "root" });
 			const [busy, setBusy] = (0, react.useState)(false);
@@ -294,11 +310,11 @@ window.__ModuleLoader__.load({
 						setOpen((value) => !value);
 					},
 					children: [
-						commanderLabel,
-						commanderEffort === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						orbitEnabled ? commanderLabel : t("orbitOff"),
+						orbitEnabled && commanderEffort !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							style: { color: "var(--dsw-alias-label-tertiary)" },
 							children: ` ${commanderEffort}`
-						}),
+						}) : null,
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 							className: OrbitModelSelect_module_css_default.chevron,
 							children: CARET
@@ -351,6 +367,22 @@ window.__ModuleLoader__.load({
 						})]
 					}),
 					pane.kind === "root" ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: OrbitModelSelect_module_css_default.switchRow,
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								className: OrbitModelSelect_module_css_default.rowLabel,
+								children: t("orbit")
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+								className: OrbitModelSelect_module_css_default.switchControl,
+								checked: orbitEnabled,
+								disabled: orbitPending,
+								label: t("orbitSwitchLabel"),
+								onChange: (next) => {
+									toggleOrbit(next);
+								}
+							})]
+						}),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", { className: OrbitModelSelect_module_css_default.separator }),
 						/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
 							type: "button",
 							role: "menuitem",
@@ -545,6 +577,9 @@ window.__ModuleLoader__.load({
 			triggerFallback: "Orbit",
 			tooltip: "Orbit model configuration",
 			title: "Orbit",
+			orbit: "Orbit",
+			orbitOff: "Orbit Off",
+			orbitSwitchLabel: "Orbit for this chat",
 			commander: "Commander",
 			executor: "Executor",
 			watchdog: "Watchdog",
@@ -564,6 +599,9 @@ window.__ModuleLoader__.load({
 			triggerFallback: "Orbit",
 			tooltip: "Orbit 模型配置",
 			title: "Orbit",
+			orbit: "Orbit",
+			orbitOff: "Orbit Off",
+			orbitSwitchLabel: "本会话 Orbit 开关",
 			commander: "指挥官",
 			executor: "执行员",
 			watchdog: "监控模型",
@@ -691,6 +729,16 @@ window.__ModuleLoader__.load({
 						},
 						selectModel: (selection) => available ? directory.select(selection).then(() => true, () => false) : Promise.resolve(false),
 						writeRole,
+						setOrbitEnabled: async (enabled) => {
+							const session = sessions.binding(sessionId)?.session;
+							if (session === void 0) return false;
+							try {
+								const result = await session.command(`/orbit-toggle ${enabled ? "on" : "off"}`);
+								return result.ok && result.value.matched;
+							} catch {
+								return false;
+							}
+						},
 						reloadSettings
 					};
 				};

package/lib/index.js

@@ -1,7 +1,8 @@
 import z from '@deepseek-ai/schemastery';
-import { installOrbitGestureBoundary, registerOrbitCommand } from "./activation.js";
+import { installOrbitGestureBoundary, registerOrbitCommand, registerOrbitToggleCommand } from "./activation.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";
 export const name = 'dsh-orbit';
@@ -112,9 +113,18 @@ export function apply(ctx, config) {
     if (config.slashCommand) {
         ctx.inject(['commands'], (commandCtx) => {
             registerOrbitCommand(commandCtx);
+            registerOrbitToggleCommand(commandCtx);
+        });
+        installOrbitGestureBoundary(ctx, {
+            sessionEnabled: (session) => orbitEnabledOf(ctx, session),
         });
-        installOrbitGestureBoundary(ctx);
     }
+    // Per-Session Orbit enable state: natively durable through the Session log
+    // and the projection registry. Minimal compositions without the registry
+    // keep the feature inert (OFF) while `/agent-orbit` keeps working.
+    ctx.inject(['sessionProjections'], (projectionCtx) => {
+        installOrbitSessionProjection(projectionCtx);
+    });
     if (config.registerGuards) {
         const handler = createOrbitPreExecuteHandler(service, {
             competingDriver: (agent) => {

package/lib/session-state.js

@@ -0,0 +1,80 @@
+/**
+ * Per-Session Orbit enable state, native to DeepSeek Harness.
+ *
+ * The write is the ordinary `/orbit-toggle on|off` command: the commands
+ * runtime appends its own `command/run` record to the Session log (a known
+ * event type, durable with the Session). The state is a session projection
+ * unit folding those records, so it is per-Session by construction, survives
+ * reloads with the log, and reaches the browser through the normal projection
+ * wire — no separate store, no Orbit settings entry, no `.cx/state.json`.
+ *
+ * This is UI/runtime preference state for one chat, never the durable
+ * execution state of an Orbit run.
+ */
+/** The command whose `command/run` records carry the toggle. */
+export const ORBIT_TOGGLE_COMMAND = 'orbit-toggle';
+/** The projection key carrying the per-Session enable state. */
+export const ORBIT_SESSION_KEY = 'orbitSession';
+/**
+ * Parse one `/orbit-toggle` argument; `undefined` when it names neither state,
+ * so a malformed toggle never flips the switch as a side effect.
+ */
+export function parseOrbitToggle(rawInput) {
+    const argument = rawInput.trim().toLowerCase();
+    if (argument === 'on')
+        return true;
+    if (argument === 'off')
+        return false;
+    return undefined;
+}
+/**
+ * Fold one Session event into the enable state. A new Session starts OFF;
+ * every unrelated event keeps the same state reference so the projection
+ * drive does no downstream work.
+ */
+export function foldOrbitSession(state, event) {
+    if (event.type !== 'command/run')
+        return state;
+    const data = event.data;
+    if (data?.name !== ORBIT_TOGGLE_COMMAND)
+        return state;
+    const enabled = parseOrbitToggle(typeof data.args === 'string' ? data.args : '');
+    if (enabled === undefined || enabled === state.enabled)
+        return state;
+    return { enabled };
+}
+/**
+ * Minimal `ZodType`-shaped validator for the projection schemas. The registry
+ * only ever calls `parse`, and Orbit must not add a `zod` runtime dependency
+ * that a strict package manager would not hoist for the plugin.
+ */
+function orbitSessionSchema() {
+    return {
+        parse(value) {
+            const enabled = value?.enabled;
+            if (typeof enabled !== 'boolean')
+                throw new Error('orbitSession projection value must be { enabled: boolean }');
+            return { enabled };
+        },
+    };
+}
+/** Register the per-Session enable projection on the session projection registry. */
+export function installOrbitSessionProjection(ctx) {
+    ctx.sessionProjections.register({
+        key: ORBIT_SESSION_KEY,
+        stateSchema: orbitSessionSchema(),
+        init: () => ({ enabled: false }),
+        apply: (state, event) => foldOrbitSession(state, event),
+        wire: {
+            viewSchema: orbitSessionSchema(),
+            view: (state) => ({ enabled: state.enabled }),
+        },
+        stateVersion: 1,
+    });
+}
+/** Whether the Session currently defaults ordinary messages into Orbit. */
+export function orbitEnabledOf(ctx, session) {
+    const reflect = ctx.reflect;
+    const registry = reflect?.get('sessionProjections');
+    return registry?.stateOf(session, ORBIT_SESSION_KEY)?.enabled === true;
+}

package/package.json

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