@deepintel-ltd/farmpro-contracts 1.3.1 → 1.3.3

package/dist/routes/agent-workflows.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-workflows.routes.d.ts","sourceRoot":"","sources":["../../src/routes/agent-workflows.routes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+J/B,CAAC"}

package/dist/routes/agent-workflows.routes.js

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentWorkflowsRouter = void 0;
+const core_1 = require("@ts-rest/core");
+const zod_1 = require("zod");
+const agent_workflows_schemas_1 = require("../schemas/agent-workflows.schemas");
+const c = (0, core_1.initContract)();
+/**
+ * Agent Workflows Routes
+ *
+ * API endpoints for querying and monitoring autonomous agent workflows.
+ * These workflows track the system's automated decision-making process
+ * for converting recommendations into tasks.
+ */
+exports.agentWorkflowsRouter = c.router({
+    /**
+     * List agent workflows with filters
+     */
+    listWorkflows: {
+        method: 'GET',
+        path: '/agent-workflows',
+        query: zod_1.z.object({
+            farmId: zod_1.z.string().uuid().optional(),
+            fieldId: zod_1.z.string().uuid().optional(),
+            status: agent_workflows_schemas_1.agentWorkflowStatusSchema.optional(),
+            triggerEvent: zod_1.z.string().optional(), // e.g., 'observation.analysis.completed'
+            startDate: zod_1.z.string().datetime().optional(),
+            endDate: zod_1.z.string().datetime().optional(),
+            limit: zod_1.z.number().int().min(1).max(100).default(20),
+            offset: zod_1.z.number().int().min(0).default(0),
+        }),
+        responses: {
+            200: agent_workflows_schemas_1.agentWorkflowListResponseSchema,
+            400: zod_1.z.object({
+                errors: zod_1.z.array(zod_1.z.object({
+                    status: zod_1.z.string(),
+                    code: zod_1.z.string(),
+                    title: zod_1.z.string(),
+                    detail: zod_1.z.string(),
+                })),
+            }),
+        },
+        summary: 'List agent workflows with filters',
+    },
+    /**
+     * Get a specific workflow by ID
+     */
+    getWorkflow: {
+        method: 'GET',
+        path: '/agent-workflows/:id',
+        responses: {
+            200: agent_workflows_schemas_1.agentWorkflowResponseSchema,
+            404: zod_1.z.object({
+                errors: zod_1.z.array(zod_1.z.object({
+                    status: zod_1.z.literal('404'),
+                    code: zod_1.z.string(),
+                    title: zod_1.z.string(),
+                    detail: zod_1.z.string(),
+                })),
+            }),
+        },
+        summary: 'Get agent workflow details',
+    },
+    /**
+     * Get workflows for a specific farm
+     */
+    getWorkflowsByFarm: {
+        method: 'GET',
+        path: '/farms/:farmId/agent-workflows',
+        query: zod_1.z.object({
+            status: agent_workflows_schemas_1.agentWorkflowStatusSchema.optional(),
+            limit: zod_1.z.number().int().min(1).max(100).default(20),
+            offset: zod_1.z.number().int().min(0).default(0),
+        }),
+        responses: {
+            200: agent_workflows_schemas_1.agentWorkflowListResponseSchema,
+            404: zod_1.z.object({
+                errors: zod_1.z.array(zod_1.z.object({
+                    status: zod_1.z.literal('404'),
+                    code: zod_1.z.string(),
+                    title: zod_1.z.string(),
+                    detail: zod_1.z.string(),
+                })),
+            }),
+        },
+        summary: 'Get all workflows for a farm',
+    },
+    /**
+     * Get workflows for a specific field
+     */
+    getWorkflowsByField: {
+        method: 'GET',
+        path: '/fields/:fieldId/agent-workflows',
+        query: zod_1.z.object({
+            status: agent_workflows_schemas_1.agentWorkflowStatusSchema.optional(),
+            limit: zod_1.z.number().int().min(1).max(100).default(20),
+            offset: zod_1.z.number().int().min(0).default(0),
+        }),
+        responses: {
+            200: agent_workflows_schemas_1.agentWorkflowListResponseSchema,
+            404: zod_1.z.object({
+                errors: zod_1.z.array(zod_1.z.object({
+                    status: zod_1.z.literal('404'),
+                    code: zod_1.z.string(),
+                    title: zod_1.z.string(),
+                    detail: zod_1.z.string(),
+                })),
+            }),
+        },
+        summary: 'Get all workflows for a field',
+    },
+    /**
+     * Get workflow statistics
+     */
+    getWorkflowStats: {
+        method: 'GET',
+        path: '/agent-workflows/stats',
+        query: zod_1.z.object({
+            farmId: zod_1.z.string().uuid().optional(),
+            startDate: zod_1.z.string().datetime().optional(),
+            endDate: zod_1.z.string().datetime().optional(),
+        }),
+        responses: {
+            200: zod_1.z.object({
+                data: zod_1.z.object({
+                    overall: zod_1.z.object({
+                        totalWorkflows: zod_1.z.number().int(),
+                        successRate: zod_1.z.number(),
+                        avgProcessingTime: zod_1.z.number(),
+                        tasksCreated: zod_1.z.number().int(),
+                        tasksUpdated: zod_1.z.number().int(),
+                        skipped: zod_1.z.number().int(),
+                    }),
+                    bySource: zod_1.z.record(zod_1.z.object({
+                        workflows: zod_1.z.number().int(),
+                        tasksCreated: zod_1.z.number().int(),
+                        tasksUpdated: zod_1.z.number().int(),
+                        skipped: zod_1.z.number().int(),
+                        skipRate: zod_1.z.number(),
+                        avgConfidence: zod_1.z.number().optional(),
+                    })),
+                    deduplication: zod_1.z.object({
+                        exactMatches: zod_1.z.number().int(),
+                        semanticMatches: zod_1.z.number().int(),
+                        categoryMatches: zod_1.z.number().int(),
+                        crossSourceMatches: zod_1.z.number().int(),
+                        avgSimilarityScore: zod_1.z.number(),
+                    }),
+                    outcomes: zod_1.z.object({
+                        tasksCompleted: zod_1.z.number().int(),
+                        tasksPending: zod_1.z.number().int(),
+                        tasksInProgress: zod_1.z.number().int(),
+                        completionRate: zod_1.z.number(),
+                    }),
+                }),
+            }),
+        },
+        summary: 'Get agent workflow statistics and analytics',
+    },
+});