@scotthuang/agent-knock-knock 0.8.1 → 0.10.0

package/dist/src/codex-local-session-provider.d.ts

@@ -1,9 +1,10 @@
-import type { AgentSessionCapabilities, CodingAgentSessionProvider, ForkContextOptions } from "./agent-session-provider.js";
+import type { ActiveAgentSessionIdentity, AgentSessionCapabilities, CodingAgentSessionProvider, ForkContextOptions } from "./agent-session-provider.js";
 import { type ActiveCodexProcess, type CodexProcessSnapshot, type CodexSessionSummary, type CodexThreadRow, type ForkContextPackage } from "./codex-session-provider.js";
 export interface CodexLocalSessionAdapter {
     listThreadRows(): Promise<CodexThreadRow[]>;
     readRollout(path: string): Promise<string | undefined>;
     listProcessSnapshots(): Promise<CodexProcessSnapshot[]>;
+    resolveActiveSessionIdentityForPid?(pid: number, cwd?: string, preferredSessionId?: string, allowedCompanionIdentity?: ActiveAgentSessionIdentity, allowedAdditionalIdentities?: readonly ActiveAgentSessionIdentity[]): Promise<ActiveAgentSessionIdentity | undefined>;
 }
 export declare class CodexLocalSessionProvider implements CodingAgentSessionProvider {
     readonly agent: "codex";
@@ -12,6 +13,7 @@ export declare class CodexLocalSessionProvider implements CodingAgentSessionProv
     getCapabilities(): Promise<AgentSessionCapabilities>;
     listHistoricalSessions(): Promise<CodexSessionSummary[]>;
     listActiveSessions(): Promise<ActiveCodexProcess[]>;
+    resolveActiveSessionIdentityForPid(pid: number, cwd?: string, preferredSessionId?: string, allowedCompanionIdentity?: ActiveAgentSessionIdentity, allowedAdditionalIdentities?: readonly ActiveAgentSessionIdentity[]): Promise<ActiveAgentSessionIdentity | undefined>;
     getSession(sessionId: string): Promise<CodexSessionSummary | undefined>;
     getForkContext(options: ForkContextOptions): Promise<ForkContextPackage | undefined>;
 }

package/dist/src/codex-local-session-provider.js

@@ -44,6 +44,23 @@ export class CodexLocalSessionProvider {
         return discoverCodexProcesses(await this.adapter.listProcessSnapshots())
             .filter((process) => process.kind === "codex_cli");
     }
+    async resolveActiveSessionIdentityForPid(pid, cwd, preferredSessionId, allowedCompanionIdentity, allowedAdditionalIdentities) {
+        if (!Number.isSafeInteger(pid) || pid <= 1) {
+            throw new Error("Codex process pid must be a positive integer greater than 1");
+        }
+        if (this.adapter.resolveActiveSessionIdentityForPid) {
+            return this.adapter.resolveActiveSessionIdentityForPid(pid, cwd, preferredSessionId, allowedCompanionIdentity, allowedAdditionalIdentities);
+        }
+        const sessionId = (await this.listActiveSessions())
+            .find((process) => process.pid === pid)?.sessionId;
+        return sessionId
+            ? {
+                sessionId,
+                processUuid: `static-pid:${pid}`,
+                evidence: "process_command_session_id"
+            }
+            : undefined;
+    }
     async getSession(sessionId) {
         const sessions = await this.listHistoricalSessions();
         return sessions.find((session) => session.id === sessionId);

package/dist/src/codex-local-session-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex-local-session-provider.js","sourceRoot":"","sources":["../../src/codex-local-session-provider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codex-local-session-provider.js","sourceRoot":"","sources":["../../src/codex-local-session-provider.ts"],"names":[],"mappings":"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"}

package/dist/src/codex-store-adapter.d.ts

@@ -1,5 +1,7 @@
+import type { ActiveAgentSessionIdentity } from "./agent-session-provider.js";
 import { type CodexProcessSnapshot, type CodexThreadRow } from "./codex-session-provider.js";
 import type { CodexLocalSessionAdapter } from "./codex-local-session-provider.js";
+import type { TerminalThreadLifecycleCandidate, TerminalThreadLifecycleCandidateProvider, TerminalThreadLifecycleCandidateRequest, TerminalThreadLifecycleCandidateToken, TerminalThreadLifecycleCandidateValidation } from "./terminal-agent-adapter.js";
 import { type ProcessCommandResult } from "./terminal-process-source.js";
 export { parseLsofCwdMap, parsePsProcessSnapshots, type ProcessCommandResult as CommandResult } from "./terminal-process-source.js";
 export interface CodexStoreAdapterOptions {
@@ -7,15 +9,38 @@ export interface CodexStoreAdapterOptions {
     runCommand?: (command: string, args: string[]) => ProcessCommandResult;
     maxSessions?: number;
 }
-export declare class CodexStoreAdapter implements CodexLocalSessionAdapter {
+export declare class CodexStoreAdapter implements CodexLocalSessionAdapter, TerminalThreadLifecycleCandidateProvider {
     private readonly codexHome;
     private readonly runCommand;
     private readonly maxSessions;
     constructor(options?: CodexStoreAdapterOptions);
     listThreadRows(): Promise<CodexThreadRow[]>;
+    listThreadLifecycleCandidates(request: TerminalThreadLifecycleCandidateRequest): Promise<TerminalThreadLifecycleCandidate[]>;
+    revalidateThreadLifecycleCandidate(candidate: TerminalThreadLifecycleCandidate | TerminalThreadLifecycleCandidateToken, request: TerminalThreadLifecycleCandidateRequest): Promise<TerminalThreadLifecycleCandidateValidation>;
+    private getThreadRow;
     readRollout(rolloutPath: string): Promise<string | undefined>;
     listProcessSnapshots(): Promise<CodexProcessSnapshot[]>;
+    resolveActiveSessionIdentityForPid(pid: number, cwd?: string, preferredSessionId?: string, allowedCompanionIdentity?: ActiveAgentSessionIdentity, allowedAdditionalIdentities?: readonly ActiveAgentSessionIdentity[]): Promise<ActiveAgentSessionIdentity | undefined>;
     private queryJson;
 }
 export declare function latestStateDbPath(codexHome: string): string | undefined;
+export interface LsofOpenFileRecord {
+    fd?: string;
+    type?: string;
+    device?: string;
+    inode?: string;
+    path?: string;
+}
+export declare function parseLsofOpenFiles(text: string): LsofOpenFileRecord[];
+export declare function resolveCodexOpenRolloutIdentity({ codexHome, pid, cwd, preferredSessionId, allowedCompanionIdentity, allowedAdditionalIdentities, processBirth, lsofOutput }: {
+    codexHome: string;
+    pid: number;
+    cwd?: string;
+    preferredSessionId?: string;
+    allowedCompanionIdentity?: ActiveAgentSessionIdentity;
+    allowedAdditionalIdentities?: readonly ActiveAgentSessionIdentity[];
+    processBirth: string;
+    lsofOutput: string;
+}): ActiveAgentSessionIdentity | undefined;
 export declare function buildThreadSelect(columns: string[], limit: number): string;
+export declare function buildThreadByIdSelect(columns: string[], nativeThreadId: string): string;