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

package/dist/src/client/notifications.js

@@ -1,9 +1,10 @@
+import"../../chunks/bash-description-wtcc8946.js";
 import"../../chunks/bash-description-t3hbavcc.js";
 import {
   taskLabel2,
   endedStatus2,
   sessionTitle2
-} from "../../chunks/bash-description-spc5av5d.js";
+} from "../../chunks/bash-description-sqknck2c.js";
 
 // src/client/notifications.ts
 var notifications_default = {

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

@@ -2,65 +2,27 @@ import { text, thinking } from "@nyte-ai/core";
 import type { PartState } from "@nyte-ai/core";
 import type { Execution, Failure, HeadInfo, Message, RunEnd, RunId, SessionInfo, ToolClass, ToolPartState } from "@nyte-ai/schema";
 export { jobTaskState } from "@nyte-ai/schema";
+export { parseCitation } from "./citation.ts";
+export type { Citation } from "./citation.ts";
 export { showsAnswer, showsReport, shownContent } from "./user-messages.ts";
 export type { AnswerMessage, ReportMessage } from "./user-messages.ts";
-/**
- * A message the user sent, or one a child, job or action delivered for them.
- *
- * @category presentation
- */
 export type UserMessage = Extract<Message, {
     readonly kind: "user";
 }>;
-/**
- * A message that carries a part: text, thinking, a tool call or a plugin's part.
- *
- * @category presentation
- */
 export type PartMessage = Extract<Message, {
     readonly kind: "part";
 }>;
-/**
- * A part message holding a tool call.
- *
- * @category presentation
- */
 export type ToolMessage = PartMessage & {
     readonly state: ToolPartState;
 };
-/**
- * A part message holding assistant text.
- *
- * @category presentation
- */
 export type TextMessage = PartMessage & {
     readonly state: PartState<typeof text>;
 };
-/**
- * A part message holding the model's thinking.
- *
- * @category presentation
- */
 export type ThinkingMessage = PartMessage & {
     readonly state: PartState<typeof thinking>;
 };
-/**
- * Narrows to a tool call's part.
- *
- * @category presentation
- */
 export declare function showsTool(message: Message): message is ToolMessage;
-/**
- * Narrows to an assistant text part.
- *
- * @category presentation
- */
 export declare function showsText(message: Message): message is TextMessage;
-/**
- * Narrows to a thinking part.
- *
- * @category presentation
- */
 export declare function showsThinking(message: Message): message is ThinkingMessage;
 /**
  * A part a client has no renderer for, shown raw: the text its state carries
@@ -86,23 +48,8 @@ export declare function readRawPart(message: PartMessage): RawPart;
  * @category presentation
  */
 export type ToolTense = "running" | "past" | "none";
-/**
- * The colour family of a tool line's state.
- *
- * @category presentation
- */
 export type ToolTone = "running" | "attention" | "success" | "failure" | "stopped";
-/**
- * The word a tool line adds after its subject when the outcome needs saying.
- *
- * @category presentation
- */
 export type ToolWord = "Needs input" | "Failed" | "Blocked" | "Stopped" | "Interrupted";
-/**
- * How every client shows a tool call's state; clients change only case and glyphs.
- *
- * @category presentation
- */
 export interface ToolStatus {
     readonly tense: ToolTense;
     readonly tone: ToolTone;
@@ -129,23 +76,8 @@ export declare function toolOutput(state: ToolPartState): string;
  * @category presentation
  */
 export type TaskState = "waiting" | "retrying" | "working" | "background" | "failed" | "done";
-/**
- * Screen readers hear the same word sighted users see.
- *
- * @category presentation
- */
 export declare function taskLabel(state: TaskState): string;
-/**
- * A delegate call's state as a task, for a child no client knows yet.
- *
- * @category presentation
- */
 export declare function callTaskState(status: ToolStatus): TaskState;
-/**
- * Whether a task has finished, either done or failed.
- *
- * @category presentation
- */
 export declare function taskEnded(state: TaskState): boolean;
 /**
  * The heading over a group of agents: how many still run, else how many finished and failed.
@@ -182,11 +114,6 @@ export type RunStatus = {
     readonly kind: "waiting-for-approval";
     readonly run: RunId;
 };
-/**
- * How many of a head's background items are still working and how many wait on the user.
- *
- * @category presentation
- */
 export type BackgroundWork = HeadInfo["background"];
 /**
  * A head's execution as a run status; none reads as idle, and a run waiting on a child, job or
@@ -228,23 +155,8 @@ export declare function backgroundLabel(background: BackgroundWork): string | un
  * @category presentation
  */
 export declare function planningLabel(planningMs: number): string | undefined;
-/**
- * Also holds the live row's place before {@link planningLabel} shows it.
- *
- * @category presentation
- */
 export declare const PLANNING_LABEL = "Planning next moves";
-/**
- * How long without progress before the live row says a run is planning.
- *
- * @category presentation
- */
 export declare const PLANNING_DELAY_MS = 200;
-/**
- * How long without progress before the live row says a run is taking longer than expected.
- *
- * @category presentation
- */
 export declare const SLOW_PLANNING_MS = 15000;
 /**
  * An execution's own run as a task; a session without one is done.
@@ -258,11 +170,6 @@ export declare function executionMark(execution: Execution | undefined): TaskSta
  * @category presentation
  */
 export declare function mainHead(session: Pick<SessionInfo, "heads">): HeadInfo | undefined;
-/**
- * A session's state, the same in a list row, a tab and a parent's task list.
- *
- * @category presentation
- */
 export declare function sessionMark(session: Pick<SessionInfo, "heads">): TaskState;
 /**
  * A session's title: its name, else "New chat" for a top-level chat or {@link SUBAGENT_TITLE}.
@@ -270,11 +177,6 @@ export declare function sessionMark(session: Pick<SessionInfo, "heads">): TaskSt
  * @category presentation
  */
 export declare function sessionTitle(session: Pick<SessionInfo, "name" | "parent">): string;
-/**
- * A child session's title while it has no name or a client doesn't know it yet.
- *
- * @category presentation
- */
 export declare const SUBAGENT_TITLE = "Subagent";
 /**
  * The text after a one-line draft's leading `/name `, while the caret is past
@@ -294,11 +196,6 @@ export interface CommandArgument {
  * @category presentation
  */
 export declare function findCommandArgument(value: string, cursor: number): CommandArgument | undefined;
-/**
- * The `@` mention or `/` command the caret is in, with the word's bounds.
- *
- * @category presentation
- */
 export interface CompletionTrigger {
     readonly kind: "@" | "/";
     readonly start: number;
@@ -311,21 +208,10 @@ export interface CompletionTrigger {
  * @category presentation
  */
 export declare function completionTrigger(value: string, cursor?: number): CompletionTrigger | undefined;
-/**
- * The verb for each tense that asserts one.
- *
- * @category presentation
- */
 export type ToolVerbs = Readonly<Record<Exclude<ToolTense, "none">, string>>;
 type DelegateClass = Extract<ToolClass, {
     readonly kind: "delegate";
 }>;
-/**
- * How a custom tool reads: its verbs, and the name and server an MCP tool
- * carries, or a fixed detail for a built-in.
- *
- * @category presentation
- */
 export interface CustomTool {
     readonly verbs: ToolVerbs;
     readonly name?: string;
@@ -339,11 +225,6 @@ export interface CustomTool {
  * @category presentation
  */
 export declare function customTool(label: string): CustomTool;
-/**
- * The verbs a tool call speaks with.
- *
- * @category presentation
- */
 export declare function toolVerbs(toolClass: ToolClass): ToolVerbs;
 /**
  * What a verbless line adds after its subject so the tool stays named: a path
@@ -358,12 +239,6 @@ export declare function toolNoun(toolClass: ToolClass): string | undefined;
  * @category presentation
  */
 export declare function delegateSubject(toolClass: DelegateClass): string;
-/**
- * What a call acts on, in full: a path, a command, an agent's title, or a
- * custom tool's name.
- *
- * @category presentation
- */
 export declare function toolSubject(toolClass: ToolClass): string | undefined;
 /**
  * One line naming a call: the tense's verb before the subject, or the subject
@@ -420,27 +295,10 @@ export interface ToolDetail {
  * @category presentation
  */
 export declare function toolDetail(toolClass: ToolClass, cwd: string | undefined): ToolDetail | undefined;
-/**
- * The step that gets a failed run going again. Each client names it its own
- * way: a command, a key or a settings page.
- *
- * @category presentation
- */
 export type Recovery = "compact" | "sign-in" | "switch-model";
-/**
- * What a failed run says: one sentence, its tone, and the step that recovers
- * from it when the user has one to take.
- *
- * @category presentation
- */
 export interface FailureNotice {
     readonly text: string;
     readonly tone: "neutral" | "danger";
     readonly recovery: Recovery | undefined;
 }
-/**
- * The notice for a run's failure.
- *
- * @category presentation
- */
 export declare function failureNotice(failure: Failure): FailureNotice;

package/dist/src/client/presentation.js

@@ -39,12 +39,15 @@ import {
   toolDetail2,
   failureNotice2,
   jobTaskState2
-} from "../../chunks/bash-description-spc5av5d.js";
+} from "../../chunks/bash-description-sqknck2c.js";
 import {
   showsReport2,
   showsAnswer2,
   shownContent2
 } from "../../chunks/bash-description-t3hbavcc.js";
+import {
+  parseCitation2
+} from "../../chunks/bash-description-wtcc8946.js";
 export {
   PLANNING_DELAY_MS2 as PLANNING_DELAY_MS,
   PLANNING_LABEL2 as PLANNING_LABEL,
@@ -65,6 +68,7 @@ export {
   formatWholeDuration2 as formatWholeDuration,
   jobTaskState2 as jobTaskState,
   mainHead2 as mainHead,
+  parseCitation2 as parseCitation,
   placeName2 as placeName,
   planningLabel2 as planningLabel,
   readRawPart2 as readRawPart,

package/dist/src/client/transcript-tui.d.ts

@@ -8,12 +8,6 @@ import type { Renderer } from "@nyte-ai/plugin/client";
  * @since 0.1.0
  */
 export declare const transcriptRenderers: readonly Renderer[];
-/**
- * The terminal renderers as a client plugin.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: {
     id: string;
     contribute: {

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

@@ -8,12 +8,6 @@ import type { Renderer } from "@nyte-ai/plugin/client";
  * @since 0.1.0
  */
 export declare const transcriptRenderers: readonly Renderer[];
-/**
- * The React renderers as a client plugin.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: {
     id: string;
     contribute: {

package/dist/src/client/user-messages.d.ts

@@ -1,10 +1,5 @@
 import type { MessageSource, UserContent } from "@nyte-ai/schema";
 import type { UserMessage } from "./presentation.ts";
-/**
- * A user message a child session or background job delivered as its report.
- *
- * @category presentation
- */
 export type ReportMessage = UserMessage & {
     readonly source: Extract<MessageSource, {
         readonly kind: "child" | "job";
@@ -21,11 +16,6 @@ export type AnswerMessage = UserMessage & {
         readonly kind: "answer";
     }>;
 };
-/**
- * Narrows to the report a child or job delivered; a person or an action sent the rest.
- *
- * @category presentation
- */
 export declare function showsReport(message: UserMessage): message is ReportMessage;
 /**
  * Narrows to a late answer to a part's request, which clients mark instead of drawing as a prompt.

package/dist/src/client.d.ts

@@ -11,34 +11,9 @@ export type { ClientApi, Command, Keybinding, Part, PartDefinition, PartState, R
  * @since 0.1.0
  */
 export type Plugin = CorePlugin<"client">;
-/**
- * What a client plugin's `activate` and hook handlers receive: the app's
- * connection, the session on screen and notifications.
- *
- * @category plugins
- * @since 0.1.0
- */
 export type PluginApi = CorePluginApi<"client">;
-/**
- * Names a hook a client plugin may handle.
- *
- * @category hooks
- * @since 0.1.0
- */
 export type HookName = SideHookName<"client">;
-/**
- * Returns a client hook handler's signature.
- *
- * @category hooks
- * @since 0.1.0
- */
 export type HookHandler<N extends HookName> = SideHookHandler<"client", N>;
-/**
- * Returns a client hook entry: a handler, or a handler with an order.
- *
- * @category hooks
- * @since 0.1.0
- */
 export type HookEntry<N extends HookName> = SideHookEntry<"client", N>;
 /**
  * Returns a renderer for one part kind whose `draw` gets the state checked

package/dist/src/codemode.d.ts

@@ -11,11 +11,5 @@ import type { Plugin } from "@nyte-ai/plugin/core";
  * @since 0.1.0
  */
 export declare function codemodePlugin(runtime: Pick<CodemodeSandboxOptions, "workerUrl" | "wasm">): Plugin;
-/**
- * The codemode plugin over the installed sandbox runtime.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: Plugin;
 export default _default;

package/dist/src/codemode.js

@@ -13,10 +13,10 @@ import { attachFile, dev } from "@nyte-ai/core";
 import { isJson, isJsonObject, SdkError, standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
 var DESCRIPTION = `Run JavaScript that calls other tools. The input is raw JavaScript (not JSON, no code fence), run as an async function body in a QuickJS sandbox: top-level \`await\` and \`return\` work. No Node, file system, network, or timers.
-- \`await tools.<name>({ ...args })\` resolves to the tool's output, or its text, and rejects with an Error on failure.
+- \`await tools.<name>({ ...args })\` resolves to the tool's output, or its text, and rejects with an Error on failure. \`tools\` is predefined; don't declare your own.
 - Optional first line: \`// @options: {"timeout_ms": 60000}\`
 - \`text(value)\`, \`console.log(...)\` and \`return\` add output; \`store(key, value)\` and \`load(key)\` keep JSON values across codemode calls in this session.
-- \`ALL_TOOLS\`, \`await searchTools(query, { limit?, namespace? })\`, \`await describeTool(name)\` and \`await describeNamespace(name)\` find unlisted tools, such as MCP tools, and their declarations.`;
+- Inside a script, \`ALL_TOOLS\`, \`await searchTools(query, { limit?, namespace? })\`, \`await describeTool(name)\` and \`await describeNamespace(name)\` find unlisted tools, such as MCP tools, and their declarations. They are script functions, not tools.`;
 var LISTING_TOKENS = 3000;
 var parameters = standard(Type.Object({ code: Type.String({ description: "Raw JavaScript source." }) }));
 function codemodePlugin(runtime) {

package/dist/src/core.d.ts

@@ -11,33 +11,7 @@ export type { CompactionPlan, Decision, ModelRequest, Submission, ToolCall, Tran
  * @since 0.1.0
  */
 export type Plugin = CorePlugin<"core">;
-/**
- * What a core plugin's `activate` and hook handlers receive: the session,
- * its environment, the registries, storage and `request`.
- *
- * @category plugins
- * @since 0.1.0
- */
 export type PluginApi = CorePluginApi<"core">;
-/**
- * Names a hook a core plugin may handle.
- *
- * @category hooks
- * @since 0.1.0
- */
 export type HookName = SideHookName<"core">;
-/**
- * Returns a core hook handler's signature, for a helper factored out of a
- * plugin's `hooks`.
- *
- * @category hooks
- * @since 0.1.0
- */
 export type HookHandler<N extends HookName> = SideHookHandler<"core", N>;
-/**
- * Returns a core hook entry: a handler, or a handler with an order.
- *
- * @category hooks
- * @since 0.1.0
- */
 export type HookEntry<N extends HookName> = SideHookEntry<"core", N>;

package/dist/src/desktop-settings/schema.d.ts

@@ -1,16 +1,13 @@
 import { Type } from "typebox";
 import type { Static } from "typebox";
-/** How a chat's state can reach you past its sidebar mark, which always shows. */
 export declare const ALERT_CHANNELS: readonly ["notification", "badge", "sound", "bounce", "remind"];
 export type AlertChannel = (typeof ALERT_CHANNELS)[number];
-/** The states that alert, each with the channels it offers. Working only marks the sidebar. */
 export declare const ALERT_OFFERS: {
     readonly waiting: readonly ["notification", "badge", "sound", "bounce", "remind"];
     readonly failed: readonly ["notification", "badge", "sound", "bounce"];
     readonly done: readonly ["notification", "badge", "sound"];
 };
 export type AlertState = keyof typeof ALERT_OFFERS;
-/** The desktop setting holding each state's chosen channels. */
 export declare const ALERT_SETTING: {
     readonly waiting: "alertsWaiting";
     readonly failed: "alertsFailed";

package/dist/src/find-on-path.d.ts

@@ -1,4 +1,2 @@
-/** Whether `path` is a file this process may run. */
 export declare function executable(path: string): Promise<boolean>;
-/** The first executable `name` in the directories of `path`, a `PATH`-style list. */
 export declare function findOnPath(name: string, path: string): Promise<string | undefined>;

package/dist/src/openai-astra-context.d.ts

@@ -1,19 +1,5 @@
 import type { ModelContextPolicy } from "@nyte-ai/core";
-/**
- * The context policy of `gpt-6-astra` on OpenAI and OpenAI Codex: a window
- * of one million tokens, compacted at 400 000.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const astra: readonly ModelContextPolicy[];
-/**
- * Gives the astra models their context window and compaction threshold,
- * folded into their `ModelInfo` and the sessions that run them.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: {
     id: string;
     contribute: {

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

@@ -1,5 +1,4 @@
 import type { CallId, Infer, PartId, PartView, SessionView } from "@nyte-ai/schema";
-/** The question tool's name, which clients match to draw its calls. */
 export declare const QUESTION_TOOL = "question";
 declare const info: import("@nyte-ai/schema").Schema<{
     question: string;
@@ -49,7 +48,6 @@ export declare const questionParameters: import("@nyte-ai/schema").Schema<{
         multiple?: boolean | undefined;
     }[];
 }>;
-/** A question, its described choices, and whether the user may select several. */
 export type QuestionInfo = Infer<typeof info>;
 /** One answer list per question, in request order. An empty list leaves a question unanswered. */
 export type QuestionAnswers = Infer<typeof answerInput>["answers"];
@@ -147,12 +145,6 @@ export type OpenQuestion = Pick<QuestionState, "questions"> & {
  * @since 0.1.0
  */
 export declare function openQuestions(view: Pick<SessionView, "parts"> | undefined): readonly OpenQuestion[];
-/**
- * The question part a call made, found by its `call` with one string comparison per part; the
- * caller validates only the match with {@link readQuestion}.
- *
- * @category plugins
- */
 export declare function findQuestionPart(parts: readonly PartView[], call: CallId): PartView | undefined;
 /**
  * A question part's state, or null when it doesn't parse.

package/dist/src/rename.js

@@ -60,7 +60,7 @@ var renameParameters = standard(Type.Object({
 }));
 var renameTool = {
   name: "session_rename",
-  description: "Rename the current session. Use a short, specific title that summarizes the work being done.",
+  description: "Rename this chat when the user asks for a new name; chats get a title on their own. Use a short, specific title.",
   parameters: renameParameters,
   class: (args) => ({ kind: "custom", label: `Renaming to ${args.title.trim()}` }),
   effects: "none",

package/dist/src/subagents.d.ts

@@ -1,12 +1,4 @@
 import type { Session } from "@nyte-ai/core";
-/**
- * Contributes the subagent tools to top-level sessions: `task`, `create`,
- * `send`, `await`, `read_agent` and `stop`, built on child sessions and
- * durable waits.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: {
     id: string;
     activate(api: {