@sdlcagent/agent-sdk 1.0.0

package/dist/validation.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resultEnvelopeSchema = exports.contextEnvelopeSchema = void 0;
+const zod_1 = require("zod");
+const triggerPayloadSchema = zod_1.z.object({
+    source: zod_1.z.string(),
+    payload: zod_1.z.record(zod_1.z.unknown()),
+});
+const promptRefSchema = zod_1.z.object({
+    role: zod_1.z.string(),
+    rendered: zod_1.z.string(),
+    prompt_id: zod_1.z.string().optional(),
+    version: zod_1.z.string().optional(),
+    binding_key: zod_1.z.string().optional(),
+});
+exports.contextEnvelopeSchema = zod_1.z.object({
+    org_id: zod_1.z.string().min(1),
+    project_id: zod_1.z.string().min(1),
+    team_id: zod_1.z.string().min(1),
+    run_id: zod_1.z.string().min(1),
+    step_id: zod_1.z.string().min(1),
+    workflow_type: zod_1.z.string().min(1),
+    run_mode: zod_1.z.enum(['CREATE', 'MODIFY_ENHANCE']),
+    trigger: triggerPayloadSchema,
+    work_item_context: zod_1.z.string(),
+    policy_snapshot: zod_1.z.record(zod_1.z.unknown()),
+    prompt_refs: zod_1.z.array(promptRefSchema),
+    redaction_profile: zod_1.z.record(zod_1.z.unknown()),
+    memory_refs: zod_1.z.record(zod_1.z.unknown()).optional(),
+    agent_config: zod_1.z.record(zod_1.z.unknown()),
+    log_callback_url: zod_1.z.string().min(1),
+    step_token: zod_1.z.string().min(1),
+});
+const actionRequestSchema = zod_1.z.object({
+    action_id: zod_1.z.string(),
+    action_key: zod_1.z.string(),
+    parameters: zod_1.z.record(zod_1.z.unknown()),
+    required: zod_1.z.boolean().optional(),
+});
+const artifactRefSchema = zod_1.z
+    .object({
+    artifact_id: zod_1.z.string(),
+    type: zod_1.z.string(),
+    title: zod_1.z.string(),
+    content: zod_1.z.string().optional(),
+    url: zod_1.z.string().optional(),
+})
+    .passthrough();
+const hitlOptionSchema = zod_1.z.object({
+    label: zod_1.z.string(),
+    description: zod_1.z.string(),
+    value: zod_1.z.string().optional(),
+});
+const memorySignalSchema = zod_1.z.object({
+    type: zod_1.z.enum(['episodic', 'semantic', 'procedural']),
+    scope: zod_1.z.enum(['workflow', 'project', 'tenant', 'global']),
+    content: zod_1.z.string(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    ttl_days: zod_1.z.number().optional(),
+});
+const criticCheckSchema = zod_1.z.object({
+    check_id: zod_1.z.string(),
+    label: zod_1.z.string(),
+    severity: zod_1.z.enum(['INFO', 'WARN', 'ERROR']),
+    passed: zod_1.z.boolean(),
+    detail: zod_1.z.string().optional(),
+});
+const criticSignalSchema = zod_1.z.object({
+    scorecard_id: zod_1.z.string(),
+    overall: zod_1.z.enum(['PASS', 'WARN', 'FAIL']),
+    checks: zod_1.z.array(criticCheckSchema),
+    score: zod_1.z.number().optional(),
+});
+exports.resultEnvelopeSchema = zod_1.z.object({
+    status: zod_1.z.enum(['SUCCEEDED', 'FAILED', 'HITL_REQUIRED']),
+    summary: zod_1.z.string(),
+    output_data: zod_1.z.record(zod_1.z.unknown()).optional(),
+    action_requests: zod_1.z.array(actionRequestSchema).optional(),
+    artifacts_created: zod_1.z.array(artifactRefSchema).optional(),
+    critic_signal: criticSignalSchema.optional(),
+    hitl_reason: zod_1.z.string().optional(),
+    hitl_options: zod_1.z.array(hitlOptionSchema).optional(),
+    remember: zod_1.z.array(memorySignalSchema).optional(),
+    agent_summary: zod_1.z.string().optional(),
+    next_step_hint: zod_1.z.string().optional(),
+    metrics: zod_1.z.record(zod_1.z.unknown()).optional(),
+});
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@sdlcagent/agent-sdk",
+  "version": "1.0.0",
+  "description": "Contract library for Sage platform agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prepare": "npm run build",
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "dotenv": "^17.4.2",
+    "express": "^4.18.2",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "@types/supertest": "^7.2.0",
+    "jest": "^30.4.2",
+    "supertest": "^7.2.2",
+    "ts-jest": "^29.4.11",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}