@capybara-hq/kernel 0.1.0-rc.0 → 0.1.0-rc.10

package/dist/agents/agents.module.js

@@ -0,0 +1,71 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Module } from "@nestjs/common";
+import { AttachmentsModule } from "../conversations/attachments.module.js";
+import { EvalBudgetModule } from "../evals/budget.js";
+import { ExtensionsModule } from "../extensions/extensions.module.js";
+import { ModelsModule } from "../models/models.module.js";
+import { OrgLockModule } from "../orgs/org-lock.js";
+import { ProvidersModule } from "../runtime/providers.js";
+import { SkillsModule } from "../skills/skills.module.js";
+import { ToolsModule } from "../tools/tools.module.js";
+import { AgentLookupModule } from "./agent-lookup.js";
+import { AgentProfileService } from "./agent-profile.service.js";
+import { AgentsService } from "./agents.service.js";
+import { AgentsFromTemplate } from "./from-template.service.js";
+import { OrgAgentTemplates } from "./org-templates.js";
+import { PendingConnectorRequests } from "./pending-connector-requests.js";
+import { PendingConnectorsService } from "./pending-connectors.service.js";
+import { AgentTemplatesService } from "./templates.js";
+/**
+ * Agents: the one {@link AgentsService} (definitions, versions, visibility; writes under the org
+ * row lock), the agent templates (the plugin ones, and the org's own: `OrgAgentTemplates`),
+ * creating agents from templates (`AgentsFromTemplate`) with its pending connector request seam
+ * (`PendingConnectorRequests`, ruling P4-7), and binding pending connectors
+ * (`PendingConnectorsService`, P4-6). Reads for a viewer are {@link AgentLookupModule}'s
+ * (re-exported), which the conversations and the skill invoker use without this module.
+ */
+let AgentsModule = class AgentsModule {
+};
+AgentsModule = __decorate([
+    Module({
+        imports: [
+            AgentLookupModule,
+            // avatar uploads
+            AttachmentsModule,
+            OrgLockModule,
+            ProvidersModule,
+            SkillsModule,
+            ToolsModule,
+            // cancels the deleted agent's eval runs
+            EvalBudgetModule,
+            // creating from a template: the extension tools and the tier purposes (rulings P4-4, P4-5)
+            ExtensionsModule,
+            ModelsModule,
+        ],
+        providers: [
+            AgentsService,
+            AgentProfileService,
+            AgentTemplatesService,
+            OrgAgentTemplates,
+            AgentsFromTemplate,
+            PendingConnectorRequests,
+            PendingConnectorsService,
+        ],
+        exports: [
+            AgentLookupModule,
+            AgentsService,
+            AgentProfileService,
+            AgentTemplatesService,
+            OrgAgentTemplates,
+            AgentsFromTemplate,
+            PendingConnectorRequests,
+            PendingConnectorsService,
+        ],
+    })
+], AgentsModule);
+export { AgentsModule };

package/dist/agents/agents.schemas.d.ts

@@ -0,0 +1,389 @@
+import { z } from "zod";
+import type { RouteSchemas } from "../platform/route-schemas.js";
+export declare const AgentMemberIds: z.ZodArray<z.ZodString>;
+/** Pending connectors come only from a template (ruling P4-6): a create request's are dropped. */
+export declare const AgentCreateDefinition: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodDefault<z.ZodNullable<z.ZodURL>>;
+    instructionFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strict>>>;
+    model: z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>;
+    fallback: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strip>>>;
+    modelParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    fallbackParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    disabledTools: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"builtin">;
+        name: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"plugin">;
+        plugin: z.ZodString;
+        tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"connector">;
+        connectorId: z.ZodString;
+        tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+    }, z.core.$strict>], "kind">>>;
+    toolPolicies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        ask: "ask";
+        deny: "deny";
+    }>>>;
+    skills: z.ZodOptional<z.ZodObject<{
+        orgSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        writePolicy: z.ZodOptional<z.ZodEnum<{
+            allow: "allow";
+            ask: "ask";
+        }>>;
+        pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    subagents: z.ZodOptional<z.ZodObject<{
+        general: z.ZodOptional<z.ZodBoolean>;
+        templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        inline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            instructions: z.ZodString;
+            tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            toolPolicies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                ask: "ask";
+                deny: "deny";
+            }>>>;
+            model: z.ZodOptional<z.ZodEnum<{
+                capable: "capable";
+                fast: "fast";
+                inherit: "inherit";
+                standard: "standard";
+            }>>;
+            effort: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                low: "low";
+                max: "max";
+                medium: "medium";
+                xhigh: "xhigh";
+            }>>;
+            maxSteps: z.ZodOptional<z.ZodNumber>;
+            skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>>;
+        agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            agentId: z.ZodString;
+            as: z.ZodString;
+            description: z.ZodString;
+        }, z.core.$strict>>>;
+        dispatchable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    tools: z.ZodOptional<z.ZodUndefined>;
+    subagentTools: z.ZodOptional<z.ZodUndefined>;
+    instructions: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AgentCreateBody: z.ZodObject<{
+    definition: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodDefault<z.ZodNullable<z.ZodURL>>;
+        instructionFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strict>>>;
+        model: z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>;
+        fallback: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>>;
+        modelParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        fallbackParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        disabledTools: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"builtin">;
+            name: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"plugin">;
+            plugin: z.ZodString;
+            tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"connector">;
+            connectorId: z.ZodString;
+            tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strict>], "kind">>>;
+        toolPolicies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            ask: "ask";
+            deny: "deny";
+        }>>>;
+        skills: z.ZodOptional<z.ZodObject<{
+            orgSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            writePolicy: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                ask: "ask";
+            }>>;
+            pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        subagents: z.ZodOptional<z.ZodObject<{
+            general: z.ZodOptional<z.ZodBoolean>;
+            templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            inline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+                instructions: z.ZodString;
+                tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                toolPolicies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                    ask: "ask";
+                    deny: "deny";
+                }>>>;
+                model: z.ZodOptional<z.ZodEnum<{
+                    capable: "capable";
+                    fast: "fast";
+                    inherit: "inherit";
+                    standard: "standard";
+                }>>;
+                effort: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    low: "low";
+                    max: "max";
+                    medium: "medium";
+                    xhigh: "xhigh";
+                }>>;
+                maxSteps: z.ZodOptional<z.ZodNumber>;
+                skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+            agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                agentId: z.ZodString;
+                as: z.ZodString;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            dispatchable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        tools: z.ZodOptional<z.ZodUndefined>;
+        subagentTools: z.ZodOptional<z.ZodUndefined>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    visibility: z.ZodEnum<{
+        members: "members";
+        org: "org";
+        private: "private";
+    }>;
+    memberIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    profile: z.ZodOptional<z.ZodObject<{
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"preset">;
+            id: z.ZodEnum<{
+                "black-bear": "black-bear";
+                capybara: "capybara";
+                elephant: "elephant";
+                fox: "fox";
+                owl: "owl";
+                panda: "panda";
+                penguin: "penguin";
+                rabbit: "rabbit";
+                turtle: "turtle";
+                whale: "whale";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"upload">;
+            uploadId: z.ZodString;
+        }, z.core.$strict>], "kind">>>;
+        description: z.ZodOptional<z.ZodString>;
+        quickActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const AgentUpdateBody: z.ZodObject<{
+    definition: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodDefault<z.ZodNullable<z.ZodURL>>;
+        instructionFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            content: z.ZodString;
+        }, z.core.$strict>>>;
+        model: z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>;
+        fallback: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            provider: z.ZodString;
+            model: z.ZodString;
+        }, z.core.$strip>>>;
+        modelParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        fallbackParams: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+        disabledTools: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"builtin">;
+            name: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"plugin">;
+            plugin: z.ZodString;
+            tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"connector">;
+            connectorId: z.ZodString;
+            tools: z.ZodUnion<readonly [z.ZodLiteral<"all">, z.ZodArray<z.ZodString>]>;
+        }, z.core.$strict>], "kind">>>;
+        toolPolicies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+            ask: "ask";
+            deny: "deny";
+        }>>>;
+        skills: z.ZodOptional<z.ZodObject<{
+            orgSkills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            writePolicy: z.ZodOptional<z.ZodEnum<{
+                allow: "allow";
+                ask: "ask";
+            }>>;
+            pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strict>>;
+        subagents: z.ZodOptional<z.ZodObject<{
+            general: z.ZodOptional<z.ZodBoolean>;
+            templates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            inline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+                instructions: z.ZodString;
+                tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                toolPolicies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                    ask: "ask";
+                    deny: "deny";
+                }>>>;
+                model: z.ZodOptional<z.ZodEnum<{
+                    capable: "capable";
+                    fast: "fast";
+                    inherit: "inherit";
+                    standard: "standard";
+                }>>;
+                effort: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    low: "low";
+                    max: "max";
+                    medium: "medium";
+                    xhigh: "xhigh";
+                }>>;
+                maxSteps: z.ZodOptional<z.ZodNumber>;
+                skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+            agents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                agentId: z.ZodString;
+                as: z.ZodString;
+                description: z.ZodString;
+            }, z.core.$strict>>>;
+            dispatchable: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        pendingConnectors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+            source: z.ZodUnion<readonly [z.ZodObject<{
+                template: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                needs: z.ZodObject<{
+                    protocol: z.ZodEnum<{
+                        mcp: "mcp";
+                        openapi: "openapi";
+                    }>;
+                    endpoint: z.ZodString;
+                    tools: z.ZodArray<z.ZodString>;
+                    label: z.ZodString;
+                }, z.core.$strict>;
+            }, z.core.$strict>]>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            policies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEnum<{
+                ask: "ask";
+                deny: "deny";
+            }>>>;
+        }, z.core.$strict>>>;
+        tools: z.ZodOptional<z.ZodUndefined>;
+        subagentTools: z.ZodOptional<z.ZodUndefined>;
+        instructions: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        members: "members";
+        org: "org";
+        private: "private";
+    }>>;
+    memberIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    expectedVersion: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+/**
+ * `PATCH …/profile`: the display data (avatar, quick actions). The description is part of the
+ * agent's definition (run context spec §3.5), saved with `PATCH :agentId`.
+ */
+export declare const AgentProfileBody: z.ZodObject<{
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"preset">;
+        id: z.ZodEnum<{
+            "black-bear": "black-bear";
+            capybara: "capybara";
+            elephant: "elephant";
+            fox: "fox";
+            owl: "owl";
+            panda: "panda";
+            penguin: "penguin";
+            rabbit: "rabbit";
+            turtle: "turtle";
+            whale: "whale";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"upload">;
+        uploadId: z.ZodString;
+    }, z.core.$strict>], "kind">>>;
+    quickActions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        body: z.ZodString;
+    }, z.core.$strict>>>;
+    expectedUpdatedAt: z.ZodString;
+}, z.core.$strict>;
+export declare const AgentFromTemplatePreviewBody: z.ZodObject<{
+    templateId: z.ZodString;
+}, z.core.$strict>;
+export declare const AgentFromTemplateBody: z.ZodObject<{
+    templateId: z.ZodString;
+    name: z.ZodString;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        members: "members";
+        org: "org";
+        private: "private";
+    }>>;
+    members: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    model: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        model: z.ZodString;
+    }, z.core.$strict>>;
+    avatar: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"preset">;
+        id: z.ZodEnum<{
+            "black-bear": "black-bear";
+            capybara: "capybara";
+            elephant: "elephant";
+            fox: "fox";
+            owl: "owl";
+            panda: "panda";
+            penguin: "penguin";
+            rabbit: "rabbit";
+            turtle: "turtle";
+            whale: "whale";
+        }>;
+    }, z.core.$strict>>;
+    previewHash: z.ZodString;
+}, z.core.$strict>;
+/** `:agentId` as the routes take it (`@Param`). */
+export declare const AgentPathParams: z.ZodObject<{
+    agentId: z.ZodString;
+}, z.core.$strip>;
+/** `:agentId` and `:key` of a pending connector's bind route. */
+export declare const PendingConnectorParams: z.ZodObject<{
+    agentId: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strip>;
+export declare const PendingConnectorBindBody: z.ZodObject<{
+    connectorId: z.ZodString;
+}, z.core.$strict>;
+export declare const AGENT_ROUTES: readonly RouteSchemas[];

package/dist/agents/agents.schemas.js

@@ -0,0 +1,126 @@
+import { z } from "zod";
+import { AGENT_VISIBILITIES } from "./agents.service.js";
+import { AgentDefinitionSchema, ModelRef } from "./definition.js";
+import { PresetAvatarSchema, ProfileInputSchema } from "./profile.js";
+export const AgentMemberIds = z.array(z.string().min(1).max(100)).max(1000);
+/**
+ * `instructions` has no default in a request: with `instructionFiles` the kernel derives it, and a
+ * new agent given neither gets the `AGENTS.md` starter (`deriveInstructions`).
+ */
+const RequestInstructions = z.string().max(100_000).optional();
+/**
+ * Fields a request may not carry (tools default-on spec §2): the old enabled list, and a
+ * sub-agent's key filter (written only at dispatch).
+ */
+const RequestOnly = {
+    tools: z
+        .undefined({
+        error: "tools was replaced by disabledTools: an agent has every tool unless it turns it off",
+    })
+        .optional(),
+    subagentTools: z
+        .undefined({ error: "subagentTools is set only on a sub-agent's definition at dispatch" })
+        .optional(),
+};
+/** Pending connectors come only from a template (ruling P4-6): a create request's are dropped. */
+export const AgentCreateDefinition = AgentDefinitionSchema.omit({ pendingConnectors: true }).extend({ instructions: RequestInstructions, ...RequestOnly });
+const UpdateDefinition = AgentDefinitionSchema.extend({
+    instructions: RequestInstructions,
+    ...RequestOnly,
+});
+export const AgentCreateBody = z
+    .object({
+    definition: AgentCreateDefinition,
+    visibility: z.enum(AGENT_VISIBILITIES),
+    memberIds: AgentMemberIds.optional(),
+    /** Without an avatar the agent gets a random preset. */
+    profile: ProfileInputSchema.optional(),
+})
+    .strict();
+export const AgentUpdateBody = z
+    .object({
+    definition: UpdateDefinition.optional(),
+    visibility: z.enum(AGENT_VISIBILITIES).optional(),
+    memberIds: AgentMemberIds.optional(),
+    /**
+     * Optimistic concurrency: the `currentVersion` the editor read. Given and different from the
+     * current version (someone saved since) -> 409 `agent.version_conflict`, nothing overwritten.
+     * Absent: not checked (older clients).
+     */
+    expectedVersion: z.number().int().positive().optional(),
+})
+    .strict();
+/**
+ * `PATCH …/profile`: the display data (avatar, quick actions). The description is part of the
+ * agent's definition (run context spec §3.5), saved with `PATCH :agentId`.
+ */
+export const AgentProfileBody = ProfileInputSchema.omit({ description: true })
+    .extend({
+    /** The `profile.updatedAt` the client read; a different one → 409 `agent.profile_conflict`. */
+    expectedUpdatedAt: z.string().min(1).max(40),
+})
+    .strict();
+const TemplateId = z.string().min(1).max(100);
+export const AgentFromTemplatePreviewBody = z.object({ templateId: TemplateId }).strict();
+export const AgentFromTemplateBody = z
+    .object({
+    templateId: TemplateId,
+    name: z.string().min(1).max(80),
+    /** Default `private`; anything else needs `agents.manage` (ruling P4-3). */
+    visibility: z.enum(AGENT_VISIBILITIES).optional(),
+    /** The accounts of a `members` agent. */
+    members: AgentMemberIds.optional(),
+    /** The person's choice; absent = the template's model resolution (P4-4). */
+    model: ModelRef.strict().optional(),
+    /** A preset avatar; absent = a random one. */
+    avatar: PresetAvatarSchema.optional(),
+    /** The preview's `previewHash`; another one → 409 `agent.template_preview_stale`. */
+    previewHash: z.string().regex(/^[0-9a-f]{64}\.[0-9a-f]{16}$/),
+})
+    .strict();
+/** `:agentId` as the routes take it (`@Param`). */
+export const AgentPathParams = z.object({ agentId: z.string().min(1) });
+/** `:agentId` and `:key` of a pending connector's bind route. */
+export const PendingConnectorParams = z.object({
+    agentId: z.string().min(1),
+    key: z.string().min(1),
+});
+export const PendingConnectorBindBody = z
+    .object({ connectorId: z.string().min(1).max(100) })
+    .strict();
+export const AGENT_ROUTES = [
+    { route: "GET /api/v1/orgs/:orgId/agents" },
+    { route: "GET /api/v1/orgs/:orgId/agents/:agentId", params: AgentPathParams },
+    { route: "POST /api/v1/orgs/:orgId/agents", body: AgentCreateBody },
+    {
+        route: "PATCH /api/v1/orgs/:orgId/agents/:agentId",
+        params: AgentPathParams,
+        body: AgentUpdateBody,
+    },
+    {
+        route: "PATCH /api/v1/orgs/:orgId/agents/:agentId/profile",
+        params: AgentPathParams,
+        body: AgentProfileBody,
+    },
+    {
+        route: "POST /api/v1/orgs/:orgId/agents/from-template/preview",
+        body: AgentFromTemplatePreviewBody,
+    },
+    { route: "POST /api/v1/orgs/:orgId/agents/from-template", body: AgentFromTemplateBody },
+    { route: "DELETE /api/v1/orgs/:orgId/agents/:agentId", params: AgentPathParams },
+    { route: "GET /api/v1/orgs/:orgId/agents/:agentId/versions", params: AgentPathParams },
+    {
+        route: "POST /api/v1/orgs/:orgId/agents/:agentId/pending-connectors/:key/bind",
+        params: PendingConnectorParams,
+        body: PendingConnectorBindBody,
+    },
+    {
+        route: "POST /api/v1/orgs/:orgId/agents/:agentId/pending-connectors/request",
+        params: AgentPathParams,
+    },
+    {
+        route: "GET /api/v1/orgs/:orgId/agents/:agentId/pending-connectors/request",
+        params: AgentPathParams,
+    },
+    { route: "GET /api/v1/orgs/:orgId/readiness" },
+];