@roarpeng/graphflow 1.9.15 → 1.9.16

package/dist/surfaces/cli/runtime.d.ts

@@ -9,6 +9,6 @@ export { getSettingsPanelStatus, indexGraphFromSettings, testRoutingAndIndexGrap
 export { assertGraphFlowRuntime, type GraphFlowRuntime, type GraphFlowRuntimeModule } from "./runtime/facade.js";
 export { runLearningNightly, runLearningNightlyResult, runSkillDecay, runSkillReset, runSkillPrune, runSkillConsolidatePlan, runSkillConsolidate, runLearnForget, } from "./runtime/learning.js";
 export { listEpisodes, searchEpisodes, forgetEpisode, type MemoryOutcome, type MemoryEpisodeItem, type MemorySearchHit, type MemoryForgetResult, } from "./runtime/memory.js";
-export { listDialogueTurnsRuntime, recordDialogueTurnRuntime, type DialogueListItem, } from "./runtime/dialogue.js";
+export { listDialogueTurnsRuntime, recordDialogueTurnRuntime, resolveDialogueRecordInput, distillDialogueTurnsRuntime, type DialogueListItem, type DistillDialogueResult, } from "./runtime/dialogue.js";
 export { detectInstalledAgents, formatModelConfigGuide, installMcpToDetectedAgents, repairUnsafeWindowsMcpCommands, repairStaleGraphFlowMcpLaunchers, } from "../../integrations/agent-mcp-installer";
 //# sourceMappingURL=runtime.d.ts.map

package/dist/surfaces/cli/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/surfaces/cli/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACnG,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACjH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/surfaces/cli/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,2BAA2B,EAC3B,8BAA8B,EAC9B,uBAAuB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACnG,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,OAAO,EACP,aAAa,EACb,aAAa,EACb,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACjH,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,wCAAwC,CAAC"}

package/dist/surfaces/cli/runtime.js

@@ -15,7 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runSkillPrune = exports.runSkillReset = exports.runSkillDecay = exports.runLearningNightlyResult = exports.runLearningNightly = exports.assertGraphFlowRuntime = exports.testRoutingAndIndexGraph = exports.indexGraphFromSettings = exports.getSettingsPanelStatus = exports.mergeAgentInsightResult = exports.submitAgentInsightResult = exports.planInsight = exports.planInsightResult = exports.planAndBrainstormResult = exports.planAndBrainstorm = exports.diagnoseRoutingResult = exports.diagnoseRouting = exports.reportOutcome = exports.runTaskResult = exports.runTask = exports.startFileWatcherIfEnabled = exports.resetTokenSavingsStats = exports.getTokenSavingsStats = exports.getFlywheelReport = exports.syncSkillPackageRuntime = exports.importSkillPackageRuntime = exports.exportSkillPackageRuntime = exports.importArtifact = exports.exportExperienceMemory = exports.exportArtifact = exports.getSkillInsights = exports.inspectGraph = exports.rebuildGraph = exports.indexFile = exports.indexGraph = exports.listWorkbenchOutline = exports.captureAssistantReply = exports.expandAnchor = exports.previewContext = exports.validateSettingsForRouting = exports.validateSettingsForGraphIndex = exports.saveGraphFlowSettings = exports.getGraphFlowSettings = exports.resolveWritableConfigPath = exports.resolveConfigPath = exports.resolveConfig = exports.resolveGlobalConfigPath = exports.ensureWorkspaceGraphFlowConfig = exports.ensureGlobalGraphFlowConfig = exports.getDefaultConfig = void 0;
-exports.repairStaleGraphFlowMcpLaunchers = exports.repairUnsafeWindowsMcpCommands = exports.installMcpToDetectedAgents = exports.formatModelConfigGuide = exports.detectInstalledAgents = exports.recordDialogueTurnRuntime = exports.listDialogueTurnsRuntime = exports.forgetEpisode = exports.searchEpisodes = exports.listEpisodes = exports.runLearnForget = exports.runSkillConsolidate = exports.runSkillConsolidatePlan = void 0;
+exports.repairStaleGraphFlowMcpLaunchers = exports.repairUnsafeWindowsMcpCommands = exports.installMcpToDetectedAgents = exports.formatModelConfigGuide = exports.detectInstalledAgents = exports.distillDialogueTurnsRuntime = exports.resolveDialogueRecordInput = exports.recordDialogueTurnRuntime = exports.listDialogueTurnsRuntime = exports.forgetEpisode = exports.searchEpisodes = exports.listEpisodes = exports.runLearnForget = exports.runSkillConsolidate = exports.runSkillConsolidatePlan = void 0;
 var defaults_1 = require("../../config/defaults");
 Object.defineProperty(exports, "getDefaultConfig", { enumerable: true, get: function () { return defaults_1.getDefaultConfig; } });
 var scaffold_1 = require("../../config/scaffold");
@@ -86,6 +86,8 @@ Object.defineProperty(exports, "forgetEpisode", { enumerable: true, get: functio
 var dialogue_js_1 = require("./runtime/dialogue.js");
 Object.defineProperty(exports, "listDialogueTurnsRuntime", { enumerable: true, get: function () { return dialogue_js_1.listDialogueTurnsRuntime; } });
 Object.defineProperty(exports, "recordDialogueTurnRuntime", { enumerable: true, get: function () { return dialogue_js_1.recordDialogueTurnRuntime; } });
+Object.defineProperty(exports, "resolveDialogueRecordInput", { enumerable: true, get: function () { return dialogue_js_1.resolveDialogueRecordInput; } });
+Object.defineProperty(exports, "distillDialogueTurnsRuntime", { enumerable: true, get: function () { return dialogue_js_1.distillDialogueTurnsRuntime; } });
 var agent_mcp_installer_1 = require("../../integrations/agent-mcp-installer");
 Object.defineProperty(exports, "detectInstalledAgents", { enumerable: true, get: function () { return agent_mcp_installer_1.detectInstalledAgents; } });
 Object.defineProperty(exports, "formatModelConfigGuide", { enumerable: true, get: function () { return agent_mcp_installer_1.formatModelConfigGuide; } });

package/dist/surfaces/cli/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/surfaces/cli/runtime.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,kDAAyD;AAAhD,4GAAA,gBAAgB,OAAA;AACzB,kDAK+B;AAJ7B,uHAAA,2BAA2B,OAAA;AAC3B,0HAAA,8BAA8B,OAAA;AAC9B,mHAAA,uBAAuB,OAAA;AAGzB,gDAAmG;AAA1F,wGAAA,aAAa,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,oHAAA,yBAAyB,OAAA;AACpE,qDAAmC;AACnC,qDAK+B;AAJ7B,mHAAA,oBAAoB,OAAA;AACpB,oHAAA,qBAAqB,OAAA;AACrB,4HAAA,6BAA6B,OAAA;AAC7B,yHAAA,0BAA0B,OAAA;AAE5B,+CAoB4B;AAnB1B,0GAAA,cAAc,OAAA;AACd,wGAAA,YAAY,OAAA;AACZ,iHAAA,qBAAqB,OAAA;AACrB,gHAAA,oBAAoB,OAAA;AACpB,sGAAA,UAAU,OAAA;AACV,qGAAA,SAAS,OAAA;AACT,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,kHAAA,sBAAsB,OAAA;AACtB,0GAAA,cAAc,OAAA;AACd,qHAAA,yBAAyB,OAAA;AACzB,qHAAA,yBAAyB,OAAA;AACzB,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AACpB,kHAAA,sBAAsB,OAAA;AACtB,qHAAA,yBAAyB,OAAA;AAE3B,mDAY8B;AAX5B,qGAAA,OAAO,OAAA;AACP,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,mHAAA,qBAAqB,OAAA;AACrB,+GAAA,iBAAiB,OAAA;AACjB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,yGAAA,WAAW,OAAA;AACX,sHAAA,wBAAwB,OAAA;AACxB,qHAAA,uBAAuB,OAAA;AAEzB,+CAI4B;AAH1B,kHAAA,sBAAsB,OAAA;AACtB,kHAAA,sBAAsB,OAAA;AACtB,oHAAA,wBAAwB,OAAA;AAE1B,iDAAiH;AAAxG,mHAAA,sBAAsB,OAAA;AAC/B,qDAS+B;AAR7B,iHAAA,kBAAkB,OAAA;AAClB,uHAAA,wBAAwB,OAAA;AACxB,4GAAA,aAAa,OAAA;AACb,4GAAA,aAAa,OAAA;AACb,4GAAA,aAAa,OAAA;AACb,sHAAA,uBAAuB,OAAA;AACvB,kHAAA,mBAAmB,OAAA;AACnB,6GAAA,cAAc,OAAA;AAEhB,iDAQ6B;AAP3B,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AAMf,qDAI+B;AAH7B,uHAAA,wBAAwB,OAAA;AACxB,wHAAA,yBAAyB,OAAA;AAG3B,8EAMgD;AAL9C,4HAAA,qBAAqB,OAAA;AACrB,6HAAA,sBAAsB,OAAA;AACtB,iIAAA,0BAA0B,OAAA;AAC1B,qIAAA,8BAA8B,OAAA;AAC9B,uIAAA,gCAAgC,OAAA"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/surfaces/cli/runtime.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,kDAAyD;AAAhD,4GAAA,gBAAgB,OAAA;AACzB,kDAK+B;AAJ7B,uHAAA,2BAA2B,OAAA;AAC3B,0HAAA,8BAA8B,OAAA;AAC9B,mHAAA,uBAAuB,OAAA;AAGzB,gDAAmG;AAA1F,wGAAA,aAAa,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,oHAAA,yBAAyB,OAAA;AACpE,qDAAmC;AACnC,qDAK+B;AAJ7B,mHAAA,oBAAoB,OAAA;AACpB,oHAAA,qBAAqB,OAAA;AACrB,4HAAA,6BAA6B,OAAA;AAC7B,yHAAA,0BAA0B,OAAA;AAE5B,+CAoB4B;AAnB1B,0GAAA,cAAc,OAAA;AACd,wGAAA,YAAY,OAAA;AACZ,iHAAA,qBAAqB,OAAA;AACrB,gHAAA,oBAAoB,OAAA;AACpB,sGAAA,UAAU,OAAA;AACV,qGAAA,SAAS,OAAA;AACT,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,4GAAA,gBAAgB,OAAA;AAChB,0GAAA,cAAc,OAAA;AACd,kHAAA,sBAAsB,OAAA;AACtB,0GAAA,cAAc,OAAA;AACd,qHAAA,yBAAyB,OAAA;AACzB,qHAAA,yBAAyB,OAAA;AACzB,mHAAA,uBAAuB,OAAA;AACvB,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AACpB,kHAAA,sBAAsB,OAAA;AACtB,qHAAA,yBAAyB,OAAA;AAE3B,mDAY8B;AAX5B,qGAAA,OAAO,OAAA;AACP,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,6GAAA,eAAe,OAAA;AACf,mHAAA,qBAAqB,OAAA;AACrB,+GAAA,iBAAiB,OAAA;AACjB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,yGAAA,WAAW,OAAA;AACX,sHAAA,wBAAwB,OAAA;AACxB,qHAAA,uBAAuB,OAAA;AAEzB,+CAI4B;AAH1B,kHAAA,sBAAsB,OAAA;AACtB,kHAAA,sBAAsB,OAAA;AACtB,oHAAA,wBAAwB,OAAA;AAE1B,iDAAiH;AAAxG,mHAAA,sBAAsB,OAAA;AAC/B,qDAS+B;AAR7B,iHAAA,kBAAkB,OAAA;AAClB,uHAAA,wBAAwB,OAAA;AACxB,4GAAA,aAAa,OAAA;AACb,4GAAA,aAAa,OAAA;AACb,4GAAA,aAAa,OAAA;AACb,sHAAA,uBAAuB,OAAA;AACvB,kHAAA,mBAAmB,OAAA;AACnB,6GAAA,cAAc,OAAA;AAEhB,iDAQ6B;AAP3B,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AAMf,qDAO+B;AAN7B,uHAAA,wBAAwB,OAAA;AACxB,wHAAA,yBAAyB,OAAA;AACzB,yHAAA,0BAA0B,OAAA;AAC1B,0HAAA,2BAA2B,OAAA;AAI7B,8EAMgD;AAL9C,4HAAA,qBAAqB,OAAA;AACrB,6HAAA,sBAAsB,OAAA;AACtB,iIAAA,0BAA0B,OAAA;AAC1B,qIAAA,8BAA8B,OAAA;AAC9B,uIAAA,gCAAgC,OAAA"}

package/dsh/plugin.mjs

@@ -80,6 +80,152 @@ export function buildContextHint(cwd = process.cwd()) {
   return `GraphFlow: before large code reads, call mcp__graphflow__graphflow_context with rootDir=${cwd}. Do not dump SKILL.md.`;
 }
 
+/**
+ * Extract the plain text of a user message (its text ContentBlocks joined).
+ * Returns "" when the message carries no text. Never throws.
+ * @param {object|undefined} message - a UserMessage (agent/inbox/inserted payload).
+ * @returns {string}
+ */
+export function extractMessageText(message) {
+  if (!message || typeof message !== "object") return "";
+  const content = message.content;
+  if (!Array.isArray(content)) return "";
+  const parts = [];
+  for (const block of content) {
+    if (block && typeof block === "object" && block.type === "text" && typeof block.text === "string") {
+      parts.push(block.text);
+    }
+  }
+  return parts.join("\n").trim();
+}
+
+/**
+ * The local GraphFlow CLI entry (this package's own dist build). Falls back to
+ * `graphflow` from PATH when dist is absent (source checkout without build).
+ * @returns {string}
+ */
+export function resolveCliCommand(packageRoot = PACKAGE_ROOT) {
+  const distCli = join(packageRoot, "dist", "surfaces", "cli", "index.js");
+  return existsSync(distCli) ? distCli : "graphflow";
+}
+
+/**
+ * Whether a message originates from the human user rather than the harness.
+ * Only `source.kind === "user"` qualifies; harness/system injections
+ * (`plugin`/`tool`/`model`) must not become dialogue turns (job finished
+ * notices, subagent reports, tool results, …). Unknown/missing source falls
+ * back to the role check so nothing legitimate is dropped.
+ * @param {object|undefined} message
+ * @returns {boolean}
+ */
+export function isUserOriginatedMessage(message) {
+  if (!message || typeof message !== "object") return false;
+  const kind =
+    message.source && typeof message.source === "object" ? message.source.kind : undefined;
+  if (kind === "user") return true;
+  if (kind === "plugin" || kind === "tool" || kind === "model") return false;
+  return message.role !== "system";
+}
+
+/**
+ * Best-effort auto-record of one user turn as a dialogue node.
+ * Spawns `graphflow dialogue record --query "<text>" [--session <sessionId>]`
+ * in the agent's workspace (cwd = session header cwd) so every web/agent
+ * question becomes a dialogue-turn graph node without relying on the agent
+ * calling graphflow_context itself. Only human-originated messages are
+ * recorded (see isUserOriginatedMessage) — harness/system injections must not
+ * pollute the dialogue graph. `sessionId` scopes the turn to one dsh session
+ * (omitted → default "main" dialogue session) so question recording and reply
+ * filling land in the same dialogue session. Never throws; the spawned child
+ * is detached.
+ * @param {object|undefined} message - a UserMessage (agent/inbox/inserted payload).
+ * @param {string} [cwd]
+ * @param {GraphFlowDshPluginConfig} [config]
+ * @param {string} [sessionId] - dialogue session name/id; omitted → "main".
+ * @returns {{attempted: boolean, reason?: string, workspace?: string}}
+ */
+export function recordDialogueFromInbox(message, cwd, config = {}, sessionId) {
+  try {
+    if (!isUserOriginatedMessage(message)) {
+      return { attempted: false, reason: "not-user-message" };
+    }
+    const env = envOf(config);
+    if (!isAutoCaptureEnabled(env)) {
+      return { attempted: false, reason: "auto-capture-off" };
+    }
+    const text = extractMessageText(message);
+    if (text.length < 4) {
+      return { attempted: false, reason: "query-too-short" };
+    }
+    const workspace = typeof cwd === "string" && cwd.trim() ? cwd : process.cwd();
+    const spawnFn = typeof config.spawn === "function" ? config.spawn : spawn;
+    const cli = resolveCliCommand(config.packageRoot);
+    const args = [cli, "dialogue", "record", "--query", text];
+    if (typeof sessionId === "string" && sessionId.trim()) {
+      args.push("--session", sessionId);
+    }
+    const bin = cli === "graphflow" ? (env.GRAPHFLOW_HOOK_BIN?.trim() || "npx") : process.execPath;
+    const fullArgs = cli === "graphflow" ? ["-y", "--package=@roarpeng/graphflow", ...args] : args;
+    spawnFn(bin, fullArgs, {
+      cwd: workspace,
+      env,
+      stdio: "ignore",
+      detached: true,
+      windowsHide: true,
+    })?.unref?.();
+    return { attempted: true, workspace };
+  } catch {
+    return { attempted: false, reason: "error" };
+  }
+}
+
+/**
+ * Best-effort fill of one assistant reply into the latest pending dialogue
+ * turn for `sessionId`. Spawns `graphflow dialogue record --reply "<text>"
+ * [--session <sessionId>]` (reply-only mode) in the workspace; the runtime
+ * fills the latest pending turn's assistantReply and safely skips when none is
+ * pending. Half-written (interrupted) replies are not filled. Never throws.
+ * @param {object|undefined} event - an `assistant/message` session event.
+ * @param {string} [sessionId] - dialogue session name/id.
+ * @param {string} [cwd]
+ * @param {GraphFlowDshPluginConfig} [config]
+ * @returns {{attempted: boolean, reason?: string, workspace?: string}}
+ */
+export function recordReplyFromTurn(event, sessionId, cwd, config = {}) {
+  try {
+    const text = extractMessageText(event?.message);
+    if (!text) {
+      return { attempted: false, reason: "no-text" };
+    }
+    if (event?.interrupted) {
+      return { attempted: false, reason: "interrupted" };
+    }
+    const env = envOf(config);
+    if (!isAutoCaptureEnabled(env)) {
+      return { attempted: false, reason: "auto-capture-off" };
+    }
+    const workspace = typeof cwd === "string" && cwd.trim() ? cwd : process.cwd();
+    const spawnFn = typeof config.spawn === "function" ? config.spawn : spawn;
+    const cli = resolveCliCommand(config.packageRoot);
+    const args = [cli, "dialogue", "record", "--reply", text];
+    if (typeof sessionId === "string" && sessionId.trim()) {
+      args.push("--session", sessionId);
+    }
+    const bin = cli === "graphflow" ? (env.GRAPHFLOW_HOOK_BIN?.trim() || "npx") : process.execPath;
+    const fullArgs = cli === "graphflow" ? ["-y", "--package=@roarpeng/graphflow", ...args] : args;
+    spawnFn(bin, fullArgs, {
+      cwd: workspace,
+      env,
+      stdio: "ignore",
+      detached: true,
+      windowsHide: true,
+    })?.unref?.();
+    return { attempted: true, workspace };
+  } catch {
+    return { attempted: false, reason: "error" };
+  }
+}
+
 export function loadGraphFlowSkillRegistration(packageRoot = PACKAGE_ROOT) {
   const skillPath = join(packageRoot, "skills", "graphflow", "SKILL.md");
   let content = "";
@@ -233,6 +379,59 @@ export function apply(ctx, config = {}) {
     // event bus missing
   }
 
+  const recordedInboxMessages = new WeakSet();
+
+  try {
+    // Auto record every user question as a dialogue-turn node (the dsh analog
+    // of Claude Code's PostToolUse capture): each web/agent question becomes a
+    // graph node with session/workspace lineage, without relying on the agent
+    // calling graphflow_context itself. Turns are scoped to the dsh session id
+    // so question recording and reply filling stay in the same dialogue
+    // session (never crossing same-workspace sessions).
+    listen(ctx, "agent/inbox/inserted", (payload) => {
+      try {
+        const message = payload?.message;
+        if (!message || typeof message !== "object") return;
+        if (recordedInboxMessages.has(message)) return;
+        recordedInboxMessages.add(message);
+        const agent = payloadAgent(payload);
+        const cwd =
+          agent?.session?.header?.cwd ??
+          resolveWorkspaceCwd(payload, config.cwd);
+        recordDialogueFromInbox(message, cwd, config, agent?.session?.id);
+      } catch {
+        // recording is optional
+      }
+    });
+  } catch {
+    // event bus missing
+  }
+
+  const recordedReplies = new WeakSet();
+
+  try {
+    // Auto fill every assistant reply into the latest pending dialogue turn of
+    // the same dsh session: closes the question→answer loop so dialogue-turn
+    // nodes record a complete exchange without the agent calling
+    // graphflow_context({ assistantReply }) itself. Deduped per message object;
+    // interrupted (half-written) replies are skipped.
+    listen(ctx, "session/event", (session, event) => {
+      try {
+        if (event?.type !== "assistant/message") return;
+        if (event.interrupted) return;
+        const message = event.message;
+        if (!message || typeof message !== "object") return;
+        if (recordedReplies.has(message)) return;
+        recordedReplies.add(message);
+        recordReplyFromTurn(event, session?.id, session?.header?.cwd, config);
+      } catch {
+        // reply fill is optional
+      }
+    });
+  } catch {
+    // event bus missing
+  }
+
   try {
     listen(ctx, "agent/pre-step", (payload, next) => {
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roarpeng/graphflow",
-  "version": "1.9.15",
+  "version": "1.9.16",
   "publishConfig": {
     "access": "public"
   },
@@ -12,6 +12,7 @@
     "mcp.json",
     "cordis.patch.yml",
     "dsh",
+    "web",
     "skills",
     "src/surfaces/trae-skill",
     "src/surfaces/trae-rules",
@@ -39,6 +40,7 @@
       "default": "./dist/index.js"
     },
     "./dsh": "./dsh/plugin.mjs",
+    "./web": "./web/plugin.mjs",
     "./package.json": "./package.json"
   },
   "bin": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "graphflow",
-  "version": "1.9.15",
+  "version": "1.9.16",
   "description": "图谱上下文压缩与任务规划插件（10 个 MCP 工具）。能力：压缩上下文、DAG 规划、增量建图、技能飞轮、诊断与产物导入导出。DeepSeek Harness：dsh plugin --profile web add @roarpeng/graphflow；工具名为 mcp__graphflow__graphflow_*。先调 graphflow_context（传 rootDir），复杂任务再 plan，改完代码后 index。",
   "author": {
     "name": "Roarpeng",

package/web/README.md

@@ -0,0 +1,36 @@
+# GraphFlow Web 知识节点栏
+
+DeepSeek Harness web 右侧"知识节点"面板的源码种子。
+
+## 现状
+
+- **自动按轮记录**（持久、随包生效）：`dsh/plugin.mjs`（glue）监听 `agent/inbox/inserted`，
+  自动把每一轮用户提问写成 `dialogue-turn` 图节点（写入 agent 会话工作区的 `.graphflow/`）。
+  回复补全沿用既有机制：agent 调用 `graphflow_context({ assistantReply })` 时填充（与
+  Claude Code SessionEnd 同一契约）。可用 `GRAPHFLOW_AUTO_CAPTURE=0` 关闭。
+- **右侧知识节点栏**（本会话生效）：以动态 Cordis 插件（Host + Client 双半部）挂载：
+  - `conversation.session.header.utilities`：会话头部"知识节点"开关按钮
+  - `shell.overlay`：右缘浮动面板（additive，不替换任何出厂 UI），展示
+    Workbench 主题（主线/旁支、活跃、待回复、消息数）+ 对话轮次（Q/A、跳转标记）
+  - 点击节点：通过会话 binding 的 `prompt('queue')` 通道提交续聊指令，agent 自动调用
+    `graphflow_context({ topicId | resumeFromTurnId })` 恢复上下文继续
+
+## 数据来源
+
+面板数据由动态插件的 host 半部经 `harness.handle("gf.nodes.list")` 提供，
+内部调用（当前工作区下）：
+- `graphflow workbench tree --json`
+- `graphflow dialogue list --json --limit 50`
+
+## 打包为静态客户端插件（未来）
+
+dsh web 的静态客户端包必须预编译为 `window.__ModuleLoader__.load({id, factory})`
+工厂格式并经 `/plugins/<id>/client.js` 提供；纯 ESM 文件无法直接加载。
+`plugin.mjs` 中的 `hostHalf()` / `clientHalf()` 即未来 `code.host` / `code.client`
+的源码。届时需：
+1. 在 `package.json` 增加 `dsh.client` 声明（`platform: "web"` + `inject` 列表）
+2. 用 dsh monorepo 的 rolldown 管线把 `./web` 编译为客户端 bundle
+3. 在 `cordis.patch.yml` 增加第三行（客户端插件行）
+
+在完成上述打包前，**不要**在 `cordis.patch.yml` 添加该行（client-modules 扫描到
+缺失 bundle 会使 profile 组合失败）。