@aifabrix/builder 2.49.2 → 2.51.0

package/templates/channels/slack/integration/slack-datasource-conversations.json

@@ -0,0 +1,226 @@
+{
+  "key": "slack-conversations",
+  "displayName": "Slack Conversations",
+  "description": "Slack conversations datasource for managing DM and channel conversations",
+  "enabled": true,
+  "systemKey": "slack",
+  "resourceType": "conversation",
+  "entityType": "messageService",
+  "version": "1.0.0",
+  "metadataSchema": {
+    "type": "object",
+    "properties": {
+      "id": {
+        "type": "string",
+        "description": "Conversation ID"
+      },
+      "name": {
+        "type": "string",
+        "description": "Conversation name"
+      },
+      "isPrivate": {
+        "type": "boolean",
+        "description": "Whether conversation is private"
+      },
+      "isIm": {
+        "type": "boolean",
+        "description": "Whether conversation is a direct message"
+      },
+      "user": {
+        "type": "string",
+        "description": "User ID (for DM conversations)"
+      },
+      "key": {
+        "type": "string",
+        "index": true
+      }
+    }
+  },
+  "fieldMappings": {
+    "attributes": {
+      "externalId": {
+        "expression": "{{raw.id}}"
+      },
+      "key": {
+        "expression": "{{raw.id}}"
+      },
+      "id": {
+        "expression": "{{raw.id}}"
+      },
+      "name": {
+        "expression": "{{raw.name}}"
+      },
+      "isPrivate": {
+        "expression": "{{raw.isPrivate}}"
+      },
+      "isIm": {
+        "expression": "{{raw.isIm}}"
+      },
+      "user": {
+        "expression": "{{raw.user}}"
+      }
+    }
+  },
+  "primaryKey": [
+    "key"
+  ],
+  "labelKey": [
+    "key"
+  ],
+  "exposed": {
+    "schema": {
+      "externalId": "metadata.externalId",
+      "key": "metadata.key",
+      "id": "metadata.id",
+      "name": "metadata.name",
+      "isPrivate": "metadata.isPrivate",
+      "isIm": "metadata.isIm",
+      "user": "metadata.user"
+    },
+    "profiles": {
+      "default": [
+        "externalId",
+        "key",
+        "id",
+        "name",
+        "isPrivate",
+        "isIm",
+        "user"
+      ]
+    }
+  },
+  "quality": {
+    "rejectIf": []
+  },
+  "execution": {
+    "engine": "cip",
+    "cip": {
+      "version": "1.0",
+      "inputType": "void",
+      "outputType": "records",
+      "operations": {
+        "create": {
+          "description": "Open a direct message conversation",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "POST",
+                "path": "/api/conversations.open",
+                "headers": {
+                  "Authorization": "Bearer {{credential.botToken}}",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "users": "{{parameters.users}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$.channel"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "list": {
+          "description": "List conversations",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "openapi",
+                "openapiRef": "list",
+                "query": {
+                  "types": "{{parameters.types | default('public_channel,private_channel,im,mpim')}}",
+                  "limit": "{{parameters.limit | default(100)}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$.channels[*]"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "get": {
+          "description": "Get conversation info",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "openapi",
+                "openapiRef": "get",
+                "query": {
+                  "channel": "{{parameters.channel}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$.channel"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        }
+      }
+    }
+  },
+  "capabilities": [
+    {
+      "key": "list",
+      "description": "List conversations",
+      "riskLevel": "low",
+      "approvalRequired": false
+    },
+    {
+      "key": "get",
+      "description": "Get conversation info",
+      "riskLevel": "low",
+      "approvalRequired": false
+    },
+    {
+      "key": "create",
+      "description": "Open a direct message conversation",
+      "riskLevel": "medium",
+      "approvalRequired": false
+    }
+  ],
+  "openapi": {
+    "operations": {
+      "list": {
+        "operationId": "get-api-conversations-list",
+        "method": "GET",
+        "path": "/api/conversations.list"
+      },
+      "get": {
+        "operationId": "get-api-conversations-info",
+        "method": "GET",
+        "path": "/api/conversations.info"
+      }
+    },
+    "enabled": true,
+    "documentKey": "slack-conversations",
+    "autoRbac": true
+  }
+}

package/templates/channels/slack/integration/slack-datasource-messages.json

@@ -0,0 +1,269 @@
+{
+  "key": "slack-messages",
+  "displayName": "Slack Messages",
+  "description": "Slack messages datasource for sending and managing messages via Slack Web API",
+  "enabled": true,
+  "systemKey": "slack",
+  "resourceType": "message",
+  "entityType": "messageService",
+  "version": "1.0.0",
+  "metadataSchema": {
+    "type": "object",
+    "properties": {
+      "channel": {
+        "type": "string",
+        "description": "Channel ID where message is sent"
+      },
+      "text": {
+        "type": "string",
+        "description": "Message text"
+      },
+      "blocks": {
+        "type": "array",
+        "description": "Message blocks (Slack Block Kit)",
+        "items": {
+          "type": "string"
+        }
+      },
+      "ts": {
+        "type": "string",
+        "description": "Message timestamp (used as message ID)"
+      },
+      "user": {
+        "type": "string",
+        "description": "User ID who sent the message"
+      },
+      "key": {
+        "type": "string",
+        "index": true
+      }
+    },
+    "required": [
+      "channel"
+    ]
+  },
+  "fieldMappings": {
+    "attributes": {
+      "externalId": {
+        "expression": "{{raw.ts}}"
+      },
+      "key": {
+        "expression": "{{raw.ts}}"
+      },
+      "channel": {
+        "expression": "{{raw.channel}}"
+      },
+      "text": {
+        "expression": "{{raw.text}}"
+      },
+      "blocks": {
+        "expression": "{{raw.blocks}}"
+      },
+      "ts": {
+        "expression": "{{raw.ts}}"
+      },
+      "user": {
+        "expression": "{{raw.user}}"
+      }
+    }
+  },
+  "primaryKey": [
+    "key"
+  ],
+  "labelKey": [
+    "key"
+  ],
+  "exposed": {
+    "schema": {
+      "externalId": "metadata.externalId",
+      "key": "metadata.key",
+      "channel": "metadata.channel",
+      "text": "metadata.text",
+      "blocks": "metadata.blocks",
+      "ts": "metadata.ts",
+      "user": "metadata.user"
+    },
+    "profiles": {
+      "default": [
+        "externalId",
+        "key",
+        "channel",
+        "text",
+        "blocks",
+        "ts",
+        "user"
+      ]
+    }
+  },
+  "quality": {
+    "rejectIf": []
+  },
+  "execution": {
+    "engine": "cip",
+    "cip": {
+      "version": "1.0",
+      "inputType": "void",
+      "outputType": "records",
+      "operations": {
+        "create": {
+          "description": "Send a message to Slack channel",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "POST",
+                "path": "/api/chat.postMessage",
+                "headers": {
+                  "Authorization": "Bearer {{credential.botToken}}",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "channel": "{{parameters.channel}}",
+                  "text": "{{parameters.text}}",
+                  "blocks": "{{parameters.blocks}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "update": {
+          "description": "Update an existing Slack message",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "POST",
+                "path": "/api/chat.update",
+                "headers": {
+                  "Authorization": "Bearer {{credential.botToken}}",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "channel": "{{parameters.channel}}",
+                  "ts": "{{parameters.ts}}",
+                  "text": "{{parameters.text}}",
+                  "blocks": "{{parameters.blocks}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "delete": {
+          "description": "Delete a Slack message",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "http",
+                "method": "POST",
+                "path": "/api/chat.delete",
+                "headers": {
+                  "Authorization": "Bearer {{credential.botToken}}",
+                  "Content-Type": "application/json"
+                },
+                "bodyTemplate": {
+                  "channel": "{{parameters.channel}}",
+                  "ts": "{{parameters.ts}}"
+                }
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        },
+        "list": {
+          "description": "Get message history from Slack channel",
+          "enabled": true,
+          "steps": [
+            {
+              "fetch": {
+                "source": "openapi",
+                "openapiRef": "list",
+                "query": {
+                  "channel": "{{parameters.channel}}",
+                  "limit": "{{parameters.limit | default(100)}}"
+                }
+              }
+            },
+            {
+              "map": {
+                "useFieldMappings": true,
+                "inputPath": "$.messages[*]"
+              }
+            },
+            {
+              "output": {
+                "mode": "records"
+              }
+            }
+          ]
+        }
+      }
+    }
+  },
+  "capabilities": [
+    {
+      "key": "list",
+      "description": "Get message history from Slack channel",
+      "riskLevel": "low",
+      "approvalRequired": false
+    },
+    {
+      "key": "create",
+      "description": "Send a message to Slack channel",
+      "riskLevel": "medium",
+      "approvalRequired": false
+    },
+    {
+      "key": "update",
+      "description": "Update an existing Slack message",
+      "riskLevel": "medium",
+      "approvalRequired": false
+    },
+    {
+      "key": "delete",
+      "description": "Delete a Slack message",
+      "riskLevel": "high",
+      "approvalRequired": false
+    }
+  ],
+  "openapi": {
+    "operations": {
+      "list": {
+        "operationId": "get-api-conversations-history",
+        "method": "GET",
+        "path": "/api/conversations.history"
+      }
+    },
+    "enabled": true,
+    "documentKey": "slack-messages",
+    "autoRbac": true
+  }
+}

package/templates/channels/slack/integration/slack-system.json

@@ -0,0 +1,144 @@
+{
+  "key": "slack",
+  "displayName": "Slack communication channel",
+  "description": "Slack communication channel — Role Assistants (workforce) and document approval workflows",
+  "type": "custom",
+  "systemKind": "communication",
+  "enabled": true,
+  "authentication": {
+    "authType": "credential",
+    "credential": {
+      "credentialKey": "slack-app",
+      "displayName": "Slack App",
+      "method": "hmac",
+      "writeOnce": true,
+      "variables": {
+        "algorithm": "sha256",
+        "signatureHeader": "X-Slack-Signature",
+        "timestampHeader": "X-Slack-Request-Timestamp",
+        "signaturePrefix": "v0=",
+        "timestampMaxAge": "300",
+        "baseUrl": "https://slack.com",
+        "testEndpoint": "https://slack.com/api/auth.test"
+      },
+      "security": {
+        "signingSecret": "kv://slack/signingSecret",
+        "botToken": "kv://slack/botToken",
+        "clientSecret": "kv://slack/clientSecret"
+      },
+      "formFields": [
+        { "name": "signingSecret", "required": true },
+        {
+          "name": "botToken",
+          "required": true,
+          "label": "Bot User OAuth Token (xoxb-)",
+          "placeholder": "xoxb-…"
+        },
+        { "name": "clientSecret", "required": false }
+      ]
+    }
+  },
+  "configuration": [
+    {
+      "name": "ENABLE_PROACTIVE_MESSAGING",
+      "value": "true",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "select",
+        "label": "Enable proactive messaging",
+        "options": ["true", "false"]
+      }
+    },
+    {
+      "name": "ENABLE_CHANNEL_NOTIFICATIONS",
+      "value": "true",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "select",
+        "label": "Enable channel notifications",
+        "options": ["true", "false"]
+      }
+    },
+    {
+      "name": "ENABLE_DIRECT_MESSAGES",
+      "value": "true",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "select",
+        "label": "Enable direct messages",
+        "options": ["true", "false"]
+      }
+    },
+    {
+      "name": "ENABLE_MODALS",
+      "value": "true",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "select",
+        "label": "Enable modals",
+        "options": ["true", "false"]
+      }
+    },
+    {
+      "name": "ENABLE_SHORTCUTS",
+      "value": "true",
+      "location": "variable",
+      "required": false,
+      "portalInput": {
+        "field": "select",
+        "label": "Enable shortcuts",
+        "options": ["true", "false"]
+      }
+    }
+  ],
+  "dataSources": ["slack-messages", "slack-conversations"],
+  "endpoints": [
+    {
+      "type": "commands",
+      "path": "/commands",
+      "router": "slack_commands_router",
+      "description": "Slack slash commands endpoint",
+      "active": true
+    },
+    {
+      "type": "events",
+      "path": "/events",
+      "router": "slack_events_router",
+      "description": "Slack Events API endpoint",
+      "active": true
+    },
+    {
+      "type": "interactive",
+      "path": "/interactive",
+      "router": "slack_interactive_router",
+      "description": "Slack interactive components endpoint",
+      "active": true
+    },
+    {
+      "type": "notifications",
+      "path": "/notifications",
+      "router": "slack_notifications_router",
+      "description": "Proactive notification endpoint",
+      "active": true
+    },
+    {
+      "type": "config",
+      "path": "/bot-config",
+      "router": "slack_config_router",
+      "description": "Slack bot configuration endpoint",
+      "active": true
+    },
+    {
+      "type": "documents",
+      "path": "/documents",
+      "router": "slack_documents_router",
+      "description": "Slack document review endpoint",
+      "active": true
+    }
+  ],
+  "endpointsActive": true
+}

package/templates/channels/slack/manifest.template.json.hbs

@@ -7,7 +7,7 @@
   "features": {
     "app_home": {
       "home_tab_enabled": true,
-      "messages_tab_enabled": false,
+      "messages_tab_enabled": true,
       "messages_tab_read_only_enabled": false
     },
     "bot_user": {
@@ -16,24 +16,34 @@
     },
     "slash_commands": [
       {
-        "command": "/aifabrix",
+        "command": "/{{commandPrefix}}-help",
         "url": "{{commandUrl}}",
-        "description": "Chat with your assistants",
-        "usage_hint": "[assistant or message]",
+        "description": "Guide to Role Assistants, work, and document review links",
         "should_escape": false
       },
       {
-        "command": "/assistants",
+        "command": "/{{commandPrefix}}-assistants",
         "url": "{{commandUrl}}",
-        "description": "Show available assistants",
+        "description": "See your Role Assistants and chat in DM",
+        "should_escape": false
+      },
+      {
+        "command": "/{{commandPrefix}}-tasks",
+        "url": "{{commandUrl}}",
+        "description": "Tasks waiting for you — View opens the Work hub",
+        "should_escape": false
+      },
+      {
+        "command": "/{{commandPrefix}}-documents",
+        "url": "{{commandUrl}}",
+        "description": "Documents waiting for review — Open in portal for full review",
+        "usage_hint": "[status] [count]",
         "should_escape": false
       }
     ]
   },
   "oauth_config": {
-    "redirect_urls": [
-      "{{oauthCallbackUrl}}"
-    ],
+    "redirect_urls": {{{slackRedirectUrlsJson}}},
     "scopes": {
       "bot": [
         "app_mentions:read",
@@ -60,7 +70,7 @@
     },
     "org_deploy_enabled": true,
     "socket_mode_enabled": false,
-    "token_rotation_enabled": true,
+    "token_rotation_enabled": {{slackTokenRotationEnabled}},
     "is_mcp_enabled": false
   }
 }