@quantiya/codevibe-core 2.0.48 → 2.0.50

package/dist/planner/client.d.ts

@@ -26,6 +26,16 @@ export interface PlannerAppSyncTransport {
         ok: boolean;
         ms: number;
     }>;
+    generatePlannerAdvisory?(input: {
+        sessionId: string;
+        prompt: string;
+        maxTokens?: number;
+        temperature?: number;
+    }): Promise<{
+        advisoryText: string;
+        serverLatencyMs: number;
+        providerUsed: string;
+    }>;
 }
 /**
  * Crypto bridge — `encryptString` + `encryptJson` + `decryptJson`

package/dist/planner/composite-advisory.d.ts

@@ -0,0 +1,25 @@
+import type { Tier } from '../orchestration-shell/types';
+import type { AdvisoryOptions, AdvisoryRunner } from './local-advisory';
+export interface CompositeAdvisoryRunnerOptions {
+    localRunner?: AdvisoryRunner | null;
+    hostedRunner: AdvisoryRunner;
+    tier: Tier;
+    onFallbackToHosted?: (error: Error) => void;
+}
+/**
+ * CompositeAdvisoryRunner coordinates local and hosted advisory execution:
+ * - Free Tier Invariant: strictly isolates Free tier from cloud inference ($0 marginal cost).
+ * - Local-First Preference: routes natural language turns / browse to local Gemma when healthy.
+ * - Dynamic Failover: if local Gemma fails (Ollama down, crash, OOM), seamlessly falls back
+ *   to hosted Bedrock Gemma for Pro/Max users without interrupting the session.
+ */
+export declare class CompositeAdvisoryRunner implements AdvisoryRunner {
+    private readonly opts;
+    private localHealthy;
+    constructor(opts: CompositeAdvisoryRunnerOptions);
+    get runtimeLabel(): string;
+    get providerKind(): 'local' | 'hosted';
+    generateAdvisory(promptText: string, options?: AdvisoryOptions): Promise<string>;
+    warm(): Promise<boolean>;
+    unload(): Promise<boolean>;
+}

package/dist/planner/hosted-advisory.d.ts

@@ -0,0 +1,37 @@
+import type { AdvisoryOptions, AdvisoryRunner } from './local-advisory';
+import type { PlannerCryptoBridge, SessionKeyResolver } from './client';
+export interface HostedAdvisoryTransport {
+    generatePlannerAdvisory(input: {
+        sessionId: string;
+        prompt: string;
+        maxTokens?: number;
+        temperature?: number;
+    }): Promise<{
+        advisoryText: string;
+        serverLatencyMs: number;
+        providerUsed: string;
+    }>;
+}
+export interface HostedGemmaAdvisoryRunnerDeps {
+    transport: HostedAdvisoryTransport;
+    crypto: PlannerCryptoBridge;
+    sessionKeyResolver: SessionKeyResolver;
+    activeSessionIdHolder: {
+        value: string | null;
+    };
+}
+/**
+ * HostedGemmaAdvisoryRunner executes advisory text generation (browse synthesis,
+ * brainstorm, etc.) against Google Gemma 3 12B on AWS Bedrock via AppSync planner proxy.
+ *
+ * Wire payload is encrypted end-to-end with AES-256-GCM under the session key.
+ */
+export declare class HostedGemmaAdvisoryRunner implements AdvisoryRunner {
+    private readonly deps;
+    readonly runtimeLabel = "Hosted Gemma (AWS Bedrock)";
+    readonly providerKind: "hosted";
+    constructor(deps: HostedGemmaAdvisoryRunnerDeps);
+    generateAdvisory(promptText: string, options?: AdvisoryOptions): Promise<string>;
+    warm(): Promise<boolean>;
+    unload(): Promise<boolean>;
+}

package/dist/planner/index.d.ts

@@ -4,5 +4,7 @@ export { PlannerCacheLayer } from './cache';
 export { PlannerHealthMachine } from './health-state';
 export { BackendPlannerClient, PlannerBudgetExceededError, PlannerTierGateRejectedError, type PlannerAppSyncTransport, type PlannerCryptoBridge, type SessionKeyResolver, type ShellEventEmit, type EmitShellEventFn, } from './client';
 export { LocalGemmaPlannerAdapter, parseLocalGemmaPlannerDecision, PlannerOutputUnparseableError, renderLocalGemmaPlannerPrompt, type LocalGemmaPlannerRunner, } from './local-gemma';
-export { parseLocalGemmaAdvisorySummary, renderLocalGemmaFamiliarizePrompt, renderLocalGemmaMultiBrowsePrompt, renderLocalGemmaBrowsePrompt, MAX_BROWSE_CONTENT_CHARS, MAX_MULTI_BROWSE_TOTAL_CONTENT_CHARS, MAX_MULTI_BROWSE_RENDERED_PROMPT_CHARS, type LocalGemmaAdvisoryRunner, } from './local-advisory';
+export { parseLocalGemmaAdvisorySummary, renderLocalGemmaFamiliarizePrompt, renderLocalGemmaMultiBrowsePrompt, renderLocalGemmaBrowsePrompt, MAX_BROWSE_CONTENT_CHARS, MAX_MULTI_BROWSE_TOTAL_CONTENT_CHARS, MAX_MULTI_BROWSE_RENDERED_PROMPT_CHARS, type AdvisoryRunner, type AdvisoryOptions, type AdvisoryResponseFormat, type LocalGemmaAdvisoryRunner, type LocalGemmaAdvisoryOptions, type LocalGemmaAdvisoryResponseFormat, } from './local-advisory';
 export { CompositePlannerAdapter, type CompositePlannerAdapterOptions, } from './composite-adapter';
+export { HostedGemmaAdvisoryRunner, type HostedGemmaAdvisoryRunnerDeps, type HostedAdvisoryTransport, } from './hosted-advisory';
+export { CompositeAdvisoryRunner, type CompositeAdvisoryRunnerOptions, } from './composite-advisory';

package/dist/planner/local-advisory.d.ts

@@ -1,6 +1,6 @@
 import type { StructuralSummary } from '../structural-summary/types';
-export interface LocalGemmaAdvisoryRunner {
-    generateAdvisory(promptText: string, options?: LocalGemmaAdvisoryOptions): Promise<string>;
+export interface AdvisoryRunner {
+    generateAdvisory(promptText: string, options?: AdvisoryOptions): Promise<string>;
     /**
      * Dogfood #618 — optional fire-and-forget model pre-warm (load + keep_alive).
      * Never throws; resolves false on failure. Called once at shell startup.
@@ -13,10 +13,11 @@ export interface LocalGemmaAdvisoryRunner {
      */
     unload?(): Promise<boolean>;
     runtimeLabel: string;
+    readonly providerKind?: 'local' | 'hosted';
 }
-export type LocalGemmaAdvisoryResponseFormat = 'json' | 'text';
-export interface LocalGemmaAdvisoryOptions {
-    responseFormat?: LocalGemmaAdvisoryResponseFormat;
+export type AdvisoryResponseFormat = 'json' | 'text';
+export interface AdvisoryOptions {
+    responseFormat?: AdvisoryResponseFormat;
     numPredict?: number;
     /**
      * RAW base64 images (NO `data:` prefix) for the MULTIMODAL local answerer
@@ -38,7 +39,15 @@ export interface LocalGemmaAdvisoryOptions {
      * Omitted unless set; browse callers pass false (R8-F2, R9-F4).
      */
     think?: boolean;
+    /**
+     * Temperature hint for advisory generation.
+     */
+    temperature?: number;
 }
+/** Backward-compatibility aliases for local runner consumers */
+export type LocalGemmaAdvisoryRunner = AdvisoryRunner;
+export type LocalGemmaAdvisoryResponseFormat = AdvisoryResponseFormat;
+export type LocalGemmaAdvisoryOptions = AdvisoryOptions;
 export declare const MAX_RENDERED_PROMPT_CHARS = 30000;
 export declare const MAX_RENDERED_PROMPT_TOKENS = 7500;
 export declare function redactAbsoluteLocalPaths(text: string): string;

package/package.json

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