@nervekit/orchestrator 0.1.0

package/dist/oauth-flow.d.ts

@@ -0,0 +1,27 @@
+import { type OAuthFlowInfo, type RespondOAuthFlowRequest } from "@nervekit/shared";
+import type { AuthManager } from "./auth.js";
+import type { EventBus } from "./infrastructure/events/index.js";
+export declare class OAuthFlowManager {
+    private readonly auth;
+    private readonly events;
+    private readonly flows;
+    private readonly activeByProvider;
+    private activeCallbackFlowId;
+    constructor(auth: AuthManager, events: EventBus);
+    get(flowId: string): OAuthFlowInfo;
+    start(providerId: string): OAuthFlowInfo;
+    respond(flowId: string, response: RespondOAuthFlowRequest): Promise<OAuthFlowInfo>;
+    cancel(flowId: string): Promise<OAuthFlowInfo>;
+    private run;
+    private handleSelect;
+    private handlePrompt;
+    private handleAuth;
+    private waitForManualCode;
+    private waitForResponse;
+    private waitForPending;
+    private fail;
+    private update;
+    private publish;
+    private release;
+}
+//# sourceMappingURL=oauth-flow.d.ts.map

package/dist/oauth-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-flow.d.ts","sourceRoot":"","sources":["../src/oauth-flow.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AA0BjE,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,oBAAoB,CAAqB;gBAG9B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,QAAQ;IAGnC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAOlC,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAkElC,OAAO,CACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,aAAa,CAAC;IAkBnB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;YAuBtC,GAAG;YAiDH,YAAY;YAiBZ,YAAY;YAkBZ,UAAU;YAiBV,iBAAiB;YAcjB,eAAe;IAQ7B,OAAO,CAAC,cAAc;YAaR,IAAI;YAqBJ,MAAM;YAYN,OAAO;IAIrB,OAAO,CAAC,OAAO;CAShB"}

package/dist/oauth-flow.js

@@ -0,0 +1,268 @@
+import { getOAuthProvider } from "@earendil-works/pi-ai/oauth";
+import { createId, } from "@nervekit/shared";
+import { HttpError } from "./registry.js";
+function now() {
+    return new Date().toISOString();
+}
+function terminal(status) {
+    return (status === "succeeded" || status === "failed" || status === "cancelled");
+}
+export class OAuthFlowManager {
+    auth;
+    events;
+    flows = new Map();
+    activeByProvider = new Map();
+    activeCallbackFlowId;
+    constructor(auth, events) {
+        this.auth = auth;
+        this.events = events;
+    }
+    get(flowId) {
+        const flow = this.flows.get(flowId);
+        if (!flow)
+            throw new HttpError(404, "OAUTH_FLOW_NOT_FOUND", "OAuth flow not found.");
+        return flow.info;
+    }
+    start(providerId) {
+        const existing = this.activeByProvider.get(providerId);
+        if (existing) {
+            const flow = this.flows.get(existing);
+            if (flow && !terminal(flow.info.status)) {
+                throw new HttpError(409, "OAUTH_FLOW_ACTIVE", `OAuth login for ${providerId} is already active.`);
+            }
+        }
+        const provider = getOAuthProvider(providerId);
+        if (!provider) {
+            throw new HttpError(404, "OAUTH_PROVIDER_NOT_FOUND", "OAuth provider not found.");
+        }
+        if (providerId !== "openai-codex" && providerId !== "anthropic") {
+            throw new HttpError(400, "OAUTH_PROVIDER_UNSUPPORTED", "This OAuth provider is not enabled in Nerve yet.");
+        }
+        if (provider.usesCallbackServer && this.activeCallbackFlowId) {
+            throw new HttpError(409, "OAUTH_CALLBACK_FLOW_ACTIVE", "Another callback-server OAuth login is already active.");
+        }
+        const timestamp = now();
+        const flow = {
+            provider,
+            abortController: new AbortController(),
+            info: {
+                flowId: createId("authflow"),
+                provider: provider.id,
+                providerName: provider.name,
+                status: "starting",
+                message: "Starting login...",
+                createdAt: timestamp,
+                updatedAt: timestamp,
+            },
+        };
+        this.flows.set(flow.info.flowId, flow);
+        this.activeByProvider.set(provider.id, flow.info.flowId);
+        if (provider.usesCallbackServer)
+            this.activeCallbackFlowId = flow.info.flowId;
+        void this.run(flow).catch((error) => {
+            void this.fail(flow, error instanceof Error ? error.message : String(error));
+        });
+        void this.publish(flow);
+        return flow.info;
+    }
+    async respond(flowId, response) {
+        const flow = this.flows.get(flowId);
+        if (!flow)
+            throw new HttpError(404, "OAUTH_FLOW_NOT_FOUND", "OAuth flow not found.");
+        if (terminal(flow.info.status))
+            return flow.info;
+        const pending = flow.pending;
+        if (!pending || pending.promptId !== response.promptId) {
+            throw new HttpError(409, "OAUTH_PROMPT_MISMATCH", "OAuth flow is not waiting for that response.");
+        }
+        flow.pending = undefined;
+        pending.resolve(response);
+        return flow.info;
+    }
+    async cancel(flowId) {
+        const flow = this.flows.get(flowId);
+        if (!flow)
+            throw new HttpError(404, "OAUTH_FLOW_NOT_FOUND", "OAuth flow not found.");
+        if (terminal(flow.info.status))
+            return flow.info;
+        flow.abortController.abort();
+        flow.pending?.reject(new Error("Login cancelled"));
+        flow.pending = undefined;
+        await this.update(flow, {
+            status: "cancelled",
+            message: "Login cancelled.",
+            promptId: undefined,
+            options: undefined,
+            authUrl: undefined,
+            instructions: undefined,
+            deviceCode: undefined,
+            placeholder: undefined,
+            allowEmpty: undefined,
+        });
+        this.release(flow);
+        return flow.info;
+    }
+    async run(flow) {
+        const callbacks = {
+            onAuth: (info) => {
+                void this.handleAuth(flow, info);
+            },
+            onDeviceCode: (info) => {
+                void this.update(flow, {
+                    status: "device_code",
+                    message: "Complete login using the device code.",
+                    deviceCode: normalizeDeviceCode(info),
+                    promptId: undefined,
+                    options: undefined,
+                    authUrl: undefined,
+                    instructions: undefined,
+                });
+            },
+            onPrompt: (prompt) => this.handlePrompt(flow, prompt),
+            onProgress: (message) => {
+                void this.update(flow, { status: "progress", message });
+            },
+            onManualCodeInput: () => this.waitForManualCode(flow),
+            onSelect: (prompt) => this.handleSelect(flow, prompt),
+            signal: flow.abortController.signal,
+        };
+        const credentials = await flow.provider.login(callbacks);
+        if (flow.abortController.signal.aborted)
+            throw new Error("Login cancelled");
+        await this.auth.setOAuth(flow.provider.id, credentials);
+        await this.update(flow, {
+            status: "succeeded",
+            message: `Logged in to ${flow.provider.name}.`,
+            promptId: undefined,
+            options: undefined,
+            authUrl: undefined,
+            instructions: undefined,
+            deviceCode: undefined,
+            placeholder: undefined,
+            allowEmpty: undefined,
+        });
+        await this.events.publish("auth.oauth_login_succeeded", {
+            provider: flow.provider.id,
+            flow: flow.info,
+        });
+        await this.events.publish("auth.providers_changed", {
+            provider: flow.provider.id,
+        });
+        this.release(flow);
+    }
+    async handleSelect(flow, prompt) {
+        const response = await this.waitForResponse(flow, {
+            status: "select",
+            message: prompt.message,
+            options: prompt.options,
+            promptId: createId("authflow"),
+            authUrl: undefined,
+            instructions: undefined,
+            deviceCode: undefined,
+            placeholder: undefined,
+        });
+        return response.selectedId;
+    }
+    async handlePrompt(flow, prompt) {
+        const response = await this.waitForResponse(flow, {
+            status: "prompt",
+            message: prompt.message,
+            placeholder: prompt.placeholder,
+            allowEmpty: prompt.allowEmpty,
+            promptId: createId("authflow"),
+            options: undefined,
+            authUrl: undefined,
+            instructions: undefined,
+            deviceCode: undefined,
+        });
+        return response.value ?? "";
+    }
+    async handleAuth(flow, info) {
+        await this.update(flow, {
+            status: "auth_url",
+            message: "Open the login URL, then complete authentication in your browser.",
+            authUrl: info.url,
+            instructions: info.instructions,
+            promptId: undefined,
+            options: undefined,
+            deviceCode: undefined,
+            placeholder: undefined,
+        });
+    }
+    async waitForManualCode(flow) {
+        const promptId = createId("authflow");
+        const response = await this.waitForResponse(flow, {
+            status: "prompt",
+            message: "Paste redirect URL or authorization code.",
+            promptId,
+            placeholder: "Paste redirect URL or authorization code",
+            options: undefined,
+            deviceCode: undefined,
+            allowEmpty: undefined,
+        });
+        return response.value ?? "";
+    }
+    async waitForResponse(flow, patch) {
+        await this.update(flow, patch);
+        return this.waitForPending(flow, patch.promptId);
+    }
+    waitForPending(flow, promptId) {
+        return new Promise((resolve, reject) => {
+            flow.pending = { promptId, resolve, reject };
+            if (flow.abortController.signal.aborted) {
+                flow.pending = undefined;
+                reject(new Error("Login cancelled"));
+            }
+        });
+    }
+    async fail(flow, message) {
+        if (flow.info.status === "cancelled")
+            return;
+        await this.update(flow, {
+            status: "failed",
+            error: message,
+            message: `Login failed: ${message}`,
+            promptId: undefined,
+            options: undefined,
+            authUrl: undefined,
+            instructions: undefined,
+            deviceCode: undefined,
+            placeholder: undefined,
+            allowEmpty: undefined,
+        });
+        await this.events.publish("auth.oauth_login_failed", {
+            provider: flow.provider.id,
+            flow: flow.info,
+        });
+        this.release(flow);
+    }
+    async update(flow, patch) {
+        flow.info = {
+            ...flow.info,
+            ...patch,
+            updatedAt: now(),
+        };
+        await this.publish(flow);
+    }
+    async publish(flow) {
+        await this.events.publish("auth.oauth_flow_updated", { flow: flow.info });
+    }
+    release(flow) {
+        if (this.activeByProvider.get(flow.provider.id) === flow.info.flowId) {
+            this.activeByProvider.delete(flow.provider.id);
+        }
+        if (this.activeCallbackFlowId === flow.info.flowId) {
+            this.activeCallbackFlowId = undefined;
+        }
+        flow.pending = undefined;
+    }
+}
+function normalizeDeviceCode(info) {
+    return {
+        userCode: info.userCode,
+        verificationUri: info.verificationUri,
+        intervalSeconds: info.intervalSeconds,
+        expiresInSeconds: info.expiresInSeconds,
+    };
+}
+//# sourceMappingURL=oauth-flow.js.map

package/dist/oauth-flow.js.map

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

package/dist/plan-paths.d.ts

@@ -0,0 +1,6 @@
+export declare function planDirForStorageHome(storageHome: string): string;
+export declare function ensurePlanDir(storageHome: string): Promise<string>;
+export declare function isPathInsidePlanDir(planDir: string, candidatePath: string): boolean;
+export declare function resolvePlanPath(cwd: string, input: unknown): string;
+export declare function planSlugFromPath(filePath: string): string;
+//# sourceMappingURL=plan-paths.d.ts.map

package/dist/plan-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-paths.d.ts","sourceRoot":"","sources":["../src/plan-paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,OAAO,CAMT;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASzD"}

package/dist/plan-paths.js

@@ -0,0 +1,30 @@
+import { mkdir } from "node:fs/promises";
+import { basename, isAbsolute, join, relative, resolve } from "node:path";
+import { resolveToolPath } from "@nerve/tools";
+export function planDirForStorageHome(storageHome) {
+    return resolve(join(storageHome, "plans"));
+}
+export async function ensurePlanDir(storageHome) {
+    const dir = planDirForStorageHome(storageHome);
+    await mkdir(dir, { recursive: true, mode: 0o755 });
+    return dir;
+}
+export function isPathInsidePlanDir(planDir, candidatePath) {
+    const relativePath = relative(planDir, candidatePath);
+    return (relativePath === "" ||
+        (!relativePath.startsWith("..") && !isAbsolute(relativePath)));
+}
+export function resolvePlanPath(cwd, input) {
+    return resolveToolPath(cwd, input);
+}
+export function planSlugFromPath(filePath) {
+    const name = basename(filePath).replace(/\.md$/i, "");
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/^[^a-z0-9]+/, "")
+        .replace(/-+$/g, "")
+        .slice(0, 80);
+    return slug || "plan";
+}
+//# sourceMappingURL=plan-paths.js.map

package/dist/plan-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-paths.js","sourceRoot":"","sources":["../src/plan-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,UAAU,qBAAqB,CAAC,WAAmB;IACvD,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,MAAM,GAAG,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACnD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,aAAqB;IAErB,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACtD,OAAO,CACL,YAAY,KAAK,EAAE;QACnB,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAc;IACzD,OAAO,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,IAAI,MAAM,CAAC;AACxB,CAAC"}

package/dist/plan-service.d.ts

@@ -0,0 +1,61 @@
+import { type AgentRecord, type Mode, type PlanReviewRecord, type PlanReviewStatus, type ToolCallRecord } from "@nerve/shared";
+import type { EventBus } from "./infrastructure/events/index.js";
+import type { InitializedStorage } from "./infrastructure/storage/index.js";
+export type PlanReviewResult = {
+    review: PlanReviewRecord;
+    outcome: PlanReviewStatus;
+    feedback?: string;
+    mode: Mode;
+    contentBlocks?: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+export type SetAgentMode = (agentId: string, mode: Mode, reason: string) => Promise<AgentRecord>;
+export declare class PlanService {
+    private readonly storage;
+    private readonly events;
+    private readonly getAgent;
+    private readonly setAgentMode;
+    readonly planReviews: Map<string, {
+        id: string;
+        toolCallId: string;
+        agentId: string;
+        conversationId: string;
+        projectId: string;
+        slug: string;
+        planPath: string;
+        status: "pending" | "accepted" | "changes_requested" | "discarded" | "force_exited";
+        requestedAt: string;
+        updatedAt: string;
+        title?: string | undefined;
+        summary?: string | undefined;
+        content?: string | undefined;
+        feedback?: string | undefined;
+        resolvedAt?: string | undefined;
+    }>;
+    private readonly waiters;
+    constructor(storage: InitializedStorage, events: EventBus, getAgent: (agentId: string) => AgentRecord, setAgentMode: SetAgentMode);
+    hydrate(): Promise<void>;
+    listPlanReviews(status?: PlanReviewStatus): PlanReviewRecord[];
+    removeReviewsForConversations(conversationIds: Iterable<string>): Promise<void>;
+    planDir(_agent: AgentRecord): string;
+    listPlanFiles(agent: AgentRecord): Promise<string[]>;
+    createPlanReview(toolCall: ToolCallRecord, agent: AgentRecord, args: Record<string, unknown>): Promise<PlanReviewRecord>;
+    presentPlan(toolCall: ToolCallRecord, agent: AgentRecord, args: Record<string, unknown>, signal?: AbortSignal): Promise<PlanReviewResult>;
+    planReviewResult(review: PlanReviewRecord): PlanReviewResult;
+    acceptPlanReview(reviewId: string, feedback?: string): Promise<PlanReviewRecord>;
+    requestPlanChanges(reviewId: string, feedback?: string): Promise<PlanReviewRecord>;
+    rejectPlanReview(reviewId: string, feedback?: string): Promise<PlanReviewRecord>;
+    discardPlanReview(reviewId: string, feedback?: string): Promise<PlanReviewRecord>;
+    forceExitAgentPlanning(agentId: string, reason: string): Promise<AgentRecord>;
+    private waitForPlanReview;
+    private getPendingPlanReview;
+    private resolvePlanReview;
+    private notifyWaiters;
+    private upsertPlanReview;
+    private readLatestPlanReviews;
+    private planReviewOutcomeMessage;
+    private planReviewsPath;
+}
+//# sourceMappingURL=plan-service.d.ts.map

package/dist/plan-service.d.ts.map

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