OptionalArtifactDirectory for structured progress artifacts. Defaults to
<cwd>/logs/integration-runs. Each run gets its own <runID>/ subdir
containing manifest.json, progress.jsonl, result.json.
CompanyIntegration row to authenticate with.
The connector instance to drive (already constructed by caller).
OptionalConsoleMirror progress to console (default false).
User context for all entity operations.
OptionalDeactivate§7 — when true, this is a COMPREHENSIVE re-discovery: declared/discovered objects (and their fields) ABSENT from this run are deactivated (Status='Disabled', never deleted; reversible on a later rediscovery). Only set on a full-surface refresh — a scoped/partial discovery must leave it false so it never disables what it didn't look at. Threaded to PersistDiscoveredSchema.
OptionalIntrospectOptional subset filter — limits introspection to a named set of objects.
OptionalLLMOptional one-shot LLM callback for the PK classifier's last-resort step.
OptionalProviderOptional metadata provider override (multi-provider scenarios).
OptionalRunOptional explicit runID. When omitted, generated as connector-<ts>-<rand>.
Supply your own when resuming a previously-killed run.
OptionalSampleOptional pre-fetched sample rows per object for statistical PK detection.
OptionalTriggerTrigger reason recorded in the manifest.
OptionalUniversalOptional vendor-wide PK convention hint (e.g. "id" for HubSpot).
Options for the creation/refresh pipeline run.