@takeshape/schema 11.43.0 → 11.44.0

package/dist/cjs/src/schemas/index.js

@@ -3,18 +3,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.allProjectSchemas = exports.experimentalSchemaJson = exports.authSchemaJson = exports.latestSchemaJson = exports.anyProjectSchema = exports.CURRENT_SCHEMA_VERSION = void 0;
+exports.allProjectSchemas = exports.latestSchemaJson = exports.anyProjectSchema = exports.CURRENT_SCHEMA_VERSION = void 0;
 // This file is generated by "pnpm json2ts"
 exports.CURRENT_SCHEMA_VERSION = '3.50.0';
 var project_schema_json_1 = require("./project-schema.json");
 Object.defineProperty(exports, "anyProjectSchema", { enumerable: true, get: function () { return __importDefault(project_schema_json_1).default; } });
 var v3_50_0_json_1 = require("./project-schema/v3.50.0.json");
 Object.defineProperty(exports, "latestSchemaJson", { enumerable: true, get: function () { return __importDefault(v3_50_0_json_1).default; } });
-var auth_schemas_json_1 = require("./auth-schemas.json");
-Object.defineProperty(exports, "authSchemaJson", { enumerable: true, get: function () { return __importDefault(auth_schemas_json_1).default; } });
-var experimental_json_1 = require("./project-schema/experimental.json");
-Object.defineProperty(exports, "experimentalSchemaJson", { enumerable: true, get: function () { return __importDefault(experimental_json_1).default; } });
-const experimental_json_2 = __importDefault(require("./project-schema/experimental.json"));
+const experimental_json_1 = __importDefault(require("./project-schema/experimental.json"));
 const meta_schema_v1_0_0_json_1 = __importDefault(require("./project-schema/meta-schema-v1.0.0.json"));
 const v1_0_0_json_1 = __importDefault(require("./project-schema/v1.0.0.json"));
 const meta_schema_v3_0_0_json_1 = __importDefault(require("./project-schema/meta-schema-v3.0.0.json"));
@@ -88,7 +84,7 @@ const v3_49_0_json_1 = __importDefault(require("./project-schema/v3.49.0.json"))
 const v3_50_0_json_2 = __importDefault(require("./project-schema/v3.50.0.json"));
 const v4_0_0_json_1 = __importDefault(require("./project-schema/v4.0.0.json"));
 exports.allProjectSchemas = [
-    experimental_json_2.default,
+    experimental_json_1.default,
     meta_schema_v1_0_0_json_1.default,
     v1_0_0_json_1.default,
     meta_schema_v3_0_0_json_1.default,

package/dist/cjs/src/schemas/project-schema/experimental.json

@@ -21,6 +21,13 @@
         },
         "states": {
           "$ref": "#/definitions/agentStateMap"
+        },
+        "guards": {
+          "title": "AgentGuardList",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/agentGuard"
+          }
         }
       },
       "required": ["start", "states", "api"],
@@ -488,6 +495,17 @@
         }
       ]
     },
+    "agentGuard": {
+      "title": "AgentGuard",
+      "type": "object",
+      "properties": {
+        "guardId": {
+          "type": "string"
+        }
+      },
+      "required": ["guardId"],
+      "additionalProperties": false
+    },
     "agentToolConfig": {
       "title": "AgentToolConfig",
       "type": "object",
@@ -726,6 +744,10 @@
         "agents": {
           "$ref": "#/definitions/agentMap",
           "description": "An Agent is a configuration for an AI service such as a chat bot or a search engine."
+        },
+        "guards": {
+          "$ref": "#/definitions/guardMap",
+          "description": "A Guard is a configuration for an AI guardrail that can check inputs and outputs and provide safety and compliance."
         }
       },
       "additionalProperties": false
@@ -757,6 +779,289 @@
       ],
       "additionalProperties": false
     },
+    "guard": {
+      "title": "GuardJSON",
+      "description": "A Guard is a configuration for an AI guardrail that can check inputs and outputs and provide safety and compliance.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "title": "Name",
+          "description": "The human-readable name of the Guard."
+        },
+        "description": {
+          "type": "string",
+          "title": "Description",
+          "description": "A description of the Guard."
+        },
+        "blockedInputMessaging": {
+          "type": "string",
+          "title": "Blocked Input Messaging",
+          "description": "A message to return when the input message is blocked by the Guard."
+        },
+        "blockedOutputsMessaging": {
+          "type": "string",
+          "title": "Blocked Outputs Messaging",
+          "description": "A message to return when the output message is blocked by the Guard."
+        },
+        "topicPolicyConfig": {
+          "type": "object",
+          "title": "Topic Policy",
+          "description": "Topics to identify and block.",
+          "properties": {
+            "topicsConfig": {
+              "type": "array",
+              "items": {
+                "title": "Topic",
+                "description": "A topic to block.",
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "definition": {
+                    "type": "string"
+                  },
+                  "examples": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "type": {
+                    "type": "string",
+                    "enum": ["DENY"]
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "contentPolicyConfig": {
+          "type": "object",
+          "title": "Content Policy",
+          "description": "Types of content to filter and strength configuration.",
+          "properties": {
+            "filtersConfig": {
+              "type": "array",
+              "items": {
+                "title": "Filter",
+                "description": "Types of content to filter.",
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": ["HATE", "INSULTS", "MICONDUCT", "PROMPT_ATTACK", "SEXUAL", "VIOLENCE"]
+                  },
+                  "inputStrength": {
+                    "$ref": "#/definitions/guardrailFilterStrength"
+                  },
+                  "outputStrength": {
+                    "$ref": "#/definitions/guardrailFilterStrength"
+                  },
+                  "inputModalities": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/guardrailModality"
+                    }
+                  },
+                  "outputModalities": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/definitions/guardrailModality"
+                    }
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "wordPolicyConfig": {
+          "type": "object",
+          "title": "Word Policy",
+          "description":
+            "Specific words to identify and block. The managedWordListsConfig is solely used for blocking profanity.",
+          "properties": {
+            "wordsConfig": {
+              "type": "array",
+              "items": {
+                "title": "Word List",
+                "description": "Specific words to block.",
+                "type": "object",
+                "properties": {
+                  "text": {
+                    "type": "string"
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "managedWordListsConfig": {
+              "type": "array",
+              "items": {
+                "title": "Managed Words",
+                "description": "Managed word list to block. This is solely used for blocking profanity.",
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": ["PROFANITY"]
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "sensitiveInformationPolicyConfig": {
+          "title": "Sensitive Information Policy",
+          "description":
+            "Filter out and block or obscure sensitive information. Matching text will be handled per the policy.",
+          "type": "object",
+          "properties": {
+            "piiEntitiesConfig": {
+              "type": "array",
+              "items": {
+                "title": "PII Entity",
+                "description": "PII entity to infer from the text.",
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "type": "string",
+                    "enum": [
+                      "ADDRESS",
+                      "AGE",
+                      "AWS_ACCESS_KEY",
+                      "AWS_SECRET_KEY",
+                      "CA_HEALTH_NUMBER",
+                      "CA_SOCIAL_INSURANCE_NUMBER",
+                      "CREDIT_DEBIT_CARD_CVV",
+                      "CREDIT_DEBIT_CARD_EXPIRY",
+                      "CREDIT_DEBIT_CARD_NUMBER",
+                      "DRIVER_ID",
+                      "EMAIL",
+                      "INTERNATIONAL_BANK_ACCOUNT_NUMBER",
+                      "IP_ADDRESS",
+                      "LICENSE_PLATE",
+                      "MAC_ADDRESS",
+                      "NAME",
+                      "PASSWORD",
+                      "PHONE",
+                      "PIN",
+                      "SWIFT_CODE",
+                      "UK_NATIONAL_HEALTH_SERVICE_NUMBER",
+                      "UK_NATIONAL_INSURANCE_NUMBER",
+                      "UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER",
+                      "URL",
+                      "USERNAME",
+                      "US_BANK_ACCOUNT_NUMBER",
+                      "US_BANK_ROUTING_NUMBER",
+                      "US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER",
+                      "US_PASSPORT_NUMBER",
+                      "US_SOCIAL_SECURITY_NUMBER",
+                      "VEHICLE_IDENTIFICATION_NUMBER"
+                    ]
+                  },
+                  "action": {
+                    "$ref": "#/definitions/guardrailSensitiveInformationAction"
+                  }
+                },
+                "additionalProperties": false
+              }
+            },
+            "regexesConfig": {
+              "type": "array",
+              "items": {
+                "title": "Regular Expression",
+                "description": "A regular expression to match sensitive information.",
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "description": {
+                    "type": "string"
+                  },
+                  "pattern": {
+                    "type": "string"
+                  },
+                  "action": {
+                    "$ref": "#/definitions/guardrailSensitiveInformationAction"
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        },
+        "contextualGroundingPolicyConfig": {
+          "title": "Contextual Grounding Policy",
+          "description":
+            "Provides evaluations based on grounding text supplied by your in-context agent variables. Off-topic conversations can then be blocked.",
+          "type": "object",
+          "properties": {
+            "filtersConfig": {
+              "type": "array",
+              "items": {
+                "title": "Filter",
+                "description": "Filter to evaluate grounding text.",
+                "type": "object",
+                "properties": {
+                  "type": {
+                    "title": "Type",
+                    "description": "The type of filter.",
+                    "type": "string",
+                    "enum": ["GROUNDING", "RELEVANCE"]
+                  },
+                  "threshold": {
+                    "title": "Threshold",
+                    "description": "The threshold for the filter as a floating point value between 0.0 - 1.0.",
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "required": ["name"],
+      "additionalProperties": false
+    },
+    "guardMap": {
+      "title": "GuardMap",
+      "type": "object",
+      "patternProperties": {
+        "^[0-9A-Za-z_]+$": {
+          "$ref": "#/definitions/guard"
+        }
+      },
+      "additionalProperties": false
+    },
+    "guardrailFilterStrength": {
+      "title": "Guardrail Filter Strength",
+      "type": "string",
+      "enum": ["NONE", "HIGH", "LOW", "MEDIUM"]
+    },
+    "guardrailModality": {
+      "title": "Guardrail Modality",
+      "type": "string",
+      "enum": ["TEXT", "IMAGE"]
+    },
+    "guardrailSensitiveInformationAction": {
+      "title": "Guardrail Sensitive Information Action",
+      "type": "string",
+      "enum": ["ANONYMIZE", "BLOCK"]
+    },
     "aiInspectAgentResolver": {
       "title": "AIInspectAgentResolver",
       "type": "object",

package/dist/cjs/src/schemas/project-schema/latest.json

@@ -3717,4 +3717,4 @@
     "mutations",
     "workflows"
   ]
-}
+}

package/dist/cjs/src/schemas/project-schema/v3.50.0.json

@@ -3717,4 +3717,4 @@
     "mutations",
     "workflows"
   ]
-}
+}

package/dist/cjs/src/validate.js

@@ -493,8 +493,8 @@ function validateShapeLoaders(context, projectSchema, shape) {
             }
         }
     }
-    if (shape.cache?.triggers) {
-        const min = context.entitlements?.minScheduleTriggerInterval ?? util_1.DEFAULT_MIN_SCHEDULE_TRIGGER_INTERVAL;
+    if (shape.cache?.triggers && !context.ignoreEntitlements) {
+        const min = context.entitlements.minScheduleTriggerInterval ?? util_1.DEFAULT_MIN_SCHEDULE_TRIGGER_INTERVAL;
         for (let i = 0; i < shape.cache.triggers.length; i++) {
             const trigger = shape.cache.triggers[i];
             if (trigger.type === 'schedule' && trigger.interval < min) {
@@ -792,14 +792,16 @@ function validateInterfaceImplementations(projectSchema) {
 function validateAgents(projectSchema) {
     const getNamespace = (0, refs_1.createGetNamespace)(projectSchema);
     const errors = [];
+    const guards = projectSchema['ai-experimental']?.guards;
     const agents = projectSchema['ai-experimental']?.agents;
     if (!agents) {
         return errors;
     }
     for (const [agentName, agent] of Object.entries(agents)) {
         const stateNames = new Set();
+        const agentPath = ['ai-experimental', 'agents', agentName];
         for (const [stateId, state] of Object.entries(agent.states)) {
-            const statePath = ['ai-experimental', 'agents', agentName, 'states', stateId];
+            const statePath = [...agentPath, 'states', stateId];
             if (stateNames.has(state.name)) {
                 errors.push({
                     path: [...statePath, 'name'],
@@ -825,6 +827,17 @@ function validateAgents(projectSchema) {
                 });
             }
         }
+        if (agent.guards) {
+            const invalidGuards = agent.guards.filter(({ guardId }) => !guards?.[guardId]);
+            if (invalidGuards.length) {
+                const guardPath = [...agentPath, 'guards'];
+                errors.push(...invalidGuards.map(({ guardId }, index) => ({
+                    path: [...guardPath, index, 'guardId'],
+                    type: 'notFound',
+                    message: `Invalid guardId "${guardId}"`
+                })));
+            }
+        }
     }
     return errors;
 }
@@ -912,6 +925,22 @@ function validateStructure(schemaVersion, context, schema, ref) {
     }
     return { valid: true, schema: schema, errors: undefined };
 }
+function validateGuards(context, schema) {
+    const errors = [];
+    if (context.ignoreEntitlements) {
+        return errors;
+    }
+    const numOfGuards = schema['ai-experimental']?.guards ? Object.keys(schema['ai-experimental']?.guards).length : 0;
+    const entitledToGuards = context.entitlements.guards ?? 0;
+    if (numOfGuards > entitledToGuards) {
+        errors.push({
+            type: 'entitlement',
+            message: `Number of guards exceeds your entitled limit of ${entitledToGuards}`,
+            path: ['ai-experimental', 'guards']
+        });
+    }
+    return errors;
+}
 function formatValidationResult(context, errors, schema) {
     const { suppressErrorPaths } = context;
     if (suppressErrorPaths) {
@@ -938,7 +967,8 @@ function validateSyntax(context, schema) {
         .concat(validateIndexedShapes(context, schema))
         .concat(validateInterfaces(schema))
         .concat(validateInterfaceImplementations(schema))
-        .concat(validateAgents(schema));
+        .concat(validateAgents(schema))
+        .concat(validateGuards(context, schema));
     return formatValidationResult(context, errors, schema);
 }
 async function validateReferences(context, schema) {

package/dist/esm/src/schemas/index.js

@@ -2,8 +2,6 @@
 export const CURRENT_SCHEMA_VERSION = '3.50.0';
 export { default as anyProjectSchema } from './project-schema.json';
 export { default as latestSchemaJson } from './project-schema/v3.50.0.json';
-export { default as authSchemaJson } from './auth-schemas.json';
-export { default as experimentalSchemaJson } from './project-schema/experimental.json';
 import experimentalSchemaJson from './project-schema/experimental.json';
 import metaSchemaV1_0_0 from './project-schema/meta-schema-v1.0.0.json';
 import projectSchemaV1_0_0 from './project-schema/v1.0.0.json';