improvement(devin): update tool names and add manual docs description

Author: waleedlatif1

apps/docs/content/docs/en/tools/devin.mdx

@@ -10,6 +10,28 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
   color="#12141A"
 />
 
+{/* MANUAL-CONTENT-START:intro */}
+[Devin](https://devin.ai/) is an autonomous AI software engineer by Cognition that can independently write, run, debug, and deploy code.
+
+With Devin, you can:
+
+- **Automate coding tasks**: Assign software engineering tasks and let Devin autonomously write, test, and iterate on code
+- **Manage sessions**: Create, monitor, and interact with Devin sessions to track progress on assigned tasks
+- **Guide active work**: Send messages to running sessions to provide additional context, redirect efforts, or answer questions
+- **Retrieve structured output**: Poll completed sessions for pull requests, structured results, and detailed status
+- **Control costs**: Set ACU (Autonomous Compute Unit) limits to cap spending on long-running tasks
+- **Standardize workflows**: Use playbook IDs to apply repeatable task patterns across sessions
+
+In Sim, the Devin integration enables your agents to programmatically manage Devin sessions as part of their workflows:
+
+- **Create sessions**: Kick off new Devin sessions with a prompt describing the task, optional playbook, ACU limits, and tags
+- **Get session details**: Retrieve the full state of a session including status, pull requests, structured output, and resource consumption
+- **List sessions**: Query all sessions in your organization with optional pagination
+- **Send messages**: Communicate with active or suspended sessions to provide guidance, and automatically resume suspended sessions
+
+This allows for powerful automation scenarios such as triggering code generation from upstream events, polling for completion before consuming results, orchestrating multi-step development pipelines, and integrating Devin's output into broader agent workflows.
+{/* MANUAL-CONTENT-END */}
+
 ## Usage Instructions
 
 Integrate Devin into your workflow. Create sessions to assign coding tasks, send messages to guide active sessions, and retrieve session status and results. Devin autonomously writes, runs, and tests code.
@@ -40,6 +62,7 @@ Integrate Devin into your workflow. Create sessions to assign coding tasks, send
 | `tags` | json | Session tags |
 | `pullRequests` | json | Pull requests created during the session |
 | `structuredOutput` | json | Structured output from the session |
+| `playbookId` | string | Associated playbook ID |
 | `sessions` | json | List of sessions |
 
 ### `devin_get_session`
@@ -64,6 +87,7 @@ Integrate Devin into your workflow. Create sessions to assign coding tasks, send
 | `tags` | json | Session tags |
 | `pullRequests` | json | Pull requests created during the session |
 | `structuredOutput` | json | Structured output from the session |
+| `playbookId` | string | Associated playbook ID |
 | `sessions` | json | List of sessions |
 
 ### `devin_list_sessions`
@@ -88,6 +112,7 @@ Integrate Devin into your workflow. Create sessions to assign coding tasks, send
 | `tags` | json | Session tags |
 | `pullRequests` | json | Pull requests created during the session |
 | `structuredOutput` | json | Structured output from the session |
+| `playbookId` | string | Associated playbook ID |
 | `sessions` | json | List of sessions |
 
 ### `devin_send_message`
@@ -112,6 +137,7 @@ Integrate Devin into your workflow. Create sessions to assign coding tasks, send
 | `tags` | json | Session tags |
 | `pullRequests` | json | Pull requests created during the session |
 | `structuredOutput` | json | Structured output from the session |
+| `playbookId` | string | Associated playbook ID |
 | `sessions` | json | List of sessions |
 
 

apps/sim/tools/devin/create-session.ts

@@ -7,7 +7,7 @@ export const devinCreateSessionTool: ToolConfig<
   DevinCreateSessionResponse
 > = {
   id: 'devin_create_session',
-  name: 'Devin Create Session',
+  name: 'create_session',
   description:
     'Create a new Devin session with a prompt. Devin will autonomously work on the task described in the prompt.',
   version: '1.0.0',

apps/sim/tools/devin/get-session.ts

@@ -4,7 +4,7 @@ import { DEVIN_SESSION_OUTPUT_PROPERTIES } from './types'
 
 export const devinGetSessionTool: ToolConfig<DevinGetSessionParams, DevinGetSessionResponse> = {
   id: 'devin_get_session',
-  name: 'Devin Get Session',
+  name: 'get_session',
   description:
     'Retrieve details of an existing Devin session including status, tags, pull requests, and structured output.',
   version: '1.0.0',

apps/sim/tools/devin/list-sessions.ts

@@ -2,69 +2,71 @@ import type { ToolConfig } from '@/tools/types'
 import type { DevinListSessionsParams, DevinListSessionsResponse } from './types'
 import { DEVIN_SESSION_LIST_ITEM_PROPERTIES } from './types'
 
-export const devinListSessionsTool: ToolConfig<DevinListSessionsParams, DevinListSessionsResponse> =
-  {
-    id: 'devin_list_sessions',
-    name: 'Devin List Sessions',
-    description: 'List Devin sessions in the organization. Returns up to 100 sessions by default.',
-    version: '1.0.0',
+export const devinListSessionsTool: ToolConfig<
+  DevinListSessionsParams,
+  DevinListSessionsResponse
+> = {
+  id: 'devin_list_sessions',
+  name: 'list_sessions',
+  description: 'List Devin sessions in the organization. Returns up to 100 sessions by default.',
+  version: '1.0.0',
 
-    params: {
-      apiKey: {
-        type: 'string',
-        required: true,
-        visibility: 'user-only',
-        description: 'Devin API key (service user credential starting with cog_)',
-      },
-      limit: {
-        type: 'number',
-        required: false,
-        visibility: 'user-or-llm',
-        description: 'Maximum number of sessions to return (1-200, default: 100)',
-      },
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Devin API key (service user credential starting with cog_)',
     },
-
-    request: {
-      url: (params) => {
-        const searchParams = new URLSearchParams()
-        if (params.limit) searchParams.set('first', String(Number(params.limit)))
-        const qs = searchParams.toString()
-        return `https://api.devin.ai/v3/organizations/sessions${qs ? `?${qs}` : ''}`
-      },
-      method: 'GET',
-      headers: (params) => ({
-        Authorization: `Bearer ${params.apiKey}`,
-      }),
+    limit: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Maximum number of sessions to return (1-200, default: 100)',
     },
+  },
 
-    transformResponse: async (response: Response) => {
-      const data = await response.json()
-      const items = data.items ?? []
-      return {
-        success: true,
-        output: {
-          sessions: items.map((item: Record<string, unknown>) => ({
-            sessionId: item.session_id ?? null,
-            url: item.url ?? null,
-            status: item.status ?? null,
-            statusDetail: item.status_detail ?? null,
-            title: item.title ?? null,
-            createdAt: item.created_at ?? null,
-            updatedAt: item.updated_at ?? null,
-            tags: item.tags ?? null,
-          })),
-        },
-      }
+  request: {
+    url: (params) => {
+      const searchParams = new URLSearchParams()
+      if (params.limit) searchParams.set('first', String(Number(params.limit)))
+      const qs = searchParams.toString()
+      return `https://api.devin.ai/v3/organizations/sessions${qs ? `?${qs}` : ''}`
     },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    const data = await response.json()
+    const items = data.items ?? []
+    return {
+      success: true,
+      output: {
+        sessions: items.map((item: Record<string, unknown>) => ({
+          sessionId: item.session_id ?? null,
+          url: item.url ?? null,
+          status: item.status ?? null,
+          statusDetail: item.status_detail ?? null,
+          title: item.title ?? null,
+          createdAt: item.created_at ?? null,
+          updatedAt: item.updated_at ?? null,
+          tags: item.tags ?? null,
+        })),
+      },
+    }
+  },
 
-    outputs: {
-      sessions: {
-        type: 'array',
-        description: 'List of Devin sessions',
-        items: {
-          type: 'object',
-          properties: DEVIN_SESSION_LIST_ITEM_PROPERTIES,
-        },
+  outputs: {
+    sessions: {
+      type: 'array',
+      description: 'List of Devin sessions',
+      items: {
+        type: 'object',
+        properties: DEVIN_SESSION_LIST_ITEM_PROPERTIES,
       },
     },
-  }
+  },
+}

apps/sim/tools/devin/send-message.ts

@@ -4,7 +4,7 @@ import { DEVIN_SESSION_OUTPUT_PROPERTIES } from './types'
 
 export const devinSendMessageTool: ToolConfig<DevinSendMessageParams, DevinSendMessageResponse> = {
   id: 'devin_send_message',
-  name: 'Devin Send Message',
+  name: 'send_message',
   description:
     'Send a message to a Devin session. If the session is suspended, it will be automatically resumed. Returns the updated session state.',
   version: '1.0.0',