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

package/dist/src/subagents.js

@@ -9,22 +9,24 @@ var SCHEDULED = {
   deciding: "its plugins are deciding it"
 };
 var selectionParameters = {
-  agent: Type.Optional(Type.String({ description: "A registered agent to run as; the default agent otherwise." })),
+  agent: Type.Optional(Type.String({
+    description: "A registered agent to run as, only when the user names one. Without it, a chat that runs as an agent starts subagents of its own agent, model and thinking level; any other chat, of the default agent."
+  })),
   model: Type.Optional(Type.String({
-    description: "A model from /model, as provider/id or its id alone; a fast variant is its own id. The default model otherwise."
+    description: "A model to run on, only when the user asks for one: provider/id or an id from /model. Without it, the subagent runs on the inherited or default model."
   })),
   thinking: Type.Optional(Type.Enum(["off", "minimal", "low", "medium", "high", "xhigh", "max"], {
-    description: "A thinking level the model accepts; its default otherwise."
+    description: "A thinking level, only when the user asks for one; the model must accept it. The inherited level or the model's default otherwise."
   }))
 };
 var isolationParameter = {
   isolation: Type.Optional(Type.Literal("worktree", {
-    description: "Run the subagent in a git worktree on a new branch from HEAD, with your uncommitted changes copied in, so its edits stay out of this workspace. The reply names the folder and branch. Without it, the subagent works in this workspace."
+    description: "Only when the user asks for an isolated copy: runs the subagent in a git worktree on a new branch from HEAD, with your uncommitted changes copied in. The reply names the folder and branch. Without it, the subagent works in this workspace."
   }))
 };
 var taskParameters = standard(Type.Object({
   prompt: Type.String({
-    description: "The task for the subagent, with everything it needs to know."
+    description: "The task for the subagent, with everything it needs to know. Only its last message comes back, so say what that message should report."
   }),
   title: Type.Optional(Type.String({ description: "A short name for the subagent's session." })),
   ...selectionParameters,
@@ -32,7 +34,7 @@ var taskParameters = standard(Type.Object({
 }));
 var createParameters = standard(Type.Object({
   prompt: Type.String({
-    description: "The subagent's first message; it starts working on it at once."
+    description: "The subagent's first message; it starts working on it at once. Only its last message comes back, so say what that message should report."
   }),
   title: Type.Optional(Type.String({ description: "A short name for the subagent's session." })),
   ...selectionParameters,
@@ -60,7 +62,7 @@ var stopParameters = standard(Type.Object({
 }));
 var task = {
   name: "task",
-  description: "Run a subagent on a task and wait for its answer. Give it everything it needs; it does not see this conversation.",
+  description: "Run a subagent and get its answer as this call's result. Use it whenever you need the answer this turn; several task calls in one response run in parallel. Give it everything it needs; it does not see this conversation. A new message to you ends the wait early, and the answer reaches you when it finishes.",
   parameters: taskParameters,
   class: (args) => ({ kind: "delegate", child: null, role: "task", title: args.title ?? null }),
   replay: "safe",
@@ -92,7 +94,7 @@ ${answer}`, "head"));
 };
 var create = {
   name: "create",
-  description: "Start a subagent on a first message and return its id, to send it more messages and await it later.",
+  description: "Start a subagent in the background and return its id at once, for work you won't wait on or a subagent you'll message again with send. Its answer reaches you on its own when it finishes. When you need the answer this turn, use task instead. Link it in a reply as [short title](agent:<id>).",
   parameters: createParameters,
   class: (args) => ({ kind: "delegate", child: null, role: "create", title: args.title ?? null }),
   effects: "none",
@@ -112,7 +114,7 @@ var create = {
 };
 var send = {
   name: "send",
-  description: "Send a message to a subagent; it works in the background. Use await for its answer.",
+  description: "Send a message to a subagent from create. A message sent while it works runs once that work ends, so there is no need to await first. Use await for its answer.",
   parameters: sendParameters,
   class: (args) => ({
     kind: "delegate",
@@ -134,7 +136,7 @@ var send = {
 };
 var awaitChild = {
   name: "await",
-  description: "Wait for a subagent to finish its current work and return its answer.",
+  description: "Wait for a subagent to finish its current work and return its answer. A new message to you ends the wait early, with the subagent still working.",
   parameters: awaitParameters,
   class: (args) => ({
     kind: "delegate",
@@ -223,20 +225,23 @@ var subagents_default = {
       api.contribute.tools.add(definition);
   }
 };
-async function childConfiguration(invocation, { agent, model, thinking }) {
-  if (agent === undefined && model === undefined && thinking === undefined)
-    return;
-  return {
-    agent,
-    model: model === undefined ? undefined : await findModel(invocation, model),
-    thinking
+async function childConfiguration(invocation, args) {
+  const view = await invocation.session.head(invocation.head).view({ tail: 0 });
+  const unregistered = args.agent !== undefined && !view.catalog.agents.some((agent) => agent.id === args.agent) ? args.agent : undefined;
+  const agent = unregistered === undefined ? args.agent : undefined;
+  const effective = view.configuration.effective;
+  const parent = agent === undefined && effective?.agent !== null ? effective : null;
+  const named = unregistered === undefined ? args.model === undefined ? undefined : await findModel(invocation, args.model) : await findAgentModel(invocation, unregistered, args.model);
+  const patch = {
+    agent: agent ?? parent?.agent,
+    model: named ?? parent?.model,
+    thinking: args.thinking ?? (named === undefined ? parent?.thinking : undefined)
   };
+  return Object.values(patch).every((value) => value === undefined) ? undefined : patch;
 }
 async function findModel(invocation, name) {
-  const models = (await invocation.sdk.models.list()).providers.flatMap((provider) => provider.credential === "unknown" || provider.credential === "configured" || provider.credential === "verified" ? provider.models : []);
-  const refs = models.flatMap((info) => info.fast === null ? [info.ref] : [info.ref, info.fast]);
-  const exact = refs.filter((ref) => `${ref.provider}/${ref.id}` === name);
-  const matches = exact.length > 0 ? exact : refs.filter((ref) => ref.id === name);
+  const models = await listModels(invocation);
+  const matches = matchModels(models, name);
   const [only, ...others] = matches;
   if (only !== undefined && others.length === 0)
     return only;
@@ -248,6 +253,45 @@ async function findModel(invocation, name) {
 ${models.map((info) => `- ${info.ref.provider}/${info.ref.id} (thinking: ${info.thinking.join(", ")})${info.fast === null ? "" : `, fast: ${info.fast.provider}/${info.fast.id}`}`).join(`
 `)}`);
 }
+async function findAgentModel(invocation, agent, model) {
+  const models = await listModels(invocation);
+  const names = model === undefined ? [agent] : [model, `${agent} ${model}`, agent];
+  const [found] = names.flatMap((name) => {
+    const matches = matchModels(models, name);
+    return matches.length === 1 ? matches : [];
+  });
+  if (found === undefined)
+    throw new Error(`No agent is registered as ${agent}.`);
+  return found;
+}
+async function listModels(invocation) {
+  return (await invocation.sdk.models.list()).providers.flatMap((provider) => provider.credential === "unknown" || provider.credential === "configured" || provider.credential === "verified" ? provider.models : []);
+}
+function matchModels(models, name) {
+  const refs = models.flatMap((info) => info.fast === null ? [info.ref] : [info.ref, info.fast]);
+  const exact = refs.filter((ref) => `${ref.provider}/${ref.id}` === name);
+  if (exact.length > 0)
+    return exact;
+  const ids = refs.filter((ref) => ref.id === name);
+  return ids.length > 0 ? ids : closestModels(refs, name);
+}
+function closestModels(refs, name) {
+  const wanted = modelWords(name);
+  if (!wanted.some((word) => /[a-z]/u.test(word)))
+    return [];
+  const held = refs.flatMap((ref) => {
+    const words = modelWords(`${ref.provider}/${ref.id}`);
+    return wanted.every((word) => countWord(words, word) >= countWord(wanted, word)) ? [{ ref, extra: modelWords(ref.id).length }] : [];
+  });
+  const fewest = Math.min(...held.map((entry) => entry.extra));
+  return held.flatMap((entry) => entry.extra === fewest ? [entry.ref] : []);
+}
+function modelWords(source) {
+  return source.toLowerCase().match(/[a-z]+|\d+/gu) ?? [];
+}
+function countWord(words, word) {
+  return words.filter((entry) => entry === word).length;
+}
 async function describeWorktree(invocation, child) {
   const workspace = await invocation.sdk.workspace((await child.info()).workspace).info();
   if (workspace.isolation === null)

package/dist/src/tool-search.d.ts

@@ -1,7 +1,6 @@
 import type { ToolNamespace } from "@nyte-ai/core";
 import type { ToolInfo } from "@nyte-ai/schema";
 export declare const DEFAULT_SEARCH_LIMIT = 8;
-/** A tool as the ranker sees it: its name and the text {@link createToolSearchDocument} builds. */
 export type ToolSearchDocument = {
     readonly name: string;
     readonly text: string;

package/dist/src/web/body.d.ts

@@ -1,3 +1,2 @@
 export type Fetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
-/** Reads a response body, throwing once its declared or streamed size passes `limit` bytes. */
 export declare function readCapped(response: Response, limit: number): Promise<Uint8Array>;

package/dist/src/web/fetch.d.ts

@@ -7,10 +7,5 @@ declare const fetchParameters: Type.TObject<{
     format: Type.TOptional<Type.TUnion<[Type.TLiteral<"markdown">, Type.TLiteral<"text">, Type.TLiteral<"html">]>>;
     timeout: Type.TOptional<Type.TNumber>;
 }>;
-/**
- * The `web_fetch` tool: GETs an http(s) URL through `fetch`, following at most ten
- * redirects that stay on http(s), and returns HTML as markdown, text or itself, other
- * text as is, and an image as a file. Bodies stop at 5 MiB; text shown inline at 50 KiB.
- */
 export declare function webFetch(fetch: Fetch): ToolDefinition<Static<typeof fetchParameters>>;
 export {};

package/dist/src/web/html-markdown.d.ts

@@ -1,9 +1,3 @@
 export declare const MAX_MARKDOWN_BYTES: number;
-/**
- * Converts HTML to Markdown in one streaming pass: drops scripts, styles, the head and
- * hidden elements; keeps headings, lists, GFM tables, fenced code, links and images;
- * stops nesting past 10,000 levels and caps the result at `MAX_MARKDOWN_BYTES`.
- */
 export declare function htmlToMarkdown(html: string): string;
-/** Returns an HTML document's text outside scripts, styles and embeds, trimmed. */
 export declare function htmlToText(html: string): string;

package/dist/src/web/index.d.ts

@@ -14,11 +14,5 @@ export type { SearchInput, ShippedProvider } from "./providers.ts";
  * @since 0.1.0
  */
 export declare function webPlugin(fetch: Fetch): Plugin;
-/**
- * The web plugin over the global `fetch`.
- *
- * @category plugins
- * @since 0.1.0
- */
 declare const _default: Plugin;
 export default _default;

package/dist/src/web/providers.d.ts

@@ -1,11 +1,5 @@
 import type { SearchProvider, SearchResult } from "@nyte-ai/plugin/core";
 import type { Fetch } from "./body.ts";
-/**
- * The search providers the web plugin ships, by id and display name.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare const PROVIDERS: readonly [{
     readonly id: "exa";
     readonly name: "Exa";
@@ -19,12 +13,6 @@ export declare const PROVIDERS: readonly [{
     readonly id: "parallel";
     readonly name: "Parallel";
 }];
-/**
- * Names a search provider the web plugin ships.
- *
- * @category plugins
- * @since 0.1.0
- */
 export type ShippedProvider = (typeof PROVIDERS)[number]["id"];
 /**
  * Returns what one adapter call needs: the query, the provider's key or
@@ -50,11 +38,4 @@ export interface SearchInput {
 export declare const adapters: {
     readonly [P in ShippedProvider]: (input: SearchInput) => Promise<readonly SearchResult[]>;
 };
-/**
- * Returns the shipped providers for the search registry, each reading its key
- * through `key` on every search and sending through `fetch`.
- *
- * @category plugins
- * @since 0.1.0
- */
 export declare function shippedProviders(fetch: Fetch, key: (provider: ShippedProvider) => Promise<string | undefined>): readonly SearchProvider[];

package/dist/src/web/search.d.ts

@@ -11,10 +11,6 @@ declare const searchOutput: Type.TObject<{
     }>>;
 }>;
 type SearchOutput = Static<typeof searchOutput>;
-/**
- * The `web_search` tool: asks the registered provider the setting `setting` names,
- * falling back to Exa and then to the first one registered.
- */
 export declare function webSearch(api: PluginApi, setting: string): ToolDefinition<{
     query: string;
 }, SearchOutput>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyte-ai/plugin",
-  "version": "0.0.27",
+  "version": "0.0.28-nightly.20261107.65",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -168,9 +168,9 @@
     "@agentclientprotocol/sdk": "^2.4.0",
     "@anthropic-ai/claude-agent-sdk": "^0.3.317",
     "@earendil-works/pi-codemode": "^1.5.0",
-    "@nyte-ai/ai": "0.0.27",
-    "@nyte-ai/core": "0.0.27",
-    "@nyte-ai/schema": "0.0.27",
+    "@nyte-ai/ai": "0.0.28-nightly.20261107.65",
+    "@nyte-ai/core": "0.0.28-nightly.20261107.65",
+    "@nyte-ai/schema": "0.0.28-nightly.20261107.65",
     "@opentelemetry/api": "^1.10.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.300.0",
     "@opentelemetry/resources": "^3.0.0",