@nexus-aethra/dshell-conversation 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nexus Aethra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/client/index.js

@@ -0,0 +1,83 @@
+/**
+ * dshell-conversation browser face — Phase 4 (activity marker).
+ *
+ * The single registration here is an always-active ConversationView
+ * Definition on the `terminal` target with no renderer. Its only job is
+ * to count the Session as active conversation activity so the framework
+ * skips the centered hero layout and engages the docked composer (the
+ * terminal-style dock lives in `dshell-mode` and shadows
+ * `conversation.composer.bar`). The dock itself is the visible content
+ * surface — no separate view tab — keeping PTY output and the input
+ * line fused in one column.
+ *
+ * The plugin also auto-activates `terminal` whenever a new Session
+ * becomes current. The stock view-restore path falls back to `chat` when
+ * no preference exists, which would put the conversation back in `hero`
+ * phase; activating `terminal` first forces `active` phase immediately.
+ * A subsequent `selectView('chat')` from the user (the header still
+ * shows the chat tab in the view ledger for advanced use) takes
+ * precedence via the stock selectView path — we only steer the default.
+ */
+export const name = '@nexus-aethra/dshell-conversation/client';
+export const inject = ['uiConversation', 'sessions', 'slots'];
+class TerminalViewBuilder {
+    empty = { rows: [] };
+    replace() {
+        return this.empty;
+    }
+    apply() {
+        return this.empty;
+    }
+}
+const viewDefinition = {
+    target: 'terminal',
+    create: () => new TerminalViewBuilder(),
+    // The terminal surface IS dshell's content (design 4.1): it counts as
+    // visible activity even in a blank session, so the conversation renders
+    // its docked composer instead of the centered hero.
+    isActive: () => true,
+};
+/** Register the always-active `terminal` target and auto-activate it per current session. */
+export function apply(ctx) {
+    // Cast through unknown: the 'sessions' key collides across faces in one
+    // tsc program (host SessionStore vs client ISessions); see terminal-bridge.
+    const sessions = ctx.get('sessions');
+    ctx.effect(() => ctx.uiConversation.views.register(viewDefinition));
+    // The terminal target must be the active view or the shell renders the
+    // (empty) chat transcript instead: ui-conversation resolves the shell
+    // phase from active targets, and its own restore path falls back to the
+    // `chat` view whenever the preference is unset. Re-assert on every
+    // session-list and view-slot change — our subscriptions are registered
+    // after ui-conversation's, so our activation runs last and wins the
+    // tick. `activate` is idempotent (the assembler ignores a target already
+    // active).
+    //
+    // This asserts the terminal *target* (which snapshots the conversation
+    // assembles), not the user's tab choice — the strip's selection is a
+    // separate per-session preference the store owns, and `activate` never
+    // touches it. So the strip can offer `会话` / `轨迹` and a click on
+    // `轨迹` stays put: it writes the preference through the stock
+    // selectView path, and the reconcile that follows a session switch only
+    // re-adds `terminal` to a monotonic active set.
+    ctx.effect(() => {
+        const reconcile = () => {
+            const current = sessions.list.getSnapshot().current;
+            if (current === undefined)
+                return;
+            try {
+                ctx.uiConversation.binding(current).activate('terminal');
+            }
+            catch {
+                // Session scope not materialized yet; retry on the next change.
+            }
+        };
+        const disposeList = sessions.list.subscribe(reconcile);
+        const disposeViews = ctx.slots.subscribe('conversation.view', reconcile);
+        reconcile();
+        return () => {
+            disposeList();
+            disposeViews();
+        };
+    }, 'dshell-conversation: open into terminal view');
+}
+//# sourceMappingURL=index.js.map

package/lib/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAaH,MAAM,CAAC,MAAM,IAAI,GAAG,0CAA0C,CAAA;AAE9D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,gBAAgB,EAAE,UAAU,EAAE,OAAO,CAAU,CAAA;AAMtE,MAAM,mBAAmB;IACd,KAAK,GAAqB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;IAE/C,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;CACF;AAED,MAAM,cAAc,GAAwD;IAC1E,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,mBAAmB,EAAE;IACvC,sEAAsE;IACtE,wEAAwE;IACxE,oDAAoD;IACpD,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;CACrB,CAAA;AAED,6FAA6F;AAC7F,MAAM,UAAU,KAAK,CAAC,GAAY;IAChC,wEAAwE;IACxE,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAyB,CAAA;IAE5D,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAA;IAEnE,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,mEAAmE;IACnE,uEAAuE;IACvE,oEAAoE;IACpE,yEAAyE;IACzE,WAAW;IACX,EAAE;IACF,uEAAuE;IACvE,qEAAqE;IACrE,uEAAuE;IACvE,gEAAgE;IAChE,6DAA6D;IAC7D,wEAAwE;IACxE,gDAAgD;IAChD,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;QACd,MAAM,SAAS,GAAG,GAAS,EAAE;YAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAA;YACnD,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAM;YACjC,IAAI,CAAC;gBACH,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA;YAC1D,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;YAClE,CAAC;QACH,CAAC,CAAA;QACD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;QACtD,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAA;QACxE,SAAS,EAAE,CAAA;QACX,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,CAAA;YACb,YAAY,EAAE,CAAA;QAChB,CAAC,CAAA;IACH,CAAC,EAAE,8CAA8C,CAAC,CAAA;AACpD,CAAC"}

package/lib/client.js

@@ -0,0 +1,77 @@
+window.__ModuleLoader__.load({
+	id: "@nexus-aethra/dshell-conversation",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region lib/client/index.js
+		/**
+		* dshell-conversation browser face — Phase 4 (activity marker).
+		*
+		* The single registration here is an always-active ConversationView
+		* Definition on the `terminal` target with no renderer. Its only job is
+		* to count the Session as active conversation activity so the framework
+		* skips the centered hero layout and engages the docked composer (the
+		* terminal-style dock lives in `dshell-mode` and shadows
+		* `conversation.composer.bar`). The dock itself is the visible content
+		* surface — no separate view tab — keeping PTY output and the input
+		* line fused in one column.
+		*
+		* The plugin also auto-activates `terminal` whenever a new Session
+		* becomes current. The stock view-restore path falls back to `chat` when
+		* no preference exists, which would put the conversation back in `hero`
+		* phase; activating `terminal` first forces `active` phase immediately.
+		* A subsequent `selectView('chat')` from the user (the header still
+		* shows the chat tab in the view ledger for advanced use) takes
+		* precedence via the stock selectView path — we only steer the default.
+		*/
+		const name = "@nexus-aethra/dshell-conversation/client";
+		const inject = [
+			"uiConversation",
+			"sessions",
+			"slots"
+		];
+		var TerminalViewBuilder = class {
+			empty = { rows: [] };
+			replace() {
+				return this.empty;
+			}
+			apply() {
+				return this.empty;
+			}
+		};
+		const viewDefinition = {
+			target: "terminal",
+			create: () => new TerminalViewBuilder(),
+			isActive: () => true
+		};
+		/** Register the always-active `terminal` target and auto-activate it per current session. */
+		function apply(ctx) {
+			const sessions = ctx.get("sessions");
+			ctx.effect(() => ctx.uiConversation.views.register(viewDefinition));
+			ctx.effect(() => {
+				const reconcile = () => {
+					const current = sessions.list.getSnapshot().current;
+					if (current === void 0) return;
+					try {
+						ctx.uiConversation.binding(current).activate("terminal");
+					} catch {}
+				};
+				const disposeList = sessions.list.subscribe(reconcile);
+				const disposeViews = ctx.slots.subscribe("conversation.view", reconcile);
+				reconcile();
+				return () => {
+					disposeList();
+					disposeViews();
+				};
+			}, "dshell-conversation: open into terminal view");
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		exports.name = name;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["client/index.js"],"sourcesContent":["/**\n * dshell-conversation browser face — Phase 4 (activity marker).\n *\n * The single registration here is an always-active ConversationView\n * Definition on the `terminal` target with no renderer. Its only job is\n * to count the Session as active conversation activity so the framework\n * skips the centered hero layout and engages the docked composer (the\n * terminal-style dock lives in `dshell-mode` and shadows\n * `conversation.composer.bar`). The dock itself is the visible content\n * surface — no separate view tab — keeping PTY output and the input\n * line fused in one column.\n *\n * The plugin also auto-activates `terminal` whenever a new Session\n * becomes current. The stock view-restore path falls back to `chat` when\n * no preference exists, which would put the conversation back in `hero`\n * phase; activating `terminal` first forces `active` phase immediately.\n * A subsequent `selectView('chat')` from the user (the header still\n * shows the chat tab in the view ledger for advanced use) takes\n * precedence via the stock selectView path — we only steer the default.\n */\nexport const name = '@nexus-aethra/dshell-conversation/client';\nexport const inject = ['uiConversation', 'sessions', 'slots'];\nclass TerminalViewBuilder {\n    empty = { rows: [] };\n    replace() {\n        return this.empty;\n    }\n    apply() {\n        return this.empty;\n    }\n}\nconst viewDefinition = {\n    target: 'terminal',\n    create: () => new TerminalViewBuilder(),\n    // The terminal surface IS dshell's content (design 4.1): it counts as\n    // visible activity even in a blank session, so the conversation renders\n    // its docked composer instead of the centered hero.\n    isActive: () => true,\n};\n/** Register the always-active `terminal` target and auto-activate it per current session. */\nexport function apply(ctx) {\n    // Cast through unknown: the 'sessions' key collides across faces in one\n    // tsc program (host SessionStore vs client ISessions); see terminal-bridge.\n    const sessions = ctx.get('sessions');\n    ctx.effect(() => ctx.uiConversation.views.register(viewDefinition));\n    // The terminal target must be the active view or the shell renders the\n    // (empty) chat transcript instead: ui-conversation resolves the shell\n    // phase from active targets, and its own restore path falls back to the\n    // `chat` view whenever the preference is unset. Re-assert on every\n    // session-list and view-slot change — our subscriptions are registered\n    // after ui-conversation's, so our activation runs last and wins the\n    // tick. `activate` is idempotent (the assembler ignores a target already\n    // active).\n    //\n    // This asserts the terminal *target* (which snapshots the conversation\n    // assembles), not the user's tab choice — the strip's selection is a\n    // separate per-session preference the store owns, and `activate` never\n    // touches it. So the strip can offer `会话` / `轨迹` and a click on\n    // `轨迹` stays put: it writes the preference through the stock\n    // selectView path, and the reconcile that follows a session switch only\n    // re-adds `terminal` to a monotonic active set.\n    ctx.effect(() => {\n        const reconcile = () => {\n            const current = sessions.list.getSnapshot().current;\n            if (current === undefined)\n                return;\n            try {\n                ctx.uiConversation.binding(current).activate('terminal');\n            }\n            catch {\n                // Session scope not materialized yet; retry on the next change.\n            }\n        };\n        const disposeList = sessions.list.subscribe(reconcile);\n        const disposeViews = ctx.slots.subscribe('conversation.view', reconcile);\n        reconcile();\n        return () => {\n            disposeList();\n            disposeViews();\n        };\n    }, 'dshell-conversation: open into terminal view');\n}\n//# sourceMappingURL=index.js.map"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBA,MAAa,OAAO;EACpB,MAAa,SAAS;GAAC;GAAkB;GAAY;EAAO;EAC5D,IAAM,sBAAN,MAA0B;GACtB,QAAQ,EAAE,MAAM,CAAC,EAAE;GACnB,UAAU;IACN,OAAO,KAAK;GAChB;GACA,QAAQ;IACJ,OAAO,KAAK;GAChB;EACJ;EACA,MAAM,iBAAiB;GACnB,QAAQ;GACR,cAAc,IAAI,oBAAoB;GAItC,gBAAgB;EACpB;;EAEA,SAAgB,MAAM,KAAK;GAGvB,MAAM,WAAW,IAAI,IAAI,UAAU;GACnC,IAAI,aAAa,IAAI,eAAe,MAAM,SAAS,cAAc,CAAC;GAiBlE,IAAI,aAAa;IACb,MAAM,kBAAkB;KACpB,MAAM,UAAU,SAAS,KAAK,YAAY,CAAC,CAAC;KAC5C,IAAI,YAAY,KAAA,GACZ;KACJ,IAAI;MACA,IAAI,eAAe,QAAQ,OAAO,CAAC,CAAC,SAAS,UAAU;KAC3D,QACM,CAEN;IACJ;IACA,MAAM,cAAc,SAAS,KAAK,UAAU,SAAS;IACrD,MAAM,eAAe,IAAI,MAAM,UAAU,qBAAqB,SAAS;IACvE,UAAU;IACV,aAAa;KACT,YAAY;KACZ,aAAa;IACjB;GACJ,GAAG,8CAA8C;EACrD"}

package/lib/index.js

@@ -0,0 +1,16 @@
+/**
+ * dshell-conversation host face — Phase 1 stub.
+ *
+ * The `terminal` target registration lives in src/client/index.ts (the
+ * browser face) because `ctx.uiConversation` is a browser-only service.
+ * This host-side entry exists only to satisfy the bundle's module-table
+ * row so dsh loads the package's host face alongside the four other
+ * dshell-* packages in the active profile.
+ */
+export const name = '@nexus-aethra/dshell-conversation/host';
+export function apply(_ctx) {
+    // Reserved for future host-side concerns; target registration is in
+    // src/client/index.ts where `ctx.uiConversation` is available.
+}
+export default { name, apply };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAG,wCAAwC,CAAA;AAE5D,MAAM,UAAU,KAAK,CAAC,IAAa;IACjC,oEAAoE;IACpE,+DAA+D;AACjE,CAAC;AAED,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA"}

package/lib/types/client/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * dshell-conversation browser face — Phase 4 (activity marker).
+ *
+ * The single registration here is an always-active ConversationView
+ * Definition on the `terminal` target with no renderer. Its only job is
+ * to count the Session as active conversation activity so the framework
+ * skips the centered hero layout and engages the docked composer (the
+ * terminal-style dock lives in `dshell-mode` and shadows
+ * `conversation.composer.bar`). The dock itself is the visible content
+ * surface — no separate view tab — keeping PTY output and the input
+ * line fused in one column.
+ *
+ * The plugin also auto-activates `terminal` whenever a new Session
+ * becomes current. The stock view-restore path falls back to `chat` when
+ * no preference exists, which would put the conversation back in `hero`
+ * phase; activating `terminal` first forces `active` phase immediately.
+ * A subsequent `selectView('chat')` from the user (the header still
+ * shows the chat tab in the view ledger for advanced use) takes
+ * precedence via the stock selectView path — we only steer the default.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "@nexus-aethra/dshell-conversation/client";
+export declare const inject: readonly ["uiConversation", "sessions", "slots"];
+/** Register the always-active `terminal` target and auto-activate it per current session. */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAWlD,eAAO,MAAM,IAAI,6CAA6C,CAAA;AAE9D,eAAO,MAAM,MAAM,kDAAmD,CAAA;AA2BtE,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAyCxC"}

package/lib/types/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * dshell-conversation host face — Phase 1 stub.
+ *
+ * The `terminal` target registration lives in src/client/index.ts (the
+ * browser face) because `ctx.uiConversation` is a browser-only service.
+ * This host-side entry exists only to satisfy the bundle's module-table
+ * row so dsh loads the package's host face alongside the four other
+ * dshell-* packages in the active profile.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "@nexus-aethra/dshell-conversation/host";
+export declare function apply(_ctx: Context): void;
+declare const _default: {
+    name: string;
+    apply: typeof apply;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,eAAO,MAAM,IAAI,2CAA2C,CAAA;AAE5D,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAGzC;;;;;AAED,wBAA8B"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@nexus-aethra/dshell-conversation",
+  "version": "0.1.0",
+  "description": "dshell Conversation activity marker: registers an always-active `terminal` view target so the conversation stays in active phase and the docked terminal surface renders instead of the centered hero.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Nexus-Aethra/Nexus-Terminal.git",
+    "directory": "packages/dshell/conversation"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    }
+  },
+  "dsh": {
+    "client": {
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.2",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.14",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json --emitDeclarationOnly false && tsdown --config-loader tsx",
+    "build:host": "tsc -p tsconfig.json --emitDeclarationOnly false",
+    "build:client": "tsdown --config-loader tsx"
+  }
+}