@scotthuang/agent-knock-knock 0.12.11 → 0.12.13

package/dist/src/managed-turn-recovery-service.js.map

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

package/dist/src/mutation-transaction.d.ts

@@ -0,0 +1,48 @@
+type Awaitable<Value> = Value | PromiseLike<Value>;
+type ScopeKind = "terminal" | "storeWriter" | "state";
+export type CanonicalMutationResource<Value = unknown> = Readonly<{
+    key: string;
+    value: Value;
+}>;
+type ScopeResources = Readonly<Record<ScopeKind, CanonicalMutationResource>>;
+export type CanonicalMutationResources = Readonly<Pick<ScopeResources, "terminal" | "storeWriter"> & Partial<ScopeResources>>;
+export type CanonicalStateMutationResources = Readonly<ScopeResources>;
+declare const mutationScopeBrand: unique symbol;
+type MutationScope<Kind extends ScopeKind> = Readonly<{
+    [mutationScopeBrand]: Kind;
+}>;
+export type CanonicalMutationScopes = Readonly<{
+    terminal: MutationScope<"terminal">;
+    storeWriter: MutationScope<"storeWriter">;
+    state?: MutationScope<"state">;
+}>;
+export type CanonicalStateMutationScopes = CanonicalMutationScopes & Readonly<{
+    state: MutationScope<"state">;
+}>;
+export type CanonicalMutationLockPorts = Readonly<{
+    resources: CanonicalMutationResources;
+    acquireTerminal: () => Awaitable<() => void>;
+    withStoreWriter: <Result>(operation: () => Promise<Result>) => Promise<Result>;
+    acquireState?: () => Awaitable<() => void>;
+}>;
+export declare function canonicalMutationResource<Value>(key: string, value: Value): Readonly<{
+    key: string;
+    value: Value;
+}>;
+type ScopesFor<Kinds extends readonly ScopeKind[]> = Pick<CanonicalStateMutationScopes, Kinds[number]>;
+export declare function capabilityGatedRepositoryOperation<const Required extends readonly ScopeKind[], Bound extends Required[number], Resource, Args extends unknown[], Result>(required: Required, bound: Bound, operation: (resource: Resource, ...args: Args) => Result): (scopes: ScopesFor<Required>, resources: Pick<ScopeResources, Required[number]>, ...args: Args) => Result;
+export declare function capabilityGatedRepositoryPairOperation<const Required extends readonly ScopeKind[], First extends Required[number], Second extends Required[number], FirstResource, SecondResource, Args extends unknown[], Result>(required: Required, bound: readonly [First, Second], operation: (first: FirstResource, second: SecondResource, ...args: Args) => Result): (scopes: ScopesFor<Required>, resources: Pick<ScopeResources, Required[number]>, ...args: Args) => Result;
+type ScopesForPorts<Ports> = Ports extends {
+    acquireState: () => unknown;
+} ? CanonicalStateMutationScopes : CanonicalMutationScopes;
+type ResourcesForPorts<Ports> = Ports extends {
+    acquireState: () => unknown;
+} ? ScopeResources : CanonicalMutationResources;
+/** Acquire terminal -> writer -> optional state and release in reverse. */
+export declare function withCanonicalMutationLocks<Result, Ports extends CanonicalMutationLockPorts>(ports: Ports, operation: (scopes: ScopesForPorts<Ports>, resources: ResourcesForPorts<Ports>) => Promise<Result>): Promise<Result>;
+/** Add one state scope to the currently active terminal + writer transaction. */
+export declare function withCanonicalStateMutationLock<Result, StateResource>(scopes: CanonicalMutationScopes, resources: CanonicalMutationResources, state: Readonly<{
+    resource: CanonicalMutationResource<StateResource>;
+    acquire: () => Awaitable<() => void>;
+}>, operation: (scopes: CanonicalStateMutationScopes, resources: CanonicalStateMutationResources) => Promise<Result>): Promise<Result>;
+export {};

package/dist/src/mutation-transaction.js

@@ -0,0 +1,73 @@
+const scopeRecords = new WeakMap();
+export function canonicalMutationResource(key, value) { return Object.freeze({ key, value }); }
+function createScope(transaction, kind, resource) {
+    const scope = Object.freeze({});
+    scopeRecords.set(scope, { kind, transaction, resource });
+    return scope;
+}
+function expireScope(scope) { scopeRecords.delete(scope); }
+async function withAcquiredScope(transaction, kind, resource, acquire, operation) {
+    const release = await acquire();
+    const scope = createScope(transaction, kind, resource);
+    try {
+        return await operation(scope);
+    }
+    finally {
+        expireScope(scope);
+        release();
+    }
+}
+function assertActiveScopes(scopes, resources, required) {
+    let transaction;
+    for (const kind of required) {
+        const record = scopes[kind] && scopeRecords.get(scopes[kind]);
+        if (!record || record.kind !== kind || record.resource !== resources[kind]) {
+            throw new Error(`mutation repository requires active authentic ${kind} scope`);
+        }
+        if (transaction && transaction !== record.transaction) {
+            throw new Error("mutation repository scopes belong to different transactions");
+        }
+        transaction = record.transaction;
+    }
+    if (!transaction) {
+        throw new Error("mutation repository requires at least one active scope");
+    }
+    return transaction;
+}
+export function capabilityGatedRepositoryOperation(required, bound, operation) {
+    return (scopes, resources, ...args) => {
+        assertActiveScopes(scopes, resources, required);
+        return operation(resources[bound].value, ...args);
+    };
+}
+export function capabilityGatedRepositoryPairOperation(required, bound, operation) {
+    return (scopes, resources, ...args) => {
+        assertActiveScopes(scopes, resources, required);
+        return operation(resources[bound[0]].value, resources[bound[1]].value, ...args);
+    };
+}
+/** Acquire terminal -> writer -> optional state and release in reverse. */
+export async function withCanonicalMutationLocks(ports, operation) {
+    const transaction = {};
+    return withAcquiredScope(transaction, "terminal", ports.resources.terminal, ports.acquireTerminal, (terminal) => ports.withStoreWriter(async () => {
+        const storeWriter = createScope(transaction, "storeWriter", ports.resources.storeWriter);
+        const invoke = (state) => operation({ terminal, storeWriter, ...(state ? { state } : {}) }, ports.resources);
+        try {
+            if (!ports.acquireState)
+                return await invoke();
+            const stateResource = ports.resources.state;
+            if (!stateResource)
+                throw new Error("state mutation lock requires a canonical resource");
+            return await withAcquiredScope(transaction, "state", stateResource, ports.acquireState, invoke);
+        }
+        finally {
+            expireScope(storeWriter);
+        }
+    }));
+}
+/** Add one state scope to the currently active terminal + writer transaction. */
+export async function withCanonicalStateMutationLock(scopes, resources, state, operation) {
+    const transaction = assertActiveScopes(scopes, resources, ["terminal", "storeWriter"]);
+    return withAcquiredScope(transaction, "state", state.resource, state.acquire, (stateScope) => operation({ ...scopes, state: stateScope }, Object.freeze({ ...resources, state: state.resource })));
+}
+//# sourceMappingURL=mutation-transaction.js.map

package/dist/src/mutation-transaction.js.map

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

package/dist/src/native-thread-lifecycle-cli-adapter.d.ts

@@ -0,0 +1,154 @@
+import type { ExecutorKind } from "./executors.js";
+import type { FileLockAcquisitionOptions } from "./file-lock-cli-adapter.js";
+import { type ManagedSessionState } from "./managed-session.js";
+import { type LifecycleTerminalObservation, type NativeThreadLifecycleQueryPorts } from "./native-thread-lifecycle-query-service.js";
+import { type Conversation } from "./protocol.js";
+import type { TerminalAgentAdapter, TerminalControlRef, TerminalRuntimeIdentity, TerminalThreadLifecycleCapabilities } from "./terminal-agent-adapter.js";
+import { type ResolvedTerminalConversation } from "./terminal-agent-bridge.js";
+import { type CodexAllowedCompanionSet } from "./terminal-authority-policy.js";
+import type { TerminalNativeIdentity } from "./terminal-binding-authority.js";
+import type { TerminalDispatchLedgerDocument } from "./terminal-dispatch-ledger-codec.js";
+import type { TerminalRuntimeCliAdapter } from "./terminal-runtime-cli-adapter.js";
+export type NativeLifecycleCliOptions = Readonly<Record<string, unknown>>;
+export interface NativeLifecycleSnapshot {
+    readonly identity?: TerminalNativeIdentity;
+    readonly runtimeIdentity?: TerminalNativeIdentity;
+    readonly codexCompanions: CodexAllowedCompanionSet;
+    readonly session?: ManagedSessionState;
+    readonly version?: string;
+    readonly capabilities: TerminalThreadLifecycleCapabilities;
+    readonly bindingToken: string;
+    readonly bindingTokens: readonly string[];
+}
+interface NativeLifecycleIdentityPorts {
+    resolveCurrent(input: {
+        options: NativeLifecycleCliOptions;
+        agent: ExecutorKind;
+        pid: number;
+        cwd?: string;
+        preferredSessionId?: string;
+        allowedCompanionIdentity?: CodexAllowedCompanionSet["primary"];
+        allowedAdditionalIdentities?: readonly NonNullable<CodexAllowedCompanionSet["primary"]>[];
+    }): Promise<TerminalNativeIdentity | undefined>;
+    managedContext(input: {
+        storeDir: string;
+        terminal: ResolvedTerminalConversation;
+    }): {
+        preferredSessionId?: string;
+        companions: CodexAllowedCompanionSet;
+    };
+    boundSession(input: {
+        storeDir: string;
+        terminal: ResolvedTerminalConversation;
+        identity?: TerminalNativeIdentity;
+    }): ManagedSessionState | undefined;
+    materializeSession(input: {
+        options: NativeLifecycleCliOptions;
+        terminal: ResolvedTerminalConversation;
+        identity?: TerminalNativeIdentity;
+    }): ManagedSessionState | undefined;
+    refineSession(input: {
+        storeDir: string;
+        session: ManagedSessionState;
+        terminalControl: TerminalControlRef;
+        identity?: TerminalNativeIdentity;
+    }): ManagedSessionState;
+    logicalIdentity(input: {
+        storeDir: string;
+        session: ManagedSessionState;
+        observedIdentity?: TerminalNativeIdentity;
+    }): TerminalNativeIdentity | undefined;
+    companionSet(input: {
+        storeDir: string;
+        session: ManagedSessionState;
+    }): CodexAllowedCompanionSet;
+    processIncarnation(pid: number): {
+        processUuid: string;
+        processBirth: string;
+    };
+    runtimeForLiveIdentity(input: {
+        terminal: ResolvedTerminalConversation;
+        identity?: TerminalNativeIdentity;
+        expectedEmptyNativeSession?: boolean;
+        physicalOnly?: boolean;
+    }): TerminalRuntimeIdentity;
+    ownerIsInactive(input: {
+        session: ManagedSessionState;
+        terminal: LifecycleTerminalObservation;
+        identity?: TerminalNativeIdentity;
+    }): boolean;
+    assertCodexComposerReady(input: {
+        options: NativeLifecycleCliOptions;
+        terminalControl: TerminalControlRef;
+    }): Promise<void>;
+}
+interface NativeLifecycleStatePorts {
+    storeDir(options: NativeLifecycleCliOptions): string;
+    inspectStore(storeDir: string): {
+        writable: boolean;
+    };
+    runtimeDir(): string;
+    acquireTerminal(storeDir: string, terminalControl: TerminalControlRef, options?: FileLockAcquisitionOptions): () => void;
+    loadLedger(terminalControl: TerminalControlRef): TerminalDispatchLedgerDocument | undefined;
+    managedTurns(storeDir: string, sessionId: string): readonly Conversation[];
+    terminalBlockingTurns(storeDir: string, terminalControl: TerminalControlRef): readonly Conversation[];
+    hasUnresolvedTransition(storeDir: string, session: ManagedSessionState): boolean;
+    dispatchOwnership(terminalControl: TerminalControlRef): {
+        state: string;
+    };
+    assertNativeThreadStoreAuthority(input: {
+        terminalControl: TerminalControlRef;
+        nativeThreadId: string;
+        storeDir: string;
+    }): void;
+    orphanedForRecovery(terminalControl: TerminalControlRef): TerminalDispatchLedgerDocument | undefined;
+}
+export interface CreateNativeThreadLifecycleCliAdapterInput {
+    runtime: {
+        forOptions(options: NativeLifecycleCliOptions): TerminalRuntimeCliAdapter;
+        sleep(milliseconds: number): Promise<void>;
+    };
+    identity: NativeLifecycleIdentityPorts;
+    state: NativeLifecycleStatePorts;
+    output: {
+        cwd(): string;
+        print(value: unknown): void;
+    };
+}
+export interface NativeThreadOwnershipRequest {
+    options: NativeLifecycleCliOptions;
+    agent: ExecutorKind;
+    currentPid: number;
+    nativeThreadId: string;
+    storeDir: string;
+    terminalControl: TerminalControlRef;
+    excludedManagedSessionId?: string;
+    allowedManagedSessionIds?: string[];
+}
+export interface NativeThreadLifecycleCliFacade {
+    resolveLifecycleTerminal(options: NativeLifecycleCliOptions): Promise<ResolvedTerminalConversation>;
+    queryPorts(options: NativeLifecycleCliOptions): NativeThreadLifecycleQueryPorts;
+    assertExclusive(input: NativeThreadOwnershipRequest): Promise<void>;
+    currentSnapshot(options: NativeLifecycleCliOptions, terminal: ResolvedTerminalConversation, settings?: {
+        materialize?: boolean;
+    }): Promise<NativeLifecycleSnapshot>;
+    lifecycleBindingTokens(input: {
+        session?: ManagedSessionState;
+        terminal: ResolvedTerminalConversation;
+        identity?: TerminalNativeIdentity;
+    }): readonly string[];
+    agentAdapter(options: NativeLifecycleCliOptions, agent: ExecutorKind): TerminalAgentAdapter;
+    runList(options: NativeLifecycleCliOptions): Promise<void>;
+    runInspect(options: NativeLifecycleCliOptions): Promise<void>;
+    assertSameInspectionTerminal(expected: ResolvedTerminalConversation, actual: ResolvedTerminalConversation, stage: string): void;
+    codexLatentClearResumeObservation(input: {
+        screen?: string;
+        agentVersion?: string;
+    }): {
+        sourceNativeThreadId: string;
+        fingerprint: string;
+    } | undefined;
+    nativeInspectionComposerEmpty(agent: ExecutorKind, screen?: string): boolean;
+}
+export declare function createNativeThreadLifecycleCliAdapter(ports: CreateNativeThreadLifecycleCliAdapterInput): NativeThreadLifecycleCliFacade;
+export {};