@capybara-hq/kernel 0.1.0-rc.5 → 0.1.0-rc.7

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" },
+];

package/dist/agents/agents.service.d.ts

@@ -87,7 +87,7 @@ export declare class AgentsService {
     private readonly evalBudget;
     /** Settles the agent's connector setup request when its pending connectors change (P4-7). */
     private readonly setupRequests;
-    constructor(db: KernelDb, lookup: AgentLookup, tools: Pick<ToolRegistry, "checkRefs">, 
+    constructor(db: KernelDb, lookup: AgentLookup, tools: Pick<ToolRegistry, "checkDisabled">, 
     /** 删除 agent 时取消它待处理的技能改动（T15）。 */
     skillChanges: Pick<SkillChangesService, "cancelPendingForAgent" | "finishCancel">, 
     /** The org row lock (orgs/org-lock.ts): joins the caller's transaction. */
@@ -99,13 +99,23 @@ export declare class AgentsService {
     /** Settles the agent's connector setup request when its pending connectors change (P4-7). */
     setupRequests: Pick<PendingConnectorRequests, "settleIn" | "retargetIn">);
     /**
-     * 校验工具引用与工具策略：引用的内置 / 插件 / 连接器工具必须存在（见 `ToolRegistry.checkRefs`）；
-     * `toolPolicies` 的键必须是这些引用产生的工具 key（取值只能收紧，已由 schema 保证）。
-     * 不合法 → `validation_failed`，path 为 `tools.<i>` / `toolPolicies.<key>`。
+     * Checks the turned-off tools and the policies (tools default-on spec §2): `disabledTools` must
+     * name existing builtins, extensions and connectors (`ToolRegistry.checkDisabled`); `toolPolicies`
+     * keys must be tools the agent could have, on or off (values only tighten, by the schema); a
+     * sub-agent's key filter is never saved. Invalid → `validation_failed` at `disabledTools.<i>` /
+     * `toolPolicies.<key>` / `subagentTools`. The list is stored in canonical form.
      */
     private checkTools;
     /**
-     * 校验主模型与兜底都可解析，并用各自模型的参数声明严格校验 `modelParams` / `fallbackParams`
+     * The current version's `disabledTools` (empty for an agent that is not there: the update's own
+     * checks report that): entries kept from it are not re-checked, so a connector deleted or an
+     * extension uninstalled later never blocks other edits.
+     */
+    private keptDisabled;
+    /**
+     * 校验主模型与兜底都可解析：enabled `chat` models in the org (`resolve`'s default kind; a model the
+     * platform or the org disabled, or an embedding model → 400 `agent.model_unavailable`, spec B
+     * §5.3），并用各自模型的参数声明严格校验 `modelParams` / `fallbackParams`
      * （没有兜底时 `fallbackParams` 必须为空）；不合法 → `validation_failed`，details 逐键点名。返回提示。
      */
     private checkModels;
@@ -171,7 +181,7 @@ export declare class AgentsService {
     }>;
     private updateIn;
     /** 软删除：权限同 update。待处理的技能改动与该 agent 评测集在执行的评测运行一并取消，提交后删除草稿（T15）。 */
-    softDelete(orgId: string, agentId: string, actorAccountId: string, actorTokenId?: string): Promise<void>;
+    softDelete(orgId: string, agentId: string, actorAccountId: string, actorTokenId?: string, auditDetail?: Record<string, unknown>): Promise<void>;
     private softDeleteIn;
     /**
      * 重新指派负责人（`agents.manage`，admin）：在组织行锁内授权；agent 不存在 / 已删除 → `agent.not_found`；