@forloop-cc/forloop-opencode-plugin-planner 2.2.15 → 2.2.17

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@forloop-cc/forloop-opencode-plugin-planner",
-  "version": "2.2.15",
+  "version": "2.2.17",
   "description": "ForLoop integration plugin for opencode — Sprint, story, and agent tools for the ForLoop platform",
   "type": "module",
   "license": "MIT",

package/plugins/capabilities/api-client.ts

@@ -76,7 +76,7 @@ export interface ChatRequest {
   message: string;
   sprintId?: number;
   selectedAgentKey?: string;
-  type?: 'chat' | 'summary' | 'suggestion' | 'analysis' | 'translation' | 'feature' | 'planner.chat' | 'developer.sprint';
+  type?: 'chat' | 'summary' | 'suggestion' | 'analysis' | 'translation' | 'feature' | 'planner.chat' | 'developer.sprint' | 'creator.generate';
   conversationId?: string;
   metadata?: any;
 }

package/plugins/capabilities/mime-types.ts

@@ -1,4 +1,8 @@
 const MIME_TYPES: Record<string, string> = {
+  '.html': 'text/html',
+  '.htm': 'text/html',
+  '.css': 'text/css',
+  '.svg': 'image/svg+xml',
   '.png': 'image/png',
   '.jpg': 'image/jpeg',
   '.jpeg': 'image/jpeg',

package/plugins/tools/ai-trigger-tools.ts

@@ -9,6 +9,7 @@ export function createAITriggerTools(client: ForLoopAPIClient) {
   const tools: Record<string, ReturnType<typeof tool>> = {};
 
   tools['forloopAiDeveloperSpaceSprint'] = createDeveloperSprintTool(client);
+  tools['forloopCreatorGenerate'] = createCreatorGenerateTool(client);
 
   return tools;
 }
@@ -77,3 +78,76 @@ function createDeveloperSprintTool(client: ForLoopAPIClient) {
     },
   });
 }
+
+/**
+ * forloopCreatorGenerate - Trigger forLoopCreator agent on-demand during planning.
+ * Dispatches the Creator via EventBridge → Step Functions → ECS (same path as
+ * developer.sprint) using selectedAgentKey=forLoopCreator and type=creator.generate.
+ * The planner MUST pre-create a Creator story (forloopStoryTemplate with
+ * assigneeAgentKey="forLoopCreator") before dispatching.
+ */
+function createCreatorGenerateTool(client: ForLoopAPIClient) {
+  return tool({
+    description: 'Trigger the forLoopCreator agent on-demand during planning to generate files (documents, presentations, spreadsheets, music, images, video). Requires a story to be pre-created via forloopStoryTemplate(assigneeAgentKey="forLoopCreator") first. Generated files land under frontend/public/ and auto-deploy via CI/CD.',
+    args: {
+      sprintId: tool.schema.number()
+        .describe('Sprint ID'),
+      storyId: tool.schema.number()
+        .describe('Pre-created Creator story ID (from forloopStoryTemplate with assigneeAgentKey="forLoopCreator")'),
+      message: tool.schema.string()
+        .optional()
+        .describe('Generation instructions, including the story ID and desired output')
+        .default('Generate the files described in the assigned story'),
+    },
+    async execute(args, _context) {
+      const tokenResult = await validateToken();
+      if (!tokenResult.valid) {
+        return tokenResult.error;
+      }
+
+      try {
+        console.log('[forloopCreatorGenerate] Triggering creator agent', {
+          sprintId: args.sprintId,
+          storyId: args.storyId,
+        });
+
+        // The ECS pipeline (EventBridge → SFN → ECS) does not carry `metadata`,
+        // so the Creator agent only ever sees the `message`. Bake the storyId into
+        // the message so the Creator can forloopContextFetch the correct story.
+        const baseMessage = args.message || 'Generate the files described in the assigned story';
+        const message = `${baseMessage}\n\nTarget story ID: ${args.storyId}`;
+
+        const response = await client.chatWithAI({
+          sprintId: args.sprintId,
+          message,
+          selectedAgentKey: 'forLoopCreator',
+          type: 'creator.generate',
+          metadata: { channel: 'creator_generate', storyId: args.storyId },
+        });
+
+        const taskId = response.taskId || response.id || 'unknown';
+        const trackingId = response.trackingId || 'unknown';
+
+        return `🎨 Creator dispatched for file generation
+
+**Details:**
+- Task ID: \`${taskId}\`
+- Tracking ID: \`${trackingId}\`
+- Sprint: #${args.sprintId}
+- Story: #${args.storyId}
+- Agent: forLoopCreator
+
+**What happens next:**
+1. Sprint lock is acquired (conflicts if a developer task is running)
+2. ECS Fargate task starts the forLoopCreator agent
+3. Files are generated under frontend/public/ and committed
+4. Story is updated with a completion comment
+
+**Monitor:** poll \`forloopDeveloperStatus(sprintId=${args.sprintId})\` for completion.`;
+      } catch (error: any) {
+        console.error('[forloopCreatorGenerate] Failed to trigger creator', error);
+        return `❌ Failed to trigger forLoopCreator: ${error.message}`;
+      }
+    },
+  });
+}

package/plugins/tools/developer-status-tool.ts

@@ -49,9 +49,11 @@ export function createDeveloperStatusTool(client: ForLoopAPIClient) {
         const exec = status.execution || {};
         const sprint = status.sprint || {};
         const execIcon = SFN_ICONS[exec.status] || '❓';
+        const isCreator = String(task.agentKey || '').toLowerCase() === 'forloopcreator';
+        const taskLabel = isCreator ? 'Creator Task' : 'Developer Task';
 
         const lines = [
-          `${execIcon} Developer Task: ${exec.status}`,
+          `${execIcon} ${taskLabel}: ${exec.status}`,
           '',
           `**Sprint**: #${resolution.sprintId}`,
           `**Task Status**: ${task.status} (${task.id ? task.id.substring(0, 8) : '?'})`,

package/plugins/tools/file-tools.ts

@@ -82,6 +82,7 @@ export function createFileUploadTool(client: ForLoopAPIClient) {
           `✅ File uploaded successfully!`,
           '',
           `**File**: ${fileName}`,
+          `**File ID**: ${complete.id}`,
           `**Size**: ${formatFileSize(fileSize)}`,
           `**URL**: ${complete.url}`,
           args.description ? `**Description**: ${args.description}` : null,
@@ -192,13 +193,16 @@ export function createFileDownloadUrlTool(client: ForLoopAPIClient) {
         // Fire-and-forget audit log — don't block download on audit failure
         client.logFileRead(args.fileId).catch(() => {});
 
-        const download = await client.getFileDownloadUrl(args.fileId);
+        // Use open-url (returns JSON {url}) rather than download (which 302-redirects
+        // to the signed URL — the plugin's fetch would follow it and fail JSON parsing).
+        const open = await client.getFileOpenUrl(args.fileId);
+        const url = String(open?.openUrl || open?.url || '');
 
         return [
           `📥 Download URL`,
           '',
           `**File ID**: ${args.fileId}`,
-          `**URL**: ${download.url}`,
+          `**URL**: ${url}`,
           '',
           '⚠️ This URL may expire. Download the file soon.',
         ].join('\n');