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

package/dist/identity/me.controller.d.ts

@@ -6,6 +6,7 @@ import { OrgsService } from "../orgs/orgs.service.js";
 import type { OrgRole } from "../orgs/roles.js";
 import { type Account, AccountsService } from "./accounts.js";
 import { type ApiTokenRecord, ApiTokenService } from "./api-tokens.js";
+import { type PreferencesSchema } from "./me.schemas.js";
 import { type Principal } from "./principal.js";
 import { SessionService } from "./sessions.js";
 import { SettingsService } from "./settings.js";
@@ -17,9 +18,6 @@ declare const TokenSchema: z.ZodObject<{
     name: z.ZodString;
     expiresAt: z.ZodOptional<z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>>;
 }, z.core.$strip>;
-declare const PreferencesSchema: z.ZodObject<{
-    timeZone: z.ZodNullable<z.ZodString>;
-}, z.core.$strict>;
 declare const CurrentOrgSchema: z.ZodObject<{
     orgId: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;

package/dist/identity/me.controller.js

@@ -15,10 +15,10 @@ import { KERNEL_LOGGER } from "../infra/tokens.js";
 import { createZodDto } from "../infra/validation/create-zod-dto.js";
 import { ZBody } from "../infra/validation/zod-params.js";
 import { OrgsService } from "../orgs/orgs.service.js";
-import { IanaTimeZone } from "../time-zone.js";
 import { AccountsService } from "./accounts.js";
 import { ApiTokenService, FutureIsoDate } from "./api-tokens.js";
 import { MAX_PASSWORD_LENGTH } from "./login.js";
+import { PreferencesBody } from "./me.schemas.js";
 import { AllowPendingPasswordChange, CurrentPrincipal, requireUser, SessionOnly, } from "./principal.js";
 import { SessionService } from "./sessions.js";
 import { SettingsService } from "./settings.js";
@@ -36,14 +36,6 @@ const TokenSchema = z.object({
 });
 class PersonalTokenBody extends createZodDto(TokenSchema, "PersonalTokenBody") {
 }
-const PreferencesSchema = z
-    .object({
-    /** The person's time zone (IANA); null = follow the browser (run context spec §3.4). */
-    timeZone: IanaTimeZone.nullable(),
-})
-    .strict();
-class PreferencesBody extends createZodDto(PreferencesSchema, "PreferencesBody") {
-}
 const CurrentOrgSchema = z.object({ orgId: z.string().min(1).nullable() });
 class CurrentOrgBody extends createZodDto(CurrentOrgSchema, "CurrentOrgBody") {
 }

package/dist/identity/me.schemas.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { RouteSchemas } from "../platform/route-schemas.js";
+/** `PUT /me/preferences`: the person's preferences (run context spec §3.4). */
+export declare const PreferencesSchema: z.ZodObject<{
+    timeZone: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+declare const PreferencesBody_base: import("../infra/validation/create-zod-dto.js").ZodDtoClass<z.ZodObject<{
+    timeZone: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>>;
+export declare class PreferencesBody extends PreferencesBody_base {
+}
+/** The `/me` routes the Platform operations mirror (`check:platform-ops` keys). */
+export declare const ME_ROUTES: readonly RouteSchemas[];
+export {};

package/dist/identity/me.schemas.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { createZodDto } from "../infra/validation/create-zod-dto.js";
+import { IanaTimeZone } from "../time-zone.js";
+/** `PUT /me/preferences`: the person's preferences (run context spec §3.4). */
+export const PreferencesSchema = z
+    .object({
+    /** The person's time zone (IANA); null = follow the browser (run context spec §3.4). */
+    timeZone: IanaTimeZone.nullable(),
+})
+    .strict();
+export class PreferencesBody extends createZodDto(PreferencesSchema, "PreferencesBody") {
+}
+/** The `/me` routes the Platform operations mirror (`check:platform-ops` keys). */
+export const ME_ROUTES = [
+    { route: "GET /api/v1/me/preferences" },
+    { route: "PUT /api/v1/me/preferences", body: PreferencesSchema },
+];

package/dist/platform/exclusions.js

@@ -330,16 +330,6 @@ export const PLATFORM_EXCLUSIONS = [
         category: "human-only",
         reason: "Switches the web session's current org",
     },
-    {
-        route: "GET /api/v1/me/preferences",
-        category: "internal",
-        reason: "The person's time zone setting the web's preferences page reads; the run context already gives the agent the zone in effect",
-    },
-    {
-        route: "PUT /api/v1/me/preferences",
-        category: "human-only",
-        reason: "A person's own time zone setting, chosen on their preferences page",
-    },
     {
         route: "PUT /api/v1/me/password",
         category: "human-only",

package/dist/platform/operation.js

@@ -12,7 +12,7 @@ export const operationDomain = (id) => id.slice(0, id.indexOf("."));
 export const PLATFORM_DOMAINS = [
     {
         id: "platform",
-        description: "What this platform is, its tool families, and what you and this agent can do.",
+        description: "What this platform is, its tool families, what you and this agent can do, and your own preferences (time zone).",
     },
     { id: "skills", description: "The org's skill library: list, read, create, switch on or off." },
     {

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

@@ -1,17 +1,22 @@
 import { type OnModuleInit } from "@nestjs/common";
 import { AgentsService } from "../../agents/agents.service.js";
+import { AccountsService } from "../../identity/accounts.js";
 import { OrgSettingsService } from "../../orgs/settings.service.js";
 import { ToolRegistry } from "../../tools/registry.js";
 import { PlatformActor } from "../actor.js";
 import { PlatformOperations } from "../registry.js";
-/** 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`).
+ */
 export declare class PlatformOperationsProvider implements OnModuleInit {
     private readonly registry;
     private readonly actor;
     private readonly agents;
     private readonly settings;
     private readonly tools;
-    constructor(registry: PlatformOperations, actor: PlatformActor, agents: AgentsService, settings: OrgSettingsService, tools: ToolRegistry);
+    private readonly accounts;
+    constructor(registry: PlatformOperations, actor: PlatformActor, agents: AgentsService, settings: OrgSettingsService, tools: ToolRegistry, accounts: AccountsService);
     /**
      * 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

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

@@ -10,6 +10,8 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 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";
@@ -34,19 +36,24 @@ 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, as the registry resolves them for a run (tools
@@ -143,6 +150,45 @@ let PlatformOperationsProvider = class PlatformOperationsProvider {
                     };
                 },
             }),
+            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 }),
+            }),
         ]);
     }
 };
@@ -152,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/route-schemas.js

@@ -15,6 +15,7 @@ import { ENVIRONMENT_ROUTES } from "../environments/environments.schemas.js";
 import { EVAL_ROUTES } from "../evals/evals.schemas.js";
 import { EXTENSION_POINT_ROUTES } from "../extensions/point-defaults.schemas.js";
 import { FILE_PREVIEWER_ROUTES } from "../files/previewers.schemas.js";
+import { ME_ROUTES } from "../identity/me.schemas.js";
 import { INBOX_ROUTES } from "../inbox/inbox.schemas.js";
 import { ORG_MODEL_ROUTES } from "../models/org-models.schemas.js";
 import { ORG_ROUTES, ORG_SETTINGS_ROUTES } from "../orgs/orgs.schemas.js";
@@ -57,4 +58,6 @@ export const ROUTE_SCHEMAS = [
     ...FILE_PREVIEWER_ROUTES,
     // Task 11b: environments
     ...ENVIRONMENT_ROUTES,
+    // personal preferences (run context spec §3.4)
+    ...ME_ROUTES,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capybara-hq/kernel",
-  "version": "0.1.0-rc.7",
+  "version": "0.1.0-rc.8",
   "description": "Capybara kernel: config, database, plugin host and HTTP API of the Capybara agent platform",
   "license": "Apache-2.0",
   "repository": {
@@ -71,7 +71,7 @@
     "@types/pg": "^8.23.1",
     "@types/semver": "^7.8.0",
     "@types/yauzl": "3.4.0",
-    "@capybara-hq/testing": "0.1.0-rc.8"
+    "@capybara-hq/testing": "0.1.0-rc.9"
   },
   "scripts": {
     "build": "tsc -b"