@remnic/core 9.69.56 → 9.69.58

package/dist/connectors/index.js

@@ -29,11 +29,11 @@ import {
   upsertHermesConfig,
   validateMarketplaceManifest,
   writeMarketplaceManifest
-} from "../chunk-SGUDMW2K.js";
-import "../chunk-7IRZK6MM.js";
+} from "../chunk-GK6NOQE6.js";
+import "../chunk-754XN6LX.js";
 import {
   runCodexMaterialize
-} from "../chunk-WUJD4CHZ.js";
+} from "../chunk-YXQE67A7.js";
 import "../chunk-3UXOZBHV.js";
 import {
   MATERIALIZE_VERSION,
@@ -58,18 +58,18 @@ import {
 import "../chunk-236PXYG7.js";
 import "../chunk-ZCUTSMR2.js";
 import "../chunk-QDW3E4RD.js";
-import "../chunk-QWQB7TOB.js";
-import "../chunk-UHVXE24Y.js";
+import "../chunk-S2OBXHMN.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-AIVRD66I.js";
-import "../chunk-PLJ2MQFT.js";
-import "../chunk-KVO2BTA4.js";
-import "../chunk-CYEPCZN5.js";
-import "../chunk-G6NQ3L4T.js";
+import "../chunk-W6YK672C.js";
+import "../chunk-IAZPYX6W.js";
 import "../chunk-WPGR3RW4.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-D7MAYFQP.js";
+import "../chunk-KVO2BTA4.js";
+import "../chunk-CYEPCZN5.js";
+import "../chunk-G6NQ3L4T.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
 import "../chunk-TFA6HPOA.js";
@@ -77,20 +77,19 @@ import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
 import "../chunk-S2V7RUCL.js";
-import "../chunk-4UVJ6EIT.js";
 import "../chunk-MRPOZBJC.js";
 import "../chunk-S2HLHAZ4.js";
 import "../chunk-DM2T26WE.js";
 import "../chunk-LDXUBPMO.js";
-import "../chunk-S45INSV3.js";
+import "../chunk-FF6N7BXC.js";
 import "../chunk-J3IWHCMF.js";
 import "../chunk-AAD2ZS6P.js";
 import "../chunk-DUJYRVUD.js";
+import "../chunk-YXZG5TVN.js";
 import "../chunk-ZIKENA2C.js";
 import "../chunk-PCEYGOSL.js";
 import "../chunk-SCU65EZI.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-YXZG5TVN.js";
 import "../chunk-5GINB5LC.js";
 import "../chunk-3WU7XOFN.js";
 import "../chunk-G7D6GZ5J.js";
@@ -114,15 +113,14 @@ import "../chunk-45GF7Y3V.js";
 import "../chunk-EP6BA7VV.js";
 import "../chunk-E2AWJ7KQ.js";
 import "../chunk-YCVB7X56.js";
+import {
+  coerceInstallExtension
+} from "../chunk-PQVCH2AE.js";
 import "../chunk-PJKTFXE2.js";
 import "../chunk-W5BIQOAJ.js";
 import "../chunk-Z7L72ZHL.js";
 import "../chunk-4O4TKIXQ.js";
 import "../chunk-C5C7IJ4Q.js";
-import "../chunk-RGMVMVMF.js";
-import {
-  coerceInstallExtension
-} from "../chunk-PQVCH2AE.js";
 import "../chunk-GDYU6VF4.js";
 import "../chunk-BT7NVCML.js";
 import "../chunk-VYCOJKSX.js";
@@ -135,12 +133,14 @@ import "../chunk-ZA53AZND.js";
 import "../chunk-7RJUVTVF.js";
 import "../chunk-AL3UYZ5N.js";
 import "../chunk-RL6NEVXT.js";
-import "../chunk-PWPIERBM.js";
-import "../chunk-MZWSOLMT.js";
+import "../chunk-IG747LRN.js";
 import "../chunk-C7HJ3NEI.js";
 import "../chunk-NB3LRY4T.js";
 import "../chunk-5FVVY2EB.js";
 import "../chunk-FFAZ2XFU.js";
+import "../chunk-FNQEXI3D.js";
+import "../chunk-RGMVMVMF.js";
+import "../chunk-PWPIERBM.js";
 import "../chunk-JDSVLVCG.js";
 import "../chunk-5GKPFL3S.js";
 import "../chunk-JAKIDQB2.js";
@@ -151,7 +151,7 @@ import "../chunk-JUOZ62Y7.js";
 import "../chunk-ZEFVK7XC.js";
 import "../chunk-6KH5NLQS.js";
 import "../chunk-P2QRMMVQ.js";
-import "../chunk-2Z24E5W2.js";
+import "../chunk-3MUKQQ7A.js";
 import "../chunk-BTTPKDIL.js";
 import "../chunk-FF4KLI5W.js";
 import "../chunk-JN72EPOE.js";

package/dist/connectors/label.d.ts

@@ -0,0 +1,19 @@
+/**
+ * connectors/label.ts — shared constants for rendering a connector identity
+ * into model-visible surfaces (issue #2183).
+ *
+ * `CONNECTOR_ID_PATTERN` is the canonical persisted-ID charset (re-exported from
+ * index.ts so callers don't depend on the registry module's internals).
+ * `CONNECTOR_LABEL_MAX_LENGTH` is the display bound shared by the recall
+ * renderer and the extraction-side helper (#2184) so the two cannot drift.
+ *
+ * The recall renderer TRUNCATES past the bound (attribution survives); #2184
+ * SUPPRESSES instead, because a truncated id in a prompt could collide with a
+ * different connector whereas a truncated display label cannot mislead the same
+ * way. Kept in its own module so the capped registry file (connectors/index.ts)
+ * stays at its ratchet ceiling.
+ */
+export { CONNECTOR_ID_PATTERN } from "./index.js";
+export declare const CONNECTOR_LABEL_MAX_LENGTH = 64;
+export declare function knownConnectorIds(): ReadonlySet<string>;
+//# sourceMappingURL=label.d.ts.map

package/dist/connectors/label.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../src/connectors/label.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAM7C,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,MAAM,CAAC,CAWvD"}

package/dist/connectors/live/framework.d.ts

@@ -0,0 +1,169 @@
+/**
+ * @remnic/core — Live Connectors Framework (issue #683 PR 1/N)
+ *
+ * Defines the contract that every "live" connector (Drive, Notion, Gmail,
+ * GitHub, ...) must satisfy. A live connector is **continuous**: it runs on a
+ * schedule, persists a cursor to disk, and ingests *new* documents since the
+ * last sync. This is distinct from one-shot importers in
+ * `packages/remnic-core/src/importers/` which transform an entire export file
+ * in a single pass.
+ *
+ * This module is intentionally pure types + interfaces. No I/O. No schedule
+ * wiring. Concrete connectors (PRs 2–5), the maintenance scheduler hookup
+ * (separate PR), and the CLI surface (PR 6) are deferred.
+ *
+ * Naming caveat: `packages/remnic-core/src/connectors/` is already scoped to
+ * the Codex marketplace integration. The live-connector framework lives under
+ * the `live/` subdirectory to avoid collision. Do not import Codex symbols
+ * from here, and do not import live-connector symbols from the Codex code.
+ */
+/**
+ * Free-form connector configuration. Validated by each connector's
+ * `validateConfig` implementation and passed to `syncIncremental` for runtime
+ * use. MUST be JSON-serializable: no functions, no class instances, no
+ * circular references.
+ *
+ * Runtime configs may contain hydrated credentials. Do not persist a runtime
+ * config directly. Any code that needs to store connector settings must call
+ * `persistableConnectorConfig()` so credentials are stripped or replaced by
+ * connector-owned references.
+ */
+export type ConnectorConfig = Record<string, unknown>;
+/**
+ * Redact secret-looking keys from a JSON-serializable connector config.
+ * Built-in connectors provide explicit projections, but this default keeps
+ * third-party connectors from accidentally persisting obvious credentials.
+ */
+export declare function redactConnectorConfigSecrets(config: ConnectorConfig): ConnectorConfig;
+/**
+ * Opaque cursor describing "where the last sync left off". Each connector
+ * defines what `kind` and `value` mean (e.g. Drive: `{kind: "pageToken",
+ * value: "..."}`, Gmail: `{kind: "historyId", value: "..."}`). The orchestrator
+ * treats it as opaque and only round-trips it through the state store.
+ *
+ * `updatedAt` is an ISO 8601 timestamp set by the framework when the cursor is
+ * written. It is informational — connectors MUST NOT use it to decide
+ * monotonicity. They own the `value` semantics.
+ */
+export interface ConnectorCursor {
+    /** Connector-defined cursor kind (e.g. `"pageToken"`, `"historyId"`, `"sinceTs"`). */
+    readonly kind: string;
+    /** Connector-defined opaque cursor value. */
+    readonly value: string;
+    /** ISO 8601 timestamp of when this cursor was last written. */
+    readonly updatedAt: string;
+}
+/**
+ * Provenance for a connector-ingested document. Required so downstream recall
+ * can attribute facts back to their origin and avoid re-ingesting on the next
+ * incremental pass.
+ */
+export interface ConnectorDocumentSource {
+    /** Stable connector id (matches `LiveConnector.id`). */
+    readonly connector: string;
+    /** Source-system identifier (Drive file id, Notion page id, Gmail msg id, ...). */
+    readonly externalId: string;
+    /** Optional source-system revision/version (etag, page version, history id). */
+    readonly externalRevision?: string;
+    /** Optional canonical URL pointing back at the source document. */
+    readonly externalUrl?: string;
+    /** ISO 8601 timestamp of when the connector fetched this document. */
+    readonly fetchedAt: string;
+}
+/**
+ * A single document yielded by an incremental sync. Connectors are responsible
+ * for chunking large source documents themselves if needed; the orchestrator
+ * ingests `content` as a unit.
+ */
+export interface ConnectorDocument {
+    /** Connector-local stable id for this document. SHOULD match `source.externalId`. */
+    readonly id: string;
+    /** Optional human-readable title. */
+    readonly title?: string;
+    /** Body content. Plaintext or Markdown — connectors document their format. */
+    readonly content: string;
+    /** Provenance. Required. */
+    readonly source: ConnectorDocumentSource;
+}
+/**
+ * Arguments passed to `syncIncremental`. The framework owns cursor/config
+ * lifecycle; connectors only read these and return the next cursor.
+ */
+export interface SyncIncrementalArgs {
+    /** Last persisted cursor, or `null` on the first ever sync. */
+    readonly cursor: ConnectorCursor | null;
+    /** Validated connector config (already passed through `validateConfig`). */
+    readonly config: ConnectorConfig;
+    /** Optional abort signal. Connectors SHOULD honor it for cooperative cancellation. */
+    readonly abortSignal?: AbortSignal;
+}
+/**
+ * Result of a single incremental sync pass.
+ *
+ * `newDocs` MAY be empty (no new documents since the last cursor). `nextCursor`
+ * MUST always be returned — even on no-op syncs the framework persists it so
+ * `updatedAt` reflects the most recent attempt.
+ */
+export interface SyncIncrementalResult {
+    readonly newDocs: ConnectorDocument[];
+    readonly nextCursor: ConnectorCursor;
+}
+/**
+ * The contract every live connector implements.
+ *
+ * Connectors MUST be:
+ *   - **Idempotent**: re-running with the same cursor MUST NOT duplicate
+ *     documents. The `source.externalId` + `source.externalRevision` pair is
+ *     used downstream for dedup.
+ *   - **Read-only on the source**: live connectors never mutate the upstream
+ *     system (no marking emails read, no editing Notion pages).
+ *   - **Cancellable**: long-running syncs SHOULD periodically check
+ *     `abortSignal.aborted` and bail cleanly.
+ *   - **Privacy-aware**: connectors MUST NOT log document content. Logging
+ *     metadata (counts, ids, timings) is fine.
+ */
+export interface LiveConnector {
+    /**
+     * Stable connector id. MUST match `CONNECTOR_ID_PATTERN` — lowercase
+     * alphanumeric plus dash, 1–64 chars, must start AND end with alphanumeric
+     * (no leading or trailing dash). The registry enforces this.
+     */
+    readonly id: string;
+    /** Short human-readable name shown in CLI / status output. */
+    readonly displayName: string;
+    /** Optional longer description. */
+    readonly description?: string;
+    /**
+     * Validate raw user-supplied config. MUST throw on malformed input — never
+     * silently default. The returned object is the runtime config passed back to
+     * `syncIncremental`; it may contain hydrated credentials and MUST NOT be
+     * persisted directly. Connectors SHOULD strip unknown fields.
+     */
+    validateConfig(raw: unknown): ConnectorConfig;
+    /**
+     * Return the subset of validated config that may be written to disk. Use this
+     * for state/config persistence instead of `validateConfig()`. Connectors that
+     * need credentials should omit the raw values here and store only non-secret
+     * scope/schedule fields plus any connector-owned secret references.
+     */
+    persistConfig?(validated: ConnectorConfig): ConnectorConfig;
+    /**
+     * Run one incremental sync pass. See `SyncIncrementalArgs` /
+     * `SyncIncrementalResult` for the contract.
+     */
+    syncIncremental(args: SyncIncrementalArgs): Promise<SyncIncrementalResult>;
+}
+export declare function persistableConnectorConfig(connector: Pick<LiveConnector, "persistConfig">, validated: ConnectorConfig): ConnectorConfig;
+/**
+ * Regex enforcing the connector-id naming rule. Exported so connectors and
+ * tests can validate ids consistently with the registry.
+ *
+ * Rule: lowercase alphanumeric + dash, 1..64 chars, must start AND end with
+ * alphanumeric (no leading or trailing dash). Single-char ids are allowed.
+ */
+export declare const CONNECTOR_ID_PATTERN: RegExp;
+/**
+ * Returns `true` if `id` is a syntactically valid connector id.
+ */
+export declare function isValidConnectorId(id: unknown): id is string;
+//# sourceMappingURL=framework.d.ts.map

package/dist/connectors/live/framework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework.d.ts","sourceRoot":"","sources":["../../../src/connectors/live/framework.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAetD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAErF;AAwBD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mFAAmF;IACnF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACpC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,eAAe,CAAC;IAE9C;;;;;OAKG;IACH,aAAa,CAAC,CAAC,SAAS,EAAE,eAAe,GAAG,eAAe,CAAC;IAE5D;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5E;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,EAC/C,SAAS,EAAE,eAAe,GACzB,eAAe,CAKjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAA2C,CAAC;AAE7E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,EAAE,IAAI,MAAM,CAE5D"}

package/dist/connectors/live/github.d.ts

@@ -0,0 +1,156 @@
+/**
+ * @remnic/core — GitHub live connector (issue #683 PR 5/6)
+ *
+ * Concrete `LiveConnector` implementation that incrementally imports notes
+ * from a user's GitHub activity into Remnic. Fetches via the GitHub REST
+ * API using raw `fetch` with a personal access token — no octokit dep,
+ * per à-la-carte packaging rules (CLAUDE.md gotcha #57).
+ *
+ * What is imported:
+ *   - Issue comments authored by `userLogin` on watched repos.
+ *   - PR review comments authored by `userLogin` on watched repos.
+ *   - Discussion comments authored by `userLogin` (optional, off by default).
+ *
+ * Design notes:
+ *
+ *   - **Auth.** GitHub personal access token via `connectors.github.token`.
+ *     The token is accepted at config-parse time but never logged. Operators
+ *     must populate it from a secret store; no real value may appear in
+ *     tests, fixtures, or comments.
+ *
+ *   - **Cursor semantics.** The cursor encodes a per-repo, per-resource-type
+ *     watermark (latest `updated_at` ISO 8601 string seen). On the very first
+ *     sync (cursor=null) we seed the watermark from the current latest
+ *     comment timestamp WITHOUT importing any content — mirrors Drive's
+ *     `getStartPageToken` bootstrap pattern. Subsequent passes only import
+ *     items created/updated after the stored watermark.
+ *
+ *   - **Watermark field.** All three GitHub resource types expose
+ *     `updated_at` at the comment level. We always use `updated_at` (not
+ *     `created_at`) so edits re-trigger ingestion.
+ *
+ *   - **Raw `fetch`.** We call `https://api.github.com/…` directly.
+ *     `Authorization: Bearer <token>` + `User-Agent: remnic-connector` headers
+ *     on every request. The `fetchFn` parameter is the test injection point —
+ *     production callers omit it and the connector uses the global `fetch`.
+ *
+ *   - **Idempotency.** `ConnectorDocument.source.externalId` is
+ *     `{repo}/{kind}/{commentId}` and `externalRevision` is `updated_at`, so
+ *     downstream dedup (CLAUDE.md gotcha #44) can recognise repeat fetches.
+ *
+ *   - **Filtering by userLogin.** GitHub's `/issues/comments` endpoint does
+ *     not support server-side author filtering in the public API. We filter
+ *     client-side by comparing `comment.user.login` to the configured
+ *     `userLogin`. This keeps the implementation free from authenticated
+ *     user lookups and avoids an extra round-trip on first run.
+ *
+ *   - **Privacy.** No comment body is ever logged. Repo names and counts
+ *     may be logged. The token is never exposed in logs, state, or errors.
+ *
+ *   - **Read-only.** This connector only reads. It never posts, edits,
+ *     reacts to, or otherwise mutates any GitHub resource.
+ *
+ *   - **Error classification.** 429/5xx → transient (re-throw, cursor
+ *     does NOT advance). 404/403/410 → terminal (skip repo/resource,
+ *     continue). Network errors → transient.
+ */
+import type { LiveConnector, SyncIncrementalResult } from "./framework.js";
+/** Stable connector id. */
+export declare const GITHUB_CONNECTOR_ID = "github";
+/** Cursor `kind` emitted by this connector. */
+export declare const GITHUB_CURSOR_KIND = "githubWatermark";
+/** Default poll interval: 5 minutes. */
+export declare const GITHUB_DEFAULT_POLL_INTERVAL_MS: number;
+/**
+ * Validated, frozen view of `connectors.github.*`.
+ */
+export interface GitHubConnectorConfig {
+    /** Personal access token. Populate from a secret store; never commit. */
+    readonly token: string;
+    /** Only import comments authored by this GitHub login. Required. */
+    readonly userLogin: string;
+    /** Repos to poll, in `owner/repo` format. */
+    readonly repos: readonly string[];
+    /** Poll interval in ms. */
+    readonly pollIntervalMs: number;
+    /** Whether to import Discussion comments. Default false. */
+    readonly includeDiscussions: boolean;
+}
+export interface GitHubComment {
+    readonly id: number;
+    readonly body?: string | null;
+    readonly user?: {
+        readonly login?: string | null;
+    } | null;
+    readonly created_at: string;
+    readonly updated_at: string;
+    readonly html_url?: string | null;
+    /** Present on PR review comments. */
+    readonly pull_request_url?: string | null;
+    /** Present on issue comments. */
+    readonly issue_url?: string | null;
+}
+export interface GitHubDiscussionComment {
+    readonly id: number;
+    readonly body?: string | null;
+    readonly author?: {
+        readonly login?: string | null;
+    } | null;
+    readonly createdAt?: string | null;
+    readonly updatedAt?: string | null;
+    readonly url?: string | null;
+}
+/**
+ * Minimal fetch-compatible surface used by the connector. Tests inject a
+ * stub; production delegates to global `fetch`.
+ */
+export type GitHubFetchFn = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    headers: {
+        get(name: string): string | null;
+    };
+    json(): Promise<unknown>;
+}>;
+/**
+ * Validate and normalise raw config. Throws with a concrete message on any
+ * malformed input — never silently defaults (CLAUDE.md gotcha #51).
+ */
+export declare function validateGitHubConfig(raw: unknown): GitHubConnectorConfig;
+/**
+ * Classify a fetch error as transient (re-throw — cursor does NOT advance,
+ * next poll retries) vs. terminal (skip this repo/resource and continue).
+ *
+ * Transient:
+ *   - 429 (rate-limit — retry after backoff)
+ *   - 5xx (GitHub backend error)
+ *   - AbortError / network-layer errors
+ *
+ * Terminal (skip-and-continue):
+ *   - 404 (repo deleted, comment gone, or no access)
+ *   - 403 (permission denied)
+ *   - 410 (gone)
+ *   - any other 4xx that isn't 429
+ */
+export declare function isTransientGitHubError(err: unknown): boolean;
+/**
+ * Result of a single sync pass. Superset of `SyncIncrementalResult` for
+ * richer test assertions.
+ */
+export interface GitHubSyncResult extends SyncIncrementalResult {
+    readonly skippedOtherAuthor: number;
+    readonly skippedEmpty: number;
+    readonly skippedTooLarge: number;
+}
+/**
+ * Construct the GitHub connector. `fetchFn` is the test hook — production
+ * callers omit it and the connector delegates to global `fetch`.
+ */
+export declare function createGitHubConnector(options?: {
+    fetchFn?: GitHubFetchFn;
+}): LiveConnector;
+//# sourceMappingURL=github.d.ts.map

package/dist/connectors/live/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../../src/connectors/live/github.ts"],"names":[],"mappings":"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"}