@llm-dev-ops/agentics-cli 1.4.26 → 1.4.29

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-function.js

@@ -0,0 +1,284 @@
+/**
+ * Google Cloud Function Handler
+ *
+ * Entry point for governance-dashboard-agents Cloud Function.
+ *
+ * Cloud Function name: governance-dashboard-agents
+ * Entry point: handler
+ * Runtime: nodejs20
+ *
+ * Routes:
+ * - POST /v1/governance-dashboard/audit     → Governance Audit Agent
+ * - POST /v1/governance-dashboard/impact    → Change Impact Agent
+ * - POST /v1/governance-dashboard/oversight  → Usage Oversight Agent
+ * - GET  /v1/governance-dashboard/health    → Health check
+ *
+ * Every response includes execution_metadata and layers_executed.
+ */
+import { createGovernanceAuditAgentFromEnv } from '../agents/governance-audit/index.js';
+import { createChangeImpactAgentFromEnv } from '../agents/change-impact/index.js';
+import { createUsageOversightAgentFromEnv } from '../agents/usage-oversight/index.js';
+import { generateUUID, getCurrentTimestamp } from '../contracts/validation.js';
+import { extractExecutionContext, createRepoSpan, createAgentSpan, attachArtifact, completeAgentSpan, failAgentSpan, finalizeRepoSpan, buildExecutionResponse, buildContextRejectionResponse, } from '../infrastructure/execution-span-manager.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const SERVICE_NAME = 'governance-dashboard-agents';
+const ROUTE_PREFIX = 'v1/governance-dashboard';
+const HEALTH_AGENTS = ['audit', 'impact', 'oversight'];
+/**
+ * Agent route configuration.
+ * Maps route slug → { factory, label for layers_executed }.
+ */
+const AGENT_ROUTES = {
+    audit: {
+        factory: createGovernanceAuditAgentFromEnv,
+        label: 'GOVERNANCE_DASHBOARD_AUDIT',
+    },
+    impact: {
+        factory: createChangeImpactAgentFromEnv,
+        label: 'GOVERNANCE_DASHBOARD_IMPACT',
+    },
+    oversight: {
+        factory: createUsageOversightAgentFromEnv,
+        label: 'GOVERNANCE_DASHBOARD_OVERSIGHT',
+    },
+};
+/**
+ * Build the execution_metadata block from request context.
+ */
+function buildExecutionMetadata(req) {
+    return {
+        trace_id: req.headers['x-correlation-id'] || generateUUID(),
+        timestamp: getCurrentTimestamp(),
+        service: SERVICE_NAME,
+        execution_id: generateUUID(),
+    };
+}
+/**
+ * Build the full response envelope with execution_metadata + layers_executed.
+ */
+function buildEnvelope(metadata, layers, data) {
+    return {
+        execution_metadata: metadata,
+        layers_executed: layers,
+        ...data,
+    };
+}
+/**
+ * Apply CORS headers.
+ */
+function applyCors(res) {
+    res.set('Access-Control-Allow-Origin', '*');
+    res.set('Access-Control-Allow-Methods', 'GET, POST, OPTIONS');
+    res.set('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Request-ID, X-Trace-ID, X-Correlation-ID, X-Parent-Span-ID, X-Execution-ID, X-Caller-Service, X-Caller-Version');
+}
+/**
+ * Send JSON response with CORS.
+ */
+function sendJson(res, status, body) {
+    applyCors(res);
+    res.status(status).json(body);
+}
+/**
+ * Create AgentContext from request.
+ */
+function createContextFromRequest(req) {
+    return {
+        execution_ref: req.headers['x-request-id'] || generateUUID(),
+        request_timestamp: getCurrentTimestamp(),
+        caller: {
+            service: req.headers['x-caller-service'] || 'cloud-function',
+            version: req.headers['x-caller-version'],
+            trace_id: req.headers['x-trace-id'],
+        },
+        organization_id: req.body?.organization_id || 'unknown',
+        telemetry_context: req.headers['x-trace-id']
+            ? {
+                trace_id: req.headers['x-trace-id'],
+                span_id: generateUUID().slice(0, 16),
+                parent_span_id: req.headers['x-parent-span-id'],
+            }
+            : undefined,
+    };
+}
+// ============================================================================
+// Main handler — exported as `handler` for gcloud --entry-point
+// ============================================================================
+/**
+ * Google Cloud Function entry point.
+ *
+ * @param req - Express-compatible Request
+ * @param res - Express-compatible Response
+ */
+export async function handler(req, res) {
+    const startTime = Date.now();
+    // CORS preflight
+    if (req.method === 'OPTIONS') {
+        applyCors(res);
+        res.status(204).send('');
+        return;
+    }
+    // Normalize path — strip leading/trailing slashes
+    const path = (req.path || '/').replace(/^\/+|\/+$/g, '');
+    const metadata = buildExecutionMetadata(req);
+    // Track repo span for error handling
+    let activeRepoSpan;
+    try {
+        // ---- Health check ----
+        if (path === `${ROUTE_PREFIX}/health` || path === 'health') {
+            const layers = [
+                { layer: 'AGENT_ROUTING', status: 'completed' },
+                { layer: 'HEALTH_CHECK', status: 'completed', duration_ms: Date.now() - startTime },
+            ];
+            sendJson(res, 200, buildEnvelope(metadata, layers, {
+                status: 'healthy',
+                agents: [...HEALTH_AGENTS],
+                version: '1.0.0',
+            }));
+            return;
+        }
+        // ---- Agent routes ----
+        // Match: v1/governance-dashboard/{agentSlug}
+        const agentRoutePrefix = `${ROUTE_PREFIX}/`;
+        if (path.startsWith(agentRoutePrefix)) {
+            const agentSlug = path.slice(agentRoutePrefix.length);
+            const route = AGENT_ROUTES[agentSlug];
+            if (!route) {
+                const layers = [
+                    { layer: 'AGENT_ROUTING', status: 'failed', duration_ms: Date.now() - startTime },
+                ];
+                sendJson(res, 404, buildEnvelope(metadata, layers, {
+                    error: {
+                        code: 'AGENT_NOT_FOUND',
+                        message: `Agent '${agentSlug}' not found`,
+                        available_agents: Object.keys(AGENT_ROUTES),
+                    },
+                }));
+                return;
+            }
+            if (req.method !== 'POST') {
+                const layers = [
+                    { layer: 'AGENT_ROUTING', status: 'failed', duration_ms: Date.now() - startTime },
+                ];
+                sendJson(res, 405, buildEnvelope(metadata, layers, {
+                    error: {
+                        code: 'METHOD_NOT_ALLOWED',
+                        message: `Method ${req.method} not allowed. Use POST.`,
+                    },
+                }));
+                return;
+            }
+            // Routing layer completed
+            const routingDone = Date.now();
+            // --- Execution Span enforcement ---
+            const execCtx = extractExecutionContext(req.headers);
+            if (!execCtx) {
+                const layers = [
+                    { layer: 'AGENT_ROUTING', status: 'completed', duration_ms: routingDone - startTime },
+                    { layer: route.label, status: 'failed', duration_ms: Date.now() - routingDone },
+                ];
+                sendJson(res, 400, buildEnvelope(metadata, layers, buildContextRejectionResponse()));
+                return;
+            }
+            // Create repo span
+            const repoSpan = createRepoSpan(execCtx);
+            activeRepoSpan = repoSpan;
+            // Create agent context
+            const context = createContextFromRequest(req);
+            // Create agent span
+            const agentSpan = createAgentSpan(repoSpan, agentSlug);
+            // Execute agent
+            const agent = route.factory();
+            let result;
+            try {
+                result = await agent.execute(req.body, context);
+            }
+            catch (agentError) {
+                failAgentSpan(agentSpan, {
+                    code: agentError.code || 'AGENT_UNHANDLED_ERROR',
+                    message: agentError.message || 'Unhandled agent error',
+                });
+                repoSpan.agent_spans.push(agentSpan);
+                finalizeRepoSpan(repoSpan);
+                const agentDone = Date.now();
+                const layers = [
+                    { layer: 'AGENT_ROUTING', status: 'completed', duration_ms: routingDone - startTime },
+                    { layer: route.label, status: 'failed', duration_ms: agentDone - routingDone },
+                ];
+                sendJson(res, 500, buildEnvelope(metadata, layers, buildExecutionResponse(repoSpan)));
+                return;
+            }
+            // Attach DecisionEvent artifact
+            if (result.decision_event) {
+                attachArtifact(agentSpan, 'decision_event', result.decision_event);
+            }
+            // Finalize agent span
+            if (result.success) {
+                completeAgentSpan(agentSpan);
+            }
+            else {
+                failAgentSpan(agentSpan, {
+                    code: result.error?.code || 'AGENT_FAILED',
+                    message: result.error?.message || 'Agent execution failed',
+                    details: result.error?.details,
+                });
+            }
+            repoSpan.agent_spans.push(agentSpan);
+            finalizeRepoSpan(repoSpan);
+            const agentDone = Date.now();
+            const layers = [
+                { layer: 'AGENT_ROUTING', status: 'completed', duration_ms: routingDone - startTime },
+                { layer: route.label, status: result.success ? 'completed' : 'failed', duration_ms: agentDone - routingDone },
+            ];
+            const executionResult = {
+                success: result.success,
+                decision_event_id: result.decision_event?.id,
+                output: result.success ? result.output : undefined,
+                error: result.success ? undefined : result.error,
+            };
+            const httpStatus = result.success ? 200 : 400;
+            sendJson(res, httpStatus, buildEnvelope(metadata, layers, {
+                ...buildExecutionResponse(repoSpan, executionResult),
+            }));
+            return;
+        }
+        // ---- Not found ----
+        const layers = [
+            { layer: 'AGENT_ROUTING', status: 'failed', duration_ms: Date.now() - startTime },
+        ];
+        sendJson(res, 404, buildEnvelope(metadata, layers, {
+            error: {
+                code: 'NOT_FOUND',
+                message: `Path '/${path}' not found. Use /v1/governance-dashboard/{audit|impact|oversight}`,
+            },
+        }));
+    }
+    catch (error) {
+        const elapsed = Date.now() - startTime;
+        console.error('Cloud Function handler error:', error);
+        const layers = [
+            { layer: 'AGENT_ROUTING', status: 'failed', duration_ms: elapsed },
+        ];
+        if (activeRepoSpan) {
+            activeRepoSpan.end_time = getCurrentTimestamp();
+            activeRepoSpan.status = 'FAILED';
+            activeRepoSpan.error = {
+                code: 'INTERNAL_ERROR',
+                message: error.message || 'Internal server error',
+            };
+            sendJson(res, 500, buildEnvelope(metadata, layers, buildExecutionResponse(activeRepoSpan)));
+        }
+        else {
+            sendJson(res, 500, buildEnvelope(metadata, layers, {
+                error: {
+                    code: 'INTERNAL_ERROR',
+                    message: error.message || 'Internal server error',
+                },
+            }));
+        }
+    }
+}
+// Default export for Cloud Functions
+export default handler;
+//# sourceMappingURL=cloud-function.js.map

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-function.js","sourceRoot":"","sources":["../../src/handlers/cloud-function.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,gCAAgC,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6CAA6C,CAAC;AAGrD,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,YAAY,GAAG,6BAA6B,CAAC;AACnD,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAC/C,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAEhE;;;GAGG;AACH,MAAM,YAAY,GAA0D;IAC1E,KAAK,EAAE;QACL,OAAO,EAAE,iCAAiC;QAC1C,KAAK,EAAE,4BAA4B;KACpC;IACD,MAAM,EAAE;QACN,OAAO,EAAE,8BAA8B;QACvC,KAAK,EAAE,6BAA6B;KACrC;IACD,SAAS,EAAE;QACT,OAAO,EAAE,gCAAgC;QACzC,KAAK,EAAE,gCAAgC;KACxC;CACF,CAAC;AAmBF;;GAEG;AACH,SAAS,sBAAsB,CAAC,GAAY;IAC1C,OAAO;QACL,QAAQ,EAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAY,IAAI,YAAY,EAAE;QACvE,SAAS,EAAE,mBAAmB,EAAE;QAChC,OAAO,EAAE,YAAY;QACrB,YAAY,EAAE,YAAY,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,QAA2B,EAC3B,MAAoB,EACpB,IAA6B;IAE7B,OAAO;QACL,kBAAkB,EAAE,QAAQ;QAC5B,eAAe,EAAE,MAAM;QACvB,GAAG,IAAI;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,GAAa;IAC9B,GAAG,CAAC,GAAG,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAC5C,GAAG,CAAC,GAAG,CAAC,8BAA8B,EAAE,oBAAoB,CAAC,CAAC;IAC9D,GAAG,CAAC,GAAG,CAAC,8BAA8B,EACpC,+IAA+I,CAAC,CAAC;AACrJ,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,GAAa,EAAE,MAAc,EAAE,IAAa;IAC5D,SAAS,CAAC,GAAG,CAAC,CAAC;IACf,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,GAAY;IAC5C,OAAO;QACL,aAAa,EAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAY,IAAI,YAAY,EAAE;QACxE,iBAAiB,EAAE,mBAAmB,EAAE;QACxC,MAAM,EAAE;YACN,OAAO,EAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAY,IAAI,gBAAgB;YACxE,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAW;YAClD,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAW;SAC9C;QACD,eAAe,EAAE,GAAG,CAAC,IAAI,EAAE,eAAe,IAAI,SAAS;QACvD,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;YAC1C,CAAC,CAAC;gBACE,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,CAAW;gBAC7C,OAAO,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACpC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAW;aAC1D;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,gEAAgE;AAChE,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAY,EAAE,GAAa;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,iBAAiB;IACjB,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,kDAAkD;IAClD,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAE7C,qCAAqC;IACrC,IAAI,cAAoC,CAAC;IAEzC,IAAI,CAAC;QACH,yBAAyB;QACzB,IAAI,IAAI,KAAK,GAAG,YAAY,SAAS,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAiB;gBAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE;gBAC/C,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;aACpF,CAAC;YAEF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE;gBACjD,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,CAAC,GAAG,aAAa,CAAC;gBAC1B,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC,CAAC;YACJ,OAAO;QACT,CAAC;QAED,yBAAyB;QACzB,6CAA6C;QAC7C,MAAM,gBAAgB,GAAG,GAAG,YAAY,GAAG,CAAC;QAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;YAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,MAAM,GAAiB;oBAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;iBAClF,CAAC;gBACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE;oBACjD,KAAK,EAAE;wBACL,IAAI,EAAE,iBAAiB;wBACvB,OAAO,EAAE,UAAU,SAAS,aAAa;wBACzC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;qBAC5C;iBACF,CAAC,CAAC,CAAC;gBACJ,OAAO;YACT,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,MAAM,MAAM,GAAiB;oBAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;iBAClF,CAAC;gBACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE;oBACjD,KAAK,EAAE;wBACL,IAAI,EAAE,oBAAoB;wBAC1B,OAAO,EAAE,UAAU,GAAG,CAAC,MAAM,yBAAyB;qBACvD;iBACF,CAAC,CAAC,CAAC;gBACJ,OAAO;YACT,CAAC;YAED,0BAA0B;YAC1B,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE/B,qCAAqC;YACrC,MAAM,OAAO,GAAG,uBAAuB,CACrC,GAAG,CAAC,OAAwD,CAC7D,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,MAAM,GAAiB;oBAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,SAAS,EAAE;oBACrF,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,EAAE;iBAChF,CAAC;gBACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC,CAAC,CAAC;gBACrF,OAAO;YACT,CAAC;YAED,mBAAmB;YACnB,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACzC,cAAc,GAAG,QAAQ,CAAC;YAE1B,uBAAuB;YACvB,MAAM,OAAO,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;YAE9C,oBAAoB;YACpB,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAEvD,gBAAgB;YAChB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC;YACX,IAAI,CAAC;gBACH,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClD,CAAC;YAAC,OAAO,UAAe,EAAE,CAAC;gBACzB,aAAa,CAAC,SAAS,EAAE;oBACvB,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,uBAAuB;oBAChD,OAAO,EAAE,UAAU,CAAC,OAAO,IAAI,uBAAuB;iBACvD,CAAC,CAAC;gBACH,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAiB;oBAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,SAAS,EAAE;oBACrF,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,GAAG,WAAW,EAAE;iBAC/E,CAAC;gBACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACtF,OAAO;YACT,CAAC;YAED,gCAAgC;YAChC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC1B,cAAc,CACZ,SAAS,EACT,gBAAgB,EAChB,MAAM,CAAC,cAAoD,CAC5D,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,SAAS,EAAE;oBACvB,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,cAAc;oBAC1C,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,wBAAwB;oBAC1D,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO;iBAC/B,CAAC,CAAC;YACL,CAAC;YAED,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAiB;gBAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,GAAG,SAAS,EAAE;gBACrF,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,GAAG,WAAW,EAAE;aAC9G,CAAC;YAEF,MAAM,eAAe,GAA4B;gBAC/C,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,EAAE;gBAC5C,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;gBAClD,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK;aACjD,CAAC;YAEF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAC9C,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE;gBACxD,GAAG,sBAAsB,CAAC,QAAQ,EAAE,eAAe,CAAC;aACrD,CAAC,CAAC,CAAC;YACJ,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,MAAM,MAAM,GAAiB;YAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE;SAClF,CAAC;QACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE;YACjD,KAAK,EAAE;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,UAAU,IAAI,oEAAoE;aAC5F;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACvC,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAiB;YAC3B,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE;SACnE,CAAC;QAEF,IAAI,cAAc,EAAE,CAAC;YACnB,cAAc,CAAC,QAAQ,GAAG,mBAAmB,EAAE,CAAC;YAChD,cAAc,CAAC,MAAM,GAAG,QAAQ,CAAC;YACjC,cAAc,CAAC,KAAK,GAAG;gBACrB,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB;aAClD,CAAC;YACF,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC9F,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE;gBACjD,KAAK,EAAE;oBACL,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB;iBAClD;aACF,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;AACH,CAAC;AAED,qCAAqC;AACrC,eAAe,OAAO,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-run.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Google Cloud Run Handler
+ *
+ * Phase 4 Layer 1 - Governance & FinOps compliant HTTP server.
+ *
+ * GOVERNANCE RULES ENFORCED:
+ * - Agents MUST emit cost signals
+ * - Agents MUST emit policy evaluation signals
+ * - Agents MUST emit approval requirements
+ * - Agents MUST NOT auto-enforce policy
+ * - Agents MUST NOT auto-approve actions
+ *
+ * PERFORMANCE BUDGETS:
+ * - MAX_TOKENS: 1200
+ * - MAX_LATENCY_MS: 2500
+ */
+import { type IncomingMessage, type ServerResponse } from 'http';
+/**
+ * Create and start HTTP server
+ */
+declare const server: import("http").Server<typeof IncomingMessage, typeof ServerResponse>;
+export { server };
+//# sourceMappingURL=cloud-run.d.ts.map

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-run.d.ts","sourceRoot":"","sources":["../../src/handlers/cloud-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,CAAC;AAmV/E;;GAEG;AACH,QAAA,MAAM,MAAM,sEAA8B,CAAC;AA6B3C,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/bundled-agents/governance-dashboard-agents/dist/handlers/cloud-run.js

@@ -0,0 +1,332 @@
+/**
+ * Google Cloud Run Handler
+ *
+ * Phase 4 Layer 1 - Governance & FinOps compliant HTTP server.
+ *
+ * GOVERNANCE RULES ENFORCED:
+ * - Agents MUST emit cost signals
+ * - Agents MUST emit policy evaluation signals
+ * - Agents MUST emit approval requirements
+ * - Agents MUST NOT auto-enforce policy
+ * - Agents MUST NOT auto-approve actions
+ *
+ * PERFORMANCE BUDGETS:
+ * - MAX_TOKENS: 1200
+ * - MAX_LATENCY_MS: 2500
+ */
+import { createServer } from 'http';
+import { createUsageOversightAgentFromEnv } from '../agents/usage-oversight/index.js';
+import { createChangeImpactAgentFromEnv } from '../agents/change-impact/index.js';
+import { generateUUID, getCurrentTimestamp } from '../contracts/validation.js';
+import { PERFORMANCE_BUDGETS, PHASE4_ENV, validatePerformanceBudgets, createPhase4Telemetry, } from '../config/phase4-layer1.js';
+import { extractExecutionContext, createRepoSpan, createAgentSpan, attachArtifact, completeAgentSpan, failAgentSpan, finalizeRepoSpan, buildExecutionResponse, buildContextRejectionResponse, } from '../infrastructure/execution-span-manager.js';
+/**
+ * Environment configuration
+ */
+const PORT = parseInt(process.env.PORT || '8080', 10);
+const MAX_LATENCY_MS = parseInt(process.env.MAX_LATENCY_MS || String(PERFORMANCE_BUDGETS.MAX_LATENCY_MS), 10);
+/**
+ * Agent route configuration
+ */
+const AGENT_ROUTES = {
+    'usage-oversight': createUsageOversightAgentFromEnv,
+    'change-impact': createChangeImpactAgentFromEnv,
+};
+/**
+ * Structured logging for Cloud Run
+ */
+function log(severity, message, data) {
+    const entry = {
+        severity,
+        message,
+        timestamp: getCurrentTimestamp(),
+        phase: PHASE4_ENV.AGENT_PHASE,
+        layer: PHASE4_ENV.AGENT_LAYER,
+        ...data,
+    };
+    console.log(JSON.stringify(entry));
+}
+/**
+ * Parse request body as JSON
+ */
+async function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (chunk) => chunks.push(chunk));
+        req.on('end', () => {
+            try {
+                const body = Buffer.concat(chunks).toString();
+                resolve(body ? JSON.parse(body) : {});
+            }
+            catch (error) {
+                reject(new Error('Invalid JSON body'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+/**
+ * Send JSON response
+ */
+function sendJson(res, statusCode, data) {
+    res.writeHead(statusCode, {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type, Authorization, X-Request-ID, X-Trace-ID',
+        'X-Agent-Phase': PHASE4_ENV.AGENT_PHASE,
+        'X-Agent-Layer': PHASE4_ENV.AGENT_LAYER,
+    });
+    res.end(JSON.stringify(data));
+}
+/**
+ * Create AgentContext from request headers
+ */
+function createContext(req, body) {
+    return {
+        execution_ref: req.headers['x-request-id'] || generateUUID(),
+        request_timestamp: getCurrentTimestamp(),
+        caller: {
+            service: req.headers['x-caller-service'] || 'cloud-run',
+            version: req.headers['x-caller-version'],
+            trace_id: req.headers['x-trace-id'],
+        },
+        organization_id: body?.organization_id || 'unknown',
+        telemetry_context: req.headers['x-trace-id']
+            ? {
+                trace_id: req.headers['x-trace-id'],
+                span_id: generateUUID().slice(0, 16),
+                parent_span_id: req.headers['x-parent-span-id'],
+            }
+            : undefined,
+    };
+}
+/**
+ * Handle incoming HTTP request
+ */
+async function handleRequest(req, res) {
+    const startTime = Date.now();
+    const path = (req.url || '/').replace(/^\/+|\/+$/g, '');
+    // Handle CORS preflight
+    if (req.method === 'OPTIONS') {
+        sendJson(res, 204, null);
+        return;
+    }
+    // Track active repo span for error handling
+    let activeRepoSpan;
+    try {
+        // Health check
+        if (path === 'health') {
+            sendJson(res, 200, {
+                status: 'healthy',
+                timestamp: getCurrentTimestamp(),
+                version: '1.0.0',
+                phase: PHASE4_ENV.AGENT_PHASE,
+                layer: PHASE4_ENV.AGENT_LAYER,
+                agents: Object.keys(AGENT_ROUTES),
+                performance_budgets: PERFORMANCE_BUDGETS,
+            });
+            return;
+        }
+        // Readiness check (for Cloud Run)
+        if (path === 'ready') {
+            sendJson(res, 200, { ready: true });
+            return;
+        }
+        // List agents
+        if (path === 'agents' && req.method === 'GET') {
+            sendJson(res, 200, {
+                agents: Object.keys(AGENT_ROUTES).map((id) => ({
+                    id,
+                    endpoint: `/agents/${id}`,
+                    methods: ['POST'],
+                    phase: PHASE4_ENV.AGENT_PHASE,
+                    layer: PHASE4_ENV.AGENT_LAYER,
+                })),
+            });
+            return;
+        }
+        // Agent execution
+        if (path.startsWith('agents/')) {
+            const agentId = path.replace('agents/', '');
+            if (req.method !== 'POST') {
+                sendJson(res, 405, {
+                    error: {
+                        code: 'METHOD_NOT_ALLOWED',
+                        message: `Method ${req.method} not allowed. Use POST.`,
+                    },
+                });
+                return;
+            }
+            const agentFactory = AGENT_ROUTES[agentId];
+            if (!agentFactory) {
+                sendJson(res, 404, {
+                    error: {
+                        code: 'AGENT_NOT_FOUND',
+                        message: `Agent '${agentId}' not found`,
+                        available_agents: Object.keys(AGENT_ROUTES),
+                    },
+                });
+                return;
+            }
+            // Parse request body
+            const body = await parseBody(req);
+            // --- EXECUTION SPAN ENFORCEMENT ---
+            // Extract execution context (REQUIRED by Foundational Execution Unit contract)
+            const execCtx = extractExecutionContext(req.headers);
+            if (!execCtx) {
+                sendJson(res, 400, buildContextRejectionResponse());
+                return;
+            }
+            // Create repo-level span
+            const repoSpan = createRepoSpan(execCtx);
+            activeRepoSpan = repoSpan;
+            // Create agent context (preserves existing behavior)
+            const context = createContext(req, body);
+            // Create agent-level span
+            const agentSpan = createAgentSpan(repoSpan, agentId);
+            // Create and execute agent
+            const agent = agentFactory();
+            let result;
+            try {
+                result = await agent.execute(body, context);
+            }
+            catch (agentError) {
+                // Agent threw an unhandled exception
+                failAgentSpan(agentSpan, {
+                    code: agentError.code || 'AGENT_UNHANDLED_ERROR',
+                    message: agentError.message || 'Unhandled agent error',
+                });
+                repoSpan.agent_spans.push(agentSpan);
+                finalizeRepoSpan(repoSpan);
+                const latencyMs = Date.now() - startTime;
+                log('ERROR', `Agent ${agentId} unhandled error`, {
+                    agent_id: agentId,
+                    error: agentError.message,
+                    latency_ms: latencyMs,
+                    repo_span_id: repoSpan.span_id,
+                    agent_span_id: agentSpan.span_id,
+                });
+                sendJson(res, 500, buildExecutionResponse(repoSpan));
+                return;
+            }
+            // Attach DecisionEvent as artifact on the agent span
+            if (result.decision_event) {
+                attachArtifact(agentSpan, 'decision_event', result.decision_event);
+            }
+            // Finalize agent span based on result
+            if (result.success) {
+                completeAgentSpan(agentSpan);
+            }
+            else {
+                failAgentSpan(agentSpan, {
+                    code: result.error?.code || 'AGENT_FAILED',
+                    message: result.error?.message || 'Agent execution failed',
+                    details: result.error?.details,
+                });
+            }
+            // Attach agent span to repo span and finalize
+            repoSpan.agent_spans.push(agentSpan);
+            finalizeRepoSpan(repoSpan);
+            // Calculate execution metrics
+            const latencyMs = Date.now() - startTime;
+            const budgetCheck = validatePerformanceBudgets({ latency_ms: latencyMs });
+            // Log execution (structured for Cloud Run)
+            log(result.success ? 'INFO' : 'WARNING', `Agent ${agentId} execution`, {
+                agent_id: agentId,
+                success: result.success,
+                latency_ms: latencyMs,
+                decision_event_id: result.decision_event?.id,
+                budget_violations: budgetCheck.violations,
+                repo_span_id: repoSpan.span_id,
+                agent_span_id: agentSpan.span_id,
+            });
+            // Warn if performance budget exceeded (but don't fail - just emit signal)
+            if (!budgetCheck.valid) {
+                log('WARNING', 'Performance budget exceeded', {
+                    agent_id: agentId,
+                    violations: budgetCheck.violations,
+                    latency_ms: latencyMs,
+                    max_latency_ms: MAX_LATENCY_MS,
+                });
+            }
+            // Build response with Phase 4 telemetry
+            const telemetry = createPhase4Telemetry(latencyMs, context.caller.service);
+            const executionResult = {
+                success: result.success,
+                decision_event_id: result.decision_event?.id,
+                output: result.success ? result.output : undefined,
+                error: result.success ? undefined : result.error,
+                telemetry,
+            };
+            const httpStatus = result.success ? 200 : 400;
+            sendJson(res, httpStatus, buildExecutionResponse(repoSpan, executionResult));
+            return;
+        }
+        // Not found
+        sendJson(res, 404, {
+            error: {
+                code: 'NOT_FOUND',
+                message: `Path '${path}' not found`,
+            },
+        });
+    }
+    catch (error) {
+        const latencyMs = Date.now() - startTime;
+        log('ERROR', 'Request handler error', {
+            error: error.message,
+            stack: error.stack,
+            path,
+            latency_ms: latencyMs,
+        });
+        // If we were in span execution mode, finalize and return spans
+        if (activeRepoSpan) {
+            activeRepoSpan.end_time = getCurrentTimestamp();
+            activeRepoSpan.status = 'FAILED';
+            activeRepoSpan.error = {
+                code: 'INTERNAL_ERROR',
+                message: error.message || 'Internal server error',
+            };
+            sendJson(res, 500, buildExecutionResponse(activeRepoSpan));
+        }
+        else {
+            sendJson(res, 500, {
+                error: {
+                    code: 'INTERNAL_ERROR',
+                    message: error.message || 'Internal server error',
+                },
+                telemetry: createPhase4Telemetry(latencyMs),
+            });
+        }
+    }
+}
+/**
+ * Create and start HTTP server
+ */
+const server = createServer(handleRequest);
+// Graceful shutdown handling
+process.on('SIGTERM', () => {
+    log('INFO', 'SIGTERM received, shutting down gracefully');
+    server.close(() => {
+        log('INFO', 'Server closed');
+        process.exit(0);
+    });
+});
+process.on('SIGINT', () => {
+    log('INFO', 'SIGINT received, shutting down');
+    server.close(() => {
+        process.exit(0);
+    });
+});
+// Start server
+server.listen(PORT, () => {
+    log('INFO', 'Governance Agents Cloud Run service started', {
+        port: PORT,
+        phase: PHASE4_ENV.AGENT_PHASE,
+        layer: PHASE4_ENV.AGENT_LAYER,
+        agents: Object.keys(AGENT_ROUTES),
+        performance_budgets: PERFORMANCE_BUDGETS,
+    });
+});
+export { server };
+//# sourceMappingURL=cloud-run.js.map