@camerontaylor/paseo-plugin 0.8.0-fork.3 → 0.9.1-fork.1

package/dist/client/contracts.d.ts

@@ -19,11 +19,19 @@ export interface PluginHostProps {
 interface PluginNavigableHostProps extends PluginHostProps {
     /** Client-owned navigation. Undefined on older hosts; hide dependent affordances when absent. */
     readonly navigation?: {
+        /** Present only on Electron. The browser runs locally; serverId selects workspace ownership. */
+        readonly openBrowser?: (input: {
+            readonly url: string;
+            readonly workspaceId: string;
+            readonly serverId?: string;
+        }) => void;
         readonly openAgent: (input: {
             readonly agentId: string;
+            readonly serverId?: string;
         }) => void;
         readonly openWorkspace: (input: {
             readonly workspaceId: string;
+            readonly serverId?: string;
         }) => void;
     };
 }

package/dist/client/index.d.ts

@@ -7,4 +7,16 @@ import type { SettingsDefinition } from "../settings.js";
 import type { SettingsState } from "./contracts.js";
 import type { ZodType } from "zod";
 export declare function useSettings<Schema extends ZodType>(definition: SettingsDefinition<Schema>): SettingsState<Schema>;
+/** Configured app host, including hosts that are currently disconnected. */
+export interface PluginHostSummary {
+    readonly serverId: string;
+    readonly label: string;
+    readonly status: "idle" | "connecting" | "online" | "offline" | "error";
+}
+/** Live configured hosts. Supplied by the app's client bundle loader. */
+export declare function useHosts(): readonly PluginHostSummary[];
+/** Borrow an online host's API under this installation's lifetime. */
+export declare function getPaseoClient(serverId: string): import("@camerontaylor/paseo-client").PaseoApi;
+/** Open an absolute HTTP(S) URL using the client platform’s external opener. */
+export declare function openExternalUrl(url: string): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/dist/client/ui.d.ts

@@ -57,4 +57,12 @@ export declare const SettingsSwitch: ComponentType<SettingsSwitchProps>;
 export declare function SettingsSelect<Value extends string>(props: SettingsSelectProps<Value>): ReactNode;
 export declare const SettingsInput: ComponentType<SettingsInputProps>;
 export declare const SettingsAction: ComponentType<SettingsActionProps>;
+export interface ExternalLinkProps {
+    href: string;
+    children: ReactNode;
+    accessibilityLabel?: string;
+    testID?: string;
+    onError?: (error: unknown) => void;
+}
+export declare const ExternalLink: ComponentType<ExternalLinkProps>;
 //# sourceMappingURL=ui.d.ts.map

package/dist/server/acp-internal/connection.js

@@ -303,6 +303,13 @@ class AcpRuntime {
         this.modes = null;
         this.commandWaiter = null;
         this.messageSequence = 0;
+        /**
+         * Fallback ids for streamed chunks that carry no `messageId`, one per
+         * chunk kind. Consecutive chunks of a kind continue the same timeline
+         * item; a chunk of the other kind, a tool call, a plan, a user message,
+         * or a turn boundary ends it (#4699).
+         */
+        this.fallbackChunkIds = new Map();
         this.closing = false;
         this.processFailed = false;
         this.configTransaction = false;
@@ -418,6 +425,7 @@ class AcpRuntime {
         }
         const prompt = toAcpPrompt(input.prompt);
         const turnId = `acp:${input.prompt.clientMessageId}`;
+        this.fallbackChunkIds.clear();
         this.emit({
             type: "timeline.item",
             sessionId: this.options.boundarySessionId,
@@ -445,6 +453,7 @@ class AcpRuntime {
         });
         const settled = this.call(this.connection.prompt({ sessionId: this.nativeSessionId, prompt })).then((response) => {
             const state = response.stopReason === "cancelled" ? "canceled" : "completed";
+            this.fallbackChunkIds.clear();
             this.terminalizeTransientItems(state);
             this.emit({
                 type: "session.turn",
@@ -454,6 +463,7 @@ class AcpRuntime {
             });
             return undefined;
         }, (error) => {
+            this.fallbackChunkIds.clear();
             this.terminalizeTransientItems("failed");
             this.emit({
                 type: "session.turn",
@@ -708,12 +718,18 @@ class AcpRuntime {
         if (update.sessionUpdate === "agent_message_chunk" ||
             update.sessionUpdate === "agent_thought_chunk" ||
             update.sessionUpdate === "user_message_chunk") {
-            if (update.sessionUpdate === "user_message_chunk")
+            if (update.sessionUpdate === "user_message_chunk") {
+                this.fallbackChunkIds.clear();
                 return;
+            }
+            // A chunk of one kind ends the other kind's item, whatever its content
+            // or id: reasoning, then text, then reasoning again are three items.
+            this.fallbackChunkIds.delete(update.sessionUpdate === "agent_message_chunk"
+                ? "agent_thought_chunk"
+                : "agent_message_chunk");
             if (update.content.type !== "text")
                 return;
-            const fallbackId = `${update.sessionUpdate}:${++this.messageSequence}`;
-            const id = update.messageId ?? fallbackId;
+            const id = this.resolveChunkId(update.sessionUpdate, update.messageId);
             const text = `${this.messages.get(id) ?? ""}${update.content.text}`;
             this.messages.set(id, text);
             this.emit({
@@ -731,11 +747,27 @@ class AcpRuntime {
             return;
         }
         if (update.sessionUpdate === "tool_call" || update.sessionUpdate === "tool_call_update") {
+            if (update.sessionUpdate === "tool_call")
+                this.fallbackChunkIds.clear();
             this.reduceToolCall(update);
             return;
         }
+        if (update.sessionUpdate === "plan")
+            this.fallbackChunkIds.clear();
         this.reduceStateUpdate(update);
     }
+    resolveChunkId(kind, messageId) {
+        if (messageId) {
+            this.fallbackChunkIds.delete(kind);
+            return messageId;
+        }
+        let id = this.fallbackChunkIds.get(kind);
+        if (!id) {
+            id = `${kind}:${++this.messageSequence}`;
+            this.fallbackChunkIds.set(kind, id);
+        }
+        return id;
+    }
     reduceStateUpdate(update) {
         if (update.sessionUpdate === "plan") {
             this.emit({

package/dist/server/contracts.d.ts

@@ -7,8 +7,21 @@ import type { PluginLifecycleRegistration } from "./lifecycle.js";
 export interface PluginHandlerContext {
     paseo: PaseoApi;
 }
+export type PluginSettingsState<Schema extends ZodType> = {
+    status: "ready";
+    revision: string;
+    values: ZodOutput<Schema>;
+} | {
+    status: "invalid";
+    revision: string;
+    error: string;
+};
+export interface PluginSettings<Schema extends ZodType> {
+    read(): Promise<PluginSettingsState<Schema>>;
+    subscribe(listener: (state: PluginSettingsState<Schema>) => void | Promise<void>): PluginCleanup;
+}
 export interface PluginServerContext extends PluginLifecycleRegistration {
-    registerSettings<Schema extends ZodType>(definition: import("../settings.js").SettingsDefinition<Schema>): void;
+    registerSettings<Schema extends ZodType>(definition: import("../settings.js").SettingsDefinition<Schema>): PluginSettings<Schema>;
     handle<InputSchema extends ZodType, OutputSchema extends ZodType>(contract: PluginRpcContract<InputSchema, OutputSchema>, handler: (input: ZodOutput<InputSchema>, context: PluginHandlerContext) => ZodInput<OutputSchema> | Promise<ZodInput<OutputSchema>>): void;
     registerProvider(provider: ProviderRegistration): void;
 }

package/dist/server/index.d.ts

@@ -1,3 +1,3 @@
-export type { PluginHandlerContext, PluginServerContext, PluginServerContribution, } from "./contracts.js";
+export type { PluginHandlerContext, PluginServerContext, PluginServerContribution, PluginSettings, PluginSettingsState, } from "./contracts.js";
 export type { PluginHookContext, PluginHookWorkspace, PluginHookAgent, PluginSessionOpenRequest, PluginTurnOutcome, PluginLifecycleEvents, PluginBeforeRequests, PluginLifecycleRegistration, } from "./lifecycle.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/server/provider.d.ts

@@ -524,7 +524,10 @@ export type ProviderEvent = {
     type: "session.opened";
     requestId?: string;
     sessionId: string;
+    /** Direct parent in the provider session ID namespace. */
     parentSessionId?: string;
+    /** ID of the spawning tool call in the direct parent's timeline. */
+    toolCallId?: string;
     capabilities: readonly string[];
     restoration: "core" | "parent";
     persistence?: ProviderPersistence;

package/dist/server/provider.js

@@ -706,6 +706,7 @@ export const ProviderEventSchema = z.discriminatedUnion("type", [
         requestId: idSchema.optional(),
         sessionId: idSchema,
         parentSessionId: idSchema.optional(),
+        toolCallId: idSchema.optional(),
         capabilities: z.array(z.string()),
         restoration: z.enum(["core", "parent"]),
         persistence: persistenceSchema.optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camerontaylor/paseo-plugin",
-  "version": "0.8.0-fork.3",
+  "version": "0.9.1-fork.1",
   "description": "Paseo plugin SDK package",
   "files": [
     "dist",
@@ -65,8 +65,8 @@
     "use-sync-external-store": "^1.6.0"
   },
   "devDependencies": {
-    "@camerontaylor/paseo-client": "0.8.0-fork.3",
-    "@camerontaylor/paseo-protocol": "0.8.0-fork.3",
+    "@camerontaylor/paseo-client": "0.9.1-fork.1",
+    "@camerontaylor/paseo-protocol": "0.9.1-fork.1",
     "@types/node": "^20.9.0",
     "@types/react": "~19.2.0",
     "react": "19.1.0",
@@ -76,8 +76,8 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@camerontaylor/paseo-client": "0.8.0-fork.3",
-    "@camerontaylor/paseo-protocol": "0.8.0-fork.3",
+    "@camerontaylor/paseo-client": "0.9.1-fork.1",
+    "@camerontaylor/paseo-protocol": "0.9.1-fork.1",
     "react": "~19.1.0",
     "react-native": ">=0.81.5",
     "zod": "^4.4.3"