@quantiya/codevibe-core 2.0.84 → 2.0.86

package/dist/orchestration-shell/gemma-intent-classifier.d.ts

@@ -0,0 +1,48 @@
+export type PromptIntentAction = 'start_task' | 'familiarize' | 'advisory_response' | 'browse' | 'brainstorm' | 'ask_user';
+export type PromptIntentSource = 'model' | 'semantic_fail_closed' | 'infrastructure_outage';
+export interface PromptIntentClassification {
+    action: PromptIntentAction;
+    is_code_or_disk_mutation: boolean;
+    confidence: 'high' | 'low';
+    rationale: string;
+    source: PromptIntentSource;
+    requires_file_read?: boolean;
+}
+export interface GemmaIntentPort {
+    classify(req: {
+        prompt: string;
+        jsonSchema?: Record<string, unknown>;
+        maxOutputTokens: number;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<{
+        text: string;
+    }>;
+}
+export declare const INTENT_CLASSIFIER_JSON_SCHEMA: Record<string, unknown>;
+export declare function buildIntentClassifierPrompt(prompt: string, clarifications?: {
+    question: string;
+    answer: string;
+}[]): string;
+export declare function parseIntentGemmaResponse(raw: string): PromptIntentClassification | null;
+/**
+ * Detect whether an error represents a genuine infrastructure transport/network/timeout outage
+ * rather than a model semantic, contract, capability, or internal programming error.
+ * Only genuine infrastructure outages permit falling back to secondary regex heuristics (Codex R50-F4, Claude NB2).
+ */
+export declare function isInfrastructureTransportOutage(err: unknown): boolean;
+/**
+ * Classify a user turn using Gemma with structured JSON.
+ * Returns `PromptIntentClassification`.
+ * Always fails closed to `start_task` on any error or ambiguity.
+ */
+export declare function classifyPromptIntentWithGemma(input: {
+    prompt: string;
+    clarifications?: {
+        question: string;
+        answer: string;
+    }[];
+}, port: GemmaIntentPort, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<PromptIntentClassification>;

package/dist/orchestration-shell/index.d.ts

@@ -343,7 +343,7 @@ export { reducer } from './reducer';
 export { createOrchestrationStore, type OrchestrationStore } from './store';
 export { routeBrowse, RETAINED_PAGE_MAX_CHARS, type RouteBrowseDeps, type RetainedBrowsePage, } from './route-browse';
 export { composeBrainstormPanelBrief, fitTextToBudget, MAX_BRAINSTORM_PAGE_CHARS, MAX_BRAINSTORM_PAGE_TOKENS, MAX_BRAINSTORM_PAGE_BYTES, } from './brainstorm-quorum';
-export { extractQueryRelevantSnippets, isPromptRelevantToRetainedPage, htmlToText } from './web/extract';
+export { extractQueryRelevantSnippets, isPromptRelevantToRetainedPage, isBlindBrowseClarification, htmlToText } from './web/extract';
 export { validateAgyArgPrompt, AGY_ARG_PROMPT_MAX_UTF8_BYTES, } from '../agy-cli-contract';
 export type { Mode, Tier, PlannerDecision, AgentKind, PlannerHealthState, RunningTaskState, ReviewerSeatState, GateState, ExecutionEventEntry, RefusalEventEntry, BypassEventEntry, MobileEventEntry, EventStreamEntry, ConversationEntry, QueuedTask, PendingClarification, OrchestrationState, OrchestrationAction, LastModeFile, TeamState, TeamTrackEntry, TeamTrackState, TeamMergeGateStatus, LiveProgress, } from './types';
 export { formatElapsed, isSpinnerPhase, renderProgressLine, type TaskProgressEvent, type OnProgress, } from './task-progress';
@@ -925,6 +925,35 @@ export declare function routeFamiliarize(deps: {
     userPrompt?: string;
     onProgress?: (event: TaskProgressEvent) => void;
 }): Promise<void>;
+/**
+ * Routes a bare document inspection or file summarization inquiry
+ * (e.g. "Pick a file and summarize its numbers and key details", "Summarize package.json", "Summarize notice.pdf")
+ * to a read-only frontier agent in plan mode.
+ *
+ * When a frontier agent is available (`localExecutor` + `quorumLoop`):
+ * - Selects the default implementor agent from detected agents (default CLAUDE or ANTIGRAVITY).
+ * - Spawns the read-only agent via `runReadOnlyAgentAdvisoryResult` in plan mode.
+ * - The agent reads the file(s) and produces grounded document facts.
+ * - Dispatches the sanitized text to `store` as `SHELL_ADVISORY`.
+ * - NEVER calls `writeRepoState` and NEVER creates a task or shadow workspace.
+ *
+ * When no frontier agent is wired or invocation fails:
+ * - Fails closed with an explicit user-facing message explaining that a read-capable model is required.
+ * - NEVER displays internal classifier rationale as the user's answer.
+ */
+/**
+ * Parses numbered or disjunctive alternatives from a clarifying question string.
+ * Supports:
+ * - Numbered lists: "1. View in chat 2. Group in chat 3. Write summary to report.md" or "1) ... 2) ..."
+ * - Disjunctive lists: "A, B, or C?" or "A or B?"
+ */
+export declare function parseNumberedOptions(question: string): string[];
+export declare function routeDocumentInspectionAdvisory(deps: {
+    store: OrchestrationStore;
+    args: RunOrchestrationShellArgs;
+    userPrompt: string;
+    onProgress?: (event: TaskProgressEvent) => void;
+}): Promise<boolean>;
 export declare function routeBrainstorm(deps: {
     store: OrchestrationStore;
     args: RunOrchestrationShellArgs;

package/dist/orchestration-shell/quorum-loop.d.ts

@@ -518,7 +518,7 @@ export interface QuorumLoopDeps {
      * weakening any production timeout or filesystem check.
      */
     shadowRecoveryOps?: {
-        listRecoverableShadows?: (env: ShadowEnv) => Promise<RecoveredShadow[]>;
+        listRecoverableShadows?: (env: ShadowEnv, ownedTaskIds?: ReadonlySet<string>) => Promise<RecoveredShadow[]>;
         listShadowCleanupResidue?: (taskIds: ReadonlySet<string>, env: ShadowEnv) => Promise<ShadowCleanupResidue[]>;
         captureWorkspaceRootAuthority?: typeof captureWorkspaceRootAuthority;
         reopenShadow?: (recovered: RecoveredShadow, env: ShadowEnv) => Promise<WorkspaceShadow | null>;

package/dist/orchestration-shell/web/extract.d.ts

@@ -56,3 +56,9 @@ export declare function isPromptRelevantToRetainedPage(prompt: string, retainedP
     title?: string;
     text?: string;
 } | null): boolean;
+/**
+ * Detects whether a planner clarifying question is a blind deflection regarding web browsing
+ * (e.g. asking for a URL, link, or website address because the model lacks awareness of the retained page),
+ * as opposed to a genuine question about user preferences, sections, files, or instructions.
+ */
+export declare function isBlindBrowseClarification(clarifyingQuestion?: string): boolean;

package/dist/prompt-parser.d.ts

@@ -42,3 +42,14 @@ export declare function normalizeSnapshot(snapshot: string): string;
 export declare function countUnescapedBackticks(str: string): number;
 export declare function isMcpHeadingLine(line: string): boolean;
 export declare function isPromptHeadingLine(line: string): boolean;
+import { parseInteractivePromptWithGemma, type TuiGemmaPort } from './tui-parser/gemma-tui-parser';
+export { parseInteractivePromptWithGemma, type TuiGemmaPort };
+/**
+ * Asynchronously parse an interactive prompt with model-based structured JSON parsing
+ * when available, respecting the CODEVIBE_TUI_PARSER operational kill-switch.
+ */
+export declare function parseInteractivePromptAsync(snapshot: string, port?: TuiGemmaPort, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    boundedOptionBlock?: boolean;
+}): Promise<ParsedInteractivePrompt | null>;

package/dist/terminal-menu.d.ts

@@ -21,3 +21,13 @@ export declare function selectTerminalMenuOption(identity: string, number: strin
  * and a separate terminal footer with key hints.
  */
 export declare function parseActiveTerminalMenu(snapshot: string): TerminalMenu | null;
+import { parseActiveTerminalMenuWithGemma, type GemmaTerminalMenu, type TuiGemmaPort } from './tui-parser/gemma-tui-parser';
+export { parseActiveTerminalMenuWithGemma, type GemmaTerminalMenu };
+/**
+ * Asynchronously parse an active terminal menu using Gemma structured JSON when available,
+ * respecting the CODEVIBE_TUI_PARSER operational kill-switch.
+ */
+export declare function parseActiveTerminalMenuAsync(snapshot: string, port?: TuiGemmaPort, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<TerminalMenu | null>;

package/dist/tui-parser/gemma-tui-parser.d.ts

@@ -0,0 +1,74 @@
+import type { ParsedInteractivePrompt } from '../prompt-parser';
+export interface TuiGemmaPort {
+    classify(req: {
+        prompt: string;
+        jsonSchema?: Record<string, unknown>;
+        maxOutputTokens: number;
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<{
+        text: string;
+    }>;
+}
+export interface RawGemmaTuiOption {
+    number: string;
+    text: string;
+    is_selected?: boolean;
+}
+export interface RawGemmaTuiResponse {
+    is_interactive_prompt: boolean;
+    kind: 'numbered' | 'yes_no' | 'text' | 'none';
+    prompt_text: string;
+    selected_option_number?: string | null;
+    options?: RawGemmaTuiOption[];
+    requires_follow_up_text?: boolean;
+}
+export declare const TUI_PARSER_JSON_SCHEMA: Record<string, unknown>;
+/** Deterministic pre-guard to quickly reject snapshots that cannot be interactive menus. */
+export declare function hasInteractivePromptMarkers(text: string): boolean;
+export declare function buildTuiParserPrompt(normalizedSnapshot: string): string;
+export declare function parseTuiGemmaResponse(raw: string): RawGemmaTuiResponse | null;
+/**
+ * Low-level raw structured response parser with timeout and cancellation bounds.
+ */
+export declare function parseRawTuiWithGemma(snapshot: string, port: TuiGemmaPort, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<RawGemmaTuiResponse | null>;
+/**
+ * Parse an interactive terminal prompt using Gemma with structured JSON.
+ * Returns `ParsedInteractivePrompt` or `null`.
+ */
+export declare function parseInteractivePromptWithGemma(snapshot: string, port: TuiGemmaPort, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<ParsedInteractivePrompt | null>;
+/** Check whether an option's label matches its row text without altering meaning or imposing ASCII word boundaries (Codex R51-F2). */
+export declare function isOptionTextRowMatch(rowContent: string, label: string): boolean;
+export interface GroundedMenuRow {
+    optionNumber: string;
+    rowText: string;
+    lineIndex: number;
+}
+/**
+ * Extract candidate option rows from snapshot and isolate the single active menu block
+ * at the bottom of the snapshot, ignoring stale options in prior scrollback blocks (Codex R52-F2).
+ */
+export declare function getActiveMenuBlock(snapshot: string): GroundedMenuRow[];
+/**
+ * Structured TerminalMenu returned by Gemma TUI parser.
+ */
+export interface GemmaTerminalMenu {
+    prompt: ParsedInteractivePrompt;
+    selectedNumber: string;
+    identity: string;
+    snapshot: string;
+}
+/**
+ * Parse an active terminal menu using Gemma with structured JSON.
+ * Returns `GemmaTerminalMenu` or `null`.
+ */
+export declare function parseActiveTerminalMenuWithGemma(snapshot: string, port: TuiGemmaPort, opts?: {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): Promise<GemmaTerminalMenu | null>;

package/dist/tui-parser/index.d.ts

@@ -0,0 +1 @@
+export { parseInteractivePromptWithGemma, parseActiveTerminalMenuWithGemma, hasInteractivePromptMarkers, buildTuiParserPrompt, parseTuiGemmaResponse, isOptionTextRowMatch, TUI_PARSER_JSON_SCHEMA, type TuiGemmaPort, type RawGemmaTuiOption, type RawGemmaTuiResponse, type GemmaTerminalMenu, } from './gemma-tui-parser';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quantiya/codevibe-core",
-  "version": "2.0.84",
+  "version": "2.0.86",
   "description": "Core library for CodeVibe plugins - shared keychain, crypto, AppSync, and auth functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",