@nyte-ai/plugin 0.0.27 → 0.0.28-nightly.20261107.65

package/dist/chunks/{bash-description-tc68h635.js → bash-description-4y8ey061.js}

@@ -1,6 +1,6 @@
 import {
   CANVAS_CODE_LIMIT2
-} from "./bash-description-jhrs22a3.js";
+} from "./bash-description-nn0tmjap.js";
 
 // src/canvas/schema.ts
 import { definePart } from "@nyte-ai/core";

package/dist/chunks/{bash-description-5zjawxsz.js → bash-description-7pkkngps.js}

@@ -4,7 +4,7 @@ import {
   initializeResult2,
   renderNotification2,
   clampCanvasHeight2
-} from "./bash-description-jhrs22a3.js";
+} from "./bash-description-nn0tmjap.js";
 
 // src/canvas/canvas-preview.ts
 import { Type } from "typebox";

package/dist/chunks/{bash-description-j2azw9sj.js → bash-description-ajjg78ww.js}

@@ -10,7 +10,7 @@ import {
   LIBRARY_EXPORTS2,
   canvasFilesComment2,
   KIT_EXPORTS2
-} from "./bash-description-jhrs22a3.js";
+} from "./bash-description-nn0tmjap.js";
 
 // src/canvas/canvas-compile.ts
 import { init, parse } from "es-module-lexer/minimal";

package/dist/chunks/{bash-description-jhrs22a3.js → bash-description-nn0tmjap.js}

@@ -106,20 +106,28 @@ var KIT2 = {
   Divider: "{}: a hairline",
   Heading: "{ level?: 1 | 2 | 3 = 2, children }",
   Text: '{ size?: "xs" | "sm" | "base" | "lg", tone?: "primary" | "secondary" | "tertiary", weight?: "normal" | "medium" | "semibold", mono?: boolean, truncate?: boolean, align?: "start" | "center" | "end", children }',
-  Code: "{ block?: boolean, children: string }: monospace, inline or a block",
-  Stat: '{ label: string, value: ReactNode, detail?: ReactNode, tone?: "neutral" | "success" | "warning" | "danger" }: a labelled number',
-  Badge: '{ tone?: "neutral" | "info" | "success" | "warning" | "danger", children }',
-  Meter: '{ value: number, max?: number = 100, label?: string, tone?: "primary" | "success" | "warning" | "danger" = "primary" }: a thin filled bar with the value beside the label',
-  Table: '{ columns: { key: string, label: ReactNode, align?: "start" | "end", width?: number | string }[], rows: Record<string, ReactNode>[], caption?: string }: rows are keyed by column key; a cell can hold a Sparkline or a Badge',
-  Callout: '{ tone?: "info" | "success" | "warning" | "danger", title?: string, children }',
-  Card: "{ title?: ReactNode, actions?: ReactNode, padding?: 0 | 2 | 3 | 4 = 4, children }: an elevated bordered surface",
+  Code: "{ block?: boolean, title?: string, children: string }: monospace, inline or a block; `title` heads a block with the file it came from",
+  FileLink: "{ path: string, line?: number, symbol?: string }: a workspace file, drawn like a file mention in the chat, that opens at `line`; `symbol` names the function there. Use it for every path instead of mono text",
+  Stat: '{ label: string, value: ReactNode, detail?: ReactNode, tone?: "neutral" | "success" | "warning" | "danger", delta?: string | number, invert?: boolean, trend?: number[] }: a labelled number; `delta` adds a change chip coloured by its sign (`invert` when down is good), `trend` a sparkline beside the value',
+  Delta: "{ value: string | number, invert?: boolean }: a change chip, green when the change is good, read from the sign it is written with; a number gets its sign written for it",
+  Badge: '{ tone?: "neutral" | "info" | "success" | "warning" | "danger", dot?: boolean, children }: a short status; `dot` leads it with a status mark',
+  Meter: '{ value: number, max?: number = 100, label?: string, detail?: ReactNode, tone?: "primary" | "success" | "warning" | "danger" = "primary" }: a share of a whole with the percentage beside the label; `detail` names the units, as in "124k of 200k"',
+  Table: '{ columns: { key: string, label: ReactNode, align?: "start" | "end", width?: number | string }[], rows: Record<string, ReactNode>[], caption?: string }: rows are keyed by column key; a cell can hold a Sparkline, Badge, Delta or DiffStat. The edge cells line up with the text around the table, and with the title inside a `padding={0}` Card',
+  KeyValue: "{ items: { label: ReactNode, value: ReactNode }[] }: labelled facts, one per row with the value at the end; use it instead of a two-column Table",
+  DiffStat: "{ added: number, removed: number }: lines added and removed, with five blocks split between them as GitHub draws it",
+  BarList: '{ data: { label: string, value: number }[], format?: (value: number) => string, tint?: Tint = "blue" }: a ranked list, each label on a bar sized to its share of the largest value; for a top-N list instead of a horizontal BarChart',
+  Steps: '{ items: { title: ReactNode, body?: ReactNode, meta?: ReactNode, status?: "done" | "current" | "todo" }[] }: an ordered walk through a process on a numbered rail, instead of a Card per step; `meta` holds a FileLink or a Badge',
+  Tracker: '{ label: string, data: { tone: "success" | "warning" | "danger" | "neutral", label: string }[] }: one cell per run, check or day, coloured by how it went and named on hover',
+  Callout: '{ tone?: "info" | "success" | "warning" | "danger", title?: string, children }: a note in the reading flow, a soft wash led by its tone glyph',
+  Card: "{ title?: ReactNode, description?: ReactNode, actions?: ReactNode, padding?: 0 | 2 | 3 | 4 = 4, children }: a raised surface for one idea; with `padding={0}` its content runs edge to edge under a ruled header",
+  Section: "{ title: ReactNode, description?: ReactNode, actions?: ReactNode, children }: a titled group, the heading with an optional line under it and actions at the end, then the content",
   StackedBars: "{ label: string, series: { key: string, label: string, tint: Tint }[], buckets: { key: string, label: string, values: number[] }[], format: (value: number) => string, height?: number = 88, ticks?: number = 5 }: compact stacked bars without axes, a readout on pointer or arrow keys; the numbers live in the copy around it. Preferred beside a Stat or a heading figure",
   Sparkline: "{ values: number[], tint?: Tint, label?: string, width?: number = 72, height?: number = 20 }: a row's trend scaled to its own peak, for a Table cell beside the row's number",
   LineChart: '{ series: { id: string, data: { x: number | string, y: number }[], tint?: Tint }[], height?: number = 240, xFormat?: (x) => string, yFormat?: (y) => string, curve?: "linear" | "monotone" | "step", area?: boolean, legend?: boolean }: a full chart with axes and a readout',
   BarChart: '{ data: Record<string, number | string>[], keys: (string | { key: string, label?: string, tint?: Tint })[], indexBy: string, height?: number = 240, layout?: "vertical" | "horizontal", mode?: "grouped" | "stacked" = "stacked", valueFormat?: (value: number) => string, legend?: boolean }: a full chart with axes and a readout with the total',
   PieChart: "{ data: { id: string, value: number, label?: string, tint?: Tint }[], height?: number = 240, donut?: boolean, valueFormat?: (value: number) => string, legend?: boolean }",
   Button: '{ variant?: "solid" | "outline" | "ghost", pill?: boolean, size?: "2xs" | "xs" | "sm" | "md" | "lg" | "xl", tone?: "neutral" | "primary" | "success" | "warning" | "danger", loading?: boolean, disabled?: boolean, onClick, children }',
-  Tabs: "Tabs.Root { value?, defaultValue?, onValueChange? } > Tabs.List { children: Tabs.Tab { value, children }[] } + Tabs.Panel { value, children }",
+  Tabs: "Tabs.Root { value?, defaultValue?, onValueChange? } > Tabs.List { children: Tabs.Tab { value, children }[] } + Tabs.Panel { value, children }: segmented tabs, only to compare views of one subject",
   Select: "Select { value?, defaultValue?, onValueChange? } > SelectTrigger { children: <SelectValue /> } + SelectContent { children: SelectItem[] }",
   SelectTrigger: "see Select",
   SelectValue: "see Select",

package/dist/chunks/{bash-description-0gnxcq7q.js → bash-description-rckj413b.js}

@@ -15,7 +15,7 @@ import { processEnvironment } from "@nyte-ai/core";
 // package.json
 var package_default = {
   name: "@nyte-ai/plugin",
-  version: "0.0.27",
+  version: "0.0.28-nightly.20261107.65",
   private: false,
   license: "MIT",
   repository: {

package/dist/chunks/bash-description-wtcc8946.js

@@ -0,0 +1,14 @@
+// src/client/citation.ts
+var LOCATION = /^(?<path>.+?)(?::(?<start>\d+)(?:-(?<end>\d+)|:\d+)?|#L(?<anchorStart>\d+)(?:-L(?<anchorEnd>\d+))?)$/u;
+function parseCitation2(text) {
+  const trimmed = text.trim().replace(/^\.\//u, "");
+  const located = LOCATION.exec(trimmed)?.groups;
+  const path = located?.path ?? trimmed;
+  const start = Number(located?.start ?? located?.anchorStart);
+  if (!Number.isSafeInteger(start) || start < 1)
+    return { path, lines: null };
+  const end = Number(located?.end ?? located?.anchorEnd ?? start);
+  return { path, lines: { start, end: Math.max(start, end) } };
+}
+
+export { parseCitation2 };

package/dist/src/acp/connection.d.ts

@@ -2,25 +2,14 @@ import type { ExecutionEnv } from "@nyte-ai/core";
 import type { AcpAgent } from "./registry.ts";
 import { AcpThread } from "./thread.ts";
 import type { AcpApprove } from "./thread.ts";
-/**
- * One agent process, started in a session's environment so the host's
- * environment, sandbox and login-shell gate apply to it, and the ACP
- * connection over its stdio. Each `open` starts an ACP session on it. A
- * failed `initialize` closes it: an agent that refuses it (fx before
- * `fx login`) stays up and keeps refusing, so the next turn needs a new one.
- */
 export declare class AcpProcess {
     #private;
     readonly agent: AcpAgent;
     private constructor();
-    /** Starts `agent` through `env.exec` with its stdio kept whole for the protocol, after the process environment is whole. */
     static start(env: ExecutionEnv, agent: AcpAgent): Promise<AcpProcess>;
     get closed(): boolean;
-    /** Whether the agent reads image blocks in a prompt. */
     images(): Promise<boolean>;
-    /** Starts an ACP session in `cwd` whose permission asks go to `approve`; an agent that wants a sign-in first fails with how to give it one. */
     open(cwd: string, approve: AcpApprove): Promise<AcpThread>;
-    /** Drops a thread Nyte no longer follows, cancelling its turn. */
     forget(thread: AcpThread): void;
     close(reason?: Error): void;
 }

package/dist/src/acp/connection.js

@@ -1,6 +1,6 @@
 import {
   AcpProcess2
-} from "../../chunks/bash-description-0gnxcq7q.js";
+} from "../../chunks/bash-description-rckj413b.js";
 import"../../chunks/bash-description-99k8z2r7.js";
 import"../../chunks/bash-description-q2v8wbn8.js";
 export {

package/dist/src/acp/index.js

@@ -8,7 +8,7 @@ import {
 import"../../chunks/bash-description-99k8z2r7.js";
 import {
   AcpProcess2
-} from "../../chunks/bash-description-0gnxcq7q.js";
+} from "../../chunks/bash-description-rckj413b.js";
 import"../../chunks/bash-description-4vz9pxyx.js";
 import {
   registryEntries2,

package/dist/src/acp/registry.d.ts

@@ -1,4 +1,3 @@
-/** An ACP agent this machine can start without downloading anything. */
 export interface AcpAgent {
     readonly id: string;
     readonly name: string;
@@ -8,20 +7,6 @@ export interface AcpAgent {
     /** The ACP session mode each new session is set to, so the agent's permission asks reach Nyte; else the agent's own default. */
     readonly mode?: string;
 }
-/** The agent entries of a registry document; anything else is no entries. */
 export declare function registryEntries(document: unknown): readonly unknown[];
-/**
- * The registry agents installed on this machine, in registry order: a binary
- * agent whose command is on `path`, or an npx agent whose package is
- * installed globally beside `npx` (its own bin, not another command of the
- * same name), run with the registry's arguments. An agent only the registry
- * can download is left out, so choosing a model never downloads one.
- */
 export declare function installedAgents(entries: readonly unknown[], path: string): Promise<readonly AcpAgent[]>;
-/**
- * The agents the user lists in `file` (`{ "agents": [{ id, name, command,
- * args?, env?, mode? }] }`), none when there is no file. Each is listed as
- * written, installed or not, and its command runs without shell expansion.
- * The file is the host's alone, so no client or project picks what runs.
- */
 export declare function userAgents(file: string): Promise<readonly AcpAgent[]>;

package/dist/src/acp/thread.d.ts

@@ -1,46 +1,29 @@
 import type { ContentBlock, PromptResponse, RequestPermissionRequest, RequestPermissionResponse, SessionUpdate } from "@agentclientprotocol/sdk/unstable";
 import type { Api, AssistantMessageEventStream, Model } from "@nyte-ai/ai";
 import type { RuntimeCall, RuntimeVerdict } from "@nyte-ai/core";
-/** Decides a call the agent asks permission for, under the session's policy. */
 export type AcpApprove = (call: RuntimeCall, signal: AbortSignal) => Promise<RuntimeVerdict>;
-/** What one of the agent's tool calls reported once it finished, or as far as it got when the turn ended. */
 export interface AcpToolOutput {
     readonly text: string;
     readonly failed: boolean;
 }
-/** How a thread reaches its agent: one prompt turn, the cancel notification for it, the folder its session runs in, and how a permission it asks for is decided. */
 export interface AcpChannel {
     readonly cwd: string;
     prompt(blocks: readonly ContentBlock[]): Promise<PromptResponse>;
     cancel(): void;
     readonly approve: AcpApprove;
 }
-/**
- * One ACP session on an agent: the prompt turns Nyte sends it, the updates
- * it streams back as assistant messages, and its tool calls, which Nyte
- * records as mirror calls whose ids start with `prefix`. A permission the
- * agent asks for waits until Nyte records that call, then goes to the
- * channel's `approve` under the call's ACP kind; a call Nyte skips is
- * refused.
- */
 export declare class AcpThread {
     #private;
     readonly prefix: string;
     constructor(prefix: string, channel: AcpChannel);
     get closed(): boolean;
-    /** Sends a prompt turn, or queues it behind the turn the agent is running, since ACP takes no message mid-turn. */
     send(blocks: readonly ContentBlock[]): void;
     update(update: SessionUpdate): void;
     permission(request: RequestPermissionRequest): Promise<RequestPermissionResponse>;
-    /** Lets the agent's permission ask for `id`, now or later, go on to its approval: Nyte is recording the call. */
     recording(id: string): void;
-    /** Refuses `id` when the agent asks, now or later: Nyte settled it without running it. A call this thread never saw is left alone. */
     skip(id: string): void;
-    /** Streams the turn as one assistant message, ending at the agent's next new tool call or at the turn's end; with `tools` false, its tool calls are refused and skipped. */
     respond(model: Model<Api>, signal: AbortSignal | undefined, tools?: boolean): AssistantMessageEventStream;
-    /** Waits for the agent to finish tool call `id`: until it completes or fails, the turn ends, or the agent waits on another call's permission. */
     result(id: string, signal: AbortSignal): Promise<AcpToolOutput>;
-    /** Stops the running turn: tells the agent, and answers its waiting permissions as cancelled. */
     cancel(): void;
     close(reason?: Error): void;
 }

package/dist/src/acp/transcript.d.ts

@@ -1,8 +1,5 @@
 import type { ContentBlock } from "@agentclientprotocol/sdk/unstable";
 import type { Message, UserMessage } from "@nyte-ai/ai";
-/** A message's identity for telling whether the agent's session already holds it. */
 export declare function messageKey(message: Message): string;
-/** A user message as prompt blocks; an image the agent cannot read becomes a note of its type. */
 export declare function userBlocks(message: UserMessage, images: boolean): ContentBlock[];
-/** The conversation as plain text, for an agent session that did not see it happen. */
 export declare function transcriptText(messages: readonly Message[]): string;

package/dist/src/acp/translate.d.ts

@@ -6,7 +6,6 @@ import type { Static } from "typebox";
 export declare const ACP_PROVIDER = "acp";
 export declare const ACP_API = "acp";
 export declare const MIRROR_TOOL = "acp";
-/** A mirror call's arguments: the ACP session it ran in, the agent's own call id, title, kind, input and the paths it touches. */
 export declare const mirrorArguments: Type.TObject<{
     thread: Type.TString;
     id: Type.TString;
@@ -16,7 +15,6 @@ export declare const mirrorArguments: Type.TObject<{
     paths: Type.TArray<Type.TString>;
 }>;
 export type MirrorArguments = Static<typeof mirrorArguments>;
-/** A turn's usage as ACP defines it. An agent's report missing a required count (fx sends no `totalTokens`) is not usage. */
 export declare const agentUsage: Type.TObject<{
     inputTokens: Type.TNumber;
     outputTokens: Type.TNumber;
@@ -25,11 +23,8 @@ export declare const agentUsage: Type.TObject<{
     cachedWriteTokens: Type.TOptional<Type.TUnion<[Type.TNumber, Type.TNull]>>;
 }>;
 export declare function emptyMessage(model: Model<Api>): AssistantMessage;
-/** The class Nyte shows and gates an agent's tool call by, from the ACP kind, its paths and its input. */
 export declare function mirrorClass(args: MirrorArguments): ToolClass;
-/** What a finished agent tool call reports, as the text its mirror call returns. */
 export declare function toolText(content: readonly ToolCallContent[], rawOutput: unknown): string;
-/** Builds one assistant message from an agent's streamed text, thoughts and tool calls. */
 export declare class Translator {
     #private;
     constructor(model: Model<Api>, output: AssistantMessage, stream: AssistantMessageEventStream);

package/dist/src/approvals/approvals.d.ts

@@ -1,6 +1,5 @@
 import type { PluginApi, RuntimeCall, RuntimeVerdict, SettingDefinition, ToolDefinition } from "@nyte-ai/core";
 import type { ApprovalPolicy, ApprovalState } from "./schema.ts";
-/** A tool call as the policy sees it: its tool's name, its class, and whether its tool lets a policy hold it. */
 export interface ApprovalTool extends RuntimeCall {
     readonly approval?: ToolDefinition["approval"];
 }

package/dist/src/approvals/schema.d.ts

@@ -6,9 +6,7 @@ declare const policy: import("@nyte-ai/schema").Schema<"ask" | "auto-edit" | "fu
  * workspace and tools whose effects are unknown, `full` never.
  */
 export type ApprovalPolicy = Infer<typeof policy>;
-/** The setting that holds the policy; it names the terminal's `/permissions` command. */
 export declare const PERMISSIONS = "permissions";
-/** The policy setting's schema, shared by the plugin and the clients that read it. */
 export declare const approvalPolicy: import("@nyte-ai/schema").Schema<"ask" | "auto-edit" | "full">;
 /** Each policy with the words every client shows for it, in menu order. */
 export declare const APPROVAL_POLICIES: readonly [{
@@ -57,9 +55,7 @@ declare const state: import("@nyte-ai/schema").Schema<{
  * first decision, null while it waits.
  */
 export type ApprovalState = Infer<typeof state>;
-/** What the user can answer, as part actions. */
 export type ApprovalDecision = Exclude<ApprovalState["decision"], null>;
-/** The three answers in the order every client offers them, with their shared labels. */
 export declare const APPROVAL_ACTIONS: readonly [{
     readonly action: "once";
     readonly label: "Allow once";
@@ -70,12 +66,10 @@ export declare const APPROVAL_ACTIONS: readonly [{
     readonly action: "deny";
     readonly label: "Deny";
 }];
-/** The question an approval asks and the command, path or label it is about. */
 export interface ApprovalPrompt {
     readonly title: string;
     readonly detail: string;
 }
-/** The words every client shows for an approval. */
 export declare function approvalPrompt(current: Pick<ApprovalState, "tool" | "class" | "reason">): ApprovalPrompt;
 /**
  * A modal request to run one tool call. Its first answer stands: once,
@@ -154,7 +148,6 @@ export declare const approval: {
         readonly id: PartId;
     }) => string;
 };
-/** An approval still waiting for the user, with the part its answer goes to. */
 export type OpenApproval = Pick<ApprovalState, "tool" | "class" | "reason"> & {
     readonly part: PartId;
 };

package/dist/src/bash-description.d.ts

@@ -1,12 +1,3 @@
-/**
- * Makes the model say what each `bash` call does. A derive wraps the
- * environment's `bash` tool, keeping its identity, execute and class, and
- * requires `description` in its parameters; the tool's class already carries
- * it as `ToolClass.shell.description`, so a client heads the call with it.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: {
     id: string;
     activate(api: {

package/dist/src/browser-client.d.ts

@@ -14,13 +14,6 @@ export interface ClientActions {
     offered(action: string): boolean;
     perform(action: string, input: Json, timeoutMs: number): Promise<Json>;
 }
-/**
- * The action an app offers to drive the page each chat's agent holds in its
- * browser; its input is a `BrowserCall`.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const BROWSER_ACTION: {
     readonly name: "browser";
     readonly summary: "Drives the page a chat's agent holds in this app's browser.";
@@ -28,13 +21,6 @@ export declare const BROWSER_ACTION: {
         readonly type: "object";
     };
 };
-/**
- * What the host asks the browser action to do: one `BrowserAgent` method of
- * the desktop and its input.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const BrowserCallType: Type.TUnion<[Type.TObject<{
     method: Type.TLiteral<"open">;
     session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
@@ -116,12 +102,6 @@ export type BrowserCall = Static<typeof BrowserCallType>;
  * @since 0.1.0
  */
 export declare function sanitizeLine(text: string): string;
-/**
- * Returns the id of the page a session's agent holds in an app's browser.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare function sessionSurfaceId(sessionId: SessionId): string;
 /**
  * The browser tools, served by the connected app that offers

package/dist/src/canvas/canvas-client.d.ts

@@ -2,14 +2,6 @@ import { Type } from "typebox";
 import type { Static } from "typebox";
 import type { ClientActions } from "../browser-client.ts";
 import type { CanvasPreviewer } from "./canvas-preview.ts";
-/**
- * The action an app offers to render a canvas preview in its own renderer;
- * its input is a `CanvasPreviewRequest`, its answer a
- * `CanvasPreviewAnswer`.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const CANVAS_PREVIEW_ACTION: {
     readonly name: "canvas.preview";
     readonly summary: "Renders a canvas off-screen in this app and reports what it saw.";
@@ -17,12 +9,6 @@ export declare const CANVAS_PREVIEW_ACTION: {
         readonly type: "object";
     };
 };
-/**
- * What the host sends the preview action.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const CanvasPreviewCallType: Type.TObject<{
     module: Type.TObject<{
         runtime: Type.TNumber;
@@ -31,12 +17,6 @@ export declare const CanvasPreviewCallType: Type.TObject<{
     }>;
     theme: Type.TEnum<["light", "dark"]>;
 }>;
-/**
- * What the preview action answers: the outcome, its PNG as base64.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const CanvasPreviewAnswerType: Type.TUnion<[Type.TObject<{
     kind: Type.TLiteral<"rendered">;
     report: Type.TObject<{

package/dist/src/canvas/canvas-compile.js

@@ -1,8 +1,8 @@
 import {
   localImports2,
   compileCanvas2
-} from "../../chunks/bash-description-j2azw9sj.js";
-import"../../chunks/bash-description-jhrs22a3.js";
+} from "../../chunks/bash-description-ajjg78ww.js";
+import"../../chunks/bash-description-nn0tmjap.js";
 import"../../chunks/bash-description-zfpm2rt0.js";
 export {
   compileCanvas2 as compileCanvas,

package/dist/src/canvas/canvas-preview.js

@@ -2,8 +2,8 @@ import {
   CANVAS_PREVIEW_WIDTHS2,
   runCanvasPreview2,
   describeCanvasPreview2
-} from "../../chunks/bash-description-5zjawxsz.js";
-import"../../chunks/bash-description-jhrs22a3.js";
+} from "../../chunks/bash-description-7pkkngps.js";
+import"../../chunks/bash-description-nn0tmjap.js";
 import"../../chunks/bash-description-zfpm2rt0.js";
 export {
   CANVAS_PREVIEW_WIDTHS2 as CANVAS_PREVIEW_WIDTHS,

package/dist/src/canvas/canvas-protocol.d.ts

@@ -27,20 +27,28 @@ export declare const KIT: {
     readonly Divider: "{}: a hairline";
     readonly Heading: "{ level?: 1 | 2 | 3 = 2, children }";
     readonly Text: '{ size?: "xs" | "sm" | "base" | "lg", tone?: "primary" | "secondary" | "tertiary", weight?: "normal" | "medium" | "semibold", mono?: boolean, truncate?: boolean, align?: "start" | "center" | "end", children }';
-    readonly Code: "{ block?: boolean, children: string }: monospace, inline or a block";
-    readonly Stat: '{ label: string, value: ReactNode, detail?: ReactNode, tone?: "neutral" | "success" | "warning" | "danger" }: a labelled number';
-    readonly Badge: '{ tone?: "neutral" | "info" | "success" | "warning" | "danger", children }';
-    readonly Meter: '{ value: number, max?: number = 100, label?: string, tone?: "primary" | "success" | "warning" | "danger" = "primary" }: a thin filled bar with the value beside the label';
-    readonly Table: '{ columns: { key: string, label: ReactNode, align?: "start" | "end", width?: number | string }[], rows: Record<string, ReactNode>[], caption?: string }: rows are keyed by column key; a cell can hold a Sparkline or a Badge';
-    readonly Callout: '{ tone?: "info" | "success" | "warning" | "danger", title?: string, children }';
-    readonly Card: "{ title?: ReactNode, actions?: ReactNode, padding?: 0 | 2 | 3 | 4 = 4, children }: an elevated bordered surface";
+    readonly Code: "{ block?: boolean, title?: string, children: string }: monospace, inline or a block; `title` heads a block with the file it came from";
+    readonly FileLink: "{ path: string, line?: number, symbol?: string }: a workspace file, drawn like a file mention in the chat, that opens at `line`; `symbol` names the function there. Use it for every path instead of mono text";
+    readonly Stat: '{ label: string, value: ReactNode, detail?: ReactNode, tone?: "neutral" | "success" | "warning" | "danger", delta?: string | number, invert?: boolean, trend?: number[] }: a labelled number; `delta` adds a change chip coloured by its sign (`invert` when down is good), `trend` a sparkline beside the value';
+    readonly Delta: "{ value: string | number, invert?: boolean }: a change chip, green when the change is good, read from the sign it is written with; a number gets its sign written for it";
+    readonly Badge: '{ tone?: "neutral" | "info" | "success" | "warning" | "danger", dot?: boolean, children }: a short status; `dot` leads it with a status mark';
+    readonly Meter: '{ value: number, max?: number = 100, label?: string, detail?: ReactNode, tone?: "primary" | "success" | "warning" | "danger" = "primary" }: a share of a whole with the percentage beside the label; `detail` names the units, as in "124k of 200k"';
+    readonly Table: '{ columns: { key: string, label: ReactNode, align?: "start" | "end", width?: number | string }[], rows: Record<string, ReactNode>[], caption?: string }: rows are keyed by column key; a cell can hold a Sparkline, Badge, Delta or DiffStat. The edge cells line up with the text around the table, and with the title inside a `padding={0}` Card';
+    readonly KeyValue: "{ items: { label: ReactNode, value: ReactNode }[] }: labelled facts, one per row with the value at the end; use it instead of a two-column Table";
+    readonly DiffStat: "{ added: number, removed: number }: lines added and removed, with five blocks split between them as GitHub draws it";
+    readonly BarList: '{ data: { label: string, value: number }[], format?: (value: number) => string, tint?: Tint = "blue" }: a ranked list, each label on a bar sized to its share of the largest value; for a top-N list instead of a horizontal BarChart';
+    readonly Steps: '{ items: { title: ReactNode, body?: ReactNode, meta?: ReactNode, status?: "done" | "current" | "todo" }[] }: an ordered walk through a process on a numbered rail, instead of a Card per step; `meta` holds a FileLink or a Badge';
+    readonly Tracker: '{ label: string, data: { tone: "success" | "warning" | "danger" | "neutral", label: string }[] }: one cell per run, check or day, coloured by how it went and named on hover';
+    readonly Callout: '{ tone?: "info" | "success" | "warning" | "danger", title?: string, children }: a note in the reading flow, a soft wash led by its tone glyph';
+    readonly Card: "{ title?: ReactNode, description?: ReactNode, actions?: ReactNode, padding?: 0 | 2 | 3 | 4 = 4, children }: a raised surface for one idea; with `padding={0}` its content runs edge to edge under a ruled header";
+    readonly Section: "{ title: ReactNode, description?: ReactNode, actions?: ReactNode, children }: a titled group, the heading with an optional line under it and actions at the end, then the content";
     readonly StackedBars: "{ label: string, series: { key: string, label: string, tint: Tint }[], buckets: { key: string, label: string, values: number[] }[], format: (value: number) => string, height?: number = 88, ticks?: number = 5 }: compact stacked bars without axes, a readout on pointer or arrow keys; the numbers live in the copy around it. Preferred beside a Stat or a heading figure";
     readonly Sparkline: "{ values: number[], tint?: Tint, label?: string, width?: number = 72, height?: number = 20 }: a row's trend scaled to its own peak, for a Table cell beside the row's number";
     readonly LineChart: '{ series: { id: string, data: { x: number | string, y: number }[], tint?: Tint }[], height?: number = 240, xFormat?: (x) => string, yFormat?: (y) => string, curve?: "linear" | "monotone" | "step", area?: boolean, legend?: boolean }: a full chart with axes and a readout';
     readonly BarChart: '{ data: Record<string, number | string>[], keys: (string | { key: string, label?: string, tint?: Tint })[], indexBy: string, height?: number = 240, layout?: "vertical" | "horizontal", mode?: "grouped" | "stacked" = "stacked", valueFormat?: (value: number) => string, legend?: boolean }: a full chart with axes and a readout with the total';
     readonly PieChart: "{ data: { id: string, value: number, label?: string, tint?: Tint }[], height?: number = 240, donut?: boolean, valueFormat?: (value: number) => string, legend?: boolean }";
     readonly Button: '{ variant?: "solid" | "outline" | "ghost", pill?: boolean, size?: "2xs" | "xs" | "sm" | "md" | "lg" | "xl", tone?: "neutral" | "primary" | "success" | "warning" | "danger", loading?: boolean, disabled?: boolean, onClick, children }';
-    readonly Tabs: "Tabs.Root { value?, defaultValue?, onValueChange? } > Tabs.List { children: Tabs.Tab { value, children }[] } + Tabs.Panel { value, children }";
+    readonly Tabs: "Tabs.Root { value?, defaultValue?, onValueChange? } > Tabs.List { children: Tabs.Tab { value, children }[] } + Tabs.Panel { value, children }: segmented tabs, only to compare views of one subject";
     readonly Select: "Select { value?, defaultValue?, onValueChange? } > SelectTrigger { children: <SelectValue /> } + SelectContent { children: SelectItem[] }";
     readonly SelectTrigger: "see Select";
     readonly SelectValue: "see Select";

package/dist/src/canvas/canvas-protocol.js

@@ -42,7 +42,7 @@ import {
   clampCanvasHeight2,
   canvasStartHeight2,
   sanitizeCanvasVariables2
-} from "../../chunks/bash-description-jhrs22a3.js";
+} from "../../chunks/bash-description-nn0tmjap.js";
 import"../../chunks/bash-description-zfpm2rt0.js";
 export {
   CANVAS_CODE_LIMIT2 as CANVAS_CODE_LIMIT,

package/dist/src/canvas/canvas.js

@@ -9,19 +9,19 @@ import {
   LIBRARY_VERSIONS2,
   TINTS2,
   KIT2
-} from "../../chunks/bash-description-jhrs22a3.js";
+} from "../../chunks/bash-description-nn0tmjap.js";
 import {
   compileCanvas2
-} from "../../chunks/bash-description-j2azw9sj.js";
+} from "../../chunks/bash-description-ajjg78ww.js";
 import {
   CANVAS_PREVIEW_WIDTHS2,
   describeCanvasPreview2
-} from "../../chunks/bash-description-5zjawxsz.js";
+} from "../../chunks/bash-description-7pkkngps.js";
 import {
   CANVAS_RENDER_TOOL2,
   CANVAS_REVISIONS_KEPT2,
   canvas2
-} from "../../chunks/bash-description-tc68h635.js";
+} from "../../chunks/bash-description-4y8ey061.js";
 
 // src/canvas/canvas.ts
 import { attachFile, definePart, followedTrace, traced } from "@nyte-ai/core";

package/dist/src/canvas/schema.js

@@ -2,8 +2,8 @@ import {
   CANVAS_RENDER_TOOL2,
   CANVAS_REVISIONS_KEPT2,
   canvas2
-} from "../../chunks/bash-description-tc68h635.js";
-import"../../chunks/bash-description-jhrs22a3.js";
+} from "../../chunks/bash-description-4y8ey061.js";
+import"../../chunks/bash-description-nn0tmjap.js";
 import"../../chunks/bash-description-zfpm2rt0.js";
 export {
   CANVAS_RENDER_TOOL2 as CANVAS_RENDER_TOOL,

package/dist/src/claude-code-sdk/session.d.ts

@@ -2,7 +2,6 @@ import type { EffortLevel, Options, Query, SDKMessage, SessionStoreEntry, query
 import type { Api, AssistantMessageEventStream, Message, Model, ProviderEnv, Tool } from "@nyte-ai/ai";
 import type { ContentBlock } from "./transcript.ts";
 interface Launch {
-    /** What only a new process can change: model, folder, thinking and system prompt. Effort and tools change on a running one. */
     readonly key: string;
     readonly model: string;
     readonly cwd: string;
@@ -14,35 +13,19 @@ interface Launch {
     readonly history: readonly SessionStoreEntry[];
     readonly tools: readonly Tool[];
     readonly query: StartQuery;
-    /** The installed `claude` to run; without one the Agent SDK looks for its own. */
     readonly claude: string | undefined;
 }
-/** Starts Claude Code: the Agent SDK's `query`, or a stand-in with the parts of its `Query` a session uses. */
 export type StartQuery = (params: Parameters<typeof query>[0]) => AsyncIterable<SDKMessage> & Pick<Query, "applyFlagSettings" | "close">;
-/**
- * Claude Code as a bare model: only the tools and system prompt Nyte passes, none of the user's
- * Claude Code settings, hooks, MCP servers, skills or CLAUDE.md, and prompts sent as written
- * (`verbatimPrompts` needs Claude Code 2.1.248 or later).
- */
 export declare function isolatedOptions(claude: string | undefined, env: ProviderEnv | undefined): Options;
-/**
- * One running `claude` for a Nyte session. Claude's calls to Nyte's tools end the response that
- * makes them; Nyte runs them like any model's calls, and their results answer Claude's MCP
- * requests when the next response starts.
- */
 export declare class ClaudeCodeSession {
     #private;
     constructor(launch: Launch);
     get closed(): boolean;
-    /** Whether this process can take the turn for `keys`: it was launched as `key` and has seen their start. */
     follows(key: string, keys: readonly string[]): boolean;
     configure(effort: EffortLevel | undefined): Promise<void>;
-    /** Serves `tools` as the Nyte MCP server's tools from now on, telling Claude Code when they changed. */
     expose(tools: readonly Tool[]): void;
-    /** Answers Claude's waiting Nyte tool calls with the results Nyte recorded for them. */
     deliver(messages: readonly Message[]): void;
     send(content: readonly ContentBlock[]): void;
-    /** Streams Claude's next response to the transcript whose message keys are `keys`. */
     respond(model: Model<Api>, keys: readonly string[], signal: AbortSignal | undefined): AssistantMessageEventStream;
     close(reason?: Error): void;
 }

package/dist/src/claude-code-sdk/translate.d.ts

@@ -8,7 +8,6 @@ export declare function emptyMessage(model: Model<Api>): AssistantMessage;
 export declare class Translator {
     #private;
     constructor(model: Model<Api>, output: AssistantMessage, stream: AssistantMessageEventStream);
-    /** Applies one stream event. Returns the raw stop reason at a message's end, and `"tool_use"` as soon as a Nyte tool call's input is complete: Claude Code waits for Nyte to run it before it runs the message's later calls. */
     apply(event: StreamEvent): string | undefined;
 }
 export {};

package/dist/src/client/citation.d.ts

@@ -0,0 +1,8 @@
+export interface Citation {
+    readonly path: string;
+    readonly lines: {
+        readonly start: number;
+        readonly end: number;
+    } | null;
+}
+export declare function parseCitation(text: string): Citation;

package/dist/src/client/citation.js

@@ -0,0 +1,6 @@
+import {
+  parseCitation2
+} from "../../chunks/bash-description-wtcc8946.js";
+export {
+  parseCitation2 as parseCitation
+};

package/dist/src/client/mount.d.ts

@@ -3,13 +3,6 @@ import type { Decision, Placement, SessionId, SessionInfo, SubmitDraft } from "@
 import type { Plugin, PluginApi } from "../client.ts";
 import type { PartMessage } from "./presentation.ts";
 type Notification = Parameters<PluginApi["ui"]["notify"]>[0];
-/**
- * What a client hands the plugins it mounts: its connection, the frameworks
- * it draws, the session input goes to, the sessions someone is looking at,
- * and where notices and plugin errors go.
- *
- * @category plugins
- */
 export interface MountOptions {
     readonly connection: Connection;
     readonly plugins: readonly Plugin[];
@@ -19,11 +12,6 @@ export interface MountOptions {
     readonly notify: (input: Notification) => void;
     readonly report: (plugin: string, message: string) => void;
 }
-/**
- * The mounted client plugins: their renderers and the hooks a client fires.
- *
- * @category plugins
- */
 export interface ClientPlugins {
     readonly ids: readonly string[];
     /** The view a plugin renderer draws for a part, or undefined when none draws its kind. */