@xirang-ai/dsh-teamflow 0.1.0 → 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

@@ -26,10 +26,12 @@
   "composer.locked": "The conversation has started; create a new one to switch agents.",
   "composer.noPreset": "The preset agent is not loaded, so the switch was not applied.",
   "composer.other": "Other (default)",
-  "create.attachment.add": "Add files",
+  "create.attachment.add": "Add attachments",
   "create.attachment.blocked": "Attachments are still uploading; wait for them to finish before sending.",
   "create.attachment.busy": "The conversation is busy, so the attachments were not sent. Try again.",
   "create.attachment.cancelled": "Upload cancelled; nothing was sent.",
+  "create.attachment.dropActive": "Release to attach these files.",
+  "create.attachment.dropHint": "Click to choose files, or drop them here.",
   "create.attachment.failed": "Upload failed",
   "create.attachment.failed.network": "The upload failed. Check the network and try again.",
   "create.attachment.failed.rejected": "The host rejected the file (damaged content or wrong type).",
@@ -131,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",
@@ -146,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

@@ -26,10 +26,12 @@
   "composer.locked": "会话已开始，无法再切换 Agent；请新建会话。",
   "composer.noPreset": "预设 Agent 未加载，无法切换。",
   "composer.other": "其他（默认）",
-  "create.attachment.add": "选择文件",
+  "create.attachment.add": "添加附件",
   "create.attachment.blocked": "附件正在上传，上传完成后再提交。",
   "create.attachment.busy": "会话正忙，附件未发送，请稍后重试。",
   "create.attachment.cancelled": "已取消上传，附件未发送。",
+  "create.attachment.dropActive": "松手即可添加附件。",
+  "create.attachment.dropHint": "点击选择文件，或把文件拖到这里。",
   "create.attachment.failed": "上传失败",
   "create.attachment.failed.network": "上传暂时失败，请检查网络后重试。",
   "create.attachment.failed.rejected": "宿主拒绝了该文件（内容损坏或类型不符）。",
@@ -131,6 +133,7 @@
   "delete.statusMissing": "—",
   "delete.summary": "共 {total} 条，可删除 {deletable} 条",
   "detail.branch": "分支",
+  "detail.bugDiscussion": "在新会话中进行缺陷讨论",
   "detail.bugBody": "缺陷说明",
   "detail.completedAt": "完成时间",
   "detail.description": "故事说明",
@@ -146,6 +149,7 @@
   "detail.discussionNewDetail": "在新会话中进行详细设计讨论",
   "detail.discussionNewSplit": "在新会话中进行故事拆分",
   "detail.discussionOpen": "打开",
+  "detail.storyDiscussion": "在新会话中进行故事讨论",
   "detail.discussionStarting": "正在创建会话…",
   "detail.docs": "详细设计",
   "detail.docsEmpty": "还没有写详细设计。",

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@xirang-ai/dsh-teamflow",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "DeepSeek Harness plugin: Xirang workbench for the requirement → development → defect pipeline.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/xirang-ai/teamflow.git"
+    "url": "git+https://github.com/xirang-ai/dsh-teamflow.git"
   },
   "keywords": [
     "deepseek-harness",
@@ -115,8 +115,8 @@
     "@deepseek-ai/schemastery": "^3.19.0",
     "nanoid": "^6.0.2"
   },
-  "homepage": "https://github.com/xirang-ai/teamflow#readme",
+  "homepage": "https://github.com/xirang-ai/dsh-teamflow#readme",
   "bugs": {
-    "url": "https://github.com/xirang-ai/teamflow/issues"
+    "url": "https://github.com/xirang-ai/dsh-teamflow/issues"
   }
 }