productfoo 0.0.0-stage → 1.0.1

package/dist-public/src/discoveryDocs.d.ts

@@ -0,0 +1,129 @@
+import { type SynthesisTransport } from "./discoverySynthesis.js";
+import { type NotionConnectionEnv } from "./notionNango.js";
+export type DocsFlowErrorCode = "needs_provider_connector" | "needs_source_approval" | "content_too_large" | "model_refused" | "model_truncated" | "identity_leak_refused" | "access_denied" | "provider_failure" | "invalid";
+export declare class DocsFlowError extends Error {
+    readonly code: DocsFlowErrorCode;
+    constructor(code: DocsFlowErrorCode, message: string);
+}
+export type NotionSourceRecord = {
+    provider: "notion";
+    connection_alias: string;
+    page_id?: string;
+    database_id?: string;
+    title?: string;
+    last_edited: string;
+    stable_url?: string;
+    parent_container?: string;
+};
+export declare function notionCanonicalPageUrl(pageId: string): string;
+export declare function parseNotionSourceRecord(raw: Record<string, unknown>, opts: {
+    connection_alias: string;
+}): NotionSourceRecord;
+export declare function docsSelectionFingerprint(record: Pick<NotionSourceRecord, "connection_alias" | "page_id" | "database_id">): string;
+export type ApprovedSourceSummary = {
+    schema_version: "0.1";
+    kind: "approved_source_artifact_summary";
+    source: {
+        provider: string;
+        connection_alias: string;
+        stable_url?: string;
+        source_fingerprint: string;
+        last_edited: string;
+        title?: string;
+    };
+    source_category: "docs";
+    evidence_class: "approved_source_artifact";
+    model_exposure: "summary_only";
+    summary: string;
+    coverage: {
+        caveats: string[];
+    };
+    privacy_attestation: {
+        pii_redacted: true;
+        direct_quotes: false;
+        raw_content_present: false;
+    };
+};
+export declare function containsIdentity(text: string, identities: string[]): boolean;
+/**
+ * Exactly one bounded model request over the approved content (R-005). The
+ * content exists only inside this one request; the reply is closed-validated,
+ * identity-screened, and turned into the summary record. On any refusal the
+ * caller receives a typed error and no write has happened.
+ */
+export declare function summarizeApprovedSource(input: {
+    record: NotionSourceRecord;
+    content_text: string;
+    identities: string[];
+}, options: {
+    model: string;
+    transport: SynthesisTransport;
+}): Promise<ApprovedSourceSummary>;
+export type NotionSelectionInput = {
+    packet_dir: string;
+    local_root: string;
+    target_id: string;
+    connection_alias: string;
+    selection: {
+        page_id?: string;
+        database_id?: string;
+    };
+    now: string;
+    env: NotionConnectionEnv;
+    transport: SynthesisTransport;
+};
+export type ApprovedDocsResult = {
+    schema_version: "0.1";
+    status: "recorded" | "needs_provider_connector" | "needs_source_approval" | "content_too_large" | "model_refused" | "model_truncated" | "identity_leak_refused" | "failed";
+    selection: {
+        page_id?: string;
+        database_id?: string;
+    };
+    summary?: ApprovedSourceSummary;
+    errors: Array<{
+        code: DocsFlowErrorCode;
+        message: string;
+    }>;
+    next_action?: string;
+};
+/**
+ * The one-read flow for an explicitly selected Notion page (R-004/R-005):
+ * approval-checked against the packet's ledger, proof-gated, one content read,
+ * one model request, identity screen, one summary-only ledger record, proof
+ * consumed. The canary content appears in no file, log, or output — only the
+ * PII-minimized summary survives.
+ */
+export declare function processNotionSelection(input: NotionSelectionInput, deps?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<ApprovedDocsResult>;
+/**
+ * The listing boundary for an approved database selection: a bounded metadata
+ * listing (titles + last-edited, capped by policy) and nothing else. No
+ * content read happens here, nothing is written, and the caller decides what
+ * the listing is evidence for.
+ */
+export declare function listNotionDatabaseSelection(input: Omit<NotionSelectionInput, "transport">, deps?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<{
+    schema_version: "0.1";
+    status: "listed" | "needs_provider_connector" | "needs_source_approval" | "failed";
+    records: NotionSourceRecord[];
+    errors: Array<{
+        code: DocsFlowErrorCode;
+        message: string;
+    }>;
+}>;
+import { type DiscoveryCommandOutcome } from "./discoveryCommand.js";
+import { parseNotionScope } from "./sourceIngress.js";
+export type NotionDocsDeps = {
+    fetchImpl?: typeof globalThis.fetch;
+    env?: NodeJS.ProcessEnv;
+    now?: () => string;
+    transport?: SynthesisTransport;
+};
+export declare function approvedNotionScopes(packetDir: string): Array<{
+    connection_id: string;
+    scope: ReturnType<typeof parseNotionScope>;
+    raw: string;
+}>;
+export declare function runNotionDocsDiscovery(root: string, args: string[], deps?: NotionDocsDeps): Promise<DiscoveryCommandOutcome>;