@xemahq/dsl 0.8.2 → 0.9.0

package/schema/action.schema.json

@@ -4,18 +4,36 @@
   "title": "Xema Action Manifest",
   "description": "Declarative manifest for a single action version. Manifests live in plugins/software-dev/workflow-config/actions/ and are seeded into the workflow-engine action registry.",
   "type": "object",
-  "required": ["apiVersion", "kind", "metadata", "spec"],
+  "required": [
+    "apiVersion",
+    "kind",
+    "metadata",
+    "spec"
+  ],
   "additionalProperties": false,
   "properties": {
-    "apiVersion": { "type": "string", "const": "xema.dev/workflow/v1alpha1" },
-    "kind": { "type": "string", "const": "Action" },
-    "metadata": { "$ref": "#/$defs/Metadata" },
-    "spec": { "$ref": "#/$defs/Spec" }
+    "apiVersion": {
+      "type": "string",
+      "const": "xema.dev/workflow/v1alpha1"
+    },
+    "kind": {
+      "type": "string",
+      "const": "Action"
+    },
+    "metadata": {
+      "$ref": "#/$defs/Metadata"
+    },
+    "spec": {
+      "$ref": "#/$defs/Spec"
+    }
   },
   "$defs": {
     "Metadata": {
       "type": "object",
-      "required": ["id", "version"],
+      "required": [
+        "id",
+        "version"
+      ],
       "additionalProperties": false,
       "properties": {
         "id": {
@@ -27,17 +45,44 @@
           "type": "string",
           "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$"
         },
-        "title": { "type": "string", "maxLength": 120 },
-        "description": { "type": "string", "maxLength": 4000 }
+        "title": {
+          "type": "string",
+          "maxLength": 120
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 4000
+        }
       }
     },
     "Spec": {
       "type": "object",
-      "required": ["executionKind", "taskQueue", "inputs", "outputs", "permissions", "retryDefaults", "timeoutDefaults"],
+      "required": [
+        "executionKind",
+        "taskQueue",
+        "inputs",
+        "outputs",
+        "permissions",
+        "retryDefaults",
+        "timeoutDefaults"
+      ],
       "additionalProperties": false,
       "properties": {
-        "executionKind": { "type": "string", "enum": ["activity", "child_workflow"] },
-        "taskQueue": { "type": "string", "enum": ["xema_default", "xema_agent", "xema_human"] },
+        "executionKind": {
+          "type": "string",
+          "enum": [
+            "activity",
+            "child_workflow"
+          ]
+        },
+        "taskQueue": {
+          "type": "string",
+          "enum": [
+            "xema_default",
+            "xema_agent",
+            "xema_human"
+          ]
+        },
         "actionKind": {
           "type": "string",
           "description": "Semantic category — drives consumer presentation (FE canvas shape, badge icon). Optional; omitted manifests are treated as 'generic'. Closed list mirrors `ActionKind` in `@xemahq/workflow-contracts`.",
@@ -88,40 +133,122 @@
           "description": "Minimum permission scope this action requires.",
           "additionalProperties": false,
           "properties": {
-            "repos": { "type": "string", "enum": ["none", "read", "limited", "write"] },
-            "kb": { "type": "string", "enum": ["none", "read", "limited", "write"] },
-            "backlog": { "type": "string", "enum": ["none", "read", "limited", "write"] },
-            "integrations": { "type": "string", "enum": ["none", "read", "limited", "write"] },
-            "artifacts": { "type": "string", "enum": ["none", "read", "limited", "write"] }
+            "artifacts": {
+              "type": "string",
+              "enum": [
+                "none",
+                "read",
+                "limited",
+                "write"
+              ]
+            },
+            "backlog": {
+              "type": "string",
+              "enum": [
+                "none",
+                "read",
+                "limited",
+                "write"
+              ]
+            },
+            "connectors": {
+              "type": "string",
+              "enum": [
+                "none",
+                "read",
+                "limited",
+                "write"
+              ]
+            },
+            "kb": {
+              "type": "string",
+              "enum": [
+                "none",
+                "read",
+                "limited",
+                "write"
+              ]
+            },
+            "memory": {
+              "type": "string",
+              "enum": [
+                "none",
+                "read",
+                "limited",
+                "write"
+              ]
+            },
+            "repos": {
+              "type": "string",
+              "enum": [
+                "none",
+                "read",
+                "limited",
+                "write"
+              ]
+            }
           }
         },
         "allowedMounts": {
           "type": "array",
-          "items": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$" },
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$"
+          },
           "uniqueItems": true
         },
         "retryDefaults": {
           "type": "object",
-          "required": ["maxAttempts", "initialInterval", "backoffCoefficient", "maximumInterval"],
+          "required": [
+            "maxAttempts",
+            "initialInterval",
+            "backoffCoefficient",
+            "maximumInterval"
+          ],
           "additionalProperties": false,
           "properties": {
-            "maxAttempts": { "type": "integer", "minimum": 1, "maximum": 20 },
-            "initialInterval": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" },
-            "backoffCoefficient": { "type": "number", "minimum": 1.0, "maximum": 10.0 },
-            "maximumInterval": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" },
+            "maxAttempts": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 20
+            },
+            "initialInterval": {
+              "type": "string",
+              "pattern": "^([1-9][0-9]*)(s|m|h)$"
+            },
+            "backoffCoefficient": {
+              "type": "number",
+              "minimum": 1.0,
+              "maximum": 10.0
+            },
+            "maximumInterval": {
+              "type": "string",
+              "pattern": "^([1-9][0-9]*)(s|m|h)$"
+            },
             "nonRetryableErrorTypes": {
               "type": "array",
-              "items": { "type": "string", "minLength": 1 }
+              "items": {
+                "type": "string",
+                "minLength": 1
+              }
             }
           }
         },
         "timeoutDefaults": {
           "type": "object",
-          "required": ["startToClose"],
+          "required": [
+            "startToClose"
+          ],
           "additionalProperties": false,
           "properties": {
-            "startToClose": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" },
-            "heartbeat": { "type": "string", "pattern": "^([1-9][0-9]*)(s|m|h)$" }
+            "startToClose": {
+              "type": "string",
+              "pattern": "^([1-9][0-9]*)(s|m|h)$"
+            },
+            "heartbeat": {
+              "type": "string",
+              "pattern": "^([1-9][0-9]*)(s|m|h)$"
+            }
           }
         },
         "auditEventMapping": {
@@ -129,36 +256,58 @@
           "description": "Mapping from step lifecycle to audit-log-api event code.",
           "additionalProperties": false,
           "properties": {
-            "started": { "type": "string", "minLength": 1 },
-            "succeeded": { "type": "string", "minLength": 1 },
-            "failed": { "type": "string", "minLength": 1 }
+            "started": {
+              "type": "string",
+              "minLength": 1
+            },
+            "succeeded": {
+              "type": "string",
+              "minLength": 1
+            },
+            "failed": {
+              "type": "string",
+              "minLength": 1
+            }
           }
         },
         "consumes": {
           "type": "array",
-          "description": "Declarative contracts the action opts into. The DSL compiler reads this list to decide which validation lanes apply — e.g. the `workspace-manifest@v1` entry enables the manifest-source lane (`agentRef` required) and the frontend canvas Inspector renders the manifest picker.",
-          "items": { "$ref": "#/$defs/ActionContract" }
+          "description": "Declarative contracts the action opts into. The `session-launch@v1` entry enables canonical Session launch validation.",
+          "items": {
+            "$ref": "#/$defs/ActionContract"
+          }
         }
       }
     },
     "ActionContract": {
-      "description": "Versioned consume-contract declaration. Kinds: `workspace-manifest@v1` (manifest-source lane, `agentRef` required) and `agent-composition@v1` (`with.composition` slug@version reference).",
-      "oneOf": [
-        { "$ref": "#/$defs/WorkspaceManifestActionContract" },
-        { "$ref": "#/$defs/AgentCompositionActionContract" }
-      ]
+      "$ref": "#/$defs/SessionLaunchActionContract"
     },
-    "WorkspaceManifestActionContract": {
+    "SessionLaunchActionContract": {
       "type": "object",
-      "required": ["kind", "version"],
+      "required": [
+        "kind",
+        "version"
+      ],
       "additionalProperties": false,
       "properties": {
-        "kind": { "type": "string", "const": "workspace-manifest" },
-        "version": { "type": "string", "const": "v1" },
+        "kind": {
+          "type": "string",
+          "const": "session-launch"
+        },
+        "version": {
+          "type": "string",
+          "const": "v1"
+        },
         "surfaces": {
           "type": "array",
           "description": "Restricts the surfaces the action can be invoked on. Must intersect the manifest's `metadata.surfaceCompat`.",
-          "items": { "type": "string", "enum": ["workflow", "agent-session"] },
+          "items": {
+            "type": "string",
+            "enum": [
+              "workflow",
+              "agent-session"
+            ]
+          },
           "uniqueItems": true
         },
         "roleHint": {
@@ -166,16 +315,6 @@
           "description": "Pins the manifest's `spec.agent.role` to a closed `AgentRunRole`. Compile-time fail when a workflow points the action at a manifest whose role doesn't match."
         }
       }
-    },
-    "AgentCompositionActionContract": {
-      "type": "object",
-      "required": ["kind", "version"],
-      "additionalProperties": false,
-      "description": "Opts the action into the `with.composition` field — a `slug@version` reference to an Agent Composition resolved at dispatch time by the runtime.",
-      "properties": {
-        "kind": { "type": "string", "const": "agent-composition" },
-        "version": { "type": "string", "const": "v1" }
-      }
     }
   }
 }