@flowdesk/core 0.1.0

package/dist/provider-failures.js

@@ -0,0 +1,116 @@
+import { PROVIDER_FAILURE_CLASSES } from "./release1-contracts.js";
+const providerDiagnosticActions = ["/flowdesk-doctor", "/flowdesk-usage", "/flowdesk-status", "/flowdesk-export-debug"];
+const modelDiagnosticActions = ["/flowdesk-doctor", "/flowdesk-status", "/flowdesk-export-debug"];
+const retryDiagnosticActions = ["/flowdesk-doctor", "/flowdesk-usage", "/flowdesk-status", "/flowdesk-retry", "/flowdesk-export-debug"];
+const noFailureActions = ["/flowdesk-status", "/flowdesk-usage", "/flowdesk-export-debug"];
+const mappingByFailureClass = {
+    none: {
+        availability_state: "healthy",
+        dispatchability: "diagnostic_only",
+        diagnostic_status: "diagnostic_only",
+        retry_state: "planned",
+        redacted_category: "provider_health",
+        safe_next_actions: [...noFailureActions],
+        safe_remediation: "Provider health has no recorded failure; continue with Release 1 diagnostic status checks."
+    },
+    auth_missing: {
+        availability_state: "unavailable",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "blocked",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_api",
+        safe_next_actions: [...providerDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and provider setup checks; retry planning remains diagnostic-only until credentials are fixed."
+    },
+    auth_expired: {
+        availability_state: "unavailable",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "blocked",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_api",
+        safe_next_actions: [...providerDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and refresh provider authentication outside FlowDesk before retry planning."
+    },
+    provider_unavailable: {
+        availability_state: "unavailable",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "blocked",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_health",
+        safe_next_actions: [...providerDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and /flowdesk-usage to refresh redacted provider availability diagnostics."
+    },
+    rate_limited: {
+        availability_state: "degraded",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "degraded",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_api",
+        safe_next_actions: [...retryDiagnosticActions],
+        safe_remediation: "Run /flowdesk-usage and /flowdesk-status; retry planning stays diagnostic-only until provider limits are fresh and healthy."
+    },
+    model_unavailable: {
+        availability_state: "unavailable",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "blocked",
+        retry_state: "diagnostic_only",
+        redacted_category: "model_availability",
+        safe_next_actions: [...modelDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and inspect model availability diagnostics before planning another attempt."
+    },
+    transport_timeout: {
+        availability_state: "unknown",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "degraded",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_api",
+        safe_next_actions: [...retryDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and /flowdesk-status to refresh transport diagnostics before retry planning."
+    },
+    provider_error: {
+        availability_state: "degraded",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "degraded",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_api",
+        safe_next_actions: [...providerDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and inspect redacted provider API diagnostics before retry planning."
+    },
+    opencode_provider_load_failure: {
+        availability_state: "unavailable",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "blocked",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_health",
+        safe_next_actions: [...providerDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor to inspect OpenCode provider loading diagnostics before retry planning."
+    },
+    telemetry_ambiguous: {
+        availability_state: "unknown",
+        dispatchability: "non_dispatchable",
+        diagnostic_status: "diagnostic_only",
+        retry_state: "diagnostic_only",
+        redacted_category: "provider_health",
+        safe_next_actions: [...providerDiagnosticActions],
+        safe_remediation: "Run /flowdesk-doctor and /flowdesk-status to refresh ambiguous provider telemetry."
+    }
+};
+export function mapProviderFailureClassToDiagnosticOutcomeV1(failureClass) {
+    const mapping = mappingByFailureClass[failureClass];
+    return {
+        failure_class: failureClass,
+        ...mapping,
+        safe_next_actions: [...mapping.safe_next_actions],
+        dispatch_authorized: false,
+        fallback_authorized: false,
+        provider_call_authorized: false,
+        hard_chat_authority: false
+    };
+}
+export function getProviderFailureDiagnosticMappingsV1() {
+    return PROVIDER_FAILURE_CLASSES.map((failureClass) => mapProviderFailureClassToDiagnosticOutcomeV1(failureClass));
+}
+export function providerFailureClassIsDiagnosticOnlyV1(failureClass) {
+    return failureClass !== "none";
+}
+//# sourceMappingURL=provider-failures.js.map

package/dist/provider-failures.js.map

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

package/dist/provider-usage-collector.d.ts

@@ -0,0 +1,60 @@
+import type { FlowDeskManagedDispatchBetaUsageAuthorityEvidenceV1, FlowDeskProviderHealthSnapshotV1, FlowDeskUsageSnapshotV1, ProviderFamily } from "./release1-contracts.js";
+type ConcreteProviderFamily = Exclude<ProviderFamily, "unknown" | "all">;
+type CollectorProviderFamily = Extract<ConcreteProviderFamily, "claude" | "openai" | "gemini">;
+export interface FlowDeskProviderUsageCollectorTargetV1 {
+    providerFamily: CollectorProviderFamily;
+    providerQualifiedModelId: string;
+    modelFamily: string;
+    usageSnapshotId: string;
+    authorityRef: string;
+    sourceRef: string;
+    conformanceRef: string;
+    redactedEvidenceRefs: readonly string[];
+    observedAt?: string;
+    freshnessTtlMinutes?: number;
+}
+export interface FlowDeskProviderUsageAcquisitionConfigV1 {
+    enabled?: boolean;
+    homeDir?: string;
+    providers?: readonly CollectorProviderFamily[];
+    claudeOAuthUsage?: boolean;
+    codexLiveUsage?: boolean;
+    geminiOAuthClientId?: string;
+    geminiOAuthClientSecret?: string;
+    geminiProjectId?: string;
+    geminiQuota?: boolean;
+}
+export interface FlowDeskProviderUsageCollectorOptionsV1 {
+    filesystem?: FlowDeskProviderUsageFileSystemV1;
+    env?: Record<string, string | undefined>;
+    fetch?: FlowDeskProviderUsageFetchV1;
+    execFile?: FlowDeskProviderUsageExecFileV1;
+    now?: () => number;
+}
+export interface FlowDeskProviderUsageFileSystemV1 {
+    exists(path: string): boolean;
+    readFile(path: string): string;
+}
+export interface FlowDeskProviderUsageFetchResponseV1 {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}
+export interface FlowDeskProviderUsageFetchRequestV1 {
+    method: "GET" | "POST";
+    headers: Record<string, string>;
+    body?: string;
+}
+export type FlowDeskProviderUsageFetchV1 = (url: string, init: FlowDeskProviderUsageFetchRequestV1) => Promise<FlowDeskProviderUsageFetchResponseV1>;
+export type FlowDeskProviderUsageExecFileV1 = (file: string, args: string[]) => string;
+export interface FlowDeskProviderUsageCollectorResultV1 {
+    ok: boolean;
+    source_kind: "provider_native";
+    usageSnapshot: FlowDeskUsageSnapshotV1;
+    providerHealthSnapshot: FlowDeskProviderHealthSnapshotV1;
+    usageAuthorityEvidence?: FlowDeskManagedDispatchBetaUsageAuthorityEvidenceV1;
+    redacted_reason?: string;
+}
+export declare function collectManagedDispatchBetaUsageEvidenceV1(target: FlowDeskProviderUsageCollectorTargetV1, acquisition: FlowDeskProviderUsageAcquisitionConfigV1 | undefined, options?: FlowDeskProviderUsageCollectorOptionsV1): Promise<FlowDeskProviderUsageCollectorResultV1>;
+export {};
+//# sourceMappingURL=provider-usage-collector.d.ts.map

package/dist/provider-usage-collector.d.ts.map

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