@scotthuang/agent-knock-knock 0.13.16 → 0.13.18

package/dist/src/terminal-model-control-subject.js

@@ -1,3 +1,5 @@
+import { createHash } from "node:crypto";
+import { terminalPhysicalBindingToken } from "./terminal-control-ref.js";
 import { terminalModelControlProfileFor } from "./terminal-model-control-profile.js";
 import { hasCanonicalTerminalEndpoint, terminalEndpointFromControlRef, terminalEndpointIdentityKey } from "./terminal-control-ref.js";
 /**
@@ -55,4 +57,75 @@ function nonBlank(value) {
         ? value.trim()
         : undefined;
 }
+/**
+ * One action-specific physical authority token for fresh Codex model control.
+ * The domain separator and exact profile keep this authority from being reused
+ * as Send or native-lifecycle authority even though all bind the same pane.
+ */
+export function terminalUserExplicitModelControlBindingToken(value) {
+    const subject = requiredModelControlSubject({
+        ...value,
+        agent: "codex"
+    });
+    const physicalTerminalToken = terminalPhysicalBindingToken({
+        terminalId: subject.terminalId,
+        terminalControl: subject.terminalControl,
+        agent: "codex",
+        pid: subject.pid,
+        workspace: subject.workspace,
+        processUuid: subject.processUuid,
+        processBirth: subject.processBirth
+    });
+    return createHash("sha256")
+        .update(JSON.stringify({
+        version: 1,
+        authority: "terminal_user_explicit_model_control",
+        physical_terminal_token: physicalTerminalToken,
+        agent_version: subject.agentVersion,
+        behavior_profile: subject.behaviorProfile
+    }))
+        .digest("hex");
+}
+function requiredModelControlSubject(input) {
+    const subject = canonicalModelControlSubject(input);
+    if (!subject) {
+        throw new Error("model-control authority requires one canonical supported terminal subject");
+    }
+    return subject;
+}
+/**
+ * Snapshot authority for adopting and cleaning one exact native `/model`
+ * residual. The residual kind and normalized surface digest prevent a token
+ * for one popup, pane generation, or bare Composer from authorizing another.
+ */
+export function terminalUserExplicitModelControlRepairBindingToken(value) {
+    const modelControlToken = terminalUserExplicitModelControlBindingToken(value);
+    return createHash("sha256")
+        .update(JSON.stringify({
+        version: 1,
+        authority: "terminal_user_explicit_model_control_repair",
+        model_control_token: modelControlToken,
+        residual_kind: value.residualKind,
+        residual_fingerprint: value.residualFingerprint
+    }))
+        .digest("hex");
+}
+/**
+ * Snapshot authority for continuing one exact native `/model` residual into
+ * the read-only catalog picker. This is deliberately domain-separated from
+ * cleanup-only repair: a repair offer never authorizes Enter, while this
+ * offer authorizes exactly one profiled slash-command dispatch.
+ */
+export function terminalUserExplicitModelControlResidualEntryBindingToken(value) {
+    const modelControlToken = terminalUserExplicitModelControlBindingToken(value);
+    return createHash("sha256")
+        .update(JSON.stringify({
+        version: 1,
+        authority: "terminal_user_explicit_model_control_residual_entry",
+        model_control_token: modelControlToken,
+        residual_kind: value.residualKind,
+        residual_fingerprint: value.residualFingerprint
+    }))
+        .digest("hex");
+}
 //# sourceMappingURL=terminal-model-control-subject.js.map

package/dist/src/terminal-model-control-subject.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-model-control-subject.js","sourceRoot":"","sources":["../../src/terminal-model-control-subject.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,EAE/B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,EAC9B,2BAA2B,EAE5B,MAAM,2BAA2B,CAAC;AA6BnC;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAAuC;IAEvC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACtB,IACE,CAAC,UAAU;QACX,CAAC,eAAe;QAChB,CAAC,KAAK,CAAC,KAAK;QACZ,CAAC,SAAS;QACV,CAAC,WAAW;QACZ,CAAC,YAAY;QACb,CAAC,YAAY;QACb,CAAC,eAAe;QAChB,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QAChB,CAAC,4BAA4B,CAAC,eAAe,CAAC,EAC9C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,8BAA8B,CAAC,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC1E,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,eAAe,KAAK,eAAe,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,8BAA8B,CAAC,eAAe,CAAC,CAAC;IACjE,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAChD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,EACtC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU;QACV,eAAe;QACf,wBAAwB,EAAE,2BAA2B,CAAC,QAAQ,CAAC;QAC/D,wBAAwB,EAAE,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAC3D,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;QAChB,SAAS;QACT,WAAW;QACX,YAAY;QACZ,YAAY;QACZ,eAAe,EAAE,OAAO,CAAC,eAAe;KACzC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE;QACd,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}
+{"version":3,"file":"terminal-model-control-subject.js","sourceRoot":"","sources":["../../src/terminal-model-control-subject.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,82 @@
+export { probeTerminalModelControl, planTerminalModelControl } from "./terminal-model-control-profile.js";
+import { type TerminalModelControlPlan } from "./terminal-model-control-profile.js";
+import type { TerminalModelReasoningEffort, TerminalModelNativeEffort, TerminalModelValue, TerminalModelSwitchRequest, CodexNativeModelCatalog, ModelRow, EffortRow, TerminalModelControlObservation, TerminalModelControlCapture, ExactTerminalModelControlObservation, TerminalModelControlSurface } from "./terminal-model-control-contract.js";
+/** Pure native surfaces and semantic navigation; this module never performs input. */
+export declare function parseCodexNativeModelCatalog(value: unknown): CodexNativeModelCatalog;
+export declare function observeCodexIdleModel(screen: string, plan?: TerminalModelControlPlan): (TerminalModelValue & {
+    readonly planMode: boolean;
+}) | undefined;
+/**
+ * Observe only complete, current model-control modal frames. Historical or
+ * partial picker text is never sufficient to authorize a key dispatch.
+ */
+export declare function observeTerminalModelControl(plan: TerminalModelControlPlan, screen: string): TerminalModelControlObservation;
+export declare function modelControlMoveKeys(currentIndex: number, targetIndex: number): readonly string[];
+/** Adapter-owned native navigation; never serialize these keys to a caller. */
+export declare function modelControlSelectModelKeys(observation: Extract<TerminalModelControlObservation, {
+    state: "codex_model_picker" | "claude_model_picker";
+}>, model: string): readonly string[];
+export declare function selectedClaudeModelId(observation: Extract<TerminalModelControlObservation, {
+    state: "claude_model_picker";
+}>): string | undefined;
+export declare function codexModelControlSelectEffortKeys(observation: Extract<TerminalModelControlObservation, {
+    state: "codex_reasoning_picker" | "codex_advanced_reasoning_picker";
+}>, effort: TerminalModelReasoningEffort): readonly string[];
+export declare function codexModelControlAllModesKeys(observation: Extract<TerminalModelControlObservation, {
+    state: "codex_plan_scope_picker";
+}>): readonly string[];
+export declare function claudeModelControlEffortKey(direction: "lower" | "higher"): readonly ["Left" | "Right"];
+export declare function claudeModelControlCommitKeys(plan: TerminalModelControlPlan): readonly ["s"];
+export declare function isExactTerminalModelControlObservation(observation: TerminalModelControlObservation): observation is ExactTerminalModelControlObservation;
+/** Pure capture classifier. It never authorizes input by itself. */
+export declare function classifyTerminalModelControlSurface(plan: TerminalModelControlPlan, capture: TerminalModelControlCapture): TerminalModelControlSurface;
+export declare function modelControlHardBlock(capture: TerminalModelControlCapture): Extract<TerminalModelControlSurface, {
+    state: "blocked";
+}> | undefined;
+export declare function modelControlActivityBlock(capture: TerminalModelControlCapture): Extract<TerminalModelControlSurface, {
+    state: "blocked";
+}> | undefined;
+export declare function modelControlPickerKind(observation: ExactTerminalModelControlObservation): "model" | "effort" | "scope";
+export declare function classifyModelControlComposerSurface(capture: TerminalModelControlCapture, observation: TerminalModelControlObservation): TerminalModelControlSurface;
+export declare function modelControlCaptureBlocked(capture: TerminalModelControlCapture): boolean;
+export declare function observeCodexModelControl(screen: string, plan: TerminalModelControlPlan): TerminalModelControlObservation;
+export declare function observeClaudeModelControl(screen: string): TerminalModelControlObservation;
+export declare function codexSemanticModelLabel(label: string, fullscreen: boolean): string | undefined;
+export declare function parseCodexModelRows(region: readonly string[], fullscreen?: boolean): {
+    rows: readonly ModelRow[];
+    selectedIndex: number;
+    currentNativeIndex: number;
+    currentModel: string;
+} | undefined;
+export declare function parseCodexEntryModelPicker(region: readonly string[]): {
+    kind: "quick_auto" | "luna_reserve";
+    selectedIndex: number;
+    currentNativeIndex: number;
+    allModelsNativeIndex?: number;
+} | undefined;
+export declare function parseCodexEffortRows(region: readonly string[], advanced: boolean): {
+    rows: readonly EffortRow[];
+    selectedIndex: number;
+    currentEffort?: TerminalModelReasoningEffort;
+    presetDefaultEffort?: TerminalModelReasoningEffort;
+} | undefined;
+export declare function currentPickerRegion(lines: readonly string[], headerIndex: number, fullscreen?: boolean): readonly string[] | undefined;
+export declare function codexFullscreenEffortFooterMatches(region: readonly string[], selected: EffortRow): boolean;
+export declare function effortFromNativeLabel(label: string): TerminalModelReasoningEffort | undefined;
+export declare function claudeEffortFromNativeLabel(label: string): TerminalModelNativeEffort | undefined;
+export declare function claudeSemanticModelId(label: string): string | undefined;
+export declare function terminalTailLines(screen: string): readonly string[];
+export declare function lastIndex(lines: readonly string[], predicate: (line: string) => boolean): number;
+export declare function screenFingerprint(lines: readonly string[]): string;
+export declare function stripAnsi(value: string): string;
+export declare function isPlainRecord(value: unknown): value is Record<string, unknown>;
+export declare function nonBlank(value: unknown): string | undefined;
+export declare function codexPersistencePostcondition(beforeScreen: string, afterScreen: string, request: TerminalModelSwitchRequest): {
+    proven: true;
+} | {
+    proven: false;
+    final: boolean;
+    reason: string;
+};
+export declare function matchCount(value: string, pattern: RegExp): number;
+export declare function escapeRegExp(value: string): string;