@flowdesk/opencode-plugin 0.1.12 → 0.1.14

package/dist/model-selection-engine.js

@@ -0,0 +1,175 @@
+/**
+ * Usage-weighted model selection engine.
+ *
+ * Maps task roles to candidate model tiers and uses current provider usage
+ * to weight the probability of selecting each model. Low-usage providers are
+ * deprioritized; exhausted providers are excluded.
+ */
+// ---------------------------------------------------------------------------
+// Model catalog – ordered by preference within each tier
+// ---------------------------------------------------------------------------
+const HEAVY_MODELS = [
+    { providerQualifiedModelId: "anthropic/claude-opus-4-7", providerFamily: "claude", agentName: "reviewer-claude-opus", tier: "heavy" },
+    { providerQualifiedModelId: "openai/gpt-5.5", providerFamily: "openai", agentName: "reviewer-gpt-frontier", tier: "heavy" },
+];
+const MEDIUM_MODELS = [
+    { providerQualifiedModelId: "openai/gpt-5.5", providerFamily: "openai", agentName: "reviewer-gpt-frontier", tier: "medium" },
+    { providerQualifiedModelId: "anthropic/claude-sonnet-4-6", providerFamily: "claude", agentName: "reviewer-claude-opus", tier: "medium" },
+    { providerQualifiedModelId: "google/gemini-3.1-pro-preview", providerFamily: "gemini", usageKey: "gemini-pro", agentName: "reviewer-gemini-pro", tier: "medium" },
+    { providerQualifiedModelId: "google/gemini-3.1-flash-preview", providerFamily: "gemini", usageKey: "gemini-flash", agentName: "reviewer-gemini-pro", tier: "medium" },
+];
+const LIGHT_MODELS = [
+    { providerQualifiedModelId: "openai/gpt-5.5", providerFamily: "openai", agentName: "reviewer-gpt-frontier", tier: "light" },
+    { providerQualifiedModelId: "anthropic/claude-sonnet-4-6", providerFamily: "claude", agentName: "reviewer-claude-opus", tier: "light" },
+    { providerQualifiedModelId: "google/gemini-3.1-flash-lite-preview", providerFamily: "gemini", usageKey: "gemini-flash-lite", agentName: "reviewer-gemini-pro", tier: "light" },
+];
+// Role → preferred tier + candidate pool
+// Heavy roles: only heavy models (high quality required)
+// Medium roles: medium first, heavy fallback
+// Light roles: light first, medium fallback
+const ROLE_TIER_MAP = {
+    security: { tier: "heavy", candidates: [...HEAVY_MODELS] },
+    architecture: { tier: "heavy", candidates: [HEAVY_MODELS[1], HEAVY_MODELS[0]] },
+    review: { tier: "heavy", candidates: [...HEAVY_MODELS, ...MEDIUM_MODELS] },
+    decision: { tier: "medium", candidates: [...MEDIUM_MODELS, ...HEAVY_MODELS] },
+    implementation: { tier: "medium", candidates: [...MEDIUM_MODELS] },
+    verification: { tier: "medium", candidates: [...MEDIUM_MODELS] },
+    performance: { tier: "medium", candidates: [...MEDIUM_MODELS] },
+    migration: { tier: "medium", candidates: [...MEDIUM_MODELS, ...HEAVY_MODELS] },
+    exploration: { tier: "light", candidates: [...LIGHT_MODELS, ...MEDIUM_MODELS] },
+    documentation: { tier: "light", candidates: [...LIGHT_MODELS, ...MEDIUM_MODELS] },
+    git: { tier: "light", candidates: [...LIGHT_MODELS] },
+};
+// ---------------------------------------------------------------------------
+// Usage weight calculation
+// ---------------------------------------------------------------------------
+function usageWeight(usage) {
+    if (!usage)
+        return 0.2; // unknown provider → low weight
+    if (usage.alertLevel === "exhausted")
+        return 0;
+    if (usage.alertLevel === "critical")
+        return 0.05;
+    const pct = usage.remainingPercent;
+    if (pct === null)
+        return 0.1;
+    if (pct > 50)
+        return 1.0;
+    if (pct > 30)
+        return 0.7;
+    if (pct > 10)
+        return 0.3;
+    return 0.05;
+}
+function usageNote(usage) {
+    if (!usage)
+        return "usage unknown";
+    if (usage.alertLevel === "exhausted")
+        return "exhausted – excluded";
+    if (usage.alertLevel === "critical")
+        return `critical (${usage.remainingPercent ?? "?"}% left)`;
+    if (usage.alertLevel === "warning")
+        return `warning (${usage.remainingPercent ?? "?"}% left)`;
+    return `ok (${usage.remainingPercent ?? "?"}% left)`;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Select the best model for a task given current provider usage.
+ * Uses weighted random selection so lower-usage providers are preferred
+ * without completely blocking higher-usage ones.
+ */
+export function selectModelForTask(role, usageByFamily, now) {
+    void now; // reserved for future TTL checks
+    const mapping = ROLE_TIER_MAP[role];
+    if (!mapping)
+        return undefined;
+    // Deduplicate by providerQualifiedModelId and compute weights
+    const seen = new Set();
+    const weighted = [];
+    for (const candidate of mapping.candidates) {
+        if (seen.has(candidate.providerQualifiedModelId))
+            continue;
+        seen.add(candidate.providerQualifiedModelId);
+        const usage = usageByFamily.get(candidate.usageKey ?? candidate.providerFamily) ?? usageByFamily.get(candidate.providerFamily);
+        const weight = usageWeight(usage);
+        if (weight <= 0)
+            continue; // exhausted – skip entirely
+        weighted.push({ candidate, weight, usageNote: usageNote(usage) });
+    }
+    if (weighted.length === 0)
+        return undefined;
+    // Weighted random pick
+    const total = weighted.reduce((sum, r) => sum + r.weight, 0);
+    let rand = Math.random() * total;
+    for (const r of weighted) {
+        rand -= r.weight;
+        if (rand <= 0)
+            return r;
+    }
+    return weighted[weighted.length - 1];
+}
+/**
+ * Build a usage map from the sidebar cache provider rows.
+ */
+export function buildUsageMapFromProviders(providers) {
+    const map = new Map();
+    for (const p of providers) {
+        if (p.providerFamily !== "claude" && p.providerFamily !== "openai" && p.providerFamily !== "gemini")
+            continue;
+        const providerUsage = {
+            providerFamily: p.providerFamily,
+            remainingPercent: p.remainingPercent,
+            alertLevel: p.alertLevel ?? "unknown",
+        };
+        map.set(p.providerFamily, providerUsage);
+        if (p.providerFamily !== "gemini")
+            continue;
+        for (const bucket of p.buckets ?? []) {
+            const usageKey = geminiUsageKeyFromResetBucket(bucket.resetBucket);
+            if (usageKey === undefined)
+                continue;
+            const usage = {
+                providerFamily: "gemini",
+                remainingPercent: bucket.remainingPercent,
+                alertLevel: alertLevelForBucket(bucket.remainingPercent, bucket.freshness, bucket.alertLevel),
+            };
+            const existing = map.get(usageKey);
+            if (existing === undefined || usageRank(usage) < usageRank(existing))
+                map.set(usageKey, usage);
+        }
+    }
+    return map;
+}
+function geminiUsageKeyFromResetBucket(value) {
+    const normalized = value?.toLowerCase().trim().replace(/^[0-9]+(?:\.[0-9]+)?%\s+/, "") ?? "";
+    if (normalized.startsWith("gemini-flash-lite"))
+        return "gemini-flash-lite";
+    if (normalized.startsWith("gemini-flash"))
+        return "gemini-flash";
+    if (normalized.startsWith("gemini-pro"))
+        return "gemini-pro";
+    return undefined;
+}
+function alertLevelForBucket(remainingPercent, freshness, explicit) {
+    if (explicit === "ok" || explicit === "warning" || explicit === "critical" || explicit === "exhausted" || explicit === "stale" || explicit === "unknown")
+        return explicit;
+    if (freshness !== undefined && freshness !== "fresh")
+        return freshness === "stale" ? "stale" : "unknown";
+    if (remainingPercent === null)
+        return "unknown";
+    if (remainingPercent <= 0)
+        return "exhausted";
+    if (remainingPercent <= 10)
+        return "critical";
+    if (remainingPercent <= 30)
+        return "warning";
+    return "ok";
+}
+function usageRank(usage) {
+    if (usage.remainingPercent !== null)
+        return usage.remainingPercent;
+    return usage.alertLevel === "unknown" || usage.alertLevel === "stale" ? Number.POSITIVE_INFINITY : 100;
+}
+//# sourceMappingURL=model-selection-engine.js.map

package/dist/model-selection-engine.js.map

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

package/dist/provider-usage-live-tool.d.ts

@@ -1,3 +1,4 @@
+import { type FlowDeskProviderHealthSnapshotV1 } from "@flowdesk/core";
 export type FlowDeskProviderUsageLiveProviderFamilyV1 = "claude" | "openai" | "gemini";
 export interface FlowDeskProviderUsageLiveConfigV1 {
     homeDir?: string;
@@ -9,8 +10,10 @@ export interface FlowDeskProviderUsageLiveConfigV1 {
     geminiOAuthClientSecret?: string;
     geminiProjectId?: string;
     persistSnapshots?: boolean;
+    persistSidebarCache?: boolean;
     durableStateRootDir?: string;
     persistWorkflowId?: string;
+    appendToChat?: boolean;
 }
 export interface FlowDeskProviderUsageLiveRequestV1 {
     providerFamily?: string;
@@ -31,6 +34,14 @@ export interface FlowDeskProviderUsageLiveProviderRowV1 {
     redactedReason?: string;
     usageSnapshotRef?: string;
     providerHealthSnapshotRef?: string;
+    providerHealth?: {
+        snapshotRef: string;
+        freshness: FlowDeskProviderHealthSnapshotV1["freshness"];
+        availabilityState: FlowDeskProviderHealthSnapshotV1["availability_state"];
+        failureClass: FlowDeskProviderHealthSnapshotV1["failure_class"];
+        dispatchability: FlowDeskProviderHealthSnapshotV1["dispatchability"];
+        sourceSurface: FlowDeskProviderHealthSnapshotV1["source_surface"];
+    };
     usageAuthorityAcquired: boolean;
 }
 export interface FlowDeskProviderUsageLiveSnapshotPersistenceV1 {
@@ -40,6 +51,20 @@ export interface FlowDeskProviderUsageLiveSnapshotPersistenceV1 {
     persistedEvidenceIds: readonly string[];
     skippedReasons: readonly string[];
 }
+export interface FlowDeskProviderUsageLiveSnapshotReuseV1 {
+    requested: boolean;
+    durableStateRootConfigured: boolean;
+    workflowId?: string;
+    reusedEvidenceIds: readonly string[];
+    skippedReasons: readonly string[];
+}
+export interface FlowDeskProviderUsageLiveSidebarCachePersistenceV1 {
+    requested: boolean;
+    durableStateRootConfigured: boolean;
+    cachePathRef?: string;
+    persisted: boolean;
+    skippedReasons: readonly string[];
+}
 export interface FlowDeskProviderUsageLiveResultV1 {
     status: "provider_usage_live_collected" | "blocked_before_provider_usage_live";
     observedAt: string;
@@ -49,7 +74,9 @@ export interface FlowDeskProviderUsageLiveResultV1 {
     worstAlertLevel: FlowDeskProviderUsageLiveAlertLevelV1;
     overallRecommendation: string;
     redactedBlockReason?: string;
+    snapshotReuse?: FlowDeskProviderUsageLiveSnapshotReuseV1;
     snapshotPersistence?: FlowDeskProviderUsageLiveSnapshotPersistenceV1;
+    sidebarCachePersistence?: FlowDeskProviderUsageLiveSidebarCachePersistenceV1;
     safeNextActions: readonly ("/flowdesk-doctor" | "/flowdesk-status")[];
     authority: {
         realOpenCodeDispatch: false;

package/dist/provider-usage-live-tool.d.ts.map

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