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

package/dist/platform/ops/platform.ops.js

@@ -7,10 +7,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-import { extensionToolKey } from "@capybara-hq/plugin-sdk";
 import { Inject, Injectable } from "@nestjs/common";
 import { z } from "zod";
 import { AgentsService } from "../../agents/agents.service.js";
+import { AccountsService } from "../../identity/accounts.js";
+import { PreferencesSchema } from "../../identity/me.schemas.js";
 import { can } from "../../orgs/roles.js";
 import { effectiveSandboxEgress, OrgSettingsService } from "../../orgs/settings.service.js";
 import { SANDBOX_TOOL_NAMES } from "../../tools/builtin-names.js";
@@ -18,7 +19,6 @@ import { ToolRegistry } from "../../tools/registry.js";
 import { PlatformActor } from "../actor.js";
 import { defineOperation } from "../operation.js";
 import { PlatformOperations } from "../registry.js";
-import { asToolError } from "./errors.js";
 /** What a role may build, as the model says it to the person: the action and its plain words. */
 const BUILDS = [
     { action: "agents.create", what: "create private agents and edit the agents you own" },
@@ -36,43 +36,43 @@ const FAMILIES = [
     "Plugin and connector tools, named plugin__<plugin>__<tool> and mcp__<connector>__<tool>.",
 ];
 const EMPTY = z.object({}).strict();
-/** The `platform` domain: orientation, and what this agent is (spec §7). Synthetic, no route. */
+/**
+ * The `platform` domain: orientation and what this agent is (spec §7, synthetic), and the
+ * person's own preferences (`/me/preferences`).
+ */
 let PlatformOperationsProvider = class PlatformOperationsProvider {
     registry;
     actor;
     agents;
     settings;
     tools;
-    constructor(registry, actor, agents, settings, tools) {
+    accounts;
+    constructor(registry, actor, agents, settings, tools, accounts) {
         this.registry = registry;
         this.actor = actor;
         this.agents = agents;
         this.settings = settings;
         this.tools = tools;
+        this.accounts = accounts;
     }
     /**
-     * The agent's tools by the keys the model sees: builtins by name, plugin tools as
-     * `plugin__<plugin>__<tool>`, and each connector reference expanded to its live tools'
-     * `mcp__<slug>__<tool>` keys as the registry resolves them for a run; connector tools that
-     * cannot load now are listed with the registry's reason.
+     * The agent's tools by the keys the model sees, as the registry resolves them for a run (tools
+     * default-on spec §8): every tool the org offers that the definition does not turn off, builtins
+     * by name, extension tools as `plugin__<plugin>__<tool>`, connector tools as
+     * `mcp__<slug>__<tool>`; the ones that cannot load now are listed with the registry's reason.
      */
     async toolKeys(orgId, d) {
-        const connectors = d.tools.filter((r) => r.kind === "connector");
-        const resolved = connectors.length === 0
-            ? { tools: [], unavailable: [] }
-            : await this.tools.forAgent(orgId, { tools: connectors });
-        const live = new Map();
-        for (const t of resolved.tools) {
-            if (t.source.kind !== "connector")
-                continue;
-            live.set(t.source.connectorId, [...(live.get(t.source.connectorId) ?? []), t.key]);
-        }
-        const keys = d.tools.flatMap((r) => r.kind === "connector"
-            ? (live.get(r.connectorId) ?? [])
-            : [r.kind === "builtin" ? r.name : extensionToolKey(r.plugin, r.name)]);
+        const resolved = await this.tools.forAgent(orgId, {
+            disabledTools: d.disabledTools ?? [],
+            subagentTools: d.subagentTools,
+            subagents: d.subagents,
+        });
         return {
-            keys: [...new Set(keys)],
-            unavailable: resolved.unavailable.map((u) => ({ tool: u.ref, reason: u.reason })),
+            keys: [...new Set(resolved.tools.map((t) => t.key))],
+            unavailable: [...resolved.unavailable, ...(resolved.hidden ?? [])].map((u) => ({
+                tool: u.ref,
+                reason: u.reason,
+            })),
         };
     }
     onModuleInit() {
@@ -111,13 +111,13 @@ let PlatformOperationsProvider = class PlatformOperationsProvider {
             }),
             defineOperation({
                 id: "platform.me",
-                description: "Show this agent as configured: its model, tools by the keys you call them by (connector tools as mcp__<connector>__<tool>, with those that cannot load now and why), skills (org and pinned), sub-agents, whether it runs in a sandbox, and the sandbox network mode. Secrets are never shown.",
+                description: "Show this agent as configured: its model, the tools it has now by the keys you call them by (every tool the org offers unless the agent turns it off; connector tools as mcp__<connector>__<tool>, with those that cannot load now and why), the tools it turns off (disabledTools), skills (org and pinned), sub-agents, whether it runs in a sandbox, the sandbox network mode, and its profile (avatar, description, quick actions). Secrets are never shown.",
                 input: EMPTY,
                 example: {},
                 authz: { orgAction: "agents.use" },
                 mirrors: [],
                 confirm: "read",
-                run: async (_input, ctx) => asToolError(async () => {
+                run: async (_input, ctx) => {
                     const agent = await this.agents.get(ctx.orgId, ctx.agentId, ctx.actorAccountId);
                     const d = agent.definition;
                     const { keys: toolKeys, unavailable } = await this.toolKeys(ctx.orgId, d);
@@ -134,6 +134,7 @@ let PlatformOperationsProvider = class PlatformOperationsProvider {
                         fallback: d.fallback,
                         tools: toolKeys,
                         ...(unavailable.length > 0 && { unavailableTools: unavailable }),
+                        disabledTools: d.disabledTools ?? [],
                         toolPolicies: d.toolPolicies,
                         skills: {
                             orgSkills: d.skills?.orgSkills ?? [],
@@ -141,8 +142,52 @@ let PlatformOperationsProvider = class PlatformOperationsProvider {
                         },
                         subagents: d.subagents ?? null,
                         sandbox: sandbox ? { enabled: true, egress: egress.egress } : { enabled: false },
+                        profile: {
+                            avatar: agent.profile.avatar,
+                            description: agent.profile.description,
+                            quickActions: agent.profile.quickActions,
+                        },
+                    };
+                },
+            }),
+            defineOperation({
+                id: "platform.preferences",
+                description: "Read your own preferences: your time zone (an IANA name such as Asia/Shanghai), or null when it follows the time zone of the browser you send messages from. The run context already tells you the zone in effect for this message.",
+                input: EMPTY,
+                example: {},
+                // any signed-in person may call the route; every run's actor is a member of this org
+                authz: { orgAction: "agents.use" },
+                mirrors: ["GET /api/v1/me/preferences"],
+                confirm: "read",
+                run: async (_input, ctx) => this.accounts.preferences(ctx.actorAccountId),
+            }),
+            defineOperation({
+                id: "platform.set-preferences",
+                description: "Set your own time zone (an IANA name such as Europe/Berlin), or null to follow the time zone of the browser you send messages from. It applies to the messages you send afterwards, on the web and in IM; the current run keeps its zone.",
+                input: PreferencesSchema,
+                example: { timeZone: "Asia/Shanghai" },
+                authz: { orgAction: "agents.use" },
+                mirrors: ["PUT /api/v1/me/preferences"],
+                confirm: "personal",
+                errors: [
+                    {
+                        code: "validation_failed",
+                        next: "Use an IANA time zone name such as Asia/Shanghai or America/New_York, or null.",
+                    },
+                ],
+                summary: async (input, ctx) => {
+                    const now = (await this.accounts.preferences(ctx.actorAccountId)).timeZone;
+                    const from = { zh: now ?? "跟随浏览器", en: now ?? "follow the browser" };
+                    const to = {
+                        zh: input.timeZone ?? "跟随浏览器",
+                        en: input.timeZone ?? "follow the browser",
+                    };
+                    return {
+                        zh: `把你的时区从「${from.zh}」改为「${to.zh}」`,
+                        en: `Change your time zone from "${from.en}" to "${to.en}"`,
                     };
-                }),
+                },
+                run: async (input, ctx) => this.accounts.setPreferences(ctx.actorAccountId, { timeZone: input.timeZone }),
             }),
         ]);
     }
@@ -153,6 +198,7 @@ PlatformOperationsProvider = __decorate([
     __param(1, Inject(PlatformActor)),
     __param(2, Inject(AgentsService)),
     __param(3, Inject(OrgSettingsService)),
-    __param(4, Inject(ToolRegistry))
+    __param(4, Inject(ToolRegistry)),
+    __param(5, Inject(AccountsService))
 ], PlatformOperationsProvider);
 export { PlatformOperationsProvider };

package/dist/platform/ops/plugins.ops.d.ts

@@ -4,14 +4,16 @@ import { OrgCatalogService } from "../../catalog/org-catalog.service.js";
 import { PluginInstaller } from "../../catalog/plugin-install.js";
 import { PlatformPluginUpdater } from "../../catalog/plugin-upgrade.js";
 import { OrgExtensionConfigs } from "../../extensions/org-config.js";
+import { ExtensionAvailability } from "../../extensions/unavailable.js";
 import { KernelDb } from "../../infra/database/kernel-db.js";
 import { PlatformOperations } from "../registry.js";
-export declare const OTHER_ORG = "This plugin belongs to another org; use the admin console.";
+export { OTHER_ORG } from "./other-orgs.js";
 export declare const NEEDS_INPUT = "This plugin needs configuration a person must enter; ask them to enable it on the \u63D2\u4EF6 page.";
 /**
  * Plugin operations of the `Platform` tool (spec §7): the org's view (list, get, switch on or off)
  * and the super admin's platform view (list, get, update with its preview). Every platform result
- * goes through {@link redactOrgs}: other orgs only as counts (spec §6.1).
+ * shows the admin console's data in full for platform items and the org's own (spec §14.5 item 1);
+ * plugins other orgs own are only counted, and reading or updating one is refused.
  */
 export declare class PluginsOperations implements OnModuleInit {
     private readonly registry;
@@ -21,13 +23,13 @@ export declare class PluginsOperations implements OnModuleInit {
     private readonly installer;
     private readonly extensions;
     private readonly kdb;
-    constructor(registry: PlatformOperations, orgCatalog: OrgCatalogService, catalog: CatalogService, updater: PlatformPluginUpdater, installer: PluginInstaller, extensions: OrgExtensionConfigs, kdb: KernelDb);
+    private readonly availability;
+    constructor(registry: PlatformOperations, orgCatalog: OrgCatalogService, catalog: CatalogService, updater: PlatformPluginUpdater, installer: PluginInstaller, extensions: OrgExtensionConfigs, kdb: KernelDb, availability: ExtensionAvailability);
     /**
-     * Refuses a super-admin operation on an item another org owns: its results would describe that
-     * org's private plugin in this org's log (spec §6.1). Platform items and the org's own pass.
+     * Installed (or builtin) plugins whose extension stopped loading: the reason, keyed by plugin
+     * name. Their state stays (`on` / `needs_config`) so an org admin can still switch them off;
+     * the reason and next step tell why the plugin does nothing now.
      */
-    private assertNotOtherOrgs;
-    /** How many live catalog items other orgs own (left out of the platform list). */
-    private otherOrgItems;
+    private stopped;
     onModuleInit(): void;
 }