@scotthuang/agent-knock-knock 0.12.37 → 0.13.0

package/dist/src/terminal-interaction-core.d.ts

@@ -0,0 +1,104 @@
+import { type NativeQuestionnaireActionPlan, type NativeQuestionnaireInspection } from "./terminal-questionnaire-adapter.js";
+import { type TerminalInteractionAgent, type TerminalInteractionResponseAuthority, type TerminalInteractionSubject, type TerminalInteractionSubjectProjection } from "./terminal-interaction-protocol.js";
+export declare const TERMINAL_INTERACTION_AGGREGATE_SCHEMA: "agent-knock-knock/terminal-interaction-aggregate";
+export declare const TERMINAL_INTERACTION_AGGREGATE_VERSION: 1;
+export declare const TERMINAL_INTERACTION_AGGREGATE_STATES: readonly ["pending", "reserved", "consumed", "response_uncertain", "superseded"];
+export type TerminalInteractionAggregateState = typeof TERMINAL_INTERACTION_AGGREGATE_STATES[number];
+export interface TerminalInteractionReservation {
+    readonly attempt_id: string;
+    readonly response_hash: string;
+    readonly reserved_at: string;
+}
+export interface TerminalInteractionResolution {
+    readonly resolved_at: string;
+    /** Bounded machine code only; never persist raw screen/error/answer text. */
+    readonly reason_code: string;
+}
+export interface TerminalInteractionAggregate {
+    readonly schema: typeof TERMINAL_INTERACTION_AGGREGATE_SCHEMA;
+    readonly version: typeof TERMINAL_INTERACTION_AGGREGATE_VERSION;
+    readonly subject: TerminalInteractionSubject;
+    readonly interaction_id: string;
+    readonly surface_id: string;
+    readonly prompt_fingerprint: string;
+    readonly response_authority: TerminalInteractionResponseAuthority;
+    readonly current_step: number;
+    readonly state: TerminalInteractionAggregateState;
+    readonly created_at: string;
+    readonly expires_at: string;
+    readonly reservation?: TerminalInteractionReservation;
+    readonly resolution?: TerminalInteractionResolution;
+}
+export type TerminalInteractionAggregateEvent = {
+    /** Exact live recapture proved the same pending native surface. */
+    readonly type: "refresh";
+    readonly expires_at: string;
+    readonly response_authority: TerminalInteractionResponseAuthority;
+} | {
+    readonly type: "reserve";
+    readonly attempt_id: string;
+    readonly response_hash: string;
+    readonly at: string;
+} | {
+    /** Exact proof that reservation completed but no terminal input began. */
+    readonly type: "release";
+} | {
+    readonly type: "consume";
+    readonly at: string;
+    readonly reason_code: string;
+} | {
+    readonly type: "response_uncertain";
+    readonly at: string;
+    readonly reason_code: string;
+} | {
+    readonly type: "supersede";
+    readonly at: string;
+    readonly reason_code: string;
+};
+export declare class TerminalInteractionTransitionError extends Error {
+    constructor(message: string);
+}
+export interface BuildTerminalInteractionOfferInput {
+    readonly subject: TerminalInteractionSubject;
+    readonly agent: TerminalInteractionAgent;
+    readonly agentVersion: string;
+    /** Canonical endpoint/process incarnation data. It is hashed, never emitted. */
+    readonly canonicalTerminalIdentity: unknown;
+    /** Exact accepted native task/thread/rollout identity. It is hashed, never emitted. */
+    readonly nativeTaskIdentity: unknown;
+    readonly inspection: NativeQuestionnaireInspection;
+    readonly now: Date;
+    readonly expiresAt?: string;
+    readonly ttlMs?: number;
+    readonly responseUncertain?: boolean;
+    readonly responseAuthority: TerminalInteractionResponseAuthority;
+    /** Managed v1 clients may temporarily require the legacy top-level alias. */
+    readonly includeLegacyTurnId?: boolean;
+}
+export interface TerminalInteractionCoreOffer {
+    readonly projection: TerminalInteractionSubjectProjection;
+    readonly promptFingerprint: string;
+    readonly surfaceId: string;
+    /** Owner-private: never copy this field into callbacks or public Status. */
+    readonly actionPlan: NativeQuestionnaireActionPlan;
+    readonly nativeInspection: Exclude<NativeQuestionnaireInspection, {
+        readonly status: "none";
+    }>;
+}
+export interface CaptureTerminalInteractionInput extends Omit<BuildTerminalInteractionOfferInput, "inspection"> {
+    readonly screen: string;
+    readonly secret?: boolean;
+}
+/**
+ * Pure, subject-neutral offer builder. Monitor and Watch pass the same native
+ * inspection through this function and therefore share semantic ids,
+ * cross-source `surface_id`, public redaction, and executable/manual policy.
+ */
+export declare function buildTerminalInteractionOffer(input: BuildTerminalInteractionOfferInput): TerminalInteractionCoreOffer | undefined;
+/** Convenience capture entry point; the parser remains single-source. */
+export declare function captureTerminalInteraction(input: CaptureTerminalInteractionInput): TerminalInteractionCoreOffer | undefined;
+export declare function createTerminalInteractionAggregate(projectionValue: unknown, createdAt: string): TerminalInteractionAggregate;
+export declare function hashTerminalInteractionResponse(value: unknown): string;
+export declare function reduceTerminalInteractionAggregate(currentValue: unknown, event: TerminalInteractionAggregateEvent): TerminalInteractionAggregate;
+export declare function validateTerminalInteractionAggregate(value: unknown): TerminalInteractionAggregate;
+export declare function aggregateMatchesProjection(aggregateValue: unknown, projectionValue: unknown): boolean;

package/dist/src/terminal-interaction-core.js

@@ -0,0 +1,407 @@
+import { createHash } from "node:crypto";
+import { inspectNativeQuestionnaire } from "./terminal-questionnaire-adapter.js";
+import { TERMINAL_INTERACTION_SCHEMA, TERMINAL_INTERACTION_SUBJECT_VERSION, sameTerminalInteractionSubject, terminalInteractionSubjectKey, validateTerminalInteractionSubject, validateTerminalInteractionSubjectProjection } from "./terminal-interaction-protocol.js";
+import { isRecord } from "./value-guards.js";
+export const TERMINAL_INTERACTION_AGGREGATE_SCHEMA = "agent-knock-knock/terminal-interaction-aggregate";
+export const TERMINAL_INTERACTION_AGGREGATE_VERSION = 1;
+export const TERMINAL_INTERACTION_AGGREGATE_STATES = [
+    "pending",
+    "reserved",
+    "consumed",
+    "response_uncertain",
+    "superseded"
+];
+export class TerminalInteractionTransitionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TerminalInteractionTransitionError";
+    }
+}
+function canonicalJson(value) {
+    if (value === null || typeof value !== "object") {
+        const serialized = JSON.stringify(value);
+        return serialized === undefined ? "null" : serialized;
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJson).join(",")}]`;
+    }
+    return `{${Object.entries(value)
+        .filter(([, item]) => item !== undefined)
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([key, item]) => `${JSON.stringify(key)}:${canonicalJson(item)}`)
+        .join(",")}}`;
+}
+function sha256(namespace, value) {
+    return createHash("sha256")
+        .update(`${namespace}\0${canonicalJson(value)}`, "utf8")
+        .digest("hex");
+}
+function terminalInteractionQuestion(question) {
+    const common = {
+        question_id: question.question_id,
+        prompt: question.prompt,
+        required: question.required
+    };
+    if (question.response_kind === "single_select" ||
+        question.response_kind === "multi_select") {
+        return {
+            ...common,
+            response_kind: question.response_kind,
+            options: question.options ?? []
+        };
+    }
+    return { ...common, response_kind: question.response_kind };
+}
+function offerExpiry(input) {
+    if (input.expiresAt !== undefined) {
+        return input.expiresAt;
+    }
+    const ttlMs = input.ttlMs ?? 60_000;
+    if (!Number.isSafeInteger(ttlMs) || ttlMs < 1) {
+        throw new TypeError("terminal interaction ttlMs must be a positive integer");
+    }
+    return new Date(input.now.getTime() + ttlMs).toISOString();
+}
+/**
+ * Pure, subject-neutral offer builder. Monitor and Watch pass the same native
+ * inspection through this function and therefore share semantic ids,
+ * cross-source `surface_id`, public redaction, and executable/manual policy.
+ */
+export function buildTerminalInteractionOffer(input) {
+    if (input.inspection.status === "none") {
+        return undefined;
+    }
+    if (input.inspection.agent !== input.agent) {
+        throw new TypeError("native questionnaire agent does not match offer agent");
+    }
+    const subject = validateTerminalInteractionSubject(input.subject);
+    // Native exact regions include cursor/highlight state. Public identity must
+    // stay stable when the user or TUI merely moves the selection within the
+    // same semantic question; exact action plans are still recaptured three
+    // times immediately around dispatch.
+    const promptFingerprint = sha256("terminal-interaction-prompt", {
+        profile: input.inspection.profile,
+        current_step: input.inspection.current_step,
+        total_steps: input.inspection.total_steps,
+        question: input.inspection.question
+    });
+    const surfaceMaterial = {
+        version: 1,
+        agent: input.agent,
+        agent_version: input.agentVersion,
+        terminal: input.canonicalTerminalIdentity,
+        native_task: input.nativeTaskIdentity,
+        profile: input.inspection.profile,
+        prompt_sha256: promptFingerprint
+    };
+    const surfaceId = `tis_${sha256("terminal-interaction-surface", surfaceMaterial).slice(0, 40)}`;
+    const interactionId = `ti_${sha256("terminal-interaction-subject", {
+        subject: terminalInteractionSubjectKey(subject),
+        subject_evidence: subject,
+        surface_id: surfaceId
+    }).slice(0, 40)}`;
+    const actionPlan = input.inspection.action_plan;
+    const nativeExecutable = input.inspection.status === "actionable" &&
+        actionPlan.kind !== "manual_only";
+    const responseAuthority = nativeExecutable
+        ? input.responseAuthority
+        : "notify_only";
+    const responseUncertain = input.responseUncertain === true;
+    const state = responseUncertain
+        ? "response_uncertain"
+        : nativeExecutable
+            ? "pending"
+            : "manual_required";
+    const question = terminalInteractionQuestion(input.inspection.question);
+    const common = {
+        schema: TERMINAL_INTERACTION_SCHEMA,
+        version: TERMINAL_INTERACTION_SUBJECT_VERSION,
+        interaction_id: interactionId,
+        subject,
+        agent: input.agent,
+        kind: "questionnaire",
+        state,
+        step: {
+            index: input.inspection.current_step,
+            total: input.inspection.total_steps
+        },
+        questions: [question],
+        expires_at: offerExpiry(input),
+        surface_id: surfaceId,
+        prompt_fingerprint: promptFingerprint,
+        response_authority: responseAuthority,
+        capabilities: {
+            respond: nativeExecutable &&
+                responseAuthority === "executable" &&
+                !responseUncertain,
+            batch_response: false,
+            free_text: question.response_kind === "free_text",
+            multi_select: question.response_kind === "multi_select"
+        }
+    };
+    const projection = validateTerminalInteractionSubjectProjection(subject.kind === "managed_turn" && input.includeLegacyTurnId !== false
+        ? { ...common, subject, turn_id: subject.turn_id }
+        : { ...common, subject });
+    return {
+        projection,
+        promptFingerprint,
+        surfaceId,
+        actionPlan,
+        nativeInspection: input.inspection
+    };
+}
+/** Convenience capture entry point; the parser remains single-source. */
+export function captureTerminalInteraction(input) {
+    return buildTerminalInteractionOffer({
+        ...input,
+        inspection: inspectNativeQuestionnaire({
+            agent: input.agent,
+            version: input.agentVersion,
+            screen: input.screen,
+            secret: input.secret
+        })
+    });
+}
+export function createTerminalInteractionAggregate(projectionValue, createdAt) {
+    const projection = validateTerminalInteractionSubjectProjection(projectionValue);
+    if (projection.state === "response_uncertain") {
+        throw new TerminalInteractionTransitionError("response-uncertain projection requires its existing durable reservation");
+    }
+    return validateTerminalInteractionAggregate({
+        schema: TERMINAL_INTERACTION_AGGREGATE_SCHEMA,
+        version: TERMINAL_INTERACTION_AGGREGATE_VERSION,
+        subject: projection.subject,
+        interaction_id: projection.interaction_id,
+        surface_id: projection.surface_id,
+        prompt_fingerprint: projection.prompt_fingerprint,
+        response_authority: projection.response_authority,
+        current_step: projection.step.index,
+        state: "pending",
+        created_at: createdAt,
+        expires_at: projection.expires_at
+    });
+}
+export function hashTerminalInteractionResponse(value) {
+    return sha256("terminal-interaction-response", value);
+}
+export function reduceTerminalInteractionAggregate(currentValue, event) {
+    const current = validateTerminalInteractionAggregate(currentValue);
+    let next;
+    switch (event.type) {
+        case "refresh":
+            if (current.state !== "pending") {
+                throw transitionError(current.state, event.type);
+            }
+            if (!Number.isFinite(Date.parse(event.expires_at)) ||
+                Date.parse(event.expires_at) < Date.parse(current.expires_at)) {
+                throw new TerminalInteractionTransitionError("terminal interaction refresh cannot shorten expires_at");
+            }
+            next = {
+                ...current,
+                expires_at: event.expires_at,
+                response_authority: event.response_authority
+            };
+            break;
+        case "reserve":
+            if (current.state !== "pending") {
+                throw transitionError(current.state, event.type);
+            }
+            if (current.response_authority !== "executable") {
+                throw new TerminalInteractionTransitionError("notify-only interaction cannot reserve terminal response authority");
+            }
+            next = {
+                ...current,
+                state: "reserved",
+                reservation: {
+                    attempt_id: event.attempt_id,
+                    response_hash: event.response_hash,
+                    reserved_at: event.at
+                }
+            };
+            break;
+        case "release":
+            if (current.state !== "reserved") {
+                throw transitionError(current.state, event.type);
+            }
+            next = {
+                ...current,
+                state: "pending",
+                reservation: undefined
+            };
+            break;
+        case "consume":
+            if (current.state !== "reserved") {
+                throw transitionError(current.state, event.type);
+            }
+            next = {
+                ...current,
+                state: "consumed",
+                resolution: {
+                    resolved_at: event.at,
+                    reason_code: event.reason_code
+                }
+            };
+            break;
+        case "response_uncertain":
+            if (current.state !== "reserved") {
+                throw transitionError(current.state, event.type);
+            }
+            next = {
+                ...current,
+                state: "response_uncertain",
+                resolution: {
+                    resolved_at: event.at,
+                    reason_code: event.reason_code
+                }
+            };
+            break;
+        case "supersede":
+            if (current.state !== "pending") {
+                throw transitionError(current.state, event.type);
+            }
+            next = {
+                ...current,
+                state: "superseded",
+                resolution: {
+                    resolved_at: event.at,
+                    reason_code: event.reason_code
+                }
+            };
+            break;
+    }
+    return validateTerminalInteractionAggregate(next);
+}
+function transitionError(state, event) {
+    return new TerminalInteractionTransitionError(`terminal interaction cannot transition from ${state} via ${event}`);
+}
+function aggregateString(value, field, pattern) {
+    if (typeof value !== "string" || value.length < 1 || value.length > 4_096) {
+        throw new TypeError(`${field} must be a bounded non-empty string`);
+    }
+    if (pattern && !pattern.test(value)) {
+        throw new TypeError(`${field} has an invalid format`);
+    }
+    return value;
+}
+function aggregateTimestamp(value, field) {
+    const timestamp = aggregateString(value, field);
+    if (!Number.isFinite(Date.parse(timestamp))) {
+        throw new TypeError(`${field} must be an ISO-compatible timestamp`);
+    }
+    return timestamp;
+}
+function aggregateRecord(value, field, keys) {
+    if (!isRecord(value)) {
+        throw new TypeError(`${field} must be an object`);
+    }
+    for (const key of Object.keys(value)) {
+        if (!keys.includes(key)) {
+            throw new TypeError(`${field}.${key} is not allowed`);
+        }
+    }
+    return value;
+}
+export function validateTerminalInteractionAggregate(value) {
+    const record = aggregateRecord(value, "$aggregate", [
+        "schema",
+        "version",
+        "subject",
+        "interaction_id",
+        "surface_id",
+        "prompt_fingerprint",
+        "response_authority",
+        "current_step",
+        "state",
+        "created_at",
+        "expires_at",
+        "reservation",
+        "resolution"
+    ]);
+    if (record.schema !== TERMINAL_INTERACTION_AGGREGATE_SCHEMA) {
+        throw new TypeError("$aggregate.schema is invalid");
+    }
+    if (record.version !== TERMINAL_INTERACTION_AGGREGATE_VERSION) {
+        throw new TypeError("$aggregate.version is invalid");
+    }
+    const subject = validateTerminalInteractionSubject(record.subject, "$aggregate.subject");
+    const state = aggregateString(record.state, "$aggregate.state");
+    if (!TERMINAL_INTERACTION_AGGREGATE_STATES.includes(state)) {
+        throw new TypeError("$aggregate.state is invalid");
+    }
+    const responseAuthority = aggregateString(record.response_authority, "$aggregate.response_authority");
+    if (responseAuthority !== "executable" && responseAuthority !== "notify_only") {
+        throw new TypeError("$aggregate.response_authority is invalid");
+    }
+    if (!Number.isSafeInteger(record.current_step) || Number(record.current_step) < 1) {
+        throw new TypeError("$aggregate.current_step must be a positive integer");
+    }
+    let reservation;
+    if (record.reservation !== undefined) {
+        const item = aggregateRecord(record.reservation, "$aggregate.reservation", [
+            "attempt_id",
+            "response_hash",
+            "reserved_at"
+        ]);
+        reservation = {
+            attempt_id: aggregateString(item.attempt_id, "$aggregate.reservation.attempt_id"),
+            response_hash: aggregateString(item.response_hash, "$aggregate.reservation.response_hash", /^[0-9a-f]{64}$/u),
+            reserved_at: aggregateTimestamp(item.reserved_at, "$aggregate.reservation.reserved_at")
+        };
+    }
+    let resolution;
+    if (record.resolution !== undefined) {
+        const item = aggregateRecord(record.resolution, "$aggregate.resolution", [
+            "resolved_at",
+            "reason_code"
+        ]);
+        resolution = {
+            resolved_at: aggregateTimestamp(item.resolved_at, "$aggregate.resolution.resolved_at"),
+            reason_code: aggregateString(item.reason_code, "$aggregate.resolution.reason_code", /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u)
+        };
+    }
+    if ((state === "reserved" || state === "consumed" ||
+        state === "response_uncertain") &&
+        !reservation) {
+        throw new TypeError(`$aggregate.reservation is required for ${state}`);
+    }
+    if ((state === "consumed" || state === "response_uncertain" ||
+        state === "superseded") && !resolution) {
+        throw new TypeError(`$aggregate.resolution is required for ${state}`);
+    }
+    if (state === "pending" && (reservation || resolution)) {
+        throw new TypeError("pending aggregate cannot have reservation or resolution");
+    }
+    if (state === "reserved" && resolution) {
+        throw new TypeError("reserved aggregate cannot have a resolution");
+    }
+    if (state === "superseded" && reservation) {
+        throw new TypeError("superseded aggregate cannot have a reservation");
+    }
+    return {
+        schema: TERMINAL_INTERACTION_AGGREGATE_SCHEMA,
+        version: TERMINAL_INTERACTION_AGGREGATE_VERSION,
+        subject,
+        interaction_id: aggregateString(record.interaction_id, "$aggregate.interaction_id"),
+        surface_id: aggregateString(record.surface_id, "$aggregate.surface_id"),
+        prompt_fingerprint: aggregateString(record.prompt_fingerprint, "$aggregate.prompt_fingerprint", /^[0-9a-f]{64}$/u),
+        response_authority: responseAuthority,
+        current_step: Number(record.current_step),
+        state,
+        created_at: aggregateTimestamp(record.created_at, "$aggregate.created_at"),
+        expires_at: aggregateTimestamp(record.expires_at, "$aggregate.expires_at"),
+        ...(reservation ? { reservation } : {}),
+        ...(resolution ? { resolution } : {})
+    };
+}
+export function aggregateMatchesProjection(aggregateValue, projectionValue) {
+    const aggregate = validateTerminalInteractionAggregate(aggregateValue);
+    const projection = validateTerminalInteractionSubjectProjection(projectionValue);
+    return sameTerminalInteractionSubject(aggregate.subject, projection.subject) &&
+        aggregate.interaction_id === projection.interaction_id &&
+        aggregate.surface_id === projection.surface_id &&
+        aggregate.prompt_fingerprint === projection.prompt_fingerprint &&
+        aggregate.response_authority === projection.response_authority &&
+        aggregate.current_step === projection.step.index &&
+        aggregate.expires_at === projection.expires_at;
+}
+//# sourceMappingURL=terminal-interaction-core.js.map

package/dist/src/terminal-interaction-core.js.map

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

package/dist/src/terminal-interaction-protocol.d.ts

@@ -1,9 +1,17 @@
 export declare const TERMINAL_INTERACTION_SCHEMA: "agent-knock-knock/terminal-interaction";
 export declare const TERMINAL_INTERACTION_VERSION: 1;
+/**
+ * Version 2 makes the interaction owner explicit. Version 1 remains readable
+ * for durable managed-Turn records written by releases before Watch response
+ * authority existed.
+ */
+export declare const TERMINAL_INTERACTION_SUBJECT_VERSION: 2;
 export declare const TERMINAL_INTERACTION_KINDS: readonly ["questionnaire"];
 export declare const TERMINAL_INTERACTION_STATES: readonly ["pending", "manual_required", "response_uncertain"];
 export declare const TERMINAL_INTERACTION_RESPONSE_KINDS: readonly ["single_select", "multi_select", "free_text", "confirm"];
 export declare const TERMINAL_INTERACTION_AGENTS: readonly ["codex", "claude"];
+export declare const TERMINAL_INTERACTION_SUBJECT_KINDS: readonly ["managed_turn", "terminal_watch"];
+export declare const TERMINAL_INTERACTION_RESPONSE_AUTHORITIES: readonly ["executable", "notify_only"];
 export declare const TERMINAL_INTERACTION_LIMITS: Readonly<{
     maxProjectionBytes: number;
     /** A projection is deliberately one native step, never a batch of keys. */
@@ -24,6 +32,21 @@ export type TerminalInteractionKind = typeof TERMINAL_INTERACTION_KINDS[number];
 export type TerminalInteractionState = typeof TERMINAL_INTERACTION_STATES[number];
 export type TerminalInteractionResponseKind = typeof TERMINAL_INTERACTION_RESPONSE_KINDS[number];
 export type TerminalInteractionAgent = typeof TERMINAL_INTERACTION_AGENTS[number];
+export type TerminalInteractionSubjectKind = typeof TERMINAL_INTERACTION_SUBJECT_KINDS[number];
+export type TerminalInteractionResponseAuthority = typeof TERMINAL_INTERACTION_RESPONSE_AUTHORITIES[number];
+export interface TerminalInteractionManagedTurnSubject {
+    readonly kind: "managed_turn";
+    readonly turn_id: string;
+    /** The exact controller message that established managed ownership. */
+    readonly message_id: string;
+}
+export interface TerminalInteractionTerminalWatchSubject {
+    readonly kind: "terminal_watch";
+    readonly watch_id: string;
+    /** Hash of the exact task/acceptance anchor; never raw terminal content. */
+    readonly anchor_fingerprint: string;
+}
+export type TerminalInteractionSubject = TerminalInteractionManagedTurnSubject | TerminalInteractionTerminalWatchSubject;
 export interface TerminalInteractionOption {
     readonly option_id: string;
     readonly label: string;
@@ -73,6 +96,45 @@ export interface TerminalInteractionProjection {
         readonly multi_select: boolean;
     };
 }
+/**
+ * Subject-aware public projection. `subject` is authoritative. `turn_id` is a
+ * deprecated managed-Turn compatibility alias and is forbidden for Watch
+ * subjects, so Watch integrations never invent a fake Turn.
+ */
+export type TerminalInteractionSubjectProjection = {
+    readonly schema: typeof TERMINAL_INTERACTION_SCHEMA;
+    readonly version: typeof TERMINAL_INTERACTION_SUBJECT_VERSION;
+    readonly interaction_id: string;
+    readonly subject: TerminalInteractionSubject;
+    readonly agent: TerminalInteractionAgent;
+    readonly kind: TerminalInteractionKind;
+    readonly state: TerminalInteractionState;
+    readonly step: {
+        readonly index: number;
+        readonly total: number;
+    };
+    readonly questions: readonly TerminalInteractionQuestion[];
+    readonly expires_at: string;
+    /** Stable across monitor/Watch observation of the same native surface. */
+    readonly surface_id: string;
+    /** SHA-256 of the normalized native prompt, never raw terminal content. */
+    readonly prompt_fingerprint: string;
+    readonly response_authority: TerminalInteractionResponseAuthority;
+    readonly capabilities: {
+        readonly respond: boolean;
+        readonly batch_response: boolean;
+        readonly free_text: boolean;
+        readonly multi_select: boolean;
+    };
+} & ({
+    readonly subject: TerminalInteractionManagedTurnSubject;
+    /** @deprecated Read `subject.turn_id`; retained for managed v1 clients. */
+    readonly turn_id?: string;
+} | {
+    readonly subject: TerminalInteractionTerminalWatchSubject;
+    readonly turn_id?: never;
+});
+export type TerminalInteractionAnyProjection = TerminalInteractionProjection | TerminalInteractionSubjectProjection;
 interface TerminalInteractionAnswerBase {
     readonly question_id: string;
 }
@@ -98,13 +160,32 @@ export interface TerminalInteractionResponse {
     readonly turn_id: string;
     readonly answers: readonly TerminalInteractionAnswer[];
 }
+export type TerminalInteractionSubjectResponse = {
+    readonly interaction_id: string;
+    readonly subject: TerminalInteractionSubject;
+    readonly answers: readonly TerminalInteractionAnswer[];
+} & ({
+    readonly subject: TerminalInteractionManagedTurnSubject;
+    /** @deprecated Optional compatibility assertion for managed clients. */
+    readonly turn_id?: string;
+} | {
+    readonly subject: TerminalInteractionTerminalWatchSubject;
+    readonly turn_id?: never;
+});
+export type TerminalInteractionAnyResponse = TerminalInteractionResponse | TerminalInteractionSubjectResponse;
 export type TerminalInteractionValidationCode = "invalid_type" | "invalid_value" | "unknown_field" | "limit_exceeded" | "duplicate_id" | "secret_not_allowed" | "control_character" | "interaction_mismatch" | "response_not_allowed" | "answer_kind_mismatch" | "unknown_question" | "unknown_option" | "missing_answer" | "expired";
 export declare class TerminalInteractionValidationError extends Error {
     readonly code: TerminalInteractionValidationCode;
     readonly path: string;
     constructor(code: TerminalInteractionValidationCode, path: string, message: string);
 }
+export declare function validateTerminalInteractionSubject(value: unknown, path?: string): TerminalInteractionSubject;
+export declare function terminalInteractionSubjectId(subject: TerminalInteractionSubject): string;
+export declare function terminalInteractionSubjectKey(subject: TerminalInteractionSubject): string;
+export declare function sameTerminalInteractionSubject(left: TerminalInteractionSubject, right: TerminalInteractionSubject): boolean;
 export declare function validateTerminalInteractionProjection(value: unknown): TerminalInteractionProjection;
+export declare function validateTerminalInteractionSubjectProjection(value: unknown): TerminalInteractionSubjectProjection;
+export declare function validateAnyTerminalInteractionProjection(value: unknown): TerminalInteractionAnyProjection;
 export declare function validateTerminalInteractionResponse(value: unknown, authoritativeStoredProjection: unknown, options?: {
     now?: Date;
     /**
@@ -114,4 +195,12 @@ export declare function validateTerminalInteractionResponse(value: unknown, auth
      */
     allowExpiredForLiveRecapture?: boolean;
 }): TerminalInteractionResponse;
+export declare function validateTerminalInteractionSubjectResponse(value: unknown, authoritativeStoredProjection: unknown, options?: {
+    now?: Date;
+    allowExpiredForLiveRecapture?: boolean;
+}): TerminalInteractionSubjectResponse;
+export declare function validateAnyTerminalInteractionResponse(value: unknown, authoritativeStoredProjection: unknown, options?: {
+    now?: Date;
+    allowExpiredForLiveRecapture?: boolean;
+}): TerminalInteractionAnyResponse;
 export {};