{
  "$schema": "schemas/execution.schema.json",
  "name": "AIScript execution",
  "version": "1.0.0-draft.1",
  "request": {
    "name": "request",
    "purpose": "Immutable current invocation view; not a Service or host request object.",
    "functions": {
      "bytes": {
        "parameters": [],
        "returns": {
          "nullable": "core.bytes"
        },
        "purpose": "Original received body bytes, or null.",
        "statementOnly": false
      },
      "text": {
        "parameters": [
          {
            "name": "charset",
            "type": "core.string",
            "required": false,
            "default": "UTF-8"
          }
        ],
        "returns": {
          "nullable": "core.string"
        },
        "purpose": "Strictly decoded body text, or null.",
        "statementOnly": false
      },
      "header": {
        "parameters": [
          {
            "name": "name",
            "type": "core.string",
            "required": true
          }
        ],
        "returns": {
          "nullable": "core.string"
        },
        "purpose": "First case-insensitive header value, or null.",
        "statementOnly": false
      },
      "headers": {
        "parameters": [
          {
            "name": "name",
            "type": "core.string",
            "required": true
          }
        ],
        "returns": {
          "arrayOf": "core.string"
        },
        "purpose": "Array of all values, empty when absent.",
        "statementOnly": false
      },
      "parameter": {
        "parameters": [
          {
            "name": "name",
            "type": "core.string",
            "required": true
          }
        ],
        "returns": {
          "nullable": "core.string"
        },
        "purpose": "One decoded mapped transport parameter, or null.",
        "statementOnly": false
      },
      "origin": {
        "parameters": [],
        "returns": "core.string",
        "purpose": "Configured external origin, not an untrusted Host header.",
        "statementOnly": false
      }
    }
  },
  "builtins": {
    "property": {
      "parameters": [
        {
          "name": "path",
          "type": "core.string",
          "required": true
        },
        {
          "name": "fallback",
          "type": "core.data",
          "required": false,
          "default": null
        }
      ],
      "returns": "core.data",
      "purpose": "Read a local System property; Secret paths begin security.secrets."
    },
    "processUrl": {
      "parameters": [
        {
          "name": "name",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.string",
      "purpose": "External URL of a declared HTTP Process."
    },
    "round": {
      "parameters": [
        {
          "name": "value",
          "type": "core.numeric",
          "required": true
        },
        {
          "name": "places",
          "type": "core.integer",
          "required": true
        },
        {
          "name": "rounding",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.decimal",
      "purpose": "Explicit rounding; places is nonnegative."
    },
    "divide": {
      "parameters": [
        {
          "name": "value",
          "type": "core.numeric",
          "required": true
        },
        {
          "name": "divisor",
          "type": "core.numeric",
          "required": true
        },
        {
          "name": "places",
          "type": "core.integer",
          "required": true
        },
        {
          "name": "rounding",
          "type": "core.string",
          "required": true
        }
      ],
      "returns": "core.decimal",
      "purpose": "Division with explicit rounding; zero divisor fails."
    }
  },
  "rounding": [
    "half-up",
    "half-even",
    "up",
    "down",
    "ceiling",
    "floor",
    "unnecessary"
  ],
  "results": {
    "forms": [
      "object",
      "text",
      "bytes",
      "file",
      "redirect"
    ],
    "metadataSchema": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "status": {
          "anyOf": [
            {
              "enum": [
                "ok",
                "created",
                "accepted",
                "noContent",
                "seeOther",
                "temporaryRedirect"
              ]
            },
            {
              "type": "integer",
              "minimum": 100,
              "maximum": 599
            }
          ]
        },
        "contentType": {
          "type": "string"
        },
        "filename": {
          "type": "string"
        },
        "headers": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          }
        }
      }
    }
  }
}
