@cavi-ai/api-client 0.1.0

package/src/extensions/cavi/fallbacks/provider.ts

@@ -0,0 +1,57 @@
+import type {
+  GatewaySnapshotFallbackProvider,
+} from "../../../core/gateway/snapshots/loaders.js";
+import type {
+  OperatorControlSnapshot,
+  ProjectBoardWorkspaceSnapshot,
+  TaskDiscourseSnapshot,
+} from "../domain/index.js";
+import {
+  fallbackAgentRuns,
+  fallbackCostHistory,
+  fallbackIncidents,
+  fallbackOverview,
+  fallbackOperatorControl,
+  fallbackProjectBoardWorkspace,
+  fallbackRoutingMatrix,
+  fallbackRunDetailForKey,
+  fallbackTaskDiscourse,
+} from "./snapshots/index.js";
+
+export type CaviControlAdapterFallbacks = {
+  projectBoardWorkspace?:
+    | ProjectBoardWorkspaceSnapshot
+    | (() => ProjectBoardWorkspaceSnapshot);
+  operatorControl?: OperatorControlSnapshot | (() => OperatorControlSnapshot);
+  taskDiscourse?:
+    | TaskDiscourseSnapshot
+    | ((taskId: string) => TaskDiscourseSnapshot);
+};
+
+export type CaviControlAdapterFallbackProvider = GatewaySnapshotFallbackProvider & {
+  cavi?: CaviControlAdapterFallbacks;
+};
+
+export function createCaviSnapshotFallbackProvider(): GatewaySnapshotFallbackProvider {
+  return {
+    snapshots: {
+      overview: fallbackOverview,
+      agentRuns: fallbackAgentRuns,
+      runDetail: fallbackRunDetailForKey,
+      routingMatrix: fallbackRoutingMatrix,
+      incidents: fallbackIncidents,
+    },
+    costHistory: fallbackCostHistory,
+  };
+}
+
+export function createCaviControlAdapterFallbackProvider(): CaviControlAdapterFallbackProvider {
+  return {
+    ...createCaviSnapshotFallbackProvider(),
+    cavi: {
+      projectBoardWorkspace: fallbackProjectBoardWorkspace,
+      operatorControl: fallbackOperatorControl,
+      taskDiscourse: fallbackTaskDiscourse,
+    },
+  };
+}

package/src/extensions/cavi/fallbacks/snapshots/agent-memory.ts

@@ -0,0 +1,8 @@
+import type { AgentMemorySnapshot } from "../../domain/index.js";
+
+export const fallbackAgentMemory: AgentMemorySnapshot = {
+  agentId: "unknown",
+  activeFiles: [],
+  journalCount: 0,
+  lastJournalDate: null,
+};

package/src/extensions/cavi/fallbacks/snapshots/cost-history.ts

@@ -0,0 +1,101 @@
+import type {
+  CostBucket,
+  CostHistoryRange,
+  CostHistorySnapshot,
+} from "../../../../core/gateway/snapshots/contracts.js";
+import { fallbackSnapshotNow as now } from "./shared.js";
+
+const PROVIDERS = ["anthropic", "openai", "google"];
+
+function createBucket(params: {
+  timestamp: number;
+  index: number;
+  range: CostHistoryRange;
+}): CostBucket {
+  const volatility = params.range === "7d" ? 0.18 : params.range === "24h" ? 0.22 : 0.3;
+  const oscillation = 1 + Math.sin(params.index / 4) * volatility;
+  const baseTokens = params.range === "7d" ? 72_000 : params.range === "24h" ? 24_000 : 8_400;
+
+  const providerBreakdown = PROVIDERS.map((provider, providerIndex) => {
+    const providerWeight = providerIndex === 0 ? 0.52 : providerIndex === 1 ? 0.33 : 0.15;
+    const tokens = Math.max(0, Math.round(baseTokens * providerWeight * oscillation));
+    const costPerToken = provider === "anthropic" ? 0.0000072 : provider === "openai" ? 0.0000061 : 0.0000048;
+
+    return {
+      provider,
+      tokens,
+      cost: Number((tokens * costPerToken).toFixed(4)),
+    };
+  });
+
+  const totalTokens = providerBreakdown.reduce((sum, item) => sum + item.tokens, 0);
+  const estimatedCostUsd = Number(
+    providerBreakdown.reduce((sum, item) => sum + item.cost, 0).toFixed(4),
+  );
+
+  return {
+    timestamp: params.timestamp,
+    activeSessions: Math.max(1, Math.round(6 + Math.cos(params.index / 3) * 2 + (params.range === "7d" ? 3 : 0))),
+    totalTokens,
+    estimatedCostUsd,
+    totalErrors: params.index % (params.range === "1h" ? 13 : 19) === 0 ? 1 : 0,
+    providerBreakdown,
+  };
+}
+
+function buildSnapshot(params: {
+  range: CostHistoryRange;
+  resolution: "1m" | "5m" | "15m" | "1h";
+  bucketCount: number;
+  stepMs: number;
+}): CostHistorySnapshot {
+  const buckets = Array.from({ length: params.bucketCount }, (_, index) => {
+    const timestamp = now - (params.bucketCount - 1 - index) * params.stepMs;
+    return createBucket({ timestamp, index, range: params.range });
+  });
+
+  return {
+    range: params.range,
+    resolution: params.resolution,
+    generatedAt: now,
+    buckets,
+    totals: {
+      totalTokens: buckets.reduce((sum, bucket) => sum + bucket.totalTokens, 0),
+      estimatedCostUsd: Number(
+        buckets.reduce((sum, bucket) => sum + bucket.estimatedCostUsd, 0).toFixed(2),
+      ),
+      totalErrors: buckets.reduce((sum, bucket) => sum + bucket.totalErrors, 0),
+    },
+  };
+}
+
+const COST_HISTORY_BY_RANGE: Record<CostHistoryRange, CostHistorySnapshot> = {
+  "1h": buildSnapshot({
+    range: "1h",
+    resolution: "1m",
+    bucketCount: 60,
+    stepMs: 60_000,
+  }),
+  "6h": buildSnapshot({
+    range: "6h",
+    resolution: "5m",
+    bucketCount: 72,
+    stepMs: 5 * 60_000,
+  }),
+  "24h": buildSnapshot({
+    range: "24h",
+    resolution: "15m",
+    bucketCount: 96,
+    stepMs: 15 * 60_000,
+  }),
+  "7d": buildSnapshot({
+    range: "7d",
+    resolution: "1h",
+    bucketCount: 7 * 24,
+    stepMs: 60 * 60_000,
+  }),
+};
+
+export function fallbackCostHistory(range: CostHistoryRange): CostHistorySnapshot {
+  return structuredClone(COST_HISTORY_BY_RANGE[range]);
+}

package/src/extensions/cavi/fallbacks/snapshots/incidents.ts

@@ -0,0 +1,56 @@
+import type {
+  IncidentRecord,
+  IncidentsSnapshot,
+} from "../../../../core/gateway/snapshots/contracts.js";
+import { fallbackSnapshotNow as now } from "./shared.js";
+
+const incidents: IncidentRecord[] = [
+  {
+    id: "inc-logs-1",
+    title: "CI remediator timeout",
+    summary: "Subagent cleanup exceeded 30s timeout window.",
+    severity: "high",
+    status: "investigating",
+    firstSeenAt: now - 6 * 60 * 60_000,
+    lastSeenAt: now - 5 * 60_000,
+    count: 4,
+    owner: "qa-operator-qa",
+    repeatedAcrossAgents: true,
+    flaggedForImmediateFix: true,
+    scope: "cavi-control",
+    agentIds: ["qa-operator-qa", "primary-operator", "backend-operator"],
+    workTaskAssigned: "fix-ci-cleanup-timeout",
+  },
+  {
+    id: "inc-logs-2",
+    title: "Gateway auth retry spike",
+    summary: "Burst of unauthorized ws connect attempts from non-paired browser clients.",
+    severity: "medium",
+    status: "open",
+    firstSeenAt: now - 4 * 60 * 60_000,
+    lastSeenAt: now - 24 * 60_000,
+    count: 7,
+    owner: "primary-operator",
+    scope: "gateway",
+    agentIds: ["primary-operator"],
+  },
+  {
+    id: "inc-logs-3",
+    title: "Bad planning: scope creep on Project Board sync",
+    summary: "Agent repeatedly extended task scope without re-estimating. Led to stalled PR.",
+    severity: "medium",
+    status: "blocked",
+    firstSeenAt: now - 2 * 24 * 60 * 60_000,
+    lastSeenAt: now - 3 * 60 * 60_000,
+    count: 2,
+    owner: "ui-operator",
+    planningRelated: true,
+    scope: "bloktix",
+    agentIds: ["ui-operator", "qa-operator"],
+  },
+];
+
+export const fallbackIncidents: IncidentsSnapshot = {
+  incidents: [...incidents],
+  blockers: incidents.filter((incident) => incident.status === "blocked"),
+};

package/src/extensions/cavi/fallbacks/snapshots/index.ts

@@ -0,0 +1,9 @@
+export { fallbackSnapshotNow } from "./shared.js";
+export { fallbackAgentRuns, fallbackRunDetailForKey } from "./runs.js";
+export { fallbackOverview } from "./overview.js";
+export { fallbackRoutingMatrix } from "./routing.js";
+export { fallbackProjectBoardWorkspace } from "../../project-board/fallback.js";
+export { fallbackOperatorControl } from "./operator-control/index.js";
+export { fallbackTaskDiscourse } from "../../discourse/fallback.js";
+export { fallbackIncidents } from "./incidents.js";
+export { fallbackCostHistory } from "./cost-history.js";

package/src/extensions/cavi/fallbacks/snapshots/library.ts

@@ -0,0 +1,112 @@
+import type { FleetLibrarySnapshot } from "../../domain/index.js";
+
+export const fallbackFleetLibrary: FleetLibrarySnapshot = {
+  generatedAt: Date.now(),
+  teams: [
+    {
+      teamId: "angels",
+      teamName: "Angels",
+      lead: "service-operator",
+      inboxCount: 0,
+      candidatesCount: 0,
+      promotedCount: 0,
+      rejectedCount: 0,
+      recentPromotions: [],
+      qmdHealth: { lastIndexedAt: null, collectionSize: 0, healthy: true },
+    },
+    {
+      teamId: "research-team",
+      teamName: "research team",
+      lead: "research-operator",
+      inboxCount: 3,
+      candidatesCount: 2,
+      promotedCount: 8,
+      rejectedCount: 1,
+      recentPromotions: [
+        {
+          id: "note_70a1bc23def45678",
+          title: "OpenClaw Architecture Deep Dive",
+          note_type: "source",
+          promoted_at: "2026-04-09T14:30:00Z",
+          promoted_by: "research-operator",
+        },
+      ],
+      qmdHealth: { lastIndexedAt: Date.now() - 600_000, collectionSize: 8, healthy: true },
+    },
+    {
+      teamId: "team-gamma",
+      teamName: "Griselda",
+      lead: "portal-media",
+      inboxCount: 2,
+      candidatesCount: 3,
+      promotedCount: 5,
+      rejectedCount: 1,
+      recentPromotions: [
+        {
+          id: "note_69d8de74aeef5a44",
+          title: "Truth Serum Comedy Bible",
+          note_type: "concept",
+          promoted_at: "2026-04-10T00:00:00Z",
+          promoted_by: "portal-media",
+        },
+        {
+          id: "note_69d8de746135a5a5",
+          title: "Seed Corpus Policy",
+          note_type: "concept",
+          promoted_at: "2026-04-10T00:00:00Z",
+          promoted_by: "portal-media",
+        },
+      ],
+      qmdHealth: { lastIndexedAt: Date.now() - 300_000, collectionSize: 5, healthy: true },
+    },
+    {
+      teamId: "team-delta",
+      teamName: "Headhunter",
+      lead: "portal-alpha",
+      inboxCount: 0,
+      candidatesCount: 0,
+      promotedCount: 0,
+      rejectedCount: 0,
+      recentPromotions: [],
+      qmdHealth: { lastIndexedAt: null, collectionSize: 0, healthy: true },
+    },
+    {
+      teamId: "team-alpha",
+      teamName: "Wu-Tang",
+      lead: "operator-a",
+      inboxCount: 0,
+      candidatesCount: 0,
+      promotedCount: 0,
+      rejectedCount: 0,
+      recentPromotions: [],
+      qmdHealth: { lastIndexedAt: null, collectionSize: 0, healthy: true },
+    },
+    {
+      teamId: "team-beta",
+      teamName: "Run-DMC",
+      lead: "reverend-run",
+      inboxCount: 0,
+      candidatesCount: 0,
+      promotedCount: 0,
+      rejectedCount: 0,
+      recentPromotions: [],
+      qmdHealth: { lastIndexedAt: null, collectionSize: 0, healthy: true },
+    },
+    {
+      teamId: "project-ops",
+      teamName: "Paw & Order",
+      lead: "project-board",
+      inboxCount: 0,
+      candidatesCount: 0,
+      promotedCount: 0,
+      rejectedCount: 0,
+      recentPromotions: [],
+      qmdHealth: { lastIndexedAt: null, collectionSize: 0, healthy: true },
+    },
+  ],
+  sigmund: {
+    status: "online",
+    lastIngestAt: Date.now() - 120_000,
+    totalProcessed: 14,
+  },
+};

package/src/extensions/cavi/fallbacks/snapshots/operator-control/defaults.ts

@@ -0,0 +1,57 @@
+import type {
+  OperatorRegistryAgent,
+  OperatorRegistryRuntime,
+  OperatorRegistryTeam,
+} from "../../../domain/index.js";
+
+/** Default values for new agent fields — spread into each mock agent. */
+export const agentDefaults: Pick<
+  OperatorRegistryAgent,
+  | "repoConfig"
+  | "capabilities"
+  | "mcpAccess"
+  | "reviewHandles"
+  | "executionMode"
+  | "identity"
+  | "ownership"
+  | "roleBoundary"
+  | "tokenEnv"
+  | "boardUrl"
+  | "k8sService"
+  | "delegatesTo"
+> = {
+  repoConfig: null,
+  capabilities: [],
+  mcpAccess: [],
+  reviewHandles: [],
+  executionMode: null,
+  identity: null,
+  ownership: null,
+  roleBoundary: null,
+  tokenEnv: null,
+  boardUrl: null,
+  k8sService: null,
+  delegatesTo: [],
+};
+
+/** Default values for new team fields. */
+export const teamDefaults: Pick<
+  OperatorRegistryTeam,
+  "department" | "teamManifest" | "headOwnedAliases" | "runtimeMembers"
+> = {
+  department: null,
+  teamManifest: null,
+  headOwnedAliases: [],
+  runtimeMembers: [],
+};
+
+/** Default values for new k8s fields. */
+export const k8sDefaults: Pick<
+  OperatorRegistryRuntime,
+  "port" | "replicas" | "endpoints" | "discordBotId"
+> = {
+  port: null,
+  replicas: null,
+  endpoints: [],
+  discordBotId: null,
+};

package/src/extensions/cavi/fallbacks/snapshots/operator-control/index.ts

@@ -0,0 +1,3 @@
+export { agentDefaults, k8sDefaults, teamDefaults } from "./defaults.js";
+export { fallbackDelegatedTransport, fallbackLegacyWorkerFleet } from "./transports.js";
+export { fallbackOperatorControl } from "./snapshot.js";

package/src/extensions/cavi/fallbacks/snapshots/operator-control/snapshot-memory.ts

@@ -0,0 +1,65 @@
+import type { OperatorControlSnapshot } from "../../../domain/index.js";
+import { fallbackSnapshotNow as now } from "../shared.js";
+
+export const fallbackOperatorControlMemory: OperatorControlSnapshot["memory"] = {
+  authority: "vector-memory",
+  storePath: "/state/cavi-control/operator-shared-memory.json",
+  generatedAt: now - 45_000,
+  collections: {
+    "service-context": {
+      count: 4,
+      lastVerifiedAt: now - 4 * 60_000,
+      writeMode: "upsert",
+    },
+    "task-outcomes": {
+      count: 17,
+      lastVerifiedAt: now - 2 * 60_000,
+      writeMode: "append-only",
+    },
+    "contract-registry": {
+      count: 11,
+      lastVerifiedAt: now - 19 * 60_000,
+      writeMode: "upsert",
+    },
+    "channel-events": {
+      count: 23,
+      lastVerifiedAt: now - 1 * 60_000,
+      writeMode: "append-only",
+    },
+  },
+  records: [
+    {
+      collection: "task-outcomes",
+      recordId: "task-operator-1-outcome",
+      scopeKey: "task-operator-1",
+      summary: null,
+      content: {
+        task_id: "task-operator-1",
+        outcome: "success",
+      },
+      metadata: {
+        source: "operator-http-test",
+        writer: "verification-operator",
+        evidence_ref: "task://task-operator-1",
+        verified_at: now - 2 * 60_000,
+      },
+      promotedAt: now - 2 * 60_000,
+    },
+    {
+      collection: "service-context",
+      recordId: "service-context:operator-a",
+      scopeKey: "operator-a",
+      summary: "operator control owns operator routing",
+      content: {
+        primary: true,
+      },
+      metadata: {
+        source: "operator-http-test",
+        writer: "operator-a",
+        evidence_ref: "task://task-operator-1",
+        verified_at: now - 3 * 60_000,
+      },
+      promotedAt: now - 3 * 60_000,
+    },
+  ],
+};