laohuang 0.3.2 → 0.4.0

package/dist/cancellation.js

@@ -0,0 +1,123 @@
+/** Cooperative, task-scoped cancellation primitives. */
+/** Raised by {@link CancelToken.throwIfCancelled}. */
+export class CancellationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CancellationError";
+    }
+}
+/**
+ * An idempotent, single-threaded cancellation token.
+ *
+ * Registered callbacks run synchronously in the call stack that wins the
+ * first call to {@link cancel}. A callback registered after cancellation
+ * runs immediately, before {@link register} returns.
+ */
+export class CancelToken {
+    #cancelled = false;
+    #reason = null;
+    #requestedAt = null;
+    #callbacks = new Map();
+    #nextCallbackId = 0;
+    #waiters = new Set();
+    #controller = new AbortController();
+    get reason() {
+        return this.#reason;
+    }
+    /** `performance.now()` timestamp of the first cancel, or null. */
+    get requestedAt() {
+        return this.#requestedAt;
+    }
+    get cancelled() {
+        return this.#cancelled;
+    }
+    /** AbortSignal view of the token, for APIs that accept one. */
+    get signal() {
+        return this.#controller.signal;
+    }
+    isCancelled() {
+        return this.#cancelled;
+    }
+    /**
+     * Request cancellation. Returns true for the first (winning) call and
+     * false for every subsequent call.
+     */
+    cancel(reason = "cancelled") {
+        const effectiveReason = reason || "cancelled";
+        if (this.#cancelled) {
+            return false;
+        }
+        this.#reason = effectiveReason;
+        this.#requestedAt = performance.now();
+        const callbacks = [...this.#callbacks.values()];
+        this.#callbacks.clear();
+        this.#cancelled = true;
+        this.#controller.abort(new CancellationError(effectiveReason));
+        for (const callback of callbacks) {
+            try {
+                callback(effectiveReason);
+            }
+            catch {
+                // Cancellation must remain effective even if a cleanup hook is
+                // faulty; owners can report their own cleanup failures.
+                continue;
+            }
+        }
+        for (const resolve of this.#waiters) {
+            resolve();
+        }
+        this.#waiters.clear();
+        return true;
+    }
+    /**
+     * Resolve true once the token is cancelled. With `timeoutMs`, resolve
+     * false instead when the timeout elapses first.
+     */
+    wait(timeoutMs) {
+        if (this.#cancelled) {
+            return Promise.resolve(true);
+        }
+        return new Promise((resolve) => {
+            let timer;
+            const onCancel = () => {
+                if (timer !== undefined) {
+                    clearTimeout(timer);
+                }
+                this.#waiters.delete(onCancel);
+                resolve(true);
+            };
+            this.#waiters.add(onCancel);
+            if (timeoutMs !== undefined) {
+                timer = setTimeout(() => {
+                    this.#waiters.delete(onCancel);
+                    resolve(false);
+                }, timeoutMs);
+            }
+        });
+    }
+    throwIfCancelled() {
+        if (this.#cancelled) {
+            throw new CancellationError(this.#reason ?? "cancelled");
+        }
+    }
+    /** Register a cancellation hook and return an unregister function. */
+    register(callback) {
+        if (this.#cancelled) {
+            const reason = this.#reason ?? "cancelled";
+            try {
+                callback(reason);
+            }
+            catch {
+                // Late-registered hooks must not break the registering caller.
+            }
+            return () => { };
+        }
+        this.#nextCallbackId += 1;
+        const callbackId = this.#nextCallbackId;
+        this.#callbacks.set(callbackId, callback);
+        return () => {
+            this.#callbacks.delete(callbackId);
+        };
+    }
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/cancellation.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+/** Command-line interface and subcommands for laoHuangCode. */
+import { type ClientConnectionSettings } from "./client.ts";
+import { type QueueStatus } from "./commands.ts";
+import { type InputFn as PromptFn } from "./model-selection.ts";
+import { type Submission } from "./session.ts";
+import { PlainEventSink, TerminalUI } from "./terminal/ui.ts";
+export declare const VERSION: string;
+type InputFn = (prompt: string) => string | Promise<string>;
+type OutputFn = (message: string) => void;
+export interface TerminalSupportOptions {
+    inputFn?: InputFn | undefined;
+    outputFn?: OutputFn | undefined;
+    stdin?: {
+        isTTY?: boolean | undefined;
+    } | undefined;
+    stdout?: {
+        isTTY?: boolean | undefined;
+    } | undefined;
+}
+/** Only enable the interactive UI for the process's real TTY streams. */
+export declare function supportsTerminalUI(options?: TerminalSupportOptions): boolean;
+export interface ReplAgentLike {
+    run(text: string): string | Promise<string>;
+}
+export interface ReplUiLike {
+    showWelcome(): void;
+    prompt(): string | Promise<string>;
+    showGoodbye(): void;
+    showInterrupted(options?: {
+        operation?: boolean;
+    }): void;
+    showError(message: string): void;
+    showAssistant(response: string): void;
+    write(message: string): void;
+    thinking?(): {
+        close(): void;
+    } | null;
+}
+export declare function runRepl(agent: ReplAgentLike, options?: {
+    commandHandler?: ((command: string) => boolean | Promise<boolean>) | undefined;
+    inputFn?: ((prompt: string) => string | Promise<string>) | undefined;
+    outputFn?: OutputFn | undefined;
+    ui?: ReplUiLike | undefined;
+}): Promise<void>;
+/** Minimal structural view of AgentSession the REPL loops rely on. */
+export interface SessionReplSession {
+    readonly eventBus: {
+        flush(): Promise<unknown>;
+    };
+    submitInput(content: string): Promise<Submission>;
+    queueStatus(): QueueStatus;
+    publishNotice(text: string, options?: {
+        style?: string;
+    }): unknown;
+    waitForIdle(timeoutMs?: number): Promise<boolean>;
+    close(options?: {
+        wait?: boolean;
+        timeoutMs?: number;
+    }): Promise<boolean>;
+}
+export interface SessionUiLike {
+    commandRegistry?: unknown;
+    renderError?: unknown;
+    showWelcome?(): void;
+    showGoodbye?(): void;
+    showError?(message: string): void;
+    prompt?(): string | Promise<string>;
+    run?(onSubmit: (text: string) => void): void | Promise<void>;
+    requestExit?(): void;
+    close?(): void;
+    startEventRenderer?(): void;
+    stopEventRenderer?(): void;
+    flushEventRenderer?(): void;
+}
+export type CommandHandler = (command: string) => boolean | Promise<boolean>;
+/** Keep accepting input while AgentSession executes in the background. */
+export declare function runSessionRepl(session: SessionReplSession, options: {
+    commandHandler?: CommandHandler | undefined;
+    ui: SessionUiLike;
+    /** Override for driving a UI whose run() does not read real stdin. */
+    runUi?: ((onSubmit: (text: string) => void) => void | Promise<void>) | undefined;
+}): Promise<boolean>;
+/** Run the same event-driven session with append-only plain output. */
+export declare function runPlainSessionRepl(session: SessionReplSession, options: {
+    commandHandler?: CommandHandler | undefined;
+    inputFn?: ((prompt: string) => string | Promise<string>) | undefined;
+    sink: PlainEventSink;
+}): Promise<boolean>;
+/**
+ * Route setup/command questions through the running terminal UI loop
+ * (mirrors the Python original's `input_fn = terminal_ui.prompt` and
+ * `session_secret_input_fn = terminal_ui.prompt_secret`). The loop's ask()
+ * coordinates the question with its editor, so no pause/resume is needed —
+ * and nothing reads fd 0 behind the driver's raw-mode stream.
+ */
+export declare function terminalUiPrompts(ui: Pick<TerminalUI, "prompt" | "promptSecret">): {
+    input: PromptFn;
+    secretInput: PromptFn;
+};
+export interface MainOptions {
+    environ?: Record<string, string | undefined> | undefined;
+    configPath?: string | undefined;
+    credentialsPath?: string | undefined;
+    inputFn?: InputFn | undefined;
+    secretInputFn?: InputFn | undefined;
+    outputFn?: OutputFn | undefined;
+    clientFactory?: ((settings: ClientConnectionSettings) => unknown) | undefined;
+    stdin?: {
+        isTTY?: boolean | undefined;
+    } | undefined;
+    stdout?: {
+        isTTY?: boolean | undefined;
+    } | undefined;
+}
+export declare function main(argv?: readonly string[] | null, options?: MainOptions): Promise<number>;
+export {};