@avocadostudio-ai/orchestrator-core 0.1.0

package/dist/chat/planner.d.ts

@@ -0,0 +1,148 @@
+import { type BlockManifest, type EditPlan, type Operation, type PageDoc } from "@avocadostudio-ai/shared";
+/** Reset the singleton (useful for tests that swap API keys). */
+export declare function resetOpenAIClient(): void;
+import { type ParsedIntent, blockContractsSummary, pageMetaContractSummary, plannerContextPack } from "../nlp/deterministic-planner.ts";
+import { type TokenUsage } from "../telemetry/usage.ts";
+import type { ToolRuntime } from "../tools/runtime.ts";
+import type { ToolExecutionEvent } from "../tools/types.ts";
+import { PlannerError, isPlannerError, type PlannerFailureReasonCategory } from "../errors.ts";
+export { PlannerError, isPlannerError };
+export type { PlannerFailureReasonCategory };
+/** @deprecated Use `PlannerError` instead. */
+export declare const PlannerOutputError: typeof PlannerError;
+/** @deprecated Use `isPlannerError` instead. */
+export declare const isPlannerOutputError: typeof isPlannerError;
+export declare function isChatStrictPrimaryOpMode(): boolean;
+export declare function isPageWideTranslationRequest(message: string): boolean;
+export type PlannerContractMode = "minimal" | "targeted" | "full";
+export type PlannerSchemaContextMeta = {
+    contractMode: PlannerContractMode;
+    contractBytes: number;
+    contractBlockCount: number;
+    targetBlockTypes: string[];
+    strictJsonEnabled: boolean;
+};
+type PlannerSchemaContextPayload = {
+    blockContracts?: ReturnType<typeof blockContractsSummary>;
+    pageMetaContract?: ReturnType<typeof pageMetaContractSummary>;
+    knownBlockTypes?: string[];
+    editPlanShape?: {
+        intent: string;
+        summary_for_user: string;
+        change_log: string[];
+        ops: string[];
+        suggested_next_actions: string[];
+    };
+};
+export declare function isStrictJsonResponseEnabled(): boolean;
+export declare function isAdaptiveSchemaContextEnabled(): boolean;
+export declare function buildPlannerSchemaContext(args: {
+    message: string;
+    contextPack: ReturnType<typeof plannerContextPack>;
+    batchOverride: boolean;
+    pageWideTranslation: boolean;
+    legacyIncludeContracts: boolean;
+    forceFullContracts?: boolean;
+    componentsManifest?: BlockManifest;
+    effectiveBlockTypes?: string[];
+}): {
+    payload: PlannerSchemaContextPayload;
+    meta: PlannerSchemaContextMeta;
+};
+export type PlannerOpenAIClient = {
+    chat: {
+        completions: {
+            create: (args: unknown, options?: {
+                signal?: AbortSignal;
+            }) => any;
+        };
+    };
+    responses: {
+        create: (args: unknown, options?: {
+            signal?: AbortSignal;
+        }) => any;
+    };
+};
+export declare function openAIChatOptionsForModel(model: string): {
+    temperature?: undefined;
+} | {
+    temperature: 0;
+};
+export declare function isResponsesOnlyModel(_model: string): boolean;
+export declare function openAiModelSupportsPdfFiles(model: string): boolean;
+export declare function extractResponsesOutputText(response: unknown): string;
+export declare function extractSummaryFromPlanBuffer(raw: string): {
+    summary: string | null;
+    changeLog: string[];
+};
+export declare function extractOpsFromPlanBuffer(raw: string, emittedCount: number): {
+    nextEmittedCount: number;
+    newOps: Operation[];
+};
+export type StreamedFieldDraft = {
+    opIndex: number;
+    blockId: string;
+    editablePath: string;
+    value: string;
+    /**
+     * Optional target page slug parsed from the partial op object. When the
+     * planner emits multi-page plans (e.g. duplicate_page → update_props on a
+     * new slug), the editor uses this to suppress live-draft overlays whose
+     * pageSlug doesn't match the user's currently-viewed page.
+     */
+    pageSlug?: string;
+};
+export declare function extractUpdatePropsFieldDraftsFromPlanBuffer(raw: string): StreamedFieldDraft[];
+export declare function parseIntentWithOpenAI(args: {
+    message: string;
+    slug: string;
+    currentPage: PageDoc;
+    activeBlockId?: string;
+    activeBlockType?: string;
+    activeEditablePath?: string;
+    model: string;
+    client?: PlannerOpenAIClient;
+}): Promise<ParsedIntent>;
+export declare function generatePlanWithOpenAI(args: {
+    message: string;
+    slug: string;
+    currentPage: PageDoc;
+    contextPack: ReturnType<typeof plannerContextPack>;
+    model: string;
+    history?: Array<{
+        role: "user" | "assistant";
+        content: string;
+    }>;
+    feedback?: string;
+    onToken?: (token: string) => void;
+    onFieldDraft?: (draft: {
+        blockId: string;
+        editablePath: string;
+        value: string;
+        pageSlug?: string;
+    }) => void;
+    onPlannedOp?: (op: Operation, index: number) => void;
+    onSummaryChunk?: (text: string) => void;
+    onChangeLogEntry?: (entry: string) => void;
+    onToolExecution?: (event: ToolExecutionEvent) => void;
+    toolRuntime?: ToolRuntime;
+    toolCallContext?: {
+        siteId: string;
+        sessionId: string;
+        userId?: string;
+        traceId: string;
+        gdriveFolderId?: string;
+    };
+    client?: PlannerOpenAIClient;
+    siteContextBlock?: string | null;
+    forceFullSchemaContracts?: boolean;
+    componentsManifest?: BlockManifest;
+    lightweight?: boolean;
+    signal?: AbortSignal;
+    locale?: string;
+    imageSourceChoiceOpen?: boolean;
+}): Promise<{
+    plan: EditPlan;
+    usage: TokenUsage;
+    schemaContext: PlannerSchemaContextMeta;
+}>;