@nyte-ai/plugin 0.0.25-nightly.20261101.43 → 0.0.27

package/THIRD-PARTY-NOTICES.md

@@ -611,6 +611,71 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## Ghostty (`ghostty-org/ghostty`)
+
+- Repository: https://github.com/ghostty-org/ghostty
+- What: `packages/vt/ghostty-vt.wasm` is the signed libghostty-vt WebAssembly
+  build from Ghostty's `tip` release at the commit recorded in
+  `packages/vt/pin.json`, shipped unmodified. `packages/vt` binds its C API.
+
+License: MIT, with the following notice:
+
+```text
+MIT License
+
+Copyright (c) 2024 Mitchell Hashimoto, Ghostty contributors
+
+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.
+```
+
+## ghostty-web (`coder/ghostty-web`)
+
+- Repository: https://github.com/coder/ghostty-web
+- What: the escape-heavy viewport row-merge fixture in `packages/vt/test` is
+  ported from ghostty-web's `lib/viewport-row-merge.test.ts`.
+
+License: MIT, with the following notice:
+
+```text
+MIT License
+
+Copyright (c) 2025 Coder
+
+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)

package/dist/chunks/{bash-description-myvnmtt2.js → bash-description-03bm07ft.js}

@@ -7,11 +7,10 @@ import {
 } from "./bash-description-5dpf5hpt.js";
 
 // src/web/fetch.ts
-import { attachFile } from "@nyte-ai/core";
+import { attachFile, clipText } from "@nyte-ai/core";
 import { standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
 var MAX_RESPONSE_BYTES = 5 * 1024 * 1024;
-var INLINE_CHARS = 50 * 1024;
 var MAX_REDIRECTS = 10;
 var DEFAULT_TIMEOUT_SECONDS = 30;
 var MAX_TIMEOUT_SECONDS = 120;
@@ -66,12 +65,7 @@ function webFetch2(fetch) {
           }
           const body = new TextDecoder().decode(await readCapped2(response, MAX_RESPONSE_BYTES));
           const text = mime !== "text/html" || format === "html" ? body : format === "markdown" ? htmlToMarkdown2(body) : htmlToText2(body);
-          return {
-            kind: "text",
-            text: text.length > INLINE_CHARS ? `${text.slice(0, INLINE_CHARS)}
-
-… Cut at ${INLINE_CHARS} of ${text.length} characters.` : text
-          };
+          return { kind: "text", text: clipText(text, "head") };
         } catch (error) {
           if (deadline.aborted && !invocation.signal.aborted)
             throw new Error(`${url.href} didn't answer within ${seconds} s.`, { cause: error });

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

@@ -15,7 +15,7 @@ import { processEnvironment } from "@nyte-ai/core";
 // package.json
 var package_default = {
   name: "@nyte-ai/plugin",
-  version: "0.0.25-nightly.20261101.43",
+  version: "0.0.27",
   private: false,
   license: "MIT",
   repository: {
@@ -34,12 +34,15 @@ var package_default = {
     "./core/approvals": "./src/approvals/approvals.ts",
     "./core/acp": "./src/acp/index.ts",
     "./core/bash-description": "./src/bash-description.ts",
+    "./core/browser-client": "./src/browser-client.ts",
     "./core/browser-tools": "./src/browser-tools.ts",
     "./core/canvas": "./src/canvas/canvas.ts",
+    "./core/canvas-client": "./src/canvas/canvas-client.ts",
     "./core/canvas-compile": "./src/canvas/canvas-compile.ts",
     "./core/canvas-preview": "./src/canvas/canvas-preview.ts",
     "./core/claude-code-sdk": "./src/claude-code-sdk/index.ts",
     "./core/codemode": "./src/codemode.ts",
+    "./core/desktop-settings": "./src/desktop-settings/desktop-settings.ts",
     "./core/codemode-runtime": "./src/codemode-runtime.ts",
     "./core/codemode-worker": "./src/codemode-worker.ts",
     "./core/openai-astra-context": "./src/openai-astra-context.ts",
@@ -61,6 +64,7 @@ var package_default = {
     "./approvals/schema": "./src/approvals/schema.ts",
     "./canvas/protocol": "./src/canvas/canvas-protocol.ts",
     "./canvas/schema": "./src/canvas/schema.ts",
+    "./desktop-settings/schema": "./src/desktop-settings/schema.ts",
     "./question/schema": "./src/question/schema.ts"
   },
   publishConfig: {
@@ -81,6 +85,10 @@ var package_default = {
         types: "./dist/src/bash-description.d.ts",
         import: "./dist/src/bash-description.js"
       },
+      "./core/browser-client": {
+        types: "./dist/src/browser-client.d.ts",
+        import: "./dist/src/browser-client.js"
+      },
       "./core/browser-tools": {
         types: "./dist/src/browser-tools.d.ts",
         import: "./dist/src/browser-tools.js"
@@ -89,6 +97,10 @@ var package_default = {
         types: "./dist/src/canvas/canvas.d.ts",
         import: "./dist/src/canvas/canvas.js"
       },
+      "./core/canvas-client": {
+        types: "./dist/src/canvas/canvas-client.d.ts",
+        import: "./dist/src/canvas/canvas-client.js"
+      },
       "./core/canvas-compile": {
         types: "./dist/src/canvas/canvas-compile.d.ts",
         import: "./dist/src/canvas/canvas-compile.js"
@@ -113,6 +125,10 @@ var package_default = {
         types: "./dist/src/codemode-worker.d.ts",
         import: "./dist/src/codemode-worker.js"
       },
+      "./core/desktop-settings": {
+        types: "./dist/src/desktop-settings/desktop-settings.d.ts",
+        import: "./dist/src/desktop-settings/desktop-settings.js"
+      },
       "./core/openai-astra-context": {
         types: "./dist/src/openai-astra-context.d.ts",
         import: "./dist/src/openai-astra-context.js"
@@ -189,6 +205,10 @@ var package_default = {
         types: "./dist/src/canvas/schema.d.ts",
         import: "./dist/src/canvas/schema.js"
       },
+      "./desktop-settings/schema": {
+        types: "./dist/src/desktop-settings/schema.d.ts",
+        import: "./dist/src/desktop-settings/schema.js"
+      },
       "./question/schema": {
         types: "./dist/src/question/schema.d.ts",
         import: "./dist/src/question/schema.js"
@@ -204,9 +224,9 @@ var package_default = {
     "build:package": "bun ../../scripts/sdk-packages.mjs build plugin"
   },
   dependencies: {
-    "@agentclientprotocol/sdk": "^2.0.0",
-    "@anthropic-ai/claude-agent-sdk": "^0.3.306",
-    "@earendil-works/pi-codemode": "^1.3.0",
+    "@agentclientprotocol/sdk": "^2.4.0",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.317",
+    "@earendil-works/pi-codemode": "^1.5.0",
     "@nyte-ai/ai": "workspace:*",
     "@nyte-ai/core": "workspace:*",
     "@nyte-ai/schema": "workspace:*",
@@ -214,22 +234,22 @@ var package_default = {
     "@opentelemetry/exporter-trace-otlp-http": "^0.300.0",
     "@opentelemetry/resources": "^3.0.0",
     "@opentelemetry/sdk-trace": "^3.0.0",
-    "@opentelemetry/semantic-conventions": "^1.43.0",
+    "@opentelemetry/semantic-conventions": "^1.44.0",
     "es-module-lexer": "^3.0.4",
-    htmlparser2: "^8.0.2",
+    htmlparser2: "^12.0.0",
     sucrase: "^3.35.1",
-    typebox: "^1.4.2",
+    typebox: "^1.4.3",
     zod: "^4.6.7"
   },
   devDependencies: {
-    "@opentui/core": "^0.6.6",
-    "@types/node": "^26.6.5",
+    "@opentui/core": "^0.8.2",
+    "@types/node": "^26.6.6",
     "@types/react": "^19.3.0",
     react: "^19.3.1",
-    vitest: "^5.0.5"
+    vitest: "^5.1.0"
   },
   peerDependencies: {
-    "@opentui/core": "^0.6.6",
+    "@opentui/core": "^0.8.2",
     react: "^19.3.1"
   },
   peerDependenciesMeta: {

package/dist/chunks/bash-description-0vfhp1qd.js

@@ -0,0 +1,54 @@
+// src/desktop-settings/schema.ts
+import { ORIGIN_PATTERN } from "@nyte-ai/schema/origin";
+import { Type } from "typebox";
+var ALERT_CHANNELS2 = ["notification", "badge", "sound", "bounce", "remind"];
+var ALERT_OFFERS2 = {
+  waiting: ALERT_CHANNELS2,
+  failed: ["notification", "badge", "sound", "bounce"],
+  done: ["notification", "badge", "sound"]
+};
+var ALERT_SETTING2 = {
+  waiting: "alertsWaiting",
+  failed: "alertsFailed",
+  done: "alertsDone"
+};
+var DESKTOP_SETTING_SCHEMAS2 = {
+  keepAwake: Type.Boolean(),
+  pauseOnSleep: Type.Boolean(),
+  terminalShell: Type.Union([Type.String({ minLength: 1 }), Type.Null()]),
+  blockAds: Type.Boolean(),
+  adblockAllowedHosts: Type.Array(Type.String({ minLength: 1, maxLength: 253 })),
+  upgradeToHttps: Type.Boolean(),
+  webOrigins: Type.Array(Type.String({ pattern: ORIGIN_PATTERN })),
+  notifications: Type.Boolean(),
+  dockBadge: Type.Boolean(),
+  notificationSounds: Type.Boolean(),
+  alertsWaiting: Type.Array(Type.Enum(ALERT_OFFERS2.waiting)),
+  alertsFailed: Type.Array(Type.Enum(ALERT_OFFERS2.failed)),
+  alertsDone: Type.Array(Type.Enum(ALERT_OFFERS2.done)),
+  remindMinutes: Type.Union([Type.Literal(1), Type.Literal(2), Type.Literal(5), Type.Literal(15)]),
+  notifyViewedChat: Type.Boolean(),
+  notifySubagents: Type.Boolean(),
+  terminalNotifications: Type.Boolean()
+};
+var DEFAULT_DESKTOP_SETTINGS2 = {
+  keepAwake: false,
+  pauseOnSleep: true,
+  terminalShell: null,
+  blockAds: true,
+  adblockAllowedHosts: [],
+  upgradeToHttps: true,
+  webOrigins: [],
+  notifications: true,
+  dockBadge: true,
+  notificationSounds: true,
+  alertsWaiting: ["notification", "badge", "sound", "bounce", "remind"],
+  alertsFailed: ["notification", "badge", "sound"],
+  alertsDone: ["notification", "badge"],
+  remindMinutes: 2,
+  notifyViewedChat: false,
+  notifySubagents: false,
+  terminalNotifications: true
+};
+
+export { ALERT_CHANNELS2, ALERT_OFFERS2, ALERT_SETTING2, DESKTOP_SETTING_SCHEMAS2, DEFAULT_DESKTOP_SETTINGS2 };

package/dist/chunks/{bash-description-g7gfy7nw.js → bash-description-4kqkzdkp.js}

@@ -3,7 +3,7 @@ import {
 } from "./bash-description-q2v8wbn8.js";
 
 // src/acp/transcript.ts
-var RESULT_LIMIT = 2000;
+import { excerptText } from "@nyte-ai/core";
 function text(content) {
   return typeof content === "string" ? content : content.map((block) => block.type === "text" ? block.text : `[${block.mimeType}]`).join("");
 }
@@ -27,10 +27,8 @@ function transcriptText2(messages) {
       return [`User:
 ${text(message.content)}`];
     if (message.role === "toolResult")
-      return [
-        `Tool result (${message.toolName}):
-${text(message.content).slice(0, RESULT_LIMIT)}`
-      ];
+      return [`Tool result (${message.toolName}):
+${excerptText(text(message.content))}`];
     if (message.role !== "assistant" || message.stopReason === "error")
       return [];
     const said = message.content.flatMap((block) => {

package/dist/chunks/{bash-description-axnga0jz.js → bash-description-a99pev5h.js}

@@ -1,7 +1,7 @@
 // src/approvals/schema.ts
-import { standard, ToolClassType } from "@nyte-ai/schema";
+import { ApprovalPolicyType, standard, ToolClassType } from "@nyte-ai/schema";
 import { Type } from "typebox";
-var policy = standard(Type.Union([Type.Literal("ask"), Type.Literal("auto-edit"), Type.Literal("full")]));
+var policy = standard(ApprovalPolicyType);
 var PERMISSIONS2 = "permissions";
 var approvalPolicy2 = policy;
 var APPROVAL_POLICIES2 = [

package/dist/chunks/{bash-description-bkhr9zrz.js → bash-description-s6v2m3ch.js}

@@ -1,6 +1,7 @@
 // src/question/schema.ts
-import { standard } from "@nyte-ai/schema";
+import { idSchema, isJsonObject, standard } from "@nyte-ai/schema";
 import { Type } from "typebox";
+var QUESTION_TOOL2 = "question";
 var infoSchema = Type.Object({
   question: Type.String({ minLength: 1, pattern: "\\S", description: "The question to ask." }),
   header: Type.String({
@@ -21,10 +22,20 @@ var answers = Type.Array(Type.Array(Type.String({ minLength: 1 })), {
   minItems: 1
 });
 var answerInput2 = standard(Type.Object({ answers }));
-var questionOutput2 = standard(Type.Object({ answers: Type.Union([answers, Type.Null()]) }));
-var state = standard(Type.Object({ questions, answers: Type.Union([answers, Type.Null()]) }));
+var skipInput = standard(Type.Object({}));
+var phase = Type.Union([
+  Type.Object({ kind: Type.Literal("asking") }),
+  Type.Object({ kind: Type.Literal("open"), head: idSchema() }),
+  Type.Object({
+    kind: Type.Literal("answered"),
+    answers,
+    head: Type.Union([idSchema(), Type.Null()])
+  }),
+  Type.Object({ kind: Type.Literal("skipped"), late: Type.Boolean() })
+]);
+var state = standard(Type.Object({ call: idSchema(), questions, phase }));
 var questionParameters2 = standard(Type.Object({ questions }));
-var actions = { answer: { input: answerInput2 } };
+var actions = { answer: { input: answerInput2 }, skip: { input: skipInput } };
 var question2 = {
   kind: "ask/question",
   state,
@@ -32,8 +43,8 @@ var question2 = {
   fallback: (current, { id }) => `Questions ${id}:
 ${current.questions.map((item, index) => `${item.header}: ${item.question}
 ${item.options.map((option) => `${option.label}: ${option.description}`).join(`
-`)}${current.answers === null ? "" : `
-Answered: ${current.answers[index].join(", ") || "Unanswered"}`}`).join(`
+`)}${current.phase.kind === "answered" ? `
+Answered: ${current.phase.answers[index].join(", ") || "Unanswered"}` : ""}`).join(`
 
 `)}`
 };
@@ -41,11 +52,18 @@ function openQuestions2(view) {
   return (view?.parts ?? []).flatMap((part) => {
     if (part.partKind !== question2.kind || part.status.kind !== "live")
       return [];
-    const checked = question2.state["~standard"].validate(part.state);
-    if (checked instanceof Promise || checked.issues !== undefined || checked.value.answers !== null)
+    const read = readQuestion2(part);
+    if (read === null || read.phase.kind !== "asking" && read.phase.kind !== "open")
       return [];
-    return [{ part: part.id, questions: checked.value.questions }];
+    return [{ part: part.id, questions: read.questions, late: read.phase.kind === "open" }];
   });
 }
+function findQuestionPart2(parts, call) {
+  return parts.find((part) => part.partKind === question2.kind && isJsonObject(part.state) && part.state.call === call);
+}
+function readQuestion2(part) {
+  const checked = question2.state["~standard"].validate(part.state);
+  return checked instanceof Promise || checked.issues !== undefined ? null : checked.value;
+}
 
-export { answerInput2, questionOutput2, questionParameters2, question2, openQuestions2 };
+export { QUESTION_TOOL2, answerInput2, questionParameters2, question2, openQuestions2, findQuestionPart2, readQuestion2 };

package/dist/chunks/{bash-description-qwyy182r.js → bash-description-spc5av5d.js}

@@ -19,12 +19,6 @@ function readRawPart2(message) {
   }
   return { format: "json", body: state === undefined ? "null" : JSON.stringify(state, null, 2) };
 }
-function showsReport2(message) {
-  return message.source.kind === "child" || message.source.kind === "job";
-}
-function shownContent2(message) {
-  return message.source.kind === "action" ? message.source.label : message.content;
-}
 var RUNNING = { tense: "running", tone: "running", word: undefined };
 function toolStatus2(message) {
   const { state, status } = message;
@@ -449,4 +443,4 @@ function failureNotice2(failure) {
   }
 }
 
-export { showsTool2, showsText2, showsThinking2, readRawPart2, showsReport2, shownContent2, toolStatus2, toolOutput2, taskLabel2, callTaskState2, taskEnded2, agentGroupSummary2, runStatus2, endedStatus2, runMark2, rowMark2, backgroundLabel2, planningLabel2, PLANNING_LABEL2, PLANNING_DELAY_MS2, SLOW_PLANNING_MS2, executionMark2, mainHead2, sessionMark2, sessionTitle2, SUBAGENT_TITLE2, findCommandArgument2, completionTrigger2, customTool2, toolVerbs2, toolNoun2, delegateSubject2, toolSubject2, toolTitle2, tidyPath2, placeName2, condensedCommand2, formatDuration2, formatWholeDuration2, toolDetail2, failureNotice2, jobTaskState2 };
+export { showsTool2, showsText2, showsThinking2, readRawPart2, toolStatus2, toolOutput2, taskLabel2, callTaskState2, taskEnded2, agentGroupSummary2, runStatus2, endedStatus2, runMark2, rowMark2, backgroundLabel2, planningLabel2, PLANNING_LABEL2, PLANNING_DELAY_MS2, SLOW_PLANNING_MS2, executionMark2, mainHead2, sessionMark2, sessionTitle2, SUBAGENT_TITLE2, findCommandArgument2, completionTrigger2, customTool2, toolVerbs2, toolNoun2, delegateSubject2, toolSubject2, toolTitle2, tidyPath2, placeName2, condensedCommand2, formatDuration2, formatWholeDuration2, toolDetail2, failureNotice2, jobTaskState2 };

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

@@ -0,0 +1,12 @@
+// src/client/user-messages.ts
+function showsReport2(message) {
+  return message.source.kind === "child" || message.source.kind === "job";
+}
+function showsAnswer2(message) {
+  return message.source.kind === "answer";
+}
+function shownContent2(message) {
+  return message.source.kind === "action" || message.source.kind === "answer" ? message.source.label : message.content;
+}
+
+export { showsReport2, showsAnswer2, shownContent2 };

package/dist/src/acp/connection.js

@@ -1,6 +1,6 @@
 import {
   AcpProcess2
-} from "../../chunks/bash-description-6mm9fym2.js";
+} from "../../chunks/bash-description-0gnxcq7q.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-6mm9fym2.js";
+} from "../../chunks/bash-description-0gnxcq7q.js";
 import"../../chunks/bash-description-4vz9pxyx.js";
 import {
   registryEntries2,
@@ -19,7 +19,7 @@ import {
   messageKey2,
   userBlocks2,
   transcriptText2
-} from "../../chunks/bash-description-g7gfy7nw.js";
+} from "../../chunks/bash-description-4kqkzdkp.js";
 
 // src/acp/index.ts
 import {

package/dist/src/acp/transcript.js

@@ -2,7 +2,7 @@ import {
   messageKey2,
   userBlocks2,
   transcriptText2
-} from "../../chunks/bash-description-g7gfy7nw.js";
+} from "../../chunks/bash-description-4kqkzdkp.js";
 import"../../chunks/bash-description-q2v8wbn8.js";
 export {
   messageKey2 as messageKey,

package/dist/src/approvals/approvals.js

@@ -4,14 +4,15 @@ import {
   APPROVAL_POLICIES2,
   approval2,
   openApprovals2
-} from "../../chunks/bash-description-axnga0jz.js";
+} from "../../chunks/bash-description-a99pev5h.js";
 
 // src/approvals/approvals.ts
 import { posix } from "node:path";
 import { definePart } from "@nyte-ai/core";
-import { SdkError } from "@nyte-ai/schema";
+import { ApprovalPolicyType, SdkError } from "@nyte-ai/schema";
 var DENIED = "The user denied this tool call. Ask them how to proceed instead of retrying it.";
 var UNANSWERED = "The approval request closed before the user answered.";
+var POLICIES = ApprovalPolicyType.anyOf.map((literal) => literal.const);
 var permissions = {
   id: PERMISSIONS2,
   label: "Permissions",
@@ -49,8 +50,10 @@ function approvalReason(policy, tool, cwd) {
 }
 async function readPolicy(api) {
   const value = await api.contribute.settings.value(PERMISSIONS2);
+  const ceiling = (await api.session.info()).mcp?.ceiling;
   const checked = approvalPolicy2["~standard"].validate(value);
-  return checked instanceof Promise || checked.issues !== undefined ? permissions.default : checked.value;
+  const host = checked instanceof Promise || checked.issues !== undefined ? permissions.default : checked.value;
+  return ceiling !== undefined && POLICIES.indexOf(ceiling) < POLICIES.indexOf(host) ? ceiling : host;
 }
 async function pendingReason(api, tool) {
   const reason = approvalReason(await readPolicy(api), tool, api.env.cwd);

package/dist/src/approvals/schema.js

@@ -6,7 +6,7 @@ import {
   approvalPrompt2,
   approval2,
   openApprovals2
-} from "../../chunks/bash-description-axnga0jz.js";
+} from "../../chunks/bash-description-a99pev5h.js";
 export {
   APPROVAL_ACTIONS2 as APPROVAL_ACTIONS,
   APPROVAL_POLICIES2 as APPROVAL_POLICIES,

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

@@ -0,0 +1,135 @@
+import type { Json, SessionId } from "@nyte-ai/schema";
+import { Type } from "typebox";
+import type { Static } from "typebox";
+import type { Plugin } from "@nyte-ai/plugin/core";
+/**
+ * How a host asks its connected clients to act: whether one offers an
+ * action now, and asking the one that does, which answers `not_supported`
+ * when none does.
+ *
+ * @category plugins
+ * @since 0.1.0
+ */
+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.";
+    readonly input: {
+        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">>;
+    owner: Type.TUnion<[Type.TObject<{
+        kind: Type.TLiteral<"home">;
+    }>, Type.TObject<{
+        kind: Type.TLiteral<"project">;
+        path: Type.TString;
+    }>]>;
+    url: Type.TString;
+}>, Type.TObject<{
+    method: Type.TLiteral<"snapshot">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    ref: Type.TOptional<Type.TString>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"click">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    ref: Type.TString;
+    expect: Type.TString;
+    button: Type.TOptional<Type.TEnum<["left", "right", "middle"]>>;
+    double: Type.TOptional<Type.TBoolean>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"type">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    ref: Type.TString;
+    text: Type.TString;
+    expect: Type.TString;
+    clear: Type.TOptional<Type.TBoolean>;
+    submit: Type.TOptional<Type.TBoolean>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"press">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    key: Type.TString;
+    ref: Type.TOptional<Type.TString>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"scroll">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    direction: Type.TEnum<["up", "down", "top", "bottom"]>;
+    ref: Type.TOptional<Type.TString>;
+    pages: Type.TOptional<Type.TNumber>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"wait">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    wait: Type.TUnion<[Type.TObject<{
+        until: Type.TLiteral<"load">;
+    }>, Type.TObject<{
+        until: Type.TLiteral<"text">;
+        text: Type.TString;
+    }>, Type.TObject<{
+        until: Type.TLiteral<"gone">;
+        text: Type.TString;
+    }>, Type.TObject<{
+        until: Type.TLiteral<"time">;
+        seconds: Type.TNumber;
+    }>]>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"console">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    limit: Type.TInteger;
+    clear: Type.TOptional<Type.TBoolean>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"evaluate">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+    expression: Type.TString;
+    ref: Type.TOptional<Type.TString>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"capture">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+}>, Type.TObject<{
+    method: Type.TLiteral<"release">;
+    session: Type.TUnsafe<import("@nyte-ai/schema").Id<"session">>;
+}>]>;
+export type BrowserCall = Static<typeof BrowserCallType>;
+/**
+ * Returns page text fit for one line of a tool result: no control
+ * characters and no characters that reorder or break lines.
+ *
+ * @category plugins
+ * @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
+ * `BROWSER_ACTION`: each session's page is the one its agent holds in that
+ * app. With no app connected that offers it, every tool answers that only
+ * Nyte.app has the browser.
+ *
+ * @category plugins
+ * @since 0.1.0
+ */
+export declare function clientBrowserPlugins(actions: ClientActions, home: string): readonly Plugin[];