@forloop-cc/forloop-opencode-plugin-planner 2.2.14 → 2.2.16

package/CHANGELOG.md

@@ -10,10 +10,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added - Sprint & Story API Enhancements
 
 #### New Sprint Tools
-- **forloopSpaceSprintCreate** - Create new sprint with dates and settings
+- **forloopSpaceSprintCreate** - Create new space with dates and settings
   - Arguments: title, description, startDate, endDate, isPrivate, organizationId
-  - Confirmation messages with sprint details
-- **forloopSpaceSprintUpdate** - Update sprint details
+  - Confirmation messages with space details
+- **forloopSpaceSprintUpdate** - Update space details
   - Arguments: sprintId, title, description, startDate, endDate, isPrivate
   - Partial updates supported
 - **forloopSpaceSprintDelete** - Delete sprint (with confirmation)
@@ -155,8 +155,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 #### Core Features
 - `forloopTokenSet` - Set/update ForLoop API token
 - `forloopTokenGet` - Check if API token is configured
-- `forloopSpaceSprintGet` - Get sprint details with stories and files
-- `forloopSpaceSprintList` - List all accessible sprints
+- `forloopSpaceSprintGet` - Get space details with stories and files
+- `forloopSpaceSprintList` - List all accessible spaces
 - `forloopStoryCreate` - Create new stories
 - `forloopStoryUpdate` - Update existing stories
 - `forloopStoryDelete` - Delete stories

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@forloop-cc/forloop-opencode-plugin-planner",
-  "version": "2.2.14",
+  "version": "2.2.16",
   "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/agent-sprint-tools.ts

@@ -44,7 +44,7 @@ export function createAgentListTool(client: ForLoopAPIClient) {
 
 export function createSprintAiAgentsUpdateTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Enable or disable AI agents for a sprint',
+    description: 'Enable or disable AI agents for a space',
     args: {
       sprintId: tool.schema.number()
         .optional()

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

@@ -9,17 +9,18 @@ export function createAITriggerTools(client: ForLoopAPIClient) {
   const tools: Record<string, ReturnType<typeof tool>> = {};
 
   tools['forloopAiDeveloperSpaceSprint'] = createDeveloperSprintTool(client);
+  tools['forloopCreatorGenerate'] = createCreatorGenerateTool(client);
 
   return tools;
 }
 
 /**
- * forloopAiDeveloperSpaceSprint - Trigger developer agent for sprint work
+ * forloopAiDeveloperSpaceSprint - Trigger developer agent for space work
  * Triggers the forLoopTaskSupervisor agent via EventBridge → Step Functions → ECS
  */
 function createDeveloperSprintTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Trigger forLoopTaskSupervisor agent to execute sprint work. This sends stories to the developer agent for implementation via EventBridge → Step Functions → ECS Fargate.',
+    description: 'Trigger forLoopTaskSupervisor agent to execute space work. This sends stories to the developer agent for implementation via EventBridge → Step Functions → ECS Fargate.',
     args: {
       sprintId: tool.schema.number()
         .describe('Sprint ID to execute'),
@@ -77,3 +78,70 @@ 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,
+        });
+
+        const response = await client.chatWithAI({
+          sprintId: args.sprintId,
+          message: args.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');

package/plugins/tools/sprint-tools.ts

@@ -6,7 +6,7 @@ import { getToken } from '../capabilities/token-storage';
 
 export function createSprintGetTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Get sprint details including stories, files, and AI agents',
+    description: 'Get space details including stories, files, and AI agents',
     args: {
       sprintId: tool.schema.number()
         .optional()
@@ -49,7 +49,7 @@ export function createSprintGetTool(client: ForLoopAPIClient) {
         });
 
         const lines = [
-          `📋 Sprint #${sprint.id}: ${sprint.title}`,
+          `📋 Space #${sprint.id}: ${sprint.title}`,
           '',
           `**Status**: ${sprint.status}`,
           `**Period**: ${formatDate(sprint.startDate)} - ${formatDate(sprint.endDate)}`,
@@ -80,7 +80,7 @@ export function createSprintGetTool(client: ForLoopAPIClient) {
 
 export function createSprintListTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'List all accessible sprints',
+    description: 'List all accessible spaces',
     args: {
       organizationId: tool.schema.number()
         .optional()
@@ -106,10 +106,10 @@ export function createSprintListTool(client: ForLoopAPIClient) {
         });
 
         if (!sprints.length) {
-          return 'No sprints found.';
+          return 'No spaces found.';
         }
 
-        const lines = ['📋 Sprints:', ''];
+        const lines = ['📋 Spaces:', ''];
         for (const sprint of sprints) {
           const statusIcon = getStatusIcon(sprint.status);
           const orgInfo = sprint.organizationName ? ` (${sprint.organizationName})` : '';
@@ -155,7 +155,7 @@ function getStatusIcon(status: string): string {
 
 export function createSprintCreateTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Create a new sprint with specified dates and settings',
+    description: 'Create a new space with specified dates and settings',
     args: {
       title: tool.schema.string()
         .describe('Sprint title'),
@@ -191,7 +191,7 @@ export function createSprintCreateTool(client: ForLoopAPIClient) {
         });
 
         const lines = [
-          '✅ Sprint created successfully!',
+          '✅ Space created successfully!',
           '',
           `**#${sprint.id}**: ${sprint.title}`,
           `**Period**: ${formatDate(sprint.startDate)} - ${formatDate(sprint.endDate)}`,
@@ -212,7 +212,7 @@ export function createSprintCreateTool(client: ForLoopAPIClient) {
 
 export function createSprintUpdateTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Update sprint details',
+    description: 'Update space details',
     args: {
       sprintId: tool.schema.number()
         .describe('Sprint ID to update'),
@@ -249,7 +249,7 @@ export function createSprintUpdateTool(client: ForLoopAPIClient) {
 
         const sprint = await client.updateSprint(args.sprintId, updateData);
 
-        return `✅ Sprint #${sprint.id} updated successfully!`;
+        return `✅ Space #${sprint.id} updated successfully!`;
       } catch (error: any) {
         return `❌ Error: ${error.message}`;
       }
@@ -259,7 +259,7 @@ export function createSprintUpdateTool(client: ForLoopAPIClient) {
 
 export function createSprintDeleteTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Delete a sprint (use with caution)',
+    description: 'Delete a space (use with caution)',
     args: {
       sprintId: tool.schema.number()
         .describe('Sprint ID to delete'),
@@ -276,7 +276,7 @@ export function createSprintDeleteTool(client: ForLoopAPIClient) {
 
       if (!args.confirm) {
         return [
-          '⚠️ Warning: This will permanently delete the sprint and all its stories.',
+          '⚠️ Warning: This will permanently delete the space and all its stories.',
           '',
           'Use --confirm true to proceed.',
         ].join('\n');
@@ -285,7 +285,7 @@ export function createSprintDeleteTool(client: ForLoopAPIClient) {
       try {
         await client.deleteSprint(args.sprintId);
 
-        return `✅ Sprint #${args.sprintId} deleted successfully!`;
+        return `✅ Space #${args.sprintId} deleted successfully!`;
       } catch (error: any) {
         return `❌ Error: ${error.message}`;
       }
@@ -295,7 +295,7 @@ export function createSprintDeleteTool(client: ForLoopAPIClient) {
 
 export function createSubSprintListTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'List all iterations (sub-sprints) within a sprint',
+    description: 'List all iterations (sub-sprints) within a space',
     args: {
       sprintId: tool.schema.number()
         .optional()
@@ -313,9 +313,9 @@ export function createSubSprintListTool(client: ForLoopAPIClient) {
       try {
         const subSprints = await client.getSubSprints(resolution.sprintId)
         if (subSprints.length === 0) {
-          return `Sprint #${resolution.sprintId} has no iterations yet.`
+          return `Space #${resolution.sprintId} has no iterations yet.`
         }
-        const lines = [`Iterations for sprint #${resolution.sprintId}:`, '']
+        const lines = [`Iterations for space #${resolution.sprintId}:`, '']
         for (const s of subSprints) {
           const active = s.status === 'in_progress' ? ' ▶ ACTIVE' : ''
           lines.push(
@@ -414,7 +414,7 @@ export function createSubSprintUpdateTool(client: ForLoopAPIClient) {
 
 export function createSubSprintDeleteTool(client: ForLoopAPIClient) {
   return tool({
-    description: 'Soft-delete an iteration (sub-sprint). Linked stories retain their subSprintId and will not appear in default sprint views.',
+    description: 'Soft-delete an iteration (sub-sprint). Linked stories retain their subSprintId and will not appear in default space views.',
     args: {
       subSprintId: tool.schema.number()
         .describe('Sub-sprint ID to delete'),