@stevecastaneda/paseo-progress 0.3.3 → 0.3.5

package/OVERVIEW.md

@@ -1,6 +1,6 @@
 Progress gives each worktree a live dashboard for long agent jobs. The agent records its tickets or steps with a `paseo-progress` command, along with what's stuck, questions for you and finished work. The Progress panel in Explorer shows all of it. Needs Paseo 0.9 or later, and Node.js 22.18 or later on the computer running the Paseo daemon.
 
-The panel shows how much of the estimated work is done, what the agent is doing right now, and where each ticket stands. A ticket turns stuck when it's blocked or runs past its estimate without an update. Press a ticket to see its timeline, activity, questions and deliverables. Images and text files the agent records open in a preview inside Paseo.
+The panel shows how much of the estimated work is done, what the agent is doing right now, and where each ticket stands. A ticket turns stuck when it's blocked or runs past its estimate without an update. Press a ticket to see its timeline, activity, questions and deliverables. Images and text files the agent records open in a preview inside Paseo. Any other file opens in an app on the computer running the Paseo daemon, and so does a previewed file when you press Open. That's true from your phone too. The app opens on that computer, not on the phone.
 
 When the agent needs a decision, it asks a numbered question with lettered options and says which one it recommends. A pill above the message box counts open questions and stuck work. Each option has a Copy button. Paste the answer into the chat and the agent records it.
 

package/README.md

@@ -1,3 +1,5 @@
+<img src="https://raw.githubusercontent.com/stevecastaneda/paseo-plugins/main/progress/icon.png" alt="" width="64" height="64">
+
 # Progress
 
 A plugin for Paseo 0.9 and later that gives each worktree a live progress dashboard. Agents record progress with the `paseo-progress` command, which adds one line per change to the worktree's progress file. That file lives outside the repo, so git never sees it. The **Progress** panel draws the dashboard from that file and updates by itself.
@@ -39,7 +41,7 @@ dir="$(paseo plugin ls progress --json | node -pe 'JSON.parse(require("fs").read
 node "$([ -f "$dir/dist/server/cli.js" ] && echo "$dir/dist/server/cli.js" || echo "$dir/server/cli.ts")" install-launcher [path]
 ```
 
-If `paseo` isn't on your `PATH`, use `/Applications/Paseo.app/Contents/Resources/bin/paseo`. The command doesn't name a plugin folder: each run asks Paseo (`paseo plugin ls`) which copy of the plugin it is running and runs that copy, so it keeps working after updates and `npm run dev` switches. The npm package carries the command compiled to JavaScript in `dist/`, because Node won't run TypeScript from `node_modules`.
+If `paseo` isn't on your `PATH`, use `/Applications/Paseo.app/Contents/Resources/bin/paseo`. The command doesn't name a plugin folder: each run asks Paseo (`paseo plugin ls`) which copy of the plugin it is running and runs that copy, so it keeps working after updates and `npm run dev` switches. The npm package carries the command as one JavaScript file in `dist/`, built with esbuild when publishing, because Node won't run TypeScript from `node_modules`. That file includes zod (MIT), so installing the plugin downloads no other packages.
 
 ## Where progress is kept
 
@@ -129,6 +131,14 @@ npm run dev
 
 ## Changelog
 
+### 0.3.5
+
+- The plugin's page in Paseo's plugin store now says that pressing **Open** in a preview opens the file in an app on the computer running the Paseo daemon, even from your phone.
+
+### 0.3.4
+
+- Installing the plugin no longer downloads any other npm packages. The `paseo-progress` command is now built into a single file that includes zod. The plugin used to install `@getpaseo/client` just for its types; it now gets them from the plugin SDK that Paseo already provides.
+
 ### 0.3.3
 
 - The skill now has subagents record their own progress, so the dashboard stops warning "possibly stale" while they work. Since Paseo 0.11, an agent waiting on background subagents shows as idle. After 15 minutes with no update, the dashboard said the work may have stopped even though the subagents were still at it. Now the agent gives each subagent the worktree path and ticket id, and the subagent records its stages and a ticker line. If the Progress panel shows **Update skill** after you update, press it so agents get the new instructions.

package/client/directory.ts

@@ -1,10 +1,24 @@
-import type { OwnedSubscription, SubscriptionObserver } from "@getpaseo/client";
+import type { getPaseoClient } from "@getpaseo/plugin/client";
+
+// Paseo's client types are read through the plugin SDK, which Paseo provides.
+// Importing them from @getpaseo/client would make Paseo require that package
+// installed alongside the plugin, even though only its types are used.
+type PaseoApi = ReturnType<typeof getPaseoClient>;
+type Handler<Subscribe> = Subscribe extends (handler: infer H) => unknown ? H : never;
+export type PaseoAgentUpdate = Parameters<Handler<PaseoApi["agents"]["subscribe"]>>[0];
+export type PaseoWorkspaceUpdate = Parameters<Handler<PaseoApi["workspaces"]["subscribe"]>>[0];
+type Message = Parameters<
+  Parameters<NonNullable<Awaited<ReturnType<PaseoApi["agents"]["list"]>>["subscription"]>["subscribe"]>[0]["update"]
+>[0];
+type OwnedSubscription<T> = {
+  subscribe(observer: { snapshot(snapshot: T): void; update(message: Message): void; error?(error: unknown): void }): () => void;
+  release(): Promise<void>;
+};
 
 type Page = {
   entries: unknown[];
   pageInfo: { hasMore: boolean; nextCursor?: string | null };
 };
-type Message = Parameters<SubscriptionObserver<unknown>["update"]>[0];
 
 // Paseo 0.9 returns an owned subscription from list({ subscribe: {} }). It
 // delivers the first page as a snapshot, again after every reconnect, then the

package/client/pills.tsx

@@ -1,11 +1,10 @@
-import type { PaseoAgentUpdate, PaseoWorkspaceUpdate } from "@getpaseo/client";
 import type { PluginButtonContentProps, PluginButtonIconProps, PluginButtonRegistration, PluginClientContext } from "@getpaseo/plugin/client";
 import { Icon } from "@getpaseo/plugin/client/react-native";
 import React, { useSyncExternalStore } from "react";
 import { Platform } from "react-native";
 import { type AttentionResult, getAttention } from "../shared/rpc";
 import { isIdle, type Pill, pillFor } from "./pill-state";
-import { observeDirectory } from "./directory";
+import { observeDirectory, type PaseoAgentUpdate, type PaseoWorkspaceUpdate } from "./directory";
 import { onPanelOpened } from "./panel-opened";
 import { IconSwap } from "./motion";
 import { Spinner } from "./spinner";