akanjs 3.0.0-beta.18 → 3.0.0-beta.19

package/base/baseEnv.ts

@@ -1,3 +1,5 @@
+import { DatabaseModes } from "./databaseModes";
+
 type ProcessEnvLike = { env?: Record<string, string | undefined> };
 
 const globalWithProcess = globalThis as unknown as { process?: ProcessEnvLike };
@@ -19,8 +21,6 @@ export type BackendEnv = {
   hostname?: string | null;
   port?: number;
   database?: {
-    mode?: DatabaseMode;
-    driver?: "sqlite" | "libsql" | "postgres";
     sqlite?: {
       filePath?: string;
       journalMode?: string;
@@ -41,6 +41,7 @@ export type BackendEnv = {
       database?: string;
       user?: string;
       password?: string;
+      insightUrl?: string;
     };
   };
   solid?: {
@@ -51,6 +52,7 @@ export type BackendEnv = {
     cleanupIntervalMs?: number;
     queuePollIntervalMs?: number;
     queueLeaseMs?: number;
+    queueFailedRetentionMs?: number;
   };
   onCleanup?: () => Promise<void>;
 };
@@ -133,7 +135,14 @@ export const getEnv = (): ClientEnv => {
     appName,
     environment,
     operationMode,
-    databaseMode: process.env.AKAN_DATABASE_MODE as DatabaseMode | undefined,
+    databaseMode:
+      typeof window === "undefined"
+        ? DatabaseModes.settle({
+            requested: process.env.AKAN_DATABASE_MODE,
+            declared: process.env.AKAN_DATABASE_MODES,
+            local: environment === "local" || operationMode === "local",
+          })
+        : undefined,
   } as const;
   const side = typeof window === "undefined" ? "server" : "client";
   const renderMode = (process.env.AKAN_PUBLIC_RENDER_ENV ?? "csr") as ClientEnv["renderMode"];

package/base/databaseModes.ts

@@ -0,0 +1,76 @@
+import type { DatabaseMode } from "./baseEnv";
+
+export interface DatabaseModeRequest {
+  /** `AKAN_DATABASE_MODE`: the mode a deployment names. */
+  requested: string | undefined;
+  /** `AKAN_DATABASE_MODES`: what the build carries drivers for, first one the default. Unset allows any. */
+  declared: string | undefined;
+  /** A developer machine, which may leave the mode unnamed when the build carries several. */
+  local: boolean;
+}
+
+/** The database modes, what each runs on, and how a process settles on one. The CLI and the server share it. */
+export class DatabaseModes {
+  static readonly all = ["single", "multiple", "cluster"] as const satisfies readonly DatabaseMode[];
+  /** Packages a mode imports at runtime. A build carries them for every mode the app declares. */
+  static readonly drivers: { [mode in DatabaseMode]: readonly string[] } = {
+    single: [],
+    multiple: ["bullmq", "ioredis"],
+    cluster: ["bullmq", "ioredis", "postgres"],
+  };
+  static readonly #stores: { [mode in DatabaseMode]: string } = {
+    single: "sqlite · solid",
+    multiple: "sqlite · redis",
+    cluster: "postgres · redis",
+  };
+
+  static describe(mode: DatabaseMode) {
+    return `${mode} (${DatabaseModes.#stores[mode]})`;
+  }
+
+  static parse(value: string, source: string): DatabaseMode {
+    const mode = value.trim();
+    if ((DatabaseModes.all as readonly string[]).includes(mode)) return mode as DatabaseMode;
+    throw new Error(`${source} must be one of ${DatabaseModes.all.join(", ")}, not "${value}"`);
+  }
+
+  static parseList(value: string, source: string): DatabaseMode[] {
+    const modes = value
+      .split(",")
+      .filter((mode) => mode.trim())
+      .map((mode) => DatabaseModes.parse(mode, source));
+    if (!modes.length) throw new Error(`${source} names no database mode`);
+    return [...new Set(modes)];
+  }
+
+  /**
+   * The mode this process runs in, or the reason it cannot pick one. A deployment that names no mode when the build
+   * carries several fails rather than falling back: the fallback would be a SQLite file inside each container, which a
+   * cluster deployment would find out about only once its instances disagreed.
+   */
+  static resolve({ requested, declared, local }: DatabaseModeRequest): DatabaseMode {
+    const modes = declared?.trim() ? DatabaseModes.parseList(declared, "AKAN_DATABASE_MODES") : null;
+    if (requested?.trim()) {
+      const mode = DatabaseModes.parse(requested, "AKAN_DATABASE_MODE");
+      if (modes && !modes.includes(mode))
+        throw new Error(
+          `AKAN_DATABASE_MODE is ${mode}, but this build carries only ${modes.join(", ")}. Add "${mode}" to database.modes in akan.config.ts and rebuild.`,
+        );
+      return mode;
+    }
+    if (!modes) return "single";
+    if (modes.length === 1 || local) return modes[0] as DatabaseMode;
+    throw new Error(
+      `This build runs in ${modes.join(" or ")} mode, and AKAN_DATABASE_MODE names neither. Set it to say which this deployment is.`,
+    );
+  }
+
+  /** `resolve` for readers that cannot fail a boot; the boot itself resolves again and reports the reason. */
+  static settle(request: DatabaseModeRequest): DatabaseMode | undefined {
+    try {
+      return DatabaseModes.resolve(request);
+    } catch {
+      return undefined;
+    }
+  }
+}

package/base/index.ts

@@ -1,5 +1,6 @@
 export * from "./base";
 export * from "./baseEnv";
+export * from "./databaseModes";
 export * from "./primitiveRegistry";
 export * from "./symbols";
 export * from "./types";

package/base/primitiveRegistry.ts

@@ -11,12 +11,8 @@ export const dayjs = dayjsLib;
 export class PrimitiveRegistry {
   static readonly #namePrimitiveMap = new Map<string, typeof PrimitiveScalar>();
   static readonly #primitiveNameMap = new Map<typeof PrimitiveScalar, string>();
-  static register(scalar: typeof PrimitiveScalar, { overwrite = false } = {}) {
-    if (
-      !overwrite &&
-      (PrimitiveRegistry.#namePrimitiveMap.has(scalar.refName) || PrimitiveRegistry.#primitiveNameMap.has(scalar))
-    )
-      throw new Error(`Scalar ${scalar.refName} already registered`);
+
+  static register(scalar: typeof PrimitiveScalar) {
     PrimitiveRegistry.#namePrimitiveMap.set(scalar.refName, scalar);
     PrimitiveRegistry.#primitiveNameMap.set(scalar, scalar.refName);
   }
@@ -42,9 +38,29 @@ export class PrimitiveRegistry {
   static getAll(): (typeof PrimitiveScalar)[] {
     return [...PrimitiveRegistry.#namePrimitiveMap.values()];
   }
+  /** The agent face `modelRef` declares, or null for anything that is not a registered primitive declaring one. */
+  static agentOf(modelRef: unknown): PrimitiveAgentFace | null {
+    if (!PrimitiveRegistry.#primitiveNameMap.has(modelRef as typeof PrimitiveScalar)) return null;
+    return (modelRef as typeof PrimitiveScalar).agent ?? null;
+  }
+}
+
+export interface PrimitiveJsonSchema {
+  [key: string]: unknown;
+}
+
+/**
+ * How an agent — an MCP client or the in-page one — sees a primitive whose stored shape is not the one a model
+ * should read or write: `schema` is what it is published as on both sides of a call, and `read` turns a stored or
+ * wire value into that shape. There is no `write`, because every argument and every input field already runs
+ * through `parseValue`; a primitive that accepts the agent's shape there has taken the write.
+ */
+export interface PrimitiveAgentFace<Value = unknown> {
+  schema: PrimitiveJsonSchema;
+  read(value: Value): unknown;
 }
 
-export type PrimitiveValue = string | number | boolean | Dayjs | Date | Uint8Array | null | undefined;
+export type PrimitiveValue = string | number | boolean | Dayjs | Date | Uint8Array | object | null | undefined;
 export class PrimitiveScalar {
   static refName: string;
   static [SERVER_VALUE]: unknown;
@@ -52,6 +68,10 @@ export class PrimitiveScalar {
   static [DEFAULT_VALUE]: unknown = null;
   static [PURIFIED_VALUE]: unknown = null;
   static [EXAMPLE_VALUE]: unknown = null;
+  /** The wire shape, for a primitive the built-in schema table cannot know. Absent, it is published as a string. */
+  static jsonSchema?: PrimitiveJsonSchema;
+  /** Absent, an agent sees the wire shape. See `PrimitiveAgentFace`. */
+  static agent?: PrimitiveAgentFace;
 
   static validate(value: PrimitiveValue): boolean {
     return true;

package/common/CodeTranscript.ts

@@ -179,6 +179,13 @@ export class CodeTranscript {
       case "question":
         this.#question = event.question;
         return this.#push({ kind: "question", id: event.question.questionId, question: event.question });
+      case "question_skipped":
+        return this.#push({
+          kind: "question",
+          id: event.question.questionId,
+          question: event.question,
+          rendered: `(${event.reason})`,
+        });
       case "question_resolved":
         if (this.#question?.questionId === event.questionId) this.#question = undefined;
         return this.#patch(event.questionId, (part) => {
@@ -197,8 +204,12 @@ export class CodeTranscript {
         return;
       case "compaction":
         this.#compacting = event.phase === "start";
-        if (event.phase === "end") this.#notice("info", `Compacted the conversation (${event.reason}).`);
-        return;
+        if (event.phase === "start") return;
+
+        if ((event.error || event.aborted) && event.reason === "manual") return;
+        if (event.error) return this.#notice("warning", event.error);
+        if (event.aborted) return this.#notice("info", "Compaction cancelled.");
+        return this.#notice("info", `Compacted the conversation (${event.reason}).`);
       case "retry":
         return this.#notice(
           "warning",

package/common/codeAgentWire.ts

@@ -190,10 +190,19 @@ export type CodeAgentEventBody =
     }
   | { type: "question"; question: CodeAgentQuestion }
   | { type: "question_resolved"; questionId: string; answer: CodeAgentAnswer; rendered: string }
+  /** A question nobody could be asked — no host attached — answered with nothing; the model continued on its own. */
+  | { type: "question_skipped"; question: CodeAgentQuestion; reason: "no-host" }
   | { type: "approval"; request: CodeAgentApprovalRequest }
   | { type: "approval_resolved"; approvalId: string; approved: boolean }
   | { type: "context"; used: number; max: number | undefined }
-  | { type: "compaction"; phase: "start" | "end"; reason: "manual" | "threshold" | "overflow" }
+  /** An `end` carrying neither `error` nor `aborted` is the only one that compacted anything. */
+  | {
+      type: "compaction";
+      phase: "start" | "end";
+      reason: "manual" | "threshold" | "overflow";
+      error?: string;
+      aborted?: boolean;
+    }
   | { type: "retry"; attempt: number; maxAttempts: number; delayMs: number; message: string }
   | { type: "queue"; steering: string[]; followUp: string[] }
   | { type: "notice"; level: "info" | "warning" | "error"; message: string }
@@ -255,6 +264,7 @@ export const codeAgentEventPersistence: { [key in CodeAgentEventType]: "live" |
   tool_end: "persist",
   question: "persist",
   question_resolved: "persist",
+  question_skipped: "persist",
   approval: "live",
   approval_resolved: "live",
   context: "live",
@@ -393,14 +403,18 @@ export const codeAgentEventLabel = (event: CodeAgentEventBody): string => {
       return `? ${event.question.prompt}`;
     case "question_resolved":
       return `= ${event.rendered}`;
+    case "question_skipped":
+      return `? ${event.question.prompt} (skipped: ${event.reason})`;
     case "approval":
       return `approve? ${event.request.summary}`;
     case "approval_resolved":
       return event.approved ? "approved" : "denied";
     case "context":
       return `context ${event.used}${event.max ? `/${event.max}` : ""}`;
-    case "compaction":
-      return `compaction ${event.phase} (${event.reason})`;
+    case "compaction": {
+      const outcome = event.error ? ` — ${event.error}` : event.aborted ? " — cancelled" : "";
+      return `compaction ${event.phase} (${event.reason})${outcome}`;
+    }
     case "retry":
       return `retry ${event.attempt}/${event.maxAttempts} in ${event.delayMs}ms — ${event.message}`;
     case "queue":

package/constant/getDefault.ts

@@ -5,7 +5,10 @@ import type { DefaultOf } from "./types";
 export interface DefaultPlan {
   /** Fields whose default is a value that can be shared: a primitive, `null`, or the field's own literal. */
   shared: Record<string, unknown>;
-  /** Fields that have to be produced per call — a thunk, a fresh array, or a nested scalar record. */
+  /**
+   * Fields that have to be produced per call — a thunk, a fresh array, a nested scalar record, or a primitive's
+   * structured default.
+   */
   perCall: Map<string, () => unknown>;
 }
 
@@ -49,7 +52,23 @@ const buildPlan = (fieldObj: FieldObject): DefaultPlan => {
     else if (field.isClass) {
       if (field.isScalar) perCall.set(key, () => getDefault(field.modelRef[FIELD_META]));
       else shared[key] = null;
-    } else shared[key] = (field.modelRef as unknown as typeof PrimitiveScalar)[DEFAULT_VALUE];
+    } else {
+      const primitiveDefault = (field.modelRef as unknown as typeof PrimitiveScalar)[DEFAULT_VALUE];
+      if (isStructured(primitiveDefault)) perCall.set(key, () => structuredClone(primitiveDefault));
+      else shared[key] = primitiveDefault;
+    }
   }
   return { shared, perCall };
 };
+
+const isStructured = (value: unknown): value is object =>
+  typeof value === "object" &&
+  value !== null &&
+  (Array.isArray(value) || Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+
+/**
+ * A primitive's value is never an identity, so a plain object or array — an empty editor document as a primitive's
+ * `DEFAULT_VALUE` — is copied for each use, for the reason an array field default is. An instance (a `Dayjs`, a
+ * `Uint8Array`) is handed back as is: its own API is how it changes, and a structured copy would drop its prototype.
+ */
+export const freshPrimitiveValue = <T>(value: T): T => (isStructured(value) ? structuredClone(value) : value);

package/constant/mask.ts

@@ -1,4 +1,4 @@
-import { FIELD_META } from "akanjs/base";
+import { type Cls, FIELD_META, getNonArrayModel, type PrimitiveAgentFace, PrimitiveRegistry } from "akanjs/base";
 
 /**
  * A model as masking reads it — the constructor, for the field metadata it carries at runtime.
@@ -14,7 +14,10 @@ export interface MaskModel {
 interface MaskField {
   fieldType?: string;
   isClass?: boolean;
+  isMap?: boolean;
   modelRef?: MaskModel;
+  of?: unknown;
+  arrDepth?: number;
   visual?: boolean;
 }
 
@@ -40,7 +43,8 @@ export const leakingFieldsOf = (model: MaskModel, value: Record<string, unknown>
 /**
  * Strips what a model marks `hidden`, `secret`, or `visual`, by the model the caller names rather than by the one
  * the value happens to still carry. The first two are secrecy and the third is cost, but the answer is the same
- * one — leave the field out — and this is the only place every AI-facing read already passes through.
+ * one — leave the field out — and this is the only place every AI-facing read already passes through. For the same
+ * reason it is where a primitive declaring an agent face is read into that face (`agentRead`).
  *
  * That distinction is the whole point. A check that reads the class off the value can only mask what arrives as an
  * instance, so a `{ ...doc }` spread, a `toJSON()`, an `immerify()`, or a round-trip through `JSON.stringify` reaches
@@ -61,11 +65,39 @@ export const mask = (model: MaskModel, value: unknown): unknown => {
   const masked: Record<string, unknown> = {};
   for (const [key, field] of Object.entries(fields)) {
     if (field.fieldType === "hidden" || field.fieldType === "secret" || field.visual || !(key in source)) continue;
-    masked[key] = field.isClass && field.modelRef ? mask(field.modelRef, source[key]) : source[key];
+    masked[key] = maskField(field, source[key]);
   }
   return masked;
 };
 
+/**
+ * What an agent reads of a primitive value: the primitive's `agent.read` when it declares an agent face, the value
+ * untouched otherwise. The read is applied through `arrDepth` levels of array, the way a field declares them.
+ */
+export const agentRead = (modelRef: unknown, value: unknown, arrDepth = 0): unknown => {
+  const face = PrimitiveRegistry.agentOf(modelRef);
+  return face ? readThrough(face, value, arrDepth) : value;
+};
+
+const readThrough = (face: PrimitiveAgentFace, value: unknown, arrDepth: number): unknown => {
+  if (value === null || value === undefined) return value;
+  if (arrDepth > 0 && Array.isArray(value)) return value.map((item) => readThrough(face, item, arrDepth - 1));
+  return face.read(value);
+};
+
+const maskField = (field: MaskField, value: unknown): unknown => {
+  if (field.isClass && field.modelRef) return mask(field.modelRef, value);
+  if (field.isMap) return maskMapValues(field.of, value);
+  return agentRead(field.modelRef, value, field.arrDepth ?? 0);
+};
+
+const maskMapValues = (of: unknown, value: unknown): unknown => {
+  const [valueRef, arrDepth] = getNonArrayModel(of as Cls);
+  if (!PrimitiveRegistry.agentOf(valueRef) || value === null || typeof value !== "object") return value;
+  const entries = value instanceof Map ? [...value.entries()] : Object.entries(value);
+  return Object.fromEntries(entries.map(([key, item]) => [key, agentRead(valueRef, item, arrDepth)]));
+};
+
 /**
  * Drops what a model marks `hidden` or `secret`, and nothing else.
  *

package/dictionary/agent.dictionary.ts

@@ -29,4 +29,13 @@ export const agentDictionary = serviceDictionary(["en", "ko"])
       "{provider} refused this turn with status {status}. Reason: {reason}",
       "{provider}가 이번 턴을 거절했습니다 (status {status}). 사유: {reason}",
     ],
+    
+    contextOverflow: [
+      "This conversation no longer fits the model's context window at {provider}. Use /compact to summarize it, or /new to start over",
+      "대화가 {provider} 모델의 컨텍스트 창을 넘었습니다. /compact로 요약하거나 /new로 새로 시작할 수 있습니다.",
+    ],
+    quotaExceeded: [
+      "The agent's usage limit for this account has been reached",
+      "이 계정의 에이전트 사용 한도에 도달했습니다.",
+    ],
   });

package/dictionary/base.dictionary.ts

@@ -109,6 +109,11 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
     agentToolRunning: ["Running", "실행 중"],
     agentToolResult: ["Show what this tool returned", "이 툴이 반환한 값 보기"],
     agentTokens: ["~{count} tokens", "약 {count} 토큰"],
+    agentTokensOf: ["~{count} / {limit} tokens", "약 {count} / {limit} 토큰"],
+    agentCompactsAt: [
+      "The conversation summarizes itself past {limit} tokens",
+      "{limit} 토큰을 넘으면 대화를 스스로 요약합니다",
+    ],
     agentSummarizing: ["Summarizing the conversation…", "대화를 요약하는 중…"],
     agentContinue: ["This is taking a while. Keep going?", "시간이 걸리고 있습니다. 계속할까요?"],
     agentKeepGoing: ["Keep going", "계속하기"],

package/document/database.ts

@@ -1,7 +1,7 @@
 import type { MergedValues, PromiseOrObject } from "akanjs/base";
 import { Logger } from "akanjs/common";
 import type { DocumentModel, QueryOf } from "akanjs/constant";
-import type { CacheAdaptor, CacheSetOptions } from "akanjs/service";
+import type { CacheAdaptor, CacheSetOptions, CacheValue } from "akanjs/service";
 import type { DataLoader } from "./dataLoader";
 import type { DocumentUpdateInput } from "./documentQuery";
 import type { ExtractQuery, ExtractSort, FilterInstance } from "./filterMeta";
@@ -16,15 +16,51 @@ export class CacheDatabase<T = unknown> {
   ) {
     this.logger = new Logger(`${refName}Cache`);
   }
-  async set(topic: string, key: string, value: string | number | Buffer, option: CacheSetOptions = {}) {
+  async set(topic: string, key: string, value: CacheValue, option: CacheSetOptions = {}) {
     await this.cache.set(this.refName, `${topic}:${key}`, value, option);
   }
-  async get<T extends string | number | Buffer>(topic: string, key: string): Promise<T | undefined> {
+  async get<T extends CacheValue = CacheValue>(topic: string, key: string): Promise<T | undefined> {
     return await this.cache.get<T>(this.refName, `${topic}:${key}`);
   }
   async delete(topic: string, key: string) {
     await this.cache.delete(this.refName, `${topic}:${key}`);
   }
+  async getDel<T extends CacheValue = CacheValue>(topic: string, key: string): Promise<T | undefined> {
+    return await this.cache.getDel<T>(this.refName, `${topic}:${key}`);
+  }
+  async setIfAbsent(topic: string, key: string, value: CacheValue, option: CacheSetOptions = {}) {
+    return await this.cache.setIfAbsent(this.refName, `${topic}:${key}`, value, option);
+  }
+  async incr(topic: string, key: string, by = 1, option: CacheSetOptions = {}) {
+    return await this.cache.incr(this.refName, `${topic}:${key}`, by, option);
+  }
+  async hset(topic: string, key: string, subKey: string, value: CacheValue, option: CacheSetOptions = {}) {
+    await this.cache.hset(this.refName, `${topic}:${key}`, subKey, value, option);
+  }
+  async hget<T extends CacheValue = CacheValue>(topic: string, key: string, subKey: string): Promise<T | undefined> {
+    return await this.cache.hget<T>(this.refName, `${topic}:${key}`, subKey);
+  }
+  async hdelete(topic: string, key: string, subKey: string) {
+    await this.cache.hdelete(this.refName, `${topic}:${key}`, subKey);
+  }
+  async hkeys(topic: string, key: string) {
+    return await this.cache.hkeys(this.refName, `${topic}:${key}`);
+  }
+  async hentries<T extends CacheValue = CacheValue>(topic: string, key: string): Promise<[string, T][]> {
+    return await this.cache.hentries<T>(this.refName, `${topic}:${key}`);
+  }
+  async hclear(topic: string, key: string) {
+    await this.cache.hclear(this.refName, `${topic}:${key}`);
+  }
+  async hgetDel<T extends CacheValue = CacheValue>(topic: string, key: string, subKey: string): Promise<T | undefined> {
+    return await this.cache.hgetDel<T>(this.refName, `${topic}:${key}`, subKey);
+  }
+  async hsetIfAbsent(topic: string, key: string, subKey: string, value: CacheValue, option: CacheSetOptions = {}) {
+    return await this.cache.hsetIfAbsent(this.refName, `${topic}:${key}`, subKey, value, option);
+  }
+  async hincr(topic: string, key: string, subKey: string, by = 1, option: CacheSetOptions = {}) {
+    return await this.cache.hincr(this.refName, `${topic}:${key}`, subKey, by, option);
+  }
 }
 /**
  * What `update<Filter>` returns. The patch cannot be a trailing parameter — a filter's own args may be optional,

package/document/queryEvaluator.ts

@@ -217,7 +217,12 @@ export class DocumentQueryEvaluator {
         return this.#has(read, operand);
       case "contains":
         
-        return read.value !== null && String(read.value).toLowerCase().includes(String(operand).toLowerCase());
+        return (
+          read.value !== null &&
+          DocumentQueryEvaluator.#foldAscii(String(read.value)).includes(
+            DocumentQueryEvaluator.#foldAscii(String(operand)),
+          )
+        );
     }
   }
 
@@ -313,6 +318,10 @@ export class DocumentQueryEvaluator {
     return leftPoints.length === rightPoints.length ? 0 : leftPoints.length < rightPoints.length ? -1 : 1;
   }
 
+  static #foldAscii(text: string) {
+    return text.replace(/[A-Z]/g, (char) => char.toLowerCase());
+  }
+
   static #isNode(value: unknown): value is DocumentQueryNode {
     return !!value && typeof value === "object" && "kind" in value;
   }

package/index.ts

@@ -229,9 +229,18 @@ export interface AkanApiConfig {
   websocketPrefix: string;
 }
 
+export interface AkanDatabaseConfig {
+  /**
+   * The modes this app's build can run in. `akan build` bundles the drivers of each, the image lets a deployment
+   * pick one of them with `AKAN_DATABASE_MODE` and no other, and `akan start` runs the first unless the shell names
+   * another. A deployment of a build carrying several has to name one.
+   */
+  modes: DatabaseMode[];
+}
+
 export interface AppConfigResult {
   docker: DockerConfig;
-  defaultDatabaseMode: DatabaseMode;
+  database: AkanDatabaseConfig;
   /**
    * Where this app mounts its endpoints. Declared here rather than only in `main.ts` because the value is baked
    * into every client bundle: a prebuilt CSR shell or a mobile bundle never reaches the server that would tell

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0001.log

@@ -0,0 +1,44 @@
+[crossTest] 58035 - 09/25/2026, 16:51:41 PM VERBOSE  crossTest is serving on port 47811 +114ms
+[crossTest] 58035 - 09/25/2026, 16:51:41 PM VERBOSE  🚀 crossTest is running on port 47811 +117ms
+[scheduler] 58035 - 09/25/2026, 16:52:41 PM   DEBUG  Schedule interval searchIndexRetry finished 2ms +60110ms
+[scheduler] 58035 - 09/25/2026, 16:53:41 PM   DEBUG  Schedule interval searchIndexRetry finished 1ms +120110ms
+[crossTest] 58035 - 09/25/2026, 16:53:57 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +135947ms
+[crossTest] 58035 - 09/25/2026, 16:53:57 PM    INFO  Shutting down gracefully... +135947ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Running destroy internals... +135947ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy internals in 1ms +135948ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroying services... +135948ms
+[BaseService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  base service destroying... +135948ms
+[AgentService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  agent service destroying... +135948ms
+[CrossItemService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItem service destroying... +135948ms
+[BaseService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  base service destroyed in 0ms +135948ms
+[AgentService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  agent service destroyed in 0ms +135948ms
+[CrossItemService] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItem service destroyed in 0ms +135948ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy services in 0ms +135948ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroying adaptors... +135948ms
+[crossItemModel] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItemModel adaptor destroying... +135948ms
+[crossItemModel] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  crossItemModel adaptor destroyed in 0ms +135948ms
+[sqliteDatabase] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  sqliteDatabase adaptor destroying... +135948ms
+[sqliteDatabase] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  sqliteDatabase adaptor destroyed in 5ms +135953ms
+[bullQueue] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  bullQueue adaptor destroying... +135953ms
+[scheduler] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  scheduler adaptor destroying... +135953ms
+[wsRedis] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  wsRedis adaptor destroying... +135953ms
+[scheduler] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  scheduler adaptor destroyed in 0ms +135953ms
+[bullQueue] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  bullQueue adaptor destroyed in 0ms +135953ms
+[wsRedis] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  WebSocket Redis adaptor destroyed +135957ms
+[wsRedis] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  wsRedis adaptor destroyed in 4ms +135957ms
+[redisCache] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  redisCache adaptor destroying... +135957ms
+[blobStorage] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  blobStorage adaptor destroying... +135957ms
+[consoleLogger] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  consoleLogger adaptor destroying... +135957ms
+[jsonCompressor] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  jsonCompressor adaptor destroying... +135957ms
+[openaiLlm] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  openaiLlm adaptor destroying... +135957ms
+[llmAdaptorRole] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  llmAdaptorRole adaptor destroying... +135957ms
+[redisCache] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  redisCache adaptor destroyed in 0ms +135957ms
+[blobStorage] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  blobStorage adaptor destroyed in 0ms +135957ms
+[consoleLogger] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +135957ms
+[jsonCompressor] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +135957ms
+[openaiLlm] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  openaiLlm adaptor destroyed in 0ms +135957ms
+[llmAdaptorRole] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  llmAdaptorRole adaptor destroyed in 0ms +135957ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy adaptors in 9ms +135957ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroying uses... +135957ms
+[DiLifecycle] 58035 - 09/25/2026, 16:53:57 PM VERBOSE  Destroy uses in 0ms +135957ms
+[crossTest] 58035 - 09/25/2026, 16:53:57 PM    INFO  Shutdown completed successfully in 10ms +135957ms

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0002.log

@@ -0,0 +1,42 @@
+[crossTest] 59872 - 09/25/2026, 16:53:58 PM VERBOSE  crossTest is serving on port 47811 +109ms
+[crossTest] 59872 - 09/25/2026, 16:53:58 PM VERBOSE  🚀 crossTest is running on port 47811 +112ms
+[crossTest] 59872 - 09/25/2026, 16:54:10 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +11999ms
+[crossTest] 59872 - 09/25/2026, 16:54:10 PM    INFO  Shutting down gracefully... +11999ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Running destroy internals... +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy internals in 0ms +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroying services... +12000ms
+[BaseService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  base service destroying... +12000ms
+[AgentService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  agent service destroying... +12000ms
+[CrossItemService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItem service destroying... +12000ms
+[BaseService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  base service destroyed in 0ms +12000ms
+[AgentService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  agent service destroyed in 0ms +12000ms
+[CrossItemService] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItem service destroyed in 0ms +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy services in 0ms +12000ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroying adaptors... +12000ms
+[crossItemModel] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItemModel adaptor destroying... +12000ms
+[crossItemModel] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  crossItemModel adaptor destroyed in 0ms +12000ms
+[sqliteDatabase] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  sqliteDatabase adaptor destroying... +12000ms
+[sqliteDatabase] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  sqliteDatabase adaptor destroyed in 5ms +12005ms
+[bullQueue] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  bullQueue adaptor destroying... +12005ms
+[scheduler] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  scheduler adaptor destroying... +12005ms
+[wsRedis] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  wsRedis adaptor destroying... +12005ms
+[scheduler] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  scheduler adaptor destroyed in 1ms +12006ms
+[bullQueue] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  bullQueue adaptor destroyed in 1ms +12006ms
+[wsRedis] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  WebSocket Redis adaptor destroyed +12010ms
+[wsRedis] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  wsRedis adaptor destroyed in 5ms +12010ms
+[redisCache] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  redisCache adaptor destroying... +12010ms
+[blobStorage] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  blobStorage adaptor destroying... +12010ms
+[consoleLogger] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  consoleLogger adaptor destroying... +12010ms
+[jsonCompressor] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  jsonCompressor adaptor destroying... +12010ms
+[openaiLlm] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  openaiLlm adaptor destroying... +12010ms
+[llmAdaptorRole] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  llmAdaptorRole adaptor destroying... +12010ms
+[redisCache] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  redisCache adaptor destroyed in 0ms +12010ms
+[blobStorage] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  blobStorage adaptor destroyed in 0ms +12010ms
+[consoleLogger] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +12010ms
+[jsonCompressor] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +12010ms
+[openaiLlm] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  openaiLlm adaptor destroyed in 0ms +12010ms
+[llmAdaptorRole] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  llmAdaptorRole adaptor destroyed in 0ms +12010ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy adaptors in 10ms +12010ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroying uses... +12010ms
+[DiLifecycle] 59872 - 09/25/2026, 16:54:10 PM VERBOSE  Destroy uses in 0ms +12010ms
+[crossTest] 59872 - 09/25/2026, 16:54:10 PM    INFO  Shutdown completed successfully in 11ms +12010ms

package/local/apps/crossTest/runtime/logs/crossTest-testing-local-2026-09-25-all-0003.log

@@ -0,0 +1,43 @@
+[crossTest] 60280 - 09/25/2026, 16:54:26 PM VERBOSE  crossTest is serving on port 47811 +111ms
+[crossTest] 60280 - 09/25/2026, 16:54:26 PM VERBOSE  🚀 crossTest is running on port 47811 +114ms
+[scheduler] 60280 - 09/25/2026, 16:55:26 PM   DEBUG  Schedule interval searchIndexRetry finished 3ms +60108ms
+[crossTest] 60280 - 09/25/2026, 16:56:12 PM   DEBUG  Received SIGTERM, starting graceful shutdown... +105905ms
+[crossTest] 60280 - 09/25/2026, 16:56:12 PM    INFO  Shutting down gracefully... +105905ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Running destroy internals... +105905ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy internals in 0ms +105905ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroying services... +105905ms
+[BaseService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  base service destroying... +105906ms
+[AgentService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  agent service destroying... +105906ms
+[CrossItemService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItem service destroying... +105906ms
+[BaseService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  base service destroyed in 0ms +105906ms
+[AgentService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  agent service destroyed in 0ms +105906ms
+[CrossItemService] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItem service destroyed in 0ms +105906ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy services in 1ms +105906ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroying adaptors... +105906ms
+[crossItemModel] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItemModel adaptor destroying... +105906ms
+[crossItemModel] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  crossItemModel adaptor destroyed in 0ms +105906ms
+[sqliteDatabase] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  sqliteDatabase adaptor destroying... +105906ms
+[sqliteDatabase] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  sqliteDatabase adaptor destroyed in 4ms +105910ms
+[bullQueue] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  bullQueue adaptor destroying... +105910ms
+[scheduler] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  scheduler adaptor destroying... +105910ms
+[wsRedis] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  wsRedis adaptor destroying... +105910ms
+[scheduler] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  scheduler adaptor destroyed in 1ms +105911ms
+[bullQueue] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  bullQueue adaptor destroyed in 1ms +105911ms
+[wsRedis] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  WebSocket Redis adaptor destroyed +105912ms
+[wsRedis] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  wsRedis adaptor destroyed in 2ms +105912ms
+[redisCache] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  redisCache adaptor destroying... +105912ms
+[blobStorage] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  blobStorage adaptor destroying... +105912ms
+[consoleLogger] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  consoleLogger adaptor destroying... +105912ms
+[jsonCompressor] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  jsonCompressor adaptor destroying... +105912ms
+[openaiLlm] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  openaiLlm adaptor destroying... +105912ms
+[llmAdaptorRole] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  llmAdaptorRole adaptor destroying... +105912ms
+[redisCache] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  redisCache adaptor destroyed in 0ms +105912ms
+[blobStorage] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  blobStorage adaptor destroyed in 0ms +105912ms
+[consoleLogger] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  consoleLogger adaptor destroyed in 0ms +105912ms
+[jsonCompressor] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  jsonCompressor adaptor destroyed in 0ms +105912ms
+[openaiLlm] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  openaiLlm adaptor destroyed in 1ms +105913ms
+[llmAdaptorRole] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  llmAdaptorRole adaptor destroyed in 1ms +105913ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy adaptors in 7ms +105913ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroying uses... +105913ms
+[DiLifecycle] 60280 - 09/25/2026, 16:56:12 PM VERBOSE  Destroy uses in 0ms +105913ms
+[crossTest] 60280 - 09/25/2026, 16:56:12 PM    INFO  Shutdown completed successfully in 8ms +105913ms