@llm-dev-ops/agentics-cli 1.4.25 → 1.4.27

package/dist/bundled-agents/analytics-hub-agents/dist/execution/execution-graph.d.ts

@@ -0,0 +1,54 @@
+/**
+ * ExecutionGraph — per-request, append-only span accumulator
+ *
+ * Manages the lifecycle of repo-level and agent-level execution spans
+ * within a single API request. Enforces the Agentics invariant that
+ * every execution must contain at least one agent span.
+ */
+import { ExecutionContext, SpanArtifact, SpanHierarchy, SpanStatus } from './span-types';
+export declare class ExecutionGraph {
+    private repoSpan;
+    private agentSpans;
+    constructor(context: ExecutionContext, repoName: string);
+    /**
+     * Start an agent-level span. Returns the span_id for later
+     * use with endAgentSpan() and attachArtifact().
+     */
+    startAgentSpan(agentName: string, attributes?: Record<string, unknown>): string;
+    /**
+     * Complete an agent span, setting its end_time and final status.
+     */
+    endAgentSpan(spanId: string, status: SpanStatus): void;
+    /**
+     * Attach a machine-verifiable artifact to an agent span.
+     */
+    attachArtifact(spanId: string, artifact: Omit<SpanArtifact, 'timestamp'>): void;
+    /**
+     * Finalize the repo-level span.
+     */
+    finalize(status: SpanStatus): void;
+    /**
+     * Validate the execution graph invariants.
+     * Returns invalid if no agent spans were emitted.
+     */
+    validate(): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Build the JSON-serializable span hierarchy for the response.
+     */
+    toHierarchy(): SpanHierarchy;
+    getRepoSpanId(): string;
+    getTraceId(): string;
+}
+/**
+ * Wrap a data-processing operation with an agent-level span.
+ * Creates a `data-processing-agent` span, executes the handler,
+ * and optionally attaches an artifact from the result.
+ */
+export declare function withDataProcessingSpan<T>(graph: ExecutionGraph | null | undefined, operationName: string, handler: () => Promise<T>, artifactBuilder?: (result: T) => {
+    artifact_type: string;
+    data: unknown;
+}): Promise<T>;
+//# sourceMappingURL=execution-graph.d.ts.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/execution-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-graph.d.ts","sourceRoot":"","sources":["../../src/execution/execution-graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,gBAAgB,EAEhB,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,UAAU,CAAuB;gBAE7B,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM;IAcvD;;;OAGG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM;IAgBT;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAQtD;;OAEG;IACH,cAAc,CACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GACxC,IAAI;IAUP;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKlC;;;OAGG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAU9C;;OAEG;IACH,WAAW,IAAI,aAAa;IAQ5B,aAAa,IAAI,MAAM;IAIvB,UAAU,IAAI,MAAM;CAGrB;AAID;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EACxC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GACxE,OAAO,CAAC,CAAC,CAAC,CAyBZ"}

package/dist/bundled-agents/analytics-hub-agents/dist/execution/execution-graph.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * ExecutionGraph — per-request, append-only span accumulator
+ *
+ * Manages the lifecycle of repo-level and agent-level execution spans
+ * within a single API request. Enforces the Agentics invariant that
+ * every execution must contain at least one agent span.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionGraph = void 0;
+exports.withDataProcessingSpan = withDataProcessingSpan;
+const uuid_1 = require("uuid");
+class ExecutionGraph {
+    repoSpan;
+    agentSpans = [];
+    constructor(context, repoName) {
+        this.repoSpan = {
+            span_id: (0, uuid_1.v4)(),
+            parent_span_id: context.parent_span_id,
+            trace_id: context.execution_id,
+            span_type: 'repo',
+            name: repoName,
+            status: 'ok',
+            start_time: new Date().toISOString(),
+            attributes: { repo_name: repoName },
+            artifacts: [],
+        };
+    }
+    /**
+     * Start an agent-level span. Returns the span_id for later
+     * use with endAgentSpan() and attachArtifact().
+     */
+    startAgentSpan(agentName, attributes) {
+        const span = {
+            span_id: (0, uuid_1.v4)(),
+            parent_span_id: this.repoSpan.span_id,
+            trace_id: this.repoSpan.trace_id,
+            span_type: 'agent',
+            name: agentName,
+            status: 'ok',
+            start_time: new Date().toISOString(),
+            attributes: attributes || {},
+            artifacts: [],
+        };
+        this.agentSpans.push(span);
+        return span.span_id;
+    }
+    /**
+     * Complete an agent span, setting its end_time and final status.
+     */
+    endAgentSpan(spanId, status) {
+        const span = this.agentSpans.find((s) => s.span_id === spanId);
+        if (span) {
+            span.end_time = new Date().toISOString();
+            span.status = status;
+        }
+    }
+    /**
+     * Attach a machine-verifiable artifact to an agent span.
+     */
+    attachArtifact(spanId, artifact) {
+        const span = this.agentSpans.find((s) => s.span_id === spanId);
+        if (span) {
+            span.artifacts.push({
+                ...artifact,
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    /**
+     * Finalize the repo-level span.
+     */
+    finalize(status) {
+        this.repoSpan.end_time = new Date().toISOString();
+        this.repoSpan.status = status;
+    }
+    /**
+     * Validate the execution graph invariants.
+     * Returns invalid if no agent spans were emitted.
+     */
+    validate() {
+        if (this.agentSpans.length === 0) {
+            return {
+                valid: false,
+                error: 'No agent-level spans were emitted during execution',
+            };
+        }
+        return { valid: true };
+    }
+    /**
+     * Build the JSON-serializable span hierarchy for the response.
+     */
+    toHierarchy() {
+        return {
+            core_span_id: this.repoSpan.parent_span_id,
+            repo_span: { ...this.repoSpan },
+            agent_spans: this.agentSpans.map((s) => ({ ...s })),
+        };
+    }
+    getRepoSpanId() {
+        return this.repoSpan.span_id;
+    }
+    getTraceId() {
+        return this.repoSpan.trace_id;
+    }
+}
+exports.ExecutionGraph = ExecutionGraph;
+// ─── Helper for data routes ────────────────────────────────────
+/**
+ * Wrap a data-processing operation with an agent-level span.
+ * Creates a `data-processing-agent` span, executes the handler,
+ * and optionally attaches an artifact from the result.
+ */
+async function withDataProcessingSpan(graph, operationName, handler, artifactBuilder) {
+    if (!graph)
+        return handler();
+    const spanId = graph.startAgentSpan('data-processing-agent', {
+        operation: operationName,
+    });
+    try {
+        const result = await handler();
+        if (artifactBuilder) {
+            const artifact = artifactBuilder(result);
+            graph.attachArtifact(spanId, {
+                artifact_type: artifact.artifact_type,
+                artifact_id: spanId,
+                data: artifact.data,
+            });
+        }
+        graph.endAgentSpan(spanId, 'ok');
+        return result;
+    }
+    catch (error) {
+        graph.endAgentSpan(spanId, 'error');
+        throw error;
+    }
+}
+//# sourceMappingURL=execution-graph.js.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/execution-graph.js.map

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

package/dist/bundled-agents/analytics-hub-agents/dist/execution/fastify-plugin.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fastify Execution Context Plugin
+ *
+ * Hooks into the Fastify request lifecycle to:
+ * 1. Extract execution context (execution_id, parent_span_id) from headers
+ * 2. Create an ExecutionGraph per request
+ * 3. Validate and wrap responses with the span hierarchy
+ *
+ * Enforces the Agentics contract: every non-operational request must
+ * carry a parent_span_id and produce at least one agent span.
+ */
+import { FastifyInstance } from 'fastify';
+declare function executionContextPlugin(fastify: FastifyInstance): Promise<void>;
+declare const _default: typeof executionContextPlugin;
+export default _default;
+//# sourceMappingURL=fastify-plugin.d.ts.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/fastify-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify-plugin.d.ts","sourceRoot":"","sources":["../../src/execution/fastify-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AA2CxE,iBAAe,sBAAsB,CAAC,OAAO,EAAE,eAAe,iBA0G7D;;AAED,wBAGG"}

package/dist/bundled-agents/analytics-hub-agents/dist/execution/fastify-plugin.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * Fastify Execution Context Plugin
+ *
+ * Hooks into the Fastify request lifecycle to:
+ * 1. Extract execution context (execution_id, parent_span_id) from headers
+ * 2. Create an ExecutionGraph per request
+ * 3. Validate and wrap responses with the span hierarchy
+ *
+ * Enforces the Agentics contract: every non-operational request must
+ * carry a parent_span_id and produce at least one agent span.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const fastify_plugin_1 = __importDefault(require("fastify-plugin"));
+const uuid_1 = require("uuid");
+const execution_graph_1 = require("./execution-graph");
+const HEADER_EXECUTION_ID = 'x-execution-id';
+const HEADER_PARENT_SPAN_ID = 'x-parent-span-id';
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Operational paths that are excluded from execution context enforcement.
+ * Also excludes public ingestion endpoints that receive events from
+ * external producers (governance-core fanout, etc.) without an
+ * Agentics execution context.
+ */
+function isOperationalPath(url) {
+    const path = url.split('?')[0];
+    // Top-level operational endpoints
+    if (path === '/health' ||
+        path === '/ready' ||
+        path === '/metrics') {
+        return true;
+    }
+    // Swagger documentation
+    if (path.startsWith('/documentation'))
+        return true;
+    // Public ingestion endpoints — external producers won't carry span headers
+    if (path.startsWith('/api/v1/events') || path.startsWith('/api/v1/ingest')) {
+        return true;
+    }
+    // Agent health and metadata sub-routes (introspection, not execution)
+    if (path.endsWith('/health') || path.endsWith('/metadata'))
+        return true;
+    return false;
+}
+async function executionContextPlugin(fastify) {
+    // Decorate request with executionGraph (null by default)
+    fastify.decorateRequest('executionGraph', null);
+    // ── onRequest: extract context, reject if missing ──────────
+    fastify.addHook('onRequest', async (request, reply) => {
+        if (isOperationalPath(request.url))
+            return;
+        const parentSpanId = request.headers[HEADER_PARENT_SPAN_ID];
+        const executionId = request.headers[HEADER_EXECUTION_ID];
+        if (!parentSpanId) {
+            reply.code(400).send({
+                success: false,
+                error: {
+                    code: 'MISSING_EXECUTION_CONTEXT',
+                    message: 'x-parent-span-id header is required for all non-operational requests',
+                },
+            });
+            return;
+        }
+        if (!UUID_REGEX.test(parentSpanId)) {
+            reply.code(400).send({
+                success: false,
+                error: {
+                    code: 'INVALID_EXECUTION_CONTEXT',
+                    message: 'x-parent-span-id must be a valid UUID',
+                },
+            });
+            return;
+        }
+        const context = {
+            execution_id: executionId && UUID_REGEX.test(executionId)
+                ? executionId
+                : (0, uuid_1.v4)(),
+            parent_span_id: parentSpanId,
+        };
+        request.executionGraph = new execution_graph_1.ExecutionGraph(context, 'analytics-hub');
+    });
+    // ── onSend: validate graph and wrap response ───────────────
+    fastify.addHook('onSend', async (request, reply, payload) => {
+        if (!request.executionGraph)
+            return payload;
+        const graph = request.executionGraph;
+        graph.finalize(reply.statusCode < 400 ? 'ok' : 'error');
+        const validation = graph.validate();
+        if (!validation.valid) {
+            // Invariant violation: no agent spans emitted.
+            // Mark repo span as failed and return 500.
+            graph.finalize('error');
+            reply.code(500);
+            return JSON.stringify({
+                success: false,
+                error: {
+                    code: 'EXECUTION_INVARIANT_VIOLATION',
+                    message: validation.error,
+                },
+                _execution: graph.toHierarchy(),
+            });
+        }
+        // Wrap JSON responses with _execution
+        let parsed = null;
+        try {
+            parsed =
+                typeof payload === 'string' ? JSON.parse(payload) : null;
+        }
+        catch {
+            // Not JSON — attach trace via header
+        }
+        if (parsed && typeof parsed === 'object') {
+            return JSON.stringify({
+                ...parsed,
+                _execution: graph.toHierarchy(),
+            });
+        }
+        // Non-JSON payload: put trace in header
+        reply.header('x-execution-trace', JSON.stringify(graph.toHierarchy()));
+        return payload;
+    });
+}
+exports.default = (0, fastify_plugin_1.default)(executionContextPlugin, {
+    name: 'execution-context',
+    fastify: '4.x',
+});
+//# sourceMappingURL=fastify-plugin.js.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/fastify-plugin.js.map

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

package/dist/bundled-agents/analytics-hub-agents/dist/execution/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Agentics Execution Span Module
+ *
+ * Provides execution span instrumentation for the analytics-hub
+ * as a Foundational Execution Unit within the Agentics system.
+ */
+export type { SpanType, SpanStatus, SpanArtifact, ExecutionSpan, ExecutionContext, SpanHierarchy, } from './span-types';
+export { ExecutionContextSchema } from './span-types';
+export { ExecutionGraph, withDataProcessingSpan } from './execution-graph';
+//# sourceMappingURL=index.d.ts.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/bundled-agents/analytics-hub-agents/dist/execution/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Agentics Execution Span Module
+ *
+ * Provides execution span instrumentation for the analytics-hub
+ * as a Foundational Execution Unit within the Agentics system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDataProcessingSpan = exports.ExecutionGraph = exports.ExecutionContextSchema = void 0;
+var span_types_1 = require("./span-types");
+Object.defineProperty(exports, "ExecutionContextSchema", { enumerable: true, get: function () { return span_types_1.ExecutionContextSchema; } });
+var execution_graph_1 = require("./execution-graph");
+Object.defineProperty(exports, "ExecutionGraph", { enumerable: true, get: function () { return execution_graph_1.ExecutionGraph; } });
+Object.defineProperty(exports, "withDataProcessingSpan", { enumerable: true, get: function () { return execution_graph_1.withDataProcessingSpan; } });
+//# sourceMappingURL=index.js.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAWH,2CAAsD;AAA7C,oHAAA,sBAAsB,OAAA;AAC/B,qDAA2E;AAAlE,iHAAA,cAAc,OAAA;AAAE,yHAAA,sBAAsB,OAAA"}

package/dist/bundled-agents/analytics-hub-agents/dist/execution/span-types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Agentics Execution Span Types
+ *
+ * Defines the span data model for the Agentics execution system.
+ * All types are JSON-serializable, append-only, and causally ordered
+ * via parent_span_id linkage.
+ */
+import { z } from 'zod';
+export type SpanType = 'core' | 'repo' | 'agent';
+export type SpanStatus = 'ok' | 'error';
+export interface SpanArtifact {
+    artifact_type: string;
+    artifact_id: string;
+    data: unknown;
+    timestamp: string;
+}
+export interface ExecutionSpan {
+    span_id: string;
+    parent_span_id: string;
+    trace_id: string;
+    span_type: SpanType;
+    name: string;
+    status: SpanStatus;
+    start_time: string;
+    end_time?: string;
+    attributes: Record<string, unknown>;
+    artifacts: SpanArtifact[];
+}
+export interface ExecutionContext {
+    execution_id: string;
+    parent_span_id: string;
+}
+export declare const ExecutionContextSchema: z.ZodObject<{
+    execution_id: z.ZodString;
+    parent_span_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    execution_id: string;
+    parent_span_id: string;
+}, {
+    execution_id: string;
+    parent_span_id: string;
+}>;
+export interface SpanHierarchy {
+    core_span_id: string;
+    repo_span: ExecutionSpan;
+    agent_spans: ExecutionSpan[];
+}
+//# sourceMappingURL=span-types.d.ts.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/span-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-types.d.ts","sourceRoot":"","sources":["../../src/execution/span-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACjD,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAID,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAIH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B"}

package/dist/bundled-agents/analytics-hub-agents/dist/execution/span-types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Agentics Execution Span Types
+ *
+ * Defines the span data model for the Agentics execution system.
+ * All types are JSON-serializable, append-only, and causally ordered
+ * via parent_span_id linkage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionContextSchema = void 0;
+const zod_1 = require("zod");
+exports.ExecutionContextSchema = zod_1.z.object({
+    execution_id: zod_1.z.string().uuid(),
+    parent_span_id: zod_1.z.string().uuid(),
+});
+//# sourceMappingURL=span-types.js.map

package/dist/bundled-agents/analytics-hub-agents/dist/execution/span-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-types.js","sourceRoot":"","sources":["../../src/execution/span-types.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6BAAwB;AAkCX,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC/B,cAAc,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;CAClC,CAAC,CAAC"}

package/dist/bundled-agents/analytics-hub-agents/dist/functions/handler.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Cloud Function Entry Point — analytics-hub-agents
+ *
+ * Maps the two Analytics Hub agents to Cloud Function routes:
+ *   POST /v1/analytics-hub/consensus       → Consensus Agent
+ *   POST /v1/analytics-hub/recommendation  → Strategic Recommendation Agent
+ *   GET  /v1/analytics-hub/health          → Health check
+ *
+ * Every response includes execution_metadata and layers_executed.
+ * Business logic is delegated entirely to existing agent modules.
+ *
+ * @module functions/handler
+ */
+/**
+ * Cloud Function HTTP request (Express-compatible shape provided by the runtime)
+ */
+interface CFRequest {
+    method: string;
+    path: string;
+    url: string;
+    body: any;
+    headers: Record<string, string | string[] | undefined>;
+}
+/**
+ * Cloud Function HTTP response (Express-compatible shape provided by the runtime)
+ */
+interface CFResponse {
+    status(code: number): CFResponse;
+    set(key: string, value: string): CFResponse;
+    json(data: unknown): void;
+    send(data: string): void;
+    end(): void;
+}
+/**
+ * Google Cloud Function HTTP handler.
+ *
+ * Deploy with:
+ *   gcloud functions deploy analytics-hub-agents \
+ *     --runtime nodejs20 --trigger-http --region us-central1 \
+ *     --project agentics-dev --entry-point handler \
+ *     --memory 512MB --timeout 120s --no-allow-unauthenticated
+ */
+export declare function handler(req: CFRequest, res: CFResponse): Promise<void>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/dist/bundled-agents/analytics-hub-agents/dist/functions/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/functions/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuBH;;GAEG;AACH,UAAU,SAAS;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,UAAU,UAAU;IAClB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,IAAI,IAAI,CAAC;CACb;AA6JD;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C5E"}