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

package/dist/agents/agents.controller.d.ts

@@ -4,150 +4,13 @@ import { AttachmentsService, type CreatedAttachment } from "../conversations/att
 import { type Principal } from "../identity/principal.js";
 import { type OrgContext } from "../orgs/org.guard.js";
 import { AgentProfileService } from "./agent-profile.service.js";
+import { AgentCreateBody, AgentFromTemplateBody, AgentFromTemplatePreviewBody, AgentProfileBody, AgentUpdateBody } from "./agents.schemas.js";
 import { AgentsService, type AgentVersionSummary, type AgentView, type AgentWarning } from "./agents.service.js";
 import { AgentsFromTemplate, type TemplatePreview } from "./from-template.service.js";
-import { type AgentProfile } from "./profile.js";
+import type { AgentProfile } from "./profile.js";
 declare const OwnerBody: z.ZodObject<{
     accountId: z.ZodString;
 }, z.core.$strict>;
-declare const CreateBody: z.ZodObject<{
-    definition: z.ZodObject<{
-        name: 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]>>>;
-        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>>;
-        instructions: z.ZodOptional<z.ZodString>;
-        tools: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"builtin">;
-            name: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"plugin">;
-            plugin: z.ZodString;
-            name: 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">, unknown>>>;
-    }, 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>;
-declare const ProfileBody: 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>>>;
-    expectedUpdatedAt: z.ZodString;
-}, z.core.$strict>;
 declare const AvatarUploadBody: z.ZodObject<{
     name: z.ZodString;
     contentType: z.ZodEnum<{
@@ -157,149 +20,6 @@ declare const AvatarUploadBody: z.ZodObject<{
     }>;
     size: z.ZodNumber;
 }, z.core.$strict>;
-declare const UpdateBody: z.ZodObject<{
-    definition: z.ZodOptional<z.ZodObject<{
-        name: 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]>>>;
-        tools: z.ZodDefault<z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"builtin">;
-            name: z.ZodString;
-        }, z.core.$strict>, z.ZodObject<{
-            kind: z.ZodLiteral<"plugin">;
-            plugin: z.ZodString;
-            name: 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">, unknown>>>;
-        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>>>;
-        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>;
-declare const FromTemplatePreviewBody: z.ZodObject<{
-    templateId: z.ZodString;
-}, z.core.$strict>;
-declare const FromTemplateBody: 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>;
 /**
  * Agent 定义（`/api/v1/orgs/:orgId/agents`）。读用 `agents.use`（访客与服务令牌可用），
  * 写用 `agents.create`（member 以上、HUMAN_ONLY），修改 / 删除的负责人或管理员判定在服务的组织行锁内完成。
@@ -318,17 +38,17 @@ export declare class AgentsController {
      * template fields with no place in the agent, and the `previewHash` the create must send. A
      * template not usable in the org → 404 `component.not_found`.
      */
-    previewFromTemplate(org: OrgContext, body: z.infer<typeof FromTemplatePreviewBody>): Promise<TemplatePreview>;
+    previewFromTemplate(org: OrgContext, body: z.infer<typeof AgentFromTemplatePreviewBody>): Promise<TemplatePreview>;
     /**
      * Creates an agent from a template (ruling P4-3): private by default; another visibility without
      * `agents.manage` → 403 `agent.visibility_forbidden`; a plan that no longer matches the preview →
      * 409 `agent.template_preview_stale`. The agent records its provenance (P4-8) and carries the
      * template's missing connectors as `pendingConnectors` (P4-6).
      */
-    createFromTemplate(principal: Principal, org: OrgContext, body: z.infer<typeof FromTemplateBody>): Promise<{
+    createFromTemplate(principal: Principal, org: OrgContext, body: z.infer<typeof AgentFromTemplateBody>): Promise<{
         agent: AgentView;
     }>;
-    create(principal: Principal, org: OrgContext, body: z.infer<typeof CreateBody>): Promise<{
+    create(principal: Principal, org: OrgContext, body: z.infer<typeof AgentCreateBody>): Promise<{
         agent: AgentView;
         warnings: AgentWarning[];
     }>;
@@ -338,12 +58,12 @@ export declare class AgentsController {
     get(principal: Principal, org: OrgContext, agentId: string): Promise<{
         agent: AgentView;
     }>;
-    update(principal: Principal, org: OrgContext, agentId: string, body: z.infer<typeof UpdateBody>): Promise<{
+    update(principal: Principal, org: OrgContext, agentId: string, body: z.infer<typeof AgentUpdateBody>): Promise<{
         agent: AgentView;
         warnings: AgentWarning[];
     }>;
     /** Display data only: no agent version. Same permission as `PATCH :agentId`. */
-    updateProfile(principal: Principal, org: OrgContext, agentId: string, body: z.infer<typeof ProfileBody>): Promise<{
+    updateProfile(principal: Principal, org: OrgContext, agentId: string, body: z.infer<typeof AgentProfileBody>): Promise<{
         profile: AgentProfile;
     }>;
     /**

package/dist/agents/agents.controller.js

@@ -17,37 +17,10 @@ import { createZodDto } from "../infra/validation/create-zod-dto.js";
 import { ZBody } from "../infra/validation/zod-params.js";
 import { CurrentOrg, OrgAction } from "../orgs/org.guard.js";
 import { AgentProfileService } from "./agent-profile.service.js";
-import { AGENT_VISIBILITIES, AgentsService, } from "./agents.service.js";
-import { AgentDefinitionSchema, AgentToolRef, DEFAULT_AGENT_TOOLS, ModelRef, } from "./definition.js";
+import { AgentCreateBody, AgentFromTemplateBody, AgentFromTemplatePreviewBody, AgentProfileBody, AgentUpdateBody, } from "./agents.schemas.js";
+import { AgentsService, } from "./agents.service.js";
 import { AgentsFromTemplate } from "./from-template.service.js";
-import { PRESET_IDS, ProfileInputSchema } from "./profile.js";
-const MemberIds = z.array(z.string().min(1).max(100)).max(1000);
 const OwnerBody = z.object({ accountId: z.string().min(1).max(100) }).strict();
-/** 创建时未给 `tools` → 默认工具（Ruling P7）；修改请求不注入默认值，版本里总是存显式的 tools。 */
-/**
- * `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();
-/** Pending connectors come only from a template (ruling P4-6): a create request's are dropped. */
-const CreateDefinition = AgentDefinitionSchema.omit({ pendingConnectors: true }).extend({
-    instructions: RequestInstructions,
-    tools: z.array(AgentToolRef).default(() => structuredClone(DEFAULT_AGENT_TOOLS)),
-});
-const UpdateDefinition = AgentDefinitionSchema.extend({ instructions: RequestInstructions });
-const CreateBody = z
-    .object({
-    definition: CreateDefinition,
-    visibility: z.enum(AGENT_VISIBILITIES),
-    memberIds: MemberIds.optional(),
-    /** Without an avatar the agent gets a random preset. */
-    profile: ProfileInputSchema.optional(),
-})
-    .strict();
-const ProfileBody = ProfileInputSchema.extend({
-    /** The `profile.updatedAt` the client read; a different one → 409 `agent.profile_conflict`. */
-    expectedUpdatedAt: z.string().min(1).max(40),
-}).strict();
 const AvatarUploadBody = z
     .object({
     name: z
@@ -59,54 +32,21 @@ const AvatarUploadBody = z
     size: z.number().int().min(1).max(AGENT_AVATAR_MAX_BYTES),
 })
     .strict();
-const UpdateBody = z
-    .object({
-    definition: UpdateDefinition.optional(),
-    visibility: z.enum(AGENT_VISIBILITIES).optional(),
-    memberIds: MemberIds.optional(),
-    /**
-     * 乐观并发：编辑页打开时读到的 `currentVersion`。给出且与当前版本不同（别人已保存过）→ 409
-     * `agent.version_conflict`，不覆盖别人的改动。不给时不检查（旧客户端）。
-     */
-    expectedVersion: z.number().int().positive().optional(),
-})
-    .strict();
-const TemplateId = z.string().min(1).max(100);
-const FromTemplatePreviewBody = z.object({ templateId: TemplateId }).strict();
-const FromTemplateBody = 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: MemberIds.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: z
-        .object({ kind: z.literal("preset"), id: z.enum(PRESET_IDS) })
-        .strict()
-        .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();
 /** 服务令牌没有账号：以 null 作为 viewer，只看到 visibility='org' 的 agent。 */
 const viewerOf = (p) => (p.kind === "user" ? p.account.id : null);
-class AgentCreateBodyDto extends createZodDto(CreateBody, "AgentCreateBody") {
+class AgentCreateBodyDto extends createZodDto(AgentCreateBody, "AgentCreateBody") {
 }
-class AgentUpdateBodyDto extends createZodDto(UpdateBody, "AgentUpdateBody") {
+class AgentUpdateBodyDto extends createZodDto(AgentUpdateBody, "AgentUpdateBody") {
 }
-class AgentProfileBodyDto extends createZodDto(ProfileBody, "AgentProfileBody") {
+class AgentProfileBodyDto extends createZodDto(AgentProfileBody, "AgentProfileBody") {
 }
 class AgentAvatarUploadBodyDto extends createZodDto(AvatarUploadBody, "AgentAvatarUploadBody") {
 }
 class AgentOwnerBodyDto extends createZodDto(OwnerBody, "AgentOwnerBody") {
 }
-class AgentFromTemplatePreviewBodyDto extends createZodDto(FromTemplatePreviewBody, "AgentFromTemplatePreviewBody") {
+class AgentFromTemplatePreviewBodyDto extends createZodDto(AgentFromTemplatePreviewBody, "AgentFromTemplatePreviewBody") {
 }
-class AgentFromTemplateBodyDto extends createZodDto(FromTemplateBody, "AgentFromTemplateBody") {
+class AgentFromTemplateBodyDto extends createZodDto(AgentFromTemplateBody, "AgentFromTemplateBody") {
 }
 /**
  * Agent 定义（`/api/v1/orgs/:orgId/agents`）。读用 `agents.use`（访客与服务令牌可用），