@avocadostudio-ai/orchestrator-core 0.20.0 → 0.21.1

package/dist/chat/chat-pipeline.d.ts

@@ -1,6 +1,6 @@
 import { type EditPlan, type Operation, type PageDoc } from "@avocadostudio-ai/shared";
 import { type ChatPipelineContext } from "./chat-pipeline-shared.ts";
-import { type ChatRequestBody, type ChatResult } from "../nlp/intent-detection.ts";
+import { type ChatRequestBody, type ChatResult, type RequestScope } from "../nlp/intent-detection.ts";
 import { type ImageSourcePreference } from "../state/session-state.ts";
 import { type SkippedOperation } from "../ops/ops-engine.ts";
 import { demoPlanFromMessage } from "../nlp/deterministic-planner.ts";
@@ -99,6 +99,8 @@ export declare function runChatPipeline(ctx: ChatPipelineContext, body: ChatRequ
     onRollbackDone?: (event: {
         restoredVersion: number;
     }) => void;
+    /** What the turn is about, sent once before planning starts. See `resolveRequestScope`. */
+    onScope?: (event: RequestScope) => void;
     signal?: AbortSignal;
 }): Promise<{
     code: number;

package/dist/chat/chat-pipeline.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { keyFileHint } from "../env-file-location.js";
 import { blockManifestSchema, getImageFieldMap } from "@avocadostudio-ai/shared";
 import { GENERATING_IMAGE_PLACEHOLDER, SEARCHING_IMAGE_PLACEHOLDER, isUnresolvedImageValue, cleanupImagePlaceholders, buildPageDirectory, isVariationRequestMessage, variationVerbIntent, resolveEffectiveSlug, throwIfCanceled, raceCancel, sleepMs, suppressCancelOnly } from "./chat-pipeline-shared.js";
-import { siteCapabilitiesSchema, isBatchAddRequest, isDuplicateBlockRequest, isBlockCatalogQuery, isInfoQuery, isContentQuery, isPageListQuery, requestsPlanFirst, plannerMessageWithPendingContext, buildSiteContextBlock, infoResponse } from "../nlp/intent-detection.js";
+import { resolveRequestScope, siteCapabilitiesSchema, isBatchAddRequest, isDuplicateBlockRequest, isBlockCatalogQuery, isInfoQuery, isContentQuery, isPageListQuery, requestsPlanFirst, plannerMessageWithPendingContext, buildSiteContextBlock, infoResponse } from "../nlp/intent-detection.js";
 import { isLikelyClarificationFollowUp } from "../nlp/intent-helpers.js";
 import { versions, pendingClarificationBySession, chatHistoryBySession, continuationChainBySession, imageSourcePreferenceBySession, getSessionDraft, getPage, setPage, pushUndo, bumpVersion, pushRecentEdit, pushVersionEntry, pushChatHistory, schedulePersistState, removePage, getSuggestionMemory, recordSuggestionsShown, recordSuggestionClicked } from "../state/session-state.js";
 import { getSiteAssets } from "../state/site-assets.js";
@@ -291,6 +291,11 @@ export async function runChatPipeline(ctx, body, options) {
     if (!body.session || !body.slug || (requiresMessage && !body.message)) {
         return { code: 400, payload: { error: "session and slug are required; message is required for planning" } };
     }
+    // Only a typed turn has a message to read the scope from. Approving a held
+    // plan or continuing a chain says nothing about it, so the editor falls back
+    // to following the ops as they land.
+    if (requiresMessage)
+        options?.onScope?.(resolveRequestScope(body));
     // An explicit "make a plan first" / "plan it before doing" request now APPLIES
     // the plan to the draft as a revertible soft draft instead of holding it
     // uncommitted: the user reviews the whole page in the live preview and Keeps or

package/dist/chat/planner.d.ts

@@ -2,6 +2,7 @@ import { type BlockManifest, type EditPlan, type Operation, type PageDoc } from
 /** 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 { isPageWideTranslationRequest } from "../nlp/intent-detection.ts";
 import { type TokenUsage } from "../telemetry/usage.ts";
 import type { ToolRuntime } from "../tools/runtime.ts";
 import type { ToolExecutionEvent } from "../tools/types.ts";
@@ -13,7 +14,7 @@ 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 { isPageWideTranslationRequest };
 export type PlannerContractMode = "minimal" | "targeted" | "full";
 export type PlannerSchemaContextMeta = {
     contractMode: PlannerContractMode;

package/dist/chat/planner.js

@@ -18,7 +18,7 @@ export function resetOpenAIClient() {
     _openaiSingleton = null;
 }
 import { extractAudienceTarget, blockContractsSummary, fetchImageAsBase64, resolveAttachmentsForLlm, pageMetaContractSummary, intentSchema } from "../nlp/deterministic-planner.js";
-import { isBatchAddRequest, isBatchRemoveRequest, isBatchReorderRequest, isPageWideRewriteRequest, isDuplicateAndModifyRequest, requestsPlanFirst } from "../nlp/intent-detection.js";
+import { isBatchAddRequest, isBatchRemoveRequest, isBatchReorderRequest, isPageWideRewriteRequest, isPageWideTranslationRequest, isDuplicateAndModifyRequest, requestsPlanFirst } from "../nlp/intent-detection.js";
 import { extractJsonObject, inferBlockTypeFromText, normalizePlanCandidate, repairAndParseJsonWithMeta } from "../nlp/plan-normalizer.js";
 import { extractUsage, ZERO_USAGE } from "../telemetry/usage.js";
 import { intentJsonSchema } from "./plan-json-schema.js";
@@ -76,20 +76,9 @@ function extractResponsesOutcome(response) {
 export function isChatStrictPrimaryOpMode() {
     return envFlag("CHAT_STRICT_PRIMARY_OP_MODE", false);
 }
-export function isPageWideTranslationRequest(message) {
-    const lower = message.toLowerCase();
-    const asksTranslation = /\btranslate\b/.test(lower) ||
-        /\btranslation\b/.test(lower) ||
-        /\blocaliz/.test(lower) ||
-        /\bgerman\b/.test(lower) ||
-        /\bdeutsch\b/.test(lower);
-    if (!asksTranslation)
-        return false;
-    return (/\b(this|the|entire|whole|full)\s+(\w+\s+)*page\b/.test(lower) ||
-        /\bwhole\s+site\b/.test(lower) ||
-        /\ball\s+sections?\b/.test(lower) ||
-        /\btranslate\s+(\w+\s+)*page\b/.test(lower));
-}
+// Moved to intent-detection so the request-scope resolver can use it without
+// an import cycle; re-exported for the planners that import it from here.
+export { isPageWideTranslationRequest };
 const EDIT_PLAN_SHAPE_HINT = {
     intent: "edit_plan | needs_clarification",
     summary_for_user: "string",

package/dist/http/chat-stream.d.ts

@@ -1,6 +1,8 @@
 import { type ChatPipelineContext } from "../chat/chat-pipeline.ts";
-import type { ChatRequestBody } from "../nlp/intent-detection.ts";
-export type ChatStreamEvent = {
+import type { ChatRequestBody, RequestScope } from "../nlp/intent-detection.ts";
+export type ChatStreamEvent = ({
+    type: "scope";
+} & RequestScope) | {
     type: "token";
     text: string;
 } | {

package/dist/http/chat-stream.js

@@ -29,6 +29,7 @@ export async function runChatStream(ctx, body, options) {
     try {
         const result = await runChatPipeline(ctx, body, {
             signal,
+            onScope: (scope) => emit({ type: "scope", ...scope }),
             onPlanningToken: (token) => emit({ type: "token", text: token }),
             onThinking: (event) => {
                 if (event.type === "start")

package/dist/nlp/intent-detection.d.ts

@@ -281,6 +281,16 @@ export declare function isPageListQuery(message: string): boolean;
  * pages or clarify. See planner-quality issue #29.
  */
 export declare function hasCrossPageScope(message: string): boolean;
+export declare function isPageWideTranslationRequest(message: string): boolean;
+export type RequestScope = {
+    scope: "block";
+    blockId: string;
+} | {
+    scope: "page";
+} | {
+    scope: "site";
+};
+export declare function resolveRequestScope(body: Pick<ChatRequestBody, "message" | "activeBlockId">): RequestScope;
 export declare function isContentQuery(message: string): boolean;
 export type PageObservation = {
     /** What is true, stated so a reader can check it. */

package/dist/nlp/intent-detection.js

@@ -302,6 +302,52 @@ export function isPageListQuery(message) {
 export function hasCrossPageScope(message) {
     return CROSS_PAGE_SCOPE_PATTERN.test(normalizeForIntent(stripSiteContextEnvelope(message)));
 }
+export function isPageWideTranslationRequest(message) {
+    const lower = message.toLowerCase();
+    const asksTranslation = /\btranslate\b/.test(lower) ||
+        /\btranslation\b/.test(lower) ||
+        /\blocaliz/.test(lower) ||
+        /\bgerman\b/.test(lower) ||
+        /\bdeutsch\b/.test(lower);
+    if (!asksTranslation)
+        return false;
+    return (/\b(this|the|entire|whole|full)\s+(\w+\s+)*page\b/.test(lower) ||
+        /\bwhole\s+site\b/.test(lower) ||
+        /\ball\s+sections?\b/.test(lower) ||
+        /\btranslate\s+(\w+\s+)*page\b/.test(lower));
+}
+/**
+ * The message names the page, or several blocks at once, as what it is about.
+ * English and German, since the editor ships both.
+ */
+const PAGE_REFERENCE_PATTERN = /\b(?:this|the|whole|entire|full|current|my|our)\s+page\b|\bpage[\s-]wide\b|\b(?:all|every|each)\s+(?:the\s+|of\s+the\s+)?(?:sections?|blocks?)\b|\b(?:diese|die|ganze|gesamte|komplette|meine|unsere)\s+seite\b|\balle\s+(?:abschnitte|bl[öo]cke|sektionen)\b/;
+/*
+ * What a chat turn is about, decided before any model is called.
+ *
+ * The editor shows it while the turn runs — a sweep over the block being
+ * worked on, or a frame round the whole page. It used to guess from the
+ * selection alone, so "review this page" with the hero selected spent the
+ * whole turn shimmering the hero: a review writes no ops, so the stream never
+ * named anything better. The selection is what the user was looking at, not
+ * necessarily what they asked about; it counts only when the message names
+ * nothing wider.
+ */
+export function resolveRequestScope(body) {
+    const message = stripSiteContextEnvelope(body.message ?? "");
+    if (hasCrossPageScope(message))
+        return { scope: "site" };
+    const m = normalizeForIntent(message);
+    if (PAGE_REFERENCE_PATTERN.test(m) ||
+        isPageWideRewriteRequest(message) ||
+        isPageWideTranslationRequest(message) ||
+        isBatchAddRequest(message) ||
+        isBatchRemoveRequest(message) ||
+        isBatchReorderRequest(message)) {
+        return { scope: "page" };
+    }
+    const blockId = body.activeBlockId?.trim();
+    return blockId ? { scope: "block", blockId } : { scope: "page" };
+}
 export function isContentQuery(message) {
     const m = normalizeForIntent(message);
     // Exclude messages with clear edit/mutation verbs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@avocadostudio-ai/orchestrator-core",
-  "version": "0.20.0",
+  "version": "0.21.1",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
@@ -22,8 +22,8 @@
     "openai": "^4.87.1",
     "sharp": "^0.35.4",
     "zod": "^4.3.6",
-    "@avocadostudio-ai/shared": "^0.20.0",
-    "@avocadostudio-ai/migration-sdk": "^0.20.0"
+    "@avocadostudio-ai/migration-sdk": "^0.21.1",
+    "@avocadostudio-ai/shared": "^0.21.1"
   },
   "devDependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.3.220",