@uipath/skills 1.199.0 → 1.200.0

package/skills/uipath-coded-apps/references/oauth-scopes.md

@@ -1,6 +1,6 @@
 # OAuth Scopes Reference
 
-Required OAuth scopes for each `@uipath/uipath-typescript` SDK service and method.
+Which OAuth scopes a Coded App needs, and where to look them up.
 
 Use this reference to:
 1. Determine which scopes to include in the `scope` field of `uipath.json`
@@ -8,231 +8,44 @@ Use this reference to:
 
 **Note:** Broader scopes cover granular ones (e.g., `OR.Assets` covers `OR.Assets.Read`). Use the most specific scope that satisfies the operations the app performs.
 
-> **Update scopes WHEN you add the feature.** Any new service call — a write op (`insertRecordById`, `updateRecordById`, `deleteRecordById`), an action-causing method (`Jobs.stop`/`resume`/`restart`, `Tasks.complete`/`assign`, `ProcessInstances.cancel`, `Exchanges.createFeedback`, etc.), or a call to a service the app hasn't used before — may need a scope broader than what the current `scope` field in `uipath.json` carries. Check the tables below before shipping the feature. The External Application registration must also allow the scope; if not, the token request is rejected entirely (see [oauth-client-setup.md](oauth-client-setup.md)).
+> **Update scopes WHEN you add the feature.** Any new service call — a write op, an action-causing method (`Jobs.stop`/`resume`/`restart`, `Tasks.complete`/`assign`, `ProcessInstances.cancel`, `Exchanges.createFeedback`, etc.), or a call to a service the app hasn't used before — may need a scope broader than what the current `scope` field in `uipath.json` carries. Look up the method's scope (below) before shipping the feature. The External Application registration must also allow the scope; if not, the token request is rejected entirely (see [oauth-client-setup.md](oauth-client-setup.md)).
 
----
+## Per-method scope lookup
 
-## Assets
+The per-method scope table ships **inside the SDK package**. Read the installed copy — it is version-exact and offline:
 
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Assets` or `OR.Assets.Read` |
-| `getById()` | `OR.Assets` or `OR.Assets.Read` |
-| `getByName()` | `OR.Assets` or `OR.Assets.Read` |
+`node_modules/@uipath/uipath-typescript/docs/oauth-scopes.md`
 
----
+Required scopes can change between SDK versions, so read the installed copy rather than a CDN `@latest` that may not match the installed version. If the installed SDK predates the file, upgrade the SDK. This skill deliberately does NOT duplicate the per-method table.
 
-## Jobs
+What the shipped table does NOT cover (skill knowledge, below): widget scopes and the task-level bundles.
 
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Jobs` or `OR.Jobs.Read` |
-| `getById()` | `OR.Jobs` or `OR.Jobs.Read` |
-| `getOutput()` | `OR.Jobs` or `OR.Jobs.Read` **plus** `OR.Folders` or `OR.Folders.Read` (required because `getOutput` internally calls the Attachments API to resolve file-type output arguments) |
-| `stop()` | `OR.Jobs` |
-| `resume()` | `OR.Jobs` or `OR.Jobs.Write` |
-| `restart()` | `OR.Jobs` |
-
----
-
-## Attachments
-
-| Method | Required Scope |
-|--------|----------------|
-| `getById()` | `OR.Folders` or `OR.Folders.Read` |
-
----
-
-## Buckets
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Buckets` or `OR.Buckets.Read` |
-| `getById()` | `OR.Buckets` or `OR.Buckets.Read` |
-| `getByName()` | `OR.Buckets` or `OR.Buckets.Read` |
-| `getFiles()` | `OR.Buckets` or `OR.Buckets.Read` |
-| `getFileMetaData()` | `OR.Buckets` or `OR.Buckets.Read` |
-| `getReadUri()` | `OR.Buckets` or `OR.Buckets.Read` |
-| `uploadFile()` | `OR.Buckets` |
-| `deleteFile()` | `OR.Buckets` or `OR.Buckets.Write` |
-
----
-
-## Entities (Data Fabric)
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `DataFabric.Schema.Read` |
-| `getById()` | `DataFabric.Schema.Read` |
-| `getAllRecords()` | `DataFabric.Data.Read` |
-| `getRecordById()` / `getRecord()` | `DataFabric.Data.Read` |
-| `insertRecordById()` / `insertRecord()` | `DataFabric.Data.Write` |
-| `insertRecordsById()` / `insertRecords()` | `DataFabric.Data.Write` |
-| `deleteRecordsById()` / `deleteRecords()` | `DataFabric.Data.Write` |
-| `deleteRecordById()` / `deleteRecord()` | `DataFabric.Data.Write` |
-| `updateRecordById()` / `updateRecord()` | `DataFabric.Data.Write` |
-| `updateRecordsById()` / `updateRecords()` | `DataFabric.Data.Write` |
-| `queryRecordsById()` / `queryRecords()` | `DataFabric.Data.Read` |
-| `downloadAttachment()` | `DataFabric.Data.Read` |
-| `uploadAttachment()` | `DataFabric.Data.Write` |
-| `deleteAttachment()` | `DataFabric.Data.Write` |
-
----
-
-## ChoiceSets (Data Fabric)
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `DataFabric.Schema.Read` |
-| `getById()` | `DataFabric.Data.Read` |
-
----
-
-## Processes
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Execution` or `OR.Execution.Read` |
-| `getById()` | `OR.Execution` or `OR.Execution.Read` |
-| `getByName()` | `OR.Execution` or `OR.Execution.Read` |
-| `start()` | `OR.Jobs` or `OR.Jobs.Write` |
-
----
-
-## Queues
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Queues` or `OR.Queues.Read` |
-| `getById()` | `OR.Queues` or `OR.Queues.Read` |
-
----
-
-## Tasks (Orchestrator)
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Tasks` or `OR.Tasks.Read` |
-| `getById()` | `OR.Tasks` or `OR.Tasks.Read` |
-| `getUsers()` | `OR.Tasks` or `OR.Tasks.Read` |
-| `create()` | `OR.Tasks` or `OR.Tasks.Write` |
-| `assign()` / `reassign()` / `unassign()` | `OR.Tasks` or `OR.Tasks.Write` |
-| `complete()` | `OR.Tasks` or `OR.Tasks.Write` |
-
----
-
-## Maestro Process Instances
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `PIMS` |
-| `getById()` | `PIMS` |
-| `getExecutionHistory()` | `PIMS` |
-| `getBpmn()` | `OR.Execution.Read` |
-| `getVariables()` | `PIMS` |
-| `getIncidents()` | `PIMS` |
-| `cancel()` / `pause()` / `resume()` | `PIMS` |
-
-## Maestro Processes
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `PIMS` |
-| `getIncidents()` | `PIMS` |
-| `getInstanceStatusTimeline()` | `Insights.RealTimeData Insights OR.Folders.Read` |
-| `getTopRunCount()` / `getTopFaultedCount()` / `getTopExecutionDuration()` | `Insights.RealTimeData Insights OR.Folders.Read` |
-
-## Maestro Process Incidents (standalone)
-
-| Method | Required Scope |
-|--------|----------------|
-| `ProcessIncidents.getAll()` | `PIMS` |
-
----
-
-## Cases
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `PIMS` |
-| `getInstanceStatusTimeline()` | `Insights.RealTimeData Insights OR.Folders.Read` |
-| `getTopRunCount()` / `getTopFaultedCount()` / `getTopExecutionDuration()` | `Insights.RealTimeData Insights OR.Folders.Read` |
-
-## Case Instances
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `PIMS` and `OR.Execution.Read` |
-| `getById()` | `PIMS` and `OR.Execution.Read` |
-| `getStages()` | `PIMS` and `OR.Execution.Read` |
-| `close()` / `pause()` / `resume()` / `reopen()` | `PIMS` |
-| `getExecutionHistory()` | `PIMS` |
-| `getActionTasks()` | `OR.Tasks` or `OR.Tasks.Read` |
-| `getSlaSummary()` / `getStagesSlaSummary()` | `Insights.RealTimeData Insights OR.Folders.Read PIMS` |
-
----
-
-## Conversational Agent
-
-Combined scopes required: `OR.Execution` · `OR.Folders` · `OR.Jobs` · `ConversationalAgents` · `Traces.Api`
-
-### Agents
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `OR.Execution` or `OR.Execution.Read` |
-| `getById()` | `OR.Execution` or `OR.Execution.Read` |
-
-### Conversations
-
-| Method | Required Scope |
-|--------|----------------|
-| `create()` | `OR.Execution`, `OR.Folders`, `OR.Jobs` |
-| `getAll()` / `getById()` | `OR.Execution.Read`, `OR.Jobs.Read` |
-| `updateById()` / `deleteById()` | `OR.Execution`, `OR.Jobs` |
-| `startSession()` | `OR.Execution`, `OR.Jobs`, `ConversationalAgents` |
-| `uploadAttachment()` / `getAttachmentUploadUri()` | `OR.Execution`, `OR.Jobs` |
-
-### Exchanges
-
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` / `getById()` | `OR.Execution.Read`, `OR.Jobs.Read` |
-| `createFeedback()` | `OR.Execution`, `OR.Jobs`, `Traces.Api` |
-
-### Messages
-
-| Method | Required Scope |
-|--------|----------------|
-| `getById()` / `getContentPartById()` | `OR.Execution.Read`, `OR.Jobs.Read` |
-
-### User Settings (`conversationalAgent.user`)
-
-| Method | Required Scope |
-|--------|----------------|
-| `getSettings()` | `OR.Users` or `OR.Users.Read` |
-| `updateSettings()` | `OR.Users` |
-
----
-
-## Agent Feedback
+## Common Scope Bundles
 
-| Method | Required Scope |
-|--------|----------------|
-| `getAll()` | `Traces.Api` |
-| `getById()` | `Traces.Api` |
-| `getCategories()` | `Traces.Api` |
-| `submit()` | `Traces.Api` |
-| `updateById()` | `Traces.Api` |
-| `deleteById()` | `Traces.Api` |
-| `createCategory()` | `Traces.Api` |
-| `deleteCategory()` | `Traces.Api` |
+Task-level bundles — what to put in the `uipath.json` `scope` field for a given feature set. Start here; consult the per-method table for methods outside these bundles.
 
----
+| App uses... | Minimum scopes needed |
+|---|---|
+| Orchestrator Assets (read) | `OR.Assets.Read` (`OR.Assets` to also write asset values) |
+| Orchestrator Queues (read) | `OR.Queues.Read` |
+| Orchestrator Buckets (read + upload) | `OR.Buckets` (read-only browsing: `OR.Buckets.Read`) |
+| Orchestrator Attachments (read) | `OR.Folders.Read` |
+| Orchestrator Tasks (read + complete) | `OR.Tasks` |
+| Orchestrator Processes (list + start) | `OR.Execution OR.Jobs` |
+| Orchestrator Jobs (list + read output) | `OR.Jobs.Read OR.Folders.Read` (add `OR.Folders.Read` so `Jobs.getOutput()` can resolve file-type output arguments via Attachments) |
+| Data Fabric (read-only) | `DataFabric.Schema.Read DataFabric.Data.Read` |
+| Data Fabric (read + write) | `DataFabric.Schema.Read DataFabric.Data.Read DataFabric.Data.Write` |
+| Maestro full access | `PIMS OR.Execution.Read` |
+| Maestro analytics / insights dashboards (top run/fault/duration counts, status timelines, SLA) | add `Insights.RealTimeData Insights OR.Folders.Read` (SLA summaries also need `PIMS`) |
+| Conversational Agent | `OR.Execution OR.Folders OR.Jobs ConversationalAgents Traces.Api` (add `OR.Users` for user-settings read/write) |
+| Agent Feedback | `Traces.Api` (every method) |
+| Insights RTM (Agents, Agent Traces, Agent Memory, Governance, Maestro Insights) | `Insights Insights.RealTimeData OR.Folders.Read` |
+| Maestro SLA (CaseInstances SLA summary) | `Insights Insights.RealTimeData OR.Folders.Read PIMS` |
+| Generic trace spans (`Traces.getById` / `getSpansByIds`) | `Traces.Api` (+ `Insights Insights.RealTimeData`) |
 
 ## Widgets
 
-Scopes required by `@uipath/ui-widgets-*` React components. The widget's own runtime API calls are listed here — add scopes from the sections above for any additional SDK calls the host app makes.
+Scopes required by `@uipath/ui-widgets-*` React components. The widget's own runtime API calls are listed here — add scopes from the per-method table for any additional SDK calls the host app makes.
 
 ### Validation Station (`@uipath/ui-widgets-validation-station`)
 
@@ -247,60 +60,3 @@ See [widgets/validation-station.md](widgets/validation-station.md) for the full
 > - `@uipath/ui-widgets-conversational-agent-chat`
 > - `@uipath/ui-widgets-datatable`
 > - `@uipath/ui-widgets-multi-file-upload`
-
----
-
-## Agents — Insights RTM (SDK ≥ 1.4.1)
-
-| Method | Required Scope |
-|--------|----------------|
-| `Agents.getAll()` / `getErrors()` | `Insights` and `Insights.RealTimeData` |
-| `Agents.getErrorsTimeline()` / `getConsumptionTimeline()` / `getLatencyTimeline()` | `Insights` and `Insights.RealTimeData` |
-
-## Agent Traces (SDK ≥ 1.4.1)
-
-| Method | Required Scope |
-|--------|----------------|
-| `AgentTraces.getErrorsTimeline()` / `getLatencyTimeline()` / `getUnitConsumption()` | `Insights` and `Insights.RealTimeData` |
-| `AgentTraces.getSpansByTraceId()` / `getSpansByReference()` | `Insights` and `Insights.RealTimeData` |
-| `Traces.getById()` / `getSpansByIds()` (generic spans — governance traces) | `Traces.Api` (+ `Insights` and `Insights.RealTimeData`) |
-
-## Agent Memory (SDK ≥ 1.4.1)
-
-| Method | Required Scope |
-|--------|----------------|
-| `AgentMemory.getTimeline()` / `getCallsTimeline()` / `getTopSpaces()` | `Insights` and `Insights.RealTimeData` |
-
-## Governance (SDK ≥ 1.4.1)
-
-| Method | Required Scope |
-|--------|----------------|
-| `Governance.getPolicyTraces()` / `getOperationSummary()` | `Insights` and `Insights.RealTimeData` — caller needs elevated (org-admin) access; `fullOrganization: true` returns 403 without org-admin |
-
-## Maestro Insights — RTM (SDK ≥ 1.4.x)
-
-These use the Insights RTM host (`INSIGHTS_RTM_BASE`). The SLA methods also touch PIMS-backed case data and require `PIMS` on top of the Insights scopes.
-
-| Method | Required Scope |
-|--------|----------------|
-| `Cases` / `MaestroProcesses` `.getTopRunCount()` / `getTopFaultedCount()` / `getTopExecutionDuration()` / `getTopElementFailedCount()` / `getInstanceStatusTimeline()` / `getElementStats()` | `Insights` · `Insights.RealTimeData` · `OR.Folders.Read` |
-| `CaseInstances.getSlaSummary()` / `getStagesSlaSummary()` | `Insights` · `Insights.RealTimeData` · `OR.Folders.Read` · **`PIMS`** |
-
-> All Insights RTM methods (Agents, Agent Traces, Agent Memory, Governance, Maestro Insights above) also require `OR.Folders.Read` — covered by the granted `OR.Folders`. `Cases.getAll` / `CaseInstances.getAll` (PIMS host, not Insights) require `PIMS` — see the Maestro sections above.
-
----
-
-## Common Scope Bundles
-
-| App uses... | Minimum scopes needed |
-|---|---|
-| Data Fabric (read-only) | `DataFabric.Schema.Read DataFabric.Data.Read` |
-| Data Fabric (read + write) | `DataFabric.Schema.Read DataFabric.Data.Read DataFabric.Data.Write` |
-| Orchestrator Tasks (read + complete) | `OR.Tasks` |
-| Orchestrator Processes (list + start) | `OR.Execution OR.Jobs` |
-| Orchestrator Jobs (list + read output) | `OR.Jobs.Read OR.Folders.Read` (add `OR.Folders.Read` so `Jobs.getOutput()` can resolve file-type output arguments via Attachments) |
-| Maestro full access | `PIMS OR.Execution.Read` |
-| Maestro analytics / insights dashboards (top run/fault/duration counts, status timelines, SLA) | add `Insights.RealTimeData Insights OR.Folders.Read` (SLA summaries also need `PIMS`) |
-| Conversational Agent | `OR.Execution OR.Folders OR.Jobs ConversationalAgents Traces.Api` (add `OR.Users` for user-settings read/write) |
-| Insights RTM (Agents, Agent Traces, Agent Memory, Governance, Maestro Insights) | `Insights Insights.RealTimeData OR.Folders.Read` |
-| Maestro SLA (CaseInstances SLA summary) | `Insights Insights.RealTimeData OR.Folders.Read PIMS` |

package/skills/uipath-coded-apps/references/sdk/action-center.md

@@ -1,135 +1,48 @@
-# Action Center Reference
+# Action Center (Tasks) — Traps & Server Behavior
 
-## Import
+Signatures/params/examples: `dist/tasks/index.d.ts`. Per-method scopes: shipped `docs/oauth-scopes.md`. This file covers only what neither can express.
 
-```typescript
-import { Tasks } from '@uipath/uipath-typescript/tasks';
-```
-
-## Scopes
-
-- Read: `OR.Tasks` or `OR.Tasks.Read`
-- Write: `OR.Tasks` or `OR.Tasks.Write`
-
-## Types to Import
-
-```typescript
-import type {
-  TaskGetResponse,
-  RawTaskGetResponse,
-  TaskCreateResponse,
-  RawTaskCreateResponse,
-  TaskMethods,
-  TaskCreateOptions,
-  TaskGetAllOptions,
-  TaskGetByIdOptions,
-  TaskGetUsersOptions,
-  TaskAssignOptions,
-  TaskAssignmentOptions,
-  TaskAssignmentResponse,
-  TaskCompleteOptions,
-  TaskCompletionOptions,
-  UserLoginInfo,
-  TaskSlaDetail,
-  TaskAssignment,
-  TaskActivity,
-  Tag,
-  TaskSource,
-} from '@uipath/uipath-typescript/tasks';
-```
-
-## Enums
-
-```typescript
-import {
-  TaskType,          // Form, External, App, DocumentValidation, DocumentClassification, DataLabeling
-  TaskPriority,      // Low, Medium, High, Critical
-  TaskStatus,        // Unassigned, Pending, Completed
-  TaskSlaStatus,     // OverdueLater, OverdueSoon, Overdue, CompletedInTime
-  TaskSlaCriteria,   // TaskCreated, TaskAssigned, TaskCompleted
-  TaskActivityType,  // Created, Assigned, Reassigned, Unassigned, Saved, Forwarded, Completed, Commented, Deleted, BulkSaved, BulkCompleted, FirstOpened
-  TaskSourceName,    // Agent, Workflow, Maestro, Default
-} from '@uipath/uipath-typescript/tasks';
-```
+## Traps
 
-`TaskType` string values:
+### `create()` only makes External tasks
 
-| Member | API string | Notes |
-|--------|------------|-------|
-| `TaskType.Form` | `'FormTask'` | Renders a UiPath form layout |
-| `TaskType.External` | `'ExternalTask'` | Externally managed task |
-| `TaskType.App` | `'AppTask'` | Powered by a UiPath App |
-| `TaskType.DocumentValidation` | `'DocumentValidationTask'` | DU validation — owned by the Validation Station widget. See [../widgets/validation-station.md](../widgets/validation-station.md) |
-| `TaskType.DocumentClassification` | `'DocumentClassificationTask'` | DU classification task |
-| `TaskType.DataLabeling` | `'DataLabelingTask'` | Training-data annotation task |
+The server accepts only `TaskType.External` from `create()`. Form and App tasks are created by the system through workflows.
 
-## Tasks Service
+### Form task hydration
 
-### create(options: TaskCreateOptions, folderId: number)
+When `getById` hits the Form-specific endpoint (`taskType: TaskType.Form`), the SDK silently adds `expandOnFormLayout: true` so `formLayout` is populated — you don't pass it yourself.
 
-Returns `Promise<TaskCreateResponse>` (task data with attached methods). Options: `{ title: string, data?: Record<string, unknown>, priority?: TaskPriority }`. The `folderId` is required.
+### OData filtering — server-side field names
 
-**Note:** `create()` only supports creating External tasks (`TaskType.External`). Form tasks and App tasks are created by the system through workflows.
-
-### getAll(options?: TaskGetAllOptions)
-
-Returns `NonPaginatedResponse<TaskGetResponse>` or `PaginatedResponse<TaskGetResponse>`. Options extend `RequestOptions & PaginationOptions & { folderId?: number, asTaskAdmin?: boolean }`. Supports `filter`, `orderby`, `expand`, `select`, pagination.
-
-### getById(id: number, options?: TaskGetByIdOptions, folderId?: number)
-
-Returns `Promise<TaskGetResponse>` with attached methods.
-
-`TaskGetByIdOptions.taskType` is an optimization. Without it, the SDK issues a generic GET, inspects `type`, then issues a second type-specific GET. With it, the SDK skips the discovery call and goes straight to the type-specific endpoint — **`folderId` then becomes required** (throws `ValidationError` otherwise). Use for any non-`External` task when you already know the type:
-
-```typescript
-// Faster — single round-trip. Required pattern for Validation Station hydration.
-const dvTask = await tasks.getById(taskId, { taskType: TaskType.DocumentValidation }, folderId);
-```
-
-For `TaskType.Form`, the SDK auto-adds `expandOnFormLayout: true` so `formLayout` is populated.
-
-`TaskGetResponse` key fields: `id`, `title`, `status`, `type`, `priority`, `folderId`, `key`, `data`, `isDeleted`, `isCompleted`, `createdTime`, `assignedToUser`, `formLayout` (form tasks), `taskAssignments`, `activities`, `tags`, `taskSource`, `parentOperationId`, `externalTag`.
-
-**OData filtering:** `TaskGetAllOptions` supports `filter` (OData `$filter` string) and `orderby` for server-side filtering and sorting. Examples:
+`filter` / `orderby` take raw server-side field names (not derivable from the `filter?: string` type):
 - Pending tasks only: `filter: "Status ne 'Completed'"`
 - By external tag: `filter: "ExternalTag eq 'some-value'"`
 - Combined: `filter: "Status ne 'Completed' and ExternalTag eq 'some-value'"`
 
-### getUsers(folderId: number, options?: TaskGetUsersOptions)
-
-Returns `NonPaginatedResponse<UserLoginInfo>` or `PaginatedResponse<UserLoginInfo>`. Each user has: `name`, `surname`, `userName`, `emailAddress`, `displayName`, `id`.
+### Completing tasks
 
-### assign(options: TaskAssignmentOptions | TaskAssignmentOptions[])
+When you already hold a `TaskGetResponse`, use the task-attached `task.complete(...)` over the service `tasks.complete(...)` — no `taskId` / `folderId` to thread through.
 
-Returns `Promise<OperationResponse<TaskAssignmentOptions[] | TaskAssignmentResponse[]>>`. Each assignment requires `taskId` and either `userId` or `userNameOrEmail`.
+**`TaskCompleteOptions` is a discriminated union on `type` — NEVER use conditional spread.** TypeScript cannot narrow the union through `...(condition ? { data: {} } : {})` (TS2345). Always branch explicitly:
 
-### reassign(options: TaskAssignmentOptions | TaskAssignmentOptions[])
-
-Same signature as assign. Reassigns tasks to new users.
-
-### unassign(taskId: number | number[])
-
-Returns `Promise<OperationResponse<{ taskId: number }[] | TaskAssignmentResponse[]>>`. Accepts single ID or array.
-
-### complete(options: TaskCompletionOptions, folderId: number)
-
-Returns `Promise<OperationResponse<TaskCompletionOptions>>`. The `folderId` is required.
-
-`TaskCompletionOptions` is a discriminated union on `type`:
-- `External`, `DocumentValidation`, `DocumentClassification`, `DataLabeling`: `{ type, taskId, data?, action? }` — both `data` and `action` optional. Routes to the generic complete endpoint.
-- `Form`: `{ type: TaskType.Form, taskId, data, action }` — both required. Routes to the form-task endpoint.
-- `App`: `{ type: TaskType.App, taskId, data, action }` — both required. Routes to the app-task endpoint.
+```typescript
+const handleTaskAction = async (task: TaskGetResponse, action: 'approve' | 'reject') => {
+  const actionLabel = action === 'approve' ? 'Approve' : 'Reject';
 
-## Task-Attached Methods (TaskMethods)
+  if (task.type === TaskType.External) {
+    await task.complete({ type: TaskType.External, action: actionLabel });
+  } else {
+    // Form and App tasks require data and action
+    await task.complete({ type: task.type, action: actionLabel, data: {} });
+  }
+};
+```
 
-Returned by `getAll()`, `getById()`, and `create()` on each task:
+### Action strings
 
-- `task.assign(options: TaskAssignOptions)` -> requires `{ userId }` or `{ userNameOrEmail }`
-- `task.reassign(options: TaskAssignOptions)` -> same options as assign
-- `task.unassign()` -> no arguments needed, uses the task's own ID
-- `task.complete(options: TaskCompleteOptions)` -> `{ type, data?, action? }` (no taskId needed, uses own ID)
+`action` is free-form and must match what the workflow designer configured. If `task.action` is set, that's the expected string. Common patterns: `'Approve'` / `'Reject'`, `'Submit'`. Maestro HITL tasks are typically `TaskType.App` or `TaskType.External`; pass `data: {}` for App tasks with no form data.
 
-`TaskAssignOptions` type: `{ userId: number } | { userNameOrEmail: string }` (mutually exclusive).
+For `TaskType.DocumentValidation`, the Validation Station widget owns the data contract — call `task.complete({ type: TaskType.DocumentValidation, action: 'Completed' })` from `onSaveComplete`. Do NOT pass `data` yourself; the widget already uploaded the validated payload to the bucket before firing the callback. See [../widgets/validation-station.md](../widgets/validation-station.md).
 
 ## Linking Tasks to Maestro Process Instances
 
@@ -155,92 +68,6 @@ const pendingTask = result.items.find(t => !t.isCompleted) ?? null;
 
 **IMPORTANT:** There is NO shortcut from `latestRunStatus` — a process waiting on HITL still shows as `"Running"`. Always use `getVariables()` + `getBpmn()` to detect HITL first, then use the `CreatorJobKey` filter to get the task details.
 
-## Completing Tasks — Detailed Patterns
-
-### Prefer task-attached `complete()` over service `complete()`
-
-When you already have a `TaskGetResponse` from `getAll()` or `getById()`, **always use the task-attached method** — it's simpler because it doesn't need `taskId` or `folderId`:
-
-```typescript
-// PREFERRED — task-attached method (no taskId, no folderId needed)
-await task.complete({ type: task.type as TaskType, action: 'Approve', data: {} });
-
-// AVOID — service method (requires both taskId and folderId)
-await tasks.complete({ type: TaskType.External, taskId: task.id, action: 'Approve' }, folderId);
-```
-
-### Task type discrimination — use the enum, don't compare strings
-
-The `task.type` field on `TaskGetResponse` is a `TaskType` enum value. **Always use the enum for comparison and when passing to `complete()`:**
-
-```typescript
-import { TaskType } from '@uipath/uipath-typescript/tasks';
-
-// CORRECT — use the enum directly from the task
-await task.complete({
-  type: task.type as TaskType,  // Already a TaskType value
-  action: actionLabel,
-  data: task.type === TaskType.External ? undefined : {},
-});
-
-// WRONG — comparing against string literals
-if (task.type === 'FormTask') { ... }  // Don't do this
-```
-
-### `TaskCompleteOptions` discriminated union
-
-The `type` field determines which other fields are required:
-
-| Task Type | `data` | `action` | Example |
-|-----------|--------|----------|---------|
-| `TaskType.External` | Optional | Optional | `{ type: TaskType.External, action: 'Approve' }` |
-| `TaskType.DocumentValidation` | Optional | Optional | `{ type: TaskType.DocumentValidation, action: 'Completed' }` |
-| `TaskType.DocumentClassification` | Optional | Optional | `{ type: TaskType.DocumentClassification, action: 'Completed' }` |
-| `TaskType.DataLabeling` | Optional | Optional | `{ type: TaskType.DataLabeling, action: 'Completed' }` |
-| `TaskType.Form` | **Required** | **Required** | `{ type: TaskType.Form, action: 'Submit', data: formData }` |
-| `TaskType.App` | **Required** | **Required** | `{ type: TaskType.App, action: 'Approve', data: {} }` |
-
-For Maestro HITL tasks (approve/reject flows), tasks are typically `TaskType.App` or `TaskType.External`. Pass `data: {}` (empty object) for App tasks when there's no form data to submit.
-
-For `TaskType.DocumentValidation`, the Validation Station widget owns the data contract — call `task.complete({ type: TaskType.DocumentValidation, action: 'Completed' })` from `onSaveComplete`. Do NOT pass `data` yourself; the widget already uploaded the validated payload to the bucket before firing the callback. See [../widgets/validation-station.md](../widgets/validation-station.md).
-
-### Action strings
-
-The `action` parameter is a free-form string that maps to the workflow's expected action. Common patterns:
-- **Approve/Reject**: `action: 'Approve'` or `action: 'Reject'`
-- **Submit**: `action: 'Submit'`
-- **Custom**: whatever the workflow designer configured
-
-If the task has an `action` field set (`task.action`), that's the expected action string. For tasks with multiple possible actions (approve/reject), pass the action corresponding to the user's choice.
-
-### Complete pattern for HITL approve/reject
-
-**IMPORTANT:** `TaskCompleteOptions` is a discriminated union on `type`. TypeScript cannot narrow the union when you use conditional spreads like `...(condition ? { data: {} } : {})`. **Always use explicit if/else branching:**
-
-```typescript
-const handleTaskAction = async (task: TaskGetResponse, action: 'approve' | 'reject') => {
-  const actionLabel = action === 'approve' ? 'Approve' : 'Reject';
-
-  // Branch by type — TypeScript narrows the discriminated union correctly
-  if (task.type === TaskType.External) {
-    await task.complete({ type: TaskType.External, action: actionLabel });
-  } else {
-    // Form and App tasks require data and action
-    await task.complete({ type: task.type, action: actionLabel, data: {} });
-  }
-};
-```
-
-**NEVER use conditional spread for discriminated unions:**
-```typescript
-// WRONG — TS2345: TypeScript can't narrow the union through a spread
-await task.complete({
-  type: task.type as TaskType,
-  action: actionLabel,
-  ...(task.type !== TaskType.External ? { data: {} } : {}),  // Breaks type narrowing
-});
-```
-
 ### If no task is found — show an error, don't widen the search
 
 **NEVER fall back to "pick the first pending task" or "pick any Maestro task" if the `CreatorJobKey` filter returns no results.** This risks completing the wrong task. Instead:
@@ -258,47 +85,3 @@ if (!pendingTask) {
   return;
 }
 ```
-
-## Usage Example
-
-```typescript
-import { useMemo, useEffect, useState } from 'react';
-import { useAuth } from '../hooks/useAuth';
-import { Tasks } from '@uipath/uipath-typescript/tasks';
-import { TaskType, TaskPriority } from '@uipath/uipath-typescript/tasks';
-import type { TaskGetResponse } from '@uipath/uipath-typescript/tasks';
-
-function TaskInbox({ folderId }: { folderId: number }) {
-  const { sdk } = useAuth();
-  const tasks = useMemo(() => new Tasks(sdk), [sdk]);
-  const [taskList, setTaskList] = useState<TaskGetResponse[]>([]);
-
-  useEffect(() => {
-    const load = async () => {
-      const result = await tasks.getAll({ folderId, pageSize: 20 });
-      setTaskList(result.items);
-    };
-    load();
-  }, [tasks, folderId]);
-
-  // Use task-attached complete — no taskId or folderId needed
-  const handleComplete = async (task: TaskGetResponse, action: string) => {
-    if (task.type === TaskType.External) {
-      await task.complete({ type: TaskType.External, action });
-    } else {
-      await task.complete({ type: task.type, action, data: {} });
-    }
-  };
-
-  const handleAssign = async (task: TaskGetResponse, userId: number) => {
-    await task.assign({ userId });
-  };
-
-  const handleCreate = async () => {
-    const newTask = await tasks.create({
-      title: 'Review document',
-      priority: TaskPriority.Medium,
-    }, folderId);
-  };
-}
-```