@miadi/tide-contract 0.3.4 → 0.3.6

package/dist/index.d.ts

@@ -391,5 +391,1236 @@ export interface TidePendingApproval {
     requires_controller: boolean;
     created_at: string;
 }
-export * from "./secret-redaction.js";
+export type TideSecretRuleKind = "token" | "labelled" | "block";
+export interface TideSecretRule {
+    name: string;
+    /** token: the whole match is redacted. labelled: group 1 is kept, group 2 is redacted. block: the whole match becomes `replacement`. */
+    kind: TideSecretRuleKind;
+    /** A regex in the subset JavaScript and Python share. */
+    pattern: string;
+    /** "" or "i". */
+    flags: string;
+    replacement?: string;
+}
+export declare const TIDE_SECRET_MASK = "***";
+/** Applied top to bottom. */
+export declare const TIDE_SECRET_RULES: readonly TideSecretRule[];
+/** A secret as its first 6 characters (4 when shorter than 7) followed by `***`. */
+export declare function redactSecretValue(value: string): string;
+/**
+ * Text with every credential the rules know redacted. Running it again changes
+ * nothing, so a capture ironsilk already redacted passes through unchanged.
+ */
+export declare function sanitizeSecrets(text: string): string;
+/** The `MiadiEventEnvelope` version the draft events follow. */
+export declare const TIDE_DRAFT_EVENT_SCHEMA_VERSION = "0.1.0";
+/** Version of the catalog below. It moves when an event or a payload field is added or changed. */
+export declare const TIDE_DRAFT_CATALOG_VERSION = "0.1.0";
+export declare const TIDE_DRAFT_EVENT_NAMESPACE = "tide.draft";
+export declare const TIDE_DRAFT_EVENTS_SCHEMA_ID = "https://miadi.dev/schemas/tide-draft-events.schema.json";
+export interface TideDraftPayloadField {
+    type: "string" | "number" | "boolean" | "string[]" | "object";
+    required?: true;
+    description: string;
+    /** Decided in Episode 548 and not yet written by tide. */
+    proposed?: true;
+}
+export interface TideDraftEventDefinition {
+    /** What happened, in one sentence. */
+    summary: string;
+    /** Which observation writes it. */
+    writtenBy: string;
+    /** The payload carries the person's words. Only `versioned` does (D2). */
+    contentIncluded?: true;
+    /** Decided in Episode 548 and not yet written by tide. */
+    proposed?: true;
+    payload: Record<string, TideDraftPayloadField>;
+}
+export declare const TIDE_DRAFT_EVENT_CATALOG: {
+    opened: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    parked: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    resumed: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    versioned: {
+        summary: string;
+        writtenBy: string;
+        contentIncluded: true;
+        payload: {
+            prompt: {
+                readonly type: "string";
+                readonly proposed: true;
+                readonly description: "The prompt in the tracing provider, `miadi-tracing:<domain>/prompt/<miadiRun-…-presession>` (D3).";
+            };
+            prompt_version: {
+                readonly type: "number";
+                readonly proposed: true;
+                readonly description: "The prompt version made from this text (D3), or that the session started from (D4).";
+            };
+            text: {
+                type: "string";
+                required: true;
+                description: string;
+            };
+            version: {
+                type: "number";
+                required: true;
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    restored: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            restores: {
+                type: "number";
+                required: true;
+                description: string;
+            };
+            ready: {
+                type: "boolean";
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    readied: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            send_at: {
+                type: "string";
+                description: string;
+            };
+            scheduler: {
+                type: "string";
+                description: string;
+            };
+            window_seconds: {
+                type: "number";
+                description: string;
+            };
+            completion: {
+                type: "string[]";
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    unreadied: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    due: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            sent: {
+                type: "boolean";
+                required: true;
+                description: string;
+            };
+            flagged_by: {
+                type: "string";
+                description: string;
+            };
+            send_at: {
+                type: "string";
+                description: string;
+            };
+            completion: {
+                type: "string[]";
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    run: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            sent: {
+                type: "boolean";
+                required: true;
+                description: string;
+            };
+            scheduler: {
+                type: "string";
+                description: string;
+            };
+            flagged_by: {
+                type: "string";
+                description: string;
+            };
+            completion: {
+                type: "string[]";
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    sent: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    started: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            prompt: {
+                readonly type: "string";
+                readonly proposed: true;
+                readonly description: "The prompt in the tracing provider, `miadi-tracing:<domain>/prompt/<miadiRun-…-presession>` (D3).";
+            };
+            prompt_version: {
+                readonly type: "number";
+                readonly proposed: true;
+                readonly description: "The prompt version made from this text (D3), or that the session started from (D4).";
+            };
+            session_id: {
+                type: "string";
+                required: true;
+                description: string;
+            };
+            agent_kind: {
+                type: "string";
+                required: true;
+                description: string;
+            };
+            matched_by: {
+                type: "string";
+                description: string;
+            };
+            planned_session_id: {
+                type: "string";
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    unstarted: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    reopened: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            closed_as: {
+                type: "string";
+                required: true;
+                description: string;
+            };
+            closed_reason: {
+                type: "string";
+                description: string;
+            };
+            attached: {
+                type: "boolean";
+                required: true;
+                description: string;
+            };
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    dismissed: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    cleared: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    abandoned: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    withdrawn: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+    expired: {
+        summary: string;
+        writtenBy: string;
+        payload: {
+            pane: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "The pane's address, `<session>:<window>.<pane>`.";
+            };
+            chars: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Length of the draft.";
+            };
+            lines: {
+                readonly type: "number";
+                readonly required: true;
+                readonly description: "Lines in the draft, continuation lines included.";
+            };
+            digest: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "HMAC-SHA256 of the text keyed with `<MIADI_HOME>/drafts/.key`, first 16 hex.";
+            };
+            kind: {
+                readonly type: "string";
+                readonly required: true;
+                readonly description: "`mctgo` when the draft starts a session on a team, else `shell`. Only a `mctgo` draft leaves the host.";
+            };
+            in_view: {
+                readonly type: "boolean";
+                readonly required: true;
+                readonly description: "The pane is the active pane of the active window of an attached session.";
+            };
+            reason: {
+                readonly type: "string";
+                readonly description: "Why the state changed: `idle`, `out of view`, `its pane closed`, `never restored`, …";
+            };
+            target_team: {
+                readonly type: "string";
+                readonly description: "The team a `mctgo` draft names.";
+            };
+            target_session: {
+                readonly type: "string";
+                readonly description: "The session a `mctgo` draft names.";
+            };
+            session_id: {
+                readonly type: "string";
+                readonly description: "The agent session id mctdraft gave the draft before it was sent (Episode 548, D7, ironsilk 0.9.58); `mct new` starts the agent with it. Absent on a draft opened otherwise.";
+            };
+            labels: {
+                readonly type: "object";
+                readonly description: "What a `mctgo` draft is about (D1, ironsilk 0.9.53): `paths`, `packages`, `repositories`, `addresses`, `issues` (string arrays, each omitted when empty) and `team`. Labels, never sentences.";
+            };
+        };
+    };
+};
+export type TideDraftEventName = keyof typeof TIDE_DRAFT_EVENT_CATALOG;
+export type TideDraftEventType = `${typeof TIDE_DRAFT_EVENT_NAMESPACE}.${TideDraftEventName}`;
+export interface TideDraftLabels {
+    paths?: string[];
+    /** `@miadi/*` and `@medicine-wheel/*` mentions. */
+    packages?: string[];
+    /** `owner/repo`, from `owner/repo#n`, `/repos/<owner>/<repo>` paths and github.com URLs. */
+    repositories?: string[];
+    addresses?: string[];
+    issues?: string[];
+    team?: string;
+}
+/** One line of `<MIADI_HOME>/drafts/events.jsonl`. */
+export interface TideDraftEvent {
+    /** `tdev:<epoch ms>:<hex>`. */
+    id: string;
+    schema_version: typeof TIDE_DRAFT_EVENT_SCHEMA_VERSION;
+    event_type: TideDraftEventType;
+    source: {
+        kind: "terminal";
+        system: "tide";
+        instance?: string;
+    };
+    /** `draft:<12 hex>`. The id survives a reboot. */
+    subject: {
+        kind: "draft";
+        id: string;
+    };
+    occurred_at: string;
+    observed_at: string;
+    /** `{kind: "person", id}` once the local account is bound to a Miadi person, else `{kind: "local-user", id: "<user>@<host>"}`. */
+    actor?: {
+        kind: string;
+        id?: string;
+    };
+    /** Equal to the subject id. */
+    correlation_id?: string;
+    causation_id?: string;
+    /** Equal to `id`. */
+    idempotency_key: string;
+    privacy: {
+        classification: string;
+        content_included: boolean;
+    };
+    payload: Record<string, unknown> & {
+        labels?: TideDraftLabels;
+    };
+}
+/** `tide.draft.parked` → `parked`, or null for any other event type. */
+export declare function tideDraftEventName(eventType: string): TideDraftEventName | null;
+/** Whether a draft event leaves the host: only a `mctgo` draft's events do (Episode 548, P1). */
+export declare function tideDraftEventTravels(event: Pick<TideDraftEvent, "payload">): boolean;
+/**
+ * What is wrong with a line read from `events.jsonl`, against the envelope and
+ * the catalog. An empty list means it conforms.
+ */
+export declare function checkTideDraftEvent(value: unknown): string[];
+/** The catalog as a JSON Schema (2020-12), committed as `schema/tide-draft-events.schema.json`. */
+export declare function tideDraftEventsJsonSchema(): Record<string, unknown>;
 //# sourceMappingURL=index.d.ts.map