@enderfga/claw-orchestrator 3.7.1 → 4.0.3

package/dist/src/ultraapp/manager.d.ts

@@ -0,0 +1,150 @@
+import { type AppSpec } from './spec.js';
+import { type UltraappStore, type ChatEntry } from './store.js';
+import { type QuestionEnvelope } from './interview-parser.js';
+import { type PatchOp } from './json-patch.js';
+import type { BuildEvent } from './build-events.js';
+import { type DeployArgs, type DeployResult } from './deploy.js';
+import type { UltraappRouter } from './router.js';
+export type RunEvent = {
+    type: 'question';
+    question: QuestionEnvelope;
+} | {
+    type: 'spec-updated';
+    spec: AppSpec;
+} | {
+    type: 'chat';
+    entry: ChatEntry;
+} | {
+    type: 'completeness';
+    ok: boolean;
+    missing: string[];
+} | {
+    type: 'interview-complete';
+    summary: string;
+} | {
+    type: 'build-event';
+    event: BuildEvent;
+} | {
+    type: 'app-url';
+    url: string;
+    version: string;
+} | {
+    type: 'error';
+    message: string;
+};
+interface SessionManagerLike {
+    startSession(config: {
+        name?: string;
+        engine?: string;
+        model?: string;
+        cwd?: string;
+        systemPrompt?: string;
+        permissionMode?: string;
+    }): Promise<{
+        name: string;
+    }>;
+    sendMessage(name: string, message: string): Promise<{
+        output: string;
+    }>;
+    stopSession(name: string): Promise<void>;
+}
+export interface UltraappManagerOptions {
+    store: UltraappStore;
+    sessionManager: SessionManagerLike;
+    skillPath?: string;
+    /** Optional reverse-proxy router. When absent, the build pipeline ends in
+        `build-complete` (v0.2 behaviour); when present, deploy runs after build
+        and the run reaches `done` with a public-but-local URL. */
+    router?: UltraappRouter;
+    /** Test seam: stub the deploy state machine. */
+    deployFn?: (a: DeployArgs) => Promise<DeployResult>;
+    /** Runtime mode for build + deploy. 'host' (default) runs the generated
+        app as a regular Node process — works anywhere Node works, no extra
+        deps. 'docker' uses `docker build` + `docker run` for isolation; only
+        use this when you want shared-host hardening. */
+    runtimeMode?: 'host' | 'docker';
+}
+export declare class UltraappManager {
+    private readonly opts;
+    private readonly runs;
+    private readonly skillContent;
+    private readonly buildQueue;
+    private readonly narrators;
+    private readonly classifierSessions;
+    private readonly inflightWork;
+    constructor(opts: UltraappManagerOptions);
+    get store(): UltraappStore;
+    createRun(): Promise<string>;
+    submitAnswer(runId: string, answer: {
+        value: string;
+        freeform?: string;
+    }): Promise<void>;
+    applySpecEdit(runId: string, patch: PatchOp[]): Promise<void>;
+    addFile(runId: string, args: {
+        kind: 'upload';
+        filename: string;
+        data: Buffer;
+    } | {
+        kind: 'path';
+        absolutePath: string;
+    }): Promise<{
+        ref: string;
+    }>;
+    subscribe(runId: string, listener: (ev: RunEvent) => void): () => void;
+    startBuild(runId: string): Promise<void>;
+    cancelBuild(runId: string): void;
+    buildPosition(runId: string): number;
+    private runBuild;
+    private runDeployStage;
+    startContainer(runId: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    stopContainer(runId: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    deleteRun(runId: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Done-mode chat message — classified into cosmetic / spec-delta /
+     * structural and routed accordingly. Cosmetic runs the patcher inline;
+     * spec-delta flips mode back to interview with a focused bootstrap;
+     * structural posts a narrator note suggesting a new run.
+     */
+    submitDoneModeMessage(runId: string, text: string): Promise<void>;
+    /**
+     * Promote a previously-built version to the currently-deployed one.
+     * Stops the current container, starts the target's container, and updates
+     * the router map atomically.
+     */
+    promoteVersion(runId: string, toVersion: string): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /** Used by spec-delta to push a system-style bootstrap into the run session. */
+    injectSystemMessage(runId: string, text: string): Promise<void>;
+    /** Used by spec-delta to flip mode back to 'interview' for the focused
+        interview, AND mark the run so the next interview-complete auto-fires
+        a build (no need for the user to click Start Build for a delta rerun). */
+    setModeForDelta(runId: string): Promise<void>;
+    private classifierCall;
+    private routeFeedback;
+    private runPatcherFlow;
+    private patcherCall;
+    private onBuildEvent;
+    /**
+     * Drain all in-flight background work (driveTurn chains, build-queue
+     * enqueue, narrator finalisation). Tests should await this in their
+     * cleanup hook before removing the per-run tmp directory.
+     */
+    waitForIdle(): Promise<void>;
+    private fireDriveTurn;
+    private trackBackground;
+    private driveTurn;
+    private emit;
+    private requireRun;
+}
+export {};