RESOURCE SCHEMA · CC BY 4.0 Source Process schema
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"audience",
"description",
"enabled",
"authentication",
"documentation",
"dependencies"
],
"properties": {
"audience": {
"type": "string",
"minLength": 1,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the one Audience this Process belongs to. The Audience must exist in this System. This association does not grant access or enable invocation channels."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160,
"description": "Resource name, unique among Process resources in this System. Used exactly in filenames and references.",
"pattern": "^[A-Za-z0-9_-]+$"
},
"description": {
"type": "string",
"minLength": 20,
"maxLength": 4000,
"description": "Business-facing explanation of what this resource represents, why it exists and how it is used."
},
"tags": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "\\S"
},
"description": "Optional labels chosen by the author for grouping, filtering and discovery. Tags do not change execution, grant access or establish certification."
},
"enabled": {
"type": "boolean",
"description": "Whether the Process is enabled for publication."
},
"channels": {
"type": "array",
"uniqueItems": true,
"description": "Optional allowed invocation channels, not Audiences. Omitted means all channels; an empty array means no channels. Values: http for API calls, internal for calls within the same API, peer for calls from another API, scheduler for scheduled calls and mom for message-driven calls. Does not bypass authentication or create scheduled jobs or Event subscriptions.",
"items": {
"type": "string",
"enum": [
"http",
"internal",
"scheduler",
"mom",
"peer"
]
}
},
"authentication": {
"type": "string",
"enum": [
"none",
"token",
"signature"
],
"description": "Incoming authentication requirement, separate from invocation channels. Signature verification alone does not populate a caller identity."
},
"signature": {
"type": "object",
"additionalProperties": false,
"required": [
"key",
"signature",
"payload",
"options"
],
"properties": {
"key": {
"type": "string",
"minLength": 1,
"description": "Header, parameter or JSON body path supplying the provider key identifier. Prefix H/, P/ or B/; unprefixed names mean headers."
},
"signature": {
"type": "string",
"minLength": 1,
"description": "Header, parameter or JSON body path supplying the signature. Prefix H/, P/ or B/; unprefixed names mean headers."
},
"payload": {
"type": "string",
"minLength": 1,
"description": "UTF-8 text template using verb, host, path and parameters. Does not automatically include body bytes or arbitrary headers."
},
"options": {
"type": "object",
"additionalProperties": false,
"required": [
"algorithm"
],
"properties": {
"algorithm": {
"enum": [
"HmacSHA256",
"SHA256withRSA",
"RSASSA-PSS",
"SHA256withECDSA"
]
},
"keyVersion": {
"type": "integer",
"minimum": 1
}
}
}
}
},
"invocation": {
"type": "object",
"additionalProperties": false,
"required": [
"cron",
"timezone",
"inputs"
],
"description": "Defines scheduled execution with cron, timezone and supplied Inputs. Required when channels explicitly includes scheduler. Can also be declared when channels is omitted, since omission allows all channels.",
"properties": {
"cron": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"timezone": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"inputs": {
"type": "object",
"additionalProperties": true
}
}
},
"primary": {
"type": "boolean",
"description": "Show this Process as a primary business Process."
},
"documentation": {
"type": "object",
"additionalProperties": false,
"required": [
"summary",
"operation",
"success",
"errors",
"examples"
],
"description": "Canonical endpoint documentation. Write precise business documentation once; it is reused by the endpoint specification, generated source, MCP tool and OpenAPI release artifacts.",
"properties": {
"summary": {
"type": "string",
"minLength": 10,
"maxLength": 160,
"description": "A concise action-oriented business summary."
},
"operation": {
"type": "string",
"minLength": 40,
"maxLength": 4000,
"description": "Explain what the Process does, its important rules, side effects, transaction boundary and externally visible behavior."
},
"success": {
"type": "string",
"minLength": 20,
"maxLength": 2000,
"description": "Explain the successful outcome and what the caller can rely on."
},
"errors": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"status",
"condition",
"message"
],
"properties": {
"status": {
"type": "integer",
"minimum": 400,
"maximum": 599
},
"code": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"condition": {
"type": "string",
"minLength": 10,
"maxLength": 1000
},
"message": {
"type": "string",
"minLength": 5,
"maxLength": 500
}
}
}
},
"examples": {
"type": "array",
"minItems": 1,
"maxItems": 5,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"description",
"request",
"response"
],
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 160
},
"description": {
"type": "string",
"minLength": 10,
"maxLength": 1000
},
"request": {
"type": "object",
"additionalProperties": true,
"description": "A realistic business example matching the Inputs. Choose each value from its field meaning and declared constraints, not a default for its primitive type."
},
"response": {
"type": "object",
"additionalProperties": true,
"description": "The realistic result of this example request, matching the Outputs and business outcome. Check each value against its field meaning, allowed values and linked records; do not generate type-only placeholders."
}
}
}
}
}
},
"dependencies": {
"type": "object",
"additionalProperties": false,
"properties": {
"dataCollections": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"processes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"events": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"storage": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,119}$"
}
},
"services": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"secrets": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
}
}
},
"inputs": {
"type": "array",
"description": "Typed values supplied to the Process, with their meaning and constraints. Information derived from related records is explained in the operation.",
"items": {
"type": "object",
"additionalProperties": true,
"required": [
"name",
"type",
"description",
"label"
],
"description": "A concrete business value with a meaningful name and description. Object and array values require a JSON schema describing the actual contents. Use integer or long for whole numbers and decimal for fractional values. AIScript defines their calculation and conversion rules.",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"type": {
"type": "string",
"enum": [
"string",
"String",
"STRING",
"text",
"Text",
"TEXT",
"integer",
"Integer",
"INTEGER",
"long",
"Long",
"LONG",
"decimal",
"Decimal",
"DECIMAL",
"boolean",
"Boolean",
"BOOLEAN",
"date",
"Date",
"DATE",
"datetime",
"Datetime",
"DATETIME",
"object",
"Object",
"OBJECT",
"array",
"Array",
"ARRAY",
"file",
"File",
"FILE",
"reference",
"Reference",
"REFERENCE"
],
"description": "Case-insensitive; normalizes this value to lowercase."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"required": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"maximum": {
"type": "number"
},
"minLength": {
"type": "integer",
"minimum": 0
},
"maxLength": {
"type": "integer",
"minimum": 0
},
"values": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {},
"description": "Allowed field values, chosen by the System author. Each value follows the field type. Omit when there is no fixed list."
},
"source": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
},
"receiver": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
},
"collection": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"minLength": 1,
"maxLength": 160,
"description": "For a reference value, the singular name of the referenced Data Collection."
},
"schema": {
"type": "object",
"additionalProperties": true,
"description": "Required for object and array values. Describe concrete properties or items so the contract can be compiled."
},
"classification": {
"type": "string",
"enum": [
"public",
"internal",
"confidential",
"restricted"
]
},
"categories": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"personal-data",
"cardholder-data",
"sensitive-authentication-data",
"financial-data",
"other-regulated-data"
]
}
},
"handling": {
"type": "object",
"additionalProperties": false,
"properties": {
"storage": {
"type": "string",
"enum": [
"none",
"transient",
"persistent"
]
},
"retention": {
"type": "string",
"maxLength": 500
},
"disposal": {
"type": "string",
"maxLength": 1000
},
"protections": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"encryption",
"tokenization",
"masking",
"redaction",
"access-control",
"audit-logging"
]
}
}
}
},
"label": {
"type": "string",
"minLength": 1,
"description": "Human-readable display label. The name remains the code and mapping key."
}
},
"allOf": [
{
"if": {
"properties": {
"type": {
"const": "reference"
}
},
"required": [
"type"
]
},
"then": {
"required": [
"collection"
]
}
}
]
}
},
"outputs": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true,
"required": [
"name",
"type",
"description",
"label"
],
"description": "A concrete business value with a meaningful name and description. Object and array values require a JSON schema describing the actual contents. Use integer or long for whole numbers and decimal for fractional values. AIScript defines their calculation and conversion rules.",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 160
},
"type": {
"type": "string",
"enum": [
"string",
"String",
"STRING",
"text",
"Text",
"TEXT",
"integer",
"Integer",
"INTEGER",
"long",
"Long",
"LONG",
"decimal",
"Decimal",
"DECIMAL",
"boolean",
"Boolean",
"BOOLEAN",
"date",
"Date",
"DATE",
"datetime",
"Datetime",
"DATETIME",
"object",
"Object",
"OBJECT",
"array",
"Array",
"ARRAY",
"file",
"File",
"FILE",
"reference",
"Reference",
"REFERENCE"
],
"description": "Case-insensitive; normalizes this value to lowercase."
},
"description": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"required": {
"type": "boolean"
},
"minimum": {
"type": "number"
},
"maximum": {
"type": "number"
},
"minLength": {
"type": "integer",
"minimum": 0
},
"maxLength": {
"type": "integer",
"minimum": 0
},
"values": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {},
"description": "Allowed field values, chosen by the System author. Each value follows the field type. Omit when there is no fixed list."
},
"source": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
},
"receiver": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
},
"collection": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"minLength": 1,
"maxLength": 160,
"description": "For a reference value, the singular name of the referenced Data Collection."
},
"schema": {
"type": "object",
"additionalProperties": true,
"description": "Required for object and array values. Describe concrete properties or items so the contract can be compiled."
},
"classification": {
"type": "string",
"enum": [
"public",
"internal",
"confidential",
"restricted"
]
},
"categories": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"personal-data",
"cardholder-data",
"sensitive-authentication-data",
"financial-data",
"other-regulated-data"
]
}
},
"handling": {
"type": "object",
"additionalProperties": false,
"properties": {
"storage": {
"type": "string",
"enum": [
"none",
"transient",
"persistent"
]
},
"retention": {
"type": "string",
"maxLength": 500
},
"disposal": {
"type": "string",
"maxLength": 1000
},
"protections": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"encryption",
"tokenization",
"masking",
"redaction",
"access-control",
"audit-logging"
]
}
}
}
},
"label": {
"type": "string",
"minLength": 1,
"description": "Human-readable display label. The name remains the code and mapping key."
}
},
"allOf": [
{
"if": {
"properties": {
"type": {
"const": "reference"
}
},
"required": [
"type"
]
},
"then": {
"required": [
"collection"
]
}
}
]
}
},
"implementation": {
"type": "object",
"additionalProperties": false,
"required": [
"resource"
],
"properties": {
"resource": {
"type": "string",
"pattern": "^(?!/)(?!.*\\\\)(?!.*(?:^|/)\\.\\.(?:/|$)).+\\.ais$",
"description": "Relative path from the System package root to the AIScript code resource. The file defines execute(input) and optional helper functions."
},
"dependencies": {
"type": "object",
"additionalProperties": false,
"properties": {
"dataCollections": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"processes": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"events": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"storage": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,119}$"
}
},
"services": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
},
"secrets": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
}
}
}
}
}
},
"composition": {
"type": "object",
"additionalProperties": false,
"required": [
"nodes",
"entryNodes",
"exitNodes"
],
"description": "Use only when this Process orchestrates other Processes. A graph Process has no implementation source. entryNodes and exitNodes are always required, even for one node. Mapping paths use input.<parentInput> or outputs.<nodeId>.<childOutput>.",
"properties": {
"nodes": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"process"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_-]{0,79}$"
},
"process": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"description": "Exact name of the referenced resource, unique within its resource type in this System.",
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 160
},
"description": {
"type": "string",
"maxLength": 2000
},
"optional": {
"type": "boolean"
},
"inputMapping": {
"type": "object",
"description": "Map each child Process input name to input.<parentInput> or outputs.<precedingNodeId>.<childOutput>.",
"additionalProperties": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
}
},
"outputMapping": {
"type": "object",
"description": "On an exit node, map each parent Process output name to output.<thisChildOutput> or outputs.<precedingNodeId>.<childOutput>.",
"additionalProperties": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
}
}
}
}
},
"connections": {
"type": "array",
"description": "Join graph nodes. Use when, never condition, for a structured branch. When a node has multiple outgoing routes, each route needs when except one optional default: true route. A single unconditional route needs only from and to. outcome is descriptive only.",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"from",
"to"
],
"properties": {
"from": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_-]{0,79}$"
},
"to": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_-]{0,79}$"
},
"outcome": {
"type": "string",
"maxLength": 160,
"description": "Optional descriptive label only; it does not select the route."
},
"when": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"left",
"operator"
],
"properties": {
"left": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
},
"operator": {
"type": "string",
"enum": [
"equals",
"notEquals",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual",
"in",
"notIn",
"contains",
"exists",
"doesNotExist",
"empty",
"notEmpty"
]
},
"right": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"all"
],
"properties": {
"all": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"left",
"operator"
],
"properties": {
"left": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
},
"operator": {
"type": "string",
"enum": [
"equals",
"notEquals",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual",
"in",
"notIn",
"contains",
"exists",
"doesNotExist",
"empty",
"notEmpty"
]
},
"right": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"any"
],
"properties": {
"any": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"left",
"operator"
],
"properties": {
"left": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
},
"operator": {
"type": "string",
"enum": [
"equals",
"notEquals",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual",
"in",
"notIn",
"contains",
"exists",
"doesNotExist",
"empty",
"notEmpty"
]
},
"right": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
}
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"not"
],
"properties": {
"not": {
"type": "object",
"additionalProperties": false,
"required": [
"left",
"operator"
],
"properties": {
"left": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
},
"operator": {
"type": "string",
"enum": [
"equals",
"notEquals",
"greaterThan",
"greaterThanOrEqual",
"lessThan",
"lessThanOrEqual",
"in",
"notIn",
"contains",
"exists",
"doesNotExist",
"empty",
"notEmpty"
]
},
"right": {
"type": "object",
"additionalProperties": false,
"properties": {
"input": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"output": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,239}$"
},
"constant": {}
},
"oneOf": [
{
"required": [
"input"
]
},
{
"required": [
"output"
]
},
{
"required": [
"constant"
]
}
]
}
}
}
}
}
]
},
"default": {
"type": "boolean"
},
"description": {
"type": "string",
"maxLength": 2000
}
}
}
},
"entryNodes": {
"type": "array",
"minItems": 1,
"description": "Node ids where execution can start. Every id must exist in nodes.",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_-]{0,79}$"
}
},
"exitNodes": {
"type": "array",
"minItems": 1,
"description": "Node ids where execution can finish. Every required parent output must be produced by an exit node outputMapping.",
"items": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_-]{0,79}$"
}
}
}
},
"presentation": {
"type": "object",
"additionalProperties": false,
"properties": {
"specVersion": {
"const": "1.0.0-draft.1"
},
"contractRevision": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"defaultLocale": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"messages": {
"type": "object",
"minProperties": 1,
"maxProperties": 30,
"additionalProperties": {
"type": "object",
"additionalProperties": {
"type": "string",
"maxLength": 4000
}
}
},
"requires": {
"type": "array",
"items": {
"enum": [
"fileViewer",
"section",
"row",
"tabs",
"wizard",
"step",
"field",
"details",
"table",
"metric",
"chart",
"timeline",
"graph",
"notice",
"actions"
]
},
"maxItems": 30,
"minItems": 1,
"uniqueItems": true
},
"lookups": {
"type": "object",
"maxProperties": 40,
"additionalProperties": {
"type": "object",
"additionalProperties": false,
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact name of the Process used for this lookup."
},
"collection": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"minLength": 1,
"maxLength": 200,
"description": "Exact name of the related Data Collection; the lookup still calls a Process."
},
"arguments": {
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/binding"
}
},
"searchInput": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"offsetInput": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"pageSizeInput": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"records": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"identity": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"label": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"description": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"resolve": {
"type": "object",
"additionalProperties": false,
"properties": {
"operation": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Exact name of the Process used to resolve selected records."
},
"idsInput": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"arguments": {
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/binding"
}
},
"records": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
}
},
"required": [
"operation",
"idsInput",
"records"
]
}
},
"required": [
"operation",
"collection",
"records",
"identity",
"label"
]
}
},
"refresh": {
"type": "object",
"additionalProperties": false,
"properties": {
"mode": {
"enum": [
"manual",
"interval"
]
},
"seconds": {
"type": "integer",
"minimum": 15,
"maximum": 3600
}
},
"required": [
"mode"
]
},
"view": {
"$ref": "#/$defs/node"
},
"process": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"minLength": 1,
"maxLength": 200,
"description": "Exact name of the Process this presentation describes."
}
},
"required": [
"specVersion",
"process",
"contractRevision",
"defaultLocale",
"messages",
"requires",
"view"
]
}
},
"description": "One Process specification. A direct implementation references a separate AIScript code resource; a composite uses composition. They are mutually exclusive. A design-only draft may omit both.",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "Process.schema.json",
"not": {
"required": [
"implementation",
"composition"
]
},
"allOf": [
{
"if": {
"properties": {
"authentication": {
"const": "signature"
}
},
"required": [
"authentication"
]
},
"then": {
"required": [
"signature"
]
},
"else": {
"not": {
"required": [
"signature"
]
}
}
},
{
"if": {
"required": [
"channels"
],
"properties": {
"channels": {
"contains": {
"const": "scheduler"
}
}
}
},
"then": {
"required": [
"invocation"
]
}
}
],
"$defs": {
"binding": {
"type": "object",
"additionalProperties": false,
"properties": {
"source": {
"enum": [
"input",
"output",
"row"
]
},
"path": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
}
},
"required": [
"source",
"path"
]
},
"format": {
"type": "object",
"additionalProperties": false,
"properties": {
"style": {
"enum": [
"text",
"number",
"decimal",
"currency",
"date",
"datetime",
"percent",
"badge"
]
},
"currency": {
"type": "object",
"additionalProperties": false,
"properties": {
"source": {
"enum": [
"input",
"output",
"row"
]
},
"path": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
}
},
"required": [
"source",
"path"
]
}
},
"required": [
"style"
]
},
"predicate": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"op": {
"const": "exists"
},
"binding": {
"$ref": "#/$defs/binding"
}
},
"required": [
"op",
"binding"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"op": {
"enum": [
"eq",
"ne",
"gt",
"gte",
"lt",
"lte"
]
},
"binding": {
"$ref": "#/$defs/binding"
},
"value": {
"type": [
"string",
"number",
"boolean",
"null"
]
}
},
"required": [
"op",
"binding",
"value"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"op": {
"const": "in"
},
"binding": {
"$ref": "#/$defs/binding"
},
"values": {
"type": "array",
"items": {
"type": [
"string",
"number",
"boolean",
"null"
]
},
"maxItems": 100
}
},
"required": [
"op",
"binding",
"values"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"op": {
"enum": [
"all",
"any"
]
},
"conditions": {
"type": "array",
"items": {
"$ref": "#/$defs/predicate"
},
"maxItems": 20,
"minItems": 1
}
},
"required": [
"op",
"conditions"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"op": {
"const": "not"
},
"condition": {
"$ref": "#/$defs/predicate"
}
},
"required": [
"op",
"condition"
]
}
]
},
"node": {
"oneOf": [
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "fileViewer"
},
"binding": {
"$ref": "#/$defs/binding"
}
},
"required": [
"id",
"kind",
"binding"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "section"
},
"columns": {
"enum": [
1,
2
]
},
"children": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"$ref": "#/$defs/node"
}
}
},
"required": [
"id",
"kind",
"children"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "row"
},
"children": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"$ref": "#/$defs/node"
}
}
},
"required": [
"id",
"kind",
"children"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "tabs"
},
"children": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"$ref": "#/$defs/node"
}
}
},
"required": [
"id",
"kind",
"children"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "wizard"
},
"children": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"$ref": "#/$defs/node"
}
}
},
"required": [
"id",
"kind",
"children"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "step"
},
"children": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"items": {
"$ref": "#/$defs/node"
}
}
},
"required": [
"id",
"kind",
"label",
"children"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "field"
},
"binding": {
"$ref": "#/$defs/binding"
},
"span": {
"type": "integer",
"minimum": 1,
"maximum": 12
},
"control": {
"enum": [
"auto",
"text",
"textarea",
"number",
"date",
"datetime",
"select",
"switch",
"lookup",
"items",
"file"
]
},
"lookup": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"file": {
"type": "object",
"additionalProperties": false,
"properties": {
"kinds": {
"type": "array",
"minItems": 1,
"uniqueItems": true,
"items": {
"enum": [
"any",
"image",
"video",
"audio",
"pdf",
"text"
]
}
},
"maxBytes": {
"type": "integer",
"minimum": 1,
"maximum": 16777216
}
},
"required": []
},
"optionLabels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"value": {
"type": [
"string",
"number",
"boolean",
"null"
]
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
}
},
"required": [
"value",
"label"
]
},
"maxItems": 100
},
"help": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
}
},
"required": [
"id",
"kind",
"binding"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "details"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"binding": {
"$ref": "#/$defs/binding"
},
"format": {
"$ref": "#/$defs/format"
}
},
"required": [
"label",
"binding"
]
},
"maxItems": 100
}
},
"required": [
"id",
"kind",
"fields"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "table"
},
"binding": {
"$ref": "#/$defs/binding"
},
"rowKey": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"rowActions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"kind": {
"enum": [
"submit",
"reset",
"refresh",
"navigate"
]
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"inputs": {
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/binding"
}
},
"confirmation": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
}
},
"required": [
"id",
"kind",
"label"
]
},
"maxItems": 8
},
"views": {
"type": "array",
"items": {
"enum": [
"table",
"cards"
]
},
"minItems": 1,
"uniqueItems": true
},
"search": {
"type": "object",
"additionalProperties": false,
"properties": {
"binding": {
"$ref": "#/$defs/binding"
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
}
},
"required": [
"binding",
"label"
]
},
"card": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"fields": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"path": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"format": {
"$ref": "#/$defs/format"
}
},
"required": [
"label",
"path"
]
},
"maxItems": 12,
"minItems": 1
}
},
"required": [
"title",
"fields"
]
},
"columns": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"path": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"format": {
"$ref": "#/$defs/format"
}
},
"required": [
"label",
"path"
]
},
"maxItems": 40,
"minItems": 1
},
"paging": {
"type": "object",
"additionalProperties": false,
"properties": {
"offset": {
"$ref": "#/$defs/binding"
},
"pageSize": {
"$ref": "#/$defs/binding"
},
"total": {
"$ref": "#/$defs/binding"
}
},
"required": [
"offset",
"pageSize"
]
}
},
"required": [
"id",
"kind",
"binding",
"rowKey",
"columns"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "metric"
},
"binding": {
"$ref": "#/$defs/binding"
},
"format": {
"$ref": "#/$defs/format"
}
},
"required": [
"id",
"kind",
"label",
"binding"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "chart"
},
"binding": {
"$ref": "#/$defs/binding"
},
"chart": {
"enum": [
"line",
"bar",
"donut"
]
},
"category": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"value": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"format": {
"$ref": "#/$defs/format"
}
},
"required": [
"id",
"kind",
"label",
"binding",
"chart",
"category",
"value"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "timeline"
},
"binding": {
"$ref": "#/$defs/binding"
},
"time": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"title": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"detail": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
}
},
"required": [
"id",
"kind",
"binding",
"time",
"title"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "graph"
},
"nodes": {
"$ref": "#/$defs/binding"
},
"edges": {
"$ref": "#/$defs/binding"
},
"nodeId": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"nodeLabel": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"source": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
},
"target": {
"type": "string",
"pattern": "^(?:/(?:[^~/]|~[01])*)*$",
"maxLength": 1000
}
},
"required": [
"id",
"kind",
"nodes",
"edges",
"nodeId",
"nodeLabel",
"source",
"target"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "notice"
},
"text": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"intent": {
"enum": [
"neutral",
"attention"
]
}
},
"required": [
"id",
"kind",
"text"
]
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"visibleWhen": {
"$ref": "#/$defs/predicate"
},
"kind": {
"const": "actions"
},
"actions": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"kind": {
"enum": [
"submit",
"reset",
"refresh",
"navigate"
]
},
"label": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
},
"target": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"inputs": {
"type": "object",
"additionalProperties": {
"$ref": "#/$defs/binding"
}
},
"confirmation": {
"type": "string",
"pattern": "^[a-zA-Z][a-zA-Z0-9_.-]*$",
"maxLength": 120
}
},
"required": [
"id",
"kind",
"label"
]
},
"maxItems": 12,
"minItems": 1
}
},
"required": [
"id",
"kind",
"actions"
]
}
]
}
},
"$id": "Process.schema.json"
}