opendevbrowser 0.0.15 → 0.0.16

package/dist/providers/adaptive-concurrency.d.ts

@@ -0,0 +1,42 @@
+import type { AdaptiveConcurrencyDiagnostics } from "./types";
+export interface AdaptiveConcurrencyConfig {
+    enabled: boolean;
+    baselineGlobal: number;
+    baselineScoped: number;
+    minGlobal?: number;
+    maxGlobal: number;
+    minScoped?: number;
+    maxScoped: number;
+    windowSize?: number;
+    cooldownMs?: number;
+    increaseStep?: number;
+    decreaseFactor?: number;
+    healthyLatencyMs?: number;
+}
+export interface AdaptiveSignal {
+    latencyMs: number;
+    timeout?: boolean;
+    challenge?: boolean;
+    http4xx?: boolean;
+    http5xx?: boolean;
+    queuePressure?: number;
+}
+export declare class AdaptiveConcurrencyController {
+    private readonly config;
+    private readonly global;
+    private readonly scoped;
+    private readonly minGlobal;
+    private readonly minScoped;
+    private readonly windowSize;
+    private readonly cooldownMs;
+    private readonly increaseStep;
+    private readonly decreaseFactor;
+    private readonly healthyLatencyMs;
+    constructor(config: AdaptiveConcurrencyConfig);
+    snapshot(scope: string): AdaptiveConcurrencyDiagnostics;
+    observe(scope: string, signal: AdaptiveSignal, nowMs?: number): void;
+    private getScoped;
+    private record;
+    private adjust;
+}
+//# sourceMappingURL=adaptive-concurrency.d.ts.map

package/dist/providers/adaptive-concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive-concurrency.d.ts","sourceRoot":"","sources":["../../src/providers/adaptive-concurrency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA+BD,qBAAa,6BAA6B;IAW5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAEb,MAAM,EAAE,yBAAyB;IAe9D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,8BAA8B;IAmCvD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,SAAa,GAAG,IAAI;IAWxE,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,MAAM;CAsCf"}

package/dist/providers/artifacts.d.ts

@@ -0,0 +1,34 @@
+export declare const DEFAULT_ARTIFACT_TTL_HOURS = 72;
+export declare const MAX_ARTIFACT_TTL_HOURS = 168;
+type ArtifactContent = string | Buffer | Record<string, unknown>;
+export interface ArtifactFile {
+    path: string;
+    content: ArtifactContent;
+}
+export interface ArtifactManifest {
+    run_id: string;
+    created_at: string;
+    ttl_hours: number;
+    expires_at: string;
+    files: string[];
+}
+export interface ArtifactBundle {
+    runId: string;
+    basePath: string;
+    manifest: ArtifactManifest;
+    manifestFileName: string;
+}
+export declare const createArtifactBundle: (args: {
+    namespace: string;
+    files: ArtifactFile[];
+    outputDir?: string;
+    ttlHours?: number;
+    manifestFileName?: string;
+    now?: Date;
+}) => Promise<ArtifactBundle>;
+export declare const cleanupExpiredArtifacts: (rootDir: string, now?: Date) => Promise<{
+    removed: string[];
+    skipped: string[];
+}>;
+export {};
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/providers/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/providers/artifacts.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAgBD,eAAO,MAAM,oBAAoB,GAAU,MAAM;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,KAAG,OAAO,CAAC,cAAc,CAsCzB,CAAC;AAQF,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,MAAK,IAAiB,KACrB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA6DlD,CAAC"}

package/dist/providers/blocker.d.ts

@@ -0,0 +1,47 @@
+import type { BlockerArtifactCaps, BlockerArtifactsV1, BlockerSignalV1, BlockerType, ProviderReasonCode } from "./types";
+export declare const DEFAULT_BLOCKER_ARTIFACT_CAPS: BlockerArtifactCaps;
+export interface BlockerClassificationInput {
+    source: BlockerSignalV1["source"];
+    url?: string;
+    finalUrl?: string;
+    title?: string;
+    status?: number;
+    providerErrorCode?: string;
+    message?: string;
+    matchedPatterns?: string[];
+    networkHosts?: string[];
+    traceRequestId?: string;
+    retryable?: boolean;
+    envLimited?: boolean;
+    restrictedTarget?: boolean;
+    promptGuardEnabled?: boolean;
+    threshold?: number;
+    detectedAt?: string;
+}
+export interface BlockerArtifactInput {
+    networkEvents?: unknown[];
+    consoleEvents?: unknown[];
+    exceptionEvents?: unknown[];
+    promptGuardEnabled?: boolean;
+    caps?: Partial<BlockerArtifactCaps>;
+}
+export declare const clampBlockerConfidence: (value: number) => number;
+export declare const clampText: (value: string | undefined, maxLength: number) => string | undefined;
+export declare const boundedUniqueList: (values: readonly string[] | undefined, maxLength: number) => string[];
+export declare const resolveBlockerArtifactCaps: (partial: Partial<BlockerArtifactCaps> | undefined) => BlockerArtifactCaps;
+export declare const classifyBlockerSignal: (input: BlockerClassificationInput) => BlockerSignalV1 | null;
+export declare const buildBlockerArtifacts: (input: BlockerArtifactInput) => BlockerArtifactsV1;
+export declare const __test__: {
+    classifyFromInputs: (input: BlockerClassificationInput, normalizedHosts: string[], matchedPatterns: string[]) => {
+        type: BlockerType;
+        reasonCode?: ProviderReasonCode;
+        confidence: number;
+        retryable: boolean;
+        matches: string[];
+    } | null;
+    extractHost: (value: string | undefined) => string | null;
+    hasAnyPattern: (value: string, patterns: RegExp[]) => boolean;
+    clampThreshold: (value: number | undefined) => number;
+    isLoopbackHost: (value: string) => boolean;
+};
+//# sourceMappingURL=blocker.d.ts.map

package/dist/providers/blocker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocker.d.ts","sourceRoot":"","sources":["../../src/providers/blocker.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,WAAW,EAEX,kBAAkB,EACnB,MAAM,SAAS,CAAC;AA8BjB,eAAO,MAAM,6BAA6B,EAAE,mBAM3C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACrC;AAWD,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAEtD,CAAC;AAOF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,GAAG,SAAS,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,SAIjF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,MAAM,EAAE,GAAG,SAAS,EACrC,WAAW,MAAM,KAChB,MAAM,EAeR,CAAC;AAyRF,eAAO,MAAM,0BAA0B,GACrC,SAAS,OAAO,CAAC,mBAAmB,CAAC,GAAG,SAAS,KAChD,mBAQF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,0BAA0B,KAChC,eAAe,GAAG,IAuDpB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,oBAAoB,KAAG,kBA6CnE,CAAC;AAEF,eAAO,MAAM,QAAQ;gCAhUZ,0BAA0B,mBAChB,MAAM,EAAE,mBACR,MAAM,EAAE,KACxB;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;yBAhF/F,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,IAAI;2BAuBhC,MAAM,YAAY,MAAM,EAAE,KAAG,OAAO;4BAtDnC,MAAM,GAAG,SAAS,KAAG,MAAM;4BA0D3B,MAAM,KAAG,OAAO;CAwX9C,CAAC"}

package/dist/providers/community/index.d.ts

@@ -0,0 +1,44 @@
+import { type PostPolicyHook } from "../shared/post-policy";
+import type { JsonValue, ProviderAdapter, ProviderContext, ProviderCrawlInput, ProviderFetchInput, ProviderPostInput, ProviderSearchInput } from "../types";
+type CommunityRow = {
+    url: string;
+    title?: string;
+    content?: string;
+    confidence?: number;
+    attributes?: Record<string, JsonValue>;
+};
+type CommunityFetchRow = {
+    url?: string;
+    title?: string;
+    content?: string;
+    attributes?: Record<string, JsonValue>;
+};
+export interface CommunityTraversalBudget {
+    pageLimit: number;
+    hopLimit: number;
+    expansionPerRecord: number;
+    maxRecords: number;
+}
+export interface CommunityProviderOptions {
+    id?: string;
+    platform?: string;
+    search?: (input: ProviderSearchInput, context: ProviderContext) => Promise<CommunityRow[]>;
+    fetch?: (input: ProviderFetchInput, context: ProviderContext) => Promise<CommunityFetchRow>;
+    crawl?: (input: ProviderCrawlInput, context: ProviderContext) => Promise<Array<{
+        url: string;
+        title?: string;
+        content?: string;
+        attributes?: Record<string, JsonValue>;
+    }>>;
+    post?: (input: ProviderPostInput, context: ProviderContext) => Promise<{
+        url?: string;
+        title?: string;
+        content?: string;
+        attributes?: Record<string, JsonValue>;
+    }>;
+    postPolicyHooks?: PostPolicyHook[];
+    defaultTraversal?: Partial<CommunityTraversalBudget>;
+}
+export declare const createCommunityProvider: (options?: CommunityProviderOptions) => ProviderAdapter;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/community/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/community/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,KAAK,EACV,SAAS,EAET,eAAe,EAEf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAIlB,KAAK,YAAY,GAAG;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC,CAAC;AASF,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC3F,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC5F,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3K,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;KAAE,CAAC,CAAC;IACnK,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACtD;AAqJD,eAAO,MAAM,uBAAuB,GAAI,UAAS,wBAA6B,KAAG,eAgThF,CAAC"}

package/dist/providers/enrichment.d.ts

@@ -0,0 +1,33 @@
+import type { JsonValue, NormalizedRecord, ProviderSource } from "./types";
+import type { ResolvedTimebox } from "./timebox";
+export interface EngagementMetrics {
+    likes: number;
+    comments: number;
+    views: number;
+    upvotes: number;
+}
+export interface RecencyMetadata {
+    within_timebox: boolean;
+    age_hours: number;
+}
+export interface DateConfidenceMetadata {
+    score: number;
+    source: "explicit" | "inferred" | "missing";
+}
+export interface ResearchRecord {
+    id: string;
+    source: ProviderSource;
+    provider: string;
+    url?: string;
+    title?: string;
+    content?: string;
+    timestamp: string;
+    confidence: number;
+    engagement: EngagementMetrics;
+    recency: RecencyMetadata;
+    date_confidence: DateConfidenceMetadata;
+    attributes: Record<string, JsonValue>;
+}
+export declare const toResearchRecord: (record: NormalizedRecord, timebox: ResolvedTimebox, now?: Date) => ResearchRecord;
+export declare const enrichResearchRecords: (records: NormalizedRecord[], timebox: ResolvedTimebox, now?: Date) => ResearchRecord[];
+//# sourceMappingURL=enrichment.d.ts.map

package/dist/providers/enrichment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment.d.ts","sourceRoot":"","sources":["../../src/providers/enrichment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,OAAO,EAAE,eAAe,CAAC;IACzB,eAAe,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACvC;AAqED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,gBAAgB,EACxB,SAAS,eAAe,EACxB,MAAK,IAAiB,KACrB,cAuCF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,gBAAgB,EAAE,EAC3B,SAAS,eAAe,EACxB,MAAK,IAAiB,KACrB,cAAc,EAEhB,CAAC"}

package/dist/providers/errors.d.ts

@@ -0,0 +1,41 @@
+import type { JsonValue, ProviderError, ProviderErrorCode, ProviderReasonCode, ProviderSource } from "./types";
+export declare const isProviderReasonCode: (value: unknown) => value is ProviderReasonCode;
+export declare const normalizeProviderReasonCode: (params: {
+    code: ProviderErrorCode;
+    message?: string;
+    status?: number;
+    details?: Record<string, JsonValue>;
+}) => ProviderReasonCode | undefined;
+export declare const providerErrorCodeFromReasonCode: (reasonCode: ProviderReasonCode | undefined) => ProviderErrorCode;
+export declare class ProviderRuntimeError extends Error {
+    readonly code: ProviderErrorCode;
+    readonly retryable: boolean;
+    readonly reasonCode?: ProviderReasonCode;
+    readonly provider?: string;
+    readonly source?: ProviderSource;
+    readonly details?: Record<string, JsonValue>;
+    constructor(code: ProviderErrorCode, message: string, options?: {
+        retryable?: boolean;
+        reasonCode?: ProviderReasonCode;
+        provider?: string;
+        source?: ProviderSource;
+        details?: Record<string, JsonValue>;
+        cause?: unknown;
+    });
+}
+export declare const isRetryableByCode: (code: ProviderErrorCode) => boolean;
+export declare const isProviderRuntimeError: (value: unknown) => value is ProviderRuntimeError;
+export declare const createProviderError: (code: ProviderErrorCode, message: string, options?: {
+    retryable?: boolean;
+    reasonCode?: ProviderReasonCode;
+    provider?: string;
+    source?: ProviderSource;
+    details?: Record<string, JsonValue>;
+}) => ProviderError;
+export declare const toProviderError: (error: unknown, options?: {
+    provider?: string;
+    source?: ProviderSource;
+    defaultCode?: ProviderErrorCode;
+    details?: Record<string, JsonValue>;
+}) => ProviderError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/providers/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/providers/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACf,MAAM,SAAS,CAAC;AA4BjB,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,kBAE9D,CAAC;AAcF,eAAO,MAAM,2BAA2B,GAAI,QAAQ;IAClD,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC,KAAG,kBAAkB,GAAG,SAgBxB,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAC1C,YAAY,kBAAkB,GAAG,SAAS,KACzC,iBAqBF,CAAC;AAgBF,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAG3C,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,cAAc,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAWT;AAED,eAAO,MAAM,iBAAiB,GAAI,MAAM,iBAAiB,KAAG,OAM3D,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,oBAEhE,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,MAAM,iBAAiB,EACvB,SAAS,MAAM,EACf,UAAS;IACP,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAChC,KACL,aAaF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,OAAO,EACd,UAAS;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAChC,KACL,aA+BF,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,121 @@
+import { ProviderRegistry } from "./registry";
+import { type AntiBotPolicyConfig } from "./shared/anti-bot-policy";
+import { type CommunityProviderOptions } from "./community";
+import { type SocialProvidersOptions } from "./social";
+import { type ShoppingProvidersOptions } from "./shopping";
+import { type WebProviderOptions } from "./web";
+import type { BrowserFallbackPort, ProviderAdapter, ProviderAggregateResult, ProviderCallResultByOperation, ProviderCookiePolicy, ProviderCookieSourceConfig, ProviderOperation, ProviderRunOptions, ProviderRuntimeBudgets } from "./types";
+export declare const DEFAULT_PROVIDER_BUDGETS: ProviderRuntimeBudgets;
+type RuntimeTierConfig = {
+    defaultTier: "A" | "B" | "C";
+    enableHybrid: boolean;
+    enableRestrictedSafe: boolean;
+    hybridRiskThreshold: number;
+    restrictedSafeRecoveryIntervalMs: number;
+};
+export interface RuntimeInit {
+    budgets?: Partial<ProviderRuntimeBudgets>;
+    providers?: ProviderAdapter[];
+    tiers?: Partial<RuntimeTierConfig>;
+    adaptiveConcurrency?: {
+        enabled?: boolean;
+        maxGlobal?: number;
+        maxPerDomain?: number;
+    };
+    blockerDetectionThreshold?: number;
+    promptInjectionGuard?: {
+        enabled?: boolean;
+    };
+    antiBotPolicy?: Partial<AntiBotPolicyConfig>;
+    transcript?: {
+        modeDefault?: "auto" | "web" | "no-auto" | "yt-dlp" | "apify";
+        strategyOrder?: Array<"youtubei" | "native_caption_parse" | "ytdlp_audio_asr" | "apify" | "ytdlp_subtitle" | "optional_asr">;
+        enableYtdlp?: boolean;
+        enableAsr?: boolean;
+        enableYtdlpAudioAsr?: boolean;
+        enableApify?: boolean;
+        apifyActorId?: string;
+        enableBrowserFallback?: boolean;
+        ytdlpTimeoutMs?: number;
+    };
+    cookies?: {
+        policy?: ProviderCookiePolicy;
+        source?: ProviderCookieSourceConfig;
+    };
+    browserFallbackPort?: BrowserFallbackPort;
+}
+export interface RuntimeDefaults {
+    web?: WebProviderOptions;
+    community?: CommunityProviderOptions;
+    social?: SocialProvidersOptions;
+    shopping?: ShoppingProvidersOptions;
+}
+export declare class ProviderRuntime {
+    readonly registry: ProviderRegistry;
+    private readonly logger;
+    private budgets;
+    private globalSemaphore;
+    private readonly scopedSemaphores;
+    private readonly tierConfig;
+    private readonly promptGuardEnabled;
+    private readonly blockerDetectionThreshold;
+    private readonly antiBotPolicy;
+    private readonly adaptiveConfig;
+    private adaptiveConcurrency;
+    private readonly browserFallbackPort?;
+    constructor(init?: RuntimeInit);
+    register(provider: ProviderAdapter): void;
+    listProviders(): ProviderAdapter[];
+    listCapabilities(): import("./types").ProviderCapabilities[];
+    getHealth(providerId: string): import("./types").ProviderHealth;
+    updateBudgets(partial: Partial<ProviderRuntimeBudgets>): ProviderRuntimeBudgets;
+    getBudgets(): ProviderRuntimeBudgets;
+    search(input: ProviderCallResultByOperation["search"], options?: ProviderRunOptions): Promise<ProviderAggregateResult>;
+    fetch(input: ProviderCallResultByOperation["fetch"], options?: ProviderRunOptions): Promise<ProviderAggregateResult>;
+    crawl(input: ProviderCallResultByOperation["crawl"], options?: ProviderRunOptions): Promise<ProviderAggregateResult>;
+    post(input: ProviderCallResultByOperation["post"], options?: ProviderRunOptions): Promise<ProviderAggregateResult>;
+    execute<Operation extends ProviderOperation>(operation: Operation, input: ProviderCallResultByOperation[Operation], options?: ProviderRunOptions): Promise<ProviderAggregateResult>;
+    private executeSequential;
+    private executeAll;
+    private invokeProvider;
+    private callOperation;
+    private withProviderConcurrency;
+    private createAdaptiveConcurrencyController;
+    private selectTierAProviders;
+    private calculateChallengePressure;
+    private calculateRiskScore;
+    private isHybridHealthy;
+    private isLatencyBudgetExceeded;
+    private isErrorBudgetExceeded;
+    private isHybridEligible;
+    private resolveScopeKey;
+    private queuePressure;
+    private detectRealismViolations;
+    private applyAdaptiveOperationInput;
+    private isChallengeError;
+    private isClientError;
+    private isServerError;
+    private buildDiagnostics;
+    private detectRuntimeBlocker;
+    private withTimeout;
+}
+export declare const createProviderRuntime: (init?: RuntimeInit) => ProviderRuntime;
+export declare const createDefaultRuntime: (defaults?: RuntimeDefaults, init?: Omit<RuntimeInit, "providers">) => ProviderRuntime;
+export { ProviderRegistry } from "./registry";
+export { selectProviders } from "./policy";
+export { createWebProvider } from "./web";
+export { createCommunityProvider } from "./community";
+export { createSocialProvider, createSocialProviders } from "./social";
+export { createShoppingProvider, createShoppingProviders, createShoppingProviderById, SHOPPING_PROVIDER_IDS } from "./shopping";
+export * from "./timebox";
+export * from "./enrichment";
+export * from "./renderer";
+export * from "./artifacts";
+export * from "./workflows";
+export * from "./types";
+export * from "./errors";
+export * from "./normalize";
+export * from "./tier-router";
+export * from "./adaptive-concurrency";
+export * from "./blocker";
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

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

package/dist/providers/normalize.d.ts

@@ -0,0 +1,39 @@
+import type { JsonValue, NormalizedRecord, ProviderExecutionMetadata, ProviderError, ProviderOperationFailure, ProviderOperationSuccess, ProviderSource, ProviderTierMetadata, TraceContext } from "./types";
+export interface NormalizeRecordInput {
+    id?: string;
+    url?: string;
+    title?: string;
+    content?: string;
+    timestamp?: string;
+    confidence?: number;
+    attributes?: Record<string, JsonValue>;
+}
+export declare const createTraceContext: (seed?: Partial<TraceContext>, provider?: string) => TraceContext;
+export declare const clampConfidence: (value: number | undefined) => number;
+export declare const createStableRecordId: (provider: string, source: ProviderSource, value: NormalizeRecordInput) => string;
+export declare const normalizeRecord: (provider: string, source: ProviderSource, value: NormalizeRecordInput) => NormalizedRecord;
+export declare const normalizeRecords: (provider: string, source: ProviderSource, records: NormalizeRecordInput[]) => NormalizedRecord[];
+export declare const normalizeSuccess: (provider: string, source: ProviderSource, records: NormalizeRecordInput[], options?: {
+    trace?: Partial<TraceContext>;
+    startedAtMs?: number;
+    attempts?: number;
+    retries?: number;
+    meta?: ProviderExecutionMetadata;
+    provenance?: Record<string, JsonValue>;
+}) => ProviderOperationSuccess;
+export declare const normalizeFailure: (provider: string, source: ProviderSource, error: unknown, options?: {
+    trace?: Partial<TraceContext>;
+    startedAtMs?: number;
+    attempts?: number;
+    retries?: number;
+    meta?: ProviderExecutionMetadata;
+    defaultMessage?: string;
+    defaultErrorCode?: ProviderError["code"];
+}) => ProviderOperationFailure;
+export declare const createExecutionMetadata: (params: {
+    tier: ProviderTierMetadata;
+    provider: string;
+    retrievalPath: string;
+    retrievedAt?: string;
+}) => ProviderExecutionMetadata;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/providers/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/providers/normalize.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,gBAAgB,EAChB,yBAAyB,EACzB,aAAa,EACb,wBAAwB,EACxB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,oBAAoB;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,kBAAkB,GAC7B,OAAM,OAAO,CAAC,YAAY,CAAM,EAChC,WAAW,MAAM,KAChB,YAQF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAK3D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAChB,QAAQ,cAAc,EACtB,OAAO,oBAAoB,KAC1B,MAWF,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,QAAQ,cAAc,EACtB,OAAO,oBAAoB,KAC1B,gBAeF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,QAAQ,cAAc,EACtB,SAAS,oBAAoB,EAAE,KAC9B,gBAAgB,EAElB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,QAAQ,cAAc,EACtB,SAAS,oBAAoB,EAAE,EAC/B,UAAS;IACP,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,yBAAyB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACnC,KACL,wBAgBF,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,QAAQ,cAAc,EACtB,OAAO,OAAO,EACd,UAAS;IACP,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,yBAAyB,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACrC,KACL,wBA6BF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,QAAQ;IAC9C,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,KAAG,yBASH,CAAC"}

package/dist/providers/policy.d.ts

@@ -0,0 +1,5 @@
+import type { ProviderAdapter, ProviderOperation, ProviderSelection } from "./types";
+import type { ProviderRegistry } from "./registry";
+export declare const selectProviders: (registry: ProviderRegistry, operation: ProviderOperation, selection?: ProviderSelection) => ProviderAdapter[];
+export declare const shouldFallbackToNextProvider: (selection: ProviderSelection) => boolean;
+//# sourceMappingURL=policy.d.ts.map

package/dist/providers/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/providers/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAyBnD,eAAO,MAAM,eAAe,GAC1B,UAAU,gBAAgB,EAC1B,WAAW,iBAAiB,EAC5B,YAAW,iBAA0B,KACpC,eAAe,EAoBjB,CAAC;AAEF,eAAO,MAAM,4BAA4B,GAAI,WAAW,iBAAiB,KAAG,OAE3E,CAAC"}

package/dist/providers/registry.d.ts

@@ -0,0 +1,22 @@
+import type { ProviderAdapter, ProviderCapabilities, ProviderError, ProviderHealth, ProviderSource } from "./types";
+export declare class ProviderRegistry {
+    private readonly providers;
+    private readonly state;
+    register(provider: ProviderAdapter): void;
+    get(providerId: string): ProviderAdapter;
+    list(): ProviderAdapter[];
+    listBySource(source: ProviderSource): ProviderAdapter[];
+    capabilities(): ProviderCapabilities[];
+    setHealth(providerId: string, health: ProviderHealth): void;
+    getHealth(providerId: string): ProviderHealth;
+    markSuccess(providerId: string, latencyMs: number): void;
+    markFailure(providerId: string, error: ProviderError, circuit: {
+        failureThreshold: number;
+        cooldownMs: number;
+    }): void;
+    isCircuitOpen(providerId: string, nowMs?: number): boolean;
+    getCircuitError(providerId: string): ProviderError;
+    reset(providerId: string): void;
+    private getState;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/providers/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAcpH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAazC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAQxC,IAAI,IAAI,eAAe,EAAE;IAIzB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,EAAE;IAIvD,YAAY,IAAI,oBAAoB,EAAE;IAItC,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI;IAQ3D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc;IAI7C,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAYxD,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxD,IAAI;IAwBP,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,SAAa,GAAG,OAAO;IAgB9D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAalD,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ/B,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/providers/renderer.d.ts

@@ -0,0 +1,49 @@
+import type { ResearchRecord } from "./enrichment";
+export type RenderMode = "compact" | "json" | "md" | "context" | "path";
+export interface ShoppingOffer {
+    offer_id: string;
+    product_id: string;
+    provider: string;
+    url: string;
+    title: string;
+    price: {
+        amount: number;
+        currency: string;
+        retrieved_at: string;
+    };
+    shipping: {
+        amount: number;
+        currency: string;
+        notes: string;
+    };
+    availability: "in_stock" | "limited" | "out_of_stock" | "unknown";
+    rating: number;
+    reviews_count: number;
+    deal_score: number;
+    attributes: Record<string, unknown>;
+}
+export declare const renderResearch: (args: {
+    mode: RenderMode;
+    topic: string;
+    records: ResearchRecord[];
+    meta: Record<string, unknown>;
+}) => {
+    response: Record<string, unknown>;
+    files: Array<{
+        path: string;
+        content: string | Record<string, unknown>;
+    }>;
+};
+export declare const renderShopping: (args: {
+    mode: RenderMode;
+    query: string;
+    offers: ShoppingOffer[];
+    meta: Record<string, unknown>;
+}) => {
+    response: Record<string, unknown>;
+    files: Array<{
+        path: string;
+        content: string | Record<string, unknown>;
+    }>;
+};
+//# sourceMappingURL=renderer.d.ts.map

package/dist/providers/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/providers/renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAeD,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,KAAG;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CA6E3E,CAAC;AA4BF,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,KAAG;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;CA8E3E,CAAC"}

package/dist/providers/runtime-factory.d.ts

@@ -0,0 +1,20 @@
+import type { BrowserManagerLike } from "../browser/manager-types";
+import type { OpenDevBrowserConfig } from "../config";
+import { type RuntimeDefaults, type RuntimeInit } from "./index";
+import type { BrowserFallbackPort, ProviderCookiePolicy, ProviderCookieSourceConfig } from "./types";
+type RuntimeConfig = Pick<OpenDevBrowserConfig, "blockerDetectionThreshold" | "security" | "providers">;
+type BrowserFallbackCookieConfig = {
+    policy: ProviderCookiePolicy;
+    source: ProviderCookieSourceConfig;
+};
+export declare const createBrowserFallbackPort: (manager: BrowserManagerLike | undefined, cookieDefaults?: Partial<BrowserFallbackCookieConfig>) => BrowserFallbackPort | undefined;
+export declare const buildRuntimeInitFromConfig: (config: RuntimeConfig | undefined, browserFallbackPort?: BrowserFallbackPort) => Omit<RuntimeInit, "providers">;
+export declare const createConfiguredProviderRuntime: (args: {
+    config?: RuntimeConfig;
+    defaults?: RuntimeDefaults;
+    manager?: BrowserManagerLike;
+    browserFallbackPort?: BrowserFallbackPort;
+    init?: Omit<RuntimeInit, "providers">;
+}) => import("./index").ProviderRuntime;
+export {};
+//# sourceMappingURL=runtime-factory.d.ts.map

package/dist/providers/runtime-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-factory.d.ts","sourceRoot":"","sources":["../../src/providers/runtime-factory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAwB,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AACvF,OAAO,KAAK,EAEV,mBAAmB,EAGnB,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAEjB,KAAK,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,2BAA2B,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;AAExG,KAAK,2BAA2B,GAAG;IACjC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,0BAA0B,CAAC;CACpC,CAAC;AAyJF,eAAO,MAAM,yBAAyB,GACpC,SAAS,kBAAkB,GAAG,SAAS,EACvC,iBAAgB,OAAO,CAAC,2BAA2B,CAAM,KACxD,mBAAmB,GAAG,SAkGxB,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,aAAa,GAAG,SAAS,EACjC,sBAAsB,mBAAmB,KACxC,IAAI,CAAC,WAAW,EAAE,WAAW,CAkE/B,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,MAAM;IACpD,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;CACvC,sCAUA,CAAC"}

package/dist/providers/safety/prompt-guard.d.ts

@@ -0,0 +1,34 @@
+import type { NormalizedRecord } from "../types";
+type PromptGuardSeverity = "low" | "medium" | "high";
+type PromptGuardAction = "strip" | "quarantine";
+type PromptGuardField = "title" | "content";
+export interface PromptGuardEntry {
+    pattern: string;
+    action: PromptGuardAction;
+    severity: PromptGuardSeverity;
+    excerpt: string;
+}
+export interface PromptGuardRecordEntry extends PromptGuardEntry {
+    recordId: string;
+    field: PromptGuardField;
+}
+export interface PromptGuardTextResult {
+    text: string;
+    diagnostics: {
+        entries: number;
+        quarantinedSegments: number;
+    };
+    entries: PromptGuardEntry[];
+}
+export interface PromptGuardResult {
+    records: NormalizedRecord[];
+    audit: {
+        enabled: boolean;
+        quarantinedSegments: number;
+        entries: PromptGuardRecordEntry[];
+    };
+}
+export declare function sanitizePromptGuardText(text: string, enabled: boolean): PromptGuardTextResult;
+export declare function applyPromptGuard(records: NormalizedRecord[], enabled: boolean): PromptGuardResult;
+export {};
+//# sourceMappingURL=prompt-guard.d.ts.map

package/dist/providers/safety/prompt-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-guard.d.ts","sourceRoot":"","sources":["../../../src/providers/safety/prompt-guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5D,KAAK,mBAAmB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AACrD,KAAK,iBAAiB,GAAG,OAAO,GAAG,YAAY,CAAC;AAChD,KAAK,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AAS5C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,OAAO,EAAE,sBAAsB,EAAE,CAAC;KACnC,CAAC;CACH;AAgED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,qBAAqB,CAsC7F;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,iBAAiB,CA+DjG"}