wtt-connect 0.2.64 → 0.2.65

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtt-connect",
-  "version": "0.2.64",
+  "version": "0.2.65",
   "private": false,
   "description": "WTT-native connector daemon for Codex, Claude Code, Cursor, Gemini, ACP, and other coding agent surfaces.",
   "type": "module",

package/src/main.js

@@ -10,6 +10,7 @@ import { smokeChat, smokeTask } from './smoke.js';
 import { ArtifactManager } from './artifacts.js';
 import { DurableStore } from './store.js';
 import { WTTClient } from './wtt-client.js';
+import { WTTApi } from './wtt-api.js';
 import { log, redact } from './logger.js';
 import { adapterBin, normalizeProfileName } from './adapters/generic-cli.js';
 import { normalizeAdapterName } from './adapters/index.js';
@@ -38,6 +39,7 @@ export async function main(args) {
   if (cmd === 'upload-artifact' || cmd === 'opendesign-upload') return uploadArtifact(loadConfig(argv), argv);
   if (cmd === 'preview-port' || cmd === 'sandbox-preview') return previewPort(loadConfig(argv), argv);
   if (cmd === 'cleanup-previews' || cmd === 'preview-cleanup') return cleanupPreviewsCommand(loadConfig(argv), argv);
+  if (cmd === 'feishu' || cmd === 'lark') return feishuCommand(loadConfig(argv), argv);
   if (cmd === 'start') {
     const config = loadConfig(argv);
     if (!config.agentId) throw new Error('WTT_AGENT_ID is required');
@@ -92,6 +94,9 @@ function parseArgs(args) {
     else if (a === '--source') out.source = args[++i];
     else if (a === '--source-id') out.sourceId = args[++i];
     else if (a === '--title') out.title = args[++i];
+    else if (a === '--content') out.content = args[++i];
+    else if (a === '--folder-token') out.folderToken = args[++i];
+    else if (a === '--max-chars') out.maxChars = Number(args[++i]);
     else if (a === '--entry') out.entry = args[++i];
     else if (a === '--type') out.type = args[++i];
     else if (a === '--port') out.port = Number(args[++i]);
@@ -151,10 +156,62 @@ Commands:
                                   Create a Cloud Sandbox live preview URL; snapshots are opt-in
   cleanup-previews [--keep-last <n>]
                                   Stop preview servers previously registered by this agent
+  feishu read-doc <url-or-token> [--max-chars n]
+                                  Read a Feishu/Lark doc shared with the WTT Bot
+  feishu create-doc --title <title> [--content text|--file path] [--folder-token token]
+                                  Create a Feishu/Lark doc through the WTT Bot
+  feishu append-doc <url-or-token> (--content text|--file path)
+                                  Append text to a Feishu/Lark doc through the WTT Bot
   help                           Show this help
 `);
 }
 
+async function feishuCommand(config, argv) {
+  const subcommand = String(argv._[0] || '').trim().toLowerCase();
+  const api = new WTTApi(config);
+  if (!config.agentId) throw new Error('WTT_AGENT_ID is required');
+  if (!config.token) throw new Error('WTT_TOKEN or WTT_AGENT_TOKEN is required');
+  if (subcommand === 'read-doc' || subcommand === 'read') {
+    const urlOrToken = String(argv._[1] || argv.url || argv.token || '').trim();
+    if (!urlOrToken) throw new Error('feishu read-doc requires <url-or-token>');
+    const result = await api.feishuReadDoc({ urlOrToken, maxChars: argv.maxChars });
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (subcommand === 'create-doc' || subcommand === 'create') {
+    const title = String(argv.title || '').trim();
+    if (!title) throw new Error('feishu create-doc requires --title <title>');
+    const content = readCommandContent(argv);
+    const result = await api.feishuCreateDoc({ title, content, folderToken: argv.folderToken || '' });
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  if (subcommand === 'append-doc' || subcommand === 'append') {
+    const urlOrToken = String(argv._[1] || argv.url || argv.token || '').trim();
+    if (!urlOrToken) throw new Error('feishu append-doc requires <url-or-token>');
+    const content = readCommandContent(argv);
+    if (!content.trim()) throw new Error('feishu append-doc requires --content <text> or --file <path>');
+    const result = await api.feishuAppendDoc({ urlOrToken, content });
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  throw new Error([
+    'unknown feishu command',
+    'Usage:',
+    '  wtt-connect feishu read-doc <url-or-token> [--max-chars n]',
+    '  wtt-connect feishu create-doc --title <title> [--content text|--file path] [--folder-token token]',
+    '  wtt-connect feishu append-doc <url-or-token> (--content text|--file path)',
+  ].join('\n'));
+}
+
+function readCommandContent(argv) {
+  if (typeof argv.content === 'string') return argv.content;
+  const file = Array.isArray(argv.files) ? argv.files[0] : '';
+  if (!file) return '';
+  const resolved = path.resolve(String(file));
+  return fs.readFileSync(resolved, 'utf8');
+}
+
 async function previewPort(config, argv) {
   const port = Number(argv.port || argv._[0]);
   if (!Number.isInteger(port) || port < 1024 || port > 65535 || port === 3000) {

package/src/runner.js

@@ -254,6 +254,7 @@ export class Runner {
         staged.promptBlock,
         renderTranscriptBlock(transcripts),
         renderCloudSandboxStorageInstruction(this.config, topicId),
+        renderFeishuToolInstruction(this.config),
         renderGeneratedFileArtifactInstruction(this.config, topicId),
         'Reply naturally and concisely unless the user asks for detail.',
       ].filter(Boolean).join('\n');
@@ -1142,6 +1143,21 @@ function renderGeneratedFileArtifactInstruction(config, topicId = '') {
   ].join('\n');
 }
 
+function renderFeishuToolInstruction(config) {
+  if (!config.agentId || !config.token) return '';
+  return [
+    'Feishu/Lark document tool rule, for internal execution only:',
+    '- If the user asks you to read, summarize, analyze, create, or append a Feishu/Lark document, or provides a docs.feishu.cn / feishu.cn / larksuite.com docx/wiki link, call the local WTT Feishu tool instead of guessing from the URL.',
+    '- Read a document: `wtt-connect feishu read-doc "<feishu_doc_or_wiki_url>" --max-chars 50000`.',
+    '- Create a document: `wtt-connect feishu create-doc --title "Title" --content "text"` or put larger content in a file and use `--file path`.',
+    '- Append to a document: `wtt-connect feishu append-doc "<feishu_doc_or_wiki_url>" --content "text"` or `--file path`.',
+    '- The backend only proxies explicit tool calls; do not claim you accessed a Feishu document unless the command succeeds.',
+    '- If the command returns a permission error, tell the user to share the document with the WTT Bot or grant the WTT Feishu app cloud document permissions.',
+    '- The first version intentionally supports read/create/append only. Do not attempt destructive delete, clear, or overwrite operations.',
+    '- When the user explicitly asks to write/create/append a Feishu document, proceed without asking for an extra confirmation.',
+  ].join('\n');
+}
+
 function renderCloudSandboxStorageInstruction(config, topicId = '') {
   if (!config.cloudSandbox) return '';
   const workDir = config.workDir || process.cwd();
@@ -1645,6 +1661,7 @@ function buildTaskPrompt(task, config, staged = { promptBlock: '' }, transcripts
     '',
     config.requireCommitPush ? 'For code changes, commit and push before final response, and include commit id.' : '',
     renderCloudSandboxStorageInstruction(config, task.topic_id || task.topicId || ''),
+    renderFeishuToolInstruction(config),
     renderGeneratedFileArtifactInstruction(config, task.topic_id || task.topicId || ''),
     'Return a concise final summary with evidence, changed files, tests, artifacts, and blockers.',
   ].filter(Boolean).join('\n');

package/src/wtt-api.js

@@ -130,4 +130,38 @@ export class WTTApi {
     }
   }
 
+  async feishuReadDoc({ urlOrToken, maxChars } = {}) {
+    return this.request('POST', '/integrations/feishu/agent/doc/read', {
+      headers: this.agentHeaders(),
+      json: {
+        agent_id: this.config.agentId,
+        url_or_token: urlOrToken,
+        ...(maxChars ? { max_chars: Number(maxChars) } : {}),
+      },
+    });
+  }
+
+  async feishuCreateDoc({ title, content = '', folderToken = '' } = {}) {
+    return this.request('POST', '/integrations/feishu/agent/doc/create', {
+      headers: this.agentHeaders(),
+      json: {
+        agent_id: this.config.agentId,
+        title,
+        content,
+        ...(folderToken ? { folder_token: folderToken } : {}),
+      },
+    });
+  }
+
+  async feishuAppendDoc({ urlOrToken, content } = {}) {
+    return this.request('POST', '/integrations/feishu/agent/doc/append', {
+      headers: this.agentHeaders(),
+      json: {
+        agent_id: this.config.agentId,
+        url_or_token: urlOrToken,
+        content,
+      },
+    });
+  }
+
 }