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

package/dist/channels/inbound.js

@@ -243,6 +243,10 @@ let ChannelInbound = class ChannelInbound {
             const posted = await this.post(row.orgId, conversationId, accountId, {
                 text: e.text,
                 clientMessageId: `${connectionId}:${e.messageId}`,
+                // run context spec §7: an anonymous guest is named by their IM profile name; a bound
+                // person by their account's name (the kernel reads it)
+                ...(threadAccount === null &&
+                    e.sender.displayName !== undefined && { senderName: e.sender.displayName }),
             });
             seq = posted.event.seq;
             // best-effort (batch 5 review m4): a failed note must not fail the job before the thread

package/dist/conversations/conversations.controller.d.ts

@@ -6,6 +6,7 @@ import { type OrgContext } from "../orgs/org.guard.js";
 import { ConversationToolInfo, type ToolInfo } from "../tools/info.js";
 import type { AgentTreeNode } from "./agent-tree.js";
 import { type ArtifactPreview, ConversationArtifacts } from "./artifacts.js";
+import { EventsQuery, FilesQuery, IdParams, ListQuery, PatchBody, SubagentsQuery } from "./conversations.schemas.js";
 import { type ConversationGroup, ConversationsService, type ConversationView, type SubagentView, type UsageTotals } from "./conversations.service.js";
 import { ConversationEnvironmentStatus } from "./environment-status.js";
 import type { ConversationEvent } from "./events.js";
@@ -13,19 +14,6 @@ import { ConversationFiles, type FileOutput } from "./files.js";
 import { ConversationOutputs, type OutputPage } from "./outputs-read.js";
 import type { QueueItem, QueuePauseReason } from "./queue.js";
 import { ConversationQueue } from "./queue.service.js";
-declare const ListQuery: z.ZodObject<{
-    q: z.ZodOptional<z.ZodString>;
-    state: z.ZodOptional<z.ZodEnum<{
-        running: "running";
-        waiting: "waiting";
-    }>>;
-    archived: z.ZodOptional<z.ZodEnum<{
-        1: "1";
-    }>>;
-    after: z.ZodOptional<z.ZodString>;
-    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-    agentId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
 declare const GroupsQuery: z.ZodObject<{
     q: z.ZodOptional<z.ZodString>;
     state: z.ZodOptional<z.ZodEnum<{
@@ -39,15 +27,6 @@ declare const GroupsQuery: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     after: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-declare const SubagentsQuery: z.ZodObject<{
-    after: z.ZodOptional<z.ZodString>;
-    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-}, z.core.$strip>;
-declare const EventsQuery: z.ZodObject<{
-    after: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-    before: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"end">, z.ZodCoercedNumber<unknown>]>>;
-    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-}, z.core.$strip>;
 /** `?keys=a,b`: 1–100 comma-separated tool keys of 1–200 characters each. */
 declare const ToolsQuery: z.ZodObject<{
     keys: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>, z.ZodArray<z.ZodString>>;
@@ -56,10 +35,6 @@ declare const OutputQuery: z.ZodObject<{
     offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
-declare const FilesQuery: z.ZodObject<{
-    after: z.ZodOptional<z.ZodString>;
-    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
-}, z.core.$strip>;
 declare const FileContentQuery: z.ZodObject<{
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
@@ -93,6 +68,11 @@ declare const MessageBody: z.ZodObject<{
     skill: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
     }, z.core.$strict>>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        zh: "zh";
+    }>>;
 }, z.core.$strict>;
 /**
  * `POST /conversations`: `message` creates the conversation with its first message (create on
@@ -125,6 +105,11 @@ declare const CreateBody: z.ZodObject<{
         skill: z.ZodOptional<z.ZodObject<{
             name: z.ZodString;
         }, z.core.$strict>>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodEnum<{
+            en: "en";
+            zh: "zh";
+        }>>;
         clientMessageId: z.ZodString;
     }, z.core.$strict>>;
 }, z.core.$strict>;
@@ -152,23 +137,17 @@ declare const QueueBody: z.ZodObject<{
     skill: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
     }, z.core.$strict>>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        zh: "zh";
+    }>>;
     clientMessageId: z.ZodString;
 }, z.core.$strict>;
 /** `PATCH …/queue/:itemId`: only the text changes (the text rule is checked against the item). */
 declare const QueueEditBody: z.ZodObject<{
     text: z.ZodString;
 }, z.core.$strict>;
-/**
- * A rename: 1–120 characters counted in code points after trimming, with no control or format
- * (bidi, zero-width) characters, the same rule generated and tool titles follow.
- */
-declare const PatchBody: z.ZodObject<{
-    title: z.ZodOptional<z.ZodString>;
-    archived: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-declare const IdParams: z.ZodObject<{
-    id: z.ZodString;
-}, z.core.$strip>;
 /**
  * 会话（`/api/v1/orgs/:orgId/conversations`）：`agents.use`（访客以上），只接受人类用户；
  * 服务令牌 → 403 `forbidden`。只有会话所有者可见，其他人一律 `conversation.not_found`。

package/dist/conversations/conversations.controller.js

@@ -14,28 +14,15 @@ import { CurrentPrincipal, requireUser } from "../identity/principal.js";
 import { createZodDto } from "../infra/validation/create-zod-dto.js";
 import { ZBody, ZParam, ZQuery } from "../infra/validation/zod-params.js";
 import { CurrentOrg, OrgAction } from "../orgs/org.guard.js";
-import { CONTROL_OR_HIDDEN_RE } from "../text.js";
 import { MAX_ATTACHMENTS } from "../tools/connector-content.js";
 import { ConversationToolInfo, TOOL_INFO_KEY_MAX, TOOL_INFO_MAX_KEYS, } from "../tools/info.js";
 import { ARTIFACT_DOWNLOAD_CACHE_SECONDS, ConversationArtifacts, } from "./artifacts.js";
-import { CONVERSATION_TITLE_MAX_CHARS, ConversationsService, } from "./conversations.service.js";
+import { EventsQuery, FilesQuery, IdParams, ListQuery, PatchBody, SubagentsQuery, searchFields, } from "./conversations.schemas.js";
+import { ConversationsService, } from "./conversations.service.js";
 import { ConversationEnvironmentStatus } from "./environment-status.js";
-import { ConversationFiles, FILE_CONTENT_MAX_BYTES, FILES_PAGE_MAX, } from "./files.js";
+import { ConversationFiles, FILE_CONTENT_MAX_BYTES } from "./files.js";
 import { ConversationOutputs, OUTPUT_PAGE_MAX_CHARS } from "./outputs-read.js";
 import { ConversationQueue } from "./queue.service.js";
-/** Shared by the list and groups queries: title search, run activity and the archived list. */
-const searchFields = {
-    q: z.string().min(1).max(100).optional(),
-    state: z.enum(["running", "waiting"]).optional(),
-    archived: z.enum(["1"]).optional(),
-};
-const ListQuery = z.object({
-    after: z.string().min(1).max(100).optional(),
-    limit: z.coerce.number().int().min(1).max(200).default(50),
-    /** Only this agent's conversations (the sidebar's per-group "More"). */
-    agentId: z.string().min(1).max(100).optional(),
-    ...searchFields,
-});
 const GroupsQuery = z.object({
     perGroup: z.coerce.number().int().min(1).max(20).default(5),
     limit: z.coerce.number().int().min(1).max(50).default(20),
@@ -43,22 +30,6 @@ const GroupsQuery = z.object({
     after: z.string().min(1).max(100).optional(),
     ...searchFields,
 });
-const SubagentsQuery = z.object({
-    /** The previous page's last sub-agent id (`next`). */
-    after: z.string().min(1).max(100).optional(),
-    limit: z.coerce.number().int().min(1).max(100).default(50),
-});
-const EventsQuery = z
-    .object({
-    after: z.coerce.number().int().min(0).optional(),
-    /** The page before this seq, or the log's last page (`end`); exclusive with `after`. */
-    before: z.union([z.literal("end"), z.coerce.number().int().min(1)]).optional(),
-    limit: z.coerce.number().int().min(1).max(500).default(500),
-})
-    .refine((q) => q.after === undefined || q.before === undefined, {
-    message: "after and before are exclusive",
-    path: ["before"],
-});
 /** `?keys=a,b`: 1–100 comma-separated tool keys of 1–200 characters each. */
 const ToolsQuery = z.object({
     keys: z
@@ -71,10 +42,6 @@ const OutputQuery = z.object({
     offset: z.coerce.number().int().min(0).default(0),
     limit: z.coerce.number().int().min(1).max(OUTPUT_PAGE_MAX_CHARS).default(OUTPUT_PAGE_MAX_CHARS),
 });
-const FilesQuery = z.object({
-    after: z.string().min(1).max(100).optional(),
-    limit: z.coerce.number().int().min(1).max(FILES_PAGE_MAX).default(50),
-});
 const FileContentQuery = z.object({
     limit: z.coerce.number().int().min(1).max(FILE_CONTENT_MAX_BYTES).default(FILE_CONTENT_MAX_BYTES),
 });
@@ -114,6 +81,13 @@ const MessageFields = z.object({
     })
         .strict()
         .optional(),
+    /**
+     * The browser's IANA time zone (run context spec §3.4). An unknown name is ignored, never a
+     * 400; the sender's account setting overrides it.
+     */
+    timeZone: z.string().min(1).max(64).optional(),
+    /** The sender's UI language (run context spec §3.4). */
+    locale: z.enum(["zh", "en"]).optional(),
 });
 // The body of `@` resource i is `content[i + 1]`, so `content[0]` must be the user's text: with
 // `@` resources the text must not be empty. A skill invocation's `content[0]` is the rendered
@@ -155,26 +129,6 @@ const QueueBody = MessageFields.omit({ retryOf: true })
     .refine(...textRule);
 /** `PATCH …/queue/:itemId`: only the text changes (the text rule is checked against the item). */
 const QueueEditBody = z.object({ text: z.string().max(100_000) }).strict();
-/**
- * A rename: 1–120 characters counted in code points after trimming, with no control or format
- * (bidi, zero-width) characters, the same rule generated and tool titles follow.
- */
-const PatchBody = z
-    .object({
-    title: z
-        .string()
-        .max(CONVERSATION_TITLE_MAX_CHARS * 2 + 100)
-        .trim()
-        .refine((t) => t.length > 0, "title must not be empty")
-        .refine((t) => Array.from(t).length <= CONVERSATION_TITLE_MAX_CHARS, `title must be at most ${CONVERSATION_TITLE_MAX_CHARS} characters`)
-        .refine((t) => !CONTROL_OR_HIDDEN_RE.test(t), "title must not contain control or format characters")
-        .optional(),
-    /** true archives (hidden from the default lists), false unarchives. */
-    archived: z.boolean().optional(),
-})
-    .strict()
-    .refine((b) => b.title !== undefined || b.archived !== undefined, "title or archived is required");
-const IdParams = z.object({ id: z.string().min(1).max(100) });
 class ConversationCreateBodyDto extends createZodDto(CreateBody, "ConversationCreateBody") {
 }
 class ConversationPatchBodyDto extends createZodDto(PatchBody, "ConversationPatchBody") {
@@ -248,6 +202,8 @@ let ConversationsController = class ConversationsController {
             ...(m.model !== undefined && { model: m.model }),
             ...(m.effort !== undefined && { effort: m.effort }),
             ...(m.skill !== undefined && { skill: m.skill }),
+            ...(m.timeZone !== undefined && { timeZone: m.timeZone }),
+            ...(m.locale !== undefined && { locale: m.locale }),
         }, pick);
         reply.status(out.created ? 201 : 200);
         return { conversation: out.conversation, event: out.event, events: out.events };
@@ -443,6 +399,8 @@ let ConversationsController = class ConversationsController {
                 ...(body.effort !== undefined && { effort: body.effort }),
                 ...(body.retryOf !== undefined && { retryOf: body.retryOf }),
                 ...(body.skill !== undefined && { skill: body.skill }),
+                ...(body.timeZone !== undefined && { timeZone: body.timeZone }),
+                ...(body.locale !== undefined && { locale: body.locale }),
             }),
         };
     }
@@ -470,6 +428,8 @@ let ConversationsController = class ConversationsController {
                 ...(body.model !== undefined && { model: body.model }),
                 ...(body.effort !== undefined && { effort: body.effort }),
                 ...(body.skill !== undefined && { skill: body.skill }),
+                ...(body.timeZone !== undefined && { timeZone: body.timeZone }),
+                ...(body.locale !== undefined && { locale: body.locale }),
             }),
         };
     }

package/dist/conversations/conversations.schemas.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import type { RouteSchemas } from "../platform/route-schemas.js";
+/** Shared by the list and groups queries: title search, run activity and the archived list. */
+export declare const searchFields: {
+    q: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        running: "running";
+        waiting: "waiting";
+    }>>;
+    archived: z.ZodOptional<z.ZodEnum<{
+        1: "1";
+    }>>;
+};
+export declare const ListQuery: z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        running: "running";
+        waiting: "waiting";
+    }>>;
+    archived: z.ZodOptional<z.ZodEnum<{
+        1: "1";
+    }>>;
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    agentId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const EventsQuery: z.ZodObject<{
+    after: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    before: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"end">, z.ZodCoercedNumber<unknown>]>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * A rename: 1–120 characters counted in code points after trimming, with no control or format
+ * (bidi, zero-width) characters, the same rule generated and tool titles follow.
+ */
+export declare const PatchBody: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    archived: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const IdParams: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const SubagentsQuery: z.ZodObject<{
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare const FilesQuery: z.ZodObject<{
+    after: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/** The conversation routes a Platform operation mirrors (spec §14, conversations). */
+export declare const CONVERSATION_ROUTES: readonly RouteSchemas[];

package/dist/conversations/conversations.schemas.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { CONTROL_OR_HIDDEN_RE } from "../text.js";
+import { CONVERSATION_TITLE_MAX_CHARS } from "./conversations.service.js";
+import { FILES_PAGE_MAX } from "./files.js";
+/** Shared by the list and groups queries: title search, run activity and the archived list. */
+export const searchFields = {
+    q: z.string().min(1).max(100).optional(),
+    state: z.enum(["running", "waiting"]).optional(),
+    archived: z.enum(["1"]).optional(),
+};
+export const ListQuery = z.object({
+    after: z.string().min(1).max(100).optional(),
+    limit: z.coerce.number().int().min(1).max(200).default(50),
+    /** Only this agent's conversations (the sidebar's per-group "More"). */
+    agentId: z.string().min(1).max(100).optional(),
+    ...searchFields,
+});
+export const EventsQuery = z
+    .object({
+    after: z.coerce.number().int().min(0).optional(),
+    /** The page before this seq, or the log's last page (`end`); exclusive with `after`. */
+    before: z.union([z.literal("end"), z.coerce.number().int().min(1)]).optional(),
+    limit: z.coerce.number().int().min(1).max(500).default(500),
+})
+    .refine((q) => q.after === undefined || q.before === undefined, {
+    message: "after and before are exclusive",
+    path: ["before"],
+});
+/**
+ * A rename: 1–120 characters counted in code points after trimming, with no control or format
+ * (bidi, zero-width) characters, the same rule generated and tool titles follow.
+ */
+export const PatchBody = z
+    .object({
+    title: z
+        .string()
+        .max(CONVERSATION_TITLE_MAX_CHARS * 2 + 100)
+        .trim()
+        .refine((t) => t.length > 0, "title must not be empty")
+        .refine((t) => Array.from(t).length <= CONVERSATION_TITLE_MAX_CHARS, `title must be at most ${CONVERSATION_TITLE_MAX_CHARS} characters`)
+        .refine((t) => !CONTROL_OR_HIDDEN_RE.test(t), "title must not contain control or format characters")
+        .optional(),
+    /** true archives (hidden from the default lists), false unarchives. */
+    archived: z.boolean().optional(),
+})
+    .strict()
+    .refine((b) => b.title !== undefined || b.archived !== undefined, "title or archived is required");
+export const IdParams = z.object({ id: z.string().min(1).max(100) });
+export const SubagentsQuery = z.object({
+    /** The previous page's last sub-agent id (`next`). */
+    after: z.string().min(1).max(100).optional(),
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+});
+export const FilesQuery = z.object({
+    after: z.string().min(1).max(100).optional(),
+    limit: z.coerce.number().int().min(1).max(FILES_PAGE_MAX).default(50),
+});
+/** The conversation routes a Platform operation mirrors (spec §14, conversations). */
+export const CONVERSATION_ROUTES = [
+    { route: "GET /api/v1/orgs/:orgId/conversations", query: ListQuery },
+    { route: "GET /api/v1/orgs/:orgId/conversations/:id", params: IdParams },
+    {
+        route: "GET /api/v1/orgs/:orgId/conversations/:id/events",
+        params: IdParams,
+        query: EventsQuery,
+    },
+    { route: "PATCH /api/v1/orgs/:orgId/conversations/:id", params: IdParams, body: PatchBody },
+    { route: "DELETE /api/v1/orgs/:orgId/conversations/:id", params: IdParams },
+    {
+        route: "GET /api/v1/orgs/:orgId/conversations/:id/subagents",
+        params: IdParams,
+        query: SubagentsQuery,
+    },
+    { route: "GET /api/v1/orgs/:orgId/conversations/:id/agent-tree", params: IdParams },
+    { route: "GET /api/v1/orgs/:orgId/conversations/:id/usage", params: IdParams },
+    { route: "GET /api/v1/orgs/:orgId/conversations/:id/files", params: IdParams, query: FilesQuery },
+    { route: "GET /api/v1/orgs/:orgId/conversations/:id/environment", params: IdParams },
+    { route: "POST /api/v1/orgs/:orgId/conversations/:id/abort", params: IdParams },
+];

package/dist/conversations/conversations.service.d.ts

@@ -161,6 +161,11 @@ export interface UserMessageInput {
     skill?: {
         name: string;
     };
+    /** The browser's IANA time zone and UI language (run context spec §3.4); IM sends none. */
+    timeZone?: string;
+    locale?: "zh" | "en";
+    /** An anonymous IM guest's IM profile name (run context spec §7); other senders: none. */
+    senderName?: string;
 }
 /**
  * 会话：只有所有者可见；每次访问都实时复核 agent 对所有者仍可用（spec 3.6 R5），
@@ -366,7 +371,10 @@ export declare class ConversationsService {
      * `text` 为空时（只发附件，HTTP 层保证此时有 `files` 且没有 `@` 资源）不写文本块。
      */
     postUserMessage(orgId: string, conversationId: string, accountId: string, input: UserMessageInput): Promise<ConversationEvent>;
-    /** A message with files or a model switch: binds the files and writes it in one transaction. */
+    /**
+     * Writes a message in one transaction: binds its files, reads its sender context and appends it
+     * (after its `model_switched` when it switches).
+     */
     private postIn;
     /**
      * The selection a message switches to, or null when it changes nothing. A model equal to the

package/dist/conversations/conversations.service.js

@@ -29,6 +29,7 @@ import { readAgentTree } from "./agent-tree.js";
 import { AttachmentsService } from "./attachments.service.js";
 import { EventLog } from "./event-log.js";
 import { userMessageIdemKey } from "./idem-keys.js";
+import { readMessageContext } from "./message-context.js";
 import { NO_SELECTION, planSelection, readSelection } from "./selection.js";
 import { conversationTree } from "./tree.js";
 /** Escapes `\`, `%` and `_` so user text is matched literally by `LIKE … ESCAPE '\'`. */
@@ -245,7 +246,7 @@ let ConversationsService = class ConversationsService {
         if (!row)
             return undefined;
         const blocks = await this.bindIn(orgId, id, accountId, input.files ?? []);
-        return this.writeMessage(id, accountId, input, next, extra, blocks, invoked);
+        return this.writeMessage(orgId, id, accountId, input, next, extra, blocks, invoked);
     }
     /**
      * The conversation (and its first event) an earlier first send with this id created. The id used
@@ -706,18 +707,12 @@ let ConversationsService = class ConversationsService {
         const invoked = agent === undefined
             ? undefined
             : await this.prepareSkill(orgId, conv.agentId, conversationId, agent, input);
-        let event;
-        if (files.length > 0 || next !== null) {
-            event = await this.postIn(orgId, conversationId, accountId, input, next, extra, invoked);
-            await this.eventLog.notify(conversationId, event.seq);
-            if (next !== null)
-                await this.eventLog.publishChanged(conversationId, "selection");
-        }
-        else {
-            [event] = await this.eventLog.append(conversationId, [
-                this.userMessage(accountId, input, extra, [], invoked),
-            ]);
-        }
+        // one transaction: the sender, time zone and language are read with the message's write
+        // (run context spec §3.2)
+        const event = await this.postIn(orgId, conversationId, accountId, input, next, extra, invoked);
+        await this.eventLog.notify(conversationId, event.seq);
+        if (next !== null)
+            await this.eventLog.publishChanged(conversationId, "selection");
         // The message is written: it brings an archived conversation back into the default lists
         if (conv.archivedAt !== null) {
             await this.db
@@ -730,11 +725,14 @@ let ConversationsService = class ConversationsService {
         await this.runs.ensureRun(conversationId);
         return event;
     }
-    /** A message with files or a model switch: binds the files and writes it in one transaction. */
+    /**
+     * Writes a message in one transaction: binds its files, reads its sender context and appends it
+     * (after its `model_switched` when it switches).
+     */
     // its own transaction: the caller notifies and publishes after the commit
     async postIn(orgId, conversationId, accountId, input, next, extra, invoked) {
         const blocks = await this.bindIn(orgId, conversationId, accountId, input.files ?? []);
-        const written = await this.writeMessage(conversationId, accountId, input, next, extra, blocks, invoked);
+        const written = await this.writeMessage(orgId, conversationId, accountId, input, next, extra, blocks, invoked);
         return written.at(-1);
     }
     /**
@@ -779,7 +777,7 @@ let ConversationsService = class ConversationsService {
      * `conversations.selection`; returns the events written, in seq order (the `user_message`
      * last). The caller notifies after commit.
      */
-    async writeMessage(conversationId, accountId, input, next, extra, blocks, invoked) {
+    async writeMessage(orgId, conversationId, accountId, input, next, extra, blocks, invoked) {
         const events = [];
         if (next !== null) {
             events.push({
@@ -790,7 +788,13 @@ let ConversationsService = class ConversationsService {
                 payload: { ...next, byAccountId: accountId, reason: "user" },
             });
         }
-        events.push(this.userMessage(accountId, input, extra, blocks, invoked));
+        const context = await readMessageContext(this.db.db, {
+            orgId,
+            accountId,
+            senderName: input.senderName,
+            browser: { timeZone: input.timeZone, locale: input.locale },
+        });
+        events.push(this.userMessage(accountId, input, extra, blocks, invoked, context));
         const written = await this.eventLog.appendIn(conversationId, events);
         if (next !== null) {
             const t = this.db.db;
@@ -847,7 +851,7 @@ let ConversationsService = class ConversationsService {
             return [];
         return this.attachments.bindForMessage(orgId, conversationId, accountId, files);
     }
-    userMessage(accountId, input, extra, fileBlocks, invoked) {
+    userMessage(accountId, input, extra, fileBlocks, invoked, context) {
         // a skill invocation's rendered text replaces the typed arguments as content[0]
         const text = invoked?.text ?? input.text;
         return {
@@ -864,6 +868,7 @@ let ConversationsService = class ConversationsService {
                 ],
                 ...(extra.attachments.length > 0 && { attachments: extra.attachments }),
                 authorAccountId: accountId,
+                ...context,
                 ...(input.clientMessageId !== undefined && { clientMessageId: input.clientMessageId }),
                 ...(input.retryOf !== undefined && { retryOf: input.retryOf }),
                 ...(invoked !== undefined && { skill: invoked.skill }),

package/dist/conversations/events.d.ts

@@ -145,6 +145,39 @@ export declare const SubagentFinishStatusSchema: z.ZodEnum<{
     max_steps: "max_steps";
     timed_out: "timed_out";
 }>;
+/** The languages a run context names (the org `locale` values). */
+export declare const RUN_CONTEXT_LOCALES: readonly ["zh", "en"];
+/** `user_message.sender` (run context spec §3.2). */
+export declare const MessageSenderSchema: z.ZodObject<{
+    name: z.ZodString;
+    role: z.ZodOptional<z.ZodEnum<{
+        admin: "admin";
+        guest: "guest";
+        member: "member";
+        owner: "owner";
+    }>>;
+    anonymous: z.ZodOptional<z.ZodLiteral<true>>;
+}, z.core.$strip>;
+/** `run_context` (run context spec §3.1): every field optional, a later event holds changes only. */
+export declare const RunContextSchema: z.ZodObject<{
+    agent: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    org: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    date: z.ZodOptional<z.ZodString>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodEnum<{
+        en: "en";
+        zh: "zh";
+    }>>;
+    dispatchedBy: z.ZodOptional<z.ZodObject<{
+        agent: z.ZodString;
+        person: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * 会话事件（`type` + `payload`）的判别联合。事件日志只追加，写入前用它校验 payload；
  * 读出时按写入时的形状原样返回。
@@ -217,6 +250,21 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             name: z.ZodString;
         }, z.core.$strip>>>;
         authorAccountId: z.ZodString;
+        sender: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            role: z.ZodOptional<z.ZodEnum<{
+                admin: "admin";
+                guest: "guest";
+                member: "member";
+                owner: "owner";
+            }>>;
+            anonymous: z.ZodOptional<z.ZodLiteral<true>>;
+        }, z.core.$strip>>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodEnum<{
+            en: "en";
+            zh: "zh";
+        }>>;
         clientMessageId: z.ZodOptional<z.ZodString>;
         retryOf: z.ZodOptional<z.ZodNumber>;
         skill: z.ZodOptional<z.ZodObject<{
@@ -241,18 +289,18 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 task: "task";
             }>>;
             narrowed: z.ZodOptional<z.ZodObject<{
-                tools: z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                disabledTools: z.ZodOptional<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;
-                    name: 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">, unknown>>;
+                }, z.core.$strict>], "kind">>>;
                 skills: z.ZodOptional<z.ZodObject<{
                     orgSkills: z.ZodArray<z.ZodString>;
                     pinned: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -439,6 +487,27 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         step: z.ZodNumber;
         text: z.ZodString;
     }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"run_context">;
+    payload: z.ZodObject<{
+        agent: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        org: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+        }, z.core.$strip>>;
+        date: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodEnum<{
+            en: "en";
+            zh: "zh";
+        }>>;
+        dispatchedBy: z.ZodOptional<z.ZodObject<{
+            agent: z.ZodString;
+            person: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"tools_changed">;
     payload: z.ZodObject<{
@@ -697,6 +766,7 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
         }, z.core.$strip>;
         definition: z.ZodObject<{
             name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
             avatarUrl: z.ZodDefault<z.ZodNullable<z.ZodURL>>;
             instructions: z.ZodDefault<z.ZodString>;
             instructionFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -713,18 +783,22 @@ export declare const ConversationEventSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             }, 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<{
+            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;
-                name: 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">, unknown>>>;
+            }, z.core.$strict>], "kind">>>;
+            subagentTools: z.ZodOptional<z.ZodObject<{
+                allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
             toolPolicies: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
                 ask: "ask";
                 deny: "deny";