@devrev-computer/skills 1.0.0

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

@@ -0,0 +1,88 @@
+# `incident_created` — Schema Reference
+
+## Input Port: `input`
+
+_No input fields (trigger or system-provided)._
+
+## 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`) — Parts to which the incident is applicable to.
+  - 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.
+  - **`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`, `sys_user`, `service_account`
+- **`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`, `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 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`) — 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 properties of an enum value.
+  - Composite: `_gen:source`
+- **`stage`** (`composite`) — Stage of the incident.
+  - Composite: `_gen:stage`
+  - **`stage`** (`composite`) — The stage of the incident.
+    - Composite: `stage.stage`
+  - **`state`** (`composite`) — The state of the incident
+    - Composite: `_gen:state`
+- **`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/incident_updated.md

@@ -0,0 +1,126 @@
+# `incident_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: `title`, `body`, `applies_to_part`, `owned_by`, `target_close_date`, `identified_date`, `acknowledged_date`, `mitigated_date`, `actual_close_date`, `severity`... (17 total)
+
+## 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`) — Parts to which the incident is applicable to.
+  - 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.
+  - **`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`, `sys_user`, `service_account`
+- **`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`
+- **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+- **`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.
+  - **`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`, `sys_user`, `service_account`
+- **`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`) — 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 properties of an enum value.
+  - Composite: `_gen:source`
+- **`stage`** (`composite`) — Stage of the incident.
+  - Composite: `_gen:stage`
+  - **`stage`** (`composite`) — The stage of the incident.
+    - Composite: `stage.stage`
+  - **`state`** (`composite`) — The state of the incident
+    - Composite: `_gen:state`
+- **`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.
+- **`old_incident`** (`composite`) — Old incident object
+  - Composite: `_gen:implicit:incident`
+  - **`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`
+  - **`body`** (`text`) — Body of the incident.
+  - **`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`
+  - **`mitigated_date`** (`timestamp`) — Timestamp when the incident was mitigated.
+  - **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+  - **`owned_by`** (`[]composite`)
+    - Composite: `_gen:user-summary`
+  - **`pia`** (`[]composite`)
+    - Composite: `_gen:article-summary`
+  - **`playbooks`** (`[]composite`)
+    - Composite: `_gen:article-summary_95fca9c7`
+  - **`reported_by`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:reported_by`
+  - **`severity`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:severity`
+  - **`source`** (`composite`) — The properties of an enum value.
+    - Composite: `_gen:source`
+  - **`tags`** (`[]composite`) — Tags associated with the object.
+    - Composite: `_gen:tags`
+  - **`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 updated incident.
+    - ID type: `incident`
+- **`id`** (`id`) **REQUIRED** — ID of the udpated incident.
+  - ID type: `incident`

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

@@ -0,0 +1,67 @@
+# `init_variable` — Schema Reference
+
+Initializes a variable of a given type. Used to create scope variables that can be modified by `set_variable` steps (typically inside loops) and read later by `$get_variable()`.
+
+## Input Port: `input`
+
+Schema is **dynamic** (Overridden by schema handler), but the template pattern is well-defined:
+
+```json
+"input_ports": [{"name": "input", "schema": {"field_descriptors": [
+  {"field_type": "composite", "composite_type": "devrev:schema", "data_name": "variables", "db_name": "variables",
+   "description": "The variables to initialize.", "name": "variables", "oasis": {"name": "variables"}}
+], "invalidate_on_field_update": ["variables"], "type": "field_descriptor"}, "type": "default"}]
+```
+
+## Input Values
+
+Define the variable(s) as a schema with fields:
+
+```json
+"input_values": [{"port_name": "input", "fields": [{"name": "variables", "value": {"type": "literal", "value": {
+  "fields": [{
+    "description": "",
+    "field_type": "text",
+    "is_filterable": false,
+    "name": "summary",
+    "ui": {
+      "create_view": {},
+      "detail_view": {"is_hidden": true},
+      "display_name": "summary",
+      "summary_view": {"is_hidden": true}
+    }
+  }]
+}}}]}]
+```
+
+Supported `field_type` values: `text`, `int`, `double`, `bool`, `timestamp`, `id`
+
+## Output Port: `output`
+
+The output port MUST include `scope_variables` — an array of field descriptors matching the variables defined in input_values:
+
+```json
+"output_ports": [
+  {"name": "output", "schema": {"type": "field_descriptor"},
+   "scope_variables": [{"field_descriptor": {
+     "field_type": "text", "data_name": "summary", "db_name": "summary", "description": "",
+     "is_filterable": false, "name": "summary", "oasis": {"name": "summary"},
+     "ui": {"create_view": {}, "detail_view": {"is_hidden": true}, "display_name": "summary", "summary_view": {"is_hidden": true}}
+   }}],
+   "type": "default"},
+  {"name": "error", "schema": {"field_descriptors": [
+    {"field_type": "text", "data_name": "message", "db_name": "message", "description": "Error message with more details about the error", "name": "message", "oasis": {"name": "message"}, "ui": {"display_name": "Error Message"}},
+    {"field_type": "enum", "allowed_values": ["bad_request", "not_found", "internal"], "data_name": "type", "db_name": "type", "description": "Type of the error", "name": "type", "oasis": {"name": "type"}, "ui": {"display_name": "Error Type"}}
+  ], "type": "field_descriptor"}, "type": "error"}
+]
+```
+
+## Reading Variables After Loop
+
+Use `$get_variable()` (NOT `$get()`) to read accumulated variable values after the loop:
+
+```
+{% expr $get_variable('init_variable_1','summary',{'output_port_name' : 'output'}) %}
+```
+
+Syntax: `$get_variable('<init_step_ref>', '<variable_name>', {'output_port_name': 'output'})`

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

@@ -0,0 +1,21 @@
+# `invoice_created` — Schema Reference
+
+## Input Port: `input`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `output`
+
+- **`status`** (`enum`) **REQUIRED** — Status of the invoice
+  - Allowed: `draft`, `finalized_pending`, `open`, `paid`, `posted`, `uncollectible`, `void`
+- **`due_date`** (`timestamp`) — Due date of the invoice
+- **`billing_email`** (`text`) **REQUIRED** — Email address for billing
+- **`total`** (`double`) **REQUIRED** — Total amount of the invoice
+- **`pdf_url`** (`text`) — URL to the invoice PDF
+- **`account`** (`composite`) — The account of the customer
+  - Composite: `account`
+  - **`display_name`** (`text`) — Display name of the account
+  - **`id`** (`id`) **REQUIRED** — ID of the account
+    - ID type: `account`
+- **`id`** (`id`) **REQUIRED** — The ID of the invoice
+  - ID type: `invoice`

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

@@ -0,0 +1,41 @@
+# `invoice_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. Only applicable in case of update events.
+  - Allowed: `pdf_url`, `due_date`, `total`, `items`, `status`
+
+## Output Port: `output`
+
+- **`status`** (`enum`) **REQUIRED** — Status of the invoice
+  - Allowed: `draft`, `finalized_pending`, `open`, `paid`, `posted`, `uncollectible`, `void`
+- **`due_date`** (`timestamp`) — Due date of the invoice
+- **`billing_email`** (`text`) **REQUIRED** — Email address for billing
+- **`total`** (`double`) **REQUIRED** — Total amount of the invoice
+- **`pdf_url`** (`text`) — URL to the invoice PDF
+- **`account`** (`composite`) — The account of the customer
+  - Composite: `account`
+  - **`display_name`** (`text`) — Display name of the account
+  - **`id`** (`id`) **REQUIRED** — ID of the account
+    - ID type: `account`
+- **`id`** (`id`) **REQUIRED** — The ID of the invoice
+  - ID type: `invoice`
+- **`items`** (`composite`) — Line items in the invoice
+  - Composite: `invoice_line_item`
+  - **`id`** (`id`) — ID of the line item
+    - ID type: `invoice_line_item`
+  - **`total`** (`double`) — Total amount for this line item
+- **`old_invoice`** (`composite`) — The previous state of the invoice
+  - Composite: `invoice`
+  - **`status`** (`enum`) **REQUIRED** — Status of the invoice
+    - Allowed: `draft`, `finalized_pending`, `open`, `paid`, `posted`, `uncollectible`, `void`
+  - **`due_date`** (`timestamp`) — Due date of the invoice
+  - **`billing_email`** (`text`) **REQUIRED** — Email address for billing
+  - **`total`** (`double`) **REQUIRED** — Total amount of the invoice
+  - **`pdf_url`** (`text`) — URL to the invoice PDF
+  - **`account`** (`composite`) — The account of the customer
+    - Composite: `account`
+  - **`id`** (`id`) **REQUIRED** — The ID of the invoice
+    - ID type: `invoice`
+  - **`items`** (`composite`) — Line items in the invoice
+    - Composite: `invoice_line_item`

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

@@ -0,0 +1,132 @@
+# `invoke_code` — Schema Reference
+
+Executes custom Python code within a workflow. Secure sandbox: 30s default timeout (max 120s), 256MB memory, 512KB output limit.
+
+**Template requirements:** Must include `input_ports`, `output_ports`, AND `input_values` with all three fields configured.
+
+## Input Port: `input`
+
+Standard input_ports schema (same for all invoke_code steps):
+
+```json
+"input_ports": [{
+  "name": "input",
+  "schema": {
+    "composite_schemas": [{
+      "description": "A variable",
+      "fields": [
+        {"field_type": "tokens", "data_name": "name", "db_name": "name", "description": "The name of the variable", "is_required": true, "name": "name", "oasis": {"name": "name"}},
+        {"field_type": "json_value", "data_name": "value", "db_name": "value", "description": "The value of the variable", "name": "value", "oasis": {"name": "value"}}
+      ],
+      "name": "variable"
+    }],
+    "field_descriptors": [
+      {"field_type": "array", "base_type": "composite", "composite_type": "variable", "data_name": "input_values", "db_name": "input_values", "description": "The input variables to pass to the code. The inputs will be passed to run(...) as a dictionary.", "name": "input_values", "oasis": {"name": "input_values"}},
+      {"field_type": "composite", "composite_type": "devrev:schema", "data_name": "output_schema", "db_name": "output_schema", "description": "The schema of the output variables to return from the code. The outputs should be returned from run(...) as a dictionary.", "name": "output_schema", "oasis": {"name": "output_schema"}},
+      {"field_type": "text", "data_name": "code", "db_name": "code", "default_value": "def run(inputs):\n    return {}", "description": "Write your code here. Do not update the run function signature.", "is_required": true, "name": "code", "oasis": {"name": "code"}, "ui": {}}
+    ],
+    "invalidate_on_field_update": ["output_schema", "input_values"],
+    "type": "field_descriptor"
+  },
+  "type": "default"
+}]
+```
+
+## Output Ports
+
+The `output` port must include resolved `field_descriptors` matching the `output_schema` fields. Plus the standard `error` port.
+
+```json
+"output_ports": [
+  {"name": "output", "schema": {"field_descriptors": [
+    {"field_type": "text", "data_name": "my_output", "db_name": "my_output", "description": "my_output", "name": "my_output", "oasis": {"name": "my_output"}}
+  ], "type": "field_descriptor"}, "type": "default"},
+  {"name": "error", "schema": {"field_descriptors": [
+    {"field_type": "text", "data_name": "message", "db_name": "message", "description": "Error message with more details about the error", "name": "message", "oasis": {"name": "message"}, "ui": {"display_name": "Error Message"}},
+    {"field_type": "enum", "allowed_values": ["bad_request", "not_found", "internal"], "data_name": "type", "db_name": "type", "description": "Type of the error", "name": "type", "oasis": {"name": "type"}, "ui": {"display_name": "Error Type"}}
+  ], "type": "field_descriptor"}, "type": "error"}
+]
+```
+
+## Input Values Pattern
+
+All three fields must be set in `input_values`:
+
+### `code` — uses `text_template` type (NOT `literal`)
+
+```json
+{
+  "name": "code",
+  "value": {
+    "type": "text_template",
+    "value": "import re\n\ndef run(inputs):\n    text = inputs.get('description', '')\n    cleaned = re.sub(r'\\bagent\\b', 'computer', text, flags=re.IGNORECASE)\n    return {'cleaned': cleaned}"
+  }
+}
+```
+
+### `input_values` — uses `composite_value_list` (NOT `composite_value`)
+
+```json
+{
+  "name": "input_values",
+  "value": {
+    "type": "list_value",
+    "value": {
+      "items": [{
+        "type": "composite_value_list",
+        "value": [{
+          "fields": [
+            {"name": "value", "value": {"type": "jsonata_expression", "value": "$get('trigger_1', 'output').description"}},
+            {"name": "name", "value": {"type": "literal", "value": "description"}}
+          ]
+        }]
+      }]
+    }
+  }
+}
+```
+
+### `output_schema` — literal with field definitions including UI metadata
+
+```json
+{
+  "name": "output_schema",
+  "value": {
+    "type": "literal",
+    "value": {
+      "fields": [{
+        "description": "",
+        "field_type": "text",
+        "is_filterable": false,
+        "name": "cleaned",
+        "ui": {
+          "create_view": {},
+          "detail_view": {"is_hidden": true},
+          "display_name": "cleaned",
+          "summary_view": {"is_hidden": true}
+        }
+      }]
+    }
+  }
+}
+```
+
+## Complete Working Example
+
+From production template "Knowledge Gaps Workflow V1":
+
+- Input: `object_ids` (array from hybrid_search output)
+- Code: extracts article ID from object IDs array
+- Output: `objectid` (text)
+
+```python
+def run(inputs):
+    object_ids = inputs.get("object_ids", [])
+    return {"objectid": f"ART-{object_ids[0].split('/')[-1]}" if object_ids else ""}
+```
+
+## Available Python Libraries
+
+`json`, `re`, `math`, `datetime`, `requests`, `collections`, `itertools`, `functools`, `string`, `random`, `decimal`, `statistics`, `typing`, `copy`, `textwrap`, `hashlib`, `hmac`, `secrets`, `base64`, `uuid`, `urllib`, `html`, `xml`, `csv`, `zipfile`, `gzip`, `zoneinfo`, `io`, `dataclasses`, `operator`
+
+**Blocked:** `os`, `sys`, `subprocess`, `shutil`, `pathlib`, `multiprocessing`, `threading`, `concurrent`, `pickle`

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

@@ -0,0 +1,105 @@
+# `issue_created` — Schema Reference
+
+## Input Port: `input`
+
+_No input fields (trigger or system-provided)._
+
+## Output Port: `output`
+
+- **`actual_close_date`** (`timestamp`) — Timestamp when the issue was actually completed.
+- **`actual_start_date`** (`timestamp`) — Actual start date for the issue.
+- **`applies_to_part`** (`composite`)
+  - Composite: `_gen:applies_to_part`
+  - **`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** — The id of the parts associated with issue.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`body`** (`text`) — The body of the issue.
+- **`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** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`created_date`** (`timestamp`) — Timestamp when the issue was created.
+- **`developed_with`** (`[]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** — The id of the part.
+    - ID type: `capability`, `feature`, `product`, `runnable`, `linkable`, `enhancement`
+- **`display_id`** (`text`) — Human-readable ID of the issue.
+- **`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.
+  - **`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`, `sys_user`, `service_account`
+- **`modified_date`** (`timestamp`) — Timestamp when the issue was last modified.
+- **`owned_by`** (`[]composite`) **REQUIRED**
+  - Composite: `_gen:user-summary`
+  - **`display_id`** (`text`) — Human-readable object ID unique to the Dev organization.
+  - **`display_name`** (`text`) — The user's display name. The name is non-unique and mutable.
+  - **`email`** (`text`) — Email address of the user.
+  - **`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** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`priority`** (`enum`) — The priority of the issue.
+  - 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.
+  - **`email`** (`text`) — Email address of 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** — The id of the user.
+    - ID type: `devu`, `sysu`, `svcacc`
+  - **`type`** (`enum`) **REQUIRED**
+    - Allowed: `dev_user`, `sys_user`, `service_account`
+- **`stage`** (`composite`) — The stage of the issue.
+  - 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`) — The tags associated with the issue.
+  - Composite: `_gen:tags`
+  - **`tag`** (`composite`)
+    - Composite: `_gen:tag`
+- **`target_close_date`** (`timestamp`) — The target close date of the issue.
+- **`target_start_date`** (`timestamp`) — The target start date of the issue.
+- **`title`** (`text`) **REQUIRED** — The title of the issue.
+- **`id`** (`id`) **REQUIRED** — The id of the issue.
+  - ID type: `issue`

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

@@ -0,0 +1,46 @@
+# `issue_sla_tracker_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: `stage`
+
+## Output Port: `output`
+
+- **`metric_target_summaries`** (`[]composite`) **REQUIRED** — Summary of the metrics target being tracked in the SLA tracker.
+  - Composite: `_gen:metric_target_summaries`
+  - **`breached_at`** (`timestamp`) — For breached metrics the time they entered into breach. This is the same as what the target date was, unless the breach happened due to a different policy starting to apply.
+  - **`completed_in`** (`int`) — For completed metrics the time (in minutes) it took to complete them. (Taking into account the schedule if any).
+  - **`completed_in_seconds`** (`int`) — For completed metrics the time (in seconds) it took to complete them. (Taking into account the schedule if any).
+  - **`is_out_of_schedule`** (`bool`) — If true, the schedule attached to this metric is out of schedule at the time of the query. It is not set for metrics in *completed* stage.
+  - **`metric_definition`** (`composite`)
+    - Composite: `_gen:metric_definition`
+  - **`next_schedule_transition`** (`timestamp`) — The next time the schedule will change its state, if such is known.
+  - **`org_schedule`** (`composite`)
+    - Composite: `_gen:org_schedule`
+  - **`org_schedule_version`** (`int`) — The version of the org schedule at the time this tracker was created.
+  - **`remaining_time`** (`int`) — Time in minutes that remains on a paused metric.
+  - **`target_time`** (`timestamp`) — Time at which the metric would breach SLA if no action taken.
+  - **`warning_target_time`** (`timestamp`) — Time at which the metric would reach the SLA warning limit if no action taken.
+  - **`stage`** (`enum`) **REQUIRED** — SLA stage of the object being tracked.
+    - Allowed: `active`, `breached`, `completed`, `paused`, `warning`
+  - **`status`** (`enum`) **REQUIRED** — Status of the object being tracked.
+    - Allowed: `hit`, `in_progress`, `miss`
+- **`modified_date`** (`timestamp`) — Timestamp when the object was last modified.
+- **`sla`** (`composite`)
+  - Composite: `_gen:sla`
+  - **`name`** (`text`) **REQUIRED** — Human-readable name.
+  - **`status`** (`enum`) **REQUIRED** — Status determines how an item can be used. In 'draft' status an item can be edited but can't be used. When 'published' the item can longer be edited but can be used. 'Archived' is read-only.
+    - Allowed: `archived`, `draft`, `published`
+  - **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+    - ID type: `sla`
+  - **`sla_type`** (`enum`) **REQUIRED** — Type of the SLA. Internal - for internal objects (issues, etc) external - for customer facing objects (tickets, conversations etc)
+    - Allowed: `external`, `internal`
+- **`id`** (`id`) **REQUIRED** — Globally unique object ID.
+  - ID type: `sla_tracker`
+- **`applies_to_id`** (`id`) **REQUIRED** — The id of the issue.
+  - ID type: `issue`
+- **`stage`** (`enum`) **REQUIRED** — SLA stage of the object being tracked.
+  - Allowed: `active`, `breached`, `completed`, `paused`, `warning`
+- **`status`** (`enum`) **REQUIRED** — Status of the object being tracked.
+  - Allowed: `hit`, `in_progress`, `miss`