@nyte-ai/plugin 0.0.24 → 0.0.25-nightly.20261025.2

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

@@ -1,15 +1,15 @@
 import type { ToolDefinition } from "@nyte-ai/core";
 export declare const question: import("@nyte-ai/core").PartDefinition<{
-    answers: string[][] | null;
     questions: {
-        multiple?: boolean | undefined;
+        question: string;
+        header: string;
         options: {
-            description: string;
             label: string;
+            description: string;
         }[];
-        question: string;
-        header: string;
+        multiple?: boolean | undefined;
     }[];
+    answers: string[][] | null;
 }, {
     answer: {
         input: import("@nyte-ai/schema").Schema<{
@@ -28,16 +28,16 @@ declare const _default: {
     id: string;
     contribute: {
         parts: import("@nyte-ai/core").PartDefinition<{
-            answers: string[][] | null;
             questions: {
-                multiple?: boolean | undefined;
+                question: string;
+                header: string;
                 options: {
-                    description: string;
                     label: string;
+                    description: string;
                 }[];
-                question: string;
-                header: string;
+                multiple?: boolean | undefined;
             }[];
+            answers: string[][] | null;
         }, {
             answer: {
                 input: import("@nyte-ai/schema").Schema<{
@@ -47,13 +47,13 @@ declare const _default: {
         }>[];
         tools: ToolDefinition<{
             questions: {
-                multiple?: boolean | undefined;
+                question: string;
+                header: string;
                 options: {
-                    description: string;
                     label: string;
+                    description: string;
                 }[];
-                question: string;
-                header: string;
+                multiple?: boolean | undefined;
             }[];
         }, {
             answers: string[][] | null;

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

@@ -1,12 +1,12 @@
 import type { Infer, PartId, SessionView } from "@nyte-ai/schema";
 declare const info: import("@nyte-ai/schema").Schema<{
-    multiple?: boolean | undefined;
+    question: string;
+    header: string;
     options: {
-        description: string;
         label: string;
+        description: string;
     }[];
-    question: string;
-    header: string;
+    multiple?: boolean | undefined;
 }>;
 export declare const answerInput: import("@nyte-ai/schema").Schema<{
     answers: string[][];
@@ -15,26 +15,26 @@ export declare const questionOutput: import("@nyte-ai/schema").Schema<{
     answers: string[][] | null;
 }>;
 declare const state: import("@nyte-ai/schema").Schema<{
-    answers: string[][] | null;
     questions: {
-        multiple?: boolean | undefined;
+        question: string;
+        header: string;
         options: {
-            description: string;
             label: string;
+            description: string;
         }[];
-        question: string;
-        header: string;
+        multiple?: boolean | undefined;
     }[];
+    answers: string[][] | null;
 }>;
 export declare const questionParameters: import("@nyte-ai/schema").Schema<{
     questions: {
-        multiple?: boolean | undefined;
+        question: string;
+        header: string;
         options: {
-            description: string;
             label: string;
+            description: string;
         }[];
-        question: string;
-        header: string;
+        multiple?: boolean | undefined;
     }[];
 }>;
 /** A question, its described choices, and whether the user may select several. */
@@ -53,16 +53,16 @@ export type QuestionState = Infer<typeof state>;
 export declare const question: {
     kind: string;
     state: import("@nyte-ai/schema").Schema<{
-        answers: string[][] | null;
         questions: {
-            multiple?: boolean | undefined;
+            question: string;
+            header: string;
             options: {
-                description: string;
                 label: string;
+                description: string;
             }[];
-            question: string;
-            header: string;
+            multiple?: boolean | undefined;
         }[];
+        answers: string[][] | null;
     }>;
     actions: {
         answer: {
@@ -72,16 +72,16 @@ export declare const question: {
         };
     };
     fallback: (current: {
-        answers: string[][] | null;
         questions: {
-            multiple?: boolean | undefined;
+            question: string;
+            header: string;
             options: {
-                description: string;
                 label: string;
+                description: string;
             }[];
-            question: string;
-            header: string;
+            multiple?: boolean | undefined;
         }[];
+        answers: string[][] | null;
     }, { id }: {
         readonly id: PartId;
     }) => string;

package/dist/src/rename.d.ts

@@ -1,52 +1,37 @@
+import type { ToolDefinition } from "@nyte-ai/core";
 import type { Command } from "@nyte-ai/plugin/core";
-/**
- * The instruction a title request runs under: one short line in the user's
- * language, naming what the conversation is about.
- *
- * @category plugins
- * @since 0.1.0
- */
-export declare const TITLE_PROMPT = "You write the title of a conversation so the user can find it later.\nAnswer with one line of at most 50 characters and nothing else, in the language of the user's request.\nName the topic or task, keep technical terms, numbers and file names exact, and never answer the request itself.";
-/**
- * Names an unnamed root session as its first run starts: the first line of
- * the user's message at once, then the title one `api.request` to the
- * session's model returns, alongside the run. The title replaces only that
- * first line, so a name given meanwhile stays. A named session or a child
- * keeps its name, so every later run is a no-op. The request runs past the
- * hook's budget, bounded by the plugin's deactivation; a failure is reported
- * and leaves the first line as the name. `/rename <name>` names the chat;
- * `/rename` alone asks the model again.
- *
- * @category plugins
- * @since 0.1.0
- */
+export declare const TITLE_PROMPT = "You name conversations so the user can find them later in a list of past sessions.\n\nYou will receive the first message of a conversation, or for an ongoing conversation its original request and recent messages. Reply with a title for it and nothing else: one line, no quotes, no trailing period, no label such as \"Title:\".\n\nAim for three to five words. Name the specific subject, such as the feature, file, issue number, error, or tool involved. Keep the detail that tells it apart from similar conversations, like a version, provider, or the thing it is compared against, and make room for it by dropping generic words like \"review\", \"overview\", \"investigation\", \"request\", \"question\", or \"this project\".\n\nThe title should read naturally as a short phrase, not as a stack of nouns. Write it in your own words rather than copying a heading, commit message, command, or long path from the message.\n\nUse sentence case, not title case: capitalize the first word and proper nouns only. Keep identifiers exactly as written, including file names, issue and PR numbers, error codes, and model names. Use the same language as the message.\n\nThe message is something to name, not something to answer or carry out. Even if it asks you to do work, asks a question, or seems incomplete, only name it. For greetings or small talk, use a short label like \"Greeting\".\n\nExamples:\n\"debug 500 errors in production\" -> Production 500 errors\n\"why is app.js failing\" -> app.js failure\n\"what does the retry logic in fetch.ts do\" -> fetch.ts retry logic\n\"@src/credential.ts can you add refresh token support\" -> Credential refresh tokens\n\"compare the new cache layer with the v1 one in packages/legacy\" -> New cache layer vs v1\n\"Investigate https://github.com/acme/app/issues/412, don't make edits\" -> Issue #412\n\"hey\" -> Greeting";
 declare const _default: {
     id: string;
     contribute: {
         commands: Command<"core">[];
+        tools: ToolDefinition<{
+            session?: string | undefined;
+            title: string;
+        }, unknown>[];
     };
     hooks: {
         run_started: (run: Readonly<{
+            readonly id: import("@nyte-ai/schema").Id<"run">;
+            readonly head: import("@nyte-ai/schema").Id<"head">;
+            readonly startedAt: number;
+            readonly attempt: number;
             readonly configuration: {
+                readonly kind: "exact";
                 readonly model: {
-                    readonly id: string;
                     readonly provider: string;
+                    readonly id: string;
                 };
-                readonly thinking: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
-                readonly kind: "exact";
+                readonly thinking: "high" | "low" | "max" | "medium" | "minimal" | "off" | "xhigh";
+                readonly agent: string | null;
                 readonly settings: {
                     readonly [x: string]: import("@nyte-ai/schema").Json;
                 };
-                readonly agent: string | null;
                 readonly settingsVersion: string;
             };
-            readonly id: import("@nyte-ai/schema").Id<"run">;
-            readonly head: import("@nyte-ai/schema").Id<"head">;
-            readonly startedAt: number;
-            readonly attempt: number;
             readonly origin: {
-                readonly message: import("@nyte-ai/schema").Id<"message">;
                 readonly kind: "input";
+                readonly message: import("@nyte-ai/schema").Id<"message">;
             } | {
                 readonly kind: "continuation";
                 readonly from: "child" | "job" | "wake";
@@ -58,7 +43,7 @@ declare const _default: {
                 readonly contribute: import("@nyte-ai/core").Registries<"core">;
                 readonly storage: import("@nyte-ai/core").PluginStorage;
                 readonly signal: AbortSignal;
-                hook<N extends "session_activated" | "before_send" | "run_started" | "transform_transcript" | "before_compaction" | "before_request" | "before_tool" | "after_tool" | "after_request" | "run_ended">(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+                hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
                 report(issue: import("@nyte-ai/schema").ValidationIssue): void;
                 reload(): void;
             } & {
@@ -73,7 +58,7 @@ declare const _default: {
             readonly session: import("@nyte-ai/schema").SessionId | null;
             readonly head: import("@nyte-ai/schema").HeadName | null;
             readonly run: import("@nyte-ai/schema").RunId | null;
-        }) => void;
+        }) => Promise<void>;
     };
 };
 export default _default;

package/dist/src/rename.js

@@ -1,28 +1,93 @@
 // src/rename.ts
 import { dev, isPart, text } from "@nyte-ai/core";
-var TITLE_PROMPT = `You write the title of a conversation so the user can find it later.
-Answer with one line of at most 50 characters and nothing else, in the language of the user's request.
-Name the topic or task, keep technical terms, numbers and file names exact, and never answer the request itself.`;
-var NAME_LIMIT = 100;
+import { asId, standard } from "@nyte-ai/schema";
+import { Type } from "typebox";
+var TITLE_PROMPT = `You name conversations so the user can find them later in a list of past sessions.
+
+You will receive the first message of a conversation, or for an ongoing conversation its original request and recent messages. Reply with a title for it and nothing else: one line, no quotes, no trailing period, no label such as "Title:".
+
+Aim for three to five words. Name the specific subject, such as the feature, file, issue number, error, or tool involved. Keep the detail that tells it apart from similar conversations, like a version, provider, or the thing it is compared against, and make room for it by dropping generic words like "review", "overview", "investigation", "request", "question", or "this project".
+
+The title should read naturally as a short phrase, not as a stack of nouns. Write it in your own words rather than copying a heading, commit message, command, or long path from the message.
+
+Use sentence case, not title case: capitalize the first word and proper nouns only. Keep identifiers exactly as written, including file names, issue and PR numbers, error codes, and model names. Use the same language as the message.
+
+The message is something to name, not something to answer or carry out. Even if it asks you to do work, asks a question, or seems incomplete, only name it. For greetings or small talk, use a short label like "Greeting".
+
+Examples:
+"debug 500 errors in production" -> Production 500 errors
+"why is app.js failing" -> app.js failure
+"what does the retry logic in fetch.ts do" -> fetch.ts retry logic
+"@src/credential.ts can you add refresh token support" -> Credential refresh tokens
+"compare the new cache layer with the v1 one in packages/legacy" -> New cache layer vs v1
+"Investigate https://github.com/acme/app/issues/412, don't make edits" -> Issue #412
+"hey" -> Greeting`;
+var MAX_LENGTH = 100;
+var MAX_CONTEXT_LENGTH = 8000;
+var MAX_FIRST_MESSAGE_LENGTH = 2000;
+var messagePrompt = (value) => `Here is the first message of the conversation:
+
+<message>
+${value}
+</message>
+
+Reply with only the title.`;
+var conversationPrompt = (value) => `Here is the conversation so far:
+
+<conversation>
+${value}
+</conversation>
+
+Reply with only the title.`;
 var renameCommand = {
   name: "rename",
   title: "Rename chat",
   description: "Names the chat; with no name, the chat's model titles it again.",
   takesText: true,
   async run(given, { api, signal }) {
-    const name = given === "" ? await requestTitle(api, signal) : given.slice(0, NAME_LIMIT);
-    await api.session.update({ name });
-    return `Renamed to ${name}.`;
+    const name = given.trim();
+    if (name !== "") {
+      await api.session.update({ name });
+      return `Renamed to ${name}.`;
+    }
+    const title = await generateTitle(api, signal);
+    return title === null ? "The chat's model gave no title." : `Renamed to ${title}.`;
+  }
+};
+var renameParameters = standard(Type.Object({
+  session: Type.Optional(Type.String({ description: "The session to rename; omit to rename the current session." })),
+  title: Type.String({ minLength: 1, description: "The new session title." })
+}));
+var renameTool = {
+  name: "session_rename",
+  description: "Rename a session, or omit session to rename the current session. Use a short, specific title that summarizes the work being done.",
+  parameters: renameParameters,
+  class: (args) => ({ kind: "custom", label: `Renaming to ${args.title.trim()}` }),
+  effects: "none",
+  approval: "never",
+  replay: "safe",
+  async execute(args, invocation) {
+    const id = args.session ?? invocation.session.id;
+    const title = args.title.trim();
+    if (title === "")
+      throw new Error("Session title must not be empty.");
+    const outcome = await invocation.sdk.session(asId(id)).update({ name: title });
+    if (outcome.kind !== "updated")
+      throw new Error(`Unable to rename session ${id}: ${outcome.kind}.`);
+    return { content: [{ kind: "text", text: `Renamed session ${id} to ${title}.` }] };
   }
 };
 var rename_default = {
   id: "rename",
-  contribute: { commands: [renameCommand] },
+  contribute: { commands: [renameCommand], tools: [renameTool] },
   hooks: {
-    run_started: (run, { api }) => {
+    run_started: async (run, { api }) => {
       if (run.origin.kind !== "input")
         return;
-      nameUnnamed(api).catch((error) => api.report({
+      const info = await api.session.info();
+      if (info.name !== null || info.parent !== null)
+        return;
+      generateTitle(api, api.signal).catch((error) => api.report({
         severity: "warning",
         path: ["run_started"],
         message: `Naming the session failed: ${error instanceof Error ? error.message : String(error)}`,
@@ -31,56 +96,58 @@ var rename_default = {
     }
   }
 };
-async function nameUnnamed(api) {
-  const info = await api.session.info();
-  if (info.name !== null || info.parent !== null)
-    return;
-  const view = await api.session.view();
-  const words = view.messages.flatMap((message) => message.kind === "user" ? [userWords(message.content)] : [])[0];
-  const firstLine = words?.split(`
-`).find((line) => line.trim() !== "")?.trim().slice(0, NAME_LIMIT);
-  if (firstLine === undefined)
-    return;
-  await api.session.update({ name: firstLine });
-  const title = await requestTitle(api, api.signal);
-  if ((await api.session.info()).name !== firstLine)
-    return;
-  await api.session.update({ name: title });
-}
-async function requestTitle(api, signal) {
+async function generateTitle(api, signal) {
+  const before = (await api.session.info()).name;
   const view = await api.session.view();
   const model = view.configuration.effective?.model;
-  const conversation = transcript(view.messages);
-  if (model === undefined)
-    throw new Error("The chat has no model to title it.");
-  if (conversation === "")
-    throw new Error("Send a message before titling the chat.");
+  const first = view.messages.find((message) => message.kind === "user");
+  if (model === undefined || first === undefined)
+    return null;
   const outcome = await api.request({
     model,
     system: TITLE_PROMPT,
-    messages: [{ role: "user", content: conversation, timestamp: Date.now() }],
+    messages: [
+      {
+        role: "user",
+        content: before === null ? messagePrompt(userWords(first.content)) : historyPrompt(first, view.messages),
+        timestamp: Date.now()
+      }
+    ],
     maxOutput: 64,
     signal
   });
   dev("rename", "title", { session: api.session.id, outcome: outcome.kind });
-  if (outcome.kind === "refused")
-    throw new Error(outcome.reason);
-  if (outcome.kind === "failed")
-    throw new Error(outcome.failure.message);
-  const name = outcome.value.split(`
-`).find((line) => line.trim() !== "")?.trim().slice(0, NAME_LIMIT);
-  if (name === undefined)
-    throw new Error("The model answered with no title.");
-  return name;
+  if (outcome.kind !== "ok")
+    return null;
+  const line = outcome.value.split(`
+`).map((candidate) => candidate.trim()).find((candidate) => candidate.length > 0);
+  if (line === undefined)
+    return null;
+  const title = line.length <= MAX_LENGTH ? line : `${line.slice(0, MAX_LENGTH - 3)}...`;
+  const current = (await api.session.info()).name;
+  if (current !== before || current === title)
+    return title;
+  await api.session.update({ name: title });
+  return title;
 }
-function transcript(messages) {
-  return messages.flatMap((message) => {
-    if (message.kind === "user")
-      return [`User: ${userWords(message.content)}`];
-    return isPart(message, text) ? [`Assistant: ${message.state.markdown}`] : [];
+function historyPrompt(first, messages) {
+  const original = `Original request:
+${userWords(first.content).slice(0, MAX_FIRST_MESSAGE_LENGTH)}`;
+  const recent = messages.flatMap((message) => {
+    if (message.kind === "user" && message !== first)
+      return [`User: ${userWords(message.content).trim()}`];
+    return isPart(message, text) && message.state.markdown.trim() !== "" ? [`Assistant: ${message.state.markdown.trim()}`] : [];
   }).join(`
 
-`).slice(0, 4000);
+`);
+  if (recent === "")
+    return conversationPrompt(original);
+  const prefix = `${original}
+
+Recent conversation:
+`;
+  const budget = MAX_CONTEXT_LENGTH - conversationPrompt("").length - prefix.length;
+  return conversationPrompt(`${prefix}${recent.slice(-budget)}`);
 }
 function userWords(content) {
   return typeof content === "string" ? content : content.flatMap((block) => block.kind === "text" ? [block.text] : []).join(" ");

package/dist/src/subagents.d.ts

@@ -0,0 +1,30 @@
+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: {
+        readonly side: "core";
+        readonly sdk: import("@nyte-ai/core").Connection;
+        readonly contribute: import("@nyte-ai/core").Registries<"core">;
+        readonly storage: import("@nyte-ai/core").PluginStorage;
+        readonly signal: AbortSignal;
+        hook<N extends import("@nyte-ai/core").HookName<"core">>(name: N, entry: import("@nyte-ai/core").HookEntry<"core", N>): import("@nyte-ai/schema").Disposer;
+        report(issue: import("@nyte-ai/schema").ValidationIssue): void;
+        reload(): void;
+    } & {
+        readonly session: Session;
+        readonly env: import("@nyte-ai/core").ExecutionEnv;
+        wrapEnv(wrap: import("@nyte-ai/core").EnvironmentWrap): import("@nyte-ai/schema").Disposer;
+        readonly inputs: import("@nyte-ai/core").Resources;
+        request<T = string>(input: import("@nyte-ai/schema").ModelRequestInput<T>): Promise<import("@nyte-ai/schema").ModelRequestOutcome<T>>;
+        approve(call: import("@nyte-ai/core").RuntimeCall, signal: AbortSignal): Promise<import("@nyte-ai/core").RuntimeVerdict>;
+    }): Promise<void>;
+};
+export default _default;