@devrev-computer/skills 1.0.0

package/skills/create-workflow-template/operations/schemas/opportunity_updated.md

@@ -0,0 +1,124 @@
+# `opportunity_updated` — Schema Reference
+
+## Input Port: `input`
+
+- **`fields_to_watch`** (`[]enum`) **REQUIRED** — Fields to watch for changes. The trigger will only be fired if any of these fields are updated.
+  - Allowed: `account`, `actual_close_date`, `annual_contract_value`, `body`, `contacts`, `owned_by`, `stage`, `tags`, `target_close_date`, `title`... (11 total)
+
+## Output Port: `output`
+
+- **`id`** (`id`) **REQUIRED** — The opportunity which was updated.
+  - ID type: `opportunity`
+- **`body`** (`text`) — The description of the opportunity.
+- **`created_date`** (`timestamp`) — Timestamp when the opportunity was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`modified_date`** (`timestamp`) — Timestamp when the opportunity was last modified.
+- **`stage`** (`composite`) — Describes the current stage of a opportunity
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) **REQUIRED** — Describes the current stage of a opportunity
+- **`target_close_date`** (`timestamp`) — Timestamp when the opportunity is expected to be closed.
+- **`title`** (`text`) **REQUIRED** — Title of the opportunity.
+- **`account`** (`composite`)
+  - Composite: `_gen:account`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`id`** (`id`) **REQUIRED** — The id of the account.
+    - ID type: `account`
+- **`actual_close_date`** (`timestamp`) — Timestamp when the opportunity was actually closed.
+- **`annual_contract_value`** (`composite`) — Annual contract value of an opportunity in USD
+  - Composite: `_gen:annual_contract_value`
+  - **`amount`** (`text`) — Amount of the money.
+  - **`currency`** (`text`) — Currency of the money.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`old_opportunity`** (`composite`) — Old opportunity object
+  - Composite: `_gen:implicit:opportunity`
+  - **`account`** (`composite`)
+    - Composite: `_gen:account`
+  - **`actual_close_date`** (`timestamp`) — Timestamp when the opportunity was actually closed
+  - **`annual_contract_value`** (`composite`) — Money.
+    - Composite: `_gen:annual_contract_value`
+  - **`body`** (`text`) — Body of the opportunity
+  - **`created_by`** (`composite`)
+    - Composite: `_gen:created_by`
+  - **`created_date`** (`timestamp`) — Timestamp when the opportunity was created.
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+  - **`modified_by`** (`composite`)
+    - Composite: `_gen:modified_by`
+  - **`modified_date`** (`timestamp`) — Timestamp when the opportunity was last modified.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`reported_by`** (`[]composite`)
+    - Composite: `_gen:user-summary`
+  - **`stage`** (`composite`) — Describes the current stage of a opportunity
+    - Composite: `_gen:stage`
+  - **`state_display_name`** (`text`) — Display name for current state.
+  - **`tags`** (`[]composite`) — Tags associated with the opportunity
+    - Composite: `_gen:tags`
+  - **`target_close_date`** (`timestamp`) — Timestamp when the opportunity is expected to be closed
+  - **`title`** (`text`) **REQUIRED** — Title of the opportunity
+  - **`value`** (`composite`) — Money.
+    - Composite: `_gen:value`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `opportunity`
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`reported_by`** (`[]composite`)
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`value`** (`composite`) — The value of the opportunity in USD.
+  - Composite: `_gen:value`
+  - **`amount`** (`text`) — Amount of the money.
+  - **`currency`** (`text`) — Currency of the money.

package/skills/create-workflow-template/operations/schemas/pick_user.md

@@ -0,0 +1,16 @@
+# `pick_user` — Schema Reference
+
+Picks a user from a group or list of users based on the given strategy (e.g., round robin).
+
+## Input Port: `input`
+
+Schema is **dynamic** (Overridden by schema handler). Typically includes:
+- The group or list of users to pick from.
+- The selection strategy (e.g., round robin).
+
+## Output Port: `output`
+
+Schema is **dynamic** (Overridden by schema handler). Typically includes:
+- The selected user ID.
+
+> **Note:** Both input and output schemas are managed by the schema handler at design time.

package/skills/create-workflow-template/operations/schemas/question_answer_created.md

@@ -0,0 +1,44 @@
+# `question_answer_created` — Schema Reference
+
+## Input Port: `input`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `output`
+
+- **`answer`** (`text`) — The Answer.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_date`** (`timestamp`) — Timestamp when the QA was created.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`modified_date`** (`timestamp`) — Timestamp when the QA was modified.
+- **`question`** (`text`) — The Question.
+- **`status`** (`enum`) — Status of the question answer.
+  - Allowed: `archived`, `discarded`, `draft`, `published`, `review_needed`
+- **`suggested_answer`** (`text`) — An alternative answer suggested by the QA generation algorithm.
+- **`suggested_for_deletion`** (`bool`) — Whether the QA was marked for deletion by the QA generation algorithm.
+- **`topic`** (`text`) — The topic to which the QA belongs.
+- **`verified`** (`bool`) — Whether the QA was verified.
+- **`id`** (`id`) **REQUIRED** — The ID of the created QA.
+  - ID type: `question_answer`

package/skills/create-workflow-template/operations/schemas/question_answer_updated.md

@@ -0,0 +1,75 @@
+# `question_answer_updated` — Schema Reference
+
+## Input Port: `input`
+
+- **`fields_to_watch`** (`[]enum`) **REQUIRED** — Fields to watch for changes. The trigger will only be fired if any of these fields are updated.
+  - Allowed: `question`, `answer`, `status`
+
+## Output Port: `output`
+
+- **`answer`** (`text`) — The Answer.
+- **`applies_to_parts`** (`[]composite`)
+  - Composite: `_gen:part-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+  - **`id`** (`id`) **REQUIRED** — ID of the part attached to the QA.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_date`** (`timestamp`) — Timestamp when the QA was created.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`modified_date`** (`timestamp`) — Timestamp when the QA was modified.
+- **`question`** (`text`) — The Question.
+- **`status`** (`enum`) — Status of the question answer.
+  - Allowed: `archived`, `discarded`, `draft`, `published`, `review_needed`
+- **`suggested_answer`** (`text`) — An alternative answer suggested by the QA generation algorithm.
+- **`suggested_for_deletion`** (`bool`) — Whether the QA was marked for deletion by the QA generation algorithm.
+- **`topic`** (`text`) — The topic to which the QA belongs.
+- **`verified`** (`bool`) — Whether the QA was verified.
+- **`old_question_answer`** (`composite`) — Old question_answer object
+  - Composite: `_gen:implicit:question_answer`
+  - **`answer`** (`text`) — The Answer.
+  - **`applies_to_parts`** (`[]composite`)
+    - Composite: `_gen:part-summary`
+  - **`created_by`** (`composite`)
+    - Composite: `_gen:created_by`
+  - **`created_date`** (`timestamp`) — Timestamp when the object was created.
+  - **`modified_by`** (`composite`)
+    - Composite: `_gen:modified_by`
+  - **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+  - **`question`** (`text`) — The Question.
+  - **`status`** (`enum`) — Status of the question answer.
+    - Allowed: `archived`, `discarded`, `draft`, `published`, `review_needed`
+  - **`suggested_answer`** (`text`) — An alternative answer suggested by the Q/A generation algorithm.
+  - **`suggested_for_deletion`** (`bool`) — Whether the Q/A was marked for deletion by the Q/A generation algorithm.
+  - **`topic`** (`text`) — The topic to which the QA belongs.
+  - **`verified`** (`bool`) — Whether the Q/A was verified.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `question_answer`
+- **`id`** (`id`) **REQUIRED** — The ID of the updated QA
+  - ID type: `question_answer`

package/skills/create-workflow-template/operations/schemas/recall_chats.md

@@ -0,0 +1,13 @@
+# `recall_chats` — Schema Reference
+
+## Input Port: `input`
+
+- **`query`** (`text`) — Extract only specific topic keywords. Drop time words ("yesterday", "last week", "last fiscal year") and generic fillers ("find", "what was"). If the prompt has no clear topic (e.g., "what were the topics of conversations last week?"), leave this empty so only the date filters are used.
+- **`start_date`** (`timestamp`) — Start of date range (ISO 8601 timestamp). If any time reference exists, always set both start_date and end_date. Examples: "last fiscal year" -> first day of that fiscal year; "last week" -> first day of last week; "last month" -> first day of last month. Leave empty only when no time reference.
+- **`end_date`** (`timestamp`) — End of date range (ISO 8601 timestamp). If any time reference exists, always set both start_date and end_date. Examples: "last fiscal year" -> last day of that fiscal year; "last week" -> last day of last week; "last month" -> last day of last month. Leave empty only when no time reference.
+- **`limit`** (`int`) — Maximum number of results to return. Defaults to 10 if not specified. Valid range: 1-100.
+
+## Output Port: `output`
+
+- **`results_count`** (`int`) **REQUIRED** — Number of conversations/messages found
+- **`results`** (`text`) **REQUIRED** — Array of search results with id, title, snippet, and comments (if any)

package/skills/create-workflow-template/operations/schemas/router.md

@@ -0,0 +1,15 @@
+# `router` — Schema Reference
+
+Route workflow into parallel paths, executing only the routes whose conditions are met.
+
+**Release Stage:** Beta
+
+## Input Port: `input`
+
+Schema is **dynamic** (Overridden by schema handler). The input includes route conditions configured at design time.
+
+## Output Port: `output`
+
+Schema is **dynamic** (Overridden by schema handler). Multiple output routes are defined at design time, each with its own condition.
+
+> **Note:** The router operation's schema (both input conditions and output routes) is fully managed by the schema handler. Routes and their conditions are configured in the workflow editor.

package/skills/create-workflow-template/operations/schemas/send_notification.md

@@ -0,0 +1,19 @@
+# `send_notification` — Schema Reference
+
+Send notification to users or groups. By default, notification priority will be marked as "Important". Emails are sent for unread "Important" notifications. Once the workflow is deployed, any receiver can go to notification preferences and change the priority to "Others" to stop receiving emails.
+
+## Input Port: `input`
+
+- **`receivers`** (`[]id`) **REQUIRED** — The users or groups who will receive the notification.
+  - ID type: `devu`, `group`
+- **`body`** (`rich_text`) **REQUIRED** — The body of the notification.
+- **`title`** (`rich_text`) **REQUIRED** — The title of the notification.
+- **`content_template_id`** (`id`) — The content template for the notification.
+  - ID type: `notification_content_template`
+  - UI: hidden
+- **`linked_object`** (`id`) — The object which will open on clicking the notification.
+  - ID type: `account`, `capability`, `enhancement`, `feature`, `incident`, `issue`, `linkable`, `opportunity`, `product`, `runnable`, `ticket`, `conversation`
+
+## Output Port: `output`
+
+No output fields defined (empty schema).

package/skills/create-workflow-template/operations/schemas/set_variable.md

@@ -0,0 +1,67 @@
+# `set_variable` — Schema Reference
+
+Sets a variable with the given value. Typically used inside loop bodies to accumulate data across iterations.
+
+## Input Port: `input`
+
+Schema is **dynamic** (Overridden by schema handler), but the template pattern is well-defined. Has three fields — all using `uenum` or `text` field types:
+
+```json
+"input_ports": [{"name": "input", "schema": {"field_descriptors": [
+  {"field_type": "uenum", "allowed_values": [
+    {"id": 1, "label": "init_variable_1 - summary", "ordinal": 1,
+     "value": {"output_port_name": "output", "step_reference_key": "init_variable_1", "variable_name": "summary"}}
+  ], "data_name": "variable", "db_name": "variable", "description": "Variable",
+   "is_required": true, "name": "variable", "oasis": {"name": "variable"}, "ui": {"display_name": "Variable"}},
+  {"field_type": "uenum", "allowed_values": [
+    {"id": 1, "label": "Set Value", "ordinal": 1, "value": "set"},
+    {"id": 2, "label": "Concatenate", "ordinal": 2, "value": "concat"}
+  ], "data_name": "operation", "db_name": "operation", "description": "Operation to perform. Defaults to 'Set Value' if not specified.",
+   "is_required": false, "name": "operation", "oasis": {"name": "operation"}, "ui": {"display_name": "Operation"}},
+  {"field_type": "text", "data_name": "value", "db_name": "value", "description": "Value",
+   "is_filterable": false, "is_required": true, "name": "value", "oasis": {"name": "value"}, "ui": {"display_name": "Value"}}
+], "invalidate_on_field_update": ["variable"], "type": "field_descriptor"}, "type": "default"}]
+```
+
+**CRITICAL:** The `variable` and `operation` fields are `uenum` type and MUST have `allowed_values`. Missing `allowed_values` causes "Missing required field: allowed_values" on import.
+
+### `variable` allowed_values
+
+The `variable` field's `allowed_values` references the `init_variable` step:
+```json
+{"id": 1, "label": "init_variable_1 - summary", "ordinal": 1,
+ "value": {"output_port_name": "output", "step_reference_key": "init_variable_1", "variable_name": "summary"}}
+```
+
+### `operation` allowed_values
+
+Always include both options:
+```json
+[
+  {"id": 1, "label": "Set Value", "ordinal": 1, "value": "set"},
+  {"id": 2, "label": "Concatenate", "ordinal": 2, "value": "concat"}
+]
+```
+
+## Input Values
+
+```json
+"input_values": [{"port_name": "input", "fields": [
+  {"name": "variable", "value": {"type": "literal", "value": {
+    "output_port_name": "output", "step_reference_key": "init_variable_1", "variable_name": "summary"}}},
+  {"name": "operation", "value": {"type": "literal", "value": "concat"}},
+  {"name": "value", "value": {"type": "text_template", "value": "{% expr $get('http_1', 'output').body %}"}}
+]}]
+```
+
+## Output Port: `output`
+
+```json
+"output_ports": [
+  {"name": "output", "schema": {"type": "field_descriptor"}, "type": "default"},
+  {"name": "error", "schema": {"field_descriptors": [
+    {"field_type": "text", "data_name": "message", "db_name": "message", "description": "Error message with more details about the error", "name": "message", "oasis": {"name": "message"}, "ui": {"display_name": "Error Message"}},
+    {"field_type": "enum", "allowed_values": ["bad_request", "not_found", "internal"], "data_name": "type", "db_name": "type", "description": "Type of the error", "name": "type", "oasis": {"name": "type"}, "ui": {"display_name": "Error Type"}}
+  ], "type": "field_descriptor"}, "type": "error"}
+]
+```

package/skills/create-workflow-template/operations/schemas/sleep_for.md

@@ -0,0 +1,12 @@
+# `sleep_for` — Schema Reference
+
+Pause the workflow for a specified duration.
+
+## Input Port: `input`
+
+- **`duration`** (`composite`) **REQUIRED** — Duration to sleep for.
+  - Composite: `devrev:duration`
+
+## Output Port: `output`
+
+No output fields (empty schema). The workflow simply resumes after the duration.

package/skills/create-workflow-template/operations/schemas/sleep_until.md

@@ -0,0 +1,17 @@
+# `sleep_until` — Schema Reference
+
+Pause the workflow until a specific date and time. You can also adjust this time by adding or subtracting some duration. Use this to delay actions, like sending reminders, until the right moment. If the time is in the past, the workflow will resume immediately.
+
+## Input Port: `input`
+
+- **`sleep_until`** (`timestamp`) **REQUIRED** — Select the time when the workflow should resume.
+- **`offset_duration`** (`composite`) — Choose if you want to add or subtract extra time from the date and time you picked.
+  - Composite: `offset`
+  - **`add_or_subtract`** (`enum`) **REQUIRED** — Choose whether to add or subtract the duration from the specified timestamp.
+    - Allowed: `add`, `subtract`
+  - **`duration`** (`composite`) **REQUIRED** — Duration of time to add or subtract.
+    - Composite: `devrev:duration`
+
+## Output Port: `output`
+
+No output fields (empty schema). The workflow simply resumes at the specified time.

package/skills/create-workflow-template/operations/schemas/sprint_updated.md

@@ -0,0 +1,37 @@
+# `sprint_updated` — Schema Reference
+
+## Input Port: `input`
+
+- **`fields_to_watch`** (`[]enum`) **REQUIRED** — Fields to watch for changes. The trigger will only be fired if any of these fields are updated.
+  - Allowed: `name`, `state`, `start_date`, `end_date`, `parent`
+
+## Output Port: `output`
+
+- **`end_date`** (`timestamp`) — Timestamp when the vista ends.
+- **`name`** (`text`) **REQUIRED** — Name of the group.
+- **`start_date`** (`timestamp`) — Timestamp when the vista starts.
+- **`state`** (`enum`) — Defines the state of the group item.
+  - Allowed: `active`, `completed`, `planned`
+- **`type`** (`enum`) **REQUIRED** — Type of the group object.
+  - Allowed: `curated`, `dynamic`
+- **`old_vista_group_item`** (`composite`) — Old sprint object
+  - Composite: `_gen:implicit:vista_group_item`
+  - **`end_date`** (`timestamp`) — Timestamp when the vista ends.
+  - **`name`** (`text`) **REQUIRED** — Name of the group.
+  - **`start_date`** (`timestamp`) — Timestamp when the vista starts.
+  - **`state`** (`enum`) — Defines the state of the group item.
+    - Allowed: `active`, `completed`, `planned`
+  - **`type`** (`enum`) **REQUIRED** — Type of the group object.
+    - Allowed: `curated`, `dynamic`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `vista_group_item`
+  - **`parent`** (`composite`) — The sprint board this sprint belongs to
+    - Composite: `_gen:parent`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `vista_group_item`
+- **`parent`** (`composite`) — The sprint board this sprint belongs to
+  - Composite: `_gen:parent`
+  - **`id`** (`id`) **REQUIRED** — Parent vista ID.
+    - ID type: `vista`
+  - **`name`** (`text`) **REQUIRED** — Name of the parent vista.
+  - **`display_id`** (`text`) **REQUIRED** — Human-readable object ID.

package/skills/create-workflow-template/operations/schemas/suggest_part.md

@@ -0,0 +1,14 @@
+# `suggest_part` — Schema Reference
+
+Suggest a part that can be attributed to a given object.
+
+## Input Port: `input`
+
+- **`id`** (`id`) **REQUIRED** — The ID of the ticket, conversation or incident to suggest parts for.
+  - ID type: `ticket`, `conversation`, `incident`
+
+## Output Port: `output`
+
+- **`id`** (`id`) **REQUIRED** — The ID of the suggested part.
+  - ID type: `capability`, `enhancement`, `feature`, `product`, `linkable`, `runnable`
+- **`found`** (`bool`) **REQUIRED** — If suggestion is present, returns true.

package/skills/create-workflow-template/operations/schemas/task_updated.md

@@ -0,0 +1,79 @@
+# `task_updated` — Schema Reference
+
+## Input Port: `input`
+
+- **`fields_to_watch`** (`[]enum`) **REQUIRED** — Fields to watch for changes. The trigger will only be fired if any of these fields are updated.
+  - Allowed: `owned_by`, `stage`, `title`, `due_date`
+
+## Output Port: `output`
+
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Rev organization from your primary customer record. If none is available, a good alternative is the email address/phone number which could uniquely identify the user. If none is specified, a system-generated identifier will be assigned to the user.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`state`** (`enum`) — State of the user.
+    - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`stage`** (`composite`) — Describes the current stage of a work item.
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) **REQUIRED** — Current stage name of the work item.
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`title`** (`text`) **REQUIRED** — Title of the work object.
+- **`old_task`** (`composite`) — Old task object
+  - Composite: `_gen:implicit:task`
+  - **`created_by`** (`composite`)
+    - Composite: `_gen:created_by`
+  - **`created_date`** (`timestamp`) — Timestamp when the object was created.
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`external_ref`** (`text`) — An opaque key that's associated with the work item that's guaranteed to be unique across all work items of same type (issue, ticket, etc).
+  - **`modified_by`** (`composite`)
+    - Composite: `_gen:modified_by`
+  - **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`stage`** (`composite`) — Describes the current stage of a work item.
+    - Composite: `_gen:stage`
+  - **`state_display_name`** (`text`) — Display name for current state.
+  - **`title`** (`text`) **REQUIRED** — Title of the work object.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `task`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `task`

package/skills/create-workflow-template/operations/schemas/test_example.md

@@ -0,0 +1,16 @@
+# `test_example` — Schema Reference
+
+## Input Port: `input`
+
+- **`new_field_required`** (`text`) **REQUIRED** — This is a new required field
+- **`new_field_required`** (`text`) **REQUIRED** — This is a new required field
+- **`new_field`** (`text`) — This is a new field
+- **`message`** (`text`) **REQUIRED** — A new description
+  - Default: `Hello, World!`
+  - Validation: min_len=1, max_len=1000
+
+## Output Port: `output`
+
+- **`message`** (`text`) — The echoed message.
+- **`nested_level_field_1`** (`text`) — This is a nested level field that should be promoted to the top level.
+- **`nested_level_field_2`** (`text`) — This is a nested level field that should be promoted to the top level.