@k2b/cloud 0.7.0 → 0.8.0

package/src/ai/file-tools.ts

@@ -108,7 +108,12 @@ export const CloudAiListFilesOutputSchema = z.object({
       mediaType: z.string(),
       origin: z.enum(["user", "assistant", "project", "skill"]),
       updatedAt: z.string(),
-      dictationRecordedAt: z.string().optional().describe("Present for prompt dictation recordings, not manually uploaded audio. Original audio remains available for re-evaluation."),
+      dictationRecordedAt: z
+        .string()
+        .optional()
+        .describe(
+          "Present for prompt dictation recordings, not manually uploaded audio. Original audio remains available for re-evaluation.",
+        ),
     }),
   ),
   truncated: z.boolean(),
@@ -342,7 +347,8 @@ export const CloudAiPresentOutputSchema = z.object({ path: z.string(), size: z.n
 export const createCloudAiPresentTool = () =>
   defineAiTool({
     name: "present",
-    description: "Present a conversation file to the user as an openable and downloadable chat attachment. The returned path is a conversation-local file identifier, not a website URL. Refer to the delivered attachment by title; do not turn its path into a Markdown link.",
+    description:
+      "Present a conversation file to the user as an openable and downloadable chat attachment. The returned path is a conversation-local file identifier, not a website URL. Refer to the delivered attachment by title; do not turn its path into a Markdown link.",
     inputSchema: CloudAiPresentInputSchema,
     outputSchema: CloudAiPresentOutputSchema,
     approval: "never",

package/src/ai/files-store.ts

@@ -1,5 +1,5 @@
-import { aiFileContentVersion, AiFileWriteError, AiFileVersionConflict } from "./file-content-version";
-import { sql, type SQL } from "bun";
+import { type SQL, sql } from "bun";
+import { AiFileVersionConflict, AiFileWriteError, aiFileContentVersion } from "./file-content-version";
 
 export { guessAiMediaType } from "./file-media-type";
 
@@ -142,7 +142,8 @@ export const aiFileStore = {
     producerCallKey: string;
     mediaType: string;
   }): Promise<AiFileStat> {
-    if (input.bytes.byteLength > AI_FILES_MAX_FILE_BYTES_DEFAULT) throw new AiFileWriteError("STORAGE_FULL", "File exceeds the destination file limit; nothing was written.");
+    if (input.bytes.byteLength > AI_FILES_MAX_FILE_BYTES_DEFAULT)
+      throw new AiFileWriteError("STORAGE_FULL", "File exceeds the destination file limit; nothing was written.");
     if (!normalizeAiFilePath(input.path)) {
       throw new Error("Invalid tool artifact path or file size.");
     }
@@ -199,7 +200,8 @@ export const aiFileStore = {
   },
 
   async list(input: { conversationId: string; prefix?: string; after?: string; limit?: number }): Promise<AiFileStat[]> {
-    if (input.limit !== undefined && (!Number.isInteger(input.limit) || input.limit < 1 || input.limit > 1000)) throw new Error("Invalid file page limit");
+    if (input.limit !== undefined && (!Number.isInteger(input.limit) || input.limit < 1 || input.limit > 1000))
+      throw new Error("Invalid file page limit");
     const prefix = input.prefix ?? "/";
     const pattern = `${prefix.endsWith("/") ? prefix : `${prefix}/`}%`;
     const rows = await sql<FileRow[]>`
@@ -306,16 +308,29 @@ export const aiFileStore = {
     }
 
     return sql.begin(async (tx) => {
-      const [conversation] = await tx<{ id: string; created_by_user_id: string; archived_at: Date | null }[]>`SELECT id,created_by_user_id,archived_at FROM ai.conversations WHERE id = ${input.conversationId} FOR UPDATE`;
-      if (input.ownerUserId !== undefined && (!conversation || conversation.created_by_user_id !== input.ownerUserId || conversation.archived_at)) throw new Error("Conversation access denied");
+      const [conversation] = await tx<
+        { id: string; created_by_user_id: string; archived_at: Date | null }[]
+      >`SELECT id,created_by_user_id,archived_at FROM ai.conversations WHERE id = ${input.conversationId} FOR UPDATE`;
+      if (
+        input.ownerUserId !== undefined &&
+        (!conversation || conversation.created_by_user_id !== input.ownerUserId || conversation.archived_at)
+      )
+        throw new Error("Conversation access denied");
       if (input.expectedVersion !== undefined) {
-        const [existing] = await tx<FileContentRow[]>`SELECT path,size,media_type,origin,updated_at,version,bytes FROM ai.files WHERE conversation_id=${input.conversationId} AND path=${input.path}`;
-        const version = existing ? aiFileContentVersion({ ...toContent(existing), id: `${input.conversationId}:${input.path}:${existing.version}` }) : null;
+        const [existing] = await tx<
+          FileContentRow[]
+        >`SELECT path,size,media_type,origin,updated_at,version,bytes FROM ai.files WHERE conversation_id=${input.conversationId} AND path=${input.path}`;
+        const version = existing
+          ? aiFileContentVersion({ ...toContent(existing), id: `${input.conversationId}:${input.path}:${existing.version}` })
+          : null;
         if (version !== input.expectedVersion) throw new AiFileVersionConflict();
       }
       const otherBytes = await aiConversationStoredBytes(tx, input.conversationId, input.path);
       if (otherBytes + input.bytes.byteLength > maxConversation) {
-        throw new AiFileWriteError("STORAGE_FULL", `Conversation storage limit of ${Math.floor(maxConversation / (1024 * 1024))} MB exceeded.`);
+        throw new AiFileWriteError(
+          "STORAGE_FULL",
+          `Conversation storage limit of ${Math.floor(maxConversation / (1024 * 1024))} MB exceeded.`,
+        );
       }
       if (input.origin === "user") {
         if (input.allowUserOverwrite) {
@@ -347,7 +362,9 @@ export const aiFileStore = {
         `;
         if (!written[0]) throw new Error(`Cannot overwrite user-uploaded file ${input.path}.`);
       }
-      const [written] = await tx<FileRow[]>`SELECT path,size,media_type,origin,dictation_recorded_at,updated_at,version FROM ai.files WHERE conversation_id=${input.conversationId} AND path=${input.path}`;
+      const [written] = await tx<
+        FileRow[]
+      >`SELECT path,size,media_type,origin,dictation_recorded_at,updated_at,version FROM ai.files WHERE conversation_id=${input.conversationId} AND path=${input.path}`;
       return toStat(written!);
     });
   },
@@ -374,7 +391,10 @@ export const aiFileStore = {
       }
       const total = await aiConversationStoredBytes(tx, input.conversationId);
       if (total + input.bytes.byteLength > maxConversation) {
-        throw new AiFileWriteError("STORAGE_FULL", `Conversation storage limit of ${Math.floor(maxConversation / (1024 * 1024))} MB exceeded.`);
+        throw new AiFileWriteError(
+          "STORAGE_FULL",
+          `Conversation storage limit of ${Math.floor(maxConversation / (1024 * 1024))} MB exceeded.`,
+        );
       }
       const appended = await tx<{ id: string }[]>`
         INSERT INTO ai.files (conversation_id, path, bytes, media_type, size, origin, updated_at)
@@ -461,11 +481,19 @@ export const aiFileStore = {
 };
 
 /** Authorized services may expose this read after resolving the conversation owner. */
-export const listAiConversationFiles = (conversationId: string, prefix?: string, page?: { after?: string; limit: number }): Promise<AiFileStat[]> =>
-  aiFileStore.list({ conversationId, prefix, ...page });
+export const listAiConversationFiles = (
+  conversationId: string,
+  prefix?: string,
+  page?: { after?: string; limit: number },
+): Promise<AiFileStat[]> => aiFileStore.list({ conversationId, prefix, ...page });
 
 /** Authorized byte-preserving read for app-owned artifact importers. */
-export async function readAiConversationFile(input: { conversationId: string; ownerUserId: string; path: string; version?: number }): Promise<AiFileContent | null> {
+export async function readAiConversationFile(input: {
+  conversationId: string;
+  ownerUserId: string;
+  path: string;
+  version?: number;
+}): Promise<AiFileContent | null> {
   const { aiConversations } = await import("./store");
   const conversation = await aiConversations.getConversation({ conversationId: input.conversationId, ownerUserId: input.ownerUserId });
   if (!conversation || conversation.archivedAt) return null;
@@ -475,17 +503,27 @@ export async function readAiConversationFile(input: { conversationId: string; ow
 
 /** Save one agent-produced file without overwriting an existing or user-edited file. */
 export async function createAiConversationArtifact(input: {
-  conversationId: string; ownerUserId: string; path: string; bytes: Uint8Array; mediaType: string; producerCallKey: string;
+  conversationId: string;
+  ownerUserId: string;
+  path: string;
+  bytes: Uint8Array;
+  mediaType: string;
+  producerCallKey: string;
 }): Promise<AiFileStat> {
   const { aiConversations } = await import("./store");
-  const conversation = await aiConversations.getConversation({conversationId:input.conversationId,ownerUserId:input.ownerUserId});
+  const conversation = await aiConversations.getConversation({ conversationId: input.conversationId, ownerUserId: input.ownerUserId });
   if (!conversation || conversation.archivedAt) throw new Error("Conversation access denied");
   return aiFileStore.createToolArtifact(input);
 }
 
 /** Explicit, revision-checked file replacement for authorized transfer services. */
 export async function writeAiConversationFile(input: {
-  conversationId: string; ownerUserId: string; path: string; bytes: Uint8Array; mediaType: string; expectedVersion: string | null;
+  conversationId: string;
+  ownerUserId: string;
+  path: string;
+  bytes: Uint8Array;
+  mediaType: string;
+  expectedVersion: string | null;
 }): Promise<AiFileStat> {
   if (normalizeAiFilePath(input.path) !== input.path) throw new Error("Invalid file path");
   const current = await aiFileStore.stat(input);

package/src/ai/grids-skill.ts

@@ -153,4 +153,6 @@ A left join preserves unmatched readable source records. A relation with many ta
 
 ## Read stored document files
 
+For download links, use the downloadUrl returned by document.list/read verbatim. It requires the user's current Cloud session and is not a public share. Studio/code tools needing file bytes use document.content.read plus capabilities.streams.read; do not fetch invented paths.
+
 Use \`grids.document.read\` for metadata and available artifact keys. When the task needs actual PDF, XML or CSV bytes, use \`grids.document.content.read\` with the document ID and optional artifactKey; omission selects the primary artifact. In code mode, obtain the stream via capabilities.run in the current run and pass it to capabilities.streams.read to receive a File. Read XML/CSV as text or use an available PDF processor. A binary download alone does not extract PDF text or prove that you inspected its contents. Prefer GQL for structured data analysis. This is a read, not document issuance, a public share or sending a file. Respect the 50 MiB code-mode payload budget and 250 MiB total transfer budget; larger stored artifacts require a supported HTTP/CLI transfer. Streams expire, require current permissions and cannot be reused across turns or in mandate-backed background tasks. Never invent stream references or export capabilities.`;

package/src/ai/http.ts

@@ -1,12 +1,12 @@
-import { AiQuotaError } from "./quotas";
-import { CODE_RUNTIME_TOOL_NAMES } from "./browser-code-contracts";
 import type { Input, Message } from "@k2b/nessi";
 import type { Context } from "hono";
 import { z } from "zod";
 import { CapabilityAppIdSchema } from "../contracts/capabilities";
 import { type AuthContext, err, fail, respond } from "../server";
 import { aiAttachmentMarker } from "./attachments";
+import { CODE_RUNTIME_TOOL_NAMES } from "./browser-code-contracts";
 import { AI_TURN_ATTACHMENT_MAX_ITEMS } from "./limits";
+import { AiQuotaError } from "./quotas";
 import { AiResourceMarkerSchema } from "./resource-markers";
 import { AI_SHORT_ID_PATTERN } from "./short-id";
 import { AI_SKILL_NAME_MAX_CHARS, AI_SKILL_NAME_PATTERN } from "./skill-format";
@@ -38,7 +38,8 @@ export const AiConversationDraftInputSchema = z
     content: z.array(AiDraftContentPartSchema).max(AI_TURN_ATTACHMENT_MAX_ITEMS * 2 + 1),
   })
   .superRefine((value, context) => {
-    if (value.content.reduce((length, part) => length + (part.type === "text" ? part.text.length : 0), 0) > 20_000) context.addIssue({ code: "custom", path: ["content"], message: "Draft text exceeds 20000 characters" });
+    if (value.content.reduce((length, part) => length + (part.type === "text" ? part.text.length : 0), 0) > 20_000)
+      context.addIssue({ code: "custom", path: ["content"], message: "Draft text exceeds 20000 characters" });
     if (value.content.filter((part) => part.type !== "text").length > AI_TURN_ATTACHMENT_MAX_ITEMS) {
       context.addIssue({ code: "custom", path: ["content"], message: `A draft can attach at most ${AI_TURN_ATTACHMENT_MAX_ITEMS} items` });
     }
@@ -46,7 +47,9 @@ export const AiConversationDraftInputSchema = z
 
 export const AiInitialConversationDraftInputSchema = z
   .object({
-    content: z.array(z.union([AiDraftContentPartSchema.options[0], AiDraftContentPartSchema.options[1]])).max(AI_TURN_ATTACHMENT_MAX_ITEMS * 2 + 1),
+    content: z
+      .array(z.union([AiDraftContentPartSchema.options[0], AiDraftContentPartSchema.options[1]]))
+      .max(AI_TURN_ATTACHMENT_MAX_ITEMS * 2 + 1),
   })
   .superRefine((value, context) => {
     if (value.content.filter((part) => part.type === "resource").length > AI_TURN_ATTACHMENT_MAX_ITEMS) {
@@ -128,7 +131,11 @@ export const AiTurnInputSchema = z
       .max(AI_TURN_ATTACHMENT_MAX_ITEMS * 2 + 1)
       .optional(),
     modelProfileId: z.string().trim().min(1).optional(),
-    clientToolIds: z.array(AiClientToolIdSchema).max(1 + CODE_RUNTIME_TOOL_NAMES.length).refine((ids) => new Set(ids).size === ids.length, "Client tool IDs must be unique").optional(),
+    clientToolIds: z
+      .array(AiClientToolIdSchema)
+      .max(1 + CODE_RUNTIME_TOOL_NAMES.length)
+      .refine((ids) => new Set(ids).size === ids.length, "Client tool IDs must be unique")
+      .optional(),
   })
   .refine((input) => Boolean(input.message?.trim() || input.content?.length), {
     message: "Message or content is required.",
@@ -149,7 +156,11 @@ export const AiSubmitConversationDraftInputSchema = z.object({
   queueId: z.uuid().optional(),
   draftRevision: z.number().int().min(1),
   modelProfileId: z.string().trim().min(1).optional(),
-  clientToolIds: z.array(AiClientToolIdSchema).max(1 + CODE_RUNTIME_TOOL_NAMES.length).refine((ids) => new Set(ids).size === ids.length, "Client tool IDs must be unique").optional(),
+  clientToolIds: z
+    .array(AiClientToolIdSchema)
+    .max(1 + CODE_RUNTIME_TOOL_NAMES.length)
+    .refine((ids) => new Set(ids).size === ids.length, "Client tool IDs must be unique")
+    .optional(),
 });
 
 export const AiSteerInputSchema = z.object({
@@ -251,7 +262,7 @@ const aiSettingsServiceError = (error: AiSettingsError) => {
 };
 
 export const toAiErrorResponse = (c: Context<AuthContext>, error: unknown) => {
-  if (error instanceof AiQuotaError) return c.json({ok:false,error:error.message,message:error.message,code:error.code},429);
+  if (error instanceof AiQuotaError) return c.json({ ok: false, error: error.message, message: error.message, code: error.code }, 429);
   if (isAiSettingsError(error)) {
     return respond(c, fail(aiSettingsServiceError(error.aiError)));
   }

package/src/ai/index.ts

@@ -1,6 +1,3 @@
-export { CODE_SOURCE_TOOLS, type CodeSourceToolName } from "./code-source-contracts";
-export { CodeResourceId, CODE_RUNTIME_TOOL_NAMES, CodeRuntimeInput, parseCodeToolInput } from "./browser-code-contracts";
-export { assistantAiSettingsState, listAssistantAiModels } from "./assistant-models";
 export { type AiApprovalPreferenceRoutes, type AiApprovalPreferenceView, createAiApprovalPreferenceRoutes } from "./approval-routes";
 export {
   type AiToolApprovalContext,
@@ -14,14 +11,18 @@ export {
   rememberAiToolApproval,
   revokeAiToolApprovalPreference,
 } from "./approvals";
+export { assistantAiSettingsState, listAssistantAiModels, selectAssistantAiModelId } from "./assistant-models";
 export { type AiAttachmentRef, aiAttachmentMarker, formatAiFileSize, parseAiAttachmentMarkers } from "./attachments";
+export { CloudAiTranscribeAudioInputSchema, CloudAiTranscribeAudioOutputSchema, createCloudAiTranscribeAudioTool } from "./audio-tool";
+export { CODE_RUNTIME_TOOL_NAMES, CodeResourceId, CodeRuntimeInput, parseCodeToolInput } from "./browser-code-contracts";
 export { aiCapabilityId, aiCapabilityToolName } from "./capabilities";
+export { getAiChatQuotas } from "./chat-quotas";
 export {
   type AiChatTaskOccurrenceView,
   type AiChatTaskView,
   AiConversationIdSchema,
-  ChatTaskIdSchema,
   ChatTaskGrantsSchema,
+  ChatTaskIdSchema,
   ChatTaskOccurrenceIdSchema,
   ChatTaskScheduleInputSchema,
   chatTaskCreateFingerprint,
@@ -40,6 +41,10 @@ export {
   aiChatTasks,
 } from "./chat-tasks";
 export { parseAiSse } from "./client/transport";
+// Framework-owned managed execution host transport.
+export { CODE_CAPABILITY_TOKEN_HEADER, createCodeCapabilityTransport } from "./code-capability-transport";
+export { authorizeCodeExecution } from "./code-execution";
+export { CODE_SOURCE_TOOLS, type CodeSourceToolName } from "./code-source-contracts";
 export { listAiCredentialProfileIds } from "./credentials";
 export {
   CLOUD_AI_TEXT_EDITOR_MAX_CHARS,
@@ -69,16 +74,18 @@ export {
   shouldApplyEnrichedDescription,
   shouldApplyEnrichedTitle,
 } from "./enrich";
+export { AiFileVersionConflict, AiFileWriteError, aiFileContentVersion } from "./file-content-version";
+export { AiFileLocation, AiFileReference } from "./file-reference-contracts";
 export {
   AI_FILES_MAX_CONVERSATION_BYTES_DEFAULT,
   AI_FILES_MAX_FILE_BYTES_DEFAULT,
   type AiFileStat,
+  createAiConversationArtifact,
   guessAiMediaType,
   listAiConversationFiles,
+  normalizeAiFilePath,
   readAiConversationFile,
-  createAiConversationArtifact,
   writeAiConversationFile,
-  normalizeAiFilePath,
 } from "./files-store";
 export {
   AI_FIRECRAWL_API_KEY_SETTING_KEY,
@@ -208,6 +215,7 @@ export {
   isNewerWireEvent,
 } from "./protocol";
 export { createAiProvider } from "./provider";
+export { AiQuotaError } from "./quotas";
 export { isConversationResourceCursor } from "./resource-refs";
 export type { AiRoutes } from "./routes";
 export {
@@ -243,7 +251,6 @@ export {
   validateAiSkillName,
   validateAiSkillReferences,
 } from "./skill-format";
-export { seedCloudAiSkills } from "./skills";
 export {
   type AiLoadedSkillSnapshot,
   type AiSkill,
@@ -257,6 +264,7 @@ export {
   AiSkillRevisionConflictError,
   type AiSkillSummary,
   aiSkills,
+  seedCloudAiSkills,
 } from "./skills";
 export { type AiSkillsRoutes, aiSkillsRoutes } from "./skills-routes";
 export { aiConversations } from "./store";
@@ -279,8 +287,17 @@ export {
   runAiStructured,
 } from "./structured";
 export { aiGlobalInstructionsContext, composeAiSystemPrompt, renderAiGlobalInstructions } from "./system-prompt";
+export { type AiTaskRequest, type AiTaskRequestInput, AiTaskRequestSchema } from "./task-contracts";
+export { executeAiTask } from "./task-execution";
 export { type AiToolApprovalState, type AiToolCallLocation, aiToolAudit } from "./tool-audit";
 export { defineAiTool, isFrontendToolMode, type PreparedAiTools, prepareAiTools } from "./tools";
+export {
+  type AiResolvedAudioModel,
+  createAiTranscriptionProvider,
+  type RunAiTranscriptionInput,
+  resolveAiAudioModel,
+  runAiTranscription,
+} from "./transcription";
 export type {
   AiAccessResult,
   AiCapabilityToolPresentation,
@@ -341,21 +358,3 @@ export {
   type CloudAiViewImageOutput,
   CloudAiViewImageOutputSchema,
 } from "./vision-tool";
-
-export {
-  createAiTranscriptionProvider,
-  resolveAiAudioModel,
-  runAiTranscription,
-  type AiResolvedAudioModel,
-  type RunAiTranscriptionInput,
-} from "./transcription";
-
-export { createCloudAiTranscribeAudioTool, CloudAiTranscribeAudioInputSchema, CloudAiTranscribeAudioOutputSchema } from "./audio-tool";
-
-export { getAiChatQuotas } from "./chat-quotas";
-
-export { AiFileLocation, AiFileReference } from "./file-reference-contracts";
-export { aiFileContentVersion, AiFileWriteError, AiFileVersionConflict } from "./file-content-version";
-
-// Framework-owned managed execution host transport.
-export { createCodeCapabilityTransport, CODE_CAPABILITY_TOKEN_HEADER } from "./code-capability-transport";

package/src/ai/inference-calls.ts

@@ -1,9 +1,8 @@
-import { hasBillableAiPricing } from "../shared/ai-costs";
-import { sql, type SQL } from "bun";
+import { type SQL, sql } from "bun";
 import type { AccessSubject } from "../server/services/access";
-import { aiCostDecimal, aiCostUnits, aiDecimalUnits, aiBudgetUnits } from "../shared/ai-costs";
+import { aiBudgetUnits, aiCostDecimal, aiCostUnits, aiDecimalUnits, hasBillableAiPricing } from "../shared/ai-costs";
+import { AiQuotaError, aiQuotas, quotaWindow } from "./quotas";
 import type { AiModelProfile } from "./types";
-import { aiQuotas, AiQuotaError, quotaWindow } from "./quotas";
 
 export class AiBackgroundCostError extends Error {
   readonly code = "ai_background_cost_stop";

package/src/ai/live.ts

@@ -1,2 +1,2 @@
 export { latestAiInvalidationCursor } from "./live-outbox";
-export { aiLiveRoutes, type AiLiveRoutes, type AiLiveRoutesConfig } from "./live-routes";
+export { type AiLiveRoutes, type AiLiveRoutesConfig, aiLiveRoutes } from "./live-routes";

package/src/ai/markdown-pdf-tool.ts

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import {
   MARKDOWN_PDF_MAX_CUSTOM_CSS_BYTES,
   MARKDOWN_PDF_MAX_MARKDOWN_BYTES,
@@ -5,9 +6,8 @@ import {
   type RenderMarkdownToPdfInput,
   renderMarkdownToPdf,
 } from "../services/pdf";
-import { z } from "zod";
 import { aiProjectFilePathFromMount } from "./file-mount";
-import { aiFileStore, normalizeAiFilePath, type AiFileContent } from "./files-store";
+import { type AiFileContent, aiFileStore, normalizeAiFilePath } from "./files-store";
 import { defineAiTool } from "./tools";
 
 export const CloudAiMarkdownToPdfInputSchema = z

package/src/ai/memories.ts

@@ -459,9 +459,7 @@ export const aiMemories = {
           action: "retired" as const,
           kind: memory.kind,
           content: memory.content,
-          ...(memory.resource_type && memory.resource_id
-            ? { resourceRef: { type: memory.resource_type, id: memory.resource_id } }
-            : {}),
+          ...(memory.resource_type && memory.resource_id ? { resourceRef: { type: memory.resource_type, id: memory.resource_id } } : {}),
         }));
       }
 
@@ -509,19 +507,20 @@ export const aiMemories = {
         );
         const created = rows[0];
         return created
-          ? [{
-              action: "added",
-              kind: created.kind,
-              content: created.content,
-              ...(resourceRef ? { resourceRef } : {}),
-            }]
+          ? [
+              {
+                action: "added",
+                kind: created.kind,
+                content: created.content,
+                ...(resourceRef ? { resourceRef } : {}),
+              },
+            ]
           : [];
       }
 
       if (duplicate && !targets.some((memory) => memory.id === duplicate.id)) {
         const duplicateResourceMatches =
-          proposal.kind !== "workflow" ||
-          (duplicate.resource_type === resourceRef?.type && duplicate.resource_id === resourceRef?.id);
+          proposal.kind !== "workflow" || (duplicate.resource_type === resourceRef?.type && duplicate.resource_id === resourceRef?.id);
         if (duplicate.kind !== proposal.kind || !duplicateResourceMatches) return [];
         await tx`
           UPDATE ai.memories old
@@ -532,15 +531,17 @@ export const aiMemories = {
             AND old.source = 'background' AND old.priority = 'normal'
             AND old.deleted_at IS NULL AND old.superseded_by_id IS NULL
         `;
-        return [{
-          action: "merged",
-          kind: duplicate.kind,
-          content: duplicate.content,
-          previousContent: targets.map((memory) => memory.content).join(" · "),
-          ...(duplicate.resource_type && duplicate.resource_id
-            ? { resourceRef: { type: duplicate.resource_type, id: duplicate.resource_id } }
-            : {}),
-        }];
+        return [
+          {
+            action: "merged",
+            kind: duplicate.kind,
+            content: duplicate.content,
+            previousContent: targets.map((memory) => memory.content).join(" · "),
+            ...(duplicate.resource_type && duplicate.resource_id
+              ? { resourceRef: { type: duplicate.resource_type, id: duplicate.resource_id } }
+              : {}),
+          },
+        ];
       }
 
       const destination = targets[0]!;
@@ -565,13 +566,15 @@ export const aiMemories = {
             AND deleted_at IS NULL AND superseded_by_id IS NULL
         `;
       }
-      return [{
-        action: proposal.action === "merge" ? "merged" : "updated",
-        kind: proposal.kind,
-        content,
-        previousContent: targets.map((memory) => memory.content).join(" · "),
-        ...(resourceRef ? { resourceRef } : {}),
-      }];
+      return [
+        {
+          action: proposal.action === "merge" ? "merged" : "updated",
+          kind: proposal.kind,
+          content,
+          previousContent: targets.map((memory) => memory.content).join(" · "),
+          ...(resourceRef ? { resourceRef } : {}),
+        },
+      ];
     });
   },
 

package/src/ai/memory-learning-runs.ts

@@ -1,7 +1,7 @@
 import { sql } from "bun";
 import type { CloudResourceRef } from "../contracts/capabilities";
-import { withAiShortId } from "./short-id";
 import type { AiMemoryKind } from "./memories";
+import { withAiShortId } from "./short-id";
 
 export type AiMemoryLearningRunStatus = "running" | "ok" | "skipped" | "failed";
 export type AiMemoryLearningRunKind = "turn" | "workflow";

package/src/ai/memory-learning.ts

@@ -1,21 +1,21 @@
-import { AiBackgroundAdmissionError, AiBackgroundCostError } from "./inference-calls";
-import { sql } from "bun";
 import { createHash } from "node:crypto";
+import { sql } from "bun";
 import { z } from "zod";
 import { CloudResourceRefSchema } from "../contracts/capabilities";
 import { coreSettings } from "../services";
 import { logger } from "../services/logging";
 import { normalizeLocale } from "../shared/locale";
 import { parseAiAttachmentMarkers } from "./attachments";
+import { AiBackgroundAdmissionError, AiBackgroundCostError } from "./inference-calls";
+import { type AiBackgroundMemoryProposal, aiMemories } from "./memories";
 import { type AiMemoryLearningChange, aiMemoryLearningRuns } from "./memory-learning-runs";
 import {
+  type AiMemoryWorkflowEvidence,
+  type AiMemoryWorkflowPattern,
   listAiPendingWorkflowPatterns,
   listAiTurnWorkflowEvidence,
   markAiWorkflowPatternReviewed,
-  type AiMemoryWorkflowEvidence,
-  type AiMemoryWorkflowPattern,
 } from "./memory-workflow-evidence";
-import { type AiBackgroundMemoryProposal, aiMemories } from "./memories";
 import { aiConversations } from "./store";
 import type { RunAiStructuredInput, RunAiStructuredResult } from "./structured";
 import { resolveAiBackgroundModel, runAiStructured } from "./structured";

package/src/ai/memory-tool.ts

@@ -108,11 +108,7 @@ export const createCloudAiMemoryTool = (evidence = "") =>
     }
 
     const memory = await aiMemories.getByShortId(userId, input.id);
-    if (
-      memory &&
-      !memoryMutationSupportedByEvidence(evidence, input.id) &&
-      !memoryMutationSupportedByEvidence(evidence, memory.content)
-    ) {
+    if (memory && !memoryMutationSupportedByEvidence(evidence, input.id) && !memoryMutationSupportedByEvidence(evidence, memory.content)) {
       return { ok: false, message: "A memory can only be forgotten when the user identifies it in this turn." };
     }
     if (!memory || !(await aiMemories.deleteByShortId(userId, input.id))) return { ok: false, message: "Memory not found." };

package/src/ai/memory-workflow-evidence.ts

@@ -37,10 +37,15 @@ export const recordAiMemoryWorkflowEvidence = async (input: {
       input.resources.flatMap((resource) => {
         const parsed = CloudResourceRefSchema.safeParse(resource.ref);
         if (!parsed.success) return [];
-        return [[`${parsed.data.type}\0${parsed.data.id}`, {
-          ref: parsed.data,
-          ...(resource.title ? { title: resource.title.trim().slice(0, MAX_RESOURCE_TITLE_CHARS) } : {}),
-        }] as const];
+        return [
+          [
+            `${parsed.data.type}\0${parsed.data.id}`,
+            {
+              ref: parsed.data,
+              ...(resource.title ? { title: resource.title.trim().slice(0, MAX_RESOURCE_TITLE_CHARS) } : {}),
+            },
+          ] as const,
+        ];
       }),
     ).values(),
   ].slice(0, MAX_RECEIPT_RESOURCES);

package/src/ai/message-queue.ts

@@ -1,14 +1,14 @@
-import { editAiDraftText } from "./draft-content";
-import { aiQuotas, AiQuotaError } from "./quotas";
+import { sql } from "bun";
+import { logger } from "../services/logging";
 import { aiChatAccessSubject, isAssistantChatTurn } from "./assistant-models";
-import { aiInputToUserMessage, aiTurnInputToContent } from "./http";
+import { editAiDraftText } from "./draft-content";
 import { canonicalizeAiConversationAttachments } from "./file-context";
+import { AI_FILES_MAX_CONVERSATION_BYTES_DEFAULT } from "./files-store";
+import { aiInputToUserMessage, aiTurnInputToContent } from "./http";
+import { AiQuotaError, aiQuotas } from "./quotas";
 import { aiResourceMarker } from "./resource-markers";
-import { sql } from "bun";
-import type { AiConversationService, AiDraftContentPart } from "./types";
 import { aiConversations } from "./store";
-import { logger } from "../services/logging";
-import { AI_FILES_MAX_CONVERSATION_BYTES_DEFAULT } from "./files-store";
+import type { AiConversationService, AiDraftContentPart } from "./types";
 
 const log = logger("ai:message-queue");
 export const AI_MESSAGE_QUEUE_LIMIT = 32;
@@ -112,15 +112,26 @@ export const editQueuedMessage = async (conversationId: string, id: string, text
     const parts = content.map((part) =>
       part.type === "text"
         ? part
-        : part.type === "project-file" ? { type: "text" as const, text: `Project file: ${part.path}` }
-        : part.type === "file"
-          ? { type: "attachment" as const, path: part.path, mediaType: part.mediaType, size: part.size }
-          : { type: "text" as const, text: aiResourceMarker({ ref: part.ref, title: part.title, icon: part.icon, href: part.href }) },
+        : part.type === "project-file"
+          ? { type: "text" as const, text: `Project file: ${part.path}` }
+          : part.type === "file"
+            ? { type: "attachment" as const, path: part.path, mediaType: part.mediaType, size: part.size }
+            : { type: "text" as const, text: aiResourceMarker({ ref: part.ref, title: part.title, icon: part.icon, href: part.href }) },
     );
     const { message } = aiInputToUserMessage(aiTurnInputToContent({ content: parts }));
     const userMessage = canonicalizeAiConversationAttachments(message, row.submission.runConfig.files);
     if (userMessage.role !== "user") throw new Error("Queued message must be a user message.");
-    const submission = { ...row.submission, userMessage, runConfig: { ...row.submission.runConfig, input: userMessage.content, selectedSkillIds: [...new Set(content.flatMap(part => part.type === "resource" && part.ref.type === "core.ai.skill" ? [part.ref.id] : []))] } };
+    const submission = {
+      ...row.submission,
+      userMessage,
+      runConfig: {
+        ...row.submission.runConfig,
+        input: userMessage.content,
+        selectedSkillIds: [
+          ...new Set(content.flatMap((part) => (part.type === "resource" && part.ref.type === "core.ai.skill" ? [part.ref.id] : []))),
+        ],
+      },
+    };
     await tx`UPDATE ai.queued_messages SET submission = (${JSON.stringify(submission)}::text)::jsonb,
     content = (${JSON.stringify(content)}::text)::jsonb WHERE id = ${id}::uuid`;
     return true;

package/src/ai/migrate.ts

@@ -1,7 +1,7 @@
-import { migrateAiQuotas } from "./quotas-migrate";
-import { migrateAiMessageQueue } from "./message-queue";
 import { sql } from "bun";
+import { migrateAiMessageQueue } from "./message-queue";
 import { migrateAiModelAccess } from "./model-access-migrate";
+import { migrateAiQuotas } from "./quotas-migrate";
 import { withAiShortId } from "./short-id";
 
 const backfillAiShortIds = async (
@@ -1441,8 +1441,10 @@ export const migrateCloudAi = async (): Promise<void> => {
       SELECT EXISTS (SELECT 1 FROM pg_extension WHERE extname = 'pg_textsearch') AS installed
     `;
     if (extension?.installed) {
-      await sql.unsafe(`CREATE INDEX IF NOT EXISTS skills_search_bm25_idx
-        ON ai.skills USING bm25 ((search_text)) WITH (text_config='simple')`).simple();
+      await sql
+        .unsafe(`CREATE INDEX IF NOT EXISTS skills_search_bm25_idx
+        ON ai.skills USING bm25 ((search_text)) WITH (text_config='simple')`)
+        .simple();
     }
   } catch (error) {
     console.warn("Optional Skill BM25 index unavailable; native Skill search remains active", error);