@devrev-computer/skills 1.0.0

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

@@ -0,0 +1,106 @@
+# `loop_over_accounts` — Schema Reference
+
+## Input Port: `input`
+
+- **`created_by`** (`[]id`) — Filters for accounts created by the specified user(s).
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`created_date`** (`composite`)
+  - Composite: `_gen:created_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+- **`display_name`** (`[]text`) — Array of display names of accounts to be filtered.
+- **`domains`** (`[]text`) — Domains for accounts to be filtered.
+- **`external_refs`** (`[]text`) — Array of references of accounts to be filtered.
+- **`modified_date`** (`composite`)
+  - Composite: `_gen:modified_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+- **`owned_by`** (`[]id`) — Filters for accounts owned by the specified user(s).
+  - ID type: `devu`, `sysu`
+- **`stage`** (`[]id`) — Filters for accounts on specified stages.
+  - ID type: `custom_stage`
+- **`tier`** (`[]text`) — Tier of the accounts to be filtered.
+- **`websites`** (`[]text`) — Array of websites of accounts to be filtered.
+- **`tags`** (`[]id`) — Filters for accounts with any of the provided tags.
+  - ID type: `tag`
+- **`limit`** (`int`) — The maximum number of accounts to return. Maximum is 1000.
+
+## Input Port: `block_callback`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `block_start`
+
+- **`artifacts`** (`[]composite`)
+  - Composite: `_gen:artifact-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`file`** (`composite`) — Defines a file object.
+    - Composite: `_gen:file`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `artifact`
+- **`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`, `svcacc`, `sysu`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`description`** (`text`) — Description of the corresponding Account.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`display_name`** (`text`) — Name of the Organization.
+- **`domains`** (`[]text`) — Company's domain names. Example - 'devrev.ai'.
+- **`external_refs`** (`[]text`) — External refs are unique identifiers from your customer system of records, stored as a list.
+- **`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`, `svcacc`, `sysu`
+- **`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.
+  - **`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`, `svcacc`, `sysu`
+- **`primary_account`** (`composite`)
+  - Composite: `_gen:primary_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 Account ID.
+    - ID type: `account`
+- **`stock_schema_fragment`** (`id`) — Stock schema fragment.
+  - ID type: `app_fragment`, `custom_type_fragment`, `stock_sf`, `tenant_fragment`
+- **`tags`** (`[]composite`) — Tags associated with an object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+  - **`value`** (`text`) — The value for the object's association with the tag.
+- **`tier`** (`text`) — The Tier of the corresponding Account.
+- **`websites`** (`[]text`) — Company's website links. Filling in this property will also fill in domain. Example - 'www.devrev.ai'.
+- **`id`** (`id`) **REQUIRED** — Globally unique Account ID.
+  - ID type: `account`

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

@@ -0,0 +1,126 @@
+# `loop_over_articles` — Schema Reference
+
+## Input Port: `input`
+
+- **`article_type`** (`[]enum`) — Filter for the type of articles.
+  - Allowed: `article`, `content_block`, `page`
+- **`limit`** (`int`) — The maximum number of articles to return. The default is '50'.
+- **`parent`** (`[]id`) — Filters for articles with the provided parent directories.
+  - ID type: `directory`
+- **`shared_with`** (`[]composite`) — Filter for articles based on intended audience.
+  - Composite: `_gen:shared_with`
+  - **`member`** (`id`) — ID of the group/member with whom the item is shared.
+    - ID type: `devu`, `group`, `revu`, `sysu`
+  - **`role`** (`id`) — Role ID of the group/member with whom the item is shared.
+    - ID type: `role`
+- **`status`** (`[]enum`) — Filters for status of the articles.
+  - Allowed: `archived`, `draft`, `published`, `review_needed`
+- **`sync_metadata`** (`composite`)
+  - Composite: `_gen:sync_metadata`
+  - **`external_reference`** (`[]text`) — Filters for issues with this specific external reference.
+  - **`last_sync_in`** (`composite`)
+    - Composite: `_gen:last_sync_in`
+  - **`last_sync_out`** (`composite`)
+    - Composite: `_gen:last_sync_out`
+  - **`origin_system`** (`[]text`) — Filters for issues synced from this specific origin system.
+- **`tags`** (`[]id`) — Filters for article with any of the provided tags.
+  - ID type: `tag`
+- **`applies_to_parts`** (`[]id`) — Filters for articles belonging to any parts.
+  - ID type: `product`, `feature`, `capability`, `enhancement`, `runnable`, `linkable`
+- **`owned_by`** (`[]id`) — Filters for articles owned by internal users only.
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`created_by`** (`[]id`) — Filters for articles created by internal users only.
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`modified_by`** (`[]id`) — Filters for articles modified by internal users only.
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`authored_by`** (`[]id`) — Filters for articles authored by internal users only.
+  - ID type: `devu`, `svcacc`, `sysu`
+
+## Input Port: `block_callback`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `block_start`
+
+- **`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** — Globally unique object ID.
+    - ID type: `product`, `feature`, `capability`, `enhancement`, `runnable`, `linkable`
+- **`article_type`** (`enum`) — Type of the article.
+  - Allowed: `article`, `content_block`, `page`
+- **`authored_by`** (`[]composite`)
+  - Composite: `_gen:user-summary`
+  - **`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`, `svcacc`, `sysu`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_by`** (`composite`)
+  - Composite: `_gen:created_by`
+  - **`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`, `svcacc`, `sysu`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_date`** (`timestamp`) — Timestamp when the article was created.
+- **`description`** (`text`) — Description of the article.
+- **`modified_by`** (`composite`)
+  - Composite: `_gen:modified_by`
+  - **`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`, `svcacc`, `sysu`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`modified_date`** (`timestamp`) — Timestamp when the article was last modified.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`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`, `svcacc`, `sysu`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`parent`** (`composite`)
+  - Composite: `_gen:parent`
+  - **`title`** (`text`) — Title of the directory.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `directory`
+- **`resource`** (`composite`) — Resource details.
+  - Composite: `_gen:resource`
+  - **`artifacts`** (`[]composite`)
+    - Composite: `_gen:artifact-summary`
+  - **`url`** (`text`) — URL of the resource (relevant only for type url).
+- **`scope`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:scope`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+- **`status`** (`enum`) — Status of the article.
+  - Allowed: `archived`, `draft`, `published`, `review_needed`
+- **`tags`** (`[]composite`) — Tags associated with the article.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+  - **`value`** (`text`) — The value for the object's association with the tag.
+- **`title`** (`text`) — Title of the article.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `article`

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

@@ -0,0 +1,88 @@
+# `loop_over_customers` — Schema Reference
+
+## Input Port: `input`
+
+- **`associations`** (`[]id`) — Filters for customers with specified associations (account/workspace).
+  - ID type: `account`, `revo`
+- **`created_by`** (`[]id`) — Filters for customers that were created by the specified user(s).
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`created_date`** (`composite`)
+  - Composite: `_gen:created_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`email`** (`[]text`) — List of emails of customers to be filtered.
+- **`external_ref`** (`[]text`) — List of external refs to filter customers for.
+- **`external_refs`** (`[]text`) — Filters for customers with the provided external_refs.
+- **`is_verified`** (`bool`) — Value of is_verified field to filter the customers.
+- **`modified_date`** (`composite`)
+  - Composite: `_gen:modified_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`phone_numbers`** (`[]text`) — List of phone numbers, in E.164 format, to filter customers on.
+- **`rev_org`** (`[]id`) — List of IDs of customer organizations to be filtered.
+  - ID type: `revo`
+- **`limit`** (`int`) — The maximum number of customers to return. Maximum is 1000.
+- **`tags`** (`[]id`) — List of tags to be filtered.
+  - ID type: `tag`
+
+## Input Port: `block_callback`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `block_start`
+
+- **`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.
+- **`display_picture`** (`composite`)
+  - Composite: `_gen:user-base-properties.display_picture`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `artifact`
+- **`email`** (`text`) — Email address of the user.
+- **`full_name`** (`text`) — Full name of the user.
+- **`is_verified`** (`bool`) — Whether the customer is verified or not.
+- **`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.
+- **`rev_org`** (`composite`)
+  - Composite: `_gen:rev_org`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `account`, `rev_org`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `revo`
+- **`state`** (`enum`) — State of the user.
+  - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+- **`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`
+- **`external_ref`** (`text`) — External ref is a mutable unique identifier for a user within the Customer 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.

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

@@ -0,0 +1,75 @@
+# `loop_over_dev_users` — Schema Reference
+
+## Input Port: `input`
+
+- **`created_date`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:created_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`email`** (`[]text`) — Filters Dev users based on email addresses.
+- **`modified_date`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:modified_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`phone_numbers`** (`[]text`) — List of phone numbers, in E.164 format, to filter Dev users on.
+- **`state`** (`[]enum`) — Filters Dev users based on state.
+  - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+- **`timezone`** (`[]text`) — Filters for Dev users in the specified time zone in IANA format (e.g., 'America/Los_Angeles').
+- **`limit`** (`int`) — The maximum number of dev users to return. Maximum is 1000.
+
+## Input Port: `block_callback`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `block_start`
+
+- **`id`** (`id`) **REQUIRED** — The ID of the current dev user.
+  - ID type: `devu`
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`display_name`** (`text`) — The display name of the current dev user.
+- **`full_name`** (`text`) — Full name of the user.
+- **`email`** (`text`) — Email address of the user.
+- **`state`** (`enum`) — State of the user.
+  - Allowed: `active`, `deactivated`, `deleted`, `locked`, `shadow`, `unassigned`
+- **`availability_modes`** (`[]composite`) — The availability modes of the user. Stock allowed values: ```   {     "id": 1,     "label": "Ticket",     "ordinal": 1,     "overridable": false   },   {     "id": 2,     "label": "Conversation",     "ordinal": 2,     "overridable": false   },   {     "id": 3,     "label": "Issue",     "ordinal": 3,     "overridable": false   },   {     "id": 4,     "label": "Incident",     "ordinal": 4,     "overridable": false   },   {     "id": 5,     "label": "Away",     "ordinal": 5,     "overridable": false   },   {     "id": 6,     "label": "Sick",     "ordinal": 6,     "overridable": false   },   {     "id": 7,     "label": "Lunch",     "ordinal": 7,     "overridable": false   },   {     "id": 8,     "label": "Travel",     "ordinal": 8,     "overridable": false   },   {     "id": 9,     "label": "Vacation",     "ordinal": 9,     "overridable": false   } ```
+  - Composite: `_gen:availability_modes`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`display_picture`** (`composite`)
+  - Composite: `_gen:user-base-properties.display_picture`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `artifact`
+- **`experience_start_date`** (`timestamp`) — Start date of the user's employment.
+- **`job_history`** (`[]composite`) — Job history of the user.
+  - Composite: `_gen:job_history`
+  - **`employment_status`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:employment_status`
+  - **`end_date`** (`timestamp`) — The end date of the job, or not specified if current.
+  - **`is_current`** (`bool`) — Is this the current active job for the user.
+  - **`location`** (`text`) — The job location for the user.
+  - **`start_date`** (`timestamp`) — The start date of the job.
+  - **`title`** (`text`) — The job title for the user.
+- **`phone_numbers`** (`[]text`) — Phone numbers of the user.
+- **`reports_to`** (`composite`)
+  - Composite: `_gen:reports_to`
+  - **`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`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`
+- **`skills`** (`[]composite`) — Array of skills of the user.
+  - Composite: `_gen:skills`
+  - **`name`** (`text`) — Name of the skill.
+- **`timezone`** (`text`) — The user's timezone in IANA Time Zone format (e.g., 'Asia/Kolkata', 'America/New_York').

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

@@ -0,0 +1,112 @@
+# `loop_over_enhancements` — Schema Reference
+
+## Input Port: `input`
+
+- **`accounts`** (`[]id`) — Filters for enhancement by its accounts.
+  - ID type: `account`
+- **`actual_close_date_v2`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:actual_close_date_v2`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`actual_start_date_v2`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:actual_start_date_v2`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`opportunities`** (`[]id`) — Filters for enhancement by its opportunities.
+  - ID type: `opportunity`
+- **`stage_v2`** (`[]id`) — List of IDs of the custom stages which will be used for filtering.
+  - ID type: `custom_stage`
+- **`target_close_date_v2`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:target_close_date_v2`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`target_start_date_v2`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:target_start_date_v2`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`tickets`** (`[]id`) — Filters for enhancement by its tickets.
+  - ID type: `ticket`
+- **`parent_part`** (`composite`) — The filter for specifying parent part.
+  - Composite: `_gen:parent_part`
+  - **`level`** (`int`) — Number of levels to fetch the part hierarchy up to.
+  - **`parts`** (`[]id`) **REQUIRED** — Part IDs to fetch the hierarchy for.
+    - ID type: `capability`, `enhancement`, `feature`, `product`
+- **`tags`** (`[]id`) — Filters for part with any of the provided tags.
+  - ID type: `tag`
+- **`owned_by`** (`[]id`) — Filters for enhancements owned by any of these users.
+  - ID type: `devu`, `sysu`, `svcacc`
+- **`created_by`** (`[]id`) — Filters for enhancements created by any of these users.
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`limit`** (`int`) — The maximum number of enhancements to return.Maximum is 1000.
+
+## Input Port: `block_callback`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `block_start`
+
+- **`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`) — 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** — ID of the user
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`created_date`** (`timestamp`) — Timestamp when the Enhancement was created.
+- **`description`** (`text`) — Description of the Enhancement.
+- **`display_id`** (`text`) — Human-readable Enhancement 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** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`modified_date`** (`timestamp`) — Timestamp when the Enhancement was modified.
+- **`name`** (`text`) **REQUIRED** — Name of the Enhancement.
+- **`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** — ID of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `service_account`, `sys_user`
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - 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** — The 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/loop_over_incidents.md

@@ -0,0 +1,113 @@
+# `loop_over_incidents` — Schema Reference
+
+## Input Port: `input`
+
+- **`created_date`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:created_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`include_child_parts`** (`bool`) — Whether to include items belonging to children of any of the provided parts.
+- **`mitigated_date`** (`composite`) — Provides ways to specify date ranges on objects.
+  - Composite: `_gen:mitigated_date`
+  - **`after`** (`timestamp`) — Filters for objects created after the provided timestamp (inclusive).
+  - **`before`** (`timestamp`) — Filters for objects created before the provided timestamp (inclusive).
+  - **`type`** (`enum`) **REQUIRED** — Type of date filter.
+    - Allowed: `range`
+- **`stage`** (`[]id`) — Filters for incidents in any of the provided stages.
+  - ID type: `custom_stage`
+- **`owned_by`** (`[]id`) — Filters for incidents owned by internal users only.
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`created_by`** (`[]id`) — Filters for incidents created by internal users only.
+  - ID type: `devu`, `svcacc`, `sysu`
+- **`applies_to_parts`** (`[]id`) — Filters for incidents that apply to any of the provided parts.
+  - ID type: `product`, `feature`, `capability`, `enhancement`, `runnable`, `linkable`
+- **`stages`** (`[]id`) — List of IDs of the custom stages which will be used for filtering.
+  - ID type: `custom_stage`
+- **`limit`** (`int`) — The maximum number of incidents to return. Maximum is 1000.
+
+## Input Port: `block_callback`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `block_start`
+
+- **`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`, `enhancement`, `feature`, `linkable`, `product`, `runnable`
+- **`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.
+  - **`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`, `service_account`, `sys_user`
+  - **`id`** (`id`) **REQUIRED** — The id of the user.
+    - ID type: `devu`, `svcacc`, `sysu`
+- **`created_date`** (`timestamp`) — Timestamp when the incident 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`
+- **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+- **`modified_date`** (`timestamp`) — Timestamp when the incident 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.
+  - **`email`** (`text`) — Email address of the user.
+  - **`id`** (`id`) **REQUIRED** — ID of the user.
+    - ID type: `devu`, `svcacc`, `sysu`
+- **`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 properties of an enum value.
+  - Composite: `_gen:reported_by`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+  - **`ordinal`** (`int`) **REQUIRED** — Used for determining the relative order of the enum value.
+- **`severity`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:severity`
+  - **`id`** (`int`) **REQUIRED** — The unique ID of the enum value.
+  - **`label`** (`text`) **REQUIRED** — The display label of the enum value.
+  - **`value`** (`json_value`) — The actual value of the enum value.
+- **`stage`** (`composite`) — Describes the current stage of a object.
+  - Composite: `_gen:stage`
+  - **`state`** (`composite`) — The state of the incident
+    - Composite: `_gen:state`
+  - **`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`