npm - akanjs - Versions diffs - 3.0.0-alpha.54 → 3.0.0-alpha.55 - Mend

akanjs 3.0.0-alpha.54 → 3.0.0-alpha.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/local/apps/serverLifecycle/serverLifecycle-local.db-shm +0 -0
package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm +0 -0
package/package.json +1 -1
package/server/rscWorker.tsx +5 -13
package/server/webRouter.ts +3 -5
package/store/agent/StoreSurfaceSource.ts +9 -1
package/types/store/agent/StoreSurfaceSource.d.ts +9 -1
package/types/ui/Agent/Chat.d.ts +25 -4
package/types/ui/Agent/Zone.d.ts +23 -4
package/types/ui/Agent/agentSessionOf.d.ts +12 -3
package/types/ui/Agent/index.d.ts +1 -1
package/types/ui/Agent/sessionHistory.d.ts +1 -1
package/types/ui/Agent/sessionView.d.ts +15 -0
package/types/ui/RecentTime.d.ts +18 -1
package/types/ui/index.d.ts +5 -3
package/types/vendor/use-agentic/AgentProvider.d.ts +1 -2
package/types/vendor/use-agentic/AgentSession.d.ts +33 -6
package/types/vendor/use-agentic/AgenticSurface.d.ts +5 -0
package/ui/Agent/Chat.tsx +76 -36
package/ui/Agent/Zone.tsx +44 -12
package/ui/Agent/agentSessionOf.ts +23 -4
package/ui/Agent/sessionHistory.ts +10 -3
package/ui/Agent/sessionView.ts +38 -0
package/ui/RecentTime.tsx +83 -35
package/ui/System/Client.tsx +19 -7
package/ui/System/ThemeToggle.tsx +14 -5
package/ui/index.ts +29 -3
package/vendor/use-agentic/AgentProvider.tsx +1 -1
package/vendor/use-agentic/AgentSession.ts +84 -19
package/vendor/use-agentic/AgenticSurface.ts +9 -0

package/local/apps/serverLifecycle/serverLifecycle-local.db-shm CHANGED Viewed

Binary file

package/local/apps/serverLifecycle/serverLifecycle-local_solid.db-shm CHANGED Viewed

Binary file

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "akanjs",
-  "version": "3.0.0-alpha.54",
+  "version": "3.0.0-alpha.55",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {

package/server/rscWorker.tsx CHANGED Viewed

@@ -547,7 +547,6 @@ export class RscRenderer {
           });
           return;
         }
-        const theme = untrackedCookies().get("theme")?.value;
         let element: ReactNode;
         let effectivePatchDecision = safePatchDecision;
         if (match && safePatchDecision.status === "patch" && safePatchDecision.patch) {
@@ -563,9 +562,9 @@ export class RscRenderer {
               reason: "suffix-compose-fallback",
               commonPrefixLength: safePatchDecision.commonPrefixLength,
             };
-            element = await this.#renderMatched(urlObj, match, theme, searchParams);
+            element = await this.#renderMatched(urlObj, match, searchParams);
           } else element = suffixElement;
-        } else if (match) element = await this.#renderMatched(urlObj, match, theme, searchParams);
+        } else if (match) element = await this.#renderMatched(urlObj, match, searchParams);
         else element = await this.#renderNotFound(urlObj);
         const traceCacheKey =
           effectivePatchDecision.status === "patch" ? (patchCacheEntry?.key ?? cacheEntry?.key) : cacheEntry?.key;
@@ -1236,12 +1235,8 @@ export class RscRenderer {
     const routeHeadSnapshot = this.#createRouteHeadSnapshot(url, routeHead, {
       hasExplicitLanguageAlternates: routeHead.hasExplicitLanguageAlternates,
     });
-    const theme = untrackedCookies().get("theme")?.value;
     return (
-      <html
-        lang={params.lang ?? RscRenderer.#getLocale(pathname, this.#i18n)}
-        {...(theme ? { "data-theme": theme } : { suppressHydrationWarning: true })}
-      >
+      <html lang={params.lang ?? RscRenderer.#getLocale(pathname, this.#i18n)} suppressHydrationWarning>
         <head key="head">
           <meta key="charset" charSet="utf-8" />
           <meta key="viewport" name="viewport" content="width=device-width, initial-scale=1" />
@@ -1263,7 +1258,6 @@ export class RscRenderer {
   async #renderMatched(
     url: URL,
     match: { pathRoute: PathRoute; params: Record<string, string> },
-    theme?: string,
     searchParams = RouteTreeBuilder.parseSearchParams(url.search),
   ): Promise<ReactNode> {
     this.#logger.verbose(
@@ -1289,11 +1283,9 @@ export class RscRenderer {
       searchParams,
       navKey: url.pathname + url.search,
     });
     return (
-      <html
-        lang={match.params.lang ?? this.#i18n.defaultLocale}
-        {...(theme ? { "data-theme": theme } : { suppressHydrationWarning: true })}
-      >
+      <html lang={match.params.lang ?? this.#i18n.defaultLocale} suppressHydrationWarning>
         <head key="head">
           <meta key="charset" charSet="utf-8" />
           <meta key="viewport" name="viewport" content="width=device-width, initial-scale=1" />

package/server/webRouter.ts CHANGED Viewed

@@ -610,7 +610,8 @@ export class WebRouter {
           if (rscResult.type === "redirect")
             return Response.redirect(new URL(rscResult.location, url.origin), rscResult.status);
           if (rscResult.type === "not-found") return this.#renderSystemNotFoundFallbackResponse(req, url);
-          const themeCookieExists = WebRouter.#hasCookie(req, "theme");
+          const cookieTheme = WebRouter.#cookieValue(req, "theme");
           const hostRequestStore = createRequestStore(req);
           const extraBootstrapInline = [
             rscResult.trace?.routeState
@@ -628,7 +629,7 @@ export class WebRouter {
             bootstrapModules: [this.#artifact.rscClientUrl],
             extraBootstrapInline: extraBootstrapInline || undefined,
             importmap: this.#artifact.vendorMap,
-            theme: themeCookieExists ? undefined : (rscResult.theme ?? "system"),
+            theme: cookieTheme ?? rscResult.theme ?? "system",
             lateControl: rscResult.lateControl,
             waitForAllReady: rscResult.trace?.ssrBlocking ?? false,
             onCancel: (reason: unknown) => {
@@ -797,9 +798,6 @@ export class WebRouter {
     }
   }
-  static #hasCookie(req: Request, name: string): boolean {
-    return parseCookieHeader(req.headers.get("cookie") ?? "").has(name);
-  }
   #getHtmlCacheEntry(req: Request, url: URL): { entry: RouteCacheEntry | null; reason?: string } {
     const decision = resolvePublicRouteCacheEntryDecision({
       request: req,

package/store/agent/StoreSurfaceSource.ts CHANGED Viewed

@@ -13,13 +13,21 @@ import { ScreenTarget } from "./ScreenTarget";
  *
  * Per zone view: a zone's `readState` reaches the keys its own subtree subscribes, and its `readScreen` and
  * `highlight` reach into its own `data-agent-zone` container rather than the whole document. A page can shadow any
- * of them by registering a hook tool of the same name — hook entries win over a source's.
+ * of them by registering a hook tool of the same name — hook entries win over a source's. **That is a root-scope
+ * move only**: inside a zone the hook entry is registered under its scope-prefixed name, which can never collide
+ * with the bare name a source publishes, so a zone drops a built-in with the session's `builtins` option instead.
  */
 export class StoreSurfaceSource implements SurfaceSource {
   /** Defined in `akanjs/ui/styles.css`, so the flash follows the app's own theme tokens. */
   static readonly highlightClass = "akan-agent-highlight";
   /** Mirrors the animation in that stylesheet: the class outlives the ring by nothing. */
   static readonly highlightMs = 2400;
+  /**
+   * What `tools()` contributes, in the order it builds them — the list a session's `builtins` option selects from.
+   * A screen that declares a hook tool of one of these names is not in it: that entry is the screen's, not this
+   * source's, so withholding the built-ins never withholds a tool a component published on purpose.
+   */
+  static readonly builtins = ["navigate", "goBack", "readScreen", "readState", "highlight"] as const;
   #bridge: AgentBridge | null;
   readonly #builtins = new Map<string, ToolEntry[]>();

package/types/store/agent/StoreSurfaceSource.d.ts CHANGED Viewed

@@ -8,7 +8,9 @@ import { AgentBridge } from "./AgentBridge.d.ts";
  *
  * Per zone view: a zone's `readState` reaches the keys its own subtree subscribes, and its `readScreen` and
  * `highlight` reach into its own `data-agent-zone` container rather than the whole document. A page can shadow any
- * of them by registering a hook tool of the same name — hook entries win over a source's.
+ * of them by registering a hook tool of the same name — hook entries win over a source's. **That is a root-scope
+ * move only**: inside a zone the hook entry is registered under its scope-prefixed name, which can never collide
+ * with the bare name a source publishes, so a zone drops a built-in with the session's `builtins` option instead.
  */
 export declare class StoreSurfaceSource implements SurfaceSource {
     #private;
@@ -16,6 +18,12 @@ export declare class StoreSurfaceSource implements SurfaceSource {
     static readonly highlightClass = "akan-agent-highlight";
     /** Mirrors the animation in that stylesheet: the class outlives the ring by nothing. */
     static readonly highlightMs = 2400;
+    /**
+     * What `tools()` contributes, in the order it builds them — the list a session's `builtins` option selects from.
+     * A screen that declares a hook tool of one of these names is not in it: that entry is the screen's, not this
+     * source's, so withholding the built-ins never withholds a tool a component published on purpose.
+     */
+    static readonly builtins: readonly ["navigate", "goBack", "readScreen", "readState", "highlight"];
     /** Lazy by default: `AgentBridge.of()` walks the whole store, so it waits for the first enumeration. */
     constructor(bridge?: AgentBridge);
     tools: (view?: string[]) => ToolEntry[];

package/types/ui/Agent/Chat.d.ts CHANGED Viewed

@@ -1,7 +1,8 @@
 import { type ReactNode } from "react";
-import { type AgentRunner, type CompactOptions } from "../../vendor/use-agentic.d.ts";
+import { type AgentRunner, type AgentSessionOptions, type CompactOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
 import type { AttachReader } from "./attachment.d.ts";
 import type { PersistOption } from "./sessionHistory.d.ts";
+import type { BuiltinOption } from "./sessionView.d.ts";
 import type { VoiceEngine } from "./voice.d.ts";
 export interface ChatProps {
     /** Reaches whichever surface is showing — the launcher while closed, the panel while open. */
@@ -17,6 +18,13 @@ export interface ChatProps {
      * messages left verbatim below the summary. Tune it per provider; `{ at: 0 }` turns it off.
      */
     compact?: CompactOptions;
+    /**
+     * Which of the runtime's own tools this chat's agent gets — all of them by default, `false` none, an array
+     * exactly the ones it names. A chat that must not leave the screen it is on drops `navigate` and `goBack`.
+     */
+    builtins?: BuiltinOption;
+    /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
+    onCompact?: AgentSessionOptions["onCompact"];
     defaultOpen?: boolean;
     /**
      * Controlled open state. Pass it with `onOpenChange` to drive the panel from the app's own control — a header
@@ -26,8 +34,14 @@ export interface ChatProps {
     onOpenChange?: (open: boolean) => void;
     /** `false` draws no launcher, for an app that opens the panel from a control of its own. */
     launcher?: boolean;
-    /** Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab. */
-    persist?: PersistOption;
+    /**
+     * Keeps the transcript across reloads — sessionStorage by default, `{ storage: "local" }` to outlive the tab, or
+     * a `SessionHistory` of the app's own to keep it anywhere else, a server included.
+     *
+     * Ignored, like every session option above it, when an enclosing `Agent.Zone` or `AgentProvider` already holds a
+     * session: this chat then binds to that one, and the options belong to whoever built it.
+     */
+    persist?: PersistOption | SessionHistory;
     /** Renders in the page flow instead of floating above it — a zone chat that lives inside its own section. */
     inline?: boolean;
     /** `false` gives the browser its own Cmd/Ctrl+L back, for an app whose shell already spends that chord. */
@@ -39,6 +53,13 @@ export interface ChatProps {
     intro?: ReactNode;
     /** Extra header controls, left of the built-in clear and close buttons. */
     header?: ReactNode;
+    /**
+     * `false` draws no header bar at all — for an `inline` chat inside a panel the app already titles. The extra
+     * `header` controls go with it, and the clear action stays reachable as the `/new` command.
+     */
+    chrome?: boolean;
+    /** The composer's opening text, read once at mount — where a `?prompt=` lands without sending it. */
+    defaultDraft?: string;
     /**
      * Reads a file the user attached into an attachment, or answers `null` to leave it to the built-in reader
      * (images as bytes, text as text). This is where an app puts what needs a parser — a PDF's text, a spreadsheet's
@@ -60,6 +81,6 @@ export interface ChatProps {
  * `persist` keeps it. An enclosing AgentProvider's session wins, which is how an app isolates a surface or swaps
  * the loop while keeping this UI.
  */
-export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, compact, defaultOpen, open: openProp, onOpenChange, launcher, persist, inline, shortcut, launcherClassName, panelClassName, intro, header, attach, voice, }: ChatProps) => ReactNode;
+export declare const DefaultChat: ({ className, title, instructions, runner, maxTurns, compact, builtins, onCompact, defaultOpen, open: openProp, onOpenChange, launcher, persist, inline, shortcut, launcherClassName, panelClassName, intro, header, chrome, defaultDraft, attach, voice, }: ChatProps) => ReactNode;
 declare const _default: import("react").ComponentType<ChatProps>;
 export default _default;

package/types/ui/Agent/Zone.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import { type ReactNode } from "react";
-import { type AgentRunner, type CompactOptions } from "../../vendor/use-agentic.d.ts";
+import { type AgentRunner, type AgentSession, type AgentSessionOptions, type CompactOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
 import type { PersistOption } from "./sessionHistory.d.ts";
+import type { BuiltinOption } from "./sessionView.d.ts";
 export interface ZoneProps {
     className?: string;
     /** Names the zone; the scope id and the `data-agent-zone` container both derive from it. */
@@ -12,8 +13,26 @@ export interface ZoneProps {
     maxTurns?: number;
     /** When this zone's conversation summarizes itself — same contract as the chat's own `compact`. */
     compact?: CompactOptions;
-    /** Keeps this zone's transcript across reloads, keyed by the zone's scope path. */
-    persist?: PersistOption;
+    /**
+     * Which of the runtime's own tools this zone's agent gets — all of them by default, `false` none, an array
+     * exactly the ones it names. `builtins={["readScreen", "readState"]}` is how a zone that must not leave the
+     * screen stops being able to: the tools are withheld, not discouraged, so a prompt cannot talk the model past it.
+     */
+    builtins?: BuiltinOption;
+    /**
+     * Keeps this zone's transcript across reloads, keyed by the zone's scope path — web storage by default, or a
+     * `SessionHistory` of the app's own to keep it anywhere else, a server included.
+     */
+    persist?: PersistOption | SessionHistory;
+    /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
+    onCompact?: AgentSessionOptions["onCompact"];
+    /**
+     * Runs this zone on a session the app built instead of one of its own, and the app then owns it: unmounting the
+     * zone leaves it running. Read once at mount, like every other session option here.
+     */
+    session?: AgentSession;
+    /** Hands the session out once it exists, for a page or store that wants to send into it or watch it. */
+    onSession?: (session: AgentSession) => void;
     children: ReactNode;
 }
 /**
@@ -22,4 +41,4 @@ export interface ZoneProps {
  * zones are views, never walls. An `Agent.Chat` mounted inside binds to this session automatically, so two zones
  * on one screen run two conversations in parallel, each seeing only its own subtree.
  */
-export declare const Zone: ({ className, id, label, instructions, runner, maxTurns, compact, persist, children, }: ZoneProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Zone: ({ className, id, label, instructions, runner, maxTurns, compact, builtins, persist, onCompact, session: provided, onSession, children, }: ZoneProps) => import("react/jsx-runtime").JSX.Element;

package/types/ui/Agent/agentSessionOf.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
-import { type AgentRunner, AgentSession, type CompactOptions } from "../../vendor/use-agentic.d.ts";
+import { type AgentRunner, AgentSession, type AgentSessionOptions, type CompactOptions, type SessionHistory } from "../../vendor/use-agentic.d.ts";
 import { type PersistOption } from "./sessionHistory.d.ts";
+import { type BuiltinOption } from "./sessionView.d.ts";
 export interface AgentSessionSetup {
     /** Read per call rather than captured, so text the session builds follows a language switched mid-conversation. */
     l: (key: string) => string;
@@ -9,10 +10,18 @@ export interface AgentSessionSetup {
     instructions?: string;
     maxTurns?: number;
     compact?: CompactOptions;
-    persist?: PersistOption;
+    /**
+     * Which of the runtime's own tools this session gets: all of them by default, none with `false`, exactly the
+     * ones an array names. A zone whose conversation must stay on one screen takes `navigate` and `goBack` off it.
+     */
+    builtins?: BuiltinOption;
+    /** Web storage by default; a `SessionHistory` puts the transcript wherever the app keeps it, including a server. */
+    persist?: PersistOption | SessionHistory;
+    /** Called after a compaction replaced messages with one summary — where a host syncs its own watermark. */
+    onCompact?: AgentSessionOptions["onCompact"];
 }
 /**
  * The one place a chat session is wired to the akan runtime. Chat and Zone both build one, and building it twice
  * is how a zone came to be the only surface with no `compact` option — an option added on one side of a copy.
  */
-export declare const agentSessionOf: ({ l, view, runner, instructions, maxTurns, compact, persist, }: AgentSessionSetup) => AgentSession;
+export declare const agentSessionOf: ({ l, view, runner, instructions, maxTurns, compact, builtins, persist, onCompact, }: AgentSessionSetup) => AgentSession;

package/types/ui/Agent/index.d.ts CHANGED Viewed

@@ -14,5 +14,5 @@ export declare const Agent: {
     StateKey: typeof StateKey;
     Tool: typeof Tool;
     Transcript: typeof Transcript;
-    Zone: ({ className, id, label, instructions, runner, maxTurns, compact, persist, children, }: import("./Zone.d.ts").ZoneProps) => import("react/jsx-runtime").JSX.Element;
+    Zone: ({ className, id, label, instructions, runner, maxTurns, compact, builtins, persist, onCompact, session: provided, onSession, children, }: import("./Zone.d.ts").ZoneProps) => import("react/jsx-runtime").JSX.Element;
 };

package/types/ui/Agent/sessionHistory.d.ts CHANGED Viewed

@@ -11,4 +11,4 @@ export type PersistOption = boolean | {
  * why the cap is applied *before* the pairing repair: the window it keeps can start between a tool call and the
  * result answering it, and a transcript restored in that state is refused by the provider on its first turn.
  */
-export declare const sessionHistoryOf: (persist: PersistOption | undefined, pathKey?: string) => SessionHistory | undefined;
+export declare const sessionHistoryOf: (persist: PersistOption | SessionHistory | undefined, pathKey?: string) => SessionHistory | undefined;

package/types/ui/Agent/sessionView.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import { StoreSurfaceSource } from "akanjs/store";
+import type { AgenticSurface, SurfaceView } from "../../vendor/use-agentic.d.ts";
+/** One of the tools the akan runtime contributes to every screen, whatever that screen declares. */
+export type AgentBuiltin = (typeof StoreSurfaceSource.builtins)[number];
+/** `true` (the default) takes all of them, `false` none, an array exactly the ones it names. */
+export type BuiltinOption = boolean | AgentBuiltin[];
+/**
+ * The half of the surface one session reads: scoped to its zone, and narrowed to the built-ins it was given.
+ *
+ * Narrowing happens here rather than on the source because the source is shared — two sessions read one registry,
+ * and a zone that must not navigate away cannot take `navigate` off the screen for the root agent too. A withheld
+ * tool is withheld from `call` as well as from the listing, answering the same "unknown tool" a name that was
+ * never registered gets: a tool the model can still reach by guessing its name is not withheld.
+ */
+export declare const sessionView: (surface: AgenticSurface, path: string[], builtins?: BuiltinOption) => SurfaceView;

package/types/ui/RecentTime.d.ts CHANGED Viewed

@@ -1,4 +1,15 @@
 import { type Dayjs } from "akanjs/base";
+export type RecentTimeRelativeUnit = "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
+export type RecentTimeRelativeStyle = "fromNow" | "always" | "auto";
+export interface RecentTimeRelative {
+    unit: RecentTimeRelativeUnit;
+    /** Signed count in `unit`. Negative is past, positive is future, `0` is now. */
+    count: number;
+    date: Dayjs;
+    now: Dayjs;
+    defaultLabel: string;
+}
+export type RecentTimeRelativeFormat = RecentTimeRelativeStyle | ((relative: RecentTimeRelative) => string);
 export interface RecentTimeProps {
     /** Date value to render. Null renders nothing, and epoch placeholder values render --:--. */
     date: Date | Dayjs | null;
@@ -6,7 +17,13 @@ export interface RecentTimeProps {
     breakUnit?: Intl.RelativeTimeFormatUnit;
     /** Use compact automatic formatting or always include date and time. */
     format?: "full" | "auto";
+    /**
+     * Relative phrasing. `"fromNow"` (default) keeps dayjs locale strings (`하루 전`).
+     * `"always"` / `"auto"` use `Intl.RelativeTimeFormat` — `1일 전` vs `어제`.
+     * A function replaces the relative label; return `defaultLabel` to keep the default.
+     */
+    relative?: RecentTimeRelativeFormat;
     /** Additional classes for the trigger span. */
     className?: string;
 }
-export declare const RecentTime: ({ date, breakUnit, format, className }: RecentTimeProps) => import("react/jsx-runtime").JSX.Element | null;
+export declare const RecentTime: ({ date, breakUnit, format, relative, className }: RecentTimeProps) => import("react/jsx-runtime").JSX.Element | null;

package/types/ui/index.d.ts CHANGED Viewed

@@ -1,17 +1,19 @@
-export { SessionContext, useAgent } from "../vendor/use-agentic.d.ts";
+export { AgentProvider, type AgentProviderProps, type AgentRunner, AgentSession, type AgentSessionOptions, type ChatMessage, type CompactOptions, type ContextBlock, httpRunner, type PublishedTool, type RunnerEvent, type RunnerRequest, SessionContext, type SessionHistory, type SurfaceView, useAgent, } from "../vendor/use-agentic.d.ts";
 export { Agent } from "./Agent.d.ts";
 export { type ApprovalProps, DefaultApproval } from "./Agent/Approval.d.ts";
-export { agentSessionOf } from "./Agent/agentSessionOf.d.ts";
+export { type AgentSessionSetup, agentSessionOf } from "./Agent/agentSessionOf.d.ts";
 export { type AttachReader, maxAttachmentBytes } from "./Agent/attachment.d.ts";
 export { type BubbleProps, DefaultBubble } from "./Agent/Bubble.d.ts";
 export type { ChatProps } from "./Agent/Chat.d.ts";
 export { type ChatCommand, ChatCommands } from "./Agent/ChatCommands.d.ts";
 export { type ComposerProps, DefaultComposer } from "./Agent/Composer.d.ts";
+export { fetchRunner } from "./Agent/fetchRunner.d.ts";
 export { DefaultLauncher, type LauncherProps } from "./Agent/Launcher.d.ts";
 export { type CodeProps, DefaultCode, DefaultMarkdown, type MarkdownProps } from "./Agent/Markdown.d.ts";
 export { DefaultMenu, type MenuProps as AgentMenuProps, type MenuRow } from "./Agent/Menu.d.ts";
 export { DefaultQuestion, type QuestionProps } from "./Agent/Question.d.ts";
 export type { PersistOption } from "./Agent/sessionHistory.d.ts";
+export type { AgentBuiltin, BuiltinOption } from "./Agent/sessionView.d.ts";
 export { tokenCount } from "./Agent/tokenCount.d.ts";
 export type { VoiceEngine, VoiceHandlers, VoiceListener, VoiceSpeech } from "./Agent/voice.d.ts";
 export { agentAttrs } from "./agentAttrs.d.ts";
@@ -52,7 +54,7 @@ export { Pagination } from "./Pagination.d.ts";
 export { Popconfirm } from "./Popconfirm.d.ts";
 export { Portal } from "./Portal.d.ts";
 export { Radio } from "./Radio.d.ts";
-export { RecentTime } from "./RecentTime.d.ts";
+export { RecentTime, type RecentTimeProps, type RecentTimeRelative, type RecentTimeRelativeFormat, type RecentTimeRelativeStyle, type RecentTimeRelativeUnit, } from "./RecentTime.d.ts";
 export { Refresh } from "./Refresh.d.ts";
 export { type BadgeVariants, type ButtonVariants, badgeRecipe, buttonRecipe, type InputSurfaceVariants, inputRecipe, recipe, tv, } from "./recipe.d.ts";
 export { ScreenNavigator } from "./ScreenNavigator.d.ts";

package/types/vendor/use-agentic/AgentProvider.d.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import { type ReactNode } from "react";
 import { AgenticSurface } from "./AgenticSurface.d.ts";
 import { AgentSession, type AgentSessionOptions } from "./AgentSession.d.ts";
 import type { AgentRunner } from "./types.d.ts";
-interface AgentProviderProps extends AgentSessionOptions {
+export interface AgentProviderProps extends AgentSessionOptions {
     surface?: AgenticSurface;
     session?: AgentSession;
     runner?: AgentRunner;
@@ -15,4 +15,3 @@ interface AgentProviderProps extends AgentSessionOptions {
  * `useAgent` reads.
  */
 export declare const AgentProvider: ({ surface, session, runner, children, ...options }: AgentProviderProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/types/vendor/use-agentic/AgentSession.d.ts CHANGED Viewed

@@ -21,18 +21,31 @@ export interface PendingQuestion {
     answer: (value: string | string[]) => void;
     dismiss: (reason?: string) => void;
 }
-/** Where a session keeps its transcript across page loads. Storage-neutral: the host decides what backs it. */
+/**
+ * Where a session keeps its transcript across page loads. Storage-neutral: the host decides what backs it, so a
+ * server-side transcript is as legal as web storage — which is why every method may answer asynchronously. A
+ * `load` still in flight when the user sends the first message is dropped rather than merged: the conversation
+ * on screen is the one they are having, and splicing a restored one under it would rewrite what they just said.
+ *
+ * Which makes **sending on mount a race the restore loses** — an opening prompt fired from an effect beats the
+ * fetch, and the user watches the conversation they came back to never arrive. Wait for `isRestoring` to clear,
+ * or write the prompt into the composer and leave the send to them.
+ */
 export interface SessionHistory {
-    load(): ChatMessage[] | null;
-    save(messages: readonly ChatMessage[]): void;
-    clear(): void;
+    load(): ChatMessage[] | null | Promise<ChatMessage[] | null>;
+    save(messages: readonly ChatMessage[]): void | Promise<void>;
+    clear(): void | Promise<void>;
 }
 export interface AgentSessionOptions {
     instructions?: string;
     buildContext?: (surface: SurfaceView) => ContextBlock[];
     /** Assistant turns per send before the session asks whether to keep going, or stops. */
     maxTurns?: number;
-    /** Restores settled messages at construction and saves after every change, debounced. Failures are silent. */
+    /**
+     * Restores settled messages at construction and saves after every change, debounced. Failures are silent, and
+     * saves are chained rather than issued in parallel — an async host would otherwise land them out of order and
+     * persist an older transcript last.
+     */
     history?: SessionHistory;
     /**
      * Awaited after a tool that changed something and before its change report is taken. A surface is read
@@ -54,6 +67,15 @@ export interface AgentSessionOptions {
      * few messages is replaced by one summary of itself, before the turn that would have overflowed is sent.
      */
     compact?: CompactOptions;
+    /**
+     * Fires after a compaction replaced `replaced` with `summary`. A host that keeps its own server-side summary
+     * uses it to move its watermark to the same cut, so the two do not summarize the same messages twice.
+     *
+     * It matters most to a host whose watermark is a *position*: compaction shrinks the transcript in place, so a
+     * "sync everything past index N" scheme silently stops syncing once N is past the shortened array — no
+     * duplicate, no error, just messages that never reach the server. Reset the mark here.
+     */
+    onCompact?: (replaced: readonly ChatMessage[], summary: ChatMessage) => void;
 }
 /**
  * The client-side conversation loop: send → model turn → tool calls → approval gate → execute → report diffs → next
@@ -73,6 +95,11 @@ export declare class AgentSession {
      */
     static readonly askUserTool: PublishedTool;
     constructor(surface: SurfaceView, runner: AgentRunner, options?: AgentSessionOptions);
+    /**
+     * True while an async `history.load()` is still in flight — the transcript is empty but not yet known to be.
+     * A host that opens with a prompt of its own waits for this before sending, or the restore loses the race.
+     */
+    get isRestoring(): boolean;
     get surface(): SurfaceView;
     get messages(): readonly ChatMessage[];
     get isRunning(): boolean;
@@ -97,7 +124,7 @@ export declare class AgentSession {
     /**
      * Empties the transcript and the persisted history, ending a turn that is still running. Awaiting the abort
      * matters: the loop settles in its own `finally`, a microtask later, and a transcript emptied before that lands
-     * is one the winding-down turn appends onto.
+     * is one the winding-down turn appends onto. The returned promise waits for the history to clear too.
      */
     reset: () => Promise<void>;
     /**

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

@@ -39,6 +39,11 @@ export declare class AgenticSurface {
      */
     view(path: string[]): SurfaceView;
     tool(name: string, view?: string[]): ToolEntry | null;
+    /**
+     * Whether a *mounted component* declares this name — a source's contribution answers `false`. The distinction is
+     * what lets a host drop the built-in tools without dropping a screen's own tool that deliberately shadows one.
+     */
+    declares(name: string, view?: string[]): boolean;
     /** Every call made through this surface, oldest first. What the dock shows the user to check against the screen. */
     get transcript(): readonly AgentCall[];
     call(name: string, args?: Record<string, unknown>, view?: string[]): Promise<unknown>;