@devrev-computer/skills 1.0.0

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

@@ -0,0 +1,225 @@
+# `watch_ticket_for_updates` — 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: `applies_to_part`, `artifacts`, `body`, `channels`, `group`, `owned_by`, `reported_by`, `rev_org`, `severity`, `source_channel`... (15 total)
+- **`id`** (`id`) **REQUIRED** — The object to watch for updates
+  - ID type: `ticket`
+
+## Input Port: `callback`
+
+- **`event`** (`rich_text`) **REQUIRED** — The event that triggered the callback
+
+## Output Port: `output`
+
+- **`actual_close_date`** (`timestamp`) — Timestamp when the work was actually completed.
+- **`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`
+  - **`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.
+- **`channels`** (`[]enum`) — Channels of the ticket.
+  - Allowed: `email`, `plug`, `slack`, `twilio`, `twilio_sms`
+- **`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.
+- **`custom_fields`** (`composite`) — Custom fields.
+  - Composite: `_gen:custom_fields`
+
+- **`custom_schema_fragments`** (`[]id`) — Custom schema fragments.
+  - ID type: `app_fragment`, `custom_type_fragment`, `stock_sf`, `tenant_fragment`
+- **`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).
+- **`group`** (`composite`)
+  - Composite: `_gen:group`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`member_type`** (`enum`) — Type of the members in the group.
+    - Allowed: `dev_user`, `rev_user`
+  - **`name`** (`text`) — Name of the group.
+  - **`sync_metadata`** (`composite`) — Sync information for records synced into/from DevRev.
+    - Composite: `_gen:sync_metadata`
+- **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+- **`is_frozen`** (`bool`) — Whether the object is frozen or not.
+- **`is_spam`** (`bool`) — Whether the ticket is spam.
+- **`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.
+- **`needs_response`** (`bool`) — Whether the ticket needs a response.
+- **`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`
+- **`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`
+- **`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`
+- **`sentiment`** (`composite`) — The properties of an enum value.
+  - Composite: `_gen:sentiment`
+  - **`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.
+- **`sentiment_modified_date`** (`timestamp`) — Timestamp when the sentiment was last modified.
+- **`sentiment_summary`** (`text`) — Summary justifying the sentiment.
+- **`severity`** (`enum`) — Severity of the ticket.
+  - Allowed: `blocker`, `high`, `low`, `medium`
+- **`sla_summary`** (`composite`) — SLA summary for the object.
+  - Composite: `_gen:sla_summary`
+
+- **`sla_tracker`** (`composite`)
+  - Composite: `_gen:ticket-properties.sla_tracker`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+- **`source_channel`** (`text`) — Source channel of the ticket.
+- **`stage`** (`composite`) — Describes the current stage of a work item.
+  - Composite: `_gen:stage`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`name`** (`text`) — The human readable name of the stage.
+- **`state_display_name`** (`text`) — Display name for current state.
+- **`stock_schema_fragment`** (`id`) — Stock schema fragment.
+  - ID type: `app_fragment`, `custom_type_fragment`, `stock_sf`, `tenant_fragment`
+- **`subtype`** (`text`) — Subtype corresponding to the custom type fragment.
+- **`sync_metadata`** (`composite`) — Sync information for records synced into/from DevRev.
+  - Composite: `_gen:work-base-properties.sync_metadata`
+  - **`external_record_id`** (`text`) — ID of the record in the external system.
+  - **`external_record_type`** (`text`) — Type of the external record in the external system.
+  - **`external_reference`** (`text`) — External record URL.
+  - **`origin_system`** (`text`) — Where the record was first created.
+- **`tags`** (`[]composite`) — Tags associated with the object.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+  - **`value`** (`text`) — The value for the object's association with the tag.
+- **`target_close_date`** (`timestamp`) — Timestamp when the work is expected to be complete.
+- **`title`** (`text`) **REQUIRED** — Title of the work object.
+- **`type`** (`enum`) **REQUIRED**
+  - Allowed: `issue`, `opportunity`, `task`, `ticket`
+- **`old_ticket`** (`composite`) — Old ticket object
+  - Composite: `_gen:implicit:ticket`
+  - **`actual_close_date`** (`timestamp`) — Timestamp when the work was actually completed.
+  - **`applies_to_part`** (`composite`)
+    - Composite: `_gen:applies_to_part`
+  - **`artifacts`** (`[]composite`)
+    - Composite: `_gen:artifact-summary`
+  - **`body`** (`text`) — Body of the work object.
+  - **`channels`** (`[]enum`) — Channels of the ticket.
+    - Allowed: `email`, `plug`, `slack`, `twilio`, `twilio_sms`
+  - **`created_by`** (`composite`)
+    - Composite: `_gen:created_by`
+  - **`created_date`** (`timestamp`) — Timestamp when the object was created.
+  - **`custom_fields`** (`composite`) — Custom fields.
+    - Composite: `_gen:custom_fields`
+  - **`custom_schema_fragments`** (`[]id`) — Custom schema fragments.
+    - ID type: `app_fragment`, `custom_type_fragment`, `stock_sf`, `tenant_fragment`
+  - **`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).
+  - **`group`** (`composite`)
+    - Composite: `_gen:group`
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`is_frozen`** (`bool`) — Whether the object is frozen or not.
+  - **`is_spam`** (`bool`) — Whether the ticket is spam.
+  - **`modified_by`** (`composite`)
+    - Composite: `_gen:modified_by`
+  - **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+  - **`needs_response`** (`bool`) — Whether the ticket needs a response.
+  - **`owned_by`** (`[]composite`) **REQUIRED**
+    - Composite: `_gen:user-summary`
+  - **`reported_by`** (`[]composite`)
+    - Composite: `_gen:user-summary`
+  - **`rev_org`** (`composite`)
+    - Composite: `_gen:rev_org`
+  - **`sentiment`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:sentiment`
+  - **`sentiment_modified_date`** (`timestamp`) — Timestamp when the sentiment was last modified.
+  - **`sentiment_summary`** (`text`) — Summary justifying the sentiment.
+  - **`severity`** (`enum`) — Severity of the ticket.
+    - Allowed: `blocker`, `high`, `low`, `medium`
+  - **`sla_summary`** (`composite`) — SLA summary for the object.
+    - Composite: `_gen:sla_summary`
+  - **`sla_tracker`** (`composite`)
+    - Composite: `_gen:ticket-properties.sla_tracker`
+  - **`source_channel`** (`text`) — Source channel of the ticket.
+  - **`stage`** (`composite`) — Describes the current stage of a work item.
+    - Composite: `_gen:stage`
+  - **`state_display_name`** (`text`) — Display name for current state.
+  - **`stock_schema_fragment`** (`id`) — Stock schema fragment.
+    - ID type: `app_fragment`, `custom_type_fragment`, `stock_sf`, `tenant_fragment`
+  - **`subtype`** (`text`) — Subtype corresponding to the custom type fragment.
+  - **`sync_metadata`** (`composite`) — Sync information for records synced into/from DevRev.
+    - Composite: `_gen:work-base-properties.sync_metadata`
+  - **`tags`** (`[]composite`) — Tags associated with the object.
+    - Composite: `_gen:tags`
+  - **`target_close_date`** (`timestamp`) — Timestamp when the work is expected to be complete.
+  - **`title`** (`text`) **REQUIRED** — Title of the work object.
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `issue`, `opportunity`, `task`, `ticket`

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

@@ -0,0 +1,17 @@
+# `web_search` — Schema Reference
+
+Calls a web search API with a query and returns results. Use this tool to get latest information from the internet. Should be used only as a last resort when information is not available inside DevRev knowledge.
+
+## Input Port: `input`
+
+- **`query`** (`text`) **REQUIRED** — The search query.
+  - Validation: min_len=1, max_len=400
+- **`max_results`** (`int`) — Number of results to fetch.
+  - Validation: gt=0
+
+## Output Port: `output`
+
+- **`results`** (`[]composite`) — Search results containing URLs and snippets.
+  - Composite: `web_search_result`
+  - **`url`** (`text`) **REQUIRED** — URL of the search result.
+  - **`snippet`** (`text`) — Snippet of the result content.

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

@@ -0,0 +1,24 @@
+# `while` — Schema Reference
+
+Executes a block of steps while a condition is true. Maximum iterations of 1000.
+
+## Input Port: `input`
+
+Schema: empty field descriptors (no explicit input fields). The loop condition is configured separately.
+
+## Input Port: `block_callback`
+
+- Type: BlockCallback
+- Schema: empty field descriptors (receives data back from the loop body block).
+
+## Output Port: `output`
+
+Schema: empty field descriptors. Execution continues from this port after the loop ends.
+
+## Output Port: `block_start`
+
+- **`iteration_number`** (`int`) — The current iteration number of the loop starting from 1.
+
+### Scope Variables
+
+- **`break`** (`bool`) — Breaks the loop. Default value is `true` for each iteration. Set to `false` within the loop body to continue iterating.

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

@@ -0,0 +1,75 @@
+# `widget_created` — Schema Reference
+
+## Input Port: `input`
+
+_No input fields (trigger or system-provided)._
+
+## 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`
+  - **`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`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`data_sources`** (`[]composite`) — Data sources provide the backing data tables for the widget.
+  - Composite: `_gen:data_sources`
+  - **`api`** (`composite`) — An API-backed data source.
+    - Composite: `_gen:api`
+  - **`data_source`** (`text`) — The ID of the data source. Meant to be set when the type is data_source.
+  - **`dimensions`** (`[]composite`) — The dimensions (or the extended dimensions) provided by the data source.  These are the categories that can be used to group or segment the measures.
+    - Composite: `_gen:dimensions`
+  - **`external_data_source`** (`composite`) — An referenced data source for a widget.
+    - Composite: `_gen:external_data_source`
+  - **`joins`** (`[]composite`) — A list of possible joins for the data source. Follows foreign key semantics.
+    - Composite: `_gen:joins`
+  - **`measures`** (`[]composite`) — The measures (or the extended measures) provided by the data source.  These are the numerical values that can be analyzed.
+    - Composite: `_gen:measures`
+  - **`oasis`** (`composite`) — An oasis backed data source.
+    - Composite: `_gen:data_sources.oasis`
+  - **`reference_name`** (`text`) **REQUIRED** — The reference name of the data source.
+  - **`type`** (`enum`) **REQUIRED** — The type of the data source.
+    - Allowed: `api`, `data_source`, `data_view`, `external_data_source`, `oasis`
+- **`description`** (`text`) **REQUIRED** — A brief summary of what the widget displays or represents.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`insights`** (`text`) — The insights associated with the widget for agent generated widgets.
+- **`is_draft`** (`bool`) — Whether the widget is a draft widget.
+- **`is_system`** (`bool`) — Whether the widget is a system widget.
+- **`layout`** (`[]composite`) **REQUIRED** — Layout of the widget. It determines the organization of the sub widgets.
+  - Composite: `_gen:layout`
+  - **`position`** (`composite`) — A grid position represents the location and size of a widget or section within  its container (dashboard, tab, or section).
+    - Composite: `_gen:position`
+  - **`reference_id`** (`text`) **REQUIRED** — The reference ID for the element to be laid out. It should be an ID of a tab, section, or widget.
+- **`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`
+  - **`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`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`name`** (`text`) — A unique identifying name for the widget (optional).
+- **`sub_widgets`** (`[]composite`) **REQUIRED** — A list of sub-widgets that the widget contains. Each widget can contain  multiple sub-widgets.
+  - Composite: `_gen:sub_widgets`
+  - **`query`** (`composite`) — The query for a widget. This includes measures and dimensions to be visualized.
+    - Composite: `_gen:query`
+  - **`reference_id`** (`text`) **REQUIRED** — A reference ID for the sub-widget. It should be unique within the widget.
+  - **`visualization`** (`composite`) — The visualization for a widget. This includes the type of visualization and any  configuration specific to that type.
+    - Composite: `_gen:visualization`
+- **`title`** (`text`) **REQUIRED** — The title of the widget.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `widget`

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

@@ -0,0 +1,98 @@
+# `widget_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: `data_sources`, `description`, `is_draft`, `layout`, `modified_date`, `name`, `sub_widgets`, `title`
+
+## 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`
+  - **`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`
+- **`created_date`** (`timestamp`) — Timestamp when the object was created.
+- **`data_sources`** (`[]composite`) — Data sources provide the backing data tables for the widget.
+  - Composite: `_gen:data_sources`
+  - **`api`** (`composite`) — An API-backed data source.
+    - Composite: `_gen:api`
+  - **`data_source`** (`text`) — The ID of the data source. Meant to be set when the type is data_source.
+  - **`dimensions`** (`[]composite`) — The dimensions (or the extended dimensions) provided by the data source.  These are the categories that can be used to group or segment the measures.
+    - Composite: `_gen:dimensions`
+  - **`external_data_source`** (`composite`) — An referenced data source for a widget.
+    - Composite: `_gen:external_data_source`
+  - **`joins`** (`[]composite`) — A list of possible joins for the data source. Follows foreign key semantics.
+    - Composite: `_gen:joins`
+  - **`measures`** (`[]composite`) — The measures (or the extended measures) provided by the data source.  These are the numerical values that can be analyzed.
+    - Composite: `_gen:measures`
+  - **`oasis`** (`composite`) — An oasis backed data source.
+    - Composite: `_gen:data_sources.oasis`
+  - **`reference_name`** (`text`) **REQUIRED** — The reference name of the data source.
+  - **`type`** (`enum`) **REQUIRED** — The type of the data source.
+    - Allowed: `api`, `data_source`, `data_view`, `external_data_source`, `oasis`
+- **`description`** (`text`) **REQUIRED** — A brief summary of what the widget displays or represents.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`insights`** (`text`) — The insights associated with the widget for agent generated widgets.
+- **`is_draft`** (`bool`) — Whether the widget is a draft widget.
+- **`is_system`** (`bool`) — Whether the widget is a system widget.
+- **`layout`** (`[]composite`) **REQUIRED** — Layout of the widget. It determines the organization of the sub widgets.
+  - Composite: `_gen:layout`
+  - **`position`** (`composite`) — A grid position represents the location and size of a widget or section within  its container (dashboard, tab, or section).
+    - Composite: `_gen:position`
+  - **`reference_id`** (`text`) **REQUIRED** — The reference ID for the element to be laid out. It should be an ID of a tab, section, or widget.
+- **`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`
+  - **`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`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`name`** (`text`) — A unique identifying name for the widget (optional).
+- **`sub_widgets`** (`[]composite`) **REQUIRED** — A list of sub-widgets that the widget contains. Each widget can contain  multiple sub-widgets.
+  - Composite: `_gen:sub_widgets`
+  - **`query`** (`composite`) — The query for a widget. This includes measures and dimensions to be visualized.
+    - Composite: `_gen:query`
+  - **`reference_id`** (`text`) **REQUIRED** — A reference ID for the sub-widget. It should be unique within the widget.
+  - **`visualization`** (`composite`) — The visualization for a widget. This includes the type of visualization and any  configuration specific to that type.
+    - Composite: `_gen:visualization`
+- **`title`** (`text`) **REQUIRED** — The title of the widget.
+- **`old_widget`** (`composite`) — Old widget object
+  - Composite: `_gen:implicit:widget`
+  - **`created_by`** (`composite`)
+    - Composite: `_gen:created_by`
+  - **`created_date`** (`timestamp`) — Timestamp when the object was created.
+  - **`data_sources`** (`[]composite`) — Data sources provide the backing data tables for the widget.
+    - Composite: `_gen:data_sources`
+  - **`description`** (`text`) **REQUIRED** — A brief summary of what the widget displays or represents.
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`id`** (`text`) **REQUIRED** — Globally unique object ID.
+  - **`insights`** (`text`) — The insights associated with the widget for agent generated widgets.
+  - **`is_draft`** (`bool`) — Whether the widget is a draft widget.
+  - **`is_system`** (`bool`) — Whether the widget is a system widget.
+  - **`layout`** (`[]composite`) **REQUIRED** — Layout of the widget. It determines the organization of the sub widgets.
+    - Composite: `_gen:layout`
+  - **`modified_by`** (`composite`)
+    - Composite: `_gen:modified_by`
+  - **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+  - **`name`** (`text`) — A unique identifying name for the widget (optional).
+  - **`sub_widgets`** (`[]composite`) **REQUIRED** — A list of sub-widgets that the widget contains. Each widget can contain  multiple sub-widgets.
+    - Composite: `_gen:sub_widgets`
+  - **`title`** (`text`) **REQUIRED** — The title of the widget.
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `widget`

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

@@ -0,0 +1,20 @@
+# `workspace_created` — Schema Reference
+
+## Input Port: `input`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `output`
+
+- **`account`** (`composite`) — The account associated with the workspace.
+  - Composite: `_gen:account`
+  - **`display_name`** (`text`) — Name of the Organization.
+  - **`id`** (`id`) **REQUIRED** — The id of the account.
+    - ID type: `account`
+- **`description`** (`text`) — The description of the workspace.
+- **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+- **`display_name`** (`text`) — Name of the Organization.
+- **`domain`** (`text`) — The domain of the workspace.
+- **`external_ref`** (`text`) — The external reference of the workspace.
+- **`id`** (`id`) **REQUIRED** — The id of the workspace.
+  - ID type: `revo`