@xmanrui/dsh-im 0.6.0 → 0.7.1

package/src/channels/shared/harness-question.mjs

@@ -0,0 +1,85 @@
+function nonEmptyString(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+export function validHarnessQuestion(question) {
+  return question && typeof question.id === 'string' && typeof question.question === 'string'
+    && (question.header === undefined || typeof question.header === 'string')
+    && (question.detail === undefined || typeof question.detail === 'string')
+    && (question.multiSelect === undefined || typeof question.multiSelect === 'boolean')
+    && (question.options === undefined || (Array.isArray(question.options)
+      && question.options.every((option) => (
+        option && typeof option.label === 'string'
+        && (option.description === undefined || typeof option.description === 'string')
+      ))));
+}
+
+export function harnessQuestionText(question, index, total, { requiresMention = false } = {}) {
+  const lines = [];
+  const progress = total > 1 ? `（${index + 1}/${total}）` : '';
+  lines.push(`DeepSeek Harness 需要你补充信息${progress}：`);
+  if (nonEmptyString(question.header)) lines.push('', question.header.trim());
+  lines.push('', nonEmptyString(question.question) ?? '请输入你的回答。');
+  if (nonEmptyString(question.detail)) lines.push('', question.detail.trim());
+
+  const options = Array.isArray(question.options) ? question.options : [];
+  if (options.length > 0) {
+    lines.push('');
+    options.forEach((option, optionIndex) => {
+      const label = typeof option?.label === 'string' ? option.label : '';
+      const description = nonEmptyString(option?.description);
+      lines.push(`${optionIndex + 1}. ${label}${description ? ` — ${description}` : ''}`);
+    });
+    lines.push('', question.multiSelect === true
+      ? '请回复选项序号或文字；多选用逗号分隔，也可补充其他内容。'
+      : '请回复一个选项序号或文字，也可直接输入其他答案。');
+  } else {
+    lines.push('', '请直接回复你的答案。');
+  }
+  if (requiresMention) lines.push('', '群聊中请 @机器人 后发送答案。');
+  return lines.join('\n');
+}
+
+function optionLabel(token, options) {
+  const normalized = token.trim();
+  if (!normalized) return null;
+  if (/^\d+$/.test(normalized)) {
+    const option = options[Number(normalized) - 1];
+    return typeof option?.label === 'string' ? option.label : null;
+  }
+  const exact = options.find((option) => option?.label === normalized);
+  return typeof exact?.label === 'string' ? exact.label : null;
+}
+
+export function harnessAnswerForQuestion(question, text) {
+  const options = Array.isArray(question.options) ? question.options : [];
+  if (options.length === 0) {
+    return { id: question.id, selected: [], custom: text };
+  }
+
+  const wholeLabel = optionLabel(text, options);
+  if (question.multiSelect !== true) {
+    return wholeLabel
+      ? { id: question.id, selected: [wholeLabel] }
+      : { id: question.id, selected: [], custom: text };
+  }
+  if (wholeLabel) return { id: question.id, selected: [wholeLabel] };
+
+  const selected = [];
+  const custom = [];
+  for (const token of text.split(/[,，、;；\n]+/)) {
+    const value = token.trim();
+    if (!value) continue;
+    const label = optionLabel(value, options);
+    if (label) {
+      if (!selected.includes(label)) selected.push(label);
+    } else {
+      custom.push(value);
+    }
+  }
+  return {
+    id: question.id,
+    selected,
+    ...(custom.length > 0 ? { custom: custom.join('、') } : {}),
+  };
+}

package/src/channels/shared/harness-session-binding.mjs

@@ -0,0 +1,110 @@
+import { isAbsolute } from 'node:path';
+
+const MAX_SESSION_ID_LENGTH = 256;
+const UNSAFE_SESSION_ID = /[\p{White_Space}\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u;
+const UNSAFE_WORKSPACE_PATH = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u;
+
+function bindingError(code, message) {
+  const error = new Error(message);
+  error.code = code;
+  return error;
+}
+
+function validatedSessionId(value) {
+  if (typeof value !== 'string' || !value || value.length > MAX_SESSION_ID_LENGTH
+    || UNSAFE_SESSION_ID.test(value)) {
+    throw bindingError('session-id-invalid', 'A non-empty, safe session id is required');
+  }
+  return value;
+}
+
+function sessionWorkspace(sessionId, value) {
+  if (!Array.isArray(value?.items) || !Array.isArray(value?.archivedSessionIds)
+    || value.archivedSessionIds.some((id) => typeof id !== 'string' || !id)) {
+    throw new Error('Harness returned an invalid response for workspace.list');
+  }
+
+  const owners = [];
+  for (const workspace of value.items) {
+    if (typeof workspace?.workspaceId !== 'string' || !workspace.workspaceId
+      || typeof workspace.path !== 'string' || !isAbsolute(workspace.path)
+      || !Array.isArray(workspace.sessionIds)
+      || workspace.sessionIds.some((id) => typeof id !== 'string' || !id)) {
+      throw new Error('Harness returned an invalid response for workspace.list');
+    }
+    for (const accountedId of workspace.sessionIds) {
+      if (accountedId === sessionId) owners.push(workspace);
+    }
+  }
+
+  if (owners.length === 0) {
+    throw bindingError('session-not-registered', 'The session is not registered to a Harness workspace');
+  }
+  if (owners.length !== 1) {
+    throw bindingError(
+      'session-workspace-ambiguous',
+      'The session is registered to more than one Harness workspace',
+    );
+  }
+  if (UNSAFE_WORKSPACE_PATH.test(owners[0].path)) {
+    throw new Error('Harness returned an unsafe workspace path for the session');
+  }
+  return {
+    workspace: owners[0],
+    archived: value.archivedSessionIds.includes(sessionId),
+  };
+}
+
+function sessionSummary(sessionId, value) {
+  if (!Array.isArray(value?.items)
+    || value.items.some((item) => typeof item?.sessionId !== 'string' || !item.sessionId)) {
+    throw new Error('Harness returned an invalid response for session.list');
+  }
+  const matches = value.items.filter((item) => item.sessionId === sessionId);
+  if (matches.length === 0) {
+    throw bindingError('session-summary-unavailable', 'The session is no longer available from Harness');
+  }
+  if (matches.length !== 1) {
+    throw new Error('Harness returned duplicate session summaries for session.list');
+  }
+
+  const [summary] = matches;
+  if (summary.origin === 'subagent') {
+    throw bindingError(
+      'session-subagent-unsupported',
+      'Subagent sessions cannot be adopted as a bot conversation',
+    );
+  }
+  if (summary.origin !== undefined) {
+    throw new Error('Harness returned an invalid session origin for session.list');
+  }
+  const title = summary.projections?.values?.title;
+  if (title !== undefined && title !== null && typeof title !== 'string') {
+    throw new Error('Harness returned an invalid session title for session.list');
+  }
+  return { title: typeof title === 'string' ? title : null };
+}
+
+export async function adoptRegisteredWorkspaceSession(client, value, options = {}, timeoutMs = 30_000) {
+  const sessionId = validatedSessionId(value);
+  await client.ensureRunning(options);
+  const workspaceList = await client.rpc('workspace.list', {}, timeoutMs, options);
+  const { workspace, archived } = sessionWorkspace(sessionId, workspaceList);
+  const summary = sessionSummary(
+    sessionId,
+    await client.rpc('session.list', {}, timeoutMs, options),
+  );
+  const adopted = await client.rpc('session.create', {
+    workspaceId: workspace.workspaceId,
+    sessionId,
+  }, timeoutMs, options);
+  if (!adopted || adopted.sessionId !== sessionId) {
+    throw new Error('Harness returned an invalid response for session.create');
+  }
+  return {
+    sessionId,
+    workspace: workspace.path,
+    title: summary.title,
+    archived,
+  };
+}