@miadi/tide-contract 0.2.0 → 0.2.2

package/README.md

@@ -13,7 +13,9 @@ This package is the shared covenant between:
 
 - `schema/tide-api.schema.json` is the planned source of truth.
 - `src/index.ts` carries hand-written TypeScript types for this scaffold, edited in lockstep with the schema (guarded by `npm test`, `test/schema-patterns.test.ts`).
-- 0.2.0 adds the `multiplexer` discriminator (`"tmux" | "herdr"`, absent ⇒ `"tmux"`), pane targets in both formats (tmux `%76`/`76`, herdr `1-2`), optional `pane_label` (herdr ids are compact/non-durable ⇒ label→id resolution at action time), the `TideSendKeysResult` discriminated union, and optional `agent_status` on `EpisodeLane` / `TidePendingApproval`.
+- 0.2.0 adds the `multiplexer` discriminator (`"tmux" | "herdr"`, absent ⇒ `"tmux"`), pane targets in both formats, optional `pane_label`, the `TideSendKeysResult` discriminated union, and optional `agent_status` on `EpisodeLane` / `TidePendingApproval`.
+- 0.2.1 corrects the herdr pane-id story from the EP137 live smoke (herdr 0.7.4): real ids are `w1:p2` (legacy `1-2` still accepted), **session-scoped and monotonic** — they do not compact or get reused when panes close, a stale id fails loudly with `pane_not_found`, and `pane rename` sets the `label` field that label→id resolution matches at action time.
+- 0.2.2 types the remaining live-verified herdr envelopes: `TideHerdrPaneInfo` (`pane list` rows), `TideHerdrWaitOutputResult` (`wait output` hit), and `TideHerdrAgentStatusEvent` (`wait agent-status` hits print an EVENT envelope, not a result envelope).
 - Runtime identity constants are exported from `src/index.ts` and mirrored in the schema `x-tide` metadata: `tide`, `MIADI_HOME`, `~/.miadi/navigator`, and `miadi.tide.daemon.v2`.
 - Future work should generate the TypeScript types from the schema and validate IronSilk runtime payloads with Python `jsonschema`.
 

package/dist/index.d.ts

@@ -16,7 +16,7 @@ export type Multiplexer = "tmux" | "herdr";
 export type TideAgentStatus = "idle" | "working" | "blocked" | "done" | "unknown";
 export interface TerminalContext {
     multiplexer?: Multiplexer;
-    /** Pane id in the owning multiplexer: tmux (e.g. "%56") or herdr (e.g. "1-2"). Field name is historical. */
+    /** Pane id in the owning multiplexer: tmux (e.g. "%56") or herdr (e.g. "w1:p2" as of herdr 0.7; legacy "1-2" accepted). Field name is historical. */
     tmux_pane: string;
     pid: number;
     cwd: string;
@@ -65,9 +65,9 @@ export interface TideTerminalTarget {
     session_name: string;
     window_id: string;
     window_name: string;
-    /** Pane id in the owning multiplexer: tmux (e.g. "%56") or herdr (e.g. "1-2"). */
+    /** Pane id in the owning multiplexer: tmux (e.g. "%56") or herdr (e.g. "w1:p2" as of herdr 0.7; legacy "1-2" accepted). */
     pane_id: string;
-    /** Durable pane label (herdr); resolve label→id at action time — herdr ids compact when panes close. */
+    /** Durable pane label (herdr, set via `pane rename`); resolve label→id at action time — herdr ids are session-scoped and a stale id fails loudly with pane_not_found. */
     pane_label?: string;
     cwd: string;
     pane_active: boolean;
@@ -127,7 +127,7 @@ export interface TideTmuxSendKeysResult {
  */
 export interface TideHerdrSendKeysResult {
     multiplexer: "herdr";
-    /** Resolved herdr pane id (e.g. "1-2"). Compact and non-durable. */
+    /** Resolved herdr pane id (e.g. "w1:p2" as of herdr 0.7; legacy "1-2" accepted). Session-scoped, not durable across herdr restarts. */
     target: string;
     /** Durable pane label this target was resolved from, when label→id resolution ran. */
     pane_label?: string;
@@ -135,7 +135,7 @@ export interface TideHerdrSendKeysResult {
     message: string;
     /** Whether a real Enter key was sent after the literal text. */
     submitted: boolean;
-    /** Exact herdr CLI argv used to type the literal text (e.g. ["pane","send-text","1-2", …]). */
+    /** Exact herdr CLI argv used to type the literal text (e.g. ["pane","send-text","w1:p2", …]). */
     literal_command: string[];
     /** Exact herdr CLI argv used to submit Enter, or null when `submitted` is false. */
     submit_command: string[] | null;
@@ -144,6 +144,57 @@ export interface TideHerdrSendKeysResult {
 }
 /** Discriminated union on `multiplexer`; an absent discriminator means the tmux variant. */
 export type TideSendKeysResult = TideTmuxSendKeysResult | TideHerdrSendKeysResult;
+/**
+ * One row from `herdr pane list` (fields observed live on herdr 0.7.4, EP137).
+ * `label` appears only after `herdr pane rename`; rows carry
+ * `terminal_title`/`terminal_title_stripped`, never `title`.
+ */
+export interface TideHerdrPaneInfo {
+    /** Session-scoped herdr pane id (e.g. "w1:p2"). */
+    pane_id?: string;
+    /** Durable pane label set via `herdr pane rename` — the field label→id resolution matches. */
+    label?: string;
+    focused?: boolean;
+    agent_status?: TideAgentStatus | string;
+    workspace_id?: string;
+    tab_id?: string;
+    cwd?: string;
+    terminal_title?: string;
+    terminal_title_stripped?: string;
+    [key: string]: unknown;
+}
+/**
+ * Envelope printed by `herdr wait output` on a hit (herdr 0.7.4, EP137):
+ * `result.type` is "output_matched" with `matched_line` and a read transcript
+ * block. On timeout herdr exits 1 with error JSON on stderr — that path
+ * surfaces as a TideError, never as this shape.
+ */
+export interface TideHerdrWaitOutputResult {
+    id?: string;
+    result?: {
+        type?: string;
+        matched_line?: string;
+        pane_id?: string;
+        workspace_id?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/**
+ * EVENT envelope printed by `herdr wait agent-status` on a hit (herdr 0.7.4,
+ * EP137) — NOT a result envelope. On timeout herdr exits 1 with plain text on
+ * stderr — that path surfaces as a TideError.
+ */
+export interface TideHerdrAgentStatusEvent {
+    event?: string;
+    data?: {
+        pane_id?: string;
+        workspace_id?: string;
+        agent_status?: TideAgentStatus | string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
 export type ObserverControllerPosture = "observer" | "controller" | "auto";
 export type EpisodeLaneRole = "planning" | "perspective" | "delivery" | "implementation" | "custom";
 export type EpisodeLaneVerificationState = "verified" | "unverified" | "unknown";
@@ -151,9 +202,9 @@ export interface EpisodeLane {
     episode_id: string;
     lane_id: string;
     lane_role: EpisodeLaneRole;
-    /** Pane target: tmux pane id (e.g. "%76") or herdr pane id (e.g. "1-2"). */
+    /** Pane target: tmux pane id (e.g. "%76") or herdr pane id (e.g. "w1:p2"). */
     pane_target: string | null;
-    /** Durable pane label. herdr ids are compact and non-durable, so label→id resolution happens at action time. */
+    /** Durable pane label. herdr ids are session-scoped (they do not survive a herdr restart), so label→id resolution happens at action time. */
     pane_label?: string | null;
     agent_status?: TideAgentStatus;
     verification_state: EpisodeLaneVerificationState;
@@ -173,7 +224,7 @@ export interface TideLaneCheckpoint {
     episode_id: string;
     lane_id: string;
     pane_target: string | null;
-    /** Durable pane label for re-resolving the (non-durable) herdr pane id at action time. */
+    /** Durable pane label for re-resolving the (session-scoped) herdr pane id at action time. */
     pane_label?: string | null;
     continuation_note: string | null;
     artifact_paths: string[];
@@ -202,7 +253,7 @@ export interface TidePendingApproval {
     episode_id: string;
     lane_id: string | null;
     pane_target: string | null;
-    /** Durable pane label for re-resolving the (non-durable) herdr pane id at action time. */
+    /** Durable pane label for re-resolving the (session-scoped) herdr pane id at action time. */
     pane_label?: string | null;
     agent_status?: TideAgentStatus;
     action_type: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/tide-contract",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Schema-first Tide API contract shared by Miadi and the IronSilk tide runtime.",
   "license": "MIT",
   "publishConfig": {

package/schema/tide-api.schema.json

@@ -51,8 +51,8 @@
         "episode_id": { "type": "string", "description": "Unique episode identifier." },
         "lane_id": { "type": "string", "description": "Unique lane identifier within the episode (e.g., 'planning', 'delivery')." },
         "lane_role": { "$ref": "#/$defs/episodeLaneRole" },
-        "pane_target": { "type": ["string", "null"], "pattern": "^(%?[0-9]+|[0-9]+-[0-9]+)$", "description": "Optional pane target: tmux pane id (e.g., '%76' or '76') or herdr pane id (e.g., '1-2')." },
-        "pane_label": { "type": ["string", "null"], "description": "Durable pane label. herdr pane ids are compact and non-durable, so label→id resolution happens at action time." },
+        "pane_target": { "type": ["string", "null"], "pattern": "^(%?[0-9]+|[0-9]+-[0-9]+|w[0-9]+:p[0-9]+)$", "description": "Optional pane target: tmux pane id (e.g., '%76' or '76') or herdr pane id (e.g., 'w1:p2' as of herdr 0.7; legacy '1-2' accepted)." },
+        "pane_label": { "type": ["string", "null"], "description": "Durable pane label. herdr pane ids are session-scoped (they do not survive a herdr restart), so label→id resolution happens at action time." },
         "agent_status": { "$ref": "#/$defs/agentStatus" },
         "verification_state": { "$ref": "#/$defs/episodeLaneVerificationState" },
         "domain_id": { "type": ["string", "null"] },
@@ -81,7 +81,7 @@
         "episode_id": { "type": "string" },
         "lane_id": { "type": "string" },
         "pane_target": { "type": ["string", "null"] },
-        "pane_label": { "type": ["string", "null"], "description": "Durable pane label for re-resolving the (non-durable) herdr pane id at action time." },
+        "pane_label": { "type": ["string", "null"], "description": "Durable pane label for re-resolving the (session-scoped) herdr pane id at action time." },
         "continuation_note": { "type": ["string", "null"] },
         "artifact_paths": { "type": "array", "items": { "type": "string" } },
         "safe_to_close": { "type": "boolean" },
@@ -124,7 +124,7 @@
         "episode_id": { "type": "string" },
         "lane_id": { "type": ["string", "null"] },
         "pane_target": { "type": ["string", "null"] },
-        "pane_label": { "type": ["string", "null"], "description": "Durable pane label for re-resolving the (non-durable) herdr pane id at action time." },
+        "pane_label": { "type": ["string", "null"], "description": "Durable pane label for re-resolving the (session-scoped) herdr pane id at action time." },
         "agent_status": { "$ref": "#/$defs/agentStatus" },
         "action_type": { "type": "string", "description": "e.g., 'steer', 'send', 'close', 'commit'." },
         "proposal_text": { "type": ["string", "null"] },
@@ -147,7 +147,7 @@
       ],
       "properties": {
         "multiplexer": { "$ref": "#/$defs/multiplexer" },
-        "tmux_pane": { "type": "string", "pattern": "^(%?[0-9]+|[0-9]+-[0-9]+)$", "description": "Pane id in the owning multiplexer: tmux (e.g., '%56') or herdr (e.g., '1-2'). Field name is historical." },
+        "tmux_pane": { "type": "string", "pattern": "^(%?[0-9]+|[0-9]+-[0-9]+|w[0-9]+:p[0-9]+)$", "description": "Pane id in the owning multiplexer: tmux (e.g., '%56') or herdr (e.g., 'w1:p2' as of herdr 0.7; legacy '1-2' accepted). Field name is historical." },
         "pid": { "type": "integer" },
         "cwd": { "type": "string" },
         "domain_id": { "type": ["string", "null"] },
@@ -258,8 +258,8 @@
         "session_name": { "type": "string" },
         "window_id": { "type": "string" },
         "window_name": { "type": "string" },
-        "pane_id": { "type": "string", "pattern": "^(%?[0-9]+|[0-9]+-[0-9]+)$", "description": "Pane id in the owning multiplexer: tmux (e.g., '%56') or herdr (e.g., '1-2')." },
-        "pane_label": { "type": "string", "description": "Durable pane label (herdr); resolve label→id at action time — herdr ids compact when panes close." },
+        "pane_id": { "type": "string", "pattern": "^(%?[0-9]+|[0-9]+-[0-9]+|w[0-9]+:p[0-9]+)$", "description": "Pane id in the owning multiplexer: tmux (e.g., '%56') or herdr (e.g., 'w1:p2' as of herdr 0.7; legacy '1-2' accepted)." },
+        "pane_label": { "type": "string", "description": "Durable pane label (herdr, set via `pane rename`); resolve label→id at action time — herdr ids are session-scoped and a stale id fails loudly with pane_not_found." },
         "cwd": { "type": "string" },
         "pane_active": { "type": "boolean" },
         "session_attached": { "type": "integer", "minimum": 0 },
@@ -319,12 +319,12 @@
       "description": "Result/plan of a direct send-keys steer against a herdr pane. The argv fields carry herdr CLI arguments instead of tmux argv.",
       "properties": {
         "multiplexer": { "const": "herdr" },
-        "target": { "type": "string", "pattern": "^[0-9]+-[0-9]+$", "description": "Resolved herdr pane id (e.g., '1-2'). Compact and non-durable." },
+        "target": { "type": "string", "pattern": "^([0-9]+-[0-9]+|w[0-9]+:p[0-9]+)$", "description": "Resolved herdr pane id (e.g., 'w1:p2' as of herdr 0.7; legacy '1-2' accepted). Session-scoped, not durable across herdr restarts." },
         "pane_label": { "type": "string", "description": "Durable pane label this target was resolved from, when label→id resolution ran." },
         "message": { "type": "string", "description": "The literal text typed into the pane." },
         "submitted": { "type": "boolean", "description": "Whether a real Enter key was sent after the literal text." },
-        "literal_command": { "type": "array", "items": { "type": "string" }, "description": "Exact herdr CLI argv used to type the literal text (e.g., ['pane','send-text','1-2', …])." },
-        "submit_command": { "type": ["array", "null"], "items": { "type": "string" }, "description": "Exact herdr CLI argv used to submit Enter (['pane','send-keys','1-2','Enter']), or null when 'submitted' is false." },
+        "literal_command": { "type": "array", "items": { "type": "string" }, "description": "Exact herdr CLI argv used to type the literal text (e.g., ['pane','send-text','w1:p2', …])." },
+        "submit_command": { "type": ["array", "null"], "items": { "type": "string" }, "description": "Exact herdr CLI argv used to submit Enter (['pane','send-keys','w1:p2','Enter']), or null when 'submitted' is false." },
         "sent_at": { "type": "string", "description": "ISO timestamp the keys were sent (omitted on a dry-run plan)." }
       }
     },
@@ -334,6 +334,57 @@
         { "$ref": "#/$defs/herdrSendKeysResult" }
       ],
       "description": "Discriminated union on 'multiplexer'; an absent discriminator means the tmux variant."
+    },
+    "herdrPaneInfo": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "One row from `herdr pane list` (loose — herdr owns the shape; fields below observed live on herdr 0.7.4, EP137). `label` appears only after `herdr pane rename`; rows carry terminal_title/terminal_title_stripped, never `title`.",
+      "properties": {
+        "pane_id": { "type": "string", "description": "Session-scoped herdr pane id (e.g., 'w1:p2')." },
+        "label": { "type": "string", "description": "Durable pane label set via `herdr pane rename` — the field label→id resolution matches." },
+        "focused": { "type": "boolean" },
+        "agent_status": { "$ref": "#/$defs/agentStatus" },
+        "workspace_id": { "type": "string" },
+        "tab_id": { "type": "string" },
+        "cwd": { "type": "string" },
+        "terminal_title": { "type": "string" },
+        "terminal_title_stripped": { "type": "string" }
+      }
+    },
+    "herdrWaitOutputResult": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "Envelope printed by `herdr wait output` on a hit (herdr 0.7.4, EP137-verified): result.type is 'output_matched' with matched_line and a read transcript block. On timeout herdr exits 1 with an error JSON on stderr — that path surfaces as a TideError, never as this shape.",
+      "properties": {
+        "id": { "type": "string" },
+        "result": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "type": { "type": "string" },
+            "matched_line": { "type": "string" },
+            "pane_id": { "type": "string" },
+            "workspace_id": { "type": "string" }
+          }
+        }
+      }
+    },
+    "herdrAgentStatusEvent": {
+      "type": "object",
+      "additionalProperties": true,
+      "description": "EVENT envelope printed by `herdr wait agent-status` on a hit (herdr 0.7.4, EP137-verified) — NOT a result envelope. On timeout herdr exits 1 with plain text on stderr — that path surfaces as a TideError.",
+      "properties": {
+        "event": { "type": "string", "description": "e.g., 'pane.agent_status_changed'." },
+        "data": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "pane_id": { "type": "string" },
+            "workspace_id": { "type": "string" },
+            "agent_status": { "$ref": "#/$defs/agentStatus" }
+          }
+        }
+      }
     }
   },
   "properties": {