offrouter-core 0.0.0

package/src/index.ts

@@ -0,0 +1,261 @@
+/**
+ * offrouter-core public surface.
+ * Policy and router live here; provider adapters land in later milestones.
+ */
+
+export { ROUTE_PROTOCOL_VERSION } from "./protocol.js";
+export type { RouteProtocolVersion } from "./protocol.js";
+
+export type {
+  AuthScope,
+  AuthTier,
+  FallbackChainEntry,
+  FallbackReason,
+  HarnessKind,
+  HarnessRef,
+  PolicyDecision,
+  PolicyDenial,
+  PolicyDenialCode,
+  PolicyDenialTarget,
+  ProviderCandidate,
+  ProviderHealth,
+  RiskLevel,
+  RouteConstraints,
+  RouteDecision,
+  RouteRequest,
+  RouteTask,
+  SelectedRoute,
+  SubscriptionStatus,
+  TaskKind,
+  WorkspaceRef,
+} from "./types.js";
+
+export {
+  AuthScopeSchema,
+  AuthTierSchema,
+  FallbackChainEntrySchema,
+  FallbackReasonSchema,
+  HarnessKindSchema,
+  HarnessRefSchema,
+  PolicyDecisionSchema,
+  PolicyDenialCodeSchema,
+  PolicyDenialSchema,
+  PolicyDenialTargetSchema,
+  ProviderCandidateSchema,
+  ProviderHealthSchema,
+  RiskLevelSchema,
+  RouteConstraintsSchema,
+  RouteDecisionSchema,
+  RouteRequestSchema,
+  RouteTaskSchema,
+  SelectedRouteSchema,
+  SubscriptionStatusSchema,
+  TaskKindSchema,
+  WorkspaceRefSchema,
+} from "./schemas.js";
+
+export {
+  evaluatePolicy,
+  isHealthySubscriptionCapacity,
+  meetsCapabilities,
+} from "./policy.js";
+export type { PolicyConfig } from "./policy.js";
+
+export { routeRequest } from "./router.js";
+export type { RouteOptions } from "./router.js";
+
+export { DelegationPolicyError, DelegationRuntime } from "./delegation.js";
+export type {
+  DelegationEvent,
+  DelegationMode,
+  DelegationOutput,
+  DelegationRequest,
+  DelegationResult,
+  DelegationRuntimeOptions,
+  DelegationTask,
+  DelegationTaskStatus,
+} from "./delegation.js";
+
+export {
+  ConfigError,
+  defaultConfig,
+  loadConfig,
+  resolveOffRouterHome,
+} from "./config.js";
+export type {
+  ConfiguredProfile,
+  ConfiguredProvider,
+  ConfigWarning,
+  LoadConfigOptions,
+  OffRouterConfig,
+  PolicyDefaults,
+  ResolveHomeOptions,
+} from "./config.js";
+
+export {
+  FileSecretStore,
+  KeychainSecretStore,
+  KeychainUnavailableError,
+  REDACTED,
+  redact,
+} from "./secrets.js";
+export type {
+  FileSecretStoreOptions,
+  KeychainSecretStoreOptions,
+  SecretStore,
+} from "./secrets.js";
+
+export { DEFAULT_PREVIEW_MAX_CHARS, InMemoryAuditStore } from "./audit.js";
+export type {
+  AppendDecisionOptions,
+  AuditRecord,
+  AuditRecordKind,
+  AuditStore,
+  CancellationState,
+  InMemoryAuditStoreOptions,
+  ListAuditOptions,
+  MarkCancelledOptions,
+} from "./audit.js";
+
+export { InMemoryStateStore, InMemoryUsageStore } from "./usage.js";
+export type {
+  InMemoryUsageStoreOptions,
+  PaidFallbackExplanation,
+  ProviderUsageSnapshot,
+  RecordUsageResult,
+  SlidingWindowOptions,
+  StateStore,
+  UsageEvent,
+  UsageEventKind,
+  UsageStore,
+} from "./usage.js";
+
+// Provider discovery + adapters
+export {
+  PROVIDER_ADAPTER_METHODS,
+  ProviderError,
+  capabilityToCandidate,
+  isProviderError,
+  mapHttpToProviderError,
+} from "./providers/adapter.js";
+export type {
+  AuthStatus,
+  CostEstimate,
+  LimitSnapshot,
+  ModelCapability,
+  ProviderAdapter,
+  ProviderErrorCode,
+  ProviderErrorOptions,
+  ProviderEvent,
+  ProviderInvokeMessage,
+  ProviderInvokeRequest,
+} from "./providers/adapter.js";
+
+export {
+  MULTI_TIER_FAMILIES,
+  STATIC_CATALOG,
+  catalogToCandidates,
+  familyAuthTiers,
+  loadBuiltinCatalog,
+  loadStaticCatalog,
+} from "./providers/catalog.js";
+export type {
+  CatalogEntry,
+  LoadBuiltinCatalogOptions,
+  LoadCatalogOptions,
+  LogicalModelFamily,
+} from "./providers/catalog.js";
+
+export {
+  BUILTIN_PROVIDERS,
+  BUILTIN_PROVIDER_IDS,
+  getBuiltinProvider,
+  selectBuiltinProviders,
+} from "./providers/catalog-data.js";
+export type {
+  BuiltinCatalogConfig,
+  BuiltinModelFamily,
+  BuiltinProviderEntry,
+  PricingHint,
+  ProviderCatalogConfig,
+} from "./providers/catalog-data.js";
+
+export { FakeProviderAdapter, createFakeProvider } from "./providers/fake.js";
+export type { FakeModelConfig, FakeProviderOptions } from "./providers/fake.js";
+
+export {
+  OLLAMA_DUMMY_BEARER,
+  OpenAiCompatibleAdapter,
+  createOpenAiCompatibleAdapter,
+} from "./providers/openai-compatible.js";
+export type {
+  OpenAiCompatibleFlavor,
+  OpenAiCompatibleOptions,
+} from "./providers/openai-compatible.js";
+
+// Auth module (credential chain, OAuth PKCE, keychain helpers)
+export {
+  Redacted,
+  exchangeCodeForTokens,
+  generateCodeChallenge,
+  generateCodeVerifier,
+  getProviderToken,
+  isOAuthProvider,
+  PKCE_CONFIGS,
+  refreshTokens,
+  resolveCredential,
+  setProviderToken,
+  startOAuthFlow,
+} from "./auth/index.js";
+export type {
+  CredentialResult,
+  CredentialSource,
+  OAuthFlowResult,
+  OAuthFlowState,
+  OAuthProviderConfig,
+  OAuthStartOptions,
+  OAuthTokenOptions,
+  OAuthTokenResponse,
+  ResolveCredentialOptions,
+} from "./auth/index.js";
+
+// OpenAI Responses-compatible local proxy
+export {
+  CHAT_COMPLETIONS_DONE,
+  ChatCompletionsRequestSchema,
+  ChatCompletionsSseBuilder,
+  RESPONSES_PROMPT_PREVIEW_CHARS,
+  ResponsesRequestSchema,
+  ResponsesSseBuilder,
+  InvalidProxyRequestError,
+  buildDelegationRequest,
+  buildRouteRequest,
+  createResponsesProxyContext,
+  extractPromptFromChatCompletions,
+  extractPromptFromResponsesInput,
+  openAiErrorPayload,
+  policyDecisionToHttpStatus,
+  promptDigest,
+  promptPreview,
+  providerErrorCodeToHttpStatus,
+  responsesSseData,
+} from "./proxy/responses-mapper.js";
+export { startResponsesProxy } from "./proxy/responses-server.js";
+export type {
+  BuildDelegationInput,
+  BuildRouteInput,
+  ChatCompletionDeltaEvent,
+  ChatCompletionObject,
+  ChatUsageInput,
+  OpenAiErrorPayload,
+  ParsedResponsesInput,
+  ResponsesMessageItem,
+  ResponsesObject,
+  ResponsesOutputTextPart,
+  ResponsesProxyContext,
+  ResponsesUsageInput,
+} from "./proxy/responses-mapper.js";
+export type {
+  ResponsesProxyHandle,
+  ResponsesProxyOptions,
+} from "./proxy/responses-server.js";