@scotthuang/agent-knock-knock 0.13.3 → 0.13.4

package/dist/src/terminal-model-control.d.ts

@@ -1,26 +1,12 @@
 import type { ExecutorKind } from "./executors.js";
+import { type TerminalModelControlCapabilities, type TerminalModelControlPlan, type TerminalModelControlScope } from "./terminal-model-control-profile.js";
 import { type TerminalControlRef } from "./terminal-control-ref.js";
+export { CLAUDE_MODEL_CONTROL_AGENT_VERSION, CODEX_MODEL_CONTROL_AGENT_VERSION, TERMINAL_MODEL_CONTROL_PROFILE_IDS, isTerminalModelControlPlanForAgent, terminalModelControlPlanConforms, terminalModelControlProfileFor, terminalModelControlProfileForPlan, terminalModelControlProfiles, terminalModelControlSlashCompletionRows, type TerminalModelControlBehaviorProfile, type TerminalModelControlCapabilities, type TerminalModelControlPlan, type TerminalModelControlProfile, type TerminalModelControlScope } from "./terminal-model-control-profile.js";
+export { canonicalModelControlSubject, type CanonicalTerminalModelControlSubject, type TerminalModelControlSubjectInput } from "./terminal-model-control-subject.js";
 /** Caller-visible reasoning values. Native labels and menu positions stay private. */
 export declare const TERMINAL_MODEL_REASONING_EFFORTS: readonly ["low", "medium", "high", "xhigh", "max", "ultra"];
 export type TerminalModelReasoningEffort = typeof TERMINAL_MODEL_REASONING_EFFORTS[number];
 type TerminalModelNativeEffort = TerminalModelReasoningEffort | "ultracode";
-export type TerminalModelControlScope = "current_session" | "current_and_new_sessions";
-export interface TerminalModelControlCapabilities {
-    readonly status: "supported" | "unsupported" | "unknown";
-    readonly agentVersion?: string;
-    readonly behaviorProfile?: string;
-    readonly scope?: TerminalModelControlScope;
-    readonly modelSelection: boolean;
-    readonly reasoningEffortSelection: boolean;
-    readonly reason: string;
-}
-export interface TerminalModelControlPlan {
-    readonly behaviorProfile: "codex-model-control-0.154.0" | "claude-model-control-2.1.266";
-    readonly command: "/model";
-    readonly scope: TerminalModelControlScope;
-    readonly requiresIdle: true;
-    readonly requiresExactEmptyComposer: true;
-}
 export interface TerminalModelChoice {
     readonly id: string;
     readonly label: string;
@@ -241,6 +227,40 @@ export interface TerminalModelControlCapture {
     /** A questionnaire, editor, viewer, or other non-model input owner exists. */
     readonly inputBlocked?: boolean;
 }
+type ExactTerminalModelControlObservation = Exclude<TerminalModelControlObservation, {
+    state: "none" | "ambiguous";
+}>;
+/**
+ * One mutually exclusive semantic owner for the current model-control frame.
+ * Raw capture facts remain transport-private; policy code consumes this union
+ * so an exact profiled picker cannot simultaneously be treated as generic
+ * agent activity.
+ */
+export type TerminalModelControlSurface = {
+    readonly state: "idle_empty";
+} | {
+    readonly state: "command_popup";
+    readonly fingerprint?: string;
+} | {
+    readonly state: "bare_command";
+    readonly fingerprint?: string;
+} | {
+    /** Exact `/model` draft whose popup/bare shape is not profile-authorized. */
+    readonly state: "command_draft";
+    readonly fingerprint?: string;
+} | {
+    readonly state: "picker";
+    readonly pickerKind: "model" | "effort" | "scope";
+    readonly observation: ExactTerminalModelControlObservation;
+} | {
+    readonly state: "blocked";
+    readonly owner: "approval" | "input" | "agent";
+} | {
+    readonly state: "unknown";
+    readonly reason: string;
+};
+/** Pure capture classifier. It never authorizes input by itself. */
+export declare function classifyTerminalModelControlSurface(plan: TerminalModelControlPlan, capture: TerminalModelControlCapture): TerminalModelControlSurface;
 /** Runtime ports are implemented only by TerminalAgentBridge. */
 export interface TerminalModelControlPorts {
     /** Revalidate current-snapshot and Store authority before each input call. */
@@ -309,4 +329,3 @@ export declare function switchTerminalModel(input: {
 }): Promise<TerminalModelSwitchResult & {
     readonly terminalControl: unknown;
 }>;
-export {};