@devrev-computer/skills 1.0.0

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

@@ -0,0 +1,44 @@
+# `update_brand` — Schema Reference
+
+## Input Port: `input`
+
+- **`description`** (`text`) — The updated description to set for the brand.
+  - Validation: max_len=65536
+- **`id`** (`id`) **REQUIRED** — The ID of the brand to be updated.
+  - ID type: `brand`
+- **`name`** (`text`) — The updated name to set for the brand.
+  - Validation: min_len=1, max_len=255
+
+## 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.
+  - **`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`, `service_account`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`description`** (`text`) — The description of the brand.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`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`, `sys_user`, `service_account`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`name`** (`text`) — The name of the brand.
+- **`id`** (`id`) **REQUIRED** — Globally unique Brand ID.
+  - ID type: `brand`

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

@@ -0,0 +1,53 @@
+# `update_contact` — Schema Reference
+
+## Input Port: `input`
+
+- **`description`** (`text`) — The description of the contact.
+- **`display_name`** (`text`) — The display name of the contact.
+- **`email`** (`text`) — The email of the contact.
+- **`external_refs`** (`[]text`) — External references associated with the contact.
+- **`phone_numbers`** (`[]text`) — The phone numbers of the contact.
+- **`tags`** (`[]composite`) — The tags of the contact.
+  - Composite: `_gen:tags`
+  - **`id`** (`id`) **REQUIRED** — The ID of the tag.
+    - ID type: `tag`
+- **`id`** (`id`) **REQUIRED** — ID of contact to be updated.
+  - ID type: `revu`
+
+## 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.
+  - **`full_name`** (`text`) — Full name of the user.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED** — The type of the user.
+    - Allowed: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the contact was created.
+- **`description`** (`text`) — The description of the contact.
+- **`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.
+- **`is_verified`** (`bool`) — Whether the contact is verified.
+- **`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.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `rev_user`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the contact was last modified.
+- **`phone_numbers`** (`[]text`) — Phone numbers of the user.
+- **`tags`** (`[]composite`) — Tags associated with the contact.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `revu`

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

@@ -0,0 +1,149 @@
+# `update_conversation` — Schema Reference
+
+## Input Port: `input`
+
+- **`id`** (`id`) **REQUIRED** — The id of the conversation.
+  - ID type: `conversation`
+- **`title`** (`text`) — Updated title of the conversation, or unchanged if not provided.
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — Sets the owner IDs to the provided user IDs. This must not be empty.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`description`** (`text`) — The updated description for the conversation.
+- **`stage_name`** (`enum`) — The stage of the conversation.
+  - Allowed: `suspended`, `needs_response`, `waiting_on_user`, `hold`, `resolved`, `archived`
+- **`group`** (`id`) — The group that the conversation is associated with.
+  - ID type: `group`
+- **`is_spam`** (`bool`) — Whether the conversation is spam.
+- **`account`** (`id`) — The account associated with the conversation.
+  - ID type: `account`
+- **`applies_to_parts`** (`composite`)
+  - Composite: `_gen:applies_to_parts`
+  - **`set`** (`[]id`) — Sets the part IDs to the provided part IDs. This must not be empty.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`is_frozen`** (`bool`) — Whether the conversation is frozen.
+- **`owned_by_agent`** (`id`) — The ID of the AI agent that owns the conversation.
+  - ID type: `ai_agent`
+- **`sentiment`** (`uenum`) — The sentiment of the conversation.
+- **`sentiment_modified_date`** (`timestamp`) — Timestamp at which sentiment was last modified.
+- **`sentiment_summary`** (`text`) — Summary justifying the current sentiment.
+- **`tags`** (`composite`)
+  - Composite: `_gen:tags`
+  - **`add`** (`[]composite`) — Adds the provided tags on the conversation. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:add`
+  - **`remove`** (`[]composite`) — Removes the provided tags on the conversation. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:remove`
+
+## Output Port: `output`
+
+- **`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** — Globally unique object ID.
+    - ID type: `account`
+- **`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 conversation.
+    - 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.
+  - **`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** — ID of the user.
+    - ID type: `revu`, `svcacc`
+- **`created_date`** (`timestamp`) — Timestamp when the conversation was created.
+- **`description`** (`text`) — The description of the conversation.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`group`** (`composite`)
+  - Composite: `_gen:group`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`id`) **REQUIRED** — ID of the group
+    - ID type: `group`
+- **`is_frozen`** (`bool`) — Whether the object is frozen or not.
+- **`last_external_message_date`** (`timestamp`) — Timestamp of the last message in external discussion.
+- **`members`** (`[]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`
+  - **`id`** (`id`) **REQUIRED** — ID of the user
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`metadata`** (`composite`) — Metadata on conversation.
+  - Composite: `_gen:metadata`
+  - **`url_context`** (`text`) — URL from which the conversation was created if the conversation was created via PLuG.
+- **`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.
+  - **`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** — The id of the user.
+    - ID type: `devu`, `revu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — Timestamp when the conversation was modified.
+- **`owned_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.
+  - **`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`
+  - **`id`** (`id`) **REQUIRED** — ID of the user
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`sentiment`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:sentiment`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`label`** (`enum`) **REQUIRED** — The display label of the enum value.
+    - Allowed: `Delighted`, `Happy`, `Neutral`, `Unhappy`, `Frustrated`
+- **`sentiment_modified_date`** (`timestamp`) — Timestamp when the sentiment was last modified.
+- **`sentiment_summary`** (`text`) — Summary justifying the sentiment.
+- **`stage`** (`composite`) — The stage of the conversation.
+  - Composite: `_gen:conversation-properties.stage`
+  - **`name`** (`enum`) — The stage of the conversation.
+    - Allowed: `new`, `suspended`, `needs_response`, `waiting_on_user`, `hold`, `resolved`, `archived`
+- **`tags`** (`[]composite`) — The tags associated with the conversation.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`title`** (`text`) — The title of the conversation.
+- **`id`** (`id`) **REQUIRED** — The ID of the updated conversation
+  - ID type: `conversation`

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

@@ -0,0 +1,64 @@
+# `update_enhancement` — Schema Reference
+
+## Input Port: `input`
+
+- **`description`** (`text`) — The updated description of the enhancement.
+- **`name`** (`text`) — The updated name of the enhancement.
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — The user that owns the enhancement.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`release_notes`** (`text`) — Updates the release notes of the enhancement.
+  - Validation: max_len=32768
+- **`target_close_date`** (`timestamp`) — Updates the target close date of the enhancement.
+- **`target_start_date`** (`timestamp`) — Updates the target start date of the enhancement.
+- **`id`** (`id`) **REQUIRED** — The ID of the enhancement
+  - ID type: `enhancement`
+- **`stage_v2`** (`id`) — The stage of the enhancement.
+  - ID type: `custom_stage`
+
+## Output Port: `output`
+
+- **`actual_close_date`** (`timestamp`) — Actual close date for the object.
+- **`actual_start_date`** (`timestamp`) — Actual start date for the object.
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`display_id`** (`text`) — Display ID of the user who created the enhancement.
+  - **`display_name`** (`text`) — The display name of the user who created the enhancement.
+  - **`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`) — ID of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`created_date`** (`timestamp`) — The date the enhancement was created.
+- **`description`** (`text`) — The description of the enhancement.
+- **`display_id`** (`text`) — The display ID of the enhancement.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`display_id`** (`text`) — Display ID of the user who modified the enhancement.
+  - **`display_name`** (`text`) — The display name of the user who modified the enhancement.
+  - **`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`) — ID of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`modified_date`** (`timestamp`) — The date the enhancement was last modified.
+- **`name`** (`text`) **REQUIRED** — The name of the enhancement.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+- **`tags`** (`[]composite`) — The tags associated with the enhancement.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Target close date for the object.
+- **`target_start_date`** (`timestamp`) — Target start date for the object.
+- **`id`** (`id`) **REQUIRED** — ID of the enhancement.
+  - ID type: `enhancement`
+- **`stage_v2`** (`composite`) — The stage of the enhancement.
+  - Composite: `_gen:stage_v2`
+  - **`stage`** (`composite`)
+    - Composite: `_gen:stage`
+  - **`state`** (`composite`)
+    - Composite: `_gen:state`

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

@@ -0,0 +1,156 @@
+# `update_incident` — Schema Reference
+
+## Input Port: `input`
+
+- **`acknowledged_date`** (`timestamp`) — Timestamp when the incident was acknowledged.
+- **`applies_to_parts`** (`composite`)
+  - Composite: `_gen:applies_to_parts`
+  - **`set`** (`[]id`) — Sets the parts to which the incident is applicable to
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`body`** (`text`) — Body of the incident.
+- **`id`** (`id`) **REQUIRED** — The ID of the incident to be updated.
+  - ID type: `incident`
+- **`identified_date`** (`timestamp`) — Time when the incident was identified/reported.
+- **`impact`** (`composite`)
+  - Composite: `_gen:impact`
+  - **`count`** (`int`) — Count of customers impacted.
+  - **`customer_ids`** (`composite`)
+    - Composite: `_gen:customer_ids`
+- **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — The users that own the incident
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`pia`** (`composite`)
+  - Composite: `_gen:pia`
+  - **`set`** (`[]id`) — The article id of the Post-Incident Analysis(PIA) of the incident.
+    - ID type: `article`
+- **`severity`** (`int`) — Severity of the incident.
+- **`tags`** (`composite`)
+  - Composite: `_gen:tags`
+  - **`set`** (`[]composite`) — Sets the tags associated with the object.
+    - Composite: `_gen:set`
+- **`target_close_date`** (`timestamp`) — Timestamp when the incident is expected to be resolved.
+- **`title`** (`text`) — Title of the incident.
+- **`stage`** (`id`) — The stage of the incident.
+  - ID type: `custom_stage`
+
+## Output Port: `output`
+
+- **`acknowledged_date`** (`timestamp`) — Timestamp when the incident was acknowledged.
+- **`actual_close_date`** (`timestamp`) — Timestamp when the incident was actually resolved.
+- **`applies_to_parts`** (`[]composite`)
+  - Composite: `_gen:part-summary`
+  - **`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 incident.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`body`** (`text`) — Body of the incident.
+- **`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.
+  - **`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`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`identified_date`** (`timestamp`) — Time when the incident was identified/reported.
+- **`impact`** (`composite`) — Details of the impact due to the incident.
+  - Composite: `_gen:impact`
+  - **`count`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:count`
+  - **`customer_ids`** (`[]composite`)
+    - Composite: `_gen:account-summary`
+- **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+- **`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.
+  - **`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`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`owned_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.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`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** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`pia`** (`[]composite`)
+  - Composite: `_gen:article-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`resource`** (`composite`) — Resource details.
+    - Composite: `_gen:resource`
+  - **`title`** (`text`) — Title of the article.
+  - **`id`** (`id`) **REQUIRED** — ID of the article.
+    - ID type: `article`
+- **`playbooks`** (`[]composite`)
+  - Composite: `_gen:article-summary_95fca9c7`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`resource`** (`composite`) — Resource details.
+    - Composite: `_gen:resource`
+  - **`title`** (`text`) — Title of the article.
+  - **`id`** (`id`) **REQUIRED** — ID of the article.
+    - ID type: `article`
+- **`reported_by`** (`composite`) — The entity that reported the incident.
+  - Composite: `_gen:reported_by`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The label for the entity that reported the incident. Use id instead as labels can change overtime.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+- **`severity`** (`composite`) — Severity of the incident.
+  - Composite: `_gen:severity`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The label for the severity. Use id instead as labels can change overtime.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`source`** (`composite`) — The source of the incident.
+  - Composite: `_gen:source`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The label for the source. Use id instead as labels can change overtime.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`stage`** (`composite`) — Stage of the incident.
+  - Composite: `_gen:stage`
+  - **`stage`** (`composite`) — The stage of the incident.
+    - Composite: `stage.stage`
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Timestamp when the incident is expected to be resolved.
+- **`title`** (`text`) **REQUIRED** — Title of the incident.
+- **`id`** (`id`) **REQUIRED** — ID of the incident.
+  - ID type: `incident`

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

@@ -0,0 +1,173 @@
+# `update_issue` — Schema Reference
+
+## Input Port: `input`
+
+- **`artifacts`** (`composite`)
+  - Composite: `_gen:artifacts`
+  - **`add`** (`[]id`) — Adds the provided artifacts (if not already present) to the field.
+    - ID type: `artifact`
+  - **`remove`** (`[]id`) — Removes the provided artifacts (if they exist) from the field.
+    - ID type: `artifact`
+  - **`set`** (`[]id`) — Sets the field to the provided artifacts.
+    - ID type: `artifact`
+- **`body`** (`text`) — Updated body of the issue, or unchanged if not provided.
+  - Validation: max_len=65536
+- **`developed_with`** (`composite`)
+  - Composite: `_gen:developed_with`
+  - **`set`** (`[]id`) — Sets the IDs of the parts associated with issue.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`owned_by`** (`composite`)
+  - Composite: `_gen:owned_by`
+  - **`set`** (`[]id`) — Sets the owner IDs to the provided user IDs. This must not be empty.
+    - ID type: `devu`, `sysu`, `svcacc`
+- **`priority_v2`** (`uenum`) — Priority enum id of the work based upon impact and criticality. The allowed ids can be extended by the user. Stock allowed values: ```   {     "id": 1,     "label": "P0",     "ordinal": 1,     "overridable": true   },   {     "id": 2,     "label": "P1",     "ordinal": 2,     "overridable": true   },   {     "id": 3,     "label": "P2",     "ordinal": 3,     "overridable": true   },   {     "id": 4,     "label": "P3",     "ordinal": 4,     "overridable": true   } ```
+- **`reported_by`** (`composite`)
+  - Composite: `_gen:reported_by`
+  - **`set`** (`[]id`) — Sets the reported by user IDs to the provided user IDs.
+    - ID type: `devu`, `sysu`, `svcacc`, `revu`
+- **`sprint`** (`id`) — Updates the sprint that the issue belongs to.
+  - ID type: `vista_group_item`
+- **`tags`** (`composite`)
+  - Composite: `_gen:tags`
+  - **`add`** (`[]composite`) — Adds the provided tags on the issue. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:add`
+  - **`remove`** (`[]composite`) — Removes the provided tags on the issue. Note: Provide either 'add' or 'remove' but not both.
+    - Composite: `_gen:remove`
+- **`target_close_date`** (`timestamp`) — Updates the timestamp for when the issue is expected to be complete.
+- **`target_start_date`** (`timestamp`) — Updates the timestamp for when the issue is expected to start.
+- **`title`** (`text`) — Updated title of the issue, or unchanged if not provided.
+  - Validation: min_len=1, max_len=256
+- **`applies_to_part`** (`id`) — Updates the part that the issue applies to.
+  - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`id`** (`id`) **REQUIRED** — The ID of issue to update.
+  - ID type: `issue`
+- **`stage`** (`id`) — The stage of the issue.
+  - ID type: `custom_stage`
+
+## Output Port: `output`
+
+- **`applies_to_part`** (`composite`)
+  - Composite: `_gen:applies_to_part`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`sync_metadata`** (`composite`) — Sync information for records synced into/from DevRev.
+    - Composite: `_gen:sync_metadata`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+- **`artifacts`** (`[]composite`)
+  - Composite: `_gen:artifact-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+- **`body`** (`text`) — Body of the work object.
+- **`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.
+  - **`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.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`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`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`developed_with`** (`[]composite`)
+  - Composite: `_gen:part-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`name`** (`text`) **REQUIRED** — Name of the part.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`sync_metadata`** (`composite`) — Sync information for records synced into/from DevRev.
+    - Composite: `_gen:sync_metadata`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `capability`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`estimated_effort`** (`double`) — Estimated effort to complete the issue.
+- **`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.
+  - **`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.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`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`
+- **`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.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`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.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`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`
+- **`priority`** (`enum`) — Priority of the work based upon impact and criticality.
+  - Allowed: `p0`, `p1`, `p2`, `p3`
+- **`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.
+  - **`display_picture`** (`composite`)
+    - Composite: `_gen:display_picture`
+  - **`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.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`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`
+- **`sprint`** (`composite`) — Vista group item.
+  - Composite: `_gen:sprint`
+  - **`end_date`** (`timestamp`) — Timestamp when the vista ends.
+  - **`id`** (`text`) **REQUIRED** — ID of the group item in don v2 format.
+  - **`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`
+- **`stage`** (`composite`) — Describes the current stage of a work item.
+  - Composite: `_gen:stage`
+  - **`name`** (`text`) **REQUIRED** — Current stage name of the work item.
+  - **`stage`** (`composite`) — The stage of the issue.
+    - Composite: `stage.stage`
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — Timestamp when the work is expected to be complete.
+- **`target_start_date`** (`timestamp`) — Target start date for the object.
+- **`title`** (`text`) **REQUIRED** — Title of the work object.
+- **`type`** (`enum`) **REQUIRED**
+  - Allowed: `issue`, `opportunity`, `task`, `ticket`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `issue`