@pimote/sdk 0.15.0-rc.5 → 0.15.0

package/README.md

@@ -102,7 +102,7 @@ interface BodySection {
 - **`body`** — Optional content sections, each with a style (`text`, `code`, or `secondary`).
 - **`footer`** — Optional array of short strings displayed at the bottom.
 - **`href`** — Optional same-origin URL. When set, the client renders the
-  entire card as a clickable link (same-tab navigation). Use for cards
+  entire card as a clickable link that opens in a new tab. Use for cards
   that point at a hosted resource — e.g. a bundle served by pimote's
   static-host tool.
 
@@ -162,7 +162,7 @@ The discovery seam. `list()` is called on cache miss and must return the current
 
 ### `FolderCreator`
 
-The creation seam. `describe()` returns the human-readable form for the creation UI — a `label` plus a `paramSchema` mapping param names to `'string' | 'string[]'`. `create(params)` receives the user-supplied params, makes the folder, and returns its `{ path }`.
+The creation seam. `describe()` returns the human-readable form for the creation UI — a `label` plus a `paramSchema` mapping param names to `'string' | 'string[]'`. `create(params)` receives the user-supplied params, makes the folder, and returns its `{ path }`. Pimote resolves that path to the folder's canonical filesystem identity before seeding, broadcasting, or opening a session, so a creator can return the lexical path it used to reach the folder. The path must name the successfully created folder.
 
 ### Entry shapes
 

package/dist/activity/ask.d.ts

@@ -7,7 +7,7 @@ import type { EventBus } from '@earendil-works/pi-coding-agent';
  * for sessions already past the idle-reap threshold — the poll is invisible
  * until it matters.
  *
- * Fails open: no responder, or any responder answering `active: false`, means
+ * Fails open: no responder, or no responder answering `active: true`, means
  * no background work and the caller may reap. When several extensions answer,
  * responses are OR-ed — any assertion of live work holds the session.
  */

package/dist/activity/ask.js

@@ -6,7 +6,7 @@
  * for sessions already past the idle-reap threshold — the poll is invisible
  * until it matters.
  *
- * Fails open: no responder, or any responder answering `active: false`, means
+ * Fails open: no responder, or no responder answering `active: true`, means
  * no background work and the caller may reap. When several extensions answer,
  * responses are OR-ed — any assertion of live work holds the session.
  */

package/dist/folders/types.d.ts

@@ -71,6 +71,12 @@ export interface FolderCreator {
     readonly id: string;
     /** Human-readable description for the creation UI. */
     describe(): FolderCreatorDescriptor;
+    /**
+     * Make the folder and return its path. Pimote resolves the path to its
+     * canonical filesystem identity before seeding, broadcasting, or opening a
+     * session, so a creator can return the lexical path it used to reach the
+     * folder. The path must name the successfully created folder.
+     */
     create(params: Record<string, unknown>): Promise<{
         path: string;
     }>;

package/dist/panels/detect.js

@@ -1,7 +1,3 @@
-/** Tracks active state per key so re-detection deactivates the old handle.
- *  Scoped per ExtensionAPI instance (one per pi session) via a WeakMap, so two
- *  sessions in the same process that detect() the same key don't deactivate
- *  each other's handles. */
 const handlesByApi = new WeakMap();
 /**
  * Detect whether running inside pimote. Returns a scoped handle for pushing
@@ -12,7 +8,6 @@ const handlesByApi = new WeakMap();
  * previous handle (its methods become no-ops) and returns a new one.
  */
 export function detect(pi, key) {
-    // Synchronous detection round-trip
     let detected = false;
     const unsub = pi.events.on('pimote:detect:response', () => {
         detected = true;
@@ -21,7 +16,6 @@ export function detect(pi, key) {
     unsub();
     if (!detected)
         return null;
-    // Deactivate previous handle for this key (scoped to this pi instance)
     let handles = handlesByApi.get(pi);
     if (!handles) {
         handles = new Map();
@@ -30,7 +24,6 @@ export function detect(pi, key) {
     const prev = handles.get(key);
     if (prev)
         prev.active = false;
-    // Create new handle state
     const state = { active: true };
     handles.set(key, state);
     return {

package/dist/panels/types.d.ts

@@ -15,7 +15,7 @@ export interface Card {
     footer?: string[];
     /**
      * Optional same-origin URL. When present, the client renders the entire
-     * card as a clickable link (same-tab navigation). Kept in lock-step with
+     * card as a clickable link that opens in a new tab. Kept in lock-step with
      * the protocol `Card` type in `shared/src/protocol.ts`.
      */
     href?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pimote/sdk",
-  "version": "0.15.0-rc.5",
+  "version": "0.15.0",
   "description": "Pimote extensibility SDK: panel cards, background-activity reap guard, and folder discovery/creation seams for pi extensions",
   "type": "module",
   "license": "MIT",
@@ -49,7 +49,7 @@
     }
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "1.3.0",
+    "@earendil-works/pi-coding-agent": "1.4.0",
     "typescript": "^6.0.2",
     "vitest": "^4.1.2"
   }