akanjs 3.0.2 → 3.1.0-rc.0

package/types/server/routeElementComposer.d.ts

@@ -1,6 +1,13 @@
 import type { Head, LayoutFallbackRoute, PathRoute, ResolvedHead, RouteRender } from "akanjs/client";
 import { type ReactElement, type ReactNode } from "react";
 import { type AkanRouteSegmentState } from "./routeState.d.ts";
+/** How a render reached after the layouts streamed answers `router.notFound()` — in place, since its parents are out. */
+export interface RouteNotFoundInPlace {
+    pathname: string;
+    /** Rendered when no layout above the thrower declares `.notFound()`. */
+    systemFallback: () => ReactNode;
+    onNotFound: () => void;
+}
 export declare class RouteElementComposer {
     #private;
     static resolveSsrFramePathRoute({ pathRoute, basePath, }: {
@@ -11,18 +18,25 @@ export declare class RouteElementComposer {
         route: PathRoute | LayoutFallbackRoute;
         basePath?: string | null;
     }): Promise<import("akanjs/client").PageState>;
-    static compose({ pathRoute, params, searchParams, navKey, }: {
+    static compose({ pathRoute, params, searchParams, navKey, notFound, }: {
         pathRoute: PathRoute;
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
         navKey?: string;
+        notFound?: RouteNotFoundInPlace;
     }): ReactNode;
-    static composeSuffix({ pathRoute, params, searchParams, patchStartIndex, navKey, }: {
+    static checkArgs({ pathRoute, params, searchParams, }: {
+        pathRoute: PathRoute;
+        params: Record<string, string>;
+        searchParams: Record<string, string | string[]>;
+    }): Promise<void>;
+    static composeSuffix({ pathRoute, params, searchParams, patchStartIndex, navKey, notFound, }: {
         pathRoute: PathRoute;
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
         patchStartIndex: number;
         navKey?: string;
+        notFound?: RouteNotFoundInPlace;
     }): ReactNode | null;
     static resolveSuffixLoadings(pathRoute: PathRoute, patchStartIndex: number): Promise<void>;
     static resolveHead({ pathRoute, params, searchParams, }: {
@@ -44,17 +58,23 @@ export declare class RouteElementComposer {
         error?: unknown;
         digest?: string;
     }): Promise<ReactNode | null>;
-    static composeRenders({ renders, segments, params, searchParams, navKey, }: {
+    static composeRenders({ renders, owners, segments, params, searchParams, navKey, notFound, }: {
         renders: RouteRender[];
+        /** Layouts above `renders` that this element leaves out (a patch) but whose `.notFound()` still applies. */
+        owners?: RouteRender[];
         segments?: AkanRouteSegmentState[];
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
         navKey?: string;
+        notFound?: RouteNotFoundInPlace;
     }): ReactNode;
-    static AsyncRender: ({ routeRender, children, params, searchParams, }: {
+    static AsyncRender: ({ routeRender, children, params, searchParams, notFound, }: {
         routeRender: RouteRender;
         children: ReactNode;
         params: Record<string, string>;
         searchParams: Record<string, string | string[]>;
+        notFound?: RouteNotFoundInPlace & {
+            owners: RouteRender[];
+        };
     }) => Promise<ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | (string | number | bigint | boolean | import("react").ReactPortal | ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined)>;
 }

package/types/server/routeState.d.ts

@@ -23,6 +23,8 @@ export interface AkanRouterStateV1 {
     href: string;
     routeId: string;
     segments: AkanRouteSegmentState[];
+    /** The route's `.config({ transition })`, which the browser plays as a view transition on the way in and out. */
+    transition?: string;
 }
 export type AkanHeadSnapshotTag = "title" | "meta" | "link";
 export interface AkanHeadSnapshotNode {
@@ -68,10 +70,11 @@ export declare function readAkanRouterStateResponseHeader(headers: Headers): Aka
 export declare function encodeAkanRscPatchSegmentPath(segmentPath: string[]): string;
 export declare function decodeAkanRscPatchSegmentPath(value: string | null | undefined): string[] | null;
 export declare function readAkanRscPatchMetadataResponseHeaders(headers: Headers): AkanRscPatchMetadata | null;
-export declare function createAkanRouterState({ pathRoute, href, buildId, }: {
+export declare function createAkanRouterState({ pathRoute, href, buildId, transition, }: {
     pathRoute: PathRoute;
     href: string;
     buildId?: number;
+    transition?: string;
 }): AkanRouterStateV1;
 export declare function createAkanRouteSegments(pathRoute: PathRoute): AkanRouteSegmentState[];
 export declare function createAkanSegmentOutletKey(segmentPath: string[], segmentIndex: number): string | null;

package/types/server/routing/roomReplay.d.ts

@@ -0,0 +1,24 @@
+import type { WebsocketPublishData, WebsocketRoomCursor } from "akanjs/signal";
+export interface RoomReplayOptions {
+    /** Whether this process sees every publish to a room, so a run of sequence numbers it holds has no hole. */
+    vouches: boolean;
+    /** Frames kept per room. */
+    depth?: number;
+    /** How long a room nobody subscribes to here keeps numbering and keeping its frames. */
+    retainMs?: number;
+    /** Rooms tracked at once; the least recently watched goes first. */
+    rooms?: number;
+}
+export declare class RoomReplay {
+    #private;
+    readonly vouches: boolean;
+    constructor({ vouches, depth, retainMs, rooms }: RoomReplayOptions);
+    /** A socket subscribed here: the room is numbered from now on, and for `retainMs` after its last subscriber left. */
+    watch(roomId: string, now?: number): void;
+    /** The frame to send for one publish; numbered, and kept, while the room is watched. */
+    frameOf(publishData: WebsocketPublishData, subscribed: boolean, now?: number): string;
+    /** Where the room's numbering stands here, for a subscribe's ack; `null` for a room nobody watches. */
+    cursor(roomId: string): WebsocketRoomCursor | null;
+    /** The frames numbered after the cursor, or `null` when this process cannot tell whether that is all of them. */
+    since(roomId: string, { epoch, seq }: WebsocketRoomCursor): string[] | null;
+}

package/types/server/rscWorkerHost.d.ts

@@ -4,7 +4,7 @@ import type { AkanMetricsReport } from "akanjs/service";
 import type { PagePromptEntry, PagePromptRun, PagePromptRunInput } from "../signal/mcp/pagePrompt.d.ts";
 import type { ClientManifest } from "./artifact.d.ts";
 import type { RouteCacheInvalidation, RouteCacheRenderState } from "./cachePolicy.d.ts";
-import type { RscTraceMetadata, SsrLateRedirect } from "./ssrTypes.d.ts";
+import type { RscTraceMetadata, SsrLateControl } from "./ssrTypes.d.ts";
 import type { BaseBuildArtifact, CssAsset } from "./types.d.ts";
 export interface RscPending {
     onChunk: (data: Uint8Array) => void;
@@ -19,6 +19,7 @@ export interface RscPending {
     onCacheState?: (state: RouteCacheRenderState) => void;
     onRedirect?: (location: string, method: RscRedirectMethod, status: RscRedirectStatus) => void;
     onLateRedirect?: (location: string, method: RscRedirectMethod, status: RscRedirectStatus) => void;
+    onLateNotFound?: () => void;
     onNotFound?: () => void;
 }
 export type RscRedirectMethod = "replace" | "push";
@@ -35,7 +36,7 @@ export type RscRenderResult = {
     theme?: AkanTheme;
     status?: number;
     trace?: RscTraceMetadata;
-    lateControl: Promise<SsrLateRedirect | null>;
+    lateControl: Promise<SsrLateControl | null>;
     cacheState: Promise<RouteCacheRenderState>;
     cancel: (reason?: unknown) => void;
 } | {
@@ -93,6 +94,8 @@ export declare class RscWorker {
     }): Promise<RscRenderResult>;
     listPagePrompts(): Promise<PagePromptEntry[]>;
     runPagePrompt(input: PagePromptRunInput): Promise<PagePromptRun>;
+    /** The root layout's `.manifest()` for `basePath`, in the browser's keys; `null` when it declares none. */
+    webManifest(basePath: string | null): Promise<unknown>;
     invalidateRouteResultCache(invalidation?: string | RouteCacheInvalidation): void;
     kill(): void;
     setLogLevel(minSev: number | null): void;

package/types/server/sitemap.d.ts

@@ -10,4 +10,6 @@ export declare function createSitemapXml(urls: string[]): string;
 export declare function createDefaultSitemapXml({ origin, basePath, entries, i18n }: DefaultSitemapOptions): string;
 export declare function createDefaultSitemapUrls({ origin, basePath, entries, i18n }: DefaultSitemapOptions): string[];
 export declare function isSitemapPath(pathname: string, basePaths: readonly string[]): boolean;
+/** The basePath a `/manifest.webmanifest` request asks for: by a visible prefix, else by the request's basePath. */
+export declare function getWebManifestBasePath(pathname: string, basePaths: readonly string[], headerBasePath?: string | null): string | null | undefined;
 export declare function getSitemapBasePath(pathname: string, basePaths: readonly string[], headerBasePath?: string | null): string | null | undefined;

package/types/server/ssrFromRscRenderer.d.ts

@@ -1,6 +1,6 @@
 import { type AkanRequestStore } from "akanjs/fetch";
 import type { ReactNode } from "react";
-import type { SsrChunkRegistryStats, SsrDocumentOptions, SsrFromRscInput, SsrLateRedirect } from "./ssrTypes.d.ts";
+import type { SsrChunkRegistryStats, SsrDocumentOptions, SsrFromRscInput, SsrLateControl, SsrLateRedirect } from "./ssrTypes.d.ts";
 export declare class SsrChunkRegistry<T> {
     #private;
     readonly maxEntries: number;
@@ -19,12 +19,12 @@ export declare function sanitizeFlightForSsrStream(stream: ReadableStream<Uint8A
 export declare class ExpectedLateRedirectStderrSuppressor {
     #private;
     private constructor();
-    static start(lateControl?: Promise<SsrLateRedirect | null>): ExpectedLateRedirectStderrSuppressor | null;
+    static start(lateControl?: Promise<SsrLateControl | null>): ExpectedLateRedirectStderrSuppressor | null;
     stop(): void;
 }
 export declare function interleaveRscScriptsWithHtml(htmlStream: ReadableStream<Uint8Array>, rscClientStream: ReadableStream<Uint8Array>, options?: {
     bootstrapModuleScripts?: string;
-    lateControl?: Promise<SsrLateRedirect | null>;
+    lateControl?: Promise<SsrLateControl | null>;
     maxPendingRscScripts?: number;
     onPendingRscScriptsSize?: (size: number) => void;
     onComplete?: () => void;

package/types/server/ssrTypes.d.ts

@@ -24,6 +24,9 @@ export interface SsrLateRedirect {
     method: "replace" | "push";
     status: 303 | 307 | 308;
 }
+export type SsrLateControl = SsrLateRedirect | {
+    type: "not-found";
+};
 export interface RscTraceMetadata {
     navId?: string;
     pathname: string;
@@ -53,7 +56,7 @@ export interface SsrFromRscInput {
     importmap?: Record<string, string>;
     theme?: AkanTheme;
     injectThemeInitScript?: boolean;
-    lateControl?: Promise<SsrLateRedirect | null>;
+    lateControl?: Promise<SsrLateControl | null>;
     onCancel?: (reason?: unknown) => void;
     /** Buffers until `stream.allReady` (`pageConfig.ssr: "block"`); `AKAN_SSR_WAIT_FOR_ALL_READY=1` forces it globally. */
     waitForAllReady?: boolean;

package/types/server/systemPageDocument.d.ts

@@ -35,6 +35,8 @@ export declare const SYSTEM_PAGE_STATUS_COPY: {
     };
 };
 export declare const SYSTEM_PAGE_STYLE = "\n:root { color-scheme: dark; --akan-primary: #ff493b; --akan-secondary: #2b2e33; --akan-accent: #d1a23b; --akan-foreground: #ffffff; --akan-background: #1a1a1a; --akan-error: #f02020; }\nbody { margin: 0; min-height: 100vh; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif; background: var(--akan-background); color: var(--akan-foreground); }\na { color: inherit; }\n.akan-system-page { min-height: 100vh; display: grid; place-items: center; padding: 32px 18px; box-sizing: border-box; background: radial-gradient(circle at top left, rgba(255, 73, 59, 0.16), transparent 34%), linear-gradient(135deg, var(--akan-background), #111); }\n.akan-system-card { width: min(720px, 100%); border: 1px solid rgba(255, 255, 255, 0.12); border-radius: 32px; background: linear-gradient(145deg, rgba(42, 42, 42, 0.96), rgba(43, 46, 51, 0.78)); box-shadow: 0 24px 80px rgba(0, 0, 0, 0.36); padding: clamp(28px, 6vw, 56px); }\n.akan-system-status { margin: 0 0 18px; font-weight: 800; font-size: clamp(4rem, 18vw, 8rem); line-height: 0.85; letter-spacing: -0.08em; color: var(--akan-primary); }\n.akan-system-eyebrow { margin: 0 0 10px; color: var(--akan-accent); font-size: 0.78rem; font-weight: 800; letter-spacing: 0.18em; text-transform: uppercase; }\n.akan-system-title { margin: 0; max-width: 12ch; font-size: clamp(2rem, 7vw, 4rem); line-height: 0.95; letter-spacing: -0.055em; color: var(--akan-foreground); }\n.akan-system-description { margin: 22px 0 0; max-width: 56ch; color: rgba(255, 255, 255, 0.76); font-size: 1.05rem; line-height: 1.75; }\n.akan-system-path { margin: 22px 0 0; overflow-wrap: anywhere; border: 1px solid rgba(255, 255, 255, 0.1); border-radius: 16px; background: rgba(26, 26, 26, 0.72); padding: 12px 14px; color: rgba(255, 255, 255, 0.72); font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; font-size: 0.88rem; }\n.akan-system-actions { margin-top: 30px; display: flex; flex-wrap: wrap; gap: 12px; }\n.akan-system-action { display: inline-flex; min-height: 44px; align-items: center; justify-content: center; border: 1px solid var(--akan-primary); border-radius: 999px; background: var(--akan-primary); box-shadow: 0 12px 34px rgba(255, 73, 59, 0.26); color: var(--akan-foreground); padding: 0 18px; font-weight: 800; text-decoration: none; }\n.akan-system-secondary { border: 1px solid rgba(255, 255, 255, 0.12); background: var(--akan-secondary); color: var(--akan-foreground); }\n.akan-system-details { margin-top: 28px; max-height: 260px; overflow: auto; border-radius: 18px; background: rgba(26, 26, 26, 0.82); border: 1px solid rgba(240, 32, 32, 0.22); padding: 16px; color: rgba(255, 255, 255, 0.78); font-size: 0.82rem; line-height: 1.55; white-space: pre-wrap; }\n";
+/** The card alone, styled by the app's own tokens: what a not-found raised after the layouts streamed renders in place. */
+export declare const SystemPageMain: (options: Omit<SystemPageOptions, "lang" | "stylesheetHref" | "script">) => import("react").JSX.Element;
 export declare function createSystemPageDocument(options: SystemPageOptions): ReactNode;
 export declare function getSystemPageErrorDetails(error: unknown): string;
 export declare function getPathnameLocale(pathname: string, i18n: AkanI18nConfig): string;

package/types/server/types.d.ts

@@ -1,9 +1,12 @@
 import type { AkanWebConfig } from "akanjs";
 import type { PromiseOrObject } from "akanjs/base";
 import type { AkanI18nConfig } from "akanjs/common";
+import type { WebsocketRoomCursor } from "akanjs/signal";
 import type { ClientManifest } from "./artifact.d.ts";
 import type { SsrManifest } from "./ssrTypes.d.ts";
-export type WebsocketRoute = (ws: Bun.ServerWebSocket<unknown>, data: unknown[], event?: "message" | "subscribe" | "unsubscribe") => PromiseOrObject<unknown>;
+export type WebsocketRoute = (ws: Bun.ServerWebSocket<unknown>, data: unknown[], event?: "message" | "subscribe" | "unsubscribe", request?: {
+    since?: WebsocketRoomCursor;
+}) => PromiseOrObject<unknown>;
 export type WebsocketRoutes = Record<string, WebsocketRoute>;
 export type HttpRoutes = Bun.Serve.Options<unknown>["routes"];
 export type LocalPublish = (roomId: string, data: object | object[] | Uint8Array) => void;

package/types/server/webRouter.d.ts

@@ -6,6 +6,7 @@ import type { PagePromptSource } from "../signal/mcp/pagePrompt.d.ts";
 import { type BuilderRpc, type RouteSeedIndex, type RoutesManifest } from "./artifact.d.ts";
 import { type RouteCacheInvalidation, type RouteCacheRenderState } from "./cachePolicy.d.ts";
 import type { HmrWsData, HmrWsHub } from "./hmr/wsHub.d.ts";
+import type { McpAppShellSource } from "./mcp/McpApps.d.ts";
 import { type RscRedirectMethod, type RscRedirectStatus, type RscRenderResult, RscWorker } from "./rscWorkerHost.d.ts";
 import { type BaseBuildArtifact, type RenderState } from "./types.d.ts";
 export declare const DEFAULT_HTML_RESULT_CACHE_MAX_BODY_BYTES: number;
@@ -23,7 +24,7 @@ export declare function resolveHtmlRouteCacheStoreTtl(input: {
     workerCacheState: RouteCacheRenderState;
     hostRequestStore: AkanRequestStore;
     lateControl?: {
-        type: "redirect";
+        type: "redirect" | "not-found";
     } | null;
 }): number | null;
 export declare function createRscNavigationStreamResponse(result: Extract<RscRenderResult, {
@@ -70,6 +71,7 @@ export declare class WebRouter {
     dispose(): void;
     setLogLevel(minSev: number | null): void;
     pagePrompts(): PagePromptSource;
+    mcpAppShell(): McpAppShellSource | undefined;
     onLogRecords(listener: (records: LogRecord[], dropped: number) => void): void;
     getMetrics(): AkanMetricsReport;
     invalidateRouteCaches(invalidation?: string | RouteCacheInvalidation): void;

package/types/service/ipcTypes.d.ts

@@ -15,9 +15,11 @@ export interface AkanJobOptions {
     attempts?: number;
     /** Smaller runs sooner, and a job with none runs before every prioritized one — bullmq's reading. */
     priority?: number;
+    /** `maxDelay` caps what an exponential backoff grows to between attempts. */
     backoff?: number | {
         type?: string;
         delay?: number;
+        maxDelay?: number;
     };
     removeOnComplete?: boolean | number;
     removeOnFail?: boolean | number;

package/types/service/predefinedAdaptor/database.adaptor.d.ts

@@ -3,14 +3,13 @@ import type { ConstantModel } from "akanjs/constant";
 import type { DatabaseModel, SchemaOf } from "akanjs/document";
 import { SearchIndex } from "./searchIndex.d.ts";
 import { BunSqliteClient } from "./sql/driver/bunSqlite.d.ts";
-import { LibsqlAkanClient } from "./sql/driver/libsql.d.ts";
 import { PostgresAkanClient } from "./sql/driver/postgres.d.ts";
 import { SqlDocumentStore } from "./sql/SqlDocumentStore.d.ts";
 import { type ConcurrentIndexBuild, type DatabaseAdaptor, type InsightSession, type SearchConfig, type SqliteEnv } from "./sql/types.d.ts";
 export { PostgresDialect } from "./sql/dialect/postgres.d.ts";
 export { SqliteDialect } from "./sql/dialect/sqlite.d.ts";
 export { SqlDocumentStore } from "./sql/SqlDocumentStore.d.ts";
-export type { AkanSqlClient, AkanSqlStatement, DatabaseAdaptor, DatabaseConfig, DocumentDatabaseOwner, DocumentStore, InsightSession, LibsqlDatabaseConfig, PostgresDatabaseConfig, SearchConfig, SqlDialect, SqliteDatabaseConfig, SqlResultRows, } from "./sql/types.d.ts";
+export type { AkanSqlClient, AkanSqlStatement, DatabaseAdaptor, DatabaseConfig, DocumentDatabaseOwner, DocumentStore, InsightSession, PostgresDatabaseConfig, SearchConfig, SqlDialect, SqliteDatabaseConfig, SqlResultRows, UpsertByIdOptions, } from "./sql/types.d.ts";
 declare const SqliteDatabase_base: import("..").AdaptorCls<{}, {
     scheduler: import("..").InjectInfo<"plug", import("./schedule.adaptor").ScheduleAdaptor, never, never>;
     config: import("..").InjectInfo<"env", {
@@ -40,28 +39,6 @@ export declare class SqliteDatabase extends SqliteDatabase_base implements Datab
     checkpoint(mode?: "PASSIVE" | "FULL" | "RESTART" | "TRUNCATE"): void;
     vacuum(): void;
 }
-declare const LibsqlDatabase_base: import("..").AdaptorCls<{}, {
-    scheduler: import("..").InjectInfo<"plug", import("./schedule.adaptor").ScheduleAdaptor, never, never>;
-    config: import("..").InjectInfo<"env", {
-        url: string;
-        authToken: string | undefined;
-        search: Required<SearchConfig>;
-    }, SqliteEnv, never>;
-}>;
-export declare class LibsqlDatabase extends LibsqlDatabase_base implements DatabaseAdaptor {
-    #private;
-    onInit(): Promise<void>;
-    onDestroy(): Promise<void>;
-    getConnection(): LibsqlAkanClient;
-    getSearchIndex(): SearchIndex;
-    openInsight(): Promise<InsightSession>;
-    stores(): SqlDocumentStore[];
-    getStore(constant: ConstantModel, database: DatabaseModel, schema: SchemaOf): SqlDocumentStore;
-    getMeta(key: string): Promise<string | undefined>;
-    setMeta(key: string, value: string): Promise<void>;
-    transaction<T>(fn: () => PromiseOrObject<T>): Promise<T>;
-    afterCommit(fn: () => PromiseOrObject<void>): Promise<void>;
-}
 declare const PostgresDatabase_base: import("..").AdaptorCls<{}, {
     scheduler: import("..").InjectInfo<"plug", import("./schedule.adaptor").ScheduleAdaptor, never, never>;
     config: import("..").InjectInfo<"env", {

package/types/service/predefinedAdaptor/queue.adaptor.d.ts

@@ -8,9 +8,15 @@ interface BullEmitter {
 interface QueueLike extends BullEmitter {
     add(name: string, args: unknown[], options?: AkanJobOptions): Promise<unknown>;
 }
-type WorkerLike = AkanWorker & BullEmitter;
+type WorkerLike = AkanWorker & BullEmitter & {
+    on(event: "failed", listener: (job: AkanJob | undefined, error: Error) => void): unknown;
+};
+export interface ProcessWorkerOptions {
+    /** After the job's last attempt failed. */
+    onFailed?: (job: AkanJob, error: unknown) => Promise<void> | void;
+}
 export interface QueueAdaptor {
-    registerProcessWorker(key: string, handler: (job: AkanJob) => Promise<unknown>): AkanWorker;
+    registerProcessWorker(key: string, handler: (job: AkanJob) => Promise<unknown>, options?: ProcessWorkerOptions): AkanWorker;
     registerProcessQueue(key: string, args: unknown[], jobOptions?: AkanJobOptions): Promise<AkanJob>;
 }
 declare const BullQueue_base: import("..").AdaptorCls<{}, {
@@ -22,7 +28,8 @@ export declare class BullQueue extends BullQueue_base implements QueueAdaptor {
     onInit(): Promise<void>;
     onDestroy(): Promise<void>;
     getQueue(key: string): QueueLike;
-    registerProcessWorker(key: string, handler: (job: AkanJob) => Promise<unknown>): WorkerLike;
+    registerProcessWorker(key: string, handler: (job: AkanJob) => Promise<unknown>, { onFailed }?: ProcessWorkerOptions): WorkerLike;
     registerProcessQueue(key: string, args: unknown[], jobOptions?: AkanJobOptions): Promise<AkanJob>;
+    static cappedBackoff(attemptsMade: number, type?: string): number;
 }
 export {};

package/types/service/predefinedAdaptor/queueBackoff.d.ts

@@ -0,0 +1,4 @@
+import type { AkanJobOptions } from "../ipcTypes.d.ts";
+export declare class QueueBackoff {
+    static delayOf(backoff: AkanJobOptions["backoff"], attemptsMade: number): number;
+}

package/types/service/predefinedAdaptor/solidQueue.adaptor.d.ts

@@ -1,5 +1,5 @@
 import { type AkanJob, type AkanJobOptions, type AkanWorker } from "../ipcTypes.d.ts";
-import type { QueueAdaptor } from "./queue.adaptor";
+import type { ProcessWorkerOptions, QueueAdaptor } from "./queue.adaptor";
 import { type SolidConfig, type SolidEnv } from "./solidSqlite.d.ts";
 declare const SolidQueue_base: import("..").AdaptorCls<{}, {
     config: import("..").InjectInfo<"env", Required<SolidConfig>, SolidEnv, never>;
@@ -14,10 +14,10 @@ export declare class SolidQueue extends SolidQueue_base implements QueueAdaptor
     #private;
     onInit(): Promise<void>;
     onDestroy(): Promise<void>;
-    registerProcessWorker(key: string, handler: (job: AkanJob) => Promise<unknown>): AkanWorker;
+    registerProcessWorker(key: string, handler: (job: AkanJob) => Promise<unknown>, options?: ProcessWorkerOptions): AkanWorker;
     registerProcessQueue(key: string, args: unknown[], jobOptions?: AkanJobOptions): Promise<AkanJob>;
     wake(name?: string): void;
     claimJob(name: string): AkanJob | null;
-    runJob(job: AkanJob, handler: (job: AkanJob) => Promise<unknown>): Promise<void>;
+    runJob(job: AkanJob, handler: (job: AkanJob) => Promise<unknown>, { onFailed }?: ProcessWorkerOptions): Promise<void>;
 }
 export {};

package/types/service/predefinedAdaptor/sql/SqlDocumentStore.d.ts

@@ -1,7 +1,7 @@
 import { type ConstantModel } from "akanjs/constant";
 import { type DatabaseModel, type DocumentQuery, type DocumentSchema, type DocumentScopeOptions, type DocumentUpdateInput, type DocumentUpdateOptions } from "akanjs/document";
 import { QueryCompiler } from "./QueryCompiler.d.ts";
-import { type DocumentDatabaseOwner, type DocumentRecord, type FindIdOptions, type FindManyOptions, type FindOneOptions, type SqlDialect, type TransferRow, type WriteHookOptions } from "./types.d.ts";
+import { type DocumentDatabaseOwner, type DocumentRecord, type FindIdOptions, type FindManyOptions, type FindOneOptions, type SqlDialect, type TransferRow, type UpsertByIdOptions, type WriteHookOptions } from "./types.d.ts";
 import { UpdateCompiler } from "./UpdateCompiler.d.ts";
 export declare class SqlDocumentStore {
     #private;
@@ -19,6 +19,9 @@ export declare class SqlDocumentStore {
     clone(data: DocumentRecord & {
         id: string;
     }): Promise<any>;
+    upsertById(data: DocumentRecord & {
+        id: string;
+    }, { preserveTimestamps }?: UpsertByIdOptions): Promise<any>;
     update(id: string, patch: DocumentRecord, options?: WriteHookOptions): Promise<any>;
     remove(id: string): Promise<any>;
     /** Up to `limit` stored rows after the id `after`, in id order and removed ones included. */
@@ -69,6 +72,8 @@ export declare class SqlDocumentStore {
     pickById(id: string): Promise<any>;
     exists(query?: DocumentQuery, options?: DocumentScopeOptions): Promise<string | null>;
     count(query?: DocumentQuery, options?: DocumentScopeOptions): Promise<number>;
+    /** The stored numbers at `path` added up over the live rows the query matches; 0 when none. */
+    sum(path: string, query?: DocumentQuery): Promise<number>;
     insight(query?: DocumentQuery): Promise<DocumentRecord>;
     private safeQuery;
     private writeQuery;

package/types/service/predefinedAdaptor/sql/dialect/postgres.d.ts

@@ -13,6 +13,7 @@ export declare class PostgresDialect implements SqlDialect {
     docColumn(): string;
     docValuePlaceholder(): string;
     extract(path: string, kind?: PathKind): string;
+    sumOf(path: string): string;
     projectExpr(path: string): string;
     decodeProjected(value: unknown): any;
     eq(path: string, value: unknown, kind?: PathKind): SqlFrag;

package/types/service/predefinedAdaptor/sql/dialect/sqlite.d.ts

@@ -8,6 +8,7 @@ export declare class SqliteDialect implements SqlDialect {
     docColumn(): string;
     docValuePlaceholder(): string;
     extract(path: string): string;
+    sumOf(path: string): string;
     projectExpr(path: string): string;
     decodeProjected(value: unknown): any;
     eq(path: string, value: unknown): SqlFrag;

package/types/service/predefinedAdaptor/sql/search/fts5.d.ts

@@ -2,7 +2,7 @@ import { type ConstantModel } from "akanjs/constant";
 import { type DatabaseModel, type SearchColumn } from "akanjs/document";
 import type { SqlFrag } from "../types.d.ts";
 import { type ModelTriggers, type SearchColumns, type SearchEngine, type SearchIndexOwner, type SearchQuery } from "./types.d.ts";
-/** The SQLite/libsql index: an fts5 table with `search_doc` as its external content. */
+/** The SQLite index: an fts5 table with `search_doc` as its external content. */
 export declare class Fts5SearchEngine implements SearchEngine {
     #private;
     readonly backfillLock = "";

package/types/service/predefinedAdaptor/sql/types.d.ts

@@ -12,10 +12,6 @@ export interface SqliteDatabaseConfig {
     cacheSize?: number;
     tempStore?: "DEFAULT" | "FILE" | "MEMORY";
 }
-export interface LibsqlDatabaseConfig {
-    url?: string;
-    authToken?: string;
-}
 export interface PostgresDatabaseConfig {
     url?: string;
     host?: string;
@@ -32,16 +28,22 @@ export interface SearchConfig {
 }
 export interface DatabaseConfig {
     sqlite?: SqliteDatabaseConfig;
-    libsql?: LibsqlDatabaseConfig;
     postgres?: PostgresDatabaseConfig;
     search?: SearchConfig;
 }
+export interface UpsertByIdOptions {
+    /** Keep the record's own `createdAt` and `updatedAt`, as a backfill from another system must. */
+    preserveTimestamps?: boolean;
+}
 export interface DocumentStore {
     ensure(): Promise<void>;
     create(data: DocumentRecord): Promise<any>;
     clone(data: DocumentRecord & {
         id: string;
     }): Promise<any>;
+    upsertById(data: DocumentRecord & {
+        id: string;
+    }, options?: UpsertByIdOptions): Promise<any>;
     update(id: string, patch: DocumentRecord): Promise<any>;
     remove(id: string): Promise<any>;
     updateOneByQuery(query: DocumentQuery, update: DocumentUpdateInput, options?: DocumentUpdateOptions): Promise<{
@@ -247,6 +249,8 @@ export interface SqlDialect {
     docColumn(): string;
     docValuePlaceholder(): string;
     extract(path: string, kind?: PathKind): string;
+    /** The aggregate summing a stored number at `path`; a value that is not a number counts as nothing. */
+    sumOf(path: string): string;
     projectExpr(path: string): string;
     decodeProjected(value: unknown): unknown;
     eq(path: string, value: unknown, kind?: PathKind): SqlFrag;

package/types/service/predefinedAdaptor/sql/values.d.ts

@@ -1,8 +1,5 @@
-import type { InArgs, InValue } from "@libsql/client";
 import type { QueryLeafOps } from "./types.d.ts";
 export declare const isPlainObject: (value: unknown) => value is Record<string, unknown>;
-export declare const toLibsqlValue: (value: unknown) => InValue;
-export declare const toLibsqlArgs: (params: unknown[]) => InArgs;
 export declare const toPostgresSql: (sql: string, params: unknown[]) => {
     sql: string;
     params: unknown[];

package/types/service/serve.d.ts

@@ -6,6 +6,8 @@ import type { DatabaseServiceForModel } from "./types.d.ts";
 interface ServiceOptions {
     enabled?: boolean | (() => boolean);
     serverMode?: "batch" | "federation";
+    /** The operation modes the module mounts in; `modules: ["@edge"]` selects every module that lists `edge`. */
+    operationMode?: ("cloud" | "edge" | "local" | (string & {}))[];
 }
 export type ServiceType = "database" | "plain";
 export interface Service {
@@ -22,6 +24,7 @@ export type ServiceCls<RefName extends string = string, Methods = {}, InjectMap
     readonly type: ServiceType;
     readonly [INJECT_META]: InjectMap;
     readonly enabled: boolean;
+    readonly operationMode: readonly string[] | undefined;
 }>;
 export declare function serve<RefName extends string, Injection extends InjectBuilder>(refName: RefName, injectBuilder: Injection, ...extendSrvs: Cls[]): ServiceCls<RefName, {}, ReturnType<Injection>>;
 export declare function serve<RefName extends string, Injection extends InjectBuilder>(refName: RefName, option: ServiceOptions, injectBuilder: Injection, ...extendSrvs: Cls[]): ServiceCls<RefName, {}, ReturnType<Injection>>;

package/types/signal/endpointIdempotency.d.ts

@@ -0,0 +1,7 @@
+import type { SignalContext } from "./signalContext.d.ts";
+export declare class EndpointIdempotency {
+    #private;
+    static readonly header = "idempotency-key";
+    static readonly keepMs: number;
+    static through(context: SignalContext, run: () => Promise<unknown>): Promise<unknown>;
+}

package/types/signal/internalArg.d.ts

@@ -20,6 +20,16 @@ export declare class Res implements InternalArg {
 export declare class CallerAccount implements InternalArg<unknown> {
     getArg(context: SignalContext): unknown;
 }
+/** A device or service a machine token names: `version` is what a guard compares to revoke it. */
+export interface MachineIdentity {
+    kind: string;
+    id: string;
+    version: number;
+}
+/** The machine a verified machine token proved for this call; required unless declared `{ nullable: true }`. */
+export declare class Machine implements InternalArg<MachineIdentity | null> {
+    getArg(context: SignalContext): MachineIdentity | null;
+}
 /** The caller's IP as the nearest proxy recorded it (see `SignalContext.getClientIp`), `null` when unknown. */
 export declare class Ip implements InternalArg<string | null> {
     getArg(context: SignalContext): string | null;

package/types/signal/mcp/McpDocument.d.ts

@@ -11,6 +11,11 @@ export interface McpDocumentOptions {
      * no `outputSchema` (results still ship as `structuredContent`).
      */
     outputSchema?: McpOutputSchemaMode;
+    /**
+     * MCP Apps: an endpoint kept off the shelf only by `mcp: false` is published as an app-only tool, which a host lists
+     * to the views it renders and never to the model. Every other refusal still holds.
+     */
+    apps?: boolean;
 }
 export type McpOutputSchemaMode = "full" | "shallow" | "none";
 export interface McpExposedEndpoint {
@@ -34,6 +39,8 @@ export declare class McpDocument {
     /** The spec types `structuredContent` as an object, so a list result is wrapped under this key. */
     static readonly listKey = "items";
     readonly tools: McpTool[];
+    /** `visibility: ["app"]` — callable by a rendered view, absent from every model-facing list. */
+    readonly appTools: McpTool[];
     readonly resourceTemplates: McpResourceTemplate[];
     /** Every readable thing is addressed by a template, so there are no fixed resources to enumerate. */
     readonly resources: McpResource[];
@@ -49,4 +56,5 @@ export declare class McpDocument {
         args: Record<string, string | string[]>;
     } | null;
     static structuredContent(endpoint: SerializedEndpoint, value: unknown): {} | undefined;
+    isAppOnly(name: string): boolean;
 }

package/types/signal/mcp/mcpProtocol.d.ts

@@ -10,6 +10,10 @@ export declare const MCP_META_PROTOCOL_VERSION = "io.modelcontextprotocol/protoc
 export declare const MCP_META_CLIENT_CAPABILITIES = "io.modelcontextprotocol/clientCapabilities";
 export declare const MCP_META_CLIENT_INFO = "io.modelcontextprotocol/clientInfo";
 export declare const MCP_META_SERVER_INFO = "io.modelcontextprotocol/serverInfo";
+/** MCP Apps (SEP-1865): a tool names a `ui://` resource, and a host that speaks the extension renders it in an iframe. */
+export declare const MCP_UI_EXTENSION = "io.modelcontextprotocol/ui";
+export declare const MCP_UI_MIME_TYPE = "text/html;profile=mcp-app";
+export declare const MCP_UI_LEGACY_RESOURCE_URI = "ui/resourceUri";
 export declare const McpErrorCode: {
     readonly parse: -32700;
     readonly invalidRequest: -32600;
@@ -34,6 +38,12 @@ export interface McpToolAnnotations {
     idempotentHint?: boolean;
     openWorldHint?: boolean;
 }
+/** `model` lists the tool to the model, `app` lets a rendered view call it; a host enforces both. */
+export type McpUiVisibility = "model" | "app";
+export interface McpToolUiMeta {
+    resourceUri?: string;
+    visibility?: McpUiVisibility[];
+}
 export interface McpTool {
     name: string;
     title?: string;
@@ -41,6 +51,10 @@ export interface McpTool {
     inputSchema: Record<string, unknown>;
     outputSchema?: Record<string, unknown>;
     annotations?: McpToolAnnotations;
+    _meta?: {
+        ui?: McpToolUiMeta;
+        [MCP_UI_LEGACY_RESOURCE_URI]?: string;
+    };
 }
 export interface McpResourceTemplate {
     uriTemplate: string;
@@ -55,6 +69,7 @@ export interface McpResource {
     title?: string;
     description?: string;
     mimeType?: string;
+    _meta?: Record<string, unknown>;
 }
 export interface McpPromptArgument {
     name: string;
@@ -76,9 +91,11 @@ export interface McpToolResult {
     content: McpTextContent[];
     structuredContent?: unknown;
     isError?: boolean;
+    _meta?: Record<string, unknown>;
 }
 export interface McpResourceContents {
     uri: string;
     mimeType: string;
     text: string;
+    _meta?: Record<string, unknown>;
 }

package/types/signal/signalContext.d.ts

@@ -73,17 +73,19 @@ export declare class SignalContext<Ctx extends HttpExecutionContext | WebSocketE
     static try(endpoint: Adaptor, endpointInfo: EndpointInfo, key: string, fn: () => Promise<Response | undefined>, options?: {
         trace?: boolean;
     }): Promise<Response | undefined>;
-    static resolveReturn(value: unknown, { signalContext, returnRef, arrDepth, registry, live, cache, }: {
+    static resolveReturn(value: unknown, { signalContext, returnRef, arrDepth, registry, live, cache, path, }: {
         signalContext: SignalContext | null;
         returnRef: ConstantFieldTypeInput;
         arrDepth: number;
         registry: InjectRegistry;
         live: LiveRegistry;
         cache?: ResolveCache;
+        /** The field path from the endpoint's return to `value`, named by a relation that cannot load. */
+        path?: string;
     }): Promise<unknown>;
-    static loadNested(value: unknown, service: DatabaseService, { arrDepth, nullable }: {
+    /** What `value` references: `null` for a document that is gone or soft-removed, which an array leaves out. */
+    static loadNested(value: unknown, service: DatabaseService, { arrDepth }: {
         arrDepth: number;
-        nullable: boolean;
     }): Promise<unknown>;
     getHttpContext<Appended = unknown>(): HttpExecutionContext<Appended>;
     getWebSocketContext<Appended = unknown>(): WebSocketExecutionContext<Appended>;