@joe-broadhead/opencode-plaud 0.0.5 → 0.0.6

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.6] - 2026-11-05
+
+### Changed
+
+- `opencode-plaud-export` spells out the `list_files` call that finds a recording by date or name, with `start_at` in UTC, so it needs no catalogue search when the main skill isn't loaded. It says that the export itself refuses an existing file with `EXPORT_EXISTS`, so there is no need to list the folder first. When several recordings match, it exports only after the user answers, and never a guess or every match.
+- Scripts use a session created for them. `opencode-plaud` and `docs/scripting.md` say to create the script's session with `opencode api post /api/session` and keep `data.id`, and never to borrow a session found in history or a session list, which would run as that session's agent, under its rules.
+
 ## [0.0.5] - 2026-11-05
 
 ### Added

package/dist/index.js

@@ -6776,7 +6776,7 @@ ${status.permissionsBlock.map((rule2) => `  ${JSON.stringify(rule2)}`).join(",\n
 
 // src/version.ts
 var PLUGIN_ID = "plaud.recordings";
-var PLUGIN_VERSION = "0.0.5";
+var PLUGIN_VERSION = "0.0.6";
 var SUPPORTED_HOSTS = ">=2.2.3 <2.3.0";
 var TESTED_HOSTS = ["2.2.3", "2.2.4", "2.2.5"];
 var RELEASE = /^(\d+)\.(\d+)\.(\d+)$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joe-broadhead/opencode-plaud",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "Unofficial OpenCode plugin for Plaud recordings",
   "type": "module",
   "license": "MIT",

package/skills/opencode-plaud/SKILL.md

@@ -88,8 +88,10 @@ return page.data.map((r) => ({ id: r.id, name: r.name, start: r.start_at + "Z",
 For a job without a model, such as a cron job: `opencode api post /api/rpc/plaud.recordings.tools/<method>`, where the
 methods are the five reads, `recent` and `describe`. The body is
 `{"input":{"sessionID":"<session>","account":"work","input":<the tool's input>}}`, with `account` optional. The
-script runs as the session's agent, under its rules, and an ask is refused. Scripts get no export, no other Plaud
-tool and no link.
+script runs as the session's agent, under its rules, and an ask is refused. So a script, or a test of one, uses a
+session created for it: `opencode api post /api/session -d '{"title":"<job>","agent":"build"}'`, keeping `data.id`.
+Never borrow a session found through history or a list, which would run as its agent. Scripts get no export, no
+other Plaud tool and no link.
 
 ## Sign-in and errors
 

package/skills/opencode-plaud-export/SKILL.md

@@ -23,10 +23,13 @@ It returns `{ path, bytes, sha256 }`, never the content.
 
 ## Decide
 
-1. **Find the id** with `plaud_recent` (the newest: `tools.plaud.recent({ limit: 1 })` in Code Mode, a plain object)
-   or `list_files` (a date or a name; see `opencode-plaud`). These Code Mode calls are exact, so no catalogue search
-   is needed. If several recordings match,
-   such as two on one day, list them with their title, start time and length, and ask which one before exporting.
+1. **Find the id** with `plaud_recent` for the newest (`tools.plaud.recent({ limit: 1 })` in Code Mode, a plain
+   object), or `list_files` for a date or a name:
+   `tools.plaud.list_files({ date_from: "YYYY-MM-DD", date_to: "YYYY-MM-DD", page_size: 50 })`, both dates inclusive;
+   for a name, add `query: "name"` or drop the dates. Its `start_at` is UTC without a `Z`. These Code Mode calls are exact, so
+   no catalogue search is needed. If several recordings match, such as two on one day, list them with their title,
+   start time and length, and ask which one. Export only after the user answers: if you can't ask, end your answer
+   with the question, and never export a guess or every match instead.
 2. **Pick the kind.** Asked to save or download the audio: `kind: "audio"`, at once. The export reads `get_file`
    itself, so don't call `get_file` first. Asked only for a link: say Plaud's links are withheld and offer to save
    the audio, and export when they agree. Summary or action items: `kind: "note"`. A transcript: omit `block` for the raw one,
@@ -38,7 +41,8 @@ It returns `{ path, bytes, sha256 }`, never the content.
    ~~~json
    { "plugins": [{ "package": "@joe-broadhead/opencode-plaud", "options": { "exportRoots": ["~/Plaud", "~/Documents"] } }] }
    ~~~
-4. **Pass `overwrite: true`** only when the user asked to replace that file.
+4. **Pass `overwrite: true`** only when the user asked to replace that file. The export itself refuses an existing
+   file with `EXPORT_EXISTS`, so don't list the folder first.
 
 ## The ask