{
  "type": "function",
  "name": "sec-enforcement-litigation-delta-feed",
  "description": "Structures SEC.gov's own Litigation Releases and Administrative Proceedings feeds into delta events: respondent, statute/rule citations, monetary sanctions, and a best-effort linked EDGAR CIK. Outside the saturated 10-K/8-K/Form-4 filings-scraper niche. Pay-per-event: billed only for what changed.",
  "strict": true,
  "parameters": {
    "type": "object",
    "properties": {
      "sources": {
        "type": [
          "array",
          "null"
        ],
        "description": "Which of SEC.gov's own enforcement feeds to walk each run. 'Litigation Releases' are HTML pages under sec.gov/enforcement-litigation/litigation-releases/lr-NNNNN (RSS at .../litigation-releases/rss, live-verified). 'Administrative Proceedings' link directly to PDF orders under sec.gov/files/litigation/admin/YYYY/34-NNNNNN.pdf (RSS at .../administrative-proceedings/rss, live-verified) and require a separate PDF text-extraction pass. Default [\"litigation_releases\",\"administrative_proceedings\"] if omitted.",
        "items": {
          "type": "string",
          "enum": [
            "litigation_releases",
            "administrative_proceedings"
          ],
          "enumTitles": [
            "Litigation Releases (HTML)",
            "Administrative Proceedings (PDF orders)"
          ]
        }
      },
      "onlyNew": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "When true (default), only NEW_LISTING and content-changed (UPDATED) records are pushed as charged events. Set false to also push free, uncharged SNAPSHOT_NO_DIFF records for every release the walk touches. Default true if omitted."
      },
      "maxItemsPerRun": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Caps the number of charged (result/result-summary) events this run will push, independent of your Apify spending limit. 0 means no Actor-side cap. Default 0 if omitted.",
        "minimum": 0
      },
      "enableCikLinking": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "When true (default), each parsed respondent name is looked up against SEC's own EDGAR company database (browse-edgar company search) to attach a linked_edgar_cik. A match scoring below cikMatchConfidenceThreshold is left null rather than guessed. Default true if omitted."
      },
      "cikMatchConfidenceThreshold": {
        "type": [
          "number",
          "null"
        ],
        "description": "Minimum name-match confidence (0-1) required before linked_edgar_cik is populated. Default 0.80 is deliberately conservative - a real respondent, 'Invesco Alpha Inc.', shares a name substring with the real, unrelated NYSE-listed Invesco Ltd, and a lower threshold would risk wrongly attaching a real public company's CIK to an unrelated enforcement action in your vendor-risk feed. Default 0.8 if omitted.",
        "minimum": 0.5
      },
      "watchlistNames": {
        "type": [
          "array",
          "null"
        ],
        "description": "Entity or individual names (case-insensitive substring match against parsed respondents) you specifically want flagged. A match sets is_watchlist_match: true. Default [] if omitted."
      },
      "userAgent": {
        "type": "string",
        "description": "SEC's own fair-access policy (sec.gov/os/webmaster-faq#developers) requires automated requests to sec.gov/data.sec.gov to declare a descriptive User-Agent identifying the requester, typically '<Your Company Name> <your-contact-email>'. Sent verbatim on every request."
      },
      "requestDelayMs": {
        "type": [
          "integer",
          "null"
        ],
        "description": "A flat delay applied between every successful request to sec.gov/data.sec.gov, independent of retries - a deliberately conservative default since this Actor's endpoints were live-verified for shape and availability only, not load-tested against SEC's general fair-access ceiling. Default 750 if omitted.",
        "minimum": 100
      },
      "maxRetries": {
        "type": [
          "integer",
          "null"
        ],
        "description": "Retry attempts for a 429/5xx response or a network-level failure before a request is treated as failed for this run. Exponential backoff (1000ms * 2^attempt, jittered, capped at 15s). Default 4 if omitted.",
        "minimum": 0
      },
      "requestTimeoutSecs": {
        "type": [
          "integer",
          "null"
        ],
        "description": "AbortSignal timeout applied to every individual HTTP request (feed page, release page, PDF download, EDGAR lookup). Default 30 if omitted.",
        "minimum": 5
      },
      "deltaStateName": {
        "type": [
          "string",
          "null"
        ],
        "description": "Names the Key-Value Store this schedule's seen-release state is kept in. Run two schedules - e.g. one full-coverage, one watchlist-only - without them draining each other's baseline by giving each a distinct name here. Default \"default\" if omitted."
      },
      "resetState": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "When true, clears this schedule's stored seen-release state before walking, so the next run re-baselines from scratch. Use for testing or recovering a corrupted state store, not routine operation. Default false if omitted."
      }
    },
    "required": [
      "sources",
      "onlyNew",
      "maxItemsPerRun",
      "enableCikLinking",
      "cikMatchConfidenceThreshold",
      "watchlistNames",
      "userAgent",
      "requestDelayMs",
      "maxRetries",
      "requestTimeoutSecs",
      "deltaStateName",
      "resetState"
    ],
    "additionalProperties": false
  }
}