@nyte-ai/plugin 0.0.18 → 0.0.19

package/THIRD-PARTY-NOTICES.md

@@ -91,6 +91,9 @@ SOFTWARE.
 - Transcript reconciliation, checkpoint instruction snapshots, provider system
   updates, and cache warming are ported from the 1.0.0 release commit
   `a13d35a742c6ef8462812a28fbe1d8c8b7431c32`.
+- Fitting images to model limits (`packages/core/src/agent/images.ts` and
+  `packages/host/src/images`) is ported from `@earendil-works/pi-durable`'s
+  images at commit `73f8de80bc87021375f8b525292ac07492253002`.
 
 License: MIT, with the following notice:
 
@@ -148,6 +151,16 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 ```
 
+## Photon (`silvia-odwyer/photon`)
+
+- Repository: https://github.com/silvia-odwyer/photon
+- Package: `@silvia-odwyer/photon` 0.3.3
+- What: the host decodes, orients, scales and re-encodes images for the model
+  with Photon's WebAssembly build.
+
+License: Apache License 2.0, reproduced in the appendix below. Copyright 2023
+Silvia O'Dwyer.
+
 ## Pierre
 
 - Repository: https://github.com/pierrecomputer/pierre
@@ -561,6 +574,59 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## snapcn (`snapcndev/snapcn`)
+
+- Repository: https://github.com/snapcndev/snapcn
+- What: the launch film's Logo Flicker and Check Cycle scenes
+  (`packages/lab/video/src/snap-cn/`) are adapted from snapcn's registry
+  components at commit `47ee435f17d85f74abf48b095b40d64fc9616fb0`.
+
+License: MIT, with the following notice:
+
+```text
+MIT License
+
+Copyright (c) 2026 Sri Nath (snap-cn)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Naybr, "Copyright Free Gameplay (No Commentary) - Minecraft Survival"
+
+- Source: https://www.youtube.com/watch?v=GPsGyv5zTlM, by Naybr (youtube.com/@Naybr)
+- What: the launch film opens on four shots from 0:30 to 2:30 of this video
+  (`clip` in `packages/lab/video/src/film/media.ts`). The footage is not in
+  the repository; `packages/lab/video/README.md` says how to fetch it.
+
+License: Creative Commons Attribution, as published on YouTube. The author
+allows use, modification, redistribution and monetisation, with this credit
+wherever the gameplay is used: "Gameplay – youtube.com/@Naybr".
+
+## Photographs in the launch film
+
+- Source: Wikimedia Commons; each file's author and source page are listed in
+  `photos` in `packages/lab/video/src/film/media.ts`.
+- What: eleven photographs the launch film cuts between. They are not in the
+  repository.
+
+License: every one is public domain or CC0. None requires attribution.
+
 ## Design references
 
 These credits record design sources. They do not grant a license to the

package/dist/chunks/billing-4vz9pxyx.js

@@ -0,0 +1,22 @@
+// src/find-on-path.ts
+import { constants } from "node:fs";
+import { access } from "node:fs/promises";
+import { delimiter, join } from "node:path";
+async function executable2(path) {
+  try {
+    await access(path, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findOnPath2(name, path) {
+  const names = process.platform === "win32" ? [`${name}.exe`, `${name}.cmd`, name] : [name];
+  for (const dir of path.split(delimiter))
+    for (const candidate of names)
+      if (dir !== "" && await executable2(join(dir, candidate)))
+        return join(dir, candidate);
+  return;
+}
+
+export { executable2, findOnPath2 };

package/dist/chunks/{billing-k2p1t25n.js → billing-hg64tqf1.js}

@@ -1,7 +1,11 @@
+import {
+  executable2,
+  findOnPath2
+} from "./billing-4vz9pxyx.js";
+
 // src/acp/registry.ts
-import { constants } from "node:fs";
-import { access, readFile, realpath } from "node:fs/promises";
-import { basename, delimiter, dirname, join } from "node:path";
+import { readFile, realpath } from "node:fs/promises";
+import { basename, dirname, join } from "node:path";
 import { Type } from "typebox";
 import { Value } from "typebox/value";
 var launch = {
@@ -29,22 +33,6 @@ function platformTarget() {
   const arch = process.arch === "arm64" ? "aarch64" : process.arch === "x64" ? "x86_64" : process.arch;
   return `${os}-${arch}`;
 }
-async function executable(path) {
-  try {
-    await access(path, constants.X_OK);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function findOnPath(name, path) {
-  const names = process.platform === "win32" ? [`${name}.exe`, `${name}.cmd`, name] : [name];
-  for (const dir of path.split(delimiter))
-    for (const candidate of names)
-      if (dir !== "" && await executable(join(dir, candidate)))
-        return join(dir, candidate);
-  return;
-}
 async function resolved(path) {
   try {
     return await realpath(path);
@@ -54,7 +42,7 @@ async function resolved(path) {
 }
 async function globalBin(spec, path) {
   const name = PACKAGE.exec(spec)?.[1] ?? spec;
-  const npx = await findOnPath("npx", path);
+  const npx = await findOnPath2("npx", path);
   if (npx === undefined)
     return;
   const bin = dirname(npx);
@@ -79,12 +67,12 @@ async function globalBin(spec, path) {
   }
   const linked = join(bin, command);
   const [from, to] = await Promise.all([resolved(linked), resolved(join(root, target))]);
-  return from !== undefined && from === to && await executable(linked) ? linked : undefined;
+  return from !== undefined && from === to && await executable2(linked) ? linked : undefined;
 }
 async function installed(agent, path) {
   const binary = agent.distribution.binary?.[platformTarget()];
   if (binary !== undefined) {
-    const command = await findOnPath(basename(binary.cmd).replace(/\.exe$/, ""), path);
+    const command = await findOnPath2(basename(binary.cmd).replace(/\.exe$/, ""), path);
     if (command !== undefined)
       return {
         id: agent.id,

package/dist/chunks/{billing-wmkxkypm.js → billing-tm34gm2p.js}

@@ -164,7 +164,8 @@ class ClaudeCodeSession2 {
         CLAUDE_AGENT_SDK_CLIENT_APP: "nyte",
         CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS: "1"
       },
-      stderr: (chunk) => this.#stderr = (this.#stderr + chunk).slice(-4096)
+      stderr: (chunk) => this.#stderr = (this.#stderr + chunk).slice(-4096),
+      pathToClaudeCodeExecutable: launch.claude
     };
     if (launch.effort !== undefined)
       options.effort = launch.effort;

package/dist/chunks/{billing-9mfedmsh.js → billing-v3hg5rc7.js}

@@ -15,7 +15,7 @@ import { processEnvironment } from "@nyte-ai/core";
 // package.json
 var package_default = {
   name: "@nyte-ai/plugin",
-  version: "0.0.18",
+  version: "0.0.19",
   private: false,
   license: "MIT",
   repository: {
@@ -195,7 +195,7 @@ var package_default = {
   scripts: {
     clean: "rm -rf node_modules .turbo",
     test: "vitest --run",
-    typecheck: "tsgo --noEmit",
+    typecheck: "tsrs --noEmit",
     "build:package": "bun ../../scripts/sdk-packages.mjs build plugin"
   },
   dependencies: {

package/dist/src/acp/connection.js

@@ -1,6 +1,6 @@
 import {
   AcpProcess2
-} from "../../chunks/billing-9mfedmsh.js";
+} from "../../chunks/billing-v3hg5rc7.js";
 import"../../chunks/billing-svrhh5a5.js";
 import"../../chunks/billing-9nn3yp18.js";
 export {

package/dist/src/acp/index.js

@@ -8,11 +8,12 @@ import {
 import"../../chunks/billing-svrhh5a5.js";
 import {
   AcpProcess2
-} from "../../chunks/billing-9mfedmsh.js";
+} from "../../chunks/billing-v3hg5rc7.js";
+import"../../chunks/billing-4vz9pxyx.js";
 import {
   registryEntries2,
   installedAgents2
-} from "../../chunks/billing-k2p1t25n.js";
+} from "../../chunks/billing-hg64tqf1.js";
 import {
   messageKey2,
   userBlocks2,

package/dist/src/acp/registry.js

@@ -1,7 +1,8 @@
 import {
   registryEntries2,
   installedAgents2
-} from "../../chunks/billing-k2p1t25n.js";
+} from "../../chunks/billing-hg64tqf1.js";
+import"../../chunks/billing-4vz9pxyx.js";
 export {
   installedAgents2 as installedAgents,
   registryEntries2 as registryEntries

package/dist/src/claude-code-sdk/index.js

@@ -1,3 +1,6 @@
+import {
+  findOnPath2
+} from "../../chunks/billing-4vz9pxyx.js";
 import {
   answerInput2
 } from "../../chunks/billing-6z2kgtyt.js";
@@ -13,7 +16,7 @@ import {
 } from "../../chunks/billing-ye3wk5r3.js";
 import {
   ClaudeCodeSession2
-} from "../../chunks/billing-wmkxkypm.js";
+} from "../../chunks/billing-tm34gm2p.js";
 import {
   mirrorArguments3,
   userBlocks3,
@@ -74,7 +77,13 @@ function effortFor(model, reasoning) {
   const mapped = model.thinkingLevelMap?.[level] ?? level;
   return EFFORTS.find((effort) => effort === mapped) ?? (level === "minimal" ? "low" : undefined);
 }
+async function findClaudeCode() {
+  await processEnvironment();
+  return await findOnPath2("claude", process.env.PATH ?? "");
+}
 async function claudeCodeConfigured() {
+  if (await findClaudeCode() === undefined)
+    return false;
   try {
     await access(process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), ".claude"));
     return true;
@@ -92,7 +101,7 @@ function answerOnce(start, model, context, options) {
   (async () => {
     try {
       stream.push({ type: "start", partial: output });
-      await processEnvironment();
+      const claude = await findClaudeCode();
       for await (const message of start({
         prompt: flatPrompt2(context.messages),
         options: {
@@ -106,7 +115,8 @@ function answerOnce(start, model, context, options) {
           persistSession: false,
           includePartialMessages: true,
           thinking: { type: "disabled" },
-          env: { ...process.env, ...options?.env }
+          env: { ...process.env, ...options?.env },
+          pathToClaudeCodeExecutable: claude
         }
       })) {
         if (message.type === "stream_event" && message.parent_tool_use_id === null)
@@ -267,7 +277,7 @@ function claudeCodeSdk(start = query) {
       session?.close();
       if (prompt.length === 0)
         throw new Error(NOT_RUNNING);
-      await processEnvironment();
+      const claude = await findClaudeCode();
       const claudeSession = randomUUID();
       session = new ClaudeCodeSession2({
         key,
@@ -285,6 +295,7 @@ function claudeCodeSdk(start = query) {
         }),
         tools,
         query: start,
+        claude,
         approve: binding.approve
       });
       sessions.set(id, session);

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

@@ -13,6 +13,8 @@ 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;
     readonly approve: Approve;
 }
 /** Decides a call Claude Code asks to run under Nyte's permissions policy, by the tool's own name. */

package/dist/src/claude-code-sdk/session.js

@@ -1,6 +1,6 @@
 import {
   ClaudeCodeSession2
-} from "../../chunks/billing-wmkxkypm.js";
+} from "../../chunks/billing-tm34gm2p.js";
 import"../../chunks/billing-ye3wk5r3.js";
 export {
   ClaudeCodeSession2 as ClaudeCodeSession

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

@@ -1,8 +1,9 @@
 import type { RunEnd } from "@nyte-ai/schema";
 /**
  * Tells the user when a run ends in any session this client can see:
- * finished, stopped, or failed with the reason. Sessions a parent spawned
- * stay quiet, so a delegation does not ring once per child.
+ * finished, or failed with the reason. A stopped run stays quiet because
+ * someone asked for it, and so do sessions a parent spawned, so a delegation
+ * does not ring once per child.
  *
  * @category plugins
  * @since 0.1.0

package/dist/src/client/notifications.js

@@ -10,9 +10,7 @@ var notifications_default = {
       const { end } = event;
       if (end.kind === "completed")
         api.ui.notify({ title, message: "Run finished", level: "info" });
-      else if (end.kind === "stopped")
-        api.ui.notify({ title, message: "Run stopped", level: "warning" });
-      else
+      else if (end.kind === "failed")
         api.ui.notify({ title, message: `Run failed: ${line(end)}`, level: "error" });
     }
   }

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

@@ -1,6 +1,6 @@
 import { text, thinking } from "@nyte-ai/core";
 import type { PartState } from "@nyte-ai/core";
-import type { Execution, Failure, HeadInfo, Message, MessageSource, SessionInfo, ToolClass, ToolPartState, UserContent } from "@nyte-ai/schema";
+import type { Execution, Failure, HeadInfo, Message, MessageSource, SessionInfo, ToolClass, ToolPartState, UserContent, UserStatus } from "@nyte-ai/schema";
 /**
  * A message the user sent, or one a child, job or action delivered for them.
  *
@@ -92,6 +92,32 @@ export declare function readRawPart(message: PartMessage): RawPart;
  * @category presentation
  */
 export declare function showsReport(message: UserMessage): message is ReportMessage;
+type PendingStatus = Extract<UserStatus, {
+    readonly kind: "pending";
+}>;
+/**
+ * A message that waits in the queue: unsent, or pending for a later turn. A pending steer sent
+ * while idle or joining the live run is never one.
+ *
+ * @category presentation
+ */
+export type QueuedMessage = UserMessage & {
+    readonly status: Extract<UserStatus, {
+        readonly kind: "unsent";
+    }> | (PendingStatus & {
+        readonly schedule: Exclude<PendingStatus["schedule"], {
+            readonly kind: "joined";
+        }>;
+    });
+};
+/**
+ * Whether a message waits in the queue rather than showing in the transcript. A retrying send
+ * always waits. Reports, joined steers and steers sent while idle stay in the transcript.
+ * Other messages wait only while a run is active.
+ *
+ * @category presentation
+ */
+export declare function waitsInQueue(message: UserMessage, running: boolean): message is QueuedMessage;
 /**
  * What a user message shows: an action's label in place of the prompt it sent.
  *

package/dist/src/client/presentation.js

@@ -21,6 +21,23 @@ function readRawPart(message) {
 function showsReport(message) {
   return message.source.kind === "child" || message.source.kind === "job";
 }
+function waitsInQueue(message, running) {
+  const { status } = message;
+  if (showsReport(message))
+    return false;
+  switch (status.kind) {
+    case "landed":
+      return false;
+    case "unsent":
+      return status.retrying !== null || running && message.delivery !== "steer";
+    case "pending":
+      return running && status.schedule.kind !== "joined" && !(message.delivery === "steer" && status.schedule.kind === "next-turn" && status.schedule.reason === "idle");
+    default: {
+      const _exhaustive = status;
+      return _exhaustive;
+    }
+  }
+}
 function shownContent(message) {
   return message.source.kind === "action" ? message.source.label : message.content;
 }
@@ -369,5 +386,6 @@ export {
   toolStatus,
   toolSubject,
   toolTitle,
-  toolVerbs
+  toolVerbs,
+  waitsInQueue
 };

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

@@ -0,0 +1,4 @@
+/** 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/find-on-path.js

@@ -0,0 +1,8 @@
+import {
+  executable2,
+  findOnPath2
+} from "../chunks/billing-4vz9pxyx.js";
+export {
+  executable2 as executable,
+  findOnPath2 as findOnPath
+};

package/dist/src/rename.d.ts

@@ -8,12 +8,14 @@ import type { Command } from "@nyte-ai/plugin/core";
  */
 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 after its first run: one `api.request` to
- * the session's model for a title, then `session.update({ name })`. 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 name alone. `/rename <name>` names the
- * chat; `/rename` alone asks the model again.
+ * 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
@@ -24,31 +26,30 @@ declare const _default: {
         commands: Command<"core">[];
     };
     hooks: {
-        run_ended: (_end: Readonly<{
-            readonly kind: "completed";
-            readonly usage: {
-                readonly output: number;
-                readonly input: number;
-                readonly cacheRead: number;
-                readonly cacheWrite: number;
-                readonly reasoning: number | null;
-                readonly total: number;
-                readonly cost: {
-                    readonly output: number;
-                    readonly input: number;
-                    readonly cacheRead: number;
-                    readonly cacheWrite: number;
-                    readonly total: number;
+        run_started: (run: Readonly<{
+            readonly configuration: {
+                readonly model: {
+                    readonly id: string;
+                    readonly provider: string;
                 };
+                readonly thinking: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+                readonly kind: "exact";
+                readonly settings: {
+                    readonly [x: string]: import("@nyte-ai/schema").Json;
+                };
+                readonly agent: string | null;
+                readonly settingsVersion: string;
             };
-        } | {
-            readonly kind: "stopped";
-        } | {
-            readonly kind: "failed";
-            readonly failure: {
-                readonly retryAfterMs?: number | undefined;
-                readonly message: string;
-                readonly class: "aborted" | "provider" | "rate_limit" | "auth" | "quota" | "context_window" | "overloaded" | "network" | "runner";
+            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 kind: "continuation";
+                readonly from: "child" | "job" | "wake";
             };
         }>, { api }: {
             readonly api: {

package/dist/src/rename.js

@@ -19,10 +19,12 @@ var rename_default = {
   id: "rename",
   contribute: { commands: [renameCommand] },
   hooks: {
-    run_ended: (_end, { api }) => {
+    run_started: (run, { api }) => {
+      if (run.origin.kind !== "input")
+        return;
       nameUnnamed(api).catch((error) => api.report({
         severity: "warning",
-        path: ["run_ended"],
+        path: ["run_started"],
         message: `Naming the session failed: ${error instanceof Error ? error.message : String(error)}`,
         source: { plugin: "rename" }
       }));
@@ -33,7 +35,17 @@ async function nameUnnamed(api) {
   const info = await api.session.info();
   if (info.name !== null || info.parent !== null)
     return;
-  await api.session.update({ name: await requestTitle(api, api.signal) });
+  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) {
   const view = await api.session.view();
@@ -63,15 +75,16 @@ async function requestTitle(api, signal) {
 }
 function transcript(messages) {
   return messages.flatMap((message) => {
-    if (message.kind === "user") {
-      const words = typeof message.content === "string" ? message.content : message.content.flatMap((block) => block.kind === "text" ? [block.text] : []).join(" ");
-      return [`User: ${words}`];
-    }
+    if (message.kind === "user")
+      return [`User: ${userWords(message.content)}`];
     return isPart(message, text) ? [`Assistant: ${message.state.markdown}`] : [];
   }).join(`
 
 `).slice(0, 4000);
 }
+function userWords(content) {
+  return typeof content === "string" ? content : content.flatMap((block) => block.kind === "text" ? [block.text] : []).join(" ");
+}
 export {
   TITLE_PROMPT,
   rename_default as default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nyte-ai/plugin",
-  "version": "0.0.18",
+  "version": "0.0.19",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -148,9 +148,9 @@
     "@agentclientprotocol/sdk": "1.9.0",
     "@anthropic-ai/claude-agent-sdk": "0.3.296",
     "@earendil-works/pi-codemode": "1.0.0",
-    "@nyte-ai/ai": "0.0.18",
-    "@nyte-ai/core": "0.0.18",
-    "@nyte-ai/schema": "0.0.18",
+    "@nyte-ai/ai": "0.0.19",
+    "@nyte-ai/core": "0.0.19",
+    "@nyte-ai/schema": "0.0.19",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/exporter-trace-otlp-http": "^0.223.0",
     "@opentelemetry/resources": "^2.12.0",
@@ -187,7 +187,7 @@
   "scripts": {
     "clean": "rm -rf node_modules .turbo",
     "test": "vitest --run",
-    "typecheck": "tsgo --noEmit",
+    "typecheck": "tsrs --noEmit",
     "build:package": "bun ../../scripts/sdk-packages.mjs build plugin"
   }
 }