wtt-connect 0.2.30 → 0.2.31

package/package.json

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

package/src/config.js

@@ -55,6 +55,8 @@ export function loadConfig(argv = {}) {
       providerMap: fileConfig.modelSwitch?.providerMap || parseJsonEnv(process.env.WTT_CONNECT_MODEL_PROVIDER_MAP, {}),
     },
     workDir,
+    cloudSandbox: parseBool(process.env.WTT_CONNECT_CLOUD_SANDBOX, fileConfig.cloudSandbox ?? false),
+    persistentOutputDir: process.env.WTT_CONNECT_PERSISTENT_OUTPUT_DIR || process.env.WTT_CONNECT_R2_OUTPUT_DIR || fileConfig.persistentOutputDir || '',
     model: process.env.WTT_CONNECT_MODEL || fileConfig.model || '',
     mode,
     allowYolo: parseBool(process.env.WTT_CONNECT_ALLOW_YOLO, fileConfig.allowYolo ?? mode === 'yolo'),

package/src/main.js

@@ -186,7 +186,7 @@ function packageUploadFiles(files, config, argv) {
   return { path: zipPath, originalFiles: files };
 }
 
-function resolveUploadFilePath(filePath, config) {
+export function resolveUploadFilePath(filePath, config) {
   const raw = String(filePath || '').trim();
   if (!raw) throw new Error('empty file path');
   const expanded = raw.startsWith('~/') ? path.join(process.env.HOME || '', raw.slice(2)) : raw;
@@ -197,9 +197,10 @@ function resolveUploadFilePath(filePath, config) {
     config.artifactDir,
     config.storeFile ? path.dirname(config.storeFile) : '',
     config.inboxDir,
+    config.persistentOutputDir,
   ].filter(Boolean).map((root) => path.resolve(root));
   if (!roots.some((root) => isPathInside(resolved, root))) {
-    throw new Error(`upload-file refused path outside WTT workspace/state roots: ${resolved}`);
+    throw new Error(`upload-file refused path outside WTT workspace/state/persistent roots: ${resolved}`);
   }
   return resolved;
 }

package/src/runner.js

@@ -221,6 +221,7 @@ export class Runner {
         '',
         staged.promptBlock,
         renderTranscriptBlock(transcripts),
+        renderCloudSandboxStorageInstruction(this.config),
         renderGeneratedFileArtifactInstruction(this.config, topicId),
         'Reply naturally and concisely unless the user asks for detail.',
       ].filter(Boolean).join('\n');
@@ -903,10 +904,11 @@ function truncate(text, maxChars) {
 
 function renderGeneratedFileArtifactInstruction(config, topicId = '') {
   const workDir = config.workDir || process.cwd();
+  const outputDir = config.cloudSandbox && config.persistentOutputDir ? config.persistentOutputDir : workDir;
   const uploadCommand = `wtt-connect upload-file --topic-id ${topicId || '<topic_id>'} --title "optional display name" <file-or-files>`;
   return [
     'Generated file artifact rule, for internal execution only:',
-    `- If you create a user-facing file (.docx, .pptx, .xlsx, .pdf, .csv, .md, .zip, images, or video), save it under your current WTT agent workspace: ${workDir}.`,
+    `- If you create a user-facing file (.docx, .pptx, .xlsx, .pdf, .csv, .md, .zip, images, or video), save it under: ${outputDir}.`,
     `- After creating the file, immediately publish it to this WTT conversation by running: ${uploadCommand}`,
     '- For multiple related files, pass all file paths to one upload-file command; wtt-connect will package them into one zip before publishing.',
     '- If upload-file is unavailable, include one marker line per generated file in your final response, exactly like: [WTT_ARTIFACT_FILE path="relative/or/absolute/file.docx" title="optional display name"].',
@@ -915,6 +917,34 @@ function renderGeneratedFileArtifactInstruction(config, topicId = '') {
   ].join('\n');
 }
 
+function renderCloudSandboxStorageInstruction(config) {
+  if (!config.cloudSandbox) return '';
+  const workDir = config.workDir || process.cwd();
+  const persistentDir = String(config.persistentOutputDir || '').trim();
+  const lines = [
+    'Cloud Sandbox storage policy, for internal execution only:',
+    `- This agent is running inside WTT Cloud Sandbox. Keep the active workspace small: ${workDir}.`,
+  ];
+  if (persistentDir) {
+    lines.push(
+      `- Put durable outputs, datasets, downloads, archives, generated reports, build products, and any file expected to survive cleanup under: ${persistentDir}.`,
+      `- Create that directory before use: mkdir -p ${shellishQuote(persistentDir)}.`,
+    );
+  } else {
+    lines.push('- Put durable large outputs under the mounted R2 storage area when available, not in the active workspace.');
+  }
+  lines.push(
+    '- Do not install large dependencies, clone large repositories, download datasets, or write bulky generated files into the workspace unless the user explicitly asks for local temporary storage.',
+    '- Keep only source edits, small manifests, notes, and temporary scratch files in the workspace.',
+    '- If a generated user-facing file is stored in R2/persistent output storage and should appear in WTT chat, still publish it with `wtt-connect upload-file` or a WTT artifact marker.',
+  );
+  return lines.join('\n');
+}
+
+function shellishQuote(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
 async function packageGeneratedFilesIfNeeded(files, config, context = {}) {
   if (!files.length) return [];
   if (files.length === 1) return files;
@@ -1351,6 +1381,7 @@ function buildTaskPrompt(task, config, staged = { promptBlock: '' }, transcripts
     renderTranscriptBlock(transcripts),
     '',
     config.requireCommitPush ? 'For code changes, commit and push before final response, and include commit id.' : '',
+    renderCloudSandboxStorageInstruction(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');