@llm-dev-ops/agentics-cli 1.3.2 → 1.3.4

package/dist/server/routes/plans.js

@@ -0,0 +1,47 @@
+/**
+ * Plans Route Handler
+ *
+ * POST /v1/plans
+ *
+ * Handles simulation plan creation from the planner service.
+ * Used by the CLI's `plan` command.
+ */
+import { Hono } from 'hono';
+import { ids } from '../utils/id-generator.js';
+import { buildPlanReference } from '../utils/response-builder.js';
+const plans = new Hono();
+/**
+ * POST /v1/plans
+ *
+ * Create a simulation plan based on a manifest reference.
+ */
+plans.post('/', async (c) => {
+    try {
+        const body = await c.req.json();
+        // Validate required fields
+        if (!body.manifest_ref) {
+            return c.json({
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: 'manifest_ref is required',
+                },
+            }, 400);
+        }
+        const id = ids.plan();
+        const params = body.params ?? {};
+        // Build response matching PlanReference type
+        const response = buildPlanReference(id, body.manifest_ref, params);
+        return c.json(response, 200);
+    }
+    catch (error) {
+        console.error('Plans route error:', error);
+        return c.json({
+            error: {
+                code: 'INTERNAL_ERROR',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            },
+        }, 500);
+    }
+});
+export { plans };
+//# sourceMappingURL=plans.js.map

package/dist/server/routes/plans.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../../../src/server/routes/plans.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;AAOzB;;;;GAIG;AACH,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAgB,CAAC;QAE9C,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC,IAAI,CACX;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,0BAA0B;iBACpC;aACF,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAEjC,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAEnE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC3C,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE;SACF,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/server/routes/roi.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ROI Route Handler
+ *
+ * POST /v1/roi
+ *
+ * Handles ROI report generation from the enterprise ROI engine.
+ * Used by the CLI's `quantify` command.
+ */
+import { Hono } from 'hono';
+declare const roi: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export { roi };
+//# sourceMappingURL=roi.d.ts.map

package/dist/server/routes/roi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roi.d.ts","sourceRoot":"","sources":["../../../src/server/routes/roi.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,QAAA,MAAM,GAAG,4EAAa,CAAC;AAoDvB,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/server/routes/roi.js

@@ -0,0 +1,48 @@
+/**
+ * ROI Route Handler
+ *
+ * POST /v1/roi
+ *
+ * Handles ROI report generation from the enterprise ROI engine.
+ * Used by the CLI's `quantify` command.
+ */
+import { Hono } from 'hono';
+import { ids } from '../utils/id-generator.js';
+import { buildRoiReportReference } from '../utils/response-builder.js';
+const roi = new Hono();
+/**
+ * POST /v1/roi
+ *
+ * Generate an ROI report based on a simulation reference.
+ */
+roi.post('/', async (c) => {
+    try {
+        const body = await c.req.json();
+        // Validate required fields
+        if (!body.sim_ref) {
+            return c.json({
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: 'sim_ref is required',
+                },
+            }, 400);
+        }
+        const id = ids.roi();
+        const reportType = body.report_type ?? 'cfo-grade';
+        const params = body.params ?? {};
+        // Build response matching RoiReportReference type
+        const response = buildRoiReportReference(id, body.sim_ref, reportType, params);
+        return c.json(response, 200);
+    }
+    catch (error) {
+        console.error('ROI route error:', error);
+        return c.json({
+            error: {
+                code: 'INTERNAL_ERROR',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            },
+        }, 500);
+    }
+});
+export { roi };
+//# sourceMappingURL=roi.js.map

package/dist/server/routes/roi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roi.js","sourceRoot":"","sources":["../../../src/server/routes/roi.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;AAQvB;;;;GAIG;AACH,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IACxB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAc,CAAC;QAE5C,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,IAAI,CACX;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,qBAAqB;iBAC/B;aACF,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;QAEjC,kDAAkD;QAClD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAE/E,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACzC,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE;SACF,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/server/routes/runner.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Runner Route Handler
+ *
+ * POST /v1/runner
+ *
+ * Handles simulation execution from the runner service.
+ * Used by the CLI's `simulate` command.
+ */
+import { Hono } from 'hono';
+declare const runner: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export { runner };
+//# sourceMappingURL=runner.d.ts.map

package/dist/server/routes/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/server/routes/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,QAAA,MAAM,MAAM,4EAAa,CAAC;AAsD1B,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/server/routes/runner.js

@@ -0,0 +1,50 @@
+/**
+ * Runner Route Handler
+ *
+ * POST /v1/runner
+ *
+ * Handles simulation execution from the runner service.
+ * Used by the CLI's `simulate` command.
+ */
+import { Hono } from 'hono';
+import { ids } from '../utils/id-generator.js';
+import { buildSimulationRunReference } from '../utils/response-builder.js';
+const runner = new Hono();
+/**
+ * POST /v1/runner
+ *
+ * Execute a simulation based on a plan reference.
+ */
+runner.post('/', async (c) => {
+    try {
+        const body = await c.req.json();
+        // Validate required fields
+        if (!body.plan_ref) {
+            return c.json({
+                error: {
+                    code: 'VALIDATION_ERROR',
+                    message: 'plan_ref is required',
+                },
+            }, 400);
+        }
+        const id = ids.run();
+        const config = {
+            ...body.config,
+            iterations: body.iterations ?? 1,
+        };
+        // Build response matching SimulationReference type
+        const response = buildSimulationRunReference(id, body.plan_ref, config);
+        return c.json(response, 200);
+    }
+    catch (error) {
+        console.error('Runner route error:', error);
+        return c.json({
+            error: {
+                code: 'INTERNAL_ERROR',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            },
+        }, 500);
+    }
+});
+export { runner };
+//# sourceMappingURL=runner.js.map

package/dist/server/routes/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../../src/server/routes/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3E,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;AAQ1B;;;;GAIG;AACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC3B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAiB,CAAC;QAE/C,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC,IAAI,CACX;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,sBAAsB;iBAChC;aACF,EACD,GAAG,CACJ,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG;YACb,GAAG,IAAI,CAAC,MAAM;YACd,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;SACjC,CAAC;QAEF,mDAAmD;QACnD,MAAM,QAAQ,GAAG,2BAA2B,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAExE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE;SACF,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/server/routes/simulate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Simulate Route Handler
+ *
+ * POST /v1/simulate
+ *
+ * Handles both:
+ * 1. Simulation execution from plan_ref (CLI's `simulate` command)
+ * 2. Simulation output retrieval from sim_ref (CLI's `inspect` command)
+ */
+import { Hono } from 'hono';
+declare const simulate: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export { simulate };
+//# sourceMappingURL=simulate.d.ts.map

package/dist/server/routes/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../../src/server/routes/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,QAAA,MAAM,QAAQ,4EAAa,CAAC;AAgE5B,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/server/routes/simulate.js

@@ -0,0 +1,58 @@
+/**
+ * Simulate Route Handler
+ *
+ * POST /v1/simulate
+ *
+ * Handles both:
+ * 1. Simulation execution from plan_ref (CLI's `simulate` command)
+ * 2. Simulation output retrieval from sim_ref (CLI's `inspect` command)
+ */
+import { Hono } from 'hono';
+import { ids } from '../utils/id-generator.js';
+import { buildSimulationOutputReference, buildSimulationRunReference } from '../utils/response-builder.js';
+const simulate = new Hono();
+/**
+ * POST /v1/simulate
+ *
+ * Handles both simulation execution and output retrieval.
+ */
+simulate.post('/', async (c) => {
+    try {
+        const body = await c.req.json();
+        // Case 1: Running a simulation (plan_ref provided)
+        if (body.plan_ref) {
+            const id = ids.run();
+            const config = {
+                ...body.config,
+                iterations: body.iterations ?? 1,
+            };
+            const response = buildSimulationRunReference(id, body.plan_ref, config);
+            return c.json(response, 200);
+        }
+        // Case 2: Inspecting simulation outputs (sim_ref provided)
+        if (body.sim_ref) {
+            const outputType = body.output_type ?? 'summary';
+            const id = ids.simulation();
+            const response = buildSimulationOutputReference(id, body.sim_ref, outputType);
+            return c.json(response, 200);
+        }
+        // Neither provided - error
+        return c.json({
+            error: {
+                code: 'VALIDATION_ERROR',
+                message: 'Either plan_ref (to run simulation) or sim_ref (to inspect outputs) is required',
+            },
+        }, 400);
+    }
+    catch (error) {
+        console.error('Simulate route error:', error);
+        return c.json({
+            error: {
+                code: 'INTERNAL_ERROR',
+                message: error instanceof Error ? error.message : 'Unknown error',
+            },
+        }, 500);
+    }
+});
+export { simulate };
+//# sourceMappingURL=simulate.js.map

package/dist/server/routes/simulate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.js","sourceRoot":"","sources":["../../../src/server/routes/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3G,MAAM,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC;AAY5B;;;;GAIG;AACH,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAC7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAmB,CAAC;QAEjD,mDAAmD;QACnD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG;gBACb,GAAG,IAAI,CAAC,MAAM;gBACd,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;aACjC,CAAC;YACF,MAAM,QAAQ,GAAG,2BAA2B,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACxE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,2DAA2D;QAC3D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;YACjD,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,8BAA8B,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,2BAA2B;QAC3B,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE;gBACL,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,iFAAiF;aAC3F;SACF,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC,IAAI,CACX;YACE,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;aAClE;SACF,EACD,GAAG,CACJ,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/server/utils/id-generator.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ID Generator Utilities
+ *
+ * Generates consistent, prefixed IDs for various resource types.
+ */
+/**
+ * Generate a timestamped ID with prefix
+ */
+export declare function generateId(prefix: string): string;
+/**
+ * Generate IDs for specific resource types
+ */
+export declare const ids: {
+    readonly simulation: () => string;
+    readonly manifest: () => string;
+    readonly plan: () => string;
+    readonly run: () => string;
+    readonly roi: () => string;
+    readonly intent: () => string;
+    readonly export: () => string;
+    readonly diligence: () => string;
+    readonly erp: () => string;
+};
+/**
+ * Generate a checksum-like string for responses
+ */
+export declare function generateChecksum(): string;
+/**
+ * Generate an artifact location URL
+ */
+export declare function generateArtifactLocation(type: string, id: string): string;
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/server/utils/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../src/server/utils/id-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;CAUN,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/server/utils/id-generator.js

@@ -0,0 +1,51 @@
+/**
+ * ID Generator Utilities
+ *
+ * Generates consistent, prefixed IDs for various resource types.
+ */
+/**
+ * Generate a random hex string of specified length
+ */
+function randomHex(length) {
+    const bytes = new Uint8Array(Math.ceil(length / 2));
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map(b => b.toString(16).padStart(2, '0'))
+        .join('')
+        .slice(0, length);
+}
+/**
+ * Generate a timestamped ID with prefix
+ */
+export function generateId(prefix) {
+    const timestamp = Date.now().toString(36);
+    const random = randomHex(8);
+    return `${prefix}-${timestamp}-${random}`;
+}
+/**
+ * Generate IDs for specific resource types
+ */
+export const ids = {
+    simulation: () => generateId('sim'),
+    manifest: () => generateId('manifest'),
+    plan: () => generateId('plan'),
+    run: () => generateId('run'),
+    roi: () => generateId('roi'),
+    intent: () => generateId('intent'),
+    export: () => generateId('export'),
+    diligence: () => generateId('diligence'),
+    erp: () => generateId('erp'),
+};
+/**
+ * Generate a checksum-like string for responses
+ */
+export function generateChecksum() {
+    return `sha256:${randomHex(64)}`;
+}
+/**
+ * Generate an artifact location URL
+ */
+export function generateArtifactLocation(type, id) {
+    return `https://artifacts.agentics.dev/${type}/${id}`;
+}
+//# sourceMappingURL=id-generator.js.map

package/dist/server/utils/id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../../src/server/utils/id-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACzC,IAAI,CAAC,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,GAAG,MAAM,IAAI,SAAS,IAAI,MAAM,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,UAAU,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;IACnC,QAAQ,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;IACtC,IAAI,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;IAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;IAC5B,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;IAC5B,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;IAClC,MAAM,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;IAClC,SAAS,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;IACxC,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;CACpB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,EAAU;IAC/D,OAAO,kCAAkC,IAAI,IAAI,EAAE,EAAE,CAAC;AACxD,CAAC"}

package/dist/server/utils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Utility Exports
+ *
+ * Central export for all server utility functions.
+ */
+export * from './id-generator.js';
+export * from './response-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/server/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Utility Exports
+ *
+ * Central export for all server utility functions.
+ */
+export * from './id-generator.js';
+export * from './response-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/server/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/server/utils/response-builder.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Response Builder Utilities
+ *
+ * Builds consistent API responses matching CLI expectations.
+ */
+/**
+ * Base reference structure matching CLI types
+ */
+export interface BaseReferenceResponse {
+    id: string;
+    type: string;
+    repository: string;
+    created_at: string;
+    checksum: string;
+}
+/**
+ * Build a base reference response
+ */
+export declare function buildBaseReference(id: string, type: string, repository: string): BaseReferenceResponse;
+/**
+ * Build simulation output reference
+ */
+export declare function buildSimulationOutputReference(id: string, simRef: unknown, outputType: string): Record<string, unknown>;
+/**
+ * Build manifest reference
+ */
+export declare function buildManifestReference(id: string, query: string): Record<string, unknown>;
+/**
+ * Build plan reference
+ */
+export declare function buildPlanReference(id: string, manifestRef: unknown, params: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build simulation run reference
+ */
+export declare function buildSimulationRunReference(id: string, planRef: unknown, config: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build ROI report reference
+ */
+export declare function buildRoiReportReference(id: string, simRef: unknown, reportType: string, params: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build intent reference
+ */
+export declare function buildIntentReference(id: string, simRef: unknown, spec: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build export reference
+ */
+export declare function buildExportReference(id: string, intentRef: unknown, formatSpec: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build ERP Surface reference
+ */
+export declare function buildErpSurfaceReference(id: string, sourceRef: unknown, erpType: string, operation: string, entityType: string, query: Record<string, unknown>, syncConfig: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Build diligence package reference
+ */
+export declare function buildDiligencePackageReference(id: string, refs: unknown, frameworks: string[], requirements: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=response-builder.d.ts.map

package/dist/server/utils/response-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../../src/server/utils/response-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAQvB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoDzB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwCzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8BzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AA6CD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoCzB;AAmBD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB"}