aimeat 1.15.1 → 1.16.2

package/dist/src/generated/api-types.d.ts

@@ -624,6 +624,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{name}/max-concurrent-tasks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Set how many tasks the agent's runner may process concurrently
+         * @description Owner sets `max_concurrent_tasks` (1–20, default 1) for an agent. 1 = serial (safe for any engine); higher values require a runner that can process tasks in parallel (e.g. a CrewAI daemon with a per-task liaison/worker pool). AIMEAT only stores and exposes the number — it does not enforce concurrency server-side. The runner reads it from the integration kit's `watchdog_spec.max_concurrent_tasks`.
+         */
+        patch: operations["updateAgentMaxConcurrentTasks"];
+        trace?: never;
+    };
     "/v1/agents/{name}/scopes": {
         parameters: {
             query?: never;
@@ -788,7 +808,10 @@ export interface paths {
         /** Update memory (optimistic locking) */
         put: operations["updateMemory"];
         post?: never;
-        /** Delete memory */
+        /**
+         * Delete memory
+         * @description Delete a memory entry by key. Owner sessions may delete entries stored under any of their own agents — if the key is not found under the owner's GHII, the server looks it up across the owner's agents and deletes the match. Operators may delete any owner's entry by passing the `owner` query parameter.
+         */
         delete: operations["deleteMemory"];
         options?: never;
         head?: never;
@@ -7077,7 +7100,7 @@ export interface paths {
         put?: never;
         /**
          * Complete a task
-         * @description Mark an active task as done with an optional completion message.
+         * @description Mark an active task as done with an optional completion message. The agent may also pass `deliverable_key` — the memory key (under its own namespace) where it published the task's output — which is stored on the task so the owner UI can link straight to the deliverable.
          */
         post: operations["completeAgentTask"];
         delete?: never;
@@ -7106,6 +7129,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{name}/tasks/{id}/rate": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Review a completed task's deliverable (Quality tab)
+         * @description Attach a per-context star rating (1–5) to a **done** task. The `context` is the quality dimension (factual/creative/code/…). Authorization: the task's owner (human) or a same-owner agent (e.g. the parent orchestrator that delegated the work); an agent may not rate its own deliverable.
+         *
+         *     **Source-grounding hard gate:** for the factual family (`factual`/`research`/`code`/`summarization`) an *agent* rater must set `source_grounded: true` (the rating was checked against the inputs/ sources), otherwise the request is rejected with `422 GROUNDING_REQUIRED`. Human owners are exempt; `creative` accepts an output-alone craft rating. The rating refreshes the agent's public statistics cache.
+         */
+        post: operations["rateAgentTask"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents/{name}/tasks/{id}/todos/{todoId}": {
         parameters: {
             query?: never;
@@ -7379,6 +7424,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/agents/{name}/statistics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get agent quality statistics (Quality tab)
+         * @description Recompute the agent's performance rollup (task counts, success rate, completion durations by context) and per-context peer-review rollup (stars, distribution, variance, low-confidence flag, rater mix, per-model slice) **from the agent's tasks** — the source of truth, so the result is not forgeable. The recomputed rollups are also written to the owner's public statistics cache keys (`agents.<name>.statistics.performance` / `.reviews`). Also returns any custom metrics the agent published under `agents.<name>.statistics.custom.*`. Owners can view any of their agents; an agent can view itself.
+         */
+        get: operations["getAgentStatistics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/agents/{name}/webhook": {
         parameters: {
             query?: never;
@@ -8032,6 +8097,11 @@ export interface components {
             tags?: string[];
             /** @description Time-to-live in hours (null = permanent) */
             ttl_hours?: number | null;
+            /**
+             * @description Owner-session only — target GAII to store this entry under one of the owner's own agents instead of the owner's GHII. Ignored for agent sessions. The agent must belong to the calling owner.
+             * @example claude#alice@aimeat-fi-001-genesis
+             */
+            agent?: string;
         };
         MemoryEntry: {
             key?: string;
@@ -9412,6 +9482,32 @@ export interface components {
             createdAt: string;
             /** Format: date-time */
             updatedAt: string;
+            /** @description Memory key (agent namespace) where the task's deliverable was published, if any. */
+            deliverableKey?: string;
+            rating?: components["schemas"]["AgentTaskRating"];
+        };
+        /** @description Peer/owner review of a completed task's deliverable (Quality tab). Feeds the per-context quality rollup from GET /v1/agents/{name}/statistics. */
+        AgentTaskRating: {
+            stars: number;
+            /** @enum {string} */
+            context: "factual" | "creative" | "code" | "planning" | "summarization" | "research" | "communication" | "other";
+            comment?: string;
+            /** @description GHII (owner) or GAII (agent) of the rater. */
+            ratedBy: string;
+            /** @enum {string} */
+            raterType: "human-owner" | "agent" | "source-grounded-agent";
+            /** @description Whether the rating was checked against the deliverable's inputs/sources. */
+            sourceGrounded: boolean;
+            /** @description Optional count of unsupported/fabricated claims. */
+            unsupported?: number;
+            /** @description Model that produced the deliverable (baseline stamp). */
+            evaluatedModel?: string;
+            /** @description Free-form evaluation context (temperature, tokens, cost, ...) stored for later slicing. */
+            metadata?: {
+                [key: string]: unknown;
+            };
+            /** Format: date-time */
+            ratedAt: string;
         };
         TaskEvent: {
             /** @enum {string} */
@@ -10836,6 +10932,52 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
+    updateAgentMaxConcurrentTasks: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Agent name (not full GAII) */
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @default 1 */
+                    max_concurrent_tasks: number;
+                };
+            };
+        };
+        responses: {
+            /** @description Concurrency updated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AimeatEnvelope"] & {
+                        data?: {
+                            gaii?: string;
+                            name?: string;
+                            max_concurrent_tasks?: number;
+                        };
+                    };
+                };
+            };
+            /** @description Invalid value (must be an integer 1–20). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     updateAgentScopes: {
         parameters: {
             query?: never;
@@ -11210,7 +11352,10 @@ export interface operations {
     };
     deleteMemory: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Operator-only override — target identity (GHII/GAII) whose memory entry should be deleted. Ignored for non-operator sessions. */
+                owner?: string;
+            };
             header?: never;
             path: {
                 key: string;
@@ -11220,6 +11365,7 @@ export interface operations {
         requestBody?: never;
         responses: {
             200: components["responses"]["AimeatSuccess"];
+            404: components["responses"]["NotFound"];
         };
     };
     searchMemory: {
@@ -20912,6 +21058,8 @@ export interface operations {
                 "application/json": {
                     /** @description Completion summary */
                     message?: string;
+                    /** @description Memory key (in the agent's namespace) holding the task's published deliverable. Stored on the task; the owner UI links to it and shows if the entry was later deleted. */
+                    deliverable_key?: string;
                 };
             };
         };
@@ -20967,6 +21115,70 @@ export interface operations {
             409: components["responses"]["Conflict"];
         };
     };
+    rateAgentTask: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                name: string;
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Star rating, 1 (poor) to 5 (excellent). */
+                    stars: number;
+                    /**
+                     * @description Quality dimension this rating scores.
+                     * @enum {string}
+                     */
+                    context: "factual" | "creative" | "code" | "planning" | "summarization" | "research" | "communication" | "other";
+                    comment?: string;
+                    /**
+                     * @description Whether the rating was checked against the deliverable's inputs/sources. Required true for the factual family when the rater is an agent.
+                     * @default false
+                     */
+                    source_grounded?: boolean;
+                    /** @description Optional count of unsupported/fabricated claims (e.g. from a factcheck pass). */
+                    unsupported?: number;
+                    /** @description Model that produced the deliverable (baseline stamp; ratings are not compared blindly across model changes). */
+                    evaluated_model?: string;
+                    /** @description Free-form evaluation context (e.g. temperature, top_p, max_tokens, tokens_in/out, cost) stored on the rating for later slicing. Max 4096 bytes serialized. */
+                    metadata?: {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+        };
+        responses: {
+            /** @description Task rated */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AimeatEnvelope"] & {
+                        data?: components["schemas"]["AgentTask"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+            /** @description Source-grounding required for this context (GROUNDING_REQUIRED). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AimeatEnvelope"];
+                };
+            };
+        };
+    };
     updateTaskTodo: {
         parameters: {
             query?: never;
@@ -21492,6 +21704,29 @@ export interface operations {
             404: components["responses"]["NotFound"];
         };
     };
+    getAgentStatistics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                name: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Recomputed performance + review rollups and custom metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+        };
+    };
     getAgentWebhook: {
         parameters: {
             query?: never;