@defai.digital/contracts 13.0.3

package/dist/workflow-templates/v1/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/workflow-templates/v1/schema.ts"],"names":[],"mappings":"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"}

package/dist/workflow-templates/v1/schema.js

@@ -0,0 +1,168 @@
+/**
+ * Workflow Templates Contract V1 - Schema Definitions
+ *
+ * Defines reusable workflow template schemas for different categories:
+ * - ML lifecycle workflows
+ * - Product development workflows
+ * - Infrastructure workflows
+ * - Leadership/strategic workflows
+ */
+import { z } from 'zod';
+/**
+ * Workflow template categories
+ */
+export const WorkflowCategorySchema = z.enum([
+    'ml-lifecycle', // Machine learning workflows
+    'product-development', // Product management workflows
+    'engineering', // Software engineering workflows
+    'infrastructure', // DevOps/infrastructure workflows
+    'leadership', // Strategic planning workflows
+    'quality', // QA and testing workflows
+    'security', // Security audit workflows
+    'research', // Technology research workflows
+]);
+/**
+ * Workflow step configuration for templates
+ */
+export const TemplateStepConfigSchema = z.object({
+    agent: z.string().min(1).max(50),
+    task: z.string().min(1).max(5000),
+    tools: z.array(z.string()).max(10).optional(),
+    outputs: z.array(z.string()).max(20).optional(),
+});
+/**
+ * Workflow template step
+ */
+export const WorkflowTemplateStepSchema = z.object({
+    stepId: z
+        .string()
+        .regex(/^[a-z][a-z0-9-]*$/)
+        .max(64),
+    name: z.string().max(128),
+    type: z.enum(['prompt', 'tool', 'conditional', 'parallel']),
+    timeout: z.number().int().min(1000).max(3600000).default(120000),
+    config: TemplateStepConfigSchema,
+    retryPolicy: z
+        .object({
+        maxAttempts: z.number().int().min(1).max(5).default(2),
+        backoffMs: z.number().int().min(1000).max(30000).default(2000),
+    })
+        .optional(),
+});
+/**
+ * Workflow template metadata
+ */
+export const WorkflowTemplateMetadataSchema = z.object({
+    requiredAbilities: z.array(z.string()).max(20),
+    requiredAgents: z.array(z.string()).max(10).optional(),
+    estimatedDuration: z.number().int().min(60).max(86400), // seconds
+    complexity: z.enum(['low', 'medium', 'high']),
+    schedule: z.string().max(100).optional(), // cron expression
+});
+/**
+ * Workflow template storage configuration
+ */
+export const WorkflowTemplateStorageSchema = z.object({
+    namespace: z.string().max(100),
+    ttl: z.number().int().min(3600).max(31536000).optional(), // seconds, 1hr to 1yr
+});
+/**
+ * Complete workflow template definition
+ */
+export const WorkflowTemplateSchema = z.object({
+    workflowId: z
+        .string()
+        .regex(/^[a-z][a-z0-9-]*$/)
+        .max(64),
+    name: z.string().max(128),
+    description: z.string().max(512),
+    version: z.string().regex(/^\d+\.\d+\.\d+$/),
+    category: WorkflowCategorySchema,
+    tags: z.array(z.string().max(50)).max(20),
+    metadata: WorkflowTemplateMetadataSchema,
+    steps: z.array(WorkflowTemplateStepSchema).min(1).max(50),
+    storage: WorkflowTemplateStorageSchema.optional(),
+});
+/**
+ * Workflow template registry entry
+ */
+export const WorkflowTemplateRegistryEntrySchema = z.object({
+    template: WorkflowTemplateSchema,
+    registeredAt: z.string().datetime(),
+    registeredBy: z.string().max(100),
+    enabled: z.boolean().default(true),
+    deprecatedAt: z.string().datetime().optional(),
+    deprecationReason: z.string().max(500).optional(),
+});
+/**
+ * Workflow template execution request
+ */
+export const WorkflowTemplateExecutionRequestSchema = z.object({
+    templateId: z.string().max(64),
+    sessionId: z.string().uuid().optional(),
+    inputs: z.record(z.string(), z.unknown()).optional(),
+    overrides: z
+        .object({
+        timeout: z.number().int().min(1000).max(3600000).optional(),
+        retryPolicy: z
+            .object({
+            maxAttempts: z.number().int().min(1).max(5),
+            backoffMs: z.number().int().min(1000).max(30000),
+        })
+            .optional(),
+    })
+        .optional(),
+});
+/**
+ * Workflow template execution result
+ */
+export const WorkflowTemplateExecutionResultSchema = z.object({
+    templateId: z.string().max(64),
+    executionId: z.string().uuid(),
+    sessionId: z.string().uuid().optional(),
+    status: z.enum(['pending', 'running', 'completed', 'failed', 'cancelled']),
+    startedAt: z.string().datetime(),
+    completedAt: z.string().datetime().optional(),
+    stepResults: z.array(z.object({
+        stepId: z.string().max(64),
+        status: z.enum(['pending', 'running', 'completed', 'failed', 'skipped']),
+        output: z.unknown().optional(),
+        error: z.string().max(2000).optional(),
+        duration: z.number().int().min(0).optional(),
+    })),
+    outputs: z.record(z.string(), z.unknown()).optional(),
+    error: z.string().max(2000).optional(),
+});
+// Validation helpers
+export const validateWorkflowTemplate = (data) => {
+    return WorkflowTemplateSchema.parse(data);
+};
+export const safeValidateWorkflowTemplate = (data) => {
+    const result = WorkflowTemplateSchema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, error: result.error };
+};
+export const validateWorkflowTemplateExecutionRequest = (data) => {
+    return WorkflowTemplateExecutionRequestSchema.parse(data);
+};
+// Factory functions
+export const createWorkflowTemplate = (params) => {
+    return WorkflowTemplateSchema.parse({
+        ...params,
+        version: params.version ?? '1.0.0',
+    });
+};
+// Error codes
+export const WorkflowTemplateErrorCodes = {
+    TEMPLATE_NOT_FOUND: 'WORKFLOW_TEMPLATE_NOT_FOUND',
+    TEMPLATE_ALREADY_EXISTS: 'WORKFLOW_TEMPLATE_ALREADY_EXISTS',
+    TEMPLATE_DEPRECATED: 'WORKFLOW_TEMPLATE_DEPRECATED',
+    INVALID_TEMPLATE_SCHEMA: 'INVALID_WORKFLOW_TEMPLATE_SCHEMA',
+    AGENT_NOT_FOUND: 'WORKFLOW_TEMPLATE_AGENT_NOT_FOUND',
+    TOOL_NOT_AVAILABLE: 'WORKFLOW_TEMPLATE_TOOL_NOT_AVAILABLE',
+    STEP_TIMEOUT: 'WORKFLOW_TEMPLATE_STEP_TIMEOUT',
+    EXECUTION_FAILED: 'WORKFLOW_TEMPLATE_EXECUTION_FAILED',
+};
+//# sourceMappingURL=schema.js.map

package/dist/workflow-templates/v1/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/workflow-templates/v1/schema.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,142 @@
+{
+  "name": "@defai.digital/contracts",
+  "version": "13.0.3",
+  "type": "module",
+  "description": "Contract schemas and behavioral invariants for AutomatosX - Single Source of Truth",
+  "license": "Apache-2.0",
+  "author": "DEFAI Private Limited",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/defai-digital/automatosx.git",
+    "directory": "packages/contracts"
+  },
+  "homepage": "https://github.com/defai-digital/automatosx#readme",
+  "bugs": {
+    "url": "https://github.com/defai-digital/automatosx/issues"
+  },
+  "keywords": [
+    "automatosx",
+    "contracts",
+    "schemas",
+    "zod",
+    "typescript",
+    "types"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./ability/v1": {
+      "types": "./dist/ability/v1/index.d.ts",
+      "import": "./dist/ability/v1/index.js"
+    },
+    "./agent/v1": {
+      "types": "./dist/agent/v1/index.d.ts",
+      "import": "./dist/agent/v1/index.js"
+    },
+    "./analysis/v1": {
+      "types": "./dist/analysis/v1/index.d.ts",
+      "import": "./dist/analysis/v1/index.js"
+    },
+    "./cli/v1": {
+      "types": "./dist/cli/v1/index.d.ts",
+      "import": "./dist/cli/v1/index.js"
+    },
+    "./config/v1": {
+      "types": "./dist/config/v1/index.d.ts",
+      "import": "./dist/config/v1/index.js"
+    },
+    "./context/v1": {
+      "types": "./dist/context/v1/index.d.ts",
+      "import": "./dist/context/v1/index.js"
+    },
+    "./cross-cutting/v1": {
+      "types": "./dist/cross-cutting/v1/index.d.ts",
+      "import": "./dist/cross-cutting/v1/index.js"
+    },
+    "./design/v1": {
+      "types": "./dist/design/v1/index.d.ts",
+      "import": "./dist/design/v1/index.js"
+    },
+    "./guard/v1": {
+      "types": "./dist/guard/v1/index.d.ts",
+      "import": "./dist/guard/v1/index.js"
+    },
+    "./iterate/v1": {
+      "types": "./dist/iterate/v1/index.d.ts",
+      "import": "./dist/iterate/v1/index.js"
+    },
+    "./mcp/v1": {
+      "types": "./dist/mcp/v1/index.d.ts",
+      "import": "./dist/mcp/v1/index.js"
+    },
+    "./memory/v1": {
+      "types": "./dist/memory/v1/index.d.ts",
+      "import": "./dist/memory/v1/index.js"
+    },
+    "./orchestration/v1": {
+      "types": "./dist/orchestration/v1/index.d.ts",
+      "import": "./dist/orchestration/v1/index.js"
+    },
+    "./provider/v1": {
+      "types": "./dist/provider/v1/index.d.ts",
+      "import": "./dist/provider/v1/index.js"
+    },
+    "./review/v1": {
+      "types": "./dist/review/v1/index.d.ts",
+      "import": "./dist/review/v1/index.js"
+    },
+    "./resilience/v1": {
+      "types": "./dist/resilience/v1/index.d.ts",
+      "import": "./dist/resilience/v1/index.js"
+    },
+    "./routing/v1": {
+      "types": "./dist/routing/v1/index.d.ts",
+      "import": "./dist/routing/v1/index.js"
+    },
+    "./session/v1": {
+      "types": "./dist/session/v1/index.d.ts",
+      "import": "./dist/session/v1/index.js"
+    },
+    "./storage/v1": {
+      "types": "./dist/storage/v1/index.d.ts",
+      "import": "./dist/storage/v1/index.js"
+    },
+    "./telemetry/v1": {
+      "types": "./dist/telemetry/v1/index.d.ts",
+      "import": "./dist/telemetry/v1/index.js"
+    },
+    "./token-budget/v1": {
+      "types": "./dist/token-budget/v1/index.d.ts",
+      "import": "./dist/token-budget/v1/index.js"
+    },
+    "./trace/v1": {
+      "types": "./dist/trace/v1/index.d.ts",
+      "import": "./dist/trace/v1/index.js"
+    },
+    "./workflow/v1": {
+      "types": "./dist/workflow/v1/index.d.ts",
+      "import": "./dist/workflow/v1/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.schema.json"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}

package/src/guard/v1/policy.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://automatosx.dev/schemas/guard/v1/policy.json",
+  "title": "AX Guard Policy",
+  "description": "Policy definition for AI coding governance",
+  "type": "object",
+  "properties": {
+    "policyId": {
+      "type": "string",
+      "description": "Unique identifier for this policy",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "allowedPaths": {
+      "type": "array",
+      "description": "Glob patterns for paths that may be modified. Supports {{variable}} placeholders.",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    },
+    "forbiddenPaths": {
+      "type": "array",
+      "description": "Glob patterns for paths that must not be modified",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    },
+    "requiredContracts": {
+      "type": "array",
+      "description": "Contract test suites that must pass",
+      "items": {
+        "type": "string",
+        "enum": ["workflow", "routing", "memory", "trace", "mcp"]
+      },
+      "default": []
+    },
+    "gates": {
+      "type": "array",
+      "description": "Gates to execute for this policy",
+      "items": {
+        "type": "string",
+        "enum": ["path_violation", "dependency", "change_radius", "contract_tests"]
+      },
+      "default": ["path_violation", "change_radius"]
+    },
+    "changeRadiusLimit": {
+      "type": "integer",
+      "description": "Maximum number of packages that can be modified",
+      "minimum": 1,
+      "default": 3
+    }
+  },
+  "required": ["policyId"],
+  "additionalProperties": false
+}

package/src/mcp/v1/tools.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://automatosx.dev/schemas/mcp/v1/tools.schema.json",
+  "title": "MCP Tool Contract V1",
+  "description": "Defines the structure of MCP tools with input/output schemas and error handling",
+  "type": "object",
+  "required": ["name", "description", "inputSchema"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "minLength": 1,
+      "maxLength": 64,
+      "description": "Unique identifier for the tool"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1024,
+      "description": "Human-readable description of what the tool does"
+    },
+    "inputSchema": {
+      "type": "object",
+      "description": "JSON Schema for tool input validation"
+    },
+    "outputSchema": {
+      "type": "object",
+      "description": "JSON Schema for tool output validation"
+    },
+    "errorCodes": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/ErrorCode"
+      },
+      "description": "List of standardized error codes this tool may return"
+    },
+    "metadata": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Optional tool metadata"
+    }
+  },
+  "$defs": {
+    "ErrorCode": {
+      "type": "object",
+      "required": ["code", "description"],
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string",
+          "pattern": "^[A-Z][A-Z0-9_]*$",
+          "description": "Standardized error code (e.g., INVALID_INPUT, RESOURCE_NOT_FOUND)"
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 256,
+          "description": "Description of when this error occurs"
+        },
+        "retryable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether this error type is safe to retry"
+        }
+      }
+    },
+    "ToolResult": {
+      "type": "object",
+      "required": ["success"],
+      "additionalProperties": false,
+      "properties": {
+        "success": {
+          "type": "boolean",
+          "description": "Whether the tool execution succeeded"
+        },
+        "data": {
+          "description": "Result data on success"
+        },
+        "error": {
+          "$ref": "#/$defs/ToolError",
+          "description": "Error details on failure"
+        }
+      }
+    },
+    "ToolError": {
+      "type": "object",
+      "required": ["code", "message"],
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "type": "string",
+          "pattern": "^[A-Z][A-Z0-9_]*$",
+          "description": "Standardized error code"
+        },
+        "message": {
+          "type": "string",
+          "maxLength": 512,
+          "description": "Human-readable error message"
+        },
+        "details": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "Additional error context"
+        }
+      }
+    }
+  }
+}

package/src/memory/v1/event.schema.json

@@ -0,0 +1,136 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://automatosx.dev/schemas/memory/v1/event.schema.json",
+  "title": "Memory Event Contract V1",
+  "description": "Defines the structure of memory events for event sourcing",
+  "type": "object",
+  "required": ["eventId", "type", "timestamp", "payload"],
+  "additionalProperties": false,
+  "properties": {
+    "eventId": {
+      "type": "string",
+      "format": "uuid",
+      "description": "Unique identifier for this event"
+    },
+    "type": {
+      "type": "string",
+      "enum": [
+        "conversation.created",
+        "conversation.updated",
+        "message.added",
+        "memory.stored",
+        "memory.retrieved",
+        "memory.deleted",
+        "context.snapshot"
+      ],
+      "description": "Type of memory event"
+    },
+    "timestamp": {
+      "type": "string",
+      "format": "date-time",
+      "description": "When the event occurred"
+    },
+    "aggregateId": {
+      "type": "string",
+      "description": "ID of the aggregate this event belongs to (e.g., conversation ID)"
+    },
+    "version": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Version number for optimistic concurrency"
+    },
+    "payload": {
+      "type": "object",
+      "description": "Event-specific data"
+    },
+    "metadata": {
+      "$ref": "#/$defs/EventMetadata",
+      "description": "Event metadata for auditing and tracing"
+    }
+  },
+  "$defs": {
+    "EventMetadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "correlationId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "ID linking related events"
+        },
+        "causationId": {
+          "type": "string",
+          "format": "uuid",
+          "description": "ID of the event that caused this event"
+        },
+        "userId": {
+          "type": "string",
+          "description": "User who triggered the event"
+        },
+        "source": {
+          "type": "string",
+          "description": "System component that generated the event"
+        }
+      }
+    },
+    "ConversationCreatedPayload": {
+      "type": "object",
+      "required": ["conversationId"],
+      "additionalProperties": false,
+      "properties": {
+        "conversationId": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "initialContext": {
+          "type": "object"
+        }
+      }
+    },
+    "MessageAddedPayload": {
+      "type": "object",
+      "required": ["messageId", "role", "content"],
+      "additionalProperties": false,
+      "properties": {
+        "messageId": {
+          "type": "string"
+        },
+        "role": {
+          "type": "string",
+          "enum": ["user", "assistant", "system"]
+        },
+        "content": {
+          "type": "string"
+        },
+        "tokenCount": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
+    },
+    "MemoryStoredPayload": {
+      "type": "object",
+      "required": ["key", "value"],
+      "additionalProperties": false,
+      "properties": {
+        "key": {
+          "type": "string"
+        },
+        "value": {},
+        "ttlMs": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Time to live in milliseconds"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}