@xirang-ai/dsh-teamflow 0.1.1 → 0.1.2

package/lib/tools/link-session.js

@@ -0,0 +1,87 @@
+/**
+ * `teamflow_link_session` — confirm the discussion prepared for this conversation.
+ *
+ * The browser creates the session and registers a pending binding before the
+ * first message, so the Agent must not need a record id. The session id is the
+ * durable identity of the conversation; linking is idempotent. Requirements,
+ * stories and defects share this tool; `teamflow_link_requirement_session`
+ * stays as a compatibility alias with the same implementation.
+ *
+ * @module
+ */
+import { defineTool } from '@deepseek-ai/dsh-tools';
+/** Where the Agent should read the record after linking. */
+function nextStep(subjectType) {
+    if (subjectType === 'story')
+        return 'teamflow_get_story';
+    if (subjectType === 'bug')
+        return 'teamflow_get_bug';
+    return 'teamflow_get_requirement';
+}
+/** Build the generic session-linking tool bound to one Host context. */
+export function linkSessionTool(environment) {
+    return defineTool({
+        name: 'teamflow_link_session',
+        description: 'Confirm that this conversation belongs to the requirement, story or defect it was started from. Call it once at the very beginning of a discussion; it takes no arguments and returns the subject type, id, title and confirmation time.',
+        parameters: {},
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    subjectType: { type: 'string', required: true },
+                    subjectId: { type: 'string', required: true },
+                    title: { type: 'string', required: true },
+                    sessionId: { type: 'string', required: true },
+                    kind: { type: 'string', required: true },
+                    linkedAt: { type: 'string', required: true },
+                    alreadyLinked: { type: 'boolean', required: true },
+                },
+            },
+            render: (_args, value) => [
+                {
+                    type: 'text',
+                    text: [
+                        `已把本会话登记到${subjectLabel(value.subjectType)} ${value.subjectId}《${value.title}》。`,
+                        `接下来调用 ${nextStep(value.subjectType)} 读取正文，再结合用户补充继续讨论。`,
+                    ].join('\n'),
+                },
+            ],
+        },
+        async execute(_args, exec) {
+            exec.signal.throwIfAborted();
+            const sessionId = exec.agent?.session.header.id?.trim() ?? '';
+            if (sessionId.length === 0) {
+                throw new Error('teamflow: 无法从当前会话取得 session id，不能登记讨论会话。');
+            }
+            const before = environment.database.workflow.getDiscussionSession(sessionId);
+            const session = environment.database.workflow.linkDiscussionSession(sessionId);
+            const title = subjectTitle(environment, session.subjectType, session.subjectId);
+            return {
+                subjectType: session.subjectType,
+                subjectId: session.subjectId,
+                title,
+                sessionId: session.sessionId,
+                kind: session.kind,
+                linkedAt: session.linkedAt ?? session.preparedAt ?? session.createdAt,
+                alreadyLinked: before?.linkedAt != null,
+            };
+        },
+    });
+}
+function subjectLabel(subjectType) {
+    if (subjectType === 'story')
+        return '故事';
+    if (subjectType === 'bug')
+        return '缺陷';
+    return '需求';
+}
+/** Record title, falling back to the id so a dangling row still reports something readable. */
+function subjectTitle(environment, subjectType, subjectId) {
+    const workflow = environment.database.workflow;
+    if (subjectType === 'story')
+        return workflow.getStory(subjectId)?.title ?? subjectId;
+    if (subjectType === 'bug')
+        return workflow.getBug(subjectId)?.title ?? subjectId;
+    return workflow.getRequirement(subjectId)?.title ?? subjectId;
+}

package/locale/en.json

@@ -133,6 +133,7 @@
   "delete.statusMissing": "—",
   "delete.summary": "{total} record(s), {deletable} deletable",
   "detail.branch": "Branch",
+  "detail.bugDiscussion": "Discuss this bug in a new session",
   "detail.bugBody": "What happened",
   "detail.completedAt": "Completed",
   "detail.description": "Description",
@@ -148,6 +149,7 @@
   "detail.discussionNewDetail": "Discuss the detailed design in a new conversation",
   "detail.discussionNewSplit": "Split Stories in a new conversation",
   "detail.discussionOpen": "Open",
+  "detail.storyDiscussion": "Discuss this story in a new session",
   "detail.discussionStarting": "Creating conversation…",
   "detail.docs": "Detailed design",
   "detail.docsEmpty": "No detailed design written yet.",

package/locale/zh.json

@@ -133,6 +133,7 @@
   "delete.statusMissing": "—",
   "delete.summary": "共 {total} 条，可删除 {deletable} 条",
   "detail.branch": "分支",
+  "detail.bugDiscussion": "在新会话中进行缺陷讨论",
   "detail.bugBody": "缺陷说明",
   "detail.completedAt": "完成时间",
   "detail.description": "故事说明",
@@ -148,6 +149,7 @@
   "detail.discussionNewDetail": "在新会话中进行详细设计讨论",
   "detail.discussionNewSplit": "在新会话中进行故事拆分",
   "detail.discussionOpen": "打开",
+  "detail.storyDiscussion": "在新会话中进行故事讨论",
   "detail.discussionStarting": "正在创建会话…",
   "detail.docs": "详细设计",
   "detail.docsEmpty": "还没有写详细设计。",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xirang-ai/dsh-teamflow",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "DeepSeek Harness plugin: Xirang workbench for the requirement → development → defect pipeline.",
   "license": "MIT",
   "repository": {