akm-cli 0.9.0-rc.1 → 0.9.0-rc.2

package/dist/schemas/akm-task.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://itlackey.github.io/akm/schemas/akm-task.json",
+  "title": "AKM Scheduled Task",
+  "description": "Strict version-2 YAML task definition. Exactly one target is required.",
+  "type": "object",
+  "required": ["version", "schedule"],
+  "additionalProperties": false,
+  "properties": {
+    "version": { "const": 2 },
+    "name": { "type": "string" },
+    "description": { "type": "string" },
+    "when_to_use": { "type": "string" },
+    "tags": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+    "schedule": { "type": "string", "minLength": 1 },
+    "enabled": { "type": "boolean" },
+    "workflow": { "type": "string", "minLength": 1 },
+    "prompt": { "type": "string", "minLength": 1 },
+    "command": {
+      "oneOf": [
+        { "type": "string", "minLength": 1 },
+        { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+      ]
+    },
+    "params": { "type": "object" },
+    "engine": { "type": "string", "minLength": 1 },
+    "model": { "type": "string", "minLength": 1 },
+    "timeoutMs": { "type": ["integer", "null"], "minimum": 1 },
+    "llm": { "$ref": "#/definitions/llm" }
+  },
+  "oneOf": [
+    {
+      "required": ["workflow"],
+      "not": { "anyOf": [{ "required": ["prompt"] }, { "required": ["command"] }, { "required": ["engine"] }, { "required": ["model"] }, { "required": ["timeoutMs"] }, { "required": ["llm"] }] }
+    },
+    {
+      "required": ["prompt"],
+      "not": { "anyOf": [{ "required": ["workflow"] }, { "required": ["command"] }, { "required": ["params"] }] }
+    },
+    {
+      "required": ["command"],
+      "not": { "anyOf": [{ "required": ["workflow"] }, { "required": ["prompt"] }, { "required": ["params"] }, { "required": ["engine"] }, { "required": ["model"] }, { "required": ["llm"] }] }
+    }
+  ],
+  "definitions": {
+    "llm": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "temperature": { "type": "number" },
+        "maxTokens": { "type": "integer", "minimum": 1 },
+        "supportsJsonSchema": { "type": "boolean" },
+        "extraParams": { "$ref": "#/definitions/extraParams" },
+        "contextLength": { "type": "integer", "minimum": 1 },
+        "enableThinking": { "type": "boolean" }
+      }
+    },
+    "extraParams": {
+      "type": "object",
+      "description": "Provider-specific request fields. Top-level AKM-owned fields are forbidden; credential-shaped keys are forbidden recursively after lowercase/non-alphanumeric normalization.",
+      "propertyNames": {
+        "not": {
+          "enum": ["model", "messages", "temperature", "maxtokens", "responseformat", "stream", "streamoptions", "enablethinking", "authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+        }
+      },
+      "additionalProperties": { "$ref": "#/definitions/extraParamValue" },
+      "x-akm-protectedTopLevelNormalizedKeys": ["model", "messages", "temperature", "maxtokens", "responseformat", "stream", "streamoptions", "enablethinking"],
+      "x-akm-recursivelyForbiddenNormalizedKeys": ["authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+    },
+    "extraParamValue": {
+      "anyOf": [
+        { "type": ["string", "number", "boolean", "null"] },
+        { "type": "array", "items": { "$ref": "#/definitions/extraParamValue" } },
+        {
+          "type": "object",
+          "propertyNames": {
+            "not": {
+              "enum": ["authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+            }
+          },
+          "additionalProperties": { "$ref": "#/definitions/extraParamValue" },
+          "x-akm-recursivelyForbiddenNormalizedKeys": ["authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+        }
+      ]
+    }
+  }
+}

package/dist/schemas/akm-workflow.json

@@ -8,8 +8,8 @@
   "additionalProperties": false,
   "properties": {
     "version": {
-      "const": 1,
-      "description": "Workflow program format version. Only 1 is valid."
+      "const": 2,
+      "description": "Workflow program format version. Only 2 is valid."
     },
     "name": {
       "type": "string",
@@ -22,6 +22,7 @@
     },
     "params": {
       "type": "object",
+      "maxProperties": 128,
       "description": "Run parameters: param name -> JSON Schema declaration. Names must be ${{ params.<name> }}-addressable identifiers.",
       "propertyNames": {
         "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
@@ -39,6 +40,7 @@
     "steps": {
       "type": "array",
       "minItems": 1,
+      "maxItems": 256,
       "items": {
         "$ref": "#/definitions/step"
       }
@@ -63,14 +65,50 @@
         }
       ]
     },
-    "runner": {
-      "description": "Execution backend for a unit; inherit defers to the run-level default.",
-      "enum": ["llm", "agent", "sdk", "inherit"]
-    },
     "onError": {
       "description": "Failure policy: fail the step on the first unit failure (default), or record failures and let the gate decide.",
       "enum": ["fail", "continue"]
     },
+    "llm": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "temperature": { "type": "number" },
+        "max_tokens": { "type": "integer", "minimum": 1 },
+        "supports_json_schema": { "type": "boolean" },
+        "extra_params": { "$ref": "#/definitions/extraParams" },
+        "context_length": { "type": "integer", "minimum": 1 },
+        "enable_thinking": { "type": "boolean" }
+      }
+    },
+    "extraParams": {
+      "type": "object",
+      "description": "Provider-specific request fields. Top-level AKM-owned fields are forbidden; credential-shaped keys are forbidden recursively after lowercase/non-alphanumeric normalization.",
+      "propertyNames": {
+        "not": {
+          "enum": ["model", "messages", "temperature", "maxtokens", "responseformat", "stream", "streamoptions", "enablethinking", "authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+        }
+      },
+      "additionalProperties": { "$ref": "#/definitions/extraParamValue" },
+      "x-akm-protectedTopLevelNormalizedKeys": ["model", "messages", "temperature", "maxtokens", "responseformat", "stream", "streamoptions", "enablethinking"],
+      "x-akm-recursivelyForbiddenNormalizedKeys": ["authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+    },
+    "extraParamValue": {
+      "anyOf": [
+        { "type": ["string", "number", "boolean", "null"] },
+        { "type": "array", "items": { "$ref": "#/definitions/extraParamValue" } },
+        {
+          "type": "object",
+          "propertyNames": {
+            "not": {
+              "enum": ["authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+            }
+          },
+          "additionalProperties": { "$ref": "#/definitions/extraParamValue" },
+          "x-akm-recursivelyForbiddenNormalizedKeys": ["authorization", "headers", "apikey", "token", "password", "secret", "cookie", "setcookie"]
+        }
+      ]
+    },
     "reducer": {
       "description": "How a map step folds per-item unit results into the step artifact.",
       "enum": ["collect", "vote"]
@@ -133,6 +171,7 @@
         "max_units": {
           "type": "integer",
           "minimum": 1,
+          "maximum": 10000,
           "description": "Ceiling on total dispatched units across the run (seeded from journaled unit rows)."
         }
       }
@@ -142,8 +181,9 @@
       "description": "Run-level defaults, overridable per unit.",
       "additionalProperties": false,
       "properties": {
-        "runner": {
-          "$ref": "#/definitions/runner"
+        "engine": {
+          "type": "string",
+          "minLength": 1
         },
         "model": {
           "type": "string",
@@ -155,6 +195,9 @@
         },
         "on_error": {
           "$ref": "#/definitions/onError"
+        },
+        "llm": {
+          "$ref": "#/definitions/llm"
         }
       }
     },
@@ -164,18 +207,18 @@
       "required": ["instructions"],
       "additionalProperties": false,
       "properties": {
-        "runner": {
-          "$ref": "#/definitions/runner"
-        },
-        "profile": {
+        "engine": {
           "type": "string",
           "minLength": 1,
-          "description": "Agent/LLM profile name."
+          "description": "Named engine selected at workflow start."
         },
         "model": {
           "type": "string",
           "minLength": 1
         },
+        "llm": {
+          "$ref": "#/definitions/llm"
+        },
         "timeout": {
           "$ref": "#/definitions/timeout"
         },
@@ -244,6 +287,7 @@
         "when": {
           "type": "object",
           "minProperties": 1,
+          "maxProperties": 256,
           "description": "Match value -> target step id.",
           "additionalProperties": {
             "$ref": "#/definitions/identifier"