akanjs 3.1.0-rc.0 → 3.1.0-rc.1

package/client/csrTypes.ts

@@ -364,6 +364,10 @@ export const usePathCtx = () => {
   return contextValues;
 };
 
+/** Inside a layout's own markup that an MCP view hides while the page is drawn on its own: frame chrome draws nothing. */
+export const hiddenLayoutContext = sharedContext<boolean>("hiddenLayout", false);
+export const useInHiddenLayout = () => useContext(hiddenLayoutContext);
+
 export type PageActivity = "current" | "prev" | "pending" | "hidden";
 export interface PageActivityState {
   activity: PageActivity;

package/dictionary/base.dictionary.ts

@@ -57,6 +57,10 @@ export const baseDictionary = serviceDictionary(["en", "ko"])
       "The same request is still being handled. Please try again in a moment.",
       "같은 요청을 아직 처리하고 있습니다. 잠시 후 다시 시도해주세요.",
     ],
+    endpointClosed: [
+      "{endpoint} is closed: the slice's guards name none that allows it.",
+      "{endpoint}이(가) 닫혀 있습니다. 슬라이스 guards에 이 동작을 허용하는 guard를 지정해야 합니다.",
+    ],
   })
   .translate({
     somethingWrong: ["Something's wrong!", "문제가 생겼어요!"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.1.0-rc.0",
+  "version": "3.1.0-rc.1",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/service/adapt.ts

@@ -13,7 +13,7 @@ export type AdaptorCls<Methods = any, InjectMap extends Record<string, InjectInf
   { readonly [INJECT_META]: InjectMap; readonly refName: string }
 >;
 
-export function adapt<Name extends string>(name: Name): AdaptorCls;
+export function adapt<Name extends string>(name: Name): AdaptorCls<{}>;
 
 export function adapt<Name extends string, Injection extends InjectBuilder<"use" | "env" | "memory" | "plug">>(
   name: Name,

package/store/action.ts

@@ -510,6 +510,15 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
     const updatedAt = (model as unknown as { updatedAt?: { toISOString?: () => string } }).updatedAt;
     return typeof updatedAt?.toISOString === "function" ? updatedAt.toISOString() : null;
   };
+  
+  const servedFetch = <T>(key: string) => {
+    const fn = fetch[key] as ((...args: any[]) => Promise<T>) | undefined;
+    if (typeof fn === "function") return fn;
+    throw Object.assign(new Error(`${key} is closed: the slice's guards name none that allows it`), {
+      error: "base.error.endpointClosed",
+      data: { endpoint: key },
+    });
+  };
   function armDraft(this: SetGet, draftScope: string | undefined, form: object, baseUpdatedAt: string | null) {
     openFormBase = draftScope ? form : null;
     if (!draftScope) return null;
@@ -598,7 +607,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
 
       if (!modelInput) return;
       this.set({ [names.modelLoading]: true });
-      const model = await (fetch[names.createModel] as (...args: any[]) => Promise<Full>)(modelInput, { onError });
+      const model = await servedFetch<Full>(names.createModel)(modelInput, { onError });
       this.set({
         [names.modelForm]: immerify(modelRef, defaultModel),
         [names.modelDraft]: clearDraft(currentState[names.modelDraft] as DraftState | null),
@@ -623,11 +632,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
       const modelInput = (cnst.input.purify as (form: any) => DefaultOf<Input> | null)(modelForm);
       if (!modelInput) return;
       if (model?.id === modelForm.id) this.set({ [names.modelLoading]: modelForm.id });
-      const updatedModel = await (fetch[names.updateModel] as (...args: any[]) => Promise<Full>)(
-        modelForm.id,
-        modelInput,
-        { onError },
-      );
+      const updatedModel = await servedFetch<Full>(names.updateModel)(modelForm.id, modelInput, { onError });
       this.set({
         ...(model?.id === updatedModel.id
           ? { [names.model]: updatedModel, [names.modelLoading]: false, [names.modelViewAt]: new Date() }
@@ -650,7 +655,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
       const modelInput = (cnst.input.purify as (data: any) => Input | null)(data);
       if (!modelInput) return;
       this.set({ [names.modelLoading]: true });
-      const model = await (fetch[names.createModel] as (...args: any[]) => Promise<Full>)(modelInput, { onError });
+      const model = await servedFetch<Full>(names.createModel)(modelInput, { onError });
       this.set({
         [names.model]: model,
         [names.modelLoading]: false,
@@ -673,7 +678,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
       const modelInput = (cnst.input.purify as (data: any) => DefaultOf<Input> | null)(data);
       if (!modelInput) return;
       if (model?.id === id) this.set({ [names.modelLoading]: id });
-      const updatedModel = await (fetch[names.updateModel] as (...args: any[]) => Promise<Full>)(id, modelInput, {
+      const updatedModel = await servedFetch<Full>(names.updateModel)(id, modelInput, {
         onError,
       });
       this.set({
@@ -689,10 +694,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
     },
     [names.removeModel]: async function (this: SetGet, id: string, options?: FetchPolicy & { modal?: string | null }) {
       const { modal, ...fetchPolicyOptions } = options ?? {};
-      const model = await (fetch[names.removeModel] as (...args: any[]) => Promise<Full & { removedAt: Dayjs | null }>)(
-        id,
-        fetchPolicyOptions,
-      );
+      const model = await servedFetch<Full & { removedAt: Dayjs | null }>(names.removeModel)(id, fetchPolicyOptions);
       const lightModel = new cnst.light().set(model) as unknown as Light;
       slices.forEach(({ keys: { state: namesOfSlice } }) => {
         const currentState = this.get() as { [key: string]: any };
@@ -776,7 +778,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
     ) {
       const id = typeof modelOrId === "string" ? modelOrId : modelOrId.id;
       this.set({ [names.modelFormLoading]: id, [names.modelModal]: modal ?? "edit" });
-      const model = await (fetch[names.model] as (...args: any[]) => Promise<Full>)(id, { onError });
+      const model = await servedFetch<Full>(names.model)(id, { onError });
       const modelForm = immerify(modelRef, deepObjectify<Input>(model as unknown as Input) as object) as Input;
       this.set({
         [names.model]: model,
@@ -798,11 +800,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
       const currentState = this.get() as { [key: string]: any };
       const model = currentState[names.model] as Full | null;
       if (id === model?.id) this.set({ modelLoading: id });
-      const updatedModel = await (fetch[names.mergeModel] as (...args: any[]) => Promise<Full>)(
-        modelOrId,
-        data,
-        options,
-      );
+      const updatedModel = await servedFetch<Full>(names.mergeModel)(modelOrId, data, options);
       this.set({
         [names.model]: id === model?.id ? updatedModel : model,
         [names.modelLoading]: false,
@@ -817,7 +815,7 @@ export const makeActions = (refName: string, slice: { [key: string]: SerializedS
     ) {
       const id = typeof modelOrId === "string" ? modelOrId : modelOrId.id;
       this.set({ [names.modelModal]: modal ?? "view", [names.modelLoading]: id });
-      const model = await (fetch[names.model] as (...args: any[]) => Promise<Full>)(id, { onError });
+      const model = await servedFetch<Full>(names.model)(id, { onError });
       this.set({ [names.model]: model, [names.modelViewAt]: new Date(), [names.modelLoading]: false });
     },
     [names.setModel]: function (this: SetGet, ...fullOrLightModels: Full[]) {

package/types/client/csrTypes.d.ts

@@ -348,6 +348,9 @@ export interface PathContextType {
 }
 export declare const pathContext: import("react").Context<PathContextType>;
 export declare const usePathCtx: () => PathContextType;
+/** Inside a layout's own markup that an MCP view hides while the page is drawn on its own: frame chrome draws nothing. */
+export declare const hiddenLayoutContext: import("react").Context<boolean>;
+export declare const useInHiddenLayout: () => boolean;
 export type PageActivity = "current" | "prev" | "pending" | "hidden";
 export interface PageActivityState {
     activity: PageActivity;

package/types/dictionary/base.dictionary.d.ts

@@ -1 +1 @@
-export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", "serverUnreachable" | "serverUnavailable" | "gatewayTimeout" | "tooManyRequests" | "unexpectedResponse" | "immutableField" | "relationNotFound" | "idempotencyInFlight", "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view">;
+export declare const baseDictionary: import("./dictInfo.d.ts").ServiceDictInfo<[string, string], "ping" | "pingBody" | "pingParam" | "pingQuery" | "wsPing" | "pubsubPing", "serverUnreachable" | "serverUnavailable" | "gatewayTimeout" | "tooManyRequests" | "unexpectedResponse" | "immutableField" | "relationNotFound" | "idempotencyInFlight" | "endpointClosed", "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view">;

package/types/dictionary/dictionary.d.ts

@@ -1,13 +1,13 @@
 import type { AgentEndpoint, AgentTurn, BaseEndpoint } from "akanjs/signal";
 export declare const dictionary: {
-    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view">, "base.error.gatewayTimeout" | "base.error.tooManyRequests" | "base.error.serverUnavailable" | "base.error.serverUnreachable" | "base.error.idempotencyInFlight" | "base.error.unexpectedResponse" | "base.error.immutableField" | "base.error.relationNotFound">;
+    base: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view">, "base.error.gatewayTimeout" | "base.error.tooManyRequests" | "base.error.serverUnavailable" | "base.error.serverUnreachable" | "base.error.idempotencyInFlight" | "base.error.unexpectedResponse" | "base.error.immutableField" | "base.error.relationNotFound" | "base.error.endpointClosed">;
     agentTurn: import("./locale.d.ts").DictModule<import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc`, never>;
     agent: import("./locale.d.ts").DictModule<import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, "agent.error.llmUnavailable" | "agent.error.llmRequestFailed" | "agent.error.contextOverflow" | "agent.error.quotaExceeded">;
 };
-export declare const Err: import("./trans.d.ts").ErrConstructor<"base.error.gatewayTimeout" | "base.error.tooManyRequests" | "base.error.serverUnavailable" | "base.error.serverUnreachable" | "base.error.idempotencyInFlight" | "base.error.unexpectedResponse" | "base.error.immutableField" | "base.error.relationNotFound" | "agent.error.llmUnavailable" | "agent.error.llmRequestFailed" | "agent.error.contextOverflow" | "agent.error.quotaExceeded">, translate: (lang: "en" | "ko" | (string & {}) | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, data?: import("./trans.d.ts").TranslationData) => string, msg: {
+export declare const Err: import("./trans.d.ts").ErrConstructor<"base.error.gatewayTimeout" | "base.error.tooManyRequests" | "base.error.serverUnavailable" | "base.error.serverUnreachable" | "base.error.idempotencyInFlight" | "base.error.unexpectedResponse" | "base.error.immutableField" | "base.error.relationNotFound" | "base.error.endpointClosed" | "agent.error.llmUnavailable" | "agent.error.llmRequestFailed" | "agent.error.contextOverflow" | "agent.error.quotaExceeded">, translate: (lang: "en" | "ko" | (string & {}) | "zhChs" | "zhCht" | "ja", key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, data?: import("./trans.d.ts").TranslationData) => string, msg: {
     error: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
     info: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
     warning: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
     success: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
     loading: (key: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, option?: import("./trans.d.ts").TransMessageOption) => void;
-}, getDictionary: (lang: "en" | "ko" | (string & {}) | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, __Error_Key__: "base.error.gatewayTimeout" | "base.error.tooManyRequests" | "base.error.serverUnavailable" | "base.error.serverUnreachable" | "base.error.idempotencyInFlight" | "base.error.unexpectedResponse" | "base.error.immutableField" | "base.error.relationNotFound" | "agent.error.llmUnavailable" | "agent.error.llmRequestFailed" | "agent.error.contextOverflow" | "agent.error.quotaExceeded";
+}, getDictionary: (lang: "en" | "ko" | (string & {}) | "zhChs" | "zhCht" | "ja") => object, getAllDictionary: () => import("./trans.d.ts").RootDictionary, __Dict_Key__: import("./locale.d.ts").ServiceTranslatorKey<"base", BaseEndpoint, "edit" | "error" | "ok" | "retry" | "approve" | "remove" | "skip" | "success" | "unauthorized" | "save" | "refresh" | "password" | "agent" | "stop" | "connecting" | "send" | "somethingWrong" | "connected" | "serverDisconnected" | "refreshing" | "tryReconnecting" | "serverHasProblem" | "checkServerStatus" | "cameraPromptHeader" | "cameraPromptPhoto" | "cameraPromptPicture" | "cameraPromptCancel" | "failed" | "processing" | "processed" | "noData" | "invalidValueError" | "emailInvalidError" | "phoneInvalidError" | "cancel" | "pageLoadFailed" | "agentIntro" | "agentPlaceholder" | "agentClear" | "agentQuestion" | "agentToolCard" | "agentAnswer" | "agentListen" | "agentVoiceFailed" | "agentAttach" | "agentAttachRemove" | "agentAttachReading" | "agentReferenceRemove" | "agentReferenceFailed" | "agentAttachTooLarge" | "agentAttachUnsupported" | "agentAttachDuplicate" | "agentAttachTooMany" | "agentAttachTooMuch" | "agentAnswerNeeded" | "agentQueue" | "agentQueuePlaceholder" | "agentQueued" | "agentQueueEdit" | "agentQueueCancel" | "agentToolDone" | "agentToolFailed" | "agentToolRunning" | "agentToolResult" | "agentTokens" | "agentTokensOf" | "agentCompactsAt" | "agentSummarizing" | "agentContinue" | "agentKeepGoing" | "agentCmdNew" | "agentCmdRetry" | "agentCmdCompact" | "agentCmdCopy" | "agentCmdHelp" | "agentCmdTools" | "agentHelpIntro" | "agentHelpNote" | "agentNothingToRetry" | "agentNothingToCompact" | "agentCompacted" | "agentSummary" | "agentBusy" | "agentCopied" | "agentCopyFailed" | "agentToolsHead" | "agentToolsState" | "decline" | "confirmClose" | "textTooShortError" | "textTooLongError" | "selectTooShortError" | "selectTooLongError" | "numberTooSmallError" | "numberTooBigError" | "passwordNotMatchError" | "selectDateError" | "priceUnit" | "passwordConfirm" | "noOptions" | "noSelection" | "addModel" | "createModel" | "createSuccess" | "updateModel" | "removeModel" | "updateSuccess" | "removeSuccess" | "sureToRemove" | "irreversibleOps" | "typeNameToRemove" | "yesRemove" | "removeMsg" | "confirmMsg" | "perPage" | "cardView" | "tableView" | "exportCsv" | "exportJson" | "actions" | "draftConflict" | "draftApplied" | "draftRestore" | "draftDiscard" | "draftStartOver" | "new" | "view"> | import("./locale.d.ts").ScalarTranslatorKey<"agentTurn", AgentTurn, never> | `agentStop.${string}` | `agentStop.${string}.desc` | import("./locale.d.ts").ServiceTranslatorKey<"agent", AgentEndpoint, never>, __Error_Key__: "base.error.gatewayTimeout" | "base.error.tooManyRequests" | "base.error.serverUnavailable" | "base.error.serverUnreachable" | "base.error.idempotencyInFlight" | "base.error.unexpectedResponse" | "base.error.immutableField" | "base.error.relationNotFound" | "base.error.endpointClosed" | "agent.error.llmUnavailable" | "agent.error.llmRequestFailed" | "agent.error.contextOverflow" | "agent.error.quotaExceeded";

package/types/service/adapt.d.ts

@@ -10,6 +10,6 @@ export type AdaptorCls<Methods = any, InjectMap extends Record<string, InjectInf
     readonly [INJECT_META]: InjectMap;
     readonly refName: string;
 }>;
-export declare function adapt<Name extends string>(name: Name): AdaptorCls;
+export declare function adapt<Name extends string>(name: Name): AdaptorCls<{}>;
 export declare function adapt<Name extends string, Injection extends InjectBuilder<"use" | "env" | "memory" | "plug">>(name: Name, injectBuilder: Injection): AdaptorCls<{}, ReturnType<Injection>>;
 export declare function dangerouslyAdapt<Name extends string, Injection extends InjectBuilder>(name: Name, injectBuilder: Injection): AdaptorCls<{}, ReturnType<Injection>>;

package/types/ui/Layout/BottomInset.d.ts

@@ -11,4 +11,4 @@ export interface BottomInsetProps {
     frameSource?: FrameSlotRegistration["source"];
     frameCache?: boolean;
 }
-export declare const BottomInset: ({ className, children, keyboardSticky, contentAnchor, role, estimatedHeight, frameScope, frameSource, frameCache, }: BottomInsetProps) => import("react").JSX.Element;
+export declare const BottomInset: ({ className, children, keyboardSticky, contentAnchor, role, estimatedHeight, frameScope, frameSource, frameCache, }: BottomInsetProps) => import("react").JSX.Element | null;

package/types/ui/Layout/Navbar.d.ts

@@ -11,4 +11,4 @@ export interface NavbarProps {
     left?: ReactNode;
     right?: ReactNode;
 }
-export declare const Navbar: ({ back, backFallback, className, height, children, title, left, right, }: NavbarProps) => import("react").JSX.Element;
+export declare const Navbar: ({ back, backFallback, className, height, children, title, left, right, }: NavbarProps) => import("react").JSX.Element | null;

package/types/ui/Layout/TopInset.d.ts

@@ -4,9 +4,9 @@ export interface TopInsetProps {
     children: ReactNode;
     estimatedHeight?: number;
 }
-export declare const TopInset: ({ className, children, estimatedHeight }: TopInsetProps) => import("react").JSX.Element;
+export declare const TopInset: ({ className, children, estimatedHeight }: TopInsetProps) => import("react").JSX.Element | null;
 export interface TopLeftActionProps {
     className?: string;
     children: ReactNode;
 }
-export declare const TopLeftAction: ({ className, children }: TopLeftActionProps) => import("react").JSX.Element;
+export declare const TopLeftAction: ({ className, children }: TopLeftActionProps) => import("react").JSX.Element | null;

package/types/ui/Layout/index.d.ts

@@ -1,15 +1,15 @@
 export declare const Layout: {
     Header: ({ className, type, children, height }: import("./Header.d.ts").HeaderProps) => import("react").JSX.Element;
     Sider: ({ className, bgClassName, trigger, header, close, children }: import("./Sider.d.ts").SiderProps) => import("react").JSX.Element;
-    Navbar: ({ back, backFallback, className, height, children, title, left, right, }: import("./Navbar.d.ts").NavbarProps) => import("react").JSX.Element;
-    TopInset: ({ className, children, estimatedHeight }: import("./TopInset.d.ts").TopInsetProps) => import("react").JSX.Element;
+    Navbar: ({ back, backFallback, className, height, children, title, left, right, }: import("./Navbar.d.ts").NavbarProps) => import("react").JSX.Element | null;
+    TopInset: ({ className, children, estimatedHeight }: import("./TopInset.d.ts").TopInsetProps) => import("react").JSX.Element | null;
     BottomTab: ({ className, tabs, height, label, renderTab }: import("./BottomTab.d.ts").BottomTabProps) => import("react").JSX.Element;
-    BottomInset: ({ className, children, keyboardSticky, contentAnchor, role, estimatedHeight, frameScope, frameSource, frameCache, }: import("./BottomInset.d.ts").BottomInsetProps) => import("react").JSX.Element;
+    BottomInset: ({ className, children, keyboardSticky, contentAnchor, role, estimatedHeight, frameScope, frameSource, frameCache, }: import("./BottomInset.d.ts").BottomInsetProps) => import("react").JSX.Element | null;
     Template: ({ className, children }: import("./Role.d.ts").TemplateProps) => import("react").JSX.Element;
     Unit: ({ className, children, href }: import("./Role.d.ts").UnitProps) => import("react").JSX.Element;
     View: ({ className, children }: import("./Role.d.ts").ViewProps) => import("react").JSX.Element;
     Zone: ({ className, children }: import("./Role.d.ts").ZoneProps) => import("react").JSX.Element;
-    TopLeftAction: ({ className, children }: import("./TopInset.d.ts").TopLeftActionProps) => import("react").JSX.Element;
+    TopLeftAction: ({ className, children }: import("./TopInset.d.ts").TopLeftActionProps) => import("react").JSX.Element | null;
     LeftSider: ({ className, children, open, width, close, onCancel }: import("./Sider.d.ts").LeftSiderProps) => import("react").JSX.Element;
     RightSider: ({ className, children, open, title, width, close, onCancel }: import("./Sider.d.ts").RightSiderProps) => import("react").JSX.Element;
 };

package/types/vendor/@akanjs/native/packages/cli/src/platforms/windows-installer.d.ts

@@ -39,11 +39,12 @@ export interface InstallerInput {
 }
 export declare function installerScript(input: InstallerInput): string;
 /**
- * Stops every process running from the install folder, waits (up to 10 s) until they are gone, and exits 1 when
- * one is left or cannot be seen. Through WMI: the installer is a 32-bit program, so its PowerShell is too, and a
- * 32-bit process cannot read a 64-bit one's path (Get-Process's Path comes back empty).
+ * Stops every process running from the install folder, again for one started meanwhile, until none is left (up to
+ * 10 s); given the app's exe, deletes it in the pass that finds none, so nothing can start it again. Exits 1 when a
+ * process (or the exe) is left or cannot be seen. Through WMI: the installer is a 32-bit program, so its PowerShell
+ * is too, and a 32-bit process cannot read a 64-bit one's path (Get-Process's Path comes back empty).
  */
-export declare const STOP_SCRIPT = "param([string]$Dir)\n$ErrorActionPreference = 'Stop'\n$prefix = [IO.Path]::GetFullPath($Dir).TrimEnd('\\') + '\\'\n$running = { Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -and $_.ExecutablePath.StartsWith($prefix, [StringComparison]::OrdinalIgnoreCase) } }\n& $running | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }\nfor ($i = 0; $i -lt 50 -and (& $running); $i++) { Start-Sleep -Milliseconds 200 }\nif (& $running) { exit 1 }\n";
+export declare const STOP_SCRIPT = "param([string]$Dir, [string]$Exe = '')\n$ErrorActionPreference = 'Stop'\n$prefix = [IO.Path]::GetFullPath($Dir).TrimEnd('\\') + '\\'\n$running = { Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -and $_.ExecutablePath.StartsWith($prefix, [StringComparison]::OrdinalIgnoreCase) } }\nfor ($i = 0; $i -lt 50; $i++) {\n  $left = @(& $running)\n  if ($left.Count -eq 0) {\n    if (-not $Exe) { exit 0 }\n    Remove-Item -LiteralPath $Exe -Force -ErrorAction SilentlyContinue\n    if (-not (Test-Path -LiteralPath $Exe)) { exit 0 }\n  }\n  $left | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }\n  Start-Sleep -Milliseconds 200\n}\nif ((& $running) -or ($Exe -and (Test-Path -LiteralPath $Exe))) { exit 1 }\n";
 /** The longest path under `folder`, relative and with Windows separators. Links are not followed. */
 export declare function deepestPath(folder: string): string;
 /** The bytes of the files under `folder`, and what they take on disk. Links are not followed. */

package/types/vendor/@akanjs/native/packages/desktop/src/dispatcher.d.ts

@@ -4,6 +4,11 @@ import type { Lifecycle } from "./lifecycle.ts";
 import type { DesktopPlugin, DesktopServerStatus, Launch, NativeEvent } from "./plugin.ts";
 /** How long the window waits for one plugin's setup. */
 export declare const SETUP_TIMEOUT_MS = 3000;
+/**
+ * How long the launch waits for a gate plugin's setup. A gate decides whether this launch runs at all, so passing it
+ * by on time starts what the losing launch must not: a second app's server on the same data (single-instance).
+ */
+export declare const GATE_TIMEOUT_MS = 30000;
 /**
  * How long a page's call to a plugin whose setup is still running (it outlasted SETUP_TIMEOUT_MS)
  * waits for it before it is answered INTERNAL with `retryable`.
@@ -90,6 +95,7 @@ export declare class CallIds {
 export declare const COALESCE_MS = 100;
 export interface DispatcherOptions {
     setupTimeoutMs?: number;
+    gateTimeoutMs?: number;
     setupWaitMs?: number;
     /** The app's resolved capabilities from boot.json (PL-11). Absent: everything is allowed. */
     acl?: ResolvedAcl | null;

package/types/vendor/@akanjs/native/plugins/single-instance/src/socket.d.ts

@@ -4,7 +4,7 @@ import type { SecondInstance } from "./index.ts";
  * are one namespace for the whole PC, so the user is part of the hash there; other users cannot
  * write to a pipe they did not create (its default security), so they cannot pose as it either.
  */
-export declare function socketPath(appId: string, env?: Record<string, string | undefined>, platform?: NodeJS.Platform): string;
+export declare function socketPath(appId: string, env?: Record<string, string | undefined>, platform?: NodeJS.Platform, profile?: string): string;
 export declare function encodeMessage(message: SecondInstance): string;
 export declare function decodeMessage(line: string): SecondInstance | null;
 export type Claim = {

package/types/vendor/use-agentic/AgentActivity.d.ts

@@ -1,6 +1,8 @@
 import { type ReactNode } from "react";
 export interface AgentActivityProps {
     active: boolean;
+    /** Guidance stays published while inactive: the subtree is off screen, but what it says about the route holds. */
+    keepGuides?: boolean;
     children: ReactNode;
 }
 /**
@@ -8,4 +10,4 @@ export interface AgentActivityProps {
  * it, like the page under the one on screen. Registrations stay in place, so turning it back on re-publishes them
  * without a remount. A registry that lives outside the surface reads the same gate through `useAgentGate()`.
  */
-export declare const AgentActivity: ({ active, children }: AgentActivityProps) => import("react").JSX.Element;
+export declare const AgentActivity: ({ active, keepGuides, children }: AgentActivityProps) => import("react").JSX.Element;

package/types/vendor/use-agentic/AgenticSurface.d.ts

@@ -38,9 +38,9 @@ export declare class AgenticSurface {
     /**
      * This surface for a subtree behind `gate`: what registers through it is published only while the gate is active,
      * and every other call reaches this surface untouched. A proxy rather than a wrapper class, so a method added to the
-     * surface later is forwarded instead of missing.
+     * surface later is forwarded instead of missing. Guidance follows `guideGate` instead when one is named.
      */
-    gated(gate: AgentGate): AgenticSurface;
+    gated(gate: AgentGate, guideGate?: AgentGate | null): AgenticSurface;
     snapshot(view?: string[]): SurfaceSnapshot;
     /**
      * A zone session's reading half: the same registry filtered to one scope subtree. Hook entries filter by their

package/types/webkit/EmbeddedLayout.d.ts

@@ -0,0 +1,10 @@
+import { type ReactNode } from "react";
+interface EmbeddedLayoutProps {
+    children: ReactNode;
+}
+export declare const EmbeddedLayout: ({ children }: EmbeddedLayoutProps) => import("react").JSX.Element;
+interface LayoutOutletProps {
+    children: ReactNode;
+}
+export declare const LayoutOutlet: ({ children }: LayoutOutletProps) => import("react").ReactPortal | null;
+export {};

package/types/webkit/RenderLayer.d.ts

@@ -6,6 +6,8 @@ interface RenderLayerProps {
     params: Record<string, string>;
     searchParams: Record<string, string | string[]>;
     leaf?: ReactNode;
+    /** A page in an MCP view: every layout above it runs, and only the page is shown. */
+    isEmbedded?: boolean;
 }
-export declare const RenderLayer: import("react").MemoExoticComponent<({ renders, index, params, searchParams, leaf }: RenderLayerProps) => import("react").JSX.Element | null>;
+export declare const RenderLayer: import("react").MemoExoticComponent<(props: RenderLayerProps) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined>;
 export {};

package/ui/Layout/BottomInset.tsx

@@ -1,6 +1,13 @@
 "use client";
 import { getEnv } from "akanjs/base";
-import { cn, DEFAULT_BOTTOM_INSET, debugFrame, type FrameSlotRegistration, usePathCtx } from "akanjs/client";
+import {
+  cn,
+  DEFAULT_BOTTOM_INSET,
+  debugFrame,
+  type FrameSlotRegistration,
+  useInHiddenLayout,
+  usePathCtx,
+} from "akanjs/client";
 import { type ReactNode, useLayoutEffect, useState } from "react";
 
 import { Portal } from "../Portal";
@@ -33,6 +40,7 @@ export const BottomInset = ({
   
   const [contentElement, setContentElement] = useState<HTMLDivElement | null>(null);
   const pathCtx = usePathCtx();
+  const isHidden = useInHiddenLayout();
   const pathRoute = pathCtx.location?.pathRoute;
   const path = pathCtx.location?.pathRoute?.path;
   const registerFrameSlot = pathCtx.registerFrameSlot ?? (() => () => undefined);
@@ -61,7 +69,7 @@ export const BottomInset = ({
     return () => debugFrame("bottomInset.unmount", { path, frameSource });
   }, [path, keyboardSticky, contentAnchor, frameRole, frameScope, frameSource]);
   useLayoutEffect(() => {
-    if (!path) return;
+    if (!path || isHidden) return;
     const height = useDeclaredHeight ? resolvedEstimatedHeight : (measuredHeight ?? readContentHeight());
     return registerFrameSlot({
       type: "bottomInset",
@@ -84,6 +92,7 @@ export const BottomInset = ({
     frameCache,
     path,
     useDeclaredHeight,
+    isHidden,
   ]);
   useLayoutEffect(() => {
     const element = contentElement;
@@ -102,6 +111,7 @@ export const BottomInset = ({
     observer.observe(element);
     return () => observer.disconnect();
   }, [contentElement]);
+  if (isHidden) return null;
 
   const content = (
     <div

package/ui/Layout/Navbar.tsx

@@ -1,6 +1,14 @@
 "use client";
 import { getEnv } from "akanjs/base";
-import { cn, DEFAULT_TOP_INSET, debugFrame, type TransitionType, usePathCtx } from "akanjs/client";
+import {
+  cn,
+  DEFAULT_TOP_INSET,
+  debugFrame,
+  type TransitionType,
+  useCsr,
+  useInHiddenLayout,
+  usePathCtx,
+} from "akanjs/client";
 import { type ReactNode, useLayoutEffect } from "react";
 import { BiChevronLeft, BiX } from "react-icons/bi";
 
@@ -34,8 +42,14 @@ export const Navbar = ({
   right,
 }: NavbarProps) => {
   const pathCtx = usePathCtx();
+  const { history } = useCsr();
+  const isHidden = useInHiddenLayout();
   const pathRoute = pathCtx.location?.pathRoute;
   const path = pathRoute?.path;
+  const entryId = pathCtx.location?.entryId;
+  
+  const isViewStart = !!globalThis.__AKAN_EMBED__ && !!entryId && history.current?.locations[0]?.entryId === entryId;
+  const shownBack = isViewStart ? false : back;
   const BackIcon = closeIconTransitions.has(pathRoute?.pageState.transition ?? "none") ? BiX : BiChevronLeft;
   const registerFrameSlot = pathCtx.registerFrameSlot ?? (() => () => undefined);
   const suffix = getEnv().renderMode === "csr" && path ? `-${pathCtx.pageKey ?? path}` : "";
@@ -45,7 +59,7 @@ export const Navbar = ({
     return () => debugFrame("navbar.unmount", { path, height });
   }, [path, height]);
   useLayoutEffect(() => {
-    if (!path) return;
+    if (!path || isHidden) return;
     return registerFrameSlot({
       type: "topInset",
       scope: "page",
@@ -53,9 +67,10 @@ export const Navbar = ({
       estimatedHeight: height ?? DEFAULT_TOP_INSET,
       height,
     });
-  }, [registerFrameSlot, height, path]);
+  }, [registerFrameSlot, height, path, isHidden]);
+  if (isHidden) return null;
   const bar = (
-    <div className={cn("flex size-full items-center gap-2 px-5", back && "pl-14", className)}>
+    <div className={cn("flex size-full items-center gap-2 px-5", shownBack && "pl-14", className)}>
       {left ? <div className="flex shrink-0 items-center gap-1">{left}</div> : null}
       {title ? <div className="min-w-0 flex-1 truncate font-semibold text-base">{title}</div> : null}
       {children}
@@ -63,19 +78,19 @@ export const Navbar = ({
     </div>
   );
   const backButton =
-    back === true ? (
+    shownBack === true ? (
       <Link.Back className="text-4xl" fallback={backFallback}>
         <BackIcon />
       </Link.Back>
     ) : (
-      back
+      shownBack
     );
   return (
     <>
       <Portal id={`topInsetContent${suffix}`} fallback={<FrameSlotFallback slot="topInset">{bar}</FrameSlotFallback>}>
         {bar}
       </Portal>
-      {back ? (
+      {shownBack ? (
         <Portal
           id={`topLeftActionContent${suffix}`}
           fallback={<FrameSlotFallback slot="topLeftAction">{backButton}</FrameSlotFallback>}

package/ui/Layout/TopInset.tsx

@@ -1,6 +1,6 @@
 "use client";
 import { getEnv } from "akanjs/base";
-import { cn, DEFAULT_TOP_INSET, debugFrame, usePathCtx } from "akanjs/client";
+import { cn, DEFAULT_TOP_INSET, debugFrame, useInHiddenLayout, usePathCtx } from "akanjs/client";
 import { type ReactNode, useLayoutEffect } from "react";
 
 import { Portal } from "../Portal";
@@ -14,6 +14,7 @@ export interface TopInsetProps {
 
 export const TopInset = ({ className, children, estimatedHeight = DEFAULT_TOP_INSET }: TopInsetProps) => {
   const pathCtx = usePathCtx();
+  const isHidden = useInHiddenLayout();
   const path = pathCtx.location?.pathRoute?.path;
   const registerFrameSlot = pathCtx.registerFrameSlot ?? (() => () => undefined);
   const suffix = getEnv().renderMode === "csr" && path ? `-${pathCtx.pageKey ?? path}` : "";
@@ -24,14 +25,15 @@ export const TopInset = ({ className, children, estimatedHeight = DEFAULT_TOP_IN
     return () => debugFrame("topInset.unmount", { path, estimatedHeight });
   }, [path, estimatedHeight]);
   useLayoutEffect(() => {
-    if (!path) return;
+    if (!path || isHidden) return;
     return registerFrameSlot({
       type: "topInset",
       scope: "page",
       source: "topInset",
       estimatedHeight,
     });
-  }, [registerFrameSlot, estimatedHeight, path]);
+  }, [registerFrameSlot, estimatedHeight, path, isHidden]);
+  if (isHidden) return null;
 
   const content = (
     <div data-akan-frame-slot="topInset" data-akan-frame-role="topChrome" className={cn("size-full", className)}>
@@ -52,6 +54,8 @@ export interface TopLeftActionProps {
 
 export const TopLeftAction = ({ className, children }: TopLeftActionProps) => {
   const pathCtx = usePathCtx();
+  const isHidden = useInHiddenLayout();
+  if (isHidden) return null;
   const path = pathCtx.location?.pathRoute?.path;
   const suffix = getEnv().renderMode === "csr" && path ? `-${pathCtx.pageKey ?? path}` : "";
   const content = <div className={className}>{children}</div>;

package/ui/Model/ViewEditModal.tsx

@@ -1,5 +1,5 @@
 "use client";
-import { usePage } from "akanjs/client";
+import { fetch, usePage } from "akanjs/client";
 import { capitalize } from "akanjs/common";
 import type { SliceMeta } from "akanjs/fetch";
 import { st } from "akanjs/store";
@@ -110,6 +110,10 @@ export default function ViewEditModal({
   const modelLoading = storeUse[names.modelLoading]() as string | boolean;
   const modelFormLoading = storeUse[names.modelFormLoading]() as string | boolean;
   const modelFormId = storeSel<string, { id: string }>((state) => state[names.modelForm].id);
+  
+  const servedFetch = fetch as unknown as { [key: string]: unknown };
+  const canUpdate = typeof servedFetch[`update${ModelName}`] === "function";
+  const canRemove = typeof servedFetch[`remove${ModelName}`] === "function";
   const isModalOpen = modelModal === "view" || (modelModal === "edit" && (!!modelFormLoading || !!modelFormId));
   const Title = () => {
     if (!model || modelLoading || !renderTitle) return <></>;
@@ -133,7 +137,7 @@ export default function ViewEditModal({
       title={
         <div className="flex w-full items-center justify-between">
           <Title />
-          {menu === false
+          {menu === false || (menu === undefined && !canRemove)
             ? null
             : (menu ?? (
                 <Dropdown
@@ -159,14 +163,16 @@ export default function ViewEditModal({
       }
       action={
         modelModal === "view" ? (
-          <EditAction
-            modelName={modelName}
-            label={editLabel ?? l("base.edit")}
-            closeView={closeView}
-            onAct={() => {
-              if (model) storeDo[names.editModel](model.id);
-            }}
-          />
+          canUpdate ? (
+            <EditAction
+              modelName={modelName}
+              label={editLabel ?? l("base.edit")}
+              closeView={closeView}
+              onAct={() => {
+                if (model) storeDo[names.editModel](model.id);
+              }}
+            />
+          ) : null
         ) : (
           <SaveAction
             modelName={modelName}

package/ui/Select.tsx

@@ -95,14 +95,19 @@ const DefaultSelect = <
   renderSelected,
 }: SelectProps<T, Multiple, Searchable, Option>) => {
   useFieldTool(onChange, { disabled });
-  const { l } = usePage();
+  const { l, lang } = usePage();
   const [isOpen, setIsOpen] = useState(false);
   const labeledOptions: LabelOption<T>[] = useMemo(() => {
-    if (isEnum(options as Cls))
-      return (options as EnumInstance<string, T>).values.map((v) => ({
-        label: typeof v === "string" ? v : typeof v === "object" ? JSON.stringify(v) : String(v),
-        value: v,
-      }));
+    if (isEnum(options as Cls)) {
+      const { refName, values } = options as EnumInstance<string, T>;
+      return values.map((v) => {
+        if (typeof v === "object") return { label: JSON.stringify(v), value: v };
+        const key = `${refName}.${String(v)}`;
+        const label = l._(key);
+        
+        return { label: label === key ? String(v) : label, value: v };
+      });
+    }
     const list = options as (T | LabelOption<T>)[];
     const first = list[0];
     
@@ -110,7 +115,7 @@ const DefaultSelect = <
     return isLabeled
       ? (list as LabelOption<T>[])
       : (list as T[]).map((v) => ({ label: v as string | boolean | number, value: v }));
-  }, [options]);
+  }, [options, lang]);
 
   const [searchText, setSearchText] = useState("");
   const portal = useOverlayPortal();

package/ui/System/CSR.tsx

@@ -483,7 +483,13 @@ const CSRPageContainer = ({ entry, prefix, layoutStyle }: CSRPageContainerProps)
             location={location}
             prefix={prefix}
           >
-            <RenderLayer renders={renders} index={0} params={location.params} searchParams={location.searchParams} />
+            <RenderLayer
+              renders={renders}
+              index={0}
+              params={location.params}
+              searchParams={location.searchParams}
+              isEmbedded={Boolean(globalThis.__AKAN_EMBED__)}
+            />
           </ClientPathWrapper>
         </animated.div>,
         pageContainers,

package/ui/System/Client.tsx

@@ -189,6 +189,7 @@ export const ClientPathWrapper = ({
           searchParams,
           search,
           pathRoute,
+          ...(location?.entryId ? { entryId: location.entryId } : {}),
         },
         prefix,
         gestureEnabled,

package/vendor/@akanjs/native/packages/cli/src/platforms/windows-installer.ts

@@ -87,6 +87,9 @@ ManifestDPIAware true
 ManifestLongPathAware true
 SetCompressor /SOLID lzma
 RequestExecutionLevel user
+; /S does not hide NSIS's "Verifying installer" window (only a script's SilentInstall does), and a large setup takes
+; over a second to verify, so the window painted over a kiosk. A truncated setup still fails to unpack into .setup-new.
+CRCCheck off
 
 !include "MUI2.nsh"
 !include "FileFunc.nsh"
@@ -188,8 +191,9 @@ FunctionEnd
 ${removal(input.entries)}
 !macroend
 
+; $R6 is 1 when the folder held the app's exe before the uninstall stopped the app and deleted it.
 !macro RemoveApp
-  \${If} \${FileExists} "$INSTDIR\\\${EXE}"
+  \${If} $R6 == 1
     !insertmacro RemoveTree "$INSTDIR"
   \${Else}
     !insertmacro RemoveEntries
@@ -358,7 +362,9 @@ Section "Install"
     !insertmacro Fail "The uninstaller could not be written to $INSTDIR.setup-uninstall.exe. \${APP_NAME} is left as it was."
   \${EndIf}
   File "/oname=$PLUGINSDIR\\stop-app.ps1" "${nsis(input.stopScript)}"
-  nsExec::Exec 'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$PLUGINSDIR\\stop-app.ps1" "$INSTDIR"'
+  ; nsExec waits forever by default: a stop script that hung once kept a setup waiting 16 minutes. Past the deadline it
+  ; is ended and answers "timeout", which counts as a failed stop.
+  nsExec::Exec /TIMEOUT=60000 'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$PLUGINSDIR\\stop-app.ps1" "$INSTDIR"'
   Pop $0
   \${If} $0 == 0
     StrCpy $AppStopped 1
@@ -438,9 +444,19 @@ FunctionEnd
 
 Section "Uninstall"
   InitPluginsDir
+  StrCpy $R6 0
+  \${If} \${FileExists} "$INSTDIR\\\${EXE}"
+    StrCpy $R6 1
+  \${EndIf}
   File "/oname=$PLUGINSDIR\\stop-app.ps1" "${nsis(input.stopScript)}"
-  nsExec::Exec 'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$PLUGINSDIR\\stop-app.ps1" "$INSTDIR"'
+  ; With the exe named, the script deletes it in the pass that finds nothing running: a watchdog that starts the app
+  ; again between a stop and a later delete kept the exe, and Delete /REBOOTOK needs an administrator.
+  nsExec::Exec /TIMEOUT=60000 'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File "$PLUGINSDIR\\stop-app.ps1" "$INSTDIR" "$INSTDIR\\\${EXE}"'
   Pop $0
+  \${If} $0 != 0
+    DetailPrint "$INSTDIR\\\${EXE} is still running and stays behind."
+    SetErrorLevel 2
+  \${EndIf}
   Delete "$SMPROGRAMS\\\${APP_NAME}.lnk"
   !insertmacro RemoveTree "$INSTDIR.previous"
   !insertmacro RemoveSiblings "update-"
@@ -465,17 +481,26 @@ SectionEnd
 }
 
 /**
- * Stops every process running from the install folder, waits (up to 10 s) until they are gone, and exits 1 when
- * one is left or cannot be seen. Through WMI: the installer is a 32-bit program, so its PowerShell is too, and a
- * 32-bit process cannot read a 64-bit one's path (Get-Process's Path comes back empty).
+ * Stops every process running from the install folder, again for one started meanwhile, until none is left (up to
+ * 10 s); given the app's exe, deletes it in the pass that finds none, so nothing can start it again. Exits 1 when a
+ * process (or the exe) is left or cannot be seen. Through WMI: the installer is a 32-bit program, so its PowerShell
+ * is too, and a 32-bit process cannot read a 64-bit one's path (Get-Process's Path comes back empty).
  */
-export const STOP_SCRIPT = `param([string]$Dir)
+export const STOP_SCRIPT = `param([string]$Dir, [string]$Exe = '')
 $ErrorActionPreference = 'Stop'
 $prefix = [IO.Path]::GetFullPath($Dir).TrimEnd('\\') + '\\'
 $running = { Get-CimInstance Win32_Process | Where-Object { $_.ExecutablePath -and $_.ExecutablePath.StartsWith($prefix, [StringComparison]::OrdinalIgnoreCase) } }
-& $running | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }
-for ($i = 0; $i -lt 50 -and (& $running); $i++) { Start-Sleep -Milliseconds 200 }
-if (& $running) { exit 1 }
+for ($i = 0; $i -lt 50; $i++) {
+  $left = @(& $running)
+  if ($left.Count -eq 0) {
+    if (-not $Exe) { exit 0 }
+    Remove-Item -LiteralPath $Exe -Force -ErrorAction SilentlyContinue
+    if (-not (Test-Path -LiteralPath $Exe)) { exit 0 }
+  }
+  $left | ForEach-Object { Stop-Process -Id $_.ProcessId -Force -ErrorAction SilentlyContinue }
+  Start-Sleep -Milliseconds 200
+}
+if ((& $running) -or ($Exe -and (Test-Path -LiteralPath $Exe))) { exit 1 }
 `;
 
 /** The longest path under `folder`, relative and with Windows separators. Links are not followed. */

package/vendor/@akanjs/native/packages/desktop/src/dispatcher.ts

@@ -33,6 +33,12 @@ import type {
 /** How long the window waits for one plugin's setup. */
 export const SETUP_TIMEOUT_MS = 3000;
 
+/**
+ * How long the launch waits for a gate plugin's setup. A gate decides whether this launch runs at all, so passing it
+ * by on time starts what the losing launch must not: a second app's server on the same data (single-instance).
+ */
+export const GATE_TIMEOUT_MS = 30_000;
+
 /**
  * How long a page's call to a plugin whose setup is still running (it outlasted SETUP_TIMEOUT_MS)
  * waits for it before it is answered INTERNAL with `retryable`.
@@ -189,6 +195,7 @@ export const COALESCE_MS = 100;
 
 export interface DispatcherOptions {
   setupTimeoutMs?: number;
+  gateTimeoutMs?: number;
   setupWaitMs?: number;
   /** The app's resolved capabilities from boot.json (PL-11). Absent: everything is allowed. */
   acl?: ResolvedAcl | null;
@@ -301,18 +308,19 @@ export function createDispatcher(
   };
 
   const timeout = options.setupTimeoutMs ?? SETUP_TIMEOUT_MS;
+  const gateTimeout = options.gateTimeoutMs ?? GATE_TIMEOUT_MS;
   /** Setups still running (plugin lifecycle rule: calls and $listen wait for them). */
   const settingUp = new Map<string, Promise<unknown>>();
-  const setUp = async (plugin: DesktopPlugin) => {
+  const setUp = async (plugin: DesktopPlugin, limit = timeout) => {
     let timer: ReturnType<typeof setTimeout> | undefined;
     try {
       const done = Promise.resolve(plugin.setup?.(context(plugin)));
       settingUp.set(plugin.id, done);
       const forget = () => void settingUp.delete(plugin.id);
       done.then(forget, forget);
-      const late = new Promise<"late">((resolve) => (timer = setTimeout(() => resolve("late"), timeout)));
+      const late = new Promise<"late">((resolve) => (timer = setTimeout(() => resolve("late"), limit)));
       if ((await Promise.race([done, late])) === "late")
-        console.warn(`[akan-native] ${plugin.id} setup took over ${timeout} ms; creating the window anyway`);
+        console.warn(`[akan-native] ${plugin.id} setup took over ${limit} ms; creating the window anyway`);
     } catch (error) {
       console.error(`[akan-native] ${plugin.id} setup failed`, error);
     } finally {
@@ -322,10 +330,10 @@ export function createDispatcher(
   
   const setups = (async () => {
     for (const plugin of plugins.filter((p) => p.launchPhase === "gate")) {
-      await setUp(plugin);
+      await setUp(plugin, gateTimeout);
       if (launch.exit !== undefined) return;
     }
-    await Promise.all(plugins.filter((p) => p.launchPhase !== "gate").map(setUp));
+    await Promise.all(plugins.filter((p) => p.launchPhase !== "gate").map((plugin) => setUp(plugin)));
   })();
   const launched = setups.then(() => {
     launching = false;

package/vendor/@akanjs/native/plugins/single-instance/src/desktop.ts

@@ -20,6 +20,10 @@ export function createDesktopSingleInstance(
   let listens = 0;
 
   const received = (ctx: DesktopContext, message: SecondInstance) => {
+    
+    console.info(
+      `[akan-native] single-instance: a second launch handed over to this one (${message.args.length} arguments)`,
+    );
     bringToFront(ctx).catch((error) => console.error("[akan-native] single-instance: cannot focus the window", error));
     
     ctx.openLinks(message.args);

package/vendor/@akanjs/native/plugins/single-instance/src/socket.ts

@@ -4,7 +4,7 @@ import { dlopen, FFIType } from "bun:ffi";
 import { createHash } from "node:crypto";
 import { chmodSync, closeSync, constants, openSync, rmSync } from "node:fs";
 import { connect, createServer, type Server, type Socket } from "node:net";
-import { tmpdir } from "node:os";
+import { tmpdir, userInfo } from "node:os";
 import { join } from "node:path";
 import type { SecondInstance } from "./index.ts";
 
@@ -13,6 +13,14 @@ const ACK = "ok\n";
 /** One message is a few KiB of arguments; anything larger is not from us. */
 const MAX_MESSAGE = 256 * 1024;
 
+const profileFolder = (env: Record<string, string | undefined>) => {
+  try {
+    return userInfo().homedir;
+  } catch {
+    return env.USERPROFILE ?? env.USERNAME ?? "";
+  }
+};
+
 /**
  * sun_path is 104 bytes on macOS, so the name is a short hash, not the app id. Windows pipe names
  * are one namespace for the whole PC, so the user is part of the hash there; other users cannot
@@ -22,12 +30,11 @@ export function socketPath(
   appId: string,
   env: Record<string, string | undefined> = process.env,
   platform: NodeJS.Platform = process.platform,
+  profile = platform === "win32" ? profileFolder(env) : "",
 ): string {
   if (platform === "win32") {
-    const hash = createHash("sha256")
-      .update(`${env.USERDOMAIN ?? ""}\\${env.USERNAME ?? ""}\0${appId}`)
-      .digest("hex")
-      .slice(0, 16);
+
+    const hash = createHash("sha256").update(`${profile.toLowerCase()}\0${appId}`).digest("hex").slice(0, 16);
     return `\\\\.\\pipe\\akan-native-${hash}`;
   }
   const dir = env.XDG_RUNTIME_DIR || env.TMPDIR || tmpdir();

package/vendor/use-agentic/AgentActivity.tsx

@@ -4,6 +4,8 @@ import { GateContext, SurfaceContext, useAgentGate, useSurface } from "./surface
 
 export interface AgentActivityProps {
   active: boolean;
+  /** Guidance stays published while inactive: the subtree is off screen, but what it says about the route holds. */
+  keepGuides?: boolean;
   children: ReactNode;
 }
 
@@ -12,11 +14,11 @@ export interface AgentActivityProps {
  * it, like the page under the one on screen. Registrations stay in place, so turning it back on re-publishes them
  * without a remount. A registry that lives outside the surface reads the same gate through `useAgentGate()`.
  */
-export const AgentActivity = ({ active, children }: AgentActivityProps) => {
+export const AgentActivity = ({ active, keepGuides = false, children }: AgentActivityProps) => {
   const surface = useSurface();
   const parent = useAgentGate();
   const gate = useMemo(() => surface.gate(active, parent), [surface, parent]);
-  const gated = useMemo(() => surface.gated(gate), [surface, gate]);
+  const gated = useMemo(() => surface.gated(gate, keepGuides ? parent : gate), [surface, gate, parent, keepGuides]);
   useLayoutEffect(() => gate.set(active), [gate, active]);
   return (
     <SurfaceContext.Provider value={gated}>

package/vendor/use-agentic/AgenticSurface.ts

@@ -127,14 +127,14 @@ export class AgenticSurface {
   /**
    * This surface for a subtree behind `gate`: what registers through it is published only while the gate is active,
    * and every other call reaches this surface untouched. A proxy rather than a wrapper class, so a method added to the
-   * surface later is forwarded instead of missing.
+   * surface later is forwarded instead of missing. Guidance follows `guideGate` instead when one is named.
    */
-  gated(gate: AgentGate): AgenticSurface {
+  gated(gate: AgentGate, guideGate: AgentGate | null = gate): AgenticSurface {
     const registrations: Partial<Record<PropertyKey, unknown>> = {
       registerTool: (scope: string[], entry: ToolEntry) => this.registerTool(scope, entry, gate),
       registerResource: (scope: string[], entry: ResourceEntry) => this.registerResource(scope, entry, gate),
       openScope: (parent: string[], scope: ScopeEntry) => this.openScope(parent, scope, gate),
-      registerGuide: (scope: string[], text: string) => this.registerGuide(scope, text, gate),
+      registerGuide: (scope: string[], text: string) => this.registerGuide(scope, text, guideGate),
     };
     
     const bound = new Map<PropertyKey, unknown>();

package/webkit/CsrRouteTable.ts

@@ -190,7 +190,8 @@ export class CsrRouteTable {
     ): PathRoute[] => {
       const layer = RouteLayering.of(route, parent);
       const { path, pathSegments } = layer;
-      const currentLayoutConfig = route.renderLayout && route.layoutPageConfig ? route.layoutPageConfig : null;
+      const currentLayoutConfig =
+        route.renderLayout && route.layoutPageConfig ? CsrRouteTable.#layoutConfigOf(route.layoutPageConfig) : null;
       const pageConfigChain = [...parentPageConfigChain, ...(currentLayoutConfig ? [currentLayoutConfig] : [])];
       const pageRenderConfigChain =
         route.pageIncludesOwnLayout === false && route.renderLayout ? parentPageConfigChain : pageConfigChain;
@@ -250,6 +251,12 @@ export class CsrRouteTable {
     return Object.keys(context).sort();
   }
 
+  static #layoutConfigOf(config: PageConfig): PageConfig {
+    if (!globalThis.__AKAN_EMBED__) return config;
+    const { topInset: _top, bottomInset: _bottom, ...rest } = config;
+    return rest;
+  }
+
   static #paramNamesOf(pattern: string) {
     return pattern
       .split("/")

package/webkit/EmbeddedLayout.tsx

@@ -0,0 +1,77 @@
+"use client";
+import { hiddenLayoutContext } from "akanjs/client";
+import {
+  type ContextType,
+  createContext,
+  type ReactNode,
+  useCallback,
+  useContext,
+  useLayoutEffect,
+  useMemo,
+  useRef,
+  useState,
+} from "react";
+import { createPortal } from "react-dom";
+import { AgentActivity, GateContext, SurfaceContext } from "../vendor/use-agentic";
+
+interface EmbeddedLayoutValue {
+  target: HTMLElement | null;
+  onOutlet: (mounted: boolean) => void;
+  surface: ContextType<typeof SurfaceContext>;
+  gate: ContextType<typeof GateContext>;
+}
+const embeddedLayoutContext = createContext<EmbeddedLayoutValue | null>(null);
+
+interface EmbeddedLayoutProps {
+  children: ReactNode;
+}
+export const EmbeddedLayout = ({ children }: EmbeddedLayoutProps) => {
+  const surface = useContext(SurfaceContext);
+  const gate = useContext(GateContext);
+  const [target, setTarget] = useState<HTMLDivElement | null>(null);
+  const [drawsPage, setDrawsPage] = useState(true);
+  const outletRef = useRef(false);
+  const onOutlet = useCallback((mounted: boolean) => {
+    outletRef.current = mounted;
+    setDrawsPage(mounted);
+  }, []);
+  
+  useLayoutEffect(() => {
+    if (!outletRef.current) setDrawsPage(false);
+  });
+  const value = useMemo(() => ({ target, onOutlet, surface, gate }), [target, onOutlet, surface, gate]);
+  return (
+    <embeddedLayoutContext.Provider value={value}>
+      <div hidden={drawsPage}>
+        <hiddenLayoutContext.Provider value={drawsPage}>
+          <AgentActivity active={!drawsPage} keepGuides>
+            {children}
+          </AgentActivity>
+        </hiddenLayoutContext.Provider>
+      </div>
+      <div ref={setTarget} className="contents" />
+    </embeddedLayoutContext.Provider>
+  );
+};
+
+interface LayoutOutletProps {
+  children: ReactNode;
+}
+export const LayoutOutlet = ({ children }: LayoutOutletProps) => {
+  const embedded = useContext(embeddedLayoutContext);
+  const onOutlet = embedded?.onOutlet;
+  useLayoutEffect(() => {
+    if (!onOutlet) return;
+    onOutlet(true);
+    return () => onOutlet(false);
+  }, [onOutlet]);
+  if (!embedded?.target) return null;
+  return createPortal(
+    <SurfaceContext.Provider value={embedded.surface}>
+      <GateContext.Provider value={embedded.gate}>
+        <hiddenLayoutContext.Provider value={false}>{children}</hiddenLayoutContext.Provider>
+      </GateContext.Provider>
+    </SurfaceContext.Provider>,
+    embedded.target,
+  );
+};

package/webkit/RenderLayer.tsx

@@ -3,6 +3,7 @@ import { debugFrame, RouteDefinition, type RouteRender, router, usePathCtx } fro
 import { isThenable, Logger } from "akanjs/common";
 import { createContext, createElement, memo, type ReactNode, useContext, useEffect, useRef, useState } from "react";
 import { CsrFrameDump } from "./csrFrameDump";
+import { EmbeddedLayout, LayoutOutlet } from "./EmbeddedLayout";
 import { RenderFailure } from "./RenderFailure";
 import { useFetch } from "./useFetch";
 import { usePageActivity } from "./usePageActivity";
@@ -28,15 +29,28 @@ interface RenderLayerProps {
   params: Record<string, string>;
   searchParams: Record<string, string | string[]>;
   leaf?: ReactNode;
+  /** A page in an MCP view: every layout above it runs, and only the page is shown. */
+  isEmbedded?: boolean;
 }
-export const RenderLayer = memo(({ renders, index, params, searchParams, leaf = null }: RenderLayerProps) => {
+export const RenderLayer = memo((props: RenderLayerProps) => {
+  const { renders, index, params, searchParams, leaf = null, isEmbedded = false } = props;
   const isLast = index >= renders.length - 1;
-  const children = isLast ? (
+  const below = isLast ? (
     leaf
   ) : (
-    <RenderLayer renders={renders} index={index + 1} params={params} searchParams={searchParams} leaf={leaf} />
+    <RenderLayer
+      renders={renders}
+      index={index + 1}
+      params={params}
+      searchParams={searchParams}
+      leaf={leaf}
+      isEmbedded={isEmbedded}
+    />
   );
   const routeRender = renders[index];
+  const isEmbeddedLayout = isEmbedded && routeRender?.kind === "layout";
+  const children = isEmbeddedLayout ? <LayoutOutlet>{below}</LayoutOutlet> : below;
+  const frame = (drawn: ReactNode) => (isEmbeddedLayout ? <EmbeddedLayout>{drawn}</EmbeddedLayout> : drawn);
   const isAsyncRender = isAsyncRouteRender(routeRender);
   const renderedRef = useRef<RenderedRoute | null>(null);
   const [, setFailures] = useState(0);
@@ -106,7 +120,8 @@ export const RenderLayer = memo(({ renders, index, params, searchParams, leaf =
     };
   }, [record]);
   if (!routeRender) return null;
-  if (!isAsyncRender) return createElement(routeRender.render as never, { children, params, searchParams } as never);
+  if (!isAsyncRender)
+    return frame(createElement(routeRender.render as never, { children, params, searchParams } as never));
   const failure = renderedRef.current?.failure;
   if (failure)
     return (
@@ -119,7 +134,7 @@ export const RenderLayer = memo(({ renders, index, params, searchParams, leaf =
       />
     );
   if (!value) return <>{composeLoadingFallback(renders.slice(index), params)}</>;
-  return <layerChildContext.Provider value={children}>{value}</layerChildContext.Provider>;
+  return frame(<layerChildContext.Provider value={children}>{value}</layerChildContext.Provider>);
 });
 
 function reportFailure(result: ReactNode | Promise<ReactNode>, layer: string): ReactNode | Promise<ReactNode> {