@scotthuang/agent-knock-knock 0.12.10 → 0.12.12

package/dist/src/cli-command-runtime.js

@@ -0,0 +1,164 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { cliEnv, writeCliStdout } from "./cli-runtime-context.js";
+import { redactString } from "./runtime-log.js";
+import { isRecord } from "./value-guards.js";
+export function resolveExecutable(command) {
+    if (command.includes(path.sep)) {
+        return command;
+    }
+    for (const dir of executableSearchPaths()) {
+        const candidate = path.join(dir, command);
+        try {
+            fs.accessSync(candidate, fs.constants.X_OK);
+            return candidate;
+        }
+        catch {
+            // Continue searching PATH.
+        }
+    }
+    throw new Error(`executable not found on PATH: ${command}`);
+}
+function executableSearchPaths() {
+    const home = cliEnv().HOME;
+    return [
+        ...(cliEnv().PATH ?? "").split(path.delimiter).filter(Boolean),
+        ...(home ? [
+            path.join(home, ".npm-global", "bin"),
+            path.join(home, ".local", "bin")
+        ] : []),
+        "/opt/homebrew/bin",
+        "/usr/local/bin"
+    ];
+}
+export function resolveOptionalExecutable(command) {
+    try {
+        return resolveExecutable(command);
+    }
+    catch {
+        return command;
+    }
+}
+export function packageRootDir() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+}
+export function expandHome(filePath) {
+    const candidate = filePath;
+    return (candidate === "~" ? cliEnv().HOME
+        : candidate?.startsWith("~/") ? `${cliEnv().HOME}${candidate.slice(1)}`
+            : candidate);
+}
+export function positiveMilliseconds(value, optionName) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${optionName} must be a positive number`);
+    }
+    return Math.ceil(parsed);
+}
+export function positiveMinutes(value, optionName) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new Error(`${optionName} must be a positive number`);
+    }
+    return parsed;
+}
+export function required(value, message) {
+    if (value === undefined || value === "") {
+        throw new Error(message);
+    }
+    return value;
+}
+export function parseJsonOption(value, optionName) {
+    if (!value) {
+        return undefined;
+    }
+    try {
+        return JSON.parse(String(value));
+    }
+    catch (error) {
+        throw new Error(`${optionName} must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+export function canonicalWorkspace(value) {
+    const requested = path.resolve(String(required(value, "--workspace is required")));
+    let canonical;
+    let stat;
+    try {
+        canonical = fs.realpathSync(requested);
+        stat = fs.statSync(canonical);
+    }
+    catch {
+        throw new Error(`--workspace does not exist: ${requested}`);
+    }
+    if (!stat.isDirectory()) {
+        throw new Error(`--workspace must be a directory: ${requested}`);
+    }
+    return canonical;
+}
+export function matchesConfiguredWorkspace(configuredWorkspace, candidateWorkspace) {
+    if (configuredWorkspace === undefined) {
+        return true;
+    }
+    if (candidateWorkspace === undefined || candidateWorkspace === null) {
+        return false;
+    }
+    try {
+        return canonicalWorkspace(configuredWorkspace) ===
+            canonicalWorkspace(candidateWorkspace);
+    }
+    catch {
+        return false;
+    }
+}
+export function assertConfiguredWorkspace(configuredWorkspace, candidateWorkspace, subject) {
+    if (configuredWorkspace === undefined) {
+        return;
+    }
+    const configured = canonicalWorkspace(configuredWorkspace);
+    let candidate;
+    try {
+        candidate = canonicalWorkspace(candidateWorkspace);
+    }
+    catch {
+        throw new Error(`refusing ${subject}; its working directory cannot be verified against ` +
+            `expected workspace ${configured}`);
+    }
+    if (candidate !== configured) {
+        throw new Error(`refusing ${subject}; workspace ${candidate} does not match expected ` +
+            `workspace ${configured}`);
+    }
+}
+export function cleanProcessText(text) {
+    const value = String(text ?? "").trim();
+    return value ? value.slice(0, 2000) : undefined;
+}
+export function writeCliJson(value) {
+    writeCliStdout(`${JSON.stringify(redactCliOutput(value), null, 2)}\n`);
+}
+export function redactCliOutput(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => redactCliOutput(item));
+    }
+    if (isRecord(value)) {
+        return Object.fromEntries(Object.entries(value).flatMap(([key, item]) => {
+            if (key === "gateway_token" || key === "gatewayToken") {
+                return [];
+            }
+            if (key === "claude_transcript_anchor" ||
+                key === "claudeTranscriptAnchor" ||
+                key === "codex_rollout_acceptance_anchor" ||
+                key === "codexRolloutAcceptanceAnchor" ||
+                key === "claude_home" ||
+                key === "claudeHome") {
+                return [];
+            }
+            if ((key === "callback_command" || key === "callbackCommand") && typeof item === "string") {
+                return [[key, redactString(item)]];
+            }
+            return [[key, redactCliOutput(item)]];
+        }));
+    }
+    return value;
+}
+//# sourceMappingURL=cli-command-runtime.js.map

package/dist/src/cli-command-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-command-runtime.js","sourceRoot":"","sources":["../../src/cli-command-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,qBAAqB;IAC5B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC;IAC3B,OAAO;QACL,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC;YACrC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;SACjC,CAAC,CAAC,CAAC,EAAE,CAAC;QACP,mBAAmB;QACnB,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,IAAI,CAAC;QACH,OAAO,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,UAAU,CAAQ,QAAe;IAC/C,MAAM,SAAS,GAAG,QAAqC,CAAC;IACxD,OAAO,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI;QACvC,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACrE,CAAC,CAAC,SAAS,CAA0C,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,UAAkB;IACrE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,4BAA4B,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,UAAkB;IAChE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,GAAG,UAAU,4BAA4B,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,KAA+B,EAC/B,OAAe;IAEf,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,KAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,UAAkB;IAElB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,GAAG,UAAU,wBACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAC5C,KAAK,EACL,yBAAyB,CAC1B,CAAC,CAAC,CAAC;IACJ,IAAI,SAAiB,CAAC;IACtB,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,mBAA4B,EAC5B,kBAA2B;IAE3B,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,mBAAmB,CAAC;YAC5C,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,mBAA4B,EAC5B,kBAA2B,EAC3B,OAAe;IAEf,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO;IACT,CAAC;IACD,MAAM,UAAU,GAAG,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;IAC3D,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,qDAAqD;YACxE,sBAAsB,UAAU,EAAE,CACnC,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,YAAY,OAAO,eAAe,SAAS,2BAA2B;YACtE,aAAa,UAAU,EAAE,CAC1B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,cAAc,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YAC5C,IAAI,GAAG,KAAK,eAAe,IAAI,GAAG,KAAK,cAAc,EAAE,CAAC;gBACtD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,IACE,GAAG,KAAK,0BAA0B;gBAClC,GAAG,KAAK,wBAAwB;gBAChC,GAAG,KAAK,iCAAiC;gBACzC,GAAG,KAAK,8BAA8B;gBACtC,GAAG,KAAK,aAAa;gBACrB,GAAG,KAAK,YAAY,EACpB,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,IAAI,CAAC,GAAG,KAAK,kBAAkB,IAAI,GAAG,KAAK,iBAAiB,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1F,OAAO,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,CAAC,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/cli-core.d.ts

@@ -1,48 +1,10 @@
-import { type ClaudeAgentRow } from "./claude-terminal-agent-adapter.js";
-import { type CodexLocalSessionAdapter } from "./codex-local-session-provider.js";
-import type { CodingAgentSessionProvider } from "./agent-session-provider.js";
-import { type ExecutorKind } from "./executors.js";
-import { type TerminalControlProviderRegistry } from "./terminal-control-provider.js";
-import { type TerminalThreadLifecycleCandidateProvider } from "./terminal-agent-adapter.js";
-import { type TerminalProcessSource } from "./terminal-process-source.js";
-export type CliCommandOptions = Record<string, any>;
-/**
- * Process-level dependencies used by an imported CLI command execution.
- *
- * Every dependency is scoped to one async execution. This deliberately avoids
- * mutating process globals, so independent in-process tests can run in
- * parallel without sharing providers, output, environment, or clocks.
- */
-export interface CliCommandDependencies {
-    terminalControlProviderRegistry?: TerminalControlProviderRegistry;
-    terminalProcessSource?: TerminalProcessSource;
-    createAgentSessionProvider?: (agent: "codex", options: Readonly<CliCommandOptions>) => CodingAgentSessionProvider;
-    codexLocalSessionAdapter?: CodexLocalSessionAdapter | ((options: Readonly<CliCommandOptions>) => CodexLocalSessionAdapter);
-    codexThreadLifecycleProvider?: TerminalThreadLifecycleCandidateProvider;
-    loadClaudeAgentRows?: (options: Readonly<CliCommandOptions>, observation: {
-        required?: boolean;
-    }) => ClaudeAgentRow[];
-    agentVersionForRunningProcess?: (agent: ExecutorKind, pid: number, options: Readonly<CliCommandOptions>) => string | undefined;
-    codexProcessBirthForPid?: (pid: number) => string;
-    stdout?: (text: string) => void;
-    cwd?: string | (() => string);
-    env?: NodeJS.ProcessEnv;
-    pid?: number;
-    now?: () => Date | number;
-    /** Monotonic clock for terminal composer settling; production uses performance.now. */
-    monotonicNowMs?: () => number;
-    sleep?: (milliseconds: number) => Promise<void>;
-    sleepSync?: (milliseconds: number) => void;
-    exit?: (code: number) => never;
-    runtimeLog?: (level: "info" | "warn" | "error", event: string, fields: Record<string, unknown>) => void;
-}
+import { type CliCommandDependencies as RuntimeCliCommandDependencies, type CliCommandExecutionResult } from "./cli-runtime-context.js";
+export type { CliCommandExecutionResult };
+export type CliCommandOptions = Record<string, unknown>;
+export type CliCommandDependencies = RuntimeCliCommandDependencies<CliCommandOptions>;
 export interface ParsedCliCommand {
     command?: string;
     options: CliCommandOptions;
 }
-export interface CliCommandExecutionResult {
-    exitCode: number;
-    stdout: string;
-}
 export declare function parseCliCommand(argv: readonly string[]): ParsedCliCommand;
 export declare function executeCliCommand(commandName: string | undefined, options?: CliCommandOptions, dependencies?: CliCommandDependencies): Promise<CliCommandExecutionResult>;