@oh-my-pi/pi-wire 18.5.1 → 18.6.1

package/dist/types/tsp.d.ts

@@ -11,9 +11,11 @@
  * `q` query, `o` open, `f` frame, `b` blob, `t` palette, `x` close. Terminal →
  * program: `r` reply, `e` event (on the pty's input side).
  *
- * The normative spec is `crates/tern/SURFACE_PROTOCOL.md` in the Stencil
- * repository; these types mirror it. Unknown fields and verbs are ignored in
- * both directions, so every addition here is optional.
+ * The normative spec is the Tern SDK's Surface Protocol and Elements reference
+ * (`docs/sdk/src/protocol` and `docs/sdk/src/elements` in the Stencil
+ * repository, https://docs.stencil.so/tern/protocol/); these types mirror it.
+ * Unknown fields and verbs are ignored in both directions, so every addition
+ * here is optional.
  */
 /** Protocol version this build speaks. */
 export declare const TSP_VERSION = 1;
@@ -328,6 +330,9 @@ export interface TspEditorProps {
     /** The text is code in this language (`python`, `bash`): highlighted, in the mono face. */
     lang?: string;
     readonly?: boolean;
+    /** Ready to accept an atomic `send` when advertised in `hello.features`.
+     *  Independent of text editability or keyboard focus; absent or false is not ready. */
+    sendable?: boolean;
     maxLines?: number;
 }
 export type TspInputProps = Omit<TspEditorProps, "maxLines">;
@@ -415,7 +420,7 @@ export interface TspPickerItem {
 export interface TspPickerColumn {
     id: string;
     head?: string;
-    /** `elapsed`: the value is an age in ms at send; Tern clocks it (spec §9). */
+    /** `elapsed`: the value is an age in ms at send; Tern clocks it. */
     format?: "text" | "num" | "price" | "bar" | "time" | "elapsed" | "dim";
     /** Lower priorities hide first when narrow. */
     priority?: number;
@@ -1043,8 +1048,10 @@ export type TspEvent = {
  * Submit `text` as one prompt through the addressed composer's ordinary
  * submission path, without paste or keyboard simulation. Sent only when
  * the program's `hello.features` includes `"send"` and `sf`/`id` identify
- * a live editable composer. Blank text is a no-op; an existing draft is
- * retained for local recall, not appended to the supplied prompt.
+ * a live editable composer whose `sendable` is exactly true. Writable text
+ * or keyboard focus alone does not imply submission readiness. Blank text is
+ * a no-op; an existing draft is retained for local recall, not appended to
+ * the supplied prompt.
  */
  | {
     ev: "send";

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-wire",
-	"version": "18.5.1",
+	"version": "18.6.1",
 	"description": "Shared wire protocol types for omp packages",
 	"homepage": "https://omp.sh",
 	"author": {

package/src/tsp.ts

@@ -11,9 +11,11 @@
  * `q` query, `o` open, `f` frame, `b` blob, `t` palette, `x` close. Terminal →
  * program: `r` reply, `e` event (on the pty's input side).
  *
- * The normative spec is `crates/tern/SURFACE_PROTOCOL.md` in the Stencil
- * repository; these types mirror it. Unknown fields and verbs are ignored in
- * both directions, so every addition here is optional.
+ * The normative spec is the Tern SDK's Surface Protocol and Elements reference
+ * (`docs/sdk/src/protocol` and `docs/sdk/src/elements` in the Stencil
+ * repository, https://docs.stencil.so/tern/protocol/); these types mirror it.
+ * Unknown fields and verbs are ignored in both directions, so every addition
+ * here is optional.
  */
 
 /** Protocol version this build speaks. */
@@ -357,6 +359,9 @@ export interface TspEditorProps {
 	/** The text is code in this language (`python`, `bash`): highlighted, in the mono face. */
 	lang?: string;
 	readonly?: boolean;
+	/** Ready to accept an atomic `send` when advertised in `hello.features`.
+	 *  Independent of text editability or keyboard focus; absent or false is not ready. */
+	sendable?: boolean;
 	maxLines?: number;
 }
 export type TspInputProps = Omit<TspEditorProps, "maxLines">;
@@ -433,7 +438,7 @@ export interface TspPickerItem {
 export interface TspPickerColumn {
 	id: string;
 	head?: string;
-	/** `elapsed`: the value is an age in ms at send; Tern clocks it (spec §9). */
+	/** `elapsed`: the value is an age in ms at send; Tern clocks it. */
 	format?: "text" | "num" | "price" | "bar" | "time" | "elapsed" | "dim";
 	/** Lower priorities hide first when narrow. */
 	priority?: number;
@@ -958,8 +963,10 @@ export type TspEvent =
 	 * Submit `text` as one prompt through the addressed composer's ordinary
 	 * submission path, without paste or keyboard simulation. Sent only when
 	 * the program's `hello.features` includes `"send"` and `sf`/`id` identify
-	 * a live editable composer. Blank text is a no-op; an existing draft is
-	 * retained for local recall, not appended to the supplied prompt.
+	 * a live editable composer whose `sendable` is exactly true. Writable text
+	 * or keyboard focus alone does not imply submission readiness. Blank text is
+	 * a no-op; an existing draft is retained for local recall, not appended to
+	 * the supplied prompt.
 	 */
 	| { ev: "send"; sf: string; id: string; text: string }
 	/**