@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.1

package/dist/types/contracts/runtime.d.ts

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+export declare const runtimeCapabilitySchema: z.ZodString;
+export declare const runtimeNodeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    nodeId: z.ZodString;
+    capabilities: z.ZodArray<z.ZodString>;
+    codeRevision: z.ZodString;
+    observedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const workAssignmentSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    assignmentId: z.ZodString;
+    workloadId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    revision: z.ZodNumber;
+    enabled: z.ZodBoolean;
+    effectiveFrom: z.ZodOptional<z.ZodISODateTime>;
+    effectiveUntil: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+export declare const runStatusSchema: z.ZodEnum<{
+    SUCCEEDED: "SUCCEEDED";
+    PARTIAL: "PARTIAL";
+    FAILED: "FAILED";
+    BLOCKED: "BLOCKED";
+    SKIPPED: "SKIPPED";
+}>;
+/** Fixed numeric diagnostics only; not a response body, URL or new finality authority. */
+export declare function nativeAcquisitionHttpStatus(errorCode: unknown, value: unknown): number | undefined;
+export declare const runReceiptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    workloadId: z.ZodString;
+    runtimeNodeId: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    projectIntentRef: z.ZodOptional<z.ZodString>;
+    collectionBatchRef: z.ZodOptional<z.ZodString>;
+    assignmentRevision: z.ZodNumber;
+    codeRevision: z.ZodString;
+    startedAt: z.ZodISODateTime;
+    finishedAt: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        SUCCEEDED: "SUCCEEDED";
+        PARTIAL: "PARTIAL";
+        FAILED: "FAILED";
+        BLOCKED: "BLOCKED";
+        SKIPPED: "SKIPPED";
+    }>;
+    inputFingerprint: z.ZodOptional<z.ZodString>;
+    outputFingerprint: z.ZodOptional<z.ZodString>;
+    evidenceCount: z.ZodNumber;
+    observationCount: z.ZodNumber;
+    errorCode: z.ZodOptional<z.ZodString>;
+    acquisitionHttpStatus: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type RuntimeNode = z.infer<typeof runtimeNodeSchema>;
+export type WorkAssignment = z.infer<typeof workAssignmentSchema>;
+export type RunStatus = z.infer<typeof runStatusSchema>;
+export type RunReceipt = z.infer<typeof runReceiptSchema>;

package/dist/types/contracts/scheduler.d.ts

@@ -0,0 +1,348 @@
+import { z } from 'zod';
+export declare const TIPP_UNIVERSE_MAX_RESOURCE_BYTES: number;
+export declare const schedulerInvocationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    command: z.ZodLiteral<"business-information-collect">;
+    maxSources: z.ZodDefault<z.ZodNumber>;
+    maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+    fileRootsFile: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"pk-import-rules-project">;
+    acquireLinkedDocuments: z.ZodDefault<z.ZodBoolean>;
+    documentBatch: z.ZodDefault<z.ZodNumber>;
+    maxDocumentBytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"acquisition-run">;
+    programDirectory: z.ZodString;
+    fileRootsFile: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"collection-tick">;
+    maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+    batchLimit: z.ZodDefault<z.ZodNumber>;
+    fileRootsFile: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"collection-projection-tick">;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"project-projection-tick">;
+    maxRows: z.ZodOptional<z.ZodNumber>;
+    maxDependencyRows: z.ZodOptional<z.ZodNumber>;
+    maxBytes: z.ZodOptional<z.ZodNumber>;
+    maxMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"review-packet-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"auto-publication-tick">;
+    concurrency: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"public-reference-tick">;
+    policyFile: z.ZodString;
+    identityDatabase: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"feed-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"procurement-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"pk-valuation-status-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"pk-standards-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"cpec-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"tipp-universe-project">;
+    chapterBatch: z.ZodDefault<z.ZodNumber>;
+    maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"tipp-detail-project">;
+    detailBatch: z.ZodDefault<z.ZodNumber>;
+    detailConcurrency: z.ZodOptional<z.ZodNumber>;
+    maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"tipp-tariff-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"tipp-regulatory-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"pk-tariff-reconciliation-project">;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"signal-collect">;
+    programFile: z.ZodString;
+    profile: z.ZodEnum<{
+        trends: "trends";
+        hn: "hn";
+        github: "github";
+        autocomplete: "autocomplete";
+        youtube: "youtube";
+        tiktok: "tiktok";
+        douyin: "douyin";
+        meta: "meta";
+        "deep-social": "deep-social";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"signal-compose">;
+    programFile: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"customs-corpus-run">;
+    programFile: z.ZodString;
+    adapter: z.ZodEnum<{
+        "us-hts": "us-hts";
+        "us-cross": "us-cross";
+        "ca-tariff": "ca-tariff";
+        "ca-rulings": "ca-rulings";
+        "eu-ebti": "eu-ebti";
+        "pk-tariff": "pk-tariff";
+        "pk-import-sro": "pk-import-sro";
+        "pk-tax-authorities": "pk-tax-authorities";
+        "pk-classification": "pk-classification";
+        "pk-valuation": "pk-valuation";
+        "za-determinations": "za-determinations";
+        "eg-nafeza": "eg-nafeza";
+        "ae-tariff": "ae-tariff";
+        "sa-tariff": "sa-tariff";
+        "ru-eaeu": "ru-eaeu";
+    }>;
+    refreshStoredDocuments: z.ZodOptional<z.ZodBoolean>;
+    refreshRemoteBundle: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>, z.ZodObject<{
+    command: z.ZodLiteral<"location-corpus-run">;
+    programFile: z.ZodString;
+    adapter: z.ZodLiteral<"unlocode">;
+}, z.core.$strict>], "command">;
+export declare const scheduledWorkloadSchema: z.ZodObject<{
+    workloadId: z.ZodString;
+    projectKey: z.ZodString;
+    priority: z.ZodNumber;
+    intervalSeconds: z.ZodNumber;
+    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+    assignmentFile: z.ZodString;
+    initialDueAt: z.ZodOptional<z.ZodISODateTime>;
+    invocation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        command: z.ZodLiteral<"business-information-collect">;
+        maxSources: z.ZodDefault<z.ZodNumber>;
+        maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+        fileRootsFile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"pk-import-rules-project">;
+        acquireLinkedDocuments: z.ZodDefault<z.ZodBoolean>;
+        documentBatch: z.ZodDefault<z.ZodNumber>;
+        maxDocumentBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"acquisition-run">;
+        programDirectory: z.ZodString;
+        fileRootsFile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"collection-tick">;
+        maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+        batchLimit: z.ZodDefault<z.ZodNumber>;
+        fileRootsFile: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"collection-projection-tick">;
+        limit: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"project-projection-tick">;
+        maxRows: z.ZodOptional<z.ZodNumber>;
+        maxDependencyRows: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        maxMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"review-packet-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"auto-publication-tick">;
+        concurrency: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"public-reference-tick">;
+        policyFile: z.ZodString;
+        identityDatabase: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"feed-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"procurement-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"pk-valuation-status-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"pk-standards-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"cpec-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"tipp-universe-project">;
+        chapterBatch: z.ZodDefault<z.ZodNumber>;
+        maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"tipp-detail-project">;
+        detailBatch: z.ZodDefault<z.ZodNumber>;
+        detailConcurrency: z.ZodOptional<z.ZodNumber>;
+        maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"tipp-tariff-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"tipp-regulatory-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"pk-tariff-reconciliation-project">;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"signal-collect">;
+        programFile: z.ZodString;
+        profile: z.ZodEnum<{
+            trends: "trends";
+            hn: "hn";
+            github: "github";
+            autocomplete: "autocomplete";
+            youtube: "youtube";
+            tiktok: "tiktok";
+            douyin: "douyin";
+            meta: "meta";
+            "deep-social": "deep-social";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"signal-compose">;
+        programFile: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"customs-corpus-run">;
+        programFile: z.ZodString;
+        adapter: z.ZodEnum<{
+            "us-hts": "us-hts";
+            "us-cross": "us-cross";
+            "ca-tariff": "ca-tariff";
+            "ca-rulings": "ca-rulings";
+            "eu-ebti": "eu-ebti";
+            "pk-tariff": "pk-tariff";
+            "pk-import-sro": "pk-import-sro";
+            "pk-tax-authorities": "pk-tax-authorities";
+            "pk-classification": "pk-classification";
+            "pk-valuation": "pk-valuation";
+            "za-determinations": "za-determinations";
+            "eg-nafeza": "eg-nafeza";
+            "ae-tariff": "ae-tariff";
+            "sa-tariff": "sa-tariff";
+            "ru-eaeu": "ru-eaeu";
+        }>;
+        refreshStoredDocuments: z.ZodOptional<z.ZodBoolean>;
+        refreshRemoteBundle: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>, z.ZodObject<{
+        command: z.ZodLiteral<"location-corpus-run">;
+        programFile: z.ZodString;
+        adapter: z.ZodLiteral<"unlocode">;
+    }, z.core.$strict>], "command">;
+}, z.core.$strict>;
+export declare const nodeSchedulerManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    nodeId: z.ZodString;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    maxWorkloadsPerTick: z.ZodDefault<z.ZodNumber>;
+    workloads: z.ZodArray<z.ZodObject<{
+        workloadId: z.ZodString;
+        projectKey: z.ZodString;
+        priority: z.ZodNumber;
+        intervalSeconds: z.ZodNumber;
+        timeoutSeconds: z.ZodDefault<z.ZodNumber>;
+        assignmentFile: z.ZodString;
+        initialDueAt: z.ZodOptional<z.ZodISODateTime>;
+        invocation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            command: z.ZodLiteral<"business-information-collect">;
+            maxSources: z.ZodDefault<z.ZodNumber>;
+            maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+            fileRootsFile: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"pk-import-rules-project">;
+            acquireLinkedDocuments: z.ZodDefault<z.ZodBoolean>;
+            documentBatch: z.ZodDefault<z.ZodNumber>;
+            maxDocumentBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"acquisition-run">;
+            programDirectory: z.ZodString;
+            fileRootsFile: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"collection-tick">;
+            maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+            batchLimit: z.ZodDefault<z.ZodNumber>;
+            fileRootsFile: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"collection-projection-tick">;
+            limit: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"project-projection-tick">;
+            maxRows: z.ZodOptional<z.ZodNumber>;
+            maxDependencyRows: z.ZodOptional<z.ZodNumber>;
+            maxBytes: z.ZodOptional<z.ZodNumber>;
+            maxMs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"review-packet-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"auto-publication-tick">;
+            concurrency: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"public-reference-tick">;
+            policyFile: z.ZodString;
+            identityDatabase: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"feed-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"procurement-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"pk-valuation-status-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"pk-standards-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"cpec-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"tipp-universe-project">;
+            chapterBatch: z.ZodDefault<z.ZodNumber>;
+            maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"tipp-detail-project">;
+            detailBatch: z.ZodDefault<z.ZodNumber>;
+            detailConcurrency: z.ZodOptional<z.ZodNumber>;
+            maxResourceBytes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"tipp-tariff-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"tipp-regulatory-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"pk-tariff-reconciliation-project">;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"signal-collect">;
+            programFile: z.ZodString;
+            profile: z.ZodEnum<{
+                trends: "trends";
+                hn: "hn";
+                github: "github";
+                autocomplete: "autocomplete";
+                youtube: "youtube";
+                tiktok: "tiktok";
+                douyin: "douyin";
+                meta: "meta";
+                "deep-social": "deep-social";
+            }>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"signal-compose">;
+            programFile: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"customs-corpus-run">;
+            programFile: z.ZodString;
+            adapter: z.ZodEnum<{
+                "us-hts": "us-hts";
+                "us-cross": "us-cross";
+                "ca-tariff": "ca-tariff";
+                "ca-rulings": "ca-rulings";
+                "eu-ebti": "eu-ebti";
+                "pk-tariff": "pk-tariff";
+                "pk-import-sro": "pk-import-sro";
+                "pk-tax-authorities": "pk-tax-authorities";
+                "pk-classification": "pk-classification";
+                "pk-valuation": "pk-valuation";
+                "za-determinations": "za-determinations";
+                "eg-nafeza": "eg-nafeza";
+                "ae-tariff": "ae-tariff";
+                "sa-tariff": "sa-tariff";
+                "ru-eaeu": "ru-eaeu";
+            }>;
+            refreshStoredDocuments: z.ZodOptional<z.ZodBoolean>;
+            refreshRemoteBundle: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            command: z.ZodLiteral<"location-corpus-run">;
+            programFile: z.ZodString;
+            adapter: z.ZodLiteral<"unlocode">;
+        }, z.core.$strict>], "command">;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SchedulerInvocation = z.infer<typeof schedulerInvocationSchema>;
+export type ScheduledWorkload = z.infer<typeof scheduledWorkloadSchema>;
+export type NodeSchedulerManifest = z.infer<typeof nodeSchedulerManifestSchema>;
+export declare const scheduledWorkerCommands: readonly string[];

package/dist/types/contracts/signal.d.ts

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+export declare const signalProfileNameSchema: z.ZodEnum<{
+    trends: "trends";
+    hn: "hn";
+    github: "github";
+    autocomplete: "autocomplete";
+    youtube: "youtube";
+    tiktok: "tiktok";
+    douyin: "douyin";
+    meta: "meta";
+    "deep-social": "deep-social";
+}>;
+export declare const signalSourceHealthSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    items: z.ZodOptional<z.ZodNumber>;
+    state: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodUnknown>>;
+export declare const signalSourceSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    sourceKey: z.ZodString;
+    profile: z.ZodEnum<{
+        trends: "trends";
+        hn: "hn";
+        github: "github";
+        autocomplete: "autocomplete";
+        youtube: "youtube";
+        tiktok: "tiktok";
+        douyin: "douyin";
+        meta: "meta";
+        "deep-social": "deep-social";
+    }>;
+    collectedAt: z.ZodISODateTime;
+    contentHash: z.ZodString;
+    evidenceId: z.ZodString;
+    signalCount: z.ZodNumber;
+    health: z.ZodObject<{
+        ok: z.ZodBoolean;
+        items: z.ZodOptional<z.ZodNumber>;
+        state: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strict>;
+export declare const signalSourceAttemptSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+    sourceRevisionRef: z.ZodOptional<z.ZodString>;
+    sourceKey: z.ZodString;
+    profile: z.ZodEnum<{
+        trends: "trends";
+        hn: "hn";
+        github: "github";
+        autocomplete: "autocomplete";
+        youtube: "youtube";
+        tiktok: "tiktok";
+        douyin: "douyin";
+        meta: "meta";
+        "deep-social": "deep-social";
+    }>;
+    lastAttemptAt: z.ZodISODateTime;
+    lastSuccessAt: z.ZodNullable<z.ZodISODateTime>;
+    success: z.ZodBoolean;
+    durationMs: z.ZodNumber;
+    state: z.ZodNullable<z.ZodString>;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export declare const signalGenerationSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    generationKey: z.ZodString;
+    scoringProfile: z.ZodString;
+    generatedAt: z.ZodISODateTime;
+    snapshotManifest: z.ZodRecord<z.ZodString, z.ZodString>;
+    historyBasis: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    contentHash: z.ZodString;
+    candidateCount: z.ZodNumber;
+    observationCount: z.ZodNumber;
+}, z.core.$strict>;
+export type SignalProfileName = z.infer<typeof signalProfileNameSchema>;
+export type SignalSourceHealth = z.infer<typeof signalSourceHealthSchema>;
+export type SignalSourceSnapshot = z.infer<typeof signalSourceSnapshotSchema>;
+export type SignalSourceAttempt = z.infer<typeof signalSourceAttemptSchema>;
+export type SignalGeneration = z.infer<typeof signalGenerationSchema>;
+export declare const signalHistoryCandidateSchema: z.ZodObject<{
+    query: z.ZodString;
+    score: z.ZodNumber;
+    sources: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export declare const signalHistorySeedSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    projectKey: z.ZodString;
+    projectRef: z.ZodOptional<z.ZodString>;
+    historyKey: z.ZodString;
+    generatedAt: z.ZodISODateTime;
+    scoringVersion: z.ZodNumber;
+    origin: z.ZodString;
+    candidates: z.ZodArray<z.ZodObject<{
+        query: z.ZodString;
+        score: z.ZodNumber;
+        sources: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SignalHistoryCandidate = z.infer<typeof signalHistoryCandidateSchema>;
+export type SignalHistorySeed = z.infer<typeof signalHistorySeedSchema>;