@miadi/tide-contract 0.1.2 → 0.2.0

package/README.md

@@ -12,8 +12,9 @@ This package is the shared covenant between:
 ## Current shape
 
 - `schema/tide-api.schema.json` is the planned source of truth.
-- `src/index.ts` carries hand-written TypeScript types for this scaffold.
-- Runtime identity constants are exported from `src/index.ts` and mirrored in the schema `x-tide` metadata: `tide`, `MIADI_HOME`, `~/.miadi/navigator`, and `hermes.navigator.daemon.v1`.
+- `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`.
+- 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`.
 
 ## Drift posture

package/dist/index.d.ts

@@ -2,8 +2,21 @@ export declare const TIDE_API_SCHEMA_ID = "https://miadi.dev/schemas/tide-api.sc
 export declare const TIDE_CLI_COMMAND = "tide";
 export declare const TIDE_STATE_ROOT_ENV = "MIADI_HOME";
 export declare const TIDE_DEFAULT_STATE_ROOT = "~/.miadi/navigator";
-export declare const TIDE_DAEMON_CONTRACT_VERSION = "hermes.navigator.daemon.v1";
+export declare const TIDE_DAEMON_CONTRACT_VERSION = "miadi.tide.daemon.v2";
+/**
+ * Terminal multiplexer discriminator. Everywhere it is optional, absence means
+ * "tmux" — the historical default — so pre-0.2.0 payloads keep validating and
+ * existing consumers compile unchanged.
+ */
+export type Multiplexer = "tmux" | "herdr";
+/**
+ * Agent status detected by herdr for a pane. "done" means the agent finished
+ * but that pane has not been looked at yet.
+ */
+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. */
     tmux_pane: string;
     pid: number;
     cwd: string;
@@ -46,12 +59,16 @@ export interface TideHealthResult {
     timestamp: string;
 }
 export interface TideTerminalTarget {
+    multiplexer?: Multiplexer;
     terminal_id: string;
     session_id: string;
     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: string;
+    /** Durable pane label (herdr); resolve label→id at action time — herdr ids compact when panes close. */
+    pane_label?: string;
     cwd: string;
     pane_active: boolean;
     session_attached: number;
@@ -82,4 +99,115 @@ export interface TideSteerResult {
 export interface TideSendResult {
     [key: string]: unknown;
 }
+/**
+ * Result/plan of a direct send-keys steer against a tmux pane. Byte-for-byte
+ * the pre-0.2.0 `TideSendKeysResult` shape: the `multiplexer` discriminator is
+ * optional and absent means "tmux", so existing producers and consumers keep
+ * compiling and validating unchanged.
+ */
+export interface TideTmuxSendKeysResult {
+    multiplexer?: "tmux";
+    /** Resolved tmux pane target, %-prefixed after normalization (e.g. "%56"). */
+    target: string;
+    /** The literal text typed into the pane. */
+    message: string;
+    /** Whether a trailing Enter (`C-m`) was sent after the literal text. */
+    submitted: boolean;
+    /** Exact `tmux send-keys -l` argv used to type the literal text (no shell). */
+    literal_command: string[];
+    /** Exact `tmux send-keys … C-m` argv used to submit, or null when `submitted` is false. */
+    submit_command: string[] | null;
+    /** ISO timestamp the keys were sent (omitted on a dry-run plan). */
+    sent_at?: string;
+}
+/**
+ * Result/plan of a direct send-keys steer against a herdr pane. The argv
+ * fields carry herdr CLI arguments (`pane send-text …` / `pane send-keys …
+ * Enter`) instead of tmux argv.
+ */
+export interface TideHerdrSendKeysResult {
+    multiplexer: "herdr";
+    /** Resolved herdr pane id (e.g. "1-2"). Compact and non-durable. */
+    target: string;
+    /** Durable pane label this target was resolved from, when label→id resolution ran. */
+    pane_label?: string;
+    /** The literal text typed into the pane. */
+    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", …]). */
+    literal_command: string[];
+    /** Exact herdr CLI argv used to submit Enter, or null when `submitted` is false. */
+    submit_command: string[] | null;
+    /** ISO timestamp the keys were sent (omitted on a dry-run plan). */
+    sent_at?: string;
+}
+/** Discriminated union on `multiplexer`; an absent discriminator means the tmux variant. */
+export type TideSendKeysResult = TideTmuxSendKeysResult | TideHerdrSendKeysResult;
+export type ObserverControllerPosture = "observer" | "controller" | "auto";
+export type EpisodeLaneRole = "planning" | "perspective" | "delivery" | "implementation" | "custom";
+export type EpisodeLaneVerificationState = "verified" | "unverified" | "unknown";
+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: string | null;
+    /** Durable pane label. herdr ids are compact and non-durable, so label→id resolution happens at action time. */
+    pane_label?: string | null;
+    agent_status?: TideAgentStatus;
+    verification_state: EpisodeLaneVerificationState;
+    domain_id: string | null;
+    safe_to_close: boolean;
+    continuation_note: string | null;
+    posture: ObserverControllerPosture;
+}
+export interface EpisodeLaneTopology {
+    episode_id: string;
+    session_name: string;
+    captured_at: string;
+    lanes: EpisodeLane[];
+}
+export interface TideLaneCheckpoint {
+    checkpoint_at: string;
+    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. */
+    pane_label?: string | null;
+    continuation_note: string | null;
+    artifact_paths: string[];
+    safe_to_close: boolean;
+    checkpoint_path: string | null;
+}
+export interface TideResumeLink {
+    episode_id: string;
+    episode_folder: string;
+    resume_path: string;
+    summary_excerpt: string | null;
+    commit_sha: string | null;
+    produced_at: string | null;
+}
+export interface TideAudioManifestLink {
+    episode_id: string;
+    episode_folder: string;
+    manifest_path: string;
+    entry_count: number;
+    last_mp3_path: string | null;
+    last_telegram_message_id: string | null;
+    updated_at: string | null;
+}
+export interface TidePendingApproval {
+    approval_id: string;
+    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. */
+    pane_label?: string | null;
+    agent_status?: TideAgentStatus;
+    action_type: string;
+    proposal_text: string | null;
+    requires_controller: boolean;
+    created_at: string;
+}
 //# sourceMappingURL=index.d.ts.map

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/dist/index.js

@@ -4,5 +4,5 @@ export const TIDE_API_SCHEMA_ID = "https://miadi.dev/schemas/tide-api.schema.jso
 export const TIDE_CLI_COMMAND = "tide";
 export const TIDE_STATE_ROOT_ENV = "MIADI_HOME";
 export const TIDE_DEFAULT_STATE_ROOT = "~/.miadi/navigator";
-export const TIDE_DAEMON_CONTRACT_VERSION = "hermes.navigator.daemon.v1";
+export const TIDE_DAEMON_CONTRACT_VERSION = "miadi.tide.daemon.v2";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,iFAAiF;AAEjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,gDAAgD,CAAA;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAA;AAC3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,iFAAiF;AAEjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,gDAAgD,CAAA;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AACtC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAC/C,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAA;AAC3D,MAAM,CAAC,MAAM,4BAA4B,GAAG,sBAAsB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miadi/tide-contract",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Schema-first Tide API contract shared by Miadi and the IronSilk tide runtime.",
   "license": "MIT",
   "publishConfig": {
@@ -24,7 +24,8 @@
   ],
   "scripts": {
     "build": "tsc",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "test": "d=$(mktemp -d \"${TMPDIR:-/tmp}/miadi-tide-contract-test.XXXXXX\") && trap 'rm -rf \"$d\"' EXIT && ../../node_modules/.bin/tsc -p tsconfig.test.json --outDir \"$d\" && node --test \"$d\"/test/*.test.js"
   },
   "devDependencies": {
     "typescript": "^5.4.0"

package/schema/tide-api.schema.json

@@ -7,10 +7,131 @@
     "cliCommand": "tide",
     "stateRootEnv": "MIADI_HOME",
     "defaultStateRoot": "~/.miadi/navigator",
-    "daemonContractVersion": "hermes.navigator.daemon.v1"
+    "daemonContractVersion": "miadi.tide.daemon.v2"
   },
   "type": "object",
   "$defs": {
+    "multiplexer": {
+      "type": "string",
+      "enum": ["tmux", "herdr"],
+      "description": "Terminal multiplexer discriminator. Absent means 'tmux' (the historical default), so pre-0.2.0 payloads stay valid."
+    },
+    "agentStatus": {
+      "type": "string",
+      "enum": ["idle", "working", "blocked", "done", "unknown"],
+      "description": "Agent status detected by herdr for a pane. 'done' means the agent finished but that pane has not been looked at yet."
+    },
+    "observerControllerPosture": {
+      "type": "string",
+      "enum": ["observer", "controller", "auto"],
+      "description": "Distinguishes read-only observer mode from controller mode where mutations (send/accept) are allowed."
+    },
+    "episodeLaneRole": {
+      "type": "string",
+      "enum": ["planning", "perspective", "delivery", "implementation", "custom"],
+      "description": "Semantic role of an episode lane (extensible via 'custom')."
+    },
+    "episodeLaneVerificationState": {
+      "type": "string",
+      "enum": ["verified", "unverified", "unknown"],
+      "description": "Whether a pane identity for this lane has been verified."
+    },
+    "episodeLane": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "episode_id",
+        "lane_id",
+        "lane_role",
+        "verification_state",
+        "safe_to_close",
+        "posture"
+      ],
+      "properties": {
+        "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." },
+        "agent_status": { "$ref": "#/$defs/agentStatus" },
+        "verification_state": { "$ref": "#/$defs/episodeLaneVerificationState" },
+        "domain_id": { "type": ["string", "null"] },
+        "safe_to_close": { "type": "boolean", "description": "Whether this lane can be closed without losing work." },
+        "continuation_note": { "type": ["string", "null"], "description": "Path or inline text for resumption context." },
+        "posture": { "$ref": "#/$defs/observerControllerPosture", "description": "Explicit observer/controller boundary." }
+      }
+    },
+    "episodeLaneTopology": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["episode_id", "session_name", "captured_at", "lanes"],
+      "properties": {
+        "episode_id": { "type": "string" },
+        "session_name": { "type": "string", "description": "tmux session name (e.g., 'miadi-episode-077-52')." },
+        "captured_at": { "type": "string" },
+        "lanes": { "type": "array", "items": { "$ref": "#/$defs/episodeLane" } }
+      }
+    },
+    "tideLaneCheckpoint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["checkpoint_at", "episode_id", "lane_id", "safe_to_close"],
+      "properties": {
+        "checkpoint_at": { "type": "string", "description": "ISO 8601 timestamp." },
+        "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." },
+        "continuation_note": { "type": ["string", "null"] },
+        "artifact_paths": { "type": "array", "items": { "type": "string" } },
+        "safe_to_close": { "type": "boolean" },
+        "checkpoint_path": { "type": ["string", "null"], "description": "Path to this checkpoint JSON file (for reference)." }
+      }
+    },
+    "tideResumeLink": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["episode_id", "episode_folder", "resume_path"],
+      "properties": {
+        "episode_id": { "type": "string" },
+        "episode_folder": { "type": "string", "description": "Absolute path to episode folder." },
+        "resume_path": { "type": "string", "description": "Absolute path to RESUME.md." },
+        "summary_excerpt": { "type": ["string", "null"], "description": "First ~300 characters of RESUME.md body." },
+        "commit_sha": { "type": ["string", "null"] },
+        "produced_at": { "type": ["string", "null"] }
+      }
+    },
+    "tideAudioManifestLink": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["episode_id", "episode_folder", "manifest_path", "entry_count"],
+      "properties": {
+        "episode_id": { "type": "string" },
+        "episode_folder": { "type": "string" },
+        "manifest_path": { "type": "string", "description": "Absolute path to AUDIO-MANIFEST.md." },
+        "entry_count": { "type": "integer", "minimum": 0 },
+        "last_mp3_path": { "type": ["string", "null"] },
+        "last_telegram_message_id": { "type": ["string", "null"] },
+        "updated_at": { "type": ["string", "null"] }
+      }
+    },
+    "tidePendingApproval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["approval_id", "episode_id", "action_type", "requires_controller", "created_at"],
+      "properties": {
+        "approval_id": { "type": "string" },
+        "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." },
+        "agent_status": { "$ref": "#/$defs/agentStatus" },
+        "action_type": { "type": "string", "description": "e.g., 'steer', 'send', 'close', 'commit'." },
+        "proposal_text": { "type": ["string", "null"] },
+        "requires_controller": { "type": "boolean" },
+        "created_at": { "type": "string" }
+      }
+    },
     "terminalContext": {
       "type": "object",
       "additionalProperties": false,
@@ -25,7 +146,8 @@
         "captured_at"
       ],
       "properties": {
-        "tmux_pane": { "type": "string", "pattern": "^%?[0-9]+$" },
+        "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." },
         "pid": { "type": "integer" },
         "cwd": { "type": "string" },
         "domain_id": { "type": ["string", "null"] },
@@ -130,12 +252,14 @@
         "select_pane_command"
       ],
       "properties": {
+        "multiplexer": { "$ref": "#/$defs/multiplexer" },
         "terminal_id": { "type": "string" },
         "session_id": { "type": "string" },
         "session_name": { "type": "string" },
         "window_id": { "type": "string" },
         "window_name": { "type": "string" },
-        "pane_id": { "type": "string", "pattern": "^%?[0-9]+$" },
+        "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." },
         "cwd": { "type": "string" },
         "pane_active": { "type": "boolean" },
         "session_attached": { "type": "integer", "minimum": 0 },
@@ -172,6 +296,44 @@
     "looseOperatorResult": {
       "type": "object",
       "additionalProperties": true
+    },
+    "tmuxSendKeysResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["target", "message", "submitted", "literal_command", "submit_command"],
+      "description": "Result/plan of a direct send-keys steer against a tmux pane. Byte-for-byte the pre-0.2.0 TideSendKeysResult shape: the discriminator is optional and absent means 'tmux'.",
+      "properties": {
+        "multiplexer": { "const": "tmux" },
+        "target": { "type": "string", "pattern": "^%?[0-9]+$", "description": "Resolved tmux pane target, %-prefixed after normalization (e.g., '%56')." },
+        "message": { "type": "string", "description": "The literal text typed into the pane." },
+        "submitted": { "type": "boolean", "description": "Whether a trailing Enter (C-m) was sent after the literal text." },
+        "literal_command": { "type": "array", "items": { "type": "string" }, "description": "Exact `tmux send-keys -l` argv used to type the literal text (no shell)." },
+        "submit_command": { "type": ["array", "null"], "items": { "type": "string" }, "description": "Exact `tmux send-keys … C-m` argv used to submit, or null when 'submitted' is false." },
+        "sent_at": { "type": "string", "description": "ISO timestamp the keys were sent (omitted on a dry-run plan)." }
+      }
+    },
+    "herdrSendKeysResult": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["multiplexer", "target", "message", "submitted", "literal_command", "submit_command"],
+      "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." },
+        "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." },
+        "sent_at": { "type": "string", "description": "ISO timestamp the keys were sent (omitted on a dry-run plan)." }
+      }
+    },
+    "sendKeysResult": {
+      "oneOf": [
+        { "$ref": "#/$defs/tmuxSendKeysResult" },
+        { "$ref": "#/$defs/herdrSendKeysResult" }
+      ],
+      "description": "Discriminated union on 'multiplexer'; an absent discriminator means the tmux variant."
     }
   },
   "properties": {
@@ -181,6 +343,12 @@
     "detect": { "$ref": "#/$defs/detectResult" },
     "peek": { "$ref": "#/$defs/looseOperatorResult" },
     "steer": { "$ref": "#/$defs/looseOperatorResult" },
-    "send": { "$ref": "#/$defs/looseOperatorResult" }
+    "send": { "$ref": "#/$defs/looseOperatorResult" },
+    "sendKeys": { "$ref": "#/$defs/sendKeysResult" },
+    "episodeLaneTopology": { "$ref": "#/$defs/episodeLaneTopology" },
+    "tideLaneCheckpoint": { "$ref": "#/$defs/tideLaneCheckpoint" },
+    "tideResumeLink": { "$ref": "#/$defs/tideResumeLink" },
+    "tideAudioManifestLink": { "$ref": "#/$defs/tideAudioManifestLink" },
+    "tidePendingApproval": { "$ref": "#/$defs/tidePendingApproval" }
   }
 }