interface SignalizConfig { apiKey?: string; clientId?: string; clientSecret?: string; baseUrl?: string; timeout?: number; maxRetries?: number; } interface ManagedBuild { build_id: string; name: string; status: 'final_build'; outcome: string; service_lane: string; execution_provider: 'signaliz_routine' | 'clay_routine'; clay_workspace_id: string | null; clay_routine_id: string | null; clay_credits_budget_per_run: number; fixed_credits_per_run: number; included_records_per_run: number; additional_record_credits: number; additional_clay_credits_per_record: number; max_records_per_run: number; price_basis: string | null; input_schema: Record; output_schema: Record; delivery_notes: string | null; finalized_at: string; } interface ManagedBuildRunQuote { version: 'managed-build-run-v2'; build_id: string; item_count: number; included_records: number; additional_records: number; base_signaliz_credits: number; additional_record_credits: number; total_signaliz_credits: number; estimated_clay_credits: number; max_records_per_run: number; price_basis: string | null; requires_confirmation: true; } interface ManagedBuildRunOptions { idempotencyKey?: string; confirmSpend?: boolean; maxCredits?: number; } interface ManagedBuildRun { run_id: string; build_id: string; status: 'dispatching' | 'queued' | 'running' | 'completed' | 'failed'; trigger_run_id: string | null; result_run_id: string | null; execution_provider: 'signaliz_routine' | 'clay_routine'; provider_run_id: string | null; provider_mode: 'signaliz' | 'inline' | 'bulk' | null; item_count: number; result_count: number; fixed_credits_charged: number; clay_credits_budget: number; estimated_clay_credits: number; actual_clay_credits: number | null; quote: ManagedBuildRunQuote; billing_status: 'pending' | 'charged' | 'refunded'; error: string | null; created_at: string; started_at: string | null; completed_at: string | null; } interface ManagedBuildRunResult { success: boolean; run?: ManagedBuildRun; quote?: ManagedBuildRunQuote; dry_run?: boolean; message?: string; error_code?: string; credits_charged?: number; execution?: Record | null; results?: Array>; returned?: number; replayed?: boolean; artifacts?: Record; } type SignalAwarenessAction = 'create' | 'list' | 'update' | 'delete' | 'manual_run' | 'list_signals' | 'bulk_import' | 'get_settings' | 'set_global_webhook' | 'test_webhook' | 'export' | 'send_signal_export'; type SignalAwarenessSchedulePreset = 'daily' | 'weekly' | 'monthly'; interface SignalMonitorInput { /** Optional display name. Defaults to the supplied domain. */ companyName?: string; domain: string; schedule?: SignalAwarenessSchedulePreset; scheduleCron?: string; webhookUrl?: string | null; } interface SignalMonitorUpdateInput { companyName?: string; schedule?: SignalAwarenessSchedulePreset; scheduleCron?: string; status?: 'active' | 'paused'; webhookUrl?: string | null; } interface SignalMonitorDefaults { schedule?: SignalAwarenessSchedulePreset; scheduleCron?: string; webhookUrl?: string | null; } interface SignalAwarenessRequest { action: SignalAwarenessAction; monitorId?: string; monitor?: SignalMonitorInput; monitors?: SignalMonitorInput[]; defaults?: SignalMonitorDefaults; updates?: SignalMonitorUpdateInput; enabled?: boolean; webhookUrl?: string | null; signalIds?: string[]; signals?: SignalAwarenessSignal[]; limit?: number; offset?: number; idempotencyKey?: string; dryRun?: boolean; } interface SignalAwarenessMonitor { id?: string; company_name?: string; domain?: string; status?: string; schedule?: string; schedule_cron?: string; webhook_url?: string | null; total_runs?: number; total_signals_found?: number; consecutive_failures?: number; auto_paused?: boolean; auto_pause_reason?: string; last_run_at?: string; next_run_at?: string; created_at?: string; updated_at?: string; } interface SignalAwarenessRun { id?: string; monitor_id?: string; status?: string; signals_found?: number; started_at?: string; completed_at?: string; created_at?: string; } /** The stable public signal row returned by every Signaliz signal surface. */ interface PublicSignalRow { signal_type: string; signal_title: string; signal_summary: string; source: string; date: string; company_name: string; domain: string; } type SignalAwarenessSignal = PublicSignalRow; interface SignalAwarenessResponse { success: boolean; monitors?: SignalAwarenessMonitor[]; monitor?: SignalAwarenessMonitor; signals?: SignalAwarenessSignal[]; signalCount?: number; monitorId?: string; runId?: string; run?: SignalAwarenessRun; creditsUsed?: number; creditsCharged?: number; cacheHit?: boolean; liveProviderCalled?: boolean; resultReturnedFrom?: 'stored_monitor_signals' | 'available_data' | 'fresh_signal_enrichment' | 'negative_cache'; created?: number; skipped?: number; delivered?: number; errors?: Array<{ row: number; error: string; }>; outputMode?: 'csv' | 'webhook'; webhookUrl?: string | null; webhookStatus?: number; total?: number; limit?: number; offset?: number; hasMore?: boolean; idempotentReplay?: boolean; } interface BatchOptions { /** Maximum simultaneous API requests. Defaults to 10; allowed range is 1-50. */ concurrency?: number; /** Stable cross-surface key. Retries reuse the same provider work; chunked batches derive one collision-free key per original row. */ idempotencyKey?: string; /** Return exact repeated successes as duplicateOf references. Defaults to false. */ compactDuplicates?: boolean; /** Return one no-spend plan for the full batch without provider calls or jobs. */ dryRun?: boolean; /** Return a durable Company Signals or Signal to Copy job handle immediately. */ waitForResult?: boolean; /** Maximum time to poll a durable job. Email jobs default to 20 minutes; Company/Copy jobs wait without a fixed deadline when omitted. */ maxWaitMs?: number; /** Override the server-provided polling delay for a durable job. */ pollIntervalMs?: number; } interface CoreBatchResumeOptions { /** Requested result page size. The server caps email/Company pages at 25 and Copy pages at 100. */ pageSize?: number; /** Maximum time to wait for the existing job. Company/Copy jobs wait without a fixed deadline when omitted. */ maxWaitMs?: number; /** Override the server-provided polling delay while the existing job is active. */ pollIntervalMs?: number; /** Return duplicate successes as duplicateOf references. Defaults to false. */ compactDuplicates?: boolean; /** Original submission key, retained in any timeout recovery metadata. */ idempotencyKey?: string; } type CoreEmailBatchResumeOptions = CoreBatchResumeOptions; interface RecoverableBatchJob { success: true; status: 'queued' | 'processing' | 'completed' | 'partial' | 'failed'; capability: 'company_signals' | 'signal_to_copy'; jobId: string; idempotencyKey: string; total: number; nextPollAfterSeconds?: number; } interface BatchItemResult { index: number; success: boolean; data?: T; error?: string; /** Stable public error code for a failed row. */ errorCode?: string; /** Whether retrying the failed row is safe. */ retryEligible?: boolean; /** Server-provided delay before retrying the failed row. */ retryAfterSeconds?: number; /** Explicit recovery strategy. A fresh key can repeat provider work and is never automatic. */ retryStrategy?: 'new_idempotency_key' | 'same_run_recovery'; /** Present only when the server proves the failed row consumed zero Signaliz credits. */ creditsUsed?: 0; /** Present only when the server proves the failed row charged zero Signaliz credits. */ creditsCharged?: 0; /** Existing provider run that can be resumed without dispatching new work. */ runId?: string; /** Existing Verify Email run that can be resumed without dispatching new work. */ verificationRunId?: string; /** Existing recoverable batch job. */ jobId?: string; /** Machine-readable recovery action returned by Signaliz. */ suggestedAction?: string; doNotAutoResubmit?: boolean; recoveryMode?: 'same_run'; recoveryStatus?: 'pending' | 'completed'; /** Zero-based input index containing the full result for this exact duplicate. */ duplicateOf?: number; } interface BatchResult { total: number; succeeded: number; failed: number; durationMs: number; results: BatchItemResult[]; } type ErrorType = 'validation' | 'not_found' | 'rate_limited' | 'provider_error' | 'timeout' | 'auth_expired' | 'insufficient_credits' | 'unknown'; interface SignalizErrorData { code: string; message: string; errorType: ErrorType; retryAfter?: number; details?: Record; } interface CoreProductDryRunResult { success: true; dryRun: true; status: 'planned'; capability: string; inputCount: number; freshInputCount: number; uniqueFreshInputCount: number; inputDuplicatesSuppressed: number; recoveryReadCount: number; uniqueRecoveryReadCount: number; plan: Record; estimate: Record; estimatedCredits: { min: number; max: number; }; creditsCharged: 0; sideEffects: unknown[]; raw: Record; } interface FindEmailCommonParams { companyName?: string; /** Set false to receive a durable run ID immediately and resume it without duplicate work or spend. */ waitForResult?: boolean; /** Return a no-spend plan without provider calls or jobs. */ dryRun?: boolean; /** Stable retry key for recovering the same request after an ambiguous response. */ idempotencyKey?: string; } type FindEmailParams = FindEmailCommonParams & ({ /** Start a new lookup using only the contact's LinkedIn profile. */ linkedinUrl: string; companyDomain?: string; fullName?: string; firstName?: string; lastName?: string; /** Omit for a new lookup. */ runId?: undefined; } | ({ companyDomain: string; linkedinUrl?: string; /** Omit for a new lookup. */ runId?: undefined; } & ({ fullName: string; firstName?: string; lastName?: string; } | { fullName?: string; firstName: string; lastName: string; })) | { /** Resume one existing Find Email run without dispatching a new finder. */ runId: string; companyDomain?: string; linkedinUrl?: string; fullName?: string; firstName?: string; lastName?: string; }); interface FindEmailResult { success: boolean; found: boolean; email: string | null; /** The mailbox checked even when it was not safe to send. */ checkedEmail?: string | null; candidateSource?: string | null; primaryVerifier?: string | null; primaryVerdict?: string | null; terminalVerifier?: string | null; terminalVerdict?: string | null; terminalResult?: string | null; terminalIsCatchAll?: boolean | null; terminalIsAcceptAll?: boolean | null; bouncebanId?: string | null; firstName?: string; lastName?: string; confidence: number; verificationStatus: string; deliverabilityStatus: string; verificationVerdict: string; isVerified: boolean; isVerifiedForSending: boolean; isDeliverable: boolean; isCatchAll: boolean; verificationFreshness: 'fresh' | 'stale' | 'unknown'; verificationAgeDays: number | null; verifiedAt: string | null; needsReverification: boolean; providerUsed: string; verificationSource: string; /** ISO timestamp when the provider observed the winning verdict. */ verificationObservedAt?: string; failureReason: string; creditsUsed?: number; creditsCharged?: number; /** True when this response reuses the first request's billing receipt without charging again. */ billingReplayed?: boolean; /** True when the public result came from a completed response-idempotency reservation. */ idempotencyReplayed?: boolean; error?: string; errorCode?: string; /** Processing while an existing provider run is still active; otherwise completed. */ status?: 'processing' | 'completed'; /** Durable Find Email run ID for polling without duplicate spend. */ runId?: string; nextPollAfterSeconds?: number; suggestedAction?: string; /** True only for same-run recovery, or a fresh idempotency key with explicit zero-spend proof; never retry automatically. */ retryEligible?: boolean; retryStrategy?: 'new_idempotency_key' | 'same_run_recovery'; doNotAutoResubmit?: boolean; recoveryMode?: 'same_run'; recoveryStatus?: 'pending' | 'completed'; raw: Record; } type VerifyEmailStatus = 'valid' | 'invalid' | 'catch_all' | 'role' | 'disposable' | 'unknown' | 'verifier_error' | 'malformed' | 'error'; type VerifyEmailRecommendation = 'send' | 'do_not_send' | 'manual_review'; interface VerifyEmailResult { email: string | null; status: 'processing' | Exclude; isCatchAll: boolean; creditsCharged: number; okToSend: boolean; verificationRunId?: string; nextPollAfterSeconds?: number; } interface VerifyEmailOptions { /** Resume an existing long verification without another provider call. */ verificationRunId?: string; /** Wait for a processing verification to finish. Defaults to true. */ waitForResult?: boolean; /** Maximum time to wait for a processing verification. Defaults to 10 minutes. */ maxWaitMs?: number; /** Override the server-provided polling delay. */ pollIntervalMs?: number; /** Return a no-spend plan without provider calls or jobs. */ dryRun?: boolean; /** Stable retry key for recovering the same request after an ambiguous response. */ idempotencyKey?: string; } interface VerifyEmailBatchOptions extends BatchOptions, VerifyEmailOptions { } interface VerifyEmailBatchInput { email: string; /** Stable retry key scoped to this address. */ idempotencyKey?: string; } interface CompanySignalEnrichmentParams { /** Resume an existing enrichment without creating another provider run. */ signalRunId?: string; /** Company domain. Required for a new enrichment. */ domain?: string; /** @deprecated Use domain. Accepted for source compatibility but not sent. */ companyDomain?: string; /** @deprecated Company names are derived from the supplied domain. */ companyName?: string; /** Optional research lens. Omit for broad company-signal coverage. */ researchPrompt?: string; /** Recent evidence window in days. Defaults to 365. */ lookbackDays?: number; /** Return a no-spend plan without provider calls or jobs. */ dryRun?: boolean; /** Stable retry key for recovering the same request after an ambiguous response. */ idempotencyKey?: string; } /** One verified signal for the parent Company Signal result's company. */ interface CompanySignal { date: string; signal_type: string; signal_title: string; signal_summary: string; source: string; } interface CompanySignalEnrichmentResult { success: boolean; error?: string; errorCode?: string; status?: string; signalRunId?: string; company: { name: string | null; domain: string | null; }; signals: CompanySignal[]; signalCount: number; creditsUsed?: number; cacheHit?: boolean; liveProviderCalled?: boolean; resultReturnedFrom?: 'available_data' | 'fresh_signal_enrichment' | 'negative_cache'; /** Public counts explaining how candidate evidence became the accepted signal feed. */ coverageDiagnostics?: { candidate_evidence_count?: number; accepted_evidence_count?: number; candidate_signal_count?: number; accepted_signal_count?: number; filtered_signal_count?: number; entity_rejected_count?: number; low_entity_confidence_count?: number; low_value_evidence_count?: number; undated_signal_count?: number; deduped_signal_count?: number; target_signal_count?: number; explanation?: string; }; } type SignalDiscoveryStatus = 'planned' | 'queued' | 'processing' | 'completed' | 'completed_with_warnings' | 'failed'; interface SignalDiscoveryParams { /** Any natural-language signal question. Required for a new search. */ query?: string; /** Number of qualified company signals requested. Defaults to 100; allowed range is 1-100. */ limit?: number; /** Resume an existing asynchronous discovery run without starting another search. */ signalSearchRunId?: string; /** Stable retry key for recovering the same search after an ambiguous response. */ idempotencyKey?: string; /** Return a no-dispatch plan without provider calls or jobs. */ dryRun?: boolean; /** * Wait through queued/processing receipts until the run is terminal. * `discoverSignalsFirst` defaults this to true; `discoverSignals` remains a * single-request compatibility method unless this is handled by the caller. */ waitForResult?: boolean; /** Maximum time spent polling when waitForResult is enabled. Defaults to 15 minutes. */ maxWaitMs?: number; /** Override the server-provided polling interval. */ pollIntervalMs?: number; /** Receives each queued, cached-progress, and terminal Signals First receipt. */ onProgress?: (result: SignalDiscoveryResult) => void; } type SignalDiscoverySignal = PublicSignalRow; interface SignalDiscoveryResult { success: boolean; status: SignalDiscoveryStatus; capability: 'signals_everything'; signalSearchRunId: string; query: string; requestedCount?: number; nextPollAfterSeconds?: number; signals: SignalDiscoverySignal[]; signalCount: number; /** Signals First is included on eligible plans; the server returns zero for every completed, failed, and recovered run. */ creditsUsed: number; /** Customer charge receipt for this run. Expected to be zero while billingStatus is included. */ creditsCharged: number; billingStatus?: 'included'; /** True when the server returned a retained terminal result instead of acquiring again. */ idempotencyReplayed?: boolean; cacheHit?: boolean; liveProviderCalled?: boolean; resultReturnedFrom?: 'stored_signal_search_run'; } interface SignalizFlowParams { signalQuery: string; campaignOffer: string; signalLimit?: number; lookbackDays?: number; icpContext?: string; peopleTitles?: string[]; peoplePerCompany?: number; copyResearchPrompt?: string; approvalRequired?: boolean; /** Stable Flow identifier; reuse it when recovering from an ambiguous start response. */ flowId?: string; /** Stable retry key. Reusing it with the same request never starts duplicate Flow work. */ idempotencyKey?: string; } interface SignalizFlowReceiptLine { capability: 'signaliz_flow_company' | 'company_signals' | 'find_email' | 'signal_to_copy'; successfulResults: number; creditsCharged: number; } interface SignalizFlowBillingReceipt { creditsCharged: number; billingStatus: 'pending' | 'included' | 'charged' | 'not_charged' | 'failed'; chargeBasis: string; planTier: string; creditsPerCompany: 0 | 1; idempotencyReplayed?: boolean; receipt: SignalizFlowReceiptLine[]; } interface SignalizFlowStartResult { success: boolean; flowId: string; runId: string; status: 'TRIGGERED'; statusEndpoint: 'api/v1/flow'; message: string; billing?: { planTier: string; mode: 'included' | 'metered'; creditsPerCompany: 0 | 1; availableCredits: number | null; }; } interface SignalizFlowStatus { success: boolean; runId: string; status: 'running' | 'completed' | 'failed'; result: Record; createdAt?: string; updatedAt?: string; completedAt?: string; } interface SignalToCopyParams { companyDomain?: string; personName?: string; title?: string; campaignOffer?: string; researchPrompt?: string; /** Set true to draft from the campaign offer without researching or claiming a company signal. */ runWithoutSignal?: boolean; /** Maximum signal age used for company-signal research. Defaults to 90 days. */ lookbackDays?: number; signalRunId?: string; /** Reuse one canonical signal fact without rediscovery. Supported in single calls and batches of 25 or fewer. */ factId?: string; /** Reuse one canonical signal event without rediscovery. Supported in single calls and batches of 25 or fewer. */ eventId?: string; /** Use the full deep-research provider portfolio. The default uses bounded credit-free first-party and Bing grounding. */ enableDeepSearch?: boolean; /** @deprecated Single Signal to Copy calls are synchronous; batch recovery is managed automatically. */ waitForResult?: boolean; maxWaitMs?: number; /** @deprecated Signal Copy batch polling is managed automatically. */ pollIntervalMs?: number; /** Return a no-spend plan without provider calls or jobs. */ dryRun?: boolean; /** Stable retry key for recovering the same request after an ambiguous response. */ idempotencyKey?: string; } interface SignalToCopyVariation { style: 'signal_led' | 'business_case' | 'predictive'; subjectLine: string; openingLine: string; cta: string; prediction?: string; email: string; } interface SignalToCopyResult { success: boolean; error?: string; errorCode?: string; status?: string; runId?: string; companySignalRunId?: string; signalSearchRunId?: string; factId?: string; eventId?: string; canonicalSourceUrl?: string; evidenceReuse?: Record; resumeContextPersisted?: boolean; strongestSignal: string; whyNow: string; subjectLine: string; openingLine: string; confidence: number; evidenceUrl: string; researchPrompt?: string; copyEvidenceMode?: 'signal_led' | 'firmographic'; empty?: boolean; emptyReason?: string; researchMetadata?: Record; creditsUsed?: number; cacheHit?: boolean; liveProviderCalled?: boolean; resultReturnedFrom?: 'stored_signal_copy' | 'available_data' | 'fresh_signal_enrichment' | 'negative_cache'; unlimitedSignalToCopy?: boolean; signalToCopyEntitlement?: 'unlimited' | 'standard'; variations: SignalToCopyVariation[]; raw: Record; } interface MCPToolInfo { name: string; title?: string; description: string; inputSchema: Record; annotations?: Record; } interface PlatformHealth { status: string; products: string[]; } type CampaignOsAgentVendor = 'codex' | 'claude_code' | 'cursor' | 'devin' | 'grok' | 'signaliz_agent' | 'other'; type CampaignOsProvider = 'clay' | 'instantly' | 'smartlead' | 'bison'; type CampaignOsAgentActionType = 'fresh_paid_sourcing' | 'provider_create' | 'provider_load' | 'provider_activation' | 'provider_send' | 'realtime_arm'; type CampaignOsOperatorAction = 'clay_spend' | 'verification_spend' | 'provider_create' | 'provider_load' | 'provider_activation' | 'provider_send' | 'realtime_arm'; type CampaignOsSourceKind = 'memory' | 'data' | 'audience' | 'trigger'; interface CampaignOsSourceBindingParams { clientId: string; bindingId: string; audienceId?: string; name: string; sourceKind: CampaignOsSourceKind; remoteObjectType?: string; remoteRef?: string; selector: Record; fieldMapping?: Record; idempotencyKey: string; } /** @deprecated Use CampaignOsSourceBindingParams. */ type CampaignOsSourcePolicyParams = CampaignOsSourceBindingParams; interface CampaignOsConnectionFabricResult { success: true; version: string; catalog: Array>; workspace_connections: Array>; bindings: Array>; source_bindings: Array>; source_runs: Array>; execution_contract: Record; } interface CampaignOsListClientsParams { query?: string; status?: 'onboarding' | 'active' | 'paused' | 'archived'; limit?: number; } interface CampaignOsClientSummary { id: string; name: string; slug: string; status: string; website_url?: string | null; offer_summary?: string | null; icp_summary?: string | null; brain_version: number; updated_at: string; counts: { sources: number; audiences: number; campaigns: number; }; } interface CampaignOsClientContext { success: true; client: Record; brain_sources: Array>; audiences: Array>; audience_definitions: Array>; audience_schedules: Array>; audience_runs: Array>; campaigns: Array>; realtime_policies: Array>; provider_connections: Array>; agent_requests: Array>; controls: Record; } declare const CAMPAIGN_OS_KNOWLEDGE_RECORD_KINDS: readonly ["client_brain", "client_context", "campaign_register", "campaign_record", "campaign_learning", "campaign_methodology", "campaign_genome", "campaign_playbook", "knowledge_inventory", "knowledge_reconciliation", "source_coverage"]; type CampaignOsKnowledgeRecordKind = typeof CAMPAIGN_OS_KNOWLEDGE_RECORD_KINDS[number]; interface CampaignOsKnowledgeSearchParams { query: string; clientId?: string; knowledgeSnapshotId?: string; recordKind?: CampaignOsKnowledgeRecordKind; limit?: number; } interface CampaignOsKnowledgeSearchResult { success: true; query: string; filters: { client_id: string | null; record_kind: string | null; }; results: Array>; total_returned: number; knowledge_snapshot: Record | null; controls: Record; } interface CampaignOsProviderRuntime { success: true; client: { id: string; name: string; slug: string; }; provider: CampaignOsProvider; connected: boolean; connection: Record | null; runtime: Record; controls: Record; } interface CampaignOsAlphaPlanParams { clientId: string; campaignId?: string; clientName: string; offerSummary: string; icpSummary: string; buyerPersonas?: string[]; knownEvidence?: string[]; preferredSources?: string[]; idempotencyKey: string; } type CampaignOsAlphaDiscoveryParams = Omit & { campaignId: string; }; interface CampaignOsAlphaRunResult { success: true; idempotent?: boolean; run: Record; controls?: Record; } interface CampaignOsAlphaSampleEntity { key: string; stableKey?: string; entityType?: 'company' | 'person' | 'account' | 'listing' | 'property' | 'job' | 'product' | 'other'; name: string; domain?: string; url?: string; context?: string; audienceMembershipId?: string; } interface CampaignOsAlphaValidationParams { clientId: string; campaignId: string; alphaRunId: string; candidateIndex: number; sampleEntities: CampaignOsAlphaSampleEntity[]; idempotencyKey: string; } interface CampaignOsAlphaValidationRunResult { success: true; idempotent?: boolean; run: Record; campaign?: Record; controls?: Record; gates?: Record; } interface CampaignOsAlphaMaterializationPreflightParams { clientId: string; campaignId: string; audienceRunId: string; validationRunId: string; idempotencyKey: string; } interface CampaignOsAlphaMaterializationStartParams { materializationRunId: string; approvalHash: string; confirmSpend: true; } interface CampaignOsAlphaMaterializationRunResult { success: true; idempotent?: boolean; run: Record; controls?: Record; gates?: Record; } interface CampaignOsAlphaExperimentAssignParams { clientId: string; campaignId: string; materializationRunId: string; /** Holdout share in basis points. Defaults to 2000 (20%). */ controlBasisPoints?: number; idempotencyKey: string; } type CampaignOsAlphaCohortStatus = 'awaiting_provider_routes' | 'awaiting_mailbox_sends' | 'outcome_window_open' | 'mature'; type CampaignOsAlphaCausalClaimStatus = 'awaiting_separate_cohort_outcome_receipts' | 'awaiting_separate_provider_routes' | 'awaiting_authenticated_mailbox_sends' | 'outcome_windows_open' | 'mature'; /** Exact cohort-attributed provider outcome proof. Lift is null until both attribution windows mature. */ interface CampaignOsAlphaExperimentOutcomeReadModel { workspace_id: string; client_id: string; campaign_id: string; experiment_run_id: string; experiment_id: string; success_metric: string; control_assigned_count: number; control_routed_count: number; control_sent_count: number; control_mature_recipient_count: number; control_replied_count: number; control_positive_reply_count: number; control_booked_count: number; control_reply_rate_percent: number | null; control_positive_reply_rate_percent: number | null; treatment_assigned_count: number; treatment_routed_count: number; treatment_sent_count: number; treatment_mature_recipient_count: number; treatment_replied_count: number; treatment_positive_reply_count: number; treatment_booked_count: number; treatment_reply_rate_percent: number | null; treatment_positive_reply_rate_percent: number | null; control_status: CampaignOsAlphaCohortStatus; treatment_status: CampaignOsAlphaCohortStatus; causal_claim_status: Exclude; positive_reply_lift_percentage_points: number | null; relative_positive_reply_lift_percent: number | null; authenticated_outcome_event_count: number; late_outcome_event_count: number; last_event_at: string | null; } interface CampaignOsAlphaExperimentRunResult { success: true; idempotent?: boolean; run: Record; outcome_read_model?: CampaignOsAlphaExperimentOutcomeReadModel | null; provider_called?: false; provider_mutation?: false; provider_load?: false; activation?: false; queue?: false; send?: false; causal_claim_status?: CampaignOsAlphaCausalClaimStatus; } interface CampaignOsAlphaExperimentCompileParams { clientId: string; campaignId: string; experimentRunId: string; provider: 'instantly' | 'smartlead' | 'bison'; idempotencyKey: string; } interface CampaignOsAlphaExperimentCompilationResult { success: true; idempotent?: boolean; run: Record; artifacts: Array>; provider_called: false; provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; } interface CampaignOsCreateDraftParams { clientId: string; name: string; objective?: string; lane?: 'one_time' | 'always_on' | 'realtime'; targetCount?: number; audienceBindingId?: string; audienceDefinitionId?: string; knowledgeSnapshotId?: string; campaignSpec: Record; agentVendor?: CampaignOsAgentVendor; idempotencyKey: string; } interface CampaignOsRefineCampaignParams { clientId: string; campaignId: string; expectedCampaignSpecVersionId: string; knowledgeSnapshotId?: string; campaignSpec: Record; changeReason: string; agentVendor?: CampaignOsAgentVendor; idempotencyKey: string; } interface CampaignOsStartBuildParams { clientId: string; name: string; objective: string; lane?: 'one_time' | 'always_on' | 'realtime'; targetCount?: number; audienceDefinitionId?: string; agentVendor?: CampaignOsAgentVendor; idempotencyKey: string; } interface CampaignOsAudienceDraftParams { clientId: string; audienceId?: string; name: string; description?: string; entityType: 'people' | 'companies'; audienceRole: 'persistent_tam' | 'campaign_segment' | 'staging' | 'suppression'; sourceMode: 'signaliz_owned' | 'bind_existing'; definition: Record; idempotencyKey: string; } interface CampaignOsClayNativePlanParams { clientId: string; audienceId: string; idempotencyKey: string; whoamiReadback?: Record; countReadback?: Record; } interface CampaignOsClayNativePrepareParams { clientId: string; audienceId: string; receiptId: string; idempotencyKey: string; whoamiReadback: Record; countReadback: Record; } interface CampaignOsClayNativeCompleteParams { clientId: string; sessionId: string; createReadback?: Record; getReadback?: Record; failureStatus?: 'failed_no_mutation' | 'reconciliation_required'; errorCode?: string; errorMessage?: string; } interface CampaignOsClayNativeSyncStartParams { clientId: string; audienceId: string; bindingId: string; idempotencyKey: string; whoamiReadback?: Record; audienceReadback?: Record; countReadback?: Record; } interface CampaignOsClayNativeSyncPageParams { clientId: string; sessionId: string; pageIndex: number; previousCursor?: string | null; pageReadback: Record; } interface CampaignOsClayNativeSyncCompleteParams { clientId: string; sessionId: string; countAfterReadback: Record; } interface CampaignOsMaterializeCacheAudienceParams { clientId: string; audienceId: string; campaignId?: string; targetCount: number; maxCohortsPerCall?: number; idempotencyKey: string; } interface CampaignOsCohortPlanParams { clientId: string; campaignId: string; campaignSpecVersionId: string; audienceId: string; campaignSourceSnapshotId?: string; targetCount: number; cohortSize?: number; idempotencyKey: string; } interface CampaignOsCohortCostReceipt { receipt_version: 'signaliz.campaign-cohort-cost/v1'; verification_price: { canonical_id: string; canonical_name: string; unit_credits: number; }; cache_selected_count: number; source_selected_count: number; source_shortfall_count: number; estimated_verification_credits: number; estimated_paid_source_credits: number | null; paid_source_cost_status: 'not_required' | 'unpriced_no_provider_selected'; paid_sourcing_authorized: false; provider_called: false; } interface CampaignOsCohortPlanReceipt { receipt_version: 'signaliz.campaign-cohort-plan/v1'; workspace_id: string; client_id: string; campaign_id: string; campaign_spec_version_id: string; verification_max_age_days: number; verification_cutoff_at: string; audience_id: string; campaign_source_snapshot_id: string | null; campaign_source_snapshot_receipt_hash: string | null; request_hash: string; requested_target_count: number; cohort_size: number; expected_cohort_count: number; cache_available_count: number; cache_selected_count: number; cache_shortfall_count: number; source_available_count: number; source_selected_count: number; source_shortfall_count: number; planned_membership_count: number; cost_receipt: CampaignOsCohortCostReceipt; provider_called: false; provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; observed_at: string; } interface CampaignOsCohortPlan { id: string; workspace_id: string; client_id: string; campaign_id: string; campaign_spec_version_id: string; audience_id: string; campaign_source_snapshot_id: string | null; requested_by: string | null; idempotency_key: string; request_hash: string; requested_target_count: number; cohort_size: number; expected_cohort_count: number; cache_available_count: number; cache_selected_count: number; cache_shortfall_count: number; source_available_count: number; source_selected_count: number; source_shortfall_count: number; planned_membership_count: number; verification_unit_cost_credits: number; estimated_verification_credits: number; estimated_paid_source_credits: number | null; paid_source_cost_status: 'not_required' | 'unpriced_no_provider_selected'; estimated_known_credits: number; cost_receipt: CampaignOsCohortCostReceipt; status: 'ready' | 'shortfall'; receipt: CampaignOsCohortPlanReceipt; receipt_hash: string; metadata: Record; provider_called: false; provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; created_at: string; } interface CampaignOsCohortReceipt { receipt_version: 'signaliz.campaign-cohort/v1'; plan_id: string; workspace_id: string; client_id: string; campaign_id: string; campaign_spec_version_id: string; audience_id: string; campaign_source_snapshot_id: string | null; cohort_ordinal: number; idempotency_key: string; target_count: number; cache_membership_count: number; source_membership_count: number; planned_membership_count: number; shortfall_count: number; assignment_contract_hash: string; provider_called: false; provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; } interface CampaignOsCohort { id: string; plan_id: string; workspace_id: string; client_id: string; campaign_id: string; campaign_spec_version_id: string; audience_id: string; cohort_ordinal: number; idempotency_key: string; target_count: number; cache_membership_count: number; source_membership_count: number; planned_membership_count: number; shortfall_count: number; assignment_contract_hash: string; status: 'ready' | 'shortfall'; receipt: CampaignOsCohortReceipt; receipt_hash: string; provider_called: false; provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; created_at: string; } interface CampaignOsCohortPlanResult { success: true; plan: CampaignOsCohortPlan; cohorts: CampaignOsCohort[]; replayed: boolean; planning_only: true; paid_sourcing_authorized: false; provider_called: false; provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; } type CampaignOsVerificationRefreshSourceKind = 'cache_orchestration' | 'audience_run' | 'shortfall_plan'; interface CampaignOsVerificationRefreshOperatorContract { operation: 'force_live_verification_refresh'; contract_version: 'campaign-os-force-live-verification/v1'; preview_id: string; campaign_spec_version_id: string; source_kind: CampaignOsVerificationRefreshSourceKind; source_id: string; preview_approval_hash: string; provider_config_id: string; provider_config_version: number; provider_config_hash: string; max_age_days: number; preview_expires_at: string; } interface CampaignOsVerificationRefreshPreviewParams { clientId: string; campaignId: string; campaignSpecVersionId: string; audienceId: string; sourceKind: CampaignOsVerificationRefreshSourceKind; sourceId: string; idempotencyKey: string; previewTtlSeconds?: number; } interface CampaignOsVerificationRefreshExecuteParams { clientId: string; campaignId: string; campaignSpecVersionId: string; audienceId: string; sourceKind: CampaignOsVerificationRefreshSourceKind; sourceId: string; previewId: string; operatorApprovalReceiptId: string; operatorContractHash: string; approvalHash: string; approvedMaxCreditCost: number; expectedProviderConfigId: string; expectedProviderConfigVersion: number; expectedProviderConfigHash: string; idempotencyKey: string; } interface CampaignOsVerificationRefreshStatusParams { clientId: string; executionId: string; } interface CampaignOsVerificationRefreshSafety { provider_mutation: false; provider_load: false; activation: false; queue: false; send: false; raw_emails_returned: false; } interface CampaignOsVerificationRefreshPreview { id: string; workspace_id: string; client_id: string; campaign_id: string; campaign_spec_version_id: string; audience_id: string; source_kind: CampaignOsVerificationRefreshSourceKind; source_id: string; source_receipt_hash: string; idempotency_key: string; request_hash: string; campaign_spec_max_age_days: number; stale_cutoff_at: string; stale_count: number; source_stale_available_count: number; prior_verified_at_min: string | null; prior_verified_at_max: string | null; prior_verified_at_null_count: number; canonical_price_id: string; canonical_price_name: string; canonical_unit_cost_credits: number; canonical_max_credit_cost: number; provider_config_id: string; provider_config_version: number; provider_config_hash: string; member_snapshot_hash: string; expires_at: string; approval_hash: string; receipt: Record; receipt_hash: string; verification_provider_called: false; provider_mutation: false; provider_load: false; activation: false; outbound_queue: false; send: false; created_at: string; } interface CampaignOsVerificationRefreshExecution { id: string; preview_id: string; workspace_id: string; client_id: string; campaign_id: string; campaign_spec_version_id: string; audience_id: string; /** Present on execution creation; intentionally omitted from status readback. */ operator_approval_receipt_id?: string; /** Present on execution creation; intentionally omitted from status readback. */ operator_contract_hash?: string; idempotency_key: string; approval_hash: string; approved_max_credit_cost: number; provider_config_id: string; provider_config_version: number; provider_config_hash: string; mcp_batch_job_id: string; status: 'queued' | 'processing' | 'reconciliation_required' | 'completed' | 'partial' | 'failed'; item_count: number; terminal_count: number; succeeded_count: number; failed_count: number; actual_credits: number; verification_provider_call_count: number; provider_mutation: false; provider_load: false; activation: false; outbound_queue: false; send: false; final_receipt: Record | null; final_receipt_hash: string | null; reconciled_at: string | null; created_at: string; updated_at: string; } interface CampaignOsVerificationRefreshResultRow { member_ordinal: number; email_identity_hash: string; member_contract_hash: string; prior_last_verified_at: string | null; verification_observed_at: string; terminal_status: 'valid' | 'invalid' | 'unknown' | 'verifier_error'; provider_name: string; provider_status: string; result_returned_from: 'fresh_verification'; live_provider_called: true; credits_used: number; receipt_hash: string; provider_mutation: false; provider_load: false; activation: false; outbound_queue: false; send: false; } interface CampaignOsVerificationRefreshPreviewResult extends CampaignOsVerificationRefreshSafety { success: true; action: 'preview'; preview: CampaignOsVerificationRefreshPreview; replayed: boolean; approval_required: true; operator_action: 'verification_spend'; verification_provider_called: false; provider_calls_made: 0; credits_consumed: 0; } interface CampaignOsVerificationRefreshExecuteResult extends CampaignOsVerificationRefreshSafety { success: true; action: 'execute'; execution: CampaignOsVerificationRefreshExecution; replayed: boolean; approval_consumed: true; verification_provider_called: false; provider_calls_made: 0; credits_consumed: 0; status_poll: { action: 'status'; client_id: string; execution_id: string; }; } interface CampaignOsVerificationRefreshStatusResult extends CampaignOsVerificationRefreshSafety { success: true; action: 'status'; execution: CampaignOsVerificationRefreshExecution; terminal: boolean; result_summary: Record; results: CampaignOsVerificationRefreshResultRow[]; result_count: number; verification_provider_called: boolean; provider_calls_made: number; credits_consumed: number; } interface CampaignOsSourceExpansionPreviewParams { clientId: string; orchestrationId: string; assignmentId?: string; source?: 'clay_search'; provider?: 'clay'; idempotencyKey: string; expiresAt?: string; } interface CampaignOsSourceExpansionReservationParams { clientId: string; previewId: string; receiptId: string; idempotencyKey: string; } interface CampaignOsSourceExpansionExecutionParams { clientId: string; audienceId: string; reservationId: string; receiptId: string; idempotencyKey: string; } interface CampaignOsAudienceScheduleParams { clientId: string; audienceId: string; campaignId?: string; enabled?: boolean; sourcePolicy?: 'cache_only' | 'cache_then_review'; cadenceMinutes?: number; perRunCap?: number; timezone?: string; startAt?: string; runNow?: boolean; } interface CampaignOsAudienceScheduleResult { success: true; schedule: Record; provider_called: false; provider_calls: 0; provider_mutation: false; approval_required: false; clay_standing_approval: false; } interface CampaignOsCacheAudienceUsageReceipt { receipt_version: string; lane: 'signaliz_cache'; provider_called: false; provider_calls: 0; clay_search_allowance_used: 0; clay_actions_used: 0; clay_data_credits_used: 0; signaliz_credits_used: 0; signaliz_cache_reads: number; suppression_read_calls: number; source_projection: 'lead_search_v1'; projection_readiness: Record; [key: string]: unknown; } interface CampaignOsCacheAudienceTerminalReceipt { receipt_version: string; lane: 'signaliz_cache'; target_count: number; input_count: number; terminal_total: number; eligible_memberships: number; candidate_rows_examined: number; provider_called: false; provider_mutation: false; suppression_checked: true; verification_checked: true; reconciled: true; raw_leads_stored: false; result_kind?: 'target_met' | 'partial' | 'no_change'; expected_cohort_target?: number; actual_eligible_count?: number; cohort_shortfall?: number; cache_exhausted?: boolean; [key: string]: unknown; } interface CampaignOsMaterializeCacheAudienceResult { success: true; run: Record; usage_receipt: CampaignOsCacheAudienceUsageReceipt; completion_receipt: CampaignOsCacheAudienceTerminalReceipt; terminal_reconciliation_receipt: CampaignOsCacheAudienceTerminalReceipt; receipt_hash: string; approval_required: false; provider_called: false; provider_calls: 0; provider_mutation: false; orchestration?: Record; cohorts_processed?: Record[]; has_more_cohorts?: boolean; next_cohort_ordinal?: number | null; blocked_reason?: string | null; requires_paid_expansion?: boolean; source_expansion_shortfall_count?: number; [key: string]: unknown; } interface CampaignOsSourceExpansionPreviewResult { success: true; preview_id: string; preview_receipt_hash: string; expires_at: string; receipt: Record; requested_target_count: number; cache_materialized_count: number; measured_shortfall_count: number; remaining_cache_allowance: number; remaining_verification_allowance: number; remaining_managed_sourcing_allowance: number; overage_quantity: number; managed_sourcing_overage_micro_usd: number; max_estimated_cost_micro_usd: number; source_expansion_contract: { operation: 'source_expansion'; contract_version: 'signaliz.source-expansion-preview/v1'; preview_id: string; preview_receipt_hash: string; orchestration_id: string; source: 'clay_search'; provider: 'clay'; measured_shortfall_count: number; overage_quantity: number; managed_sourcing_overage_micro_usd: number; max_estimated_cost_micro_usd: number; reservation_required_before_provider_call: true; }; reservation_allowed: boolean; reservation_block_reason: string | null; bounded_approval_context: Record; next_tool: 'campaign_os_prepare_operator_approval' | null; approval_required_before_paid_expansion: true; provider_called: false; provider_calls: 0; provider_mutation: false; provider_load_performed: false; provider_activation_performed: false; provider_send_performed: false; } interface CampaignOsSourceExpansionReservationResult { success: true; reservation_id: string; reservation_receipt_hash: string; approval_receipt_id: string; approval_contract_hash: string; preview_id: string; preview_receipt_hash: string; quantity: number; overage_quantity: number; max_estimated_cost_micro_usd: number; receipt: Record; approval_required: false; operator_approval_confirmed: true; usage_reserved: true; provider_execution_ready: false; next_tool: null; next_step: string; provider_called: false; provider_calls: 0; provider_mutation: false; provider_load_performed: false; provider_activation_performed: false; provider_send_performed: false; } interface CampaignOsSourceExpansionExecutionResult { success: true; replayed: boolean; reservation_id: string; provider_operation_id: string; provider_receipt: Record; usage_terminal: Record; audience_reconciliation: Record; sourced_count: number; reconciled_materialized_count: number; remaining_shortfall_count: number; actual_cost_micro_usd: number; provider_called: true; provider_calls: number; provider_mutation: true; provider_load_performed: false; provider_activation_performed: false; provider_send_performed: false; } interface CampaignOsActionRequestParams { clientId: string; campaignId?: string; agentVendor?: CampaignOsAgentVendor; actionType: CampaignOsAgentActionType; instructions: string; preflightInputs?: CampaignOsActionPreflightInputs; idempotencyKey: string; } interface CampaignOsActionPreflightInputs { provider?: CampaignOsProvider; providerConnectionId?: string; audienceId?: string; audienceRunId?: string; providerArtifactId?: string; policyId?: string; deliveryId?: string; providerCampaignId?: string; targetCount?: number; verificationMaxAgeDays?: number; } interface CampaignOsActionPreflightResult { success: true; request_id: string; continuation_receipt: Record; continuation_receipt_hash: string; idempotent: boolean; execution_started: false; provider_called: false; provider_mutation: false; } type CampaignOsDecisionState = 'SEND' | 'RESEARCH' | 'WAIT' | 'SUPPRESS'; type CampaignOsDecisionScope = 'none' | 'bounded_canary' | 'scale_review'; interface CampaignOsEvaluateDecisionParams { clientId: string; campaignId: string; includeNetwork?: boolean; validForSeconds?: number; idempotencyKey: string; } interface CampaignOsEvaluateDecisionResult { success: true; dispatched: true; client_id: string; campaign_id: string; campaign_build_id: string | null; evaluated_at: string; valid_for_seconds: number; include_network: boolean; idempotency_key: string; dispatch_reference: string | null; recommendation_only: true; provider_call_performed: false; provider_mutation_performed: false; provider_load_performed: false; provider_activation_performed: false; provider_send_performed: false; spend_performed: false; } interface CampaignOsDecisionReceipt { contract_version: string | null; decision_id: string | null; evidence_digest: string | null; decision: CampaignOsDecisionState | 'unknown'; recommended_scope: CampaignOsDecisionScope; confidence: Record; reason_codes: unknown[]; rationale: unknown[]; source_status: Record; evidence: Record; evidence_labels: unknown[]; next_actions: unknown[]; controlled_test: Record; freshness: Record; guardrails: Record; } interface CampaignOsReceiptParams { clientId?: string; campaignId?: string; limit?: number; } type CampaignOsLifecycleReceiptType = 'decision' | 'campaign_build' | 'audience_run' | 'audience_schedule' | 'provider_artifact' | 'provider_load' | 'action_request' | 'realtime_delivery' | 'provider_event' | 'outcome_snapshot'; type CampaignOsLifecycleStage = 'decision' | 'knowledge' | 'build' | 'audience' | 'compile' | 'approval' | 'provider' | 'realtime' | 'mailbox' | 'outcome'; interface CampaignOsLifecycleReceipt { id: string; receipt_type: CampaignOsLifecycleReceiptType; stage: CampaignOsLifecycleStage; client_id: string | null; campaign_id: string | null; status: string; occurred_at: string; provider: CampaignOsProvider | null; provider_mutation: boolean; proof: Record; } interface CampaignOsReceiptTimelineResult { success: true; action_requests: Array>; decision_receipts: Array<{ id: string; client_id: string | null; campaign_id: string; status: CampaignOsDecisionState | 'unknown'; occurred_at: string; receipt: CampaignOsDecisionReceipt; }>; build_receipts: Array>; audience_receipts: Array>; audience_schedule_receipts: Array>; provider_artifacts: Array>; provider_load_receipts: Array>; delivery_receipts: Array>; provider_event_receipts: Array>; outcome_receipts: Array>; timeline: CampaignOsLifecycleReceipt[]; state_contract: Record; } type CampaignOsProviderCampaignStatus = 'active' | 'paused' | 'completed' | 'draft' | 'unknown'; type CampaignOsLearningRefreshMode = 'live_if_available' | 'stored_only'; type CampaignOsProviderState = 'fresh' | 'stale' | 'partial' | 'unavailable'; type CampaignOsSemanticInterestProof = 'verified' | 'insufficient' | 'unavailable'; interface CampaignOsProviderCampaignSummary { inventory_id: string; /** Exact provider-native identity, safe for deterministic agent routing. */ provider_campaign_id: string; /** Canonical Campaign OS identity; null while the provider row is unlinked. */ campaign_key: string | null; /** Present only when that exact executable campaign object exists. */ gtm_campaign_id: string | null; knowledge_only: boolean; linked: boolean; link_basis: string; link_confidence: 'none' | 'exact' | 'reviewed'; provider: string; provider_campaign_name: string | null; provider_campaign_status: CampaignOsProviderCampaignStatus; first_seen_at: string | null; last_seen_at: string | null; last_synced_at: string | null; missing_since: string | null; metric_presence: Record; } interface CampaignOsProviderCampaignListParams { clientId: string; campaignKey?: string; gtmCampaignId?: string; status?: CampaignOsProviderCampaignStatus; linkedOnly?: boolean; includeMissing?: boolean; limit?: number; } interface CampaignOsProviderCampaignListResult { client_id: string; campaigns: CampaignOsProviderCampaignSummary[]; count: number; includes_unlinked: boolean; includes_knowledge_only: boolean; provider_mutation_performed: false; raw_payload_withheld: true; } interface CampaignOsSyncCampaignLearningParams { clientId: string; connectionId: string; idempotencyKey: string; } interface CampaignOsSyncCampaignLearningResult { dispatched: boolean; route_available: boolean; idempotency_key?: string; dispatch_reference?: string | null; provider_state?: CampaignOsProviderState; provider_state_reason?: string; provider_mutation_performed: false; } /** * Exactly one exact target: campaignKey, gtmCampaignId, or inventoryId. A * knowledge-backed campaign with no executable object is analyzable on * campaignKey alone. */ interface CampaignOsAnalyzeCampaignParams { clientId: string; campaignKey?: string; gtmCampaignId?: string; inventoryId?: string; refreshMode?: CampaignOsLearningRefreshMode; idempotencyKey: string; } interface CampaignOsAnalyzeCampaignResult { dispatched: boolean; /** The resolved canonical identity is always returned. */ campaign_key: string; gtm_campaign_id: string | null; inventory_id: string | null; knowledge_only: boolean; refresh_mode: CampaignOsLearningRefreshMode; idempotency_key: string; dispatch_reference: string | null; provider_mutation_performed: false; } interface CampaignInterestFacts { reply_event_count: number; /** Provider says "interested". Never human semantic proof. */ provider_labeled_interest_count: number; /** Signaliz classifier indication. Never human semantic proof. */ model_indicated_interest_count: number; /** Explicit human-reviewed Interested. The only valid semantic proof. */ human_reviewed_interested_count: number; } interface CampaignOsCampaignAnalysis { analysis_id: string; campaign_key: string | null; gtm_campaign_id: string | null; knowledge_only?: boolean; inventory_id: string | null; refresh_mode: CampaignOsLearningRefreshMode; provider_state: CampaignOsProviderState; provider_state_reason: string; current_metrics: Record; current_metrics_observed: boolean; historical_claims: Array<{ claim: string; source: string; observed_at: string | null; label: 'historical'; }>; semantic_interest_proof: CampaignOsSemanticInterestProof; semantic_interest_reason?: string | null; interest_facts?: CampaignInterestFacts; lessons: string[]; evidence: Array<{ kind: string; ref: string; }>; controlled_changes: Array>; measurement_plan: Record; stop_conditions: string[]; evidence_refs: string[]; provider_call_count: number; receipt_hash: string; created_at: string; } interface CampaignOsCampaignAnalysisParams { clientId: string; analysisId?: string; campaignKey?: string; gtmCampaignId?: string; inventoryId?: string; } interface CampaignOsCampaignAnalysisResult { found: boolean; client_id: string; campaign_key: string | null; analysis?: CampaignOsCampaignAnalysis; provider_mutation_performed: false; raw_payload_withheld?: true; } declare class SignalizError extends Error { readonly code: string; readonly errorType: ErrorType; readonly retryAfter?: number; readonly details?: Record; constructor(data: SignalizErrorData); get isRetryable(): boolean; } declare class Signaliz { private readonly client; constructor(config: SignalizConfig); private engineerRequest; /** Read Client Brain, skills, rules, connections, goals and jobs from the UI workspace. */ getEngineerContext(clientId: string, workspaceId?: string): Promise>; /** Read a complete versioned skill, including its CMM source instructions. */ getEngineerSkill(clientId: string, skillId: string, workspaceId?: string): Promise>; /** Save settings with the revision from context; stale writes are rejected. */ saveEngineerProfile(clientId: string, profile: Record, revision: number, workspaceId?: string): Promise>; createEngineerGoal(clientId: string, goal: { objective: string; metric: string; target: number; deadline: string; budget_usd: number; }, workspaceId?: string): Promise>; updateEngineerGoal(clientId: string, goalId: string, status: 'active' | 'paused' | 'completed', workspaceId?: string): Promise>; /** List only managed builds explicitly bound to this client. */ listEngineerManagedBuilds(clientId: string, workspaceId?: string): Promise>; /** Bind an exact finalized workspace build; does not run it. */ bindEngineerManagedBuild(clientId: string, buildId: string, workspaceId?: string): Promise>; /** Quote a client-bound build without provider execution or spending. */ quoteEngineerManagedBuild(clientId: string, buildId: string, input?: Record, workspaceId?: string): Promise>; /** Save an immutable brief without provider execution. Preserve request_id on explicit retry. */ planEngineerJob(input: { client_id: string; objective: string; skill_id: string; request_id: string; goal_id?: string; }, workspaceId?: string): Promise>; /** Read original context, evaluations and receipts without redispatch. */ getEngineerJob(clientId: string, jobId: string, workspaceId?: string): Promise>; /** Execute the bounded Clay audit once. On an uncertain response, inspect the job before retrying. */ runEngineerJob(clientId: string, input: { job_id: string; request_id: string; source: { transport: 'clay_oauth'; }; table_id: string; field_mapping?: { email_field: string; millionverifier_field: string; bounceban_field: string; observed_at_field: string; max_age_days: number; }; } | { job_id: string; campaign_id: string; } | { job_id: string; connection_id: string; table_id: string; email_field?: string; millionverifier_field?: string; bounceban_field?: string; observed_at_field?: string; max_age_days?: number; }, workspaceId?: string): Promise>; /** Dispatch the campaign-router skill through the existing provider-locked Campaign OS build. */ executeEngineerJob(clientId: string, input: { job_id: string; target_count?: number; audience_definition_id?: string; } | { job_id: string; template: 'email_acceptance'; workflow_name: string; }, workspaceId?: string): Promise>; /** Observe an existing build without creating another run. */ getEngineerJobStatus(clientId: string, jobId: string, workspaceId?: string): Promise>; /** Compile a preview from this job's saved Campaign OS draft; does not activate or send. */ testEngineerJob(clientId: string, jobId: string | { job_id: string; providers?: string[]; } | { job_id: string; request_id: string; source_operation_id: string; }, workspaceId?: string): Promise>; /** Use the existing scoped Campaign OS connection and memory operations. */ getEngineerEnvironment(clientId: string, input: { operation: 'connections.list' | 'connections.bind' | 'sources.approve' | 'sources.read' | 'sources.hydrate' | 'sources.bind' | 'sources.preflight' | 'memory.status' | 'memory.import' | 'memory.search'; args?: Record; }, workspaceId?: string): Promise>; /** Save a reusable client-scoped custom agent without granting new runtime tools. */ saveEngineerAgent(clientId: string, agent: { id?: string; name: string; base_skill_id: 'campaign-router' | 'clay-audit' | 'campaign-review' | 'email-acceptance' | 'workflow-build'; instructions: string; requirements?: string; }, revision: number, workspaceId?: string): Promise>; /** Propose a typed campaign repair from plain language without changing the draft. */ proposeEngineerRepair(clientId: string, input: { job_id: string; request_id: string; change_request: string; providers: string[]; }, workspaceId?: string): Promise>; getEngineerRepairProposal(clientId: string, input: { job_id: string; request_id: string; }, workspaceId?: string): Promise>; applyEngineerRepairProposal(clientId: string, input: { job_id: string; request_id: string; }, workspaceId?: string): Promise>; /** Save one explicit draft repair and compile the resulting revision. */ repairEngineerJob(clientId: string, input: { job_id: string; request_id: string; expected_campaign_spec_version_id: string; campaign_spec: Record; change_reason: string; providers: string[]; } | { job_id: string; request_id: string; source_operation_id: string; }, workspaceId?: string): Promise>; /** Save an observation of existing Campaign OS outcome receipts and a proposed next step. */ observeEngineerJob(clientId: string, jobId: string, workspaceId?: string): Promise>; /** List Final Build systems owned by the authenticated workspace. */ listManagedBuilds(): Promise<{ success: true; builds: ManagedBuild[]; total: number; }>; /** Read one delivered build contract and its fixed per-run price. */ getManagedBuild(buildId: string): Promise<{ success: true; build: ManagedBuild; }>; /** Quote a run from its current input size without creating a run or charging credits. */ quoteManagedBuildRun(buildId: string, input?: Record): Promise<{ success: true; dry_run: true; build: ManagedBuild; quote: ManagedBuildRunQuote; credits_charged: 0; }>; /** * Run a delivered build. Each intended call receives a fresh idempotency key; * pass the same key again only to recover that exact run without double charge. */ runManagedBuild(buildId: string, input?: Record, options?: ManagedBuildRunOptions | string): Promise; /** Read durable status and returned result rows for one managed-build run. */ getManagedBuildRun(runId: string, limit?: number): Promise; /** List the admin-only Campaign OS client portfolio for agent harnesses. */ listCampaignOsClients(params?: CampaignOsListClientsParams): Promise<{ success: true; clients: CampaignOsClientSummary[]; total_returned: number; data_contract: string; }>; /** Read bounded Brain, audience, campaign, policy, and receipt context for one client. */ getCampaignOsClientContext(clientId: string, sourceLimit?: number, knowledgeSnapshotId?: string): Promise; /** Search the immutable current CMM campaign-memory snapshot. */ searchCampaignOsKnowledge(params: CampaignOsKnowledgeSearchParams): Promise; /** Read a safe Clay, Instantly, Smartlead, or Bison runtime contract. This method never calls the provider. */ getCampaignOsProviderRuntime(clientId: string, provider: CampaignOsProvider): Promise; /** Start the evidence-grounded, provider-locked Campaign Brain. No admin approval or provider call occurs. */ startCampaignOsBuild(params: CampaignOsStartBuildParams): Promise>; /** Read a durable Campaign Brain build and its provider-locked CampaignSpec result. */ getCampaignOsBuild(buildRunId: string): Promise>; /** Create an editable provider-locked campaign object without CMM-admin approval. This method never calls a provider. */ createCampaignOsDraft(params: CampaignOsCreateDraftParams): Promise>; /** Append CampaignSpec vN+1 to the same campaign without provider calls or admin approval. */ refineCampaignOsCampaign(params: CampaignOsRefineCampaignParams): Promise>; /** Create or revise a provider-neutral Audience definition without calling Clay. */ createCampaignOsAudienceDraft(params: CampaignOsAudienceDraftParams): Promise>; /** Plan an official-CLI Clay Audience saved-filter create with zero provider calls from Signaliz. */ planCampaignOsClayNativeAudience(params: CampaignOsClayNativePlanParams): Promise>; /** Consume one exact Clay provider_create receipt and return the official CLI create/get packet. */ prepareCampaignOsClayNativeAudience(params: CampaignOsClayNativePrepareParams): Promise>; /** Record validated official-CLI create/get readback or a bounded terminal failure. */ completeCampaignOsClayNativeAudience(params: CampaignOsClayNativeCompleteParams): Promise>; /** Plan or start an exact read-only native Clay Audience membership sync. */ startCampaignOsClayNativeSync(params: CampaignOsClayNativeSyncStartParams): Promise>; /** Append one <=500-id official-CLI page; only hashes are persisted. */ appendCampaignOsClayNativeSyncPage(params: CampaignOsClayNativeSyncPageParams): Promise>; /** Complete only an exactly reconciled count-before/pages/count-after sync. */ completeCampaignOsClayNativeSync(params: CampaignOsClayNativeSyncCompleteParams): Promise>; /** Materialize a grant-bounded cache-only Audience target as resumable cohorts of at most 500, with zero provider or Clay usage and no approval request. */ materializeCampaignOsCacheAudience(params: CampaignOsMaterializeCacheAudienceParams): Promise; /** Plan deterministic, replay-safe Campaign OS cohorts without sourcing, provider calls, spend authority, load, activation, queue, or send. */ planCampaignOsCohorts(params: CampaignOsCohortPlanParams): Promise; /** Preview the exact stale <=500-member refresh set and canonical Signaliz-credit ceiling. No provider call or spend occurs. */ previewCampaignOsVerificationRefresh(params: CampaignOsVerificationRefreshPreviewParams): Promise; /** Consume one exact verification_spend receipt for the immutable preview. This never loads, activates, queues, or sends. */ executeCampaignOsVerificationRefresh(params: CampaignOsVerificationRefreshExecuteParams): Promise; /** Read hash-only progress and terminal verification receipts. Raw emails are never returned. */ getCampaignOsVerificationRefresh(params: CampaignOsVerificationRefreshStatusParams): Promise; /** Preview only the exact cache shortfall and its tenant plan/cost envelope. No usage is reserved and no provider is called. */ previewCampaignOsSourceExpansion(params: CampaignOsSourceExpansionPreviewParams): Promise; /** Reserve the exact confirmed Clay source-expansion shortfall. This writes an immutable usage receipt but makes no provider call. */ reserveCampaignOsSourceExpansion(params: CampaignOsSourceExpansionReservationParams): Promise; /** Execute one exact reserved Clay Search shortfall. The authenticated provider and usage receipts remain load/send locked. */ executeCampaignOsSourceExpansion(params: CampaignOsSourceExpansionExecutionParams): Promise; /** Configure cache-first always-on audience deltas without creating standing Clay approval. */ upsertCampaignOsAudienceSchedule(params: CampaignOsAudienceScheduleParams): Promise; /** Append a deterministic zero-provider-call Audience preview receipt. */ previewCampaignOsAudience(clientId: string, audienceId: string, idempotencyKey: string): Promise>; /** Compile provider-specific previews; Instantly may perform bounded read-only sender validation. */ compileCampaignOsPreview(clientId: string, campaignId: string, providers?: 'all' | 'instantly' | 'smartlead' | 'bison', senderEmails?: string[]): Promise>; /** Freeze one exact planned cohort and its audience-run suppression snapshot against an authenticated Instantly Draft. */ prepareCampaignOsProviderLoad(params: { clientId: string; campaignId: string; providerArtifactId: string; campaignCohortId: string; audienceRunId: string; idempotencyKey: string; verificationMaxAgeDays?: number; }): Promise>; /** Execute exactly one separately approved Instantly lifecycle action. */ executeCampaignOsProviderAction(params: { clientId: string; action: 'provider_create' | 'provider_load' | 'provider_send' | 'provider_activation'; receiptId: string; providerArtifactId: string; providerLoadId?: string; }): Promise>; /** Plan Signaliz Alpha research without calling a model, web search, Clay, or delivery provider. */ planCampaignOsAlpha(params: CampaignOsAlphaPlanParams): Promise>; /** Run one source-cited Signaliz Alpha discovery under a $0.10 authorization ceiling. Output remains candidate-only. */ startCampaignOsAlphaDiscovery(params: CampaignOsAlphaDiscoveryParams): Promise; /** Read and reconcile one tenant-bound Signaliz Alpha discovery receipt. */ getCampaignOsAlphaRun(alphaRunId: string): Promise; /** Validate one discovered Alpha candidate on 3-20 exact entities with a fixed $0.25 ceiling. */ startCampaignOsAlphaValidation(params: CampaignOsAlphaValidationParams): Promise; /** Read and reconcile one receipt-derived Alpha validation run. */ getCampaignOsAlphaValidationRun(validationRunId: string): Promise; /** Append a passing Alpha validation to the exact current CampaignSpec; providers stay locked. */ applyCampaignOsValidatedAlpha(validationRunId: string): Promise; /** Create an immutable no-spend Alpha materialization preflight for exact campaign, audience, and validation lineage. */ preflightCampaignOsAlphaMaterialization(params: CampaignOsAlphaMaterializationPreflightParams): Promise; /** Start only the research spend bounded by an immutable Alpha materialization preflight; providers remain locked. */ startCampaignOsAlphaMaterialization(params: CampaignOsAlphaMaterializationStartParams): Promise; /** Read and reconcile one tenant-bound Alpha materialization without starting new work or spend. */ getCampaignOsAlphaMaterialization(materializationRunId: string): Promise; /** Deterministically assign exact evidence-qualified members to immutable control and treatment cohorts without provider execution. */ assignCampaignOsAlphaExperiment(params: CampaignOsAlphaExperimentAssignParams): Promise; /** Read one immutable Alpha assignment receipt. Separate cohort outcomes are required before claiming lift. */ getCampaignOsAlphaExperiment(experimentRunId: string): Promise; /** Compile exact control/treatment cohorts into separate provider-neutral envelopes without provider execution. */ compileCampaignOsAlphaExperiment(params: CampaignOsAlphaExperimentCompileParams): Promise; /** List secret-free customer-owned connections and scoped sources for one Client Brain. */ listCampaignOsConnections(clientId: string): Promise; /** * Revalidate one already-connected provider route with bounded read-only * provider calls. The stored secret is decrypted server-side and is never * returned to the caller. */ revalidateCampaignOsProviderConnection(params: { clientId: string; connectionId: string; provider: CampaignOsProvider; }): Promise>; /** Create a draft exact source binding. This never approves or calls a provider. */ createCampaignOsSourceBinding(params: CampaignOsSourceBindingParams): Promise>; /** Append a deterministic no-provider-call source preflight run. */ preflightCampaignOsSourceBinding(clientId: string, sourceBindingId: string, idempotencyKey: string, maxRecords?: number): Promise>; /** @deprecated Use createCampaignOsSourceBinding. */ createCampaignOsSourcePolicy(params: CampaignOsSourcePolicyParams): Promise>; /** @deprecated Use preflightCampaignOsSourceBinding. */ preflightCampaignOsSourcePolicy(clientId: string, sourcePolicyId: string, idempotencyKey: string, maxRecords?: number): Promise>; /** Submit a review request. Provider load, activation, and send do not execute here. */ submitCampaignOsActionRequest(params: CampaignOsActionRequestParams): Promise>; /** Prepare or read an approved request's immutable no-call continuation. This never invokes a provider. */ prepareCampaignOsActionPreflight(clientId: string, requestId: string): Promise; /** Read the bounded build-to-outcome timeline without recipient secrets. */ listCampaignOsReceipts(params?: CampaignOsReceiptParams): Promise; /** * Evaluate current campaign truth into a durable recommendation receipt. * SEND is recommendation-only and never authorizes a provider call. */ evaluateCampaignOsDecision(params: CampaignOsEvaluateDecisionParams): Promise; /** * Read the discovered read-only provider campaign inventory, including * campaigns never linked to a canonical Campaign OS campaign. */ listCampaignOsProviderCampaigns(params: CampaignOsProviderCampaignListParams): Promise; /** Request an immediate read-only learning refresh for one exact route. */ syncCampaignOsCampaignLearning(params: CampaignOsSyncCampaignLearningParams): Promise; /** Request one immutable read-only campaign analysis. */ analyzeCampaignOsCampaign(params: CampaignOsAnalyzeCampaignParams): Promise; /** * Read-only named-operator authority status for the authenticated operator: * active grant, permissions, harness-key binding, expiry, recent receipts. */ getCampaignOsOperatorAuthority(params?: { clientId?: string; receiptLimit?: number; }): Promise>; /** * Issue one fresh, short-lived operator preflight for exactly one * consequential action. Performs zero provider calls and unlocks nothing. */ prepareCampaignOsOperatorApproval(params: { clientId: string; action: CampaignOsOperatorAction; provider: 'clay' | 'instantly' | 'signaliz'; campaignKey?: string; gtmCampaignId?: string; audienceId?: string; providerConnectionId?: string; leadCount: number; costCeilingCredits: number; specHash?: string; artifactHashes?: string[]; clayNativeAudience?: { operation: 'clay_native_audience_create'; contract_version: 'signaliz.clay-native-audience-companion/v1'; definition_version: number; definition_hash: string; clay_workspace_id: string; entity_type: 'people' | 'companies'; filter_hash: string; expected_count: number; }; sourceExpansion?: { operation: 'source_expansion'; contract_version: 'signaliz.source-expansion-preview/v1'; preview_id: string; preview_receipt_hash: string; orchestration_id: string; source: 'clay_search'; provider: 'clay'; measured_shortfall_count: number; overage_quantity: number; managed_sourcing_overage_micro_usd: number; max_estimated_cost_micro_usd: number; reservation_required_before_provider_call: true; }; verificationRefresh?: CampaignOsVerificationRefreshOperatorContract; idempotencyKey: string; }): Promise>; /** * Convert one explicit operator confirmation into a single-use approval * receipt for an exact server-issued preflight. Never executes a provider * mutation: execution requires the separate provider execution endpoint. */ confirmCampaignOsOperatorApproval(params: { clientId: string; preflightId: string; challengeNonce: string; contractHash: string; contract: Record; confirmationText: string; confirmationChannel: 'chat' | 'verbal_relayed' | 'web_console'; harness: 'signaliz_agent' | 'codex' | 'claude_code' | 'cursor' | 'devin' | 'grok' | 'web_console'; }): Promise>; /** Read one operator approval receipt. Never returns secrets. */ getCampaignOsOperatorApprovalReceipt(params: { clientId: string; receiptId: string; }): Promise>; /** * Read-only status of the EXTERNAL AgentMemory product (agentmemory 0.9.29) * for one client: active lane, remote endpoint origin when configured, last * packet provenance, and install routes. Never returns a bearer secret. */ getCampaignOsAgentMemoryStatus(params: { clientId: string; packetLimit?: number; }): Promise>; /** * Import one bounded AgentMemory retrieval packet the caller already * fetched. Signaliz performs no network call here, so this works against a * localhost or self-hosted AgentMemory instance. Imported memory is * advisory evidence only. */ importCampaignOsAgentMemoryPacket(params: { clientId: string; sourceInstance: string; retrievalQuery: string; retrievedAt: string; agentMemoryVersion?: string; eligibleItemTypes?: Array<'fact' | 'decision' | 'lesson' | 'note' | 'observation'>; packetHash?: string; items: Array>; }): Promise>; /** Read one imported AgentMemory packet receipt plus its evidence ref. */ getCampaignOsAgentMemoryPacket(params: { clientId: string; packetId: string; selectedItemIds?: string[]; }): Promise>; /** * Read-only: build a portable AgentMemory learning packet from a receipted * Campaign OS lesson. Signaliz never writes to an external AgentMemory * instance: saving it back is an explicit operator action. */ buildCampaignOsAgentMemoryLearningExport(params: { clientId: string; campaignKey: string; analysisId?: string; project?: string; tags?: string[]; }): Promise>; /** * Read-only Campaign Learning Memory campaign start gate. Returns a * cmm-campaign-start-v1-compatible start-gate receipt. Metadata only: * content_stored is always false and no recalled text is returned. */ campaignMemorySearch(params: { clientId: string; client?: string; campaignId: string; campaignDir?: string; objective: string; limit?: number; hitCount?: number; unavailable?: boolean; blockedReason?: string; }): Promise>; /** Read-only: workspace recall mode, connection state, and gate decision. */ getCampaignMemoryGateStatus(params: { clientId: string; campaignId?: string; actionKind?: 'provider_capable' | 'safe_draft' | 'read'; }): Promise>; /** * Read-only Campaign Learning Memory connection state and recent recall * receipts. Never returns a secret, recalled text, or provider payloads. */ campaignLearningMemoryStatus(params: { clientId: string; recallLimit?: number; }): Promise>; /** Read one immutable Campaign Learning Memory start-gate receipt. */ getCampaignMemoryGateReceipt(params: { clientId: string; receiptId?: string; receiptHash?: string; }): Promise>; /** Import an external cmm.campaign-memory-gate/v1 receipt as provenance. */ importCampaignMemoryGateReceipt(params: { clientId: string; client?: string; campaignId: string; expectedQueryHash?: string; receipt: Record; }): Promise>; /** Read one immutable Campaign OS analysis receipt. */ getCampaignOsCampaignAnalysis(params: CampaignOsCampaignAnalysisParams): Promise; /** * The canonical Signal Awareness control plane used by the CLI and MCP. * Manual runs accept a stable retry key and return an explicit billing * receipt, including zero-credit available-data reuse. */ signalAwareness(request: SignalAwarenessRequest): Promise; addSignalAwarenessCompany(domain: string, schedule?: SignalAwarenessSchedulePreset): Promise; deleteSignalAwarenessCompany(domain: string): Promise; changeSignalAwarenessSchedule(domain: string, schedule: SignalAwarenessSchedulePreset): Promise; listAllSignalAwarenessSignals(domain: string): Promise; createSignalMonitor(monitor: SignalMonitorInput): Promise; listSignalMonitors(limit?: number, offset?: number): Promise; runSignalMonitor(monitorId: string, idempotencyKey?: string): Promise; updateSignalMonitor(monitorId: string, updates: SignalMonitorUpdateInput): Promise; pauseSignalMonitor(monitorId: string): Promise; resumeSignalMonitor(monitorId: string): Promise; deleteSignalMonitor(monitorId: string): Promise; listSignalAwarenessSignals(monitorId?: string, limit?: number, offset?: number): Promise; bulkCreateSignalMonitors(monitors: SignalMonitorInput[], defaults?: SignalMonitorDefaults): Promise; getSignalAwarenessSettings(): Promise; setSignalAwarenessOutput(outputMode: 'csv' | 'webhook', webhookUrl?: string | null): Promise; testSignalAwarenessWebhook(webhookUrl: string): Promise; exportSignalAwareness(monitorId?: string): Promise; sendSignalAwarenessExport(signals: SignalAwarenessSignal[]): Promise; findEmail(params: FindEmailParams & { dryRun: true; }): Promise; findEmail(params: FindEmailParams): Promise; findEmails(params: FindEmailParams[], options: BatchOptions & { dryRun: true; }): Promise; findEmails(params: FindEmailParams[], options?: BatchOptions): Promise>; resumeFindEmailBatch(jobId: string, options?: CoreEmailBatchResumeOptions): Promise>; verifyEmail(email: string | undefined, options: VerifyEmailOptions & { dryRun: true; }): Promise; verifyEmail(email: string | undefined, options?: VerifyEmailOptions): Promise; verifyEmails(emails: Array, options: VerifyEmailBatchOptions & { dryRun: true; }): Promise; verifyEmails(emails: Array, options?: VerifyEmailBatchOptions): Promise>; resumeVerifyEmailBatch(jobId: string, options?: CoreEmailBatchResumeOptions): Promise>; enrichCompanySignals(params: CompanySignalEnrichmentParams & { dryRun: true; }): Promise; enrichCompanySignals(params: CompanySignalEnrichmentParams): Promise; discoverSignals(params: SignalDiscoveryParams & { dryRun: true; }): Promise; discoverSignals(params: SignalDiscoveryParams): Promise; /** Signals First is the customer-facing name for open-ended discovery. */ discoverSignalsFirst(params: SignalDiscoveryParams & { dryRun: true; }): Promise; discoverSignalsFirst(params: SignalDiscoveryParams): Promise; startFlow(params: SignalizFlowParams): Promise; getFlow(runId: string): Promise; enrichCompanies(companies: CompanySignalEnrichmentParams[], options: BatchOptions & { dryRun: true; }): Promise; enrichCompanies(companies: CompanySignalEnrichmentParams[], options: BatchOptions & { waitForResult: false; }): Promise; enrichCompanies(companies: CompanySignalEnrichmentParams[], options?: BatchOptions): Promise>; resumeCompanySignalBatch(jobId: string, options?: CoreBatchResumeOptions): Promise>; signalToCopy(params: SignalToCopyParams & { dryRun: true; }): Promise; signalToCopy(params: SignalToCopyParams): Promise; createSignalCopyBatch(requests: SignalToCopyParams[], options: BatchOptions & { dryRun: true; }): Promise; createSignalCopyBatch(requests: SignalToCopyParams[], options: BatchOptions & { waitForResult: false; }): Promise; createSignalCopyBatch(requests: SignalToCopyParams[], options?: BatchOptions): Promise>; resumeSignalCopyBatch(jobId: string, options?: CoreBatchResumeOptions): Promise>; private runCoreProductDryRun; private runSignalCopyBatchChunks; private runRecoverableCoreBatchJob; private submitRecoverableCoreBatchJob; private readRecoverableCoreBatchJob; private runSignalCopyBatchChunk; private runCoreBatchRound; listTools(): Promise; health(): Promise; } export { type BatchItemResult, type BatchOptions, type BatchResult, CAMPAIGN_OS_KNOWLEDGE_RECORD_KINDS, type CampaignOsActionPreflightInputs, type CampaignOsActionPreflightResult, type CampaignOsActionRequestParams, type CampaignOsAgentActionType, type CampaignOsAgentVendor, type CampaignOsAlphaCausalClaimStatus, type CampaignOsAlphaCohortStatus, type CampaignOsAlphaDiscoveryParams, type CampaignOsAlphaExperimentAssignParams, type CampaignOsAlphaExperimentCompilationResult, type CampaignOsAlphaExperimentCompileParams, type CampaignOsAlphaExperimentOutcomeReadModel, type CampaignOsAlphaExperimentRunResult, type CampaignOsAlphaMaterializationPreflightParams, type CampaignOsAlphaMaterializationRunResult, type CampaignOsAlphaMaterializationStartParams, type CampaignOsAlphaPlanParams, type CampaignOsAlphaRunResult, type CampaignOsAlphaSampleEntity, type CampaignOsAlphaValidationParams, type CampaignOsAlphaValidationRunResult, type CampaignOsAnalyzeCampaignParams, type CampaignOsAnalyzeCampaignResult, type CampaignOsAudienceDraftParams, type CampaignOsAudienceScheduleParams, type CampaignOsAudienceScheduleResult, type CampaignOsCacheAudienceTerminalReceipt, type CampaignOsCacheAudienceUsageReceipt, type CampaignOsCampaignAnalysis, type CampaignOsCampaignAnalysisParams, type CampaignOsCampaignAnalysisResult, type CampaignOsClayNativeCompleteParams, type CampaignOsClayNativePlanParams, type CampaignOsClayNativePrepareParams, type CampaignOsClayNativeSyncCompleteParams, type CampaignOsClayNativeSyncPageParams, type CampaignOsClayNativeSyncStartParams, type CampaignOsClientContext, type CampaignOsClientSummary, type CampaignOsCohort, type CampaignOsCohortCostReceipt, type CampaignOsCohortPlan, type CampaignOsCohortPlanParams, type CampaignOsCohortPlanReceipt, type CampaignOsCohortPlanResult, type CampaignOsCohortReceipt, type CampaignOsConnectionFabricResult, type CampaignOsCreateDraftParams, type CampaignOsDecisionReceipt, type CampaignOsDecisionScope, type CampaignOsDecisionState, type CampaignOsEvaluateDecisionParams, type CampaignOsEvaluateDecisionResult, type CampaignOsKnowledgeRecordKind, type CampaignOsKnowledgeSearchParams, type CampaignOsKnowledgeSearchResult, type CampaignOsLearningRefreshMode, type CampaignOsLifecycleReceipt, type CampaignOsLifecycleReceiptType, type CampaignOsLifecycleStage, type CampaignOsListClientsParams, type CampaignOsMaterializeCacheAudienceParams, type CampaignOsMaterializeCacheAudienceResult, type CampaignOsOperatorAction, type CampaignOsProvider, type CampaignOsProviderCampaignListParams, type CampaignOsProviderCampaignListResult, type CampaignOsProviderCampaignStatus, type CampaignOsProviderCampaignSummary, type CampaignOsProviderRuntime, type CampaignOsProviderState, type CampaignOsReceiptParams, type CampaignOsReceiptTimelineResult, type CampaignOsRefineCampaignParams, type CampaignOsSemanticInterestProof, type CampaignOsSourceBindingParams, type CampaignOsSourceExpansionExecutionParams, type CampaignOsSourceExpansionExecutionResult, type CampaignOsSourceExpansionPreviewParams, type CampaignOsSourceExpansionPreviewResult, type CampaignOsSourceExpansionReservationParams, type CampaignOsSourceExpansionReservationResult, type CampaignOsSourceKind, type CampaignOsSourcePolicyParams, type CampaignOsStartBuildParams, type CampaignOsSyncCampaignLearningParams, type CampaignOsSyncCampaignLearningResult, type CampaignOsVerificationRefreshExecuteParams, type CampaignOsVerificationRefreshExecuteResult, type CampaignOsVerificationRefreshExecution, type CampaignOsVerificationRefreshOperatorContract, type CampaignOsVerificationRefreshPreview, type CampaignOsVerificationRefreshPreviewParams, type CampaignOsVerificationRefreshPreviewResult, type CampaignOsVerificationRefreshResultRow, type CampaignOsVerificationRefreshSafety, type CampaignOsVerificationRefreshSourceKind, type CampaignOsVerificationRefreshStatusParams, type CampaignOsVerificationRefreshStatusResult, type CompanySignal, type CompanySignalEnrichmentParams, type CompanySignalEnrichmentResult, type CoreBatchResumeOptions, type CoreEmailBatchResumeOptions, type ErrorType, type FindEmailParams, type FindEmailResult, type MCPToolInfo, type ManagedBuild, type ManagedBuildRun, type ManagedBuildRunOptions, type ManagedBuildRunQuote, type ManagedBuildRunResult, type PlatformHealth, type PublicSignalRow, type RecoverableBatchJob, type SignalAwarenessAction, type SignalAwarenessMonitor, type SignalAwarenessRequest, type SignalAwarenessResponse, type SignalAwarenessRun, type SignalAwarenessSchedulePreset, type SignalAwarenessSignal, type SignalDiscoveryParams, type SignalDiscoveryResult, type SignalDiscoverySignal, type SignalDiscoveryStatus, type SignalMonitorDefaults, type SignalMonitorInput, type SignalMonitorUpdateInput, type SignalToCopyParams, type SignalToCopyResult, type SignalToCopyVariation, Signaliz, type SignalizConfig, SignalizError, type SignalizErrorData, type SignalizFlowBillingReceipt, type SignalizFlowParams, type SignalizFlowReceiptLine, type SignalizFlowStartResult, type SignalizFlowStatus, type VerifyEmailBatchInput, type VerifyEmailBatchOptions, type VerifyEmailOptions, type VerifyEmailRecommendation, type VerifyEmailResult, type VerifyEmailStatus };