gik-service-providers 0.1.0 → 0.2.0

package/README.md

@@ -7,6 +7,7 @@ npm install gik-service-providers
 ```ts
 import { createSchedulerServiceKind } from "gik-service-providers/scheduler";
 import { createGmailServiceKind } from "gik-service-providers/gmail";
+import { createGitHubContextStoreServiceKind } from "gik-service-providers/github-context-store";
 ```
 
 There is deliberately **no package-root export or index barrel**. Applications
@@ -126,9 +127,47 @@ HTTP 408/5xx, or an unreadable success response produces
 Investigate Sent mail and require fresh host authority before a new attempt;
 Gmail does not provide a general idempotent-send guarantee.
 
+## GitHub context store
+
+Kind `github-context-store`, version `1`, implements the standard
+`context-store.query/v1` and `context-store.ingest/v1` contracts:
+
+```json
+{
+  "endpoint": "https://api.github.com",
+  "repository": "owner/private-backing-store",
+  "ref": "refs/heads/context-v1",
+  "prefix": ".gik-state/context/v1",
+  "credentialRef": "github/context-store",
+  "maxRecordsPerScope": 1000,
+  "maxWriteAttempts": 3
+}
+```
+
+The configured ref must already exist. The provider never creates repositories,
+refs, credentials or authorization. The host resolves `credentialRef` to a
+`GitHubContextStoreConnection` that adds authentication internally, and must
+authorize every concrete `https://api.github.com` URL before the provider asks
+for that connection. Query-only declarations require GitHub Contents read
+permission; a declaration containing ingest requires Contents write permission.
+
+Scopes and record identities are SHA-256 encoded into repository paths.
+Ingestion creates immutable record blobs and a bounded recent-record index in
+one Git commit, then advances the declared ref without force. Reusing an
+identity with different content fails. A non-fast-forward ref race is rebuilt
+from the new head up to `maxWriteAttempts`; exhaustion is explicit. Query reads
+one ref revision and returns at most the requested standard limit. The Git
+revision used or created is returned in `ServiceExecutionResult.detail`, while
+the standard context-store output shape remains unchanged.
+
+This provider stores only bounded, non-sensitive context. It is not a token
+vault, GitHub event archive, durable-runtime journal, or substitute for host
+authorization. Actions artifacts and Copilot Memory have different retention
+and consistency semantics and are not silently used as fallbacks.
+
 ## Distribution and release
 
-Both subpaths are independently built and smoke-tested from the actual npm
+All subpaths are independently built and smoke-tested from the actual npm
 tarball in a clean consumer, including TypeScript and the absent root export.
 GitHub Actions performs all installation, build, typecheck and tests for this
 repository. Publishing remains a protected maintainer-approved action; see the

package/dist/github-context-store.d.ts

@@ -0,0 +1,26 @@
+import { ServiceKindFactory } from 'gik-controlface/services';
+
+interface GitHubContextStoreHttpRequest {
+    url: string;
+    method: "GET" | "POST" | "PATCH";
+    headers: Readonly<Record<string, string>>;
+    body?: string;
+    signal: AbortSignal;
+}
+/** The host owns authentication and adds it inside this connection. */
+interface GitHubContextStoreConnection {
+    request(request: Readonly<GitHubContextStoreHttpRequest>): Promise<Response>;
+}
+declare class GitHubContextRecordConflictError extends Error {
+    readonly code = "github-context-record-conflict";
+    constructor(recordId: string);
+}
+declare class GitHubContextStoreRevisionConflictError extends Error {
+    readonly ref: string;
+    readonly attempts: number;
+    readonly code = "github-context-store-revision-conflict";
+    constructor(ref: string, attempts: number);
+}
+declare function createGitHubContextStoreServiceKind(): ServiceKindFactory;
+
+export { GitHubContextRecordConflictError, type GitHubContextStoreConnection, type GitHubContextStoreHttpRequest, GitHubContextStoreRevisionConflictError, createGitHubContextStoreServiceKind };

package/dist/github-context-store.js

@@ -0,0 +1,647 @@
+// src/github-context-store.ts
+import { createHash } from "crypto";
+import { Buffer } from "buffer";
+import {
+  CONTEXT_STORE_INGEST_CONTRACT,
+  CONTEXT_STORE_MAX_QUERY_LIMIT,
+  CONTEXT_STORE_QUERY_CONTRACT,
+  contextStoreIngestInputSchema,
+  contextStoreIngestOutputSchema,
+  contextStoreQueryInputSchema,
+  contextStoreQueryOutputSchema,
+  requireServiceDependency,
+  serviceConfig,
+  UnsatisfiedServiceDependencyError
+} from "gik-controlface/services";
+
+// src/values.ts
+function object(value, label) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object`);
+  return value;
+}
+function text(value, label) {
+  if (typeof value !== "string" || !value.trim()) throw new Error(`${label} must be a nonempty string`);
+  return value;
+}
+function integer(value, label, minimum, maximum) {
+  if (typeof value !== "number" || !Number.isInteger(value) || value < minimum || value > maximum) {
+    throw new Error(`${label} must be an integer between ${minimum} and ${maximum}`);
+  }
+  return value;
+}
+function keys(value, allowed) {
+  const unexpected = Object.keys(value).filter((key) => !allowed.includes(key));
+  if (unexpected.length) throw new Error(`Unsupported input fields: ${unexpected.join(", ")}`);
+}
+function isJson(value) {
+  return value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value) || Array.isArray(value) && value.every(isJson) || !!value && typeof value === "object" && Object.values(value).every(isJson);
+}
+
+// src/github-context-store.ts
+var provider = { id: "github-context-store", version: "1" };
+var recordMode = "100644";
+var recordType = "blob";
+var defaultMaxRecordsPerScope = 1e3;
+var defaultMaxWriteAttempts = 3;
+var GitHubContextRecordConflictError = class extends Error {
+  code = "github-context-record-conflict";
+  constructor(recordId) {
+    super(`GitHub context record '${recordId}' already exists with different content`);
+    this.name = "GitHubContextRecordConflictError";
+  }
+};
+var GitHubContextStoreRevisionConflictError = class extends Error {
+  constructor(ref, attempts) {
+    super(`GitHub context ref '${ref}' changed during ${attempts} write attempts`);
+    this.ref = ref;
+    this.attempts = attempts;
+    this.name = "GitHubContextStoreRevisionConflictError";
+  }
+  ref;
+  attempts;
+  code = "github-context-store-revision-conflict";
+};
+function isConnection(value) {
+  return !!value && typeof value === "object" && "request" in value && typeof value.request === "function";
+}
+function canonical(value) {
+  if (Array.isArray(value)) return value.map(canonical);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, entry]) => [key, canonical(entry)])
+    );
+  }
+  return value;
+}
+function serialize(value) {
+  if (!isJson(value)) throw new Error("GitHub context value must be JSON data");
+  return `${JSON.stringify(canonical(value))}
+`;
+}
+function jsonValue(value, label) {
+  if (!isJson(value)) throw new Error(`${label} must be JSON data`);
+  return value;
+}
+function digest(value) {
+  return createHash("sha256").update(value).digest("hex");
+}
+function repositoryParts(repository) {
+  const parts = repository.split("/");
+  if (parts.length !== 2 || parts.some((part) => !/^[A-Za-z0-9_.-]+$/.test(part))) {
+    throw new Error("GitHub context repository must be an owner/name pair");
+  }
+  return [parts[0], parts[1]];
+}
+function normalizedRef(value) {
+  if (!value.startsWith("refs/heads/")) {
+    throw new Error("GitHub context ref must start with 'refs/heads/'");
+  }
+  const branch = value.slice("refs/heads/".length);
+  if (!branch || branch.startsWith("/") || branch.endsWith("/") || branch.includes("//") || branch.split("/").some((part) => !part || part === "." || part === ".." || !/^[A-Za-z0-9._-]+$/.test(part))) {
+    throw new Error("GitHub context ref contains an unsafe branch name");
+  }
+  return `heads/${branch}`;
+}
+function normalizedPrefix(value) {
+  if (value.startsWith("/") || value.endsWith("/") || value.includes("\\") || value.split("/").some((part) => !part || part === "." || part === "..")) {
+    throw new Error("GitHub context prefix must be a safe repository-relative path");
+  }
+  return value;
+}
+function config(declaration) {
+  const value = serviceConfig(declaration);
+  const endpoint2 = text(value.endpoint, "endpoint");
+  const ref = text(value.ref, "ref");
+  if (endpoint2 !== "https://api.github.com") {
+    throw new Error("GitHub context endpoint must be https://api.github.com");
+  }
+  normalizedRef(ref);
+  return {
+    endpoint: endpoint2,
+    repository: text(value.repository, "repository"),
+    ref,
+    prefix: normalizedPrefix(text(value.prefix, "prefix")),
+    credentialRef: text(value.credentialRef, "credentialRef"),
+    maxRecordsPerScope: integer(
+      value.maxRecordsPerScope ?? defaultMaxRecordsPerScope,
+      "maxRecordsPerScope",
+      1,
+      5e3
+    ),
+    maxWriteAttempts: integer(
+      value.maxWriteAttempts ?? defaultMaxWriteAttempts,
+      "maxWriteAttempts",
+      1,
+      5
+    )
+  };
+}
+function credentialRequirement(declaration) {
+  const configured = config(declaration);
+  const writes = Object.values(declaration.operations).some(({ operation }) => operation === "ingest");
+  return {
+    id: "github-context-repository",
+    kind: "credential",
+    title: "GitHub context repository",
+    description: "Host-managed GitHub App connection for the declared context repository and ref",
+    ref: configured.credentialRef,
+    scheme: "github-app",
+    permissions: [writes ? "contents:write" : "contents:read"]
+  };
+}
+function validatedRecord(value) {
+  if (!isJson(value)) throw new Error("GitHub context record must be JSON data");
+  const record = object(value, "GitHub context record");
+  const id = text(record.id, "record id");
+  const kind = text(record.kind, "record kind");
+  const observedAt = text(record.observedAt, "record observedAt");
+  if (Number.isNaN(Date.parse(observedAt))) {
+    throw new Error("GitHub context record observedAt must be an ISO timestamp");
+  }
+  if (record.references !== void 0 && !Array.isArray(record.references)) {
+    throw new Error("GitHub context record references must be an array");
+  }
+  const result = { id, kind, observedAt };
+  for (const [key, entry] of Object.entries(record)) {
+    if (!isJson(entry)) throw new Error(`GitHub context record field '${key}' is not JSON data`);
+    result[key] = entry;
+  }
+  return result;
+}
+function jsonObject(value, label) {
+  const source = object(value, label);
+  const result = {};
+  for (const [key, entry] of Object.entries(source)) {
+    if (!isJson(entry)) throw new Error(`${label} field '${key}' is not JSON data`);
+    result[key] = entry;
+  }
+  return result;
+}
+function queryInput(value) {
+  const input = object(value, "GitHub context query");
+  keys(input, ["scope", "requestKey", "query", "limit"]);
+  return {
+    scope: text(input.scope, "scope"),
+    requestKey: text(input.requestKey, "requestKey"),
+    query: jsonObject(input.query, "query"),
+    limit: integer(input.limit, "limit", 1, CONTEXT_STORE_MAX_QUERY_LIMIT)
+  };
+}
+function ingestInput(value) {
+  const input = object(value, "GitHub context ingestion");
+  keys(input, ["scope", "records"]);
+  if (!Array.isArray(input.records)) throw new Error("GitHub context records must be an array");
+  const records = input.records.map(validatedRecord);
+  const identities = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    const encoded = serialize(record);
+    const previous = identities.get(record.id);
+    if (previous !== void 0 && previous !== encoded) {
+      throw new GitHubContextRecordConflictError(record.id);
+    }
+    identities.set(record.id, encoded);
+  }
+  return { scope: text(input.scope, "scope"), records };
+}
+function apiPath(parts) {
+  return parts.map((part) => encodeURIComponent(part)).join("/");
+}
+function endpoint(configured, suffix) {
+  const [owner, repository] = repositoryParts(configured.repository);
+  return new URL(`/repos/${apiPath([owner, repository])}/${suffix}`, configured.endpoint);
+}
+function scopePaths(configured, scope) {
+  const root = `${configured.prefix}/scopes/${digest(scope)}`;
+  return {
+    metadata: `${root}/metadata.json`,
+    index: `${root}/recent.json`,
+    record: (id) => `${root}/records/${digest(id)}.json`
+  };
+}
+function jsonResponse(value, label) {
+  if (!isJson(value)) throw new Error(`${label} is not JSON data`);
+  return object(value, label);
+}
+function apiObject(value, label) {
+  const response = jsonResponse(value, label);
+  return { sha: text(response.sha, `${label} SHA`) };
+}
+function refResponse(value) {
+  const response = jsonResponse(value, "GitHub ref response");
+  const target = object(response.object, "GitHub ref object");
+  return { object: { sha: text(target.sha, "GitHub ref object SHA") } };
+}
+function commitResponse(value) {
+  const response = jsonResponse(value, "GitHub commit response");
+  const tree = object(response.tree, "GitHub commit tree");
+  return {
+    sha: text(response.sha, "GitHub commit SHA"),
+    tree: { sha: text(tree.sha, "GitHub commit tree SHA") }
+  };
+}
+function contentResponse(value) {
+  const response = jsonResponse(value, "GitHub content response");
+  if (response.type !== "file" || response.encoding !== "base64") {
+    throw new Error("GitHub content response is not a base64 file");
+  }
+  return {
+    type: "file",
+    encoding: "base64",
+    content: text(response.content, "GitHub content")
+  };
+}
+function scopeIndex(value, scope) {
+  const source = jsonResponse(value, "GitHub context scope index");
+  if (source.format !== "gik-github-context-recent/1" || source.scope !== scope || !Array.isArray(source.records)) {
+    throw new Error("GitHub context scope index is corrupt or belongs to another scope");
+  }
+  return {
+    format: "gik-github-context-recent/1",
+    scope,
+    records: source.records.map((entry) => {
+      const record = object(entry, "GitHub context scope index record");
+      return {
+        id: text(record.id, "indexed record id"),
+        observedAt: text(record.observedAt, "indexed record observedAt")
+      };
+    })
+  };
+}
+function createGitHubContextStoreServiceKind() {
+  return {
+    manifest: {
+      id: provider.id,
+      version: provider.version,
+      title: "GitHub-backed context store",
+      description: "Immutable bounded context records stored on a declared private GitHub ref",
+      configSchema: {
+        type: "object",
+        additionalProperties: false,
+        required: ["endpoint", "repository", "ref", "prefix", "credentialRef"],
+        properties: {
+          endpoint: { const: "https://api.github.com" },
+          repository: { type: "string", pattern: "^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$" },
+          ref: {
+            type: "string",
+            pattern: "^refs/heads/(?!\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/(?!\\.{1,2}(?:/|$))[A-Za-z0-9._-]+)*$"
+          },
+          prefix: { type: "string", minLength: 1 },
+          credentialRef: { type: "string", minLength: 1 },
+          maxRecordsPerScope: { type: "integer", minimum: 1, maximum: 5e3 },
+          maxWriteAttempts: { type: "integer", minimum: 1, maximum: 5 }
+        }
+      },
+      subjects: ["cell", "substrate-agent", "chat", "task"],
+      executionModes: ["immediate", "queued"],
+      supports: { discover: true, probe: true }
+    },
+    describeDependencies: (declaration) => [credentialRequirement(declaration)],
+    validate(declaration, context) {
+      try {
+        if (declaration.version !== "1") {
+          throw new Error("github-context-store supports version 1 only");
+        }
+        config(declaration);
+        if (!context.resolveCredential || !context.authorizeEndpoint) {
+          throw new Error(
+            "github-context-store requires host credential resolution and endpoint authorization"
+          );
+        }
+        if (!Object.keys(declaration.operations).length) {
+          throw new Error("github-context-store requires a declared operation");
+        }
+        for (const operation of Object.values(declaration.operations)) {
+          const contract = operation.operation === "query" ? CONTEXT_STORE_QUERY_CONTRACT : operation.operation === "ingest" ? CONTEXT_STORE_INGEST_CONTRACT : void 0;
+          if (!contract || operation.contract !== contract || operation.sense) {
+            throw new Error("Unsupported github-context-store operation or contract");
+          }
+        }
+        return { ok: true };
+      } catch (error) {
+        return { ok: false, errors: [error instanceof Error ? error.message : String(error)] };
+      }
+    },
+    create(declaration, context) {
+      const configured = config(declaration);
+      const ref = normalizedRef(configured.ref);
+      const requirement = credentialRequirement(declaration);
+      const operations = [...new Set(
+        Object.values(declaration.operations).map(({ operation }) => operation)
+      )];
+      async function call(path, method, body, signal, allowedStatuses = []) {
+        requireServiceDependency(context, requirement, context.identity?.serviceId ?? provider.id);
+        const url = endpoint(configured, path);
+        if (!context.authorizeEndpoint || !await context.authorizeEndpoint(provider.id, url)) {
+          throw new Error("Host denied the declared GitHub context-store endpoint");
+        }
+        const connection = await context.resolveCredential?.(configured.credentialRef);
+        if (!isConnection(connection)) {
+          throw new UnsatisfiedServiceDependencyError(
+            "Host must supply a GitHub context-store connection",
+            requirement,
+            {
+              dependencyStatus: {
+                state: "missing",
+                message: "Configure the host-managed GitHub App connection"
+              }
+            }
+          );
+        }
+        const abort = AbortSignal.any([
+          ...signal ? [signal] : [],
+          AbortSignal.timeout(3e4)
+        ]);
+        abort.throwIfAborted();
+        requireServiceDependency(context, requirement, context.identity?.serviceId ?? provider.id);
+        const response = await connection.request({
+          url: url.href,
+          method,
+          headers: {
+            accept: "application/vnd.github+json",
+            "content-type": "application/json",
+            "x-github-api-version": "2026-03-10"
+          },
+          ...body === void 0 ? {} : { body: JSON.stringify(body) },
+          signal: abort
+        });
+        if (response.status === 401) {
+          await context.clearCredential?.(configured.credentialRef);
+          throw new UnsatisfiedServiceDependencyError(
+            "GitHub context-store authorization expired",
+            requirement,
+            {
+              dependencyStatus: {
+                state: "authorization-required",
+                message: "Reconnect the GitHub App installation"
+              }
+            }
+          );
+        }
+        if (!response.ok && !allowedStatuses.includes(response.status)) {
+          throw new Error(
+            `GitHub context-store ${method} ${url.pathname} failed with HTTP ${response.status}`
+          );
+        }
+        if (response.status === 204 || allowedStatuses.includes(response.status)) {
+          return { response };
+        }
+        let value;
+        try {
+          value = await response.json();
+        } catch (error) {
+          throw new Error("GitHub context-store response is not valid JSON", { cause: error });
+        }
+        return { response, value };
+      }
+      async function head(signal) {
+        const reference = refResponse(
+          (await call(`git/ref/${apiPath(ref.split("/"))}`, "GET", void 0, signal)).value
+        );
+        const commit2 = commitResponse(
+          (await call(
+            `git/commits/${encodeURIComponent(reference.object.sha)}`,
+            "GET",
+            void 0,
+            signal
+          )).value
+        );
+        return commit2;
+      }
+      async function readPath(path, revision, signal) {
+        const url = `contents/${apiPath(path.split("/"))}?ref=${encodeURIComponent(revision)}`;
+        const result = await call(url, "GET", void 0, signal, [404]);
+        if (result.response.status === 404) return void 0;
+        const content = contentResponse(result.value);
+        try {
+          const value = JSON.parse(
+            Buffer.from(content.content.replace(/\s+/g, ""), "base64").toString("utf8")
+          );
+          if (!isJson(value)) throw new Error("Decoded value is not JSON data");
+          return value;
+        } catch (error) {
+          throw new Error(`GitHub context path '${path}' contains invalid JSON`, { cause: error });
+        }
+      }
+      async function createBlob(content, signal) {
+        const response = apiObject(
+          (await call("git/blobs", "POST", { content, encoding: "utf-8" }, signal)).value,
+          "GitHub blob response"
+        );
+        return response.sha;
+      }
+      async function commit(base, changes, message, signal) {
+        const treeEntries = await Promise.all(changes.map(async ({ path, content }) => ({
+          path,
+          mode: recordMode,
+          type: recordType,
+          sha: await createBlob(content, signal)
+        })));
+        const tree = apiObject(
+          (await call("git/trees", "POST", {
+            base_tree: base.tree.sha,
+            tree: treeEntries
+          }, signal)).value,
+          "GitHub tree response"
+        );
+        const created = apiObject(
+          (await call("git/commits", "POST", {
+            message,
+            tree: tree.sha,
+            parents: [base.sha]
+          }, signal)).value,
+          "GitHub commit response"
+        );
+        const revision = created.sha;
+        const update = await call(
+          `git/refs/${apiPath(ref.split("/"))}`,
+          "PATCH",
+          { sha: revision, force: false },
+          signal,
+          [409, 422]
+        );
+        return update.response.ok ? revision : void 0;
+      }
+      async function query(input, signal) {
+        const current = await head(signal);
+        const paths = scopePaths(configured, input.scope);
+        const storedIndex = await readPath(paths.index, current.sha, signal);
+        if (storedIndex === void 0) {
+          return {
+            output: { scope: input.scope, requestKey: input.requestKey, records: [] },
+            revision: current.sha
+          };
+        }
+        const index = scopeIndex(storedIndex, input.scope);
+        const records = await Promise.all(index.records.slice(0, input.limit).map(async (entry) => {
+          const id = text(entry?.id, "indexed record id");
+          const value = await readPath(paths.record(id), current.sha, signal);
+          if (value === void 0) {
+            throw new Error(`GitHub context scope index references missing record '${id}'`);
+          }
+          const record = validatedRecord(value);
+          if (record.id !== id) {
+            throw new Error(`GitHub context record path identity mismatch for '${id}'`);
+          }
+          return record;
+        }));
+        return {
+          output: {
+            scope: input.scope,
+            requestKey: input.requestKey,
+            records
+          },
+          revision: current.sha
+        };
+      }
+      async function ingest(input, signal) {
+        const paths = scopePaths(configured, input.scope);
+        for (let attempt = 1; attempt <= configured.maxWriteAttempts; attempt += 1) {
+          const current = await head(signal);
+          const metadataValue = await readPath(paths.metadata, current.sha, signal);
+          if (metadataValue !== void 0) {
+            const metadata = object(metadataValue, "GitHub context scope metadata");
+            if (metadata.format !== "gik-github-context-scope/1" || metadata.scope !== input.scope) {
+              throw new Error("GitHub context scope metadata is corrupt or hash-collided");
+            }
+          }
+          const storedIndex = await readPath(paths.index, current.sha, signal);
+          let index = {
+            format: "gik-github-context-recent/1",
+            scope: input.scope,
+            records: []
+          };
+          if (storedIndex !== void 0) {
+            index = scopeIndex(storedIndex, input.scope);
+          }
+          const changes = [];
+          const entries = new Map(index.records.map((entry) => [entry.id, entry]));
+          const unique = /* @__PURE__ */ new Map();
+          for (const record of input.records) unique.set(record.id, record);
+          for (const record of unique.values()) {
+            const path = paths.record(record.id);
+            const encoded = serialize(record);
+            const existing = await readPath(path, current.sha, signal);
+            if (existing !== void 0) {
+              const stored = validatedRecord(existing);
+              if (stored.id !== record.id || serialize(stored) !== encoded) {
+                throw new GitHubContextRecordConflictError(record.id);
+              }
+            } else {
+              changes.push({ path, content: encoded });
+            }
+            entries.set(record.id, { id: record.id, observedAt: record.observedAt });
+          }
+          const nextRecords = [...entries.values()].sort((left, right) => right.observedAt.localeCompare(left.observedAt) || left.id.localeCompare(right.id)).slice(0, configured.maxRecordsPerScope);
+          const nextIndex = { ...index, records: nextRecords };
+          if (metadataValue === void 0) {
+            changes.push({
+              path: paths.metadata,
+              content: serialize({
+                format: "gik-github-context-scope/1",
+                scope: input.scope
+              })
+            });
+          }
+          if (storedIndex === void 0 || serialize(storedIndex) !== serialize(nextIndex)) {
+            changes.push({
+              path: paths.index,
+              content: serialize(nextIndex)
+            });
+          }
+          if (!changes.length) {
+            return {
+              output: {
+                scope: input.scope,
+                recordIds: input.records.map(({ id }) => id),
+                status: "stored"
+              },
+              revision: current.sha
+            };
+          }
+          const revision = await commit(
+            current,
+            changes,
+            `context: ingest ${input.records.length} record(s) for ${digest(input.scope).slice(0, 12)}`,
+            signal
+          );
+          if (revision) {
+            return {
+              output: {
+                scope: input.scope,
+                recordIds: input.records.map(({ id }) => id),
+                status: "stored"
+              },
+              revision
+            };
+          }
+        }
+        throw new GitHubContextStoreRevisionConflictError(
+          configured.ref,
+          configured.maxWriteAttempts
+        );
+      }
+      return {
+        provider,
+        discover: async () => ({
+          provider,
+          revision: "1",
+          discoveredAt: (/* @__PURE__ */ new Date()).toISOString(),
+          capabilities: operations.map((operation) => ({
+            id: operation === "query" ? CONTEXT_STORE_QUERY_CONTRACT : CONTEXT_STORE_INGEST_CONTRACT,
+            operation,
+            name: operation === "query" ? "Query GitHub context" : "Ingest GitHub context",
+            version: "1",
+            inputSchema: operation === "query" ? contextStoreQueryInputSchema : contextStoreIngestInputSchema,
+            outputSchema: operation === "query" ? contextStoreQueryOutputSchema : contextStoreIngestOutputSchema,
+            assurance: "declared-and-locally-validated"
+          }))
+        }),
+        async probe(adapterContext) {
+          const current = await head(adapterContext.signal);
+          return {
+            ok: true,
+            detail: {
+              repository: configured.repository,
+              ref: configured.ref,
+              revision: current.sha
+            }
+          };
+        },
+        async execute(request, adapterContext) {
+          if (!operations.includes(request.operation)) {
+            throw new Error("GitHub context-store operation is not declared");
+          }
+          if (request.operation === "query") {
+            const result = await query(queryInput(request.input), adapterContext.signal);
+            return {
+              output: jsonValue(result.output, "GitHub context query output"),
+              detail: {
+                repository: configured.repository,
+                ref: configured.ref,
+                revision: result.revision
+              }
+            };
+          }
+          if (request.operation === "ingest") {
+            const result = await ingest(ingestInput(request.input), adapterContext.signal);
+            return {
+              output: jsonValue(result.output, "GitHub context ingestion output"),
+              detail: {
+                repository: configured.repository,
+                ref: configured.ref,
+                revision: result.revision
+              }
+            };
+          }
+          throw new Error("Unsupported GitHub context-store operation");
+        }
+      };
+    }
+  };
+}
+export {
+  GitHubContextRecordConflictError,
+  GitHubContextStoreRevisionConflictError,
+  createGitHubContextStoreServiceKind
+};
+//# sourceMappingURL=github-context-store.js.map

package/dist/github-context-store.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/github-context-store.ts","../src/values.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { Buffer } from \"node:buffer\";\n\nimport {\n  CONTEXT_STORE_INGEST_CONTRACT,\n  CONTEXT_STORE_MAX_QUERY_LIMIT,\n  CONTEXT_STORE_QUERY_CONTRACT,\n  contextStoreIngestInputSchema,\n  contextStoreIngestOutputSchema,\n  contextStoreQueryInputSchema,\n  contextStoreQueryOutputSchema,\n  requireServiceDependency,\n  serviceConfig,\n  UnsatisfiedServiceDependencyError,\n  type ContextRecord,\n  type ContextStoreIngestInput,\n  type ContextStoreIngestOutput,\n  type ContextStoreQueryInput,\n  type ContextStoreQueryOutput,\n  type ServiceDependencyRequirement,\n  type ServiceKindContext,\n  type ServiceKindFactory,\n  type ServiceRequest,\n} from \"gik-controlface/services\";\nimport type { Json, NativeServiceDeclaration } from \"gik-kernel\";\nimport { integer, isJson, keys, object, text } from \"./values\";\n\nconst provider = { id: \"github-context-store\", version: \"1\" };\nconst recordMode = \"100644\";\nconst recordType = \"blob\";\nconst defaultMaxRecordsPerScope = 1000;\nconst defaultMaxWriteAttempts = 3;\n\nexport interface GitHubContextStoreHttpRequest {\n  url: string;\n  method: \"GET\" | \"POST\" | \"PATCH\";\n  headers: Readonly<Record<string, string>>;\n  body?: string;\n  signal: AbortSignal;\n}\n\n/** The host owns authentication and adds it inside this connection. */\nexport interface GitHubContextStoreConnection {\n  request(request: Readonly<GitHubContextStoreHttpRequest>): Promise<Response>;\n}\n\nexport class GitHubContextRecordConflictError extends Error {\n  readonly code = \"github-context-record-conflict\";\n\n  constructor(recordId: string) {\n    super(`GitHub context record '${recordId}' already exists with different content`);\n    this.name = \"GitHubContextRecordConflictError\";\n  }\n}\n\nexport class GitHubContextStoreRevisionConflictError extends Error {\n  readonly code = \"github-context-store-revision-conflict\";\n\n  constructor(readonly ref: string, readonly attempts: number) {\n    super(`GitHub context ref '${ref}' changed during ${attempts} write attempts`);\n    this.name = \"GitHubContextStoreRevisionConflictError\";\n  }\n}\n\ninterface GitHubContextStoreConfig {\n  endpoint: string;\n  repository: string;\n  ref: string;\n  prefix: string;\n  credentialRef: string;\n  maxRecordsPerScope: number;\n  maxWriteAttempts: number;\n}\n\ninterface ScopeIndex {\n  format: \"gik-github-context-recent/1\";\n  scope: string;\n  records: Array<{ id: string; observedAt: string }>;\n}\n\ninterface GitHubApiObject {\n  sha: string;\n}\n\ninterface GitHubRefResponse {\n  object: GitHubApiObject;\n}\n\ninterface GitHubCommitResponse extends GitHubApiObject {\n  tree: GitHubApiObject;\n}\n\ninterface GitHubContentResponse {\n  type: \"file\";\n  encoding: \"base64\";\n  content: string;\n}\n\nfunction isConnection(value: unknown): value is GitHubContextStoreConnection {\n  return !!value && typeof value === \"object\"\n    && \"request\" in value && typeof value.request === \"function\";\n}\n\nfunction canonical(value: Json): Json {\n  if (Array.isArray(value)) return value.map(canonical);\n  if (value && typeof value === \"object\") {\n    return Object.fromEntries(\n      Object.entries(value)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, entry]) => [key, canonical(entry)]),\n    );\n  }\n  return value;\n}\n\nfunction serialize(value: unknown): string {\n  if (!isJson(value)) throw new Error(\"GitHub context value must be JSON data\");\n  return `${JSON.stringify(canonical(value))}\\n`;\n}\n\nfunction jsonValue(value: unknown, label: string): Json {\n  if (!isJson(value)) throw new Error(`${label} must be JSON data`);\n  return value;\n}\n\nfunction digest(value: string): string {\n  return createHash(\"sha256\").update(value).digest(\"hex\");\n}\n\nfunction repositoryParts(repository: string): [string, string] {\n  const parts = repository.split(\"/\");\n  if (parts.length !== 2 || parts.some((part) => !/^[A-Za-z0-9_.-]+$/.test(part))) {\n    throw new Error(\"GitHub context repository must be an owner/name pair\");\n  }\n  return [parts[0], parts[1]];\n}\n\nfunction normalizedRef(value: string): string {\n  if (!value.startsWith(\"refs/heads/\")) {\n    throw new Error(\"GitHub context ref must start with 'refs/heads/'\");\n  }\n  const branch = value.slice(\"refs/heads/\".length);\n  if (!branch || branch.startsWith(\"/\") || branch.endsWith(\"/\")\n    || branch.includes(\"//\") || branch.split(\"/\").some((part) =>\n      !part || part === \".\" || part === \"..\" || !/^[A-Za-z0-9._-]+$/.test(part))) {\n    throw new Error(\"GitHub context ref contains an unsafe branch name\");\n  }\n  return `heads/${branch}`;\n}\n\nfunction normalizedPrefix(value: string): string {\n  if (value.startsWith(\"/\") || value.endsWith(\"/\") || value.includes(\"\\\\\")\n    || value.split(\"/\").some((part) => !part || part === \".\" || part === \"..\")) {\n    throw new Error(\"GitHub context prefix must be a safe repository-relative path\");\n  }\n  return value;\n}\n\nfunction config(declaration: NativeServiceDeclaration): GitHubContextStoreConfig {\n  const value = serviceConfig(declaration);\n  const endpoint = text(value.endpoint, \"endpoint\");\n  const ref = text(value.ref, \"ref\");\n  if (endpoint !== \"https://api.github.com\") {\n    throw new Error(\"GitHub context endpoint must be https://api.github.com\");\n  }\n  normalizedRef(ref);\n  return {\n    endpoint,\n    repository: text(value.repository, \"repository\"),\n    ref,\n    prefix: normalizedPrefix(text(value.prefix, \"prefix\")),\n    credentialRef: text(value.credentialRef, \"credentialRef\"),\n    maxRecordsPerScope: integer(\n      value.maxRecordsPerScope ?? defaultMaxRecordsPerScope,\n      \"maxRecordsPerScope\",\n      1,\n      5000,\n    ),\n    maxWriteAttempts: integer(\n      value.maxWriteAttempts ?? defaultMaxWriteAttempts,\n      \"maxWriteAttempts\",\n      1,\n      5,\n    ),\n  };\n}\n\nfunction credentialRequirement(declaration: NativeServiceDeclaration): ServiceDependencyRequirement {\n  const configured = config(declaration);\n  const writes = Object.values(declaration.operations)\n    .some(({ operation }) => operation === \"ingest\");\n  return {\n    id: \"github-context-repository\",\n    kind: \"credential\",\n    title: \"GitHub context repository\",\n    description: \"Host-managed GitHub App connection for the declared context repository and ref\",\n    ref: configured.credentialRef,\n    scheme: \"github-app\",\n    permissions: [writes ? \"contents:write\" : \"contents:read\"],\n  };\n}\n\nfunction validatedRecord(value: unknown): ContextRecord {\n  if (!isJson(value)) throw new Error(\"GitHub context record must be JSON data\");\n  const record = object(value, \"GitHub context record\");\n  const id = text(record.id, \"record id\");\n  const kind = text(record.kind, \"record kind\");\n  const observedAt = text(record.observedAt, \"record observedAt\");\n  if (Number.isNaN(Date.parse(observedAt))) {\n    throw new Error(\"GitHub context record observedAt must be an ISO timestamp\");\n  }\n  if (record.references !== undefined && !Array.isArray(record.references)) {\n    throw new Error(\"GitHub context record references must be an array\");\n  }\n  const result: ContextRecord = { id, kind, observedAt };\n  for (const [key, entry] of Object.entries(record)) {\n    if (!isJson(entry)) throw new Error(`GitHub context record field '${key}' is not JSON data`);\n    result[key] = entry;\n  }\n  return result;\n}\n\nfunction jsonObject(value: unknown, label: string): Record<string, Json> {\n  const source = object(value, label);\n  const result: Record<string, Json> = {};\n  for (const [key, entry] of Object.entries(source)) {\n    if (!isJson(entry)) throw new Error(`${label} field '${key}' is not JSON data`);\n    result[key] = entry;\n  }\n  return result;\n}\n\nfunction queryInput(value: unknown): ContextStoreQueryInput {\n  const input = object(value, \"GitHub context query\");\n  keys(input, [\"scope\", \"requestKey\", \"query\", \"limit\"]);\n  return {\n    scope: text(input.scope, \"scope\"),\n    requestKey: text(input.requestKey, \"requestKey\"),\n    query: jsonObject(input.query, \"query\"),\n    limit: integer(input.limit, \"limit\", 1, CONTEXT_STORE_MAX_QUERY_LIMIT),\n  };\n}\n\nfunction ingestInput(value: unknown): ContextStoreIngestInput {\n  const input = object(value, \"GitHub context ingestion\");\n  keys(input, [\"scope\", \"records\"]);\n  if (!Array.isArray(input.records)) throw new Error(\"GitHub context records must be an array\");\n  const records = input.records.map(validatedRecord);\n  const identities = new Map<string, string>();\n  for (const record of records) {\n    const encoded = serialize(record);\n    const previous = identities.get(record.id);\n    if (previous !== undefined && previous !== encoded) {\n      throw new GitHubContextRecordConflictError(record.id);\n    }\n    identities.set(record.id, encoded);\n  }\n  return { scope: text(input.scope, \"scope\"), records };\n}\n\nfunction apiPath(parts: string[]): string {\n  return parts.map((part) => encodeURIComponent(part)).join(\"/\");\n}\n\nfunction endpoint(configured: GitHubContextStoreConfig, suffix: string): URL {\n  const [owner, repository] = repositoryParts(configured.repository);\n  return new URL(`/repos/${apiPath([owner, repository])}/${suffix}`, configured.endpoint);\n}\n\nfunction scopePaths(configured: GitHubContextStoreConfig, scope: string) {\n  const root = `${configured.prefix}/scopes/${digest(scope)}`;\n  return {\n    metadata: `${root}/metadata.json`,\n    index: `${root}/recent.json`,\n    record: (id: string) => `${root}/records/${digest(id)}.json`,\n  };\n}\n\nfunction jsonResponse(value: unknown, label: string): Record<string, unknown> {\n  if (!isJson(value)) throw new Error(`${label} is not JSON data`);\n  return object(value, label);\n}\n\nfunction apiObject(value: unknown, label: string): GitHubApiObject {\n  const response = jsonResponse(value, label);\n  return { sha: text(response.sha, `${label} SHA`) };\n}\n\nfunction refResponse(value: unknown): GitHubRefResponse {\n  const response = jsonResponse(value, \"GitHub ref response\");\n  const target = object(response.object, \"GitHub ref object\");\n  return { object: { sha: text(target.sha, \"GitHub ref object SHA\") } };\n}\n\nfunction commitResponse(value: unknown): GitHubCommitResponse {\n  const response = jsonResponse(value, \"GitHub commit response\");\n  const tree = object(response.tree, \"GitHub commit tree\");\n  return {\n    sha: text(response.sha, \"GitHub commit SHA\"),\n    tree: { sha: text(tree.sha, \"GitHub commit tree SHA\") },\n  };\n}\n\nfunction contentResponse(value: unknown): GitHubContentResponse {\n  const response = jsonResponse(value, \"GitHub content response\");\n  if (response.type !== \"file\" || response.encoding !== \"base64\") {\n    throw new Error(\"GitHub content response is not a base64 file\");\n  }\n  return {\n    type: \"file\",\n    encoding: \"base64\",\n    content: text(response.content, \"GitHub content\"),\n  };\n}\n\nfunction scopeIndex(value: unknown, scope: string): ScopeIndex {\n  const source = jsonResponse(value, \"GitHub context scope index\");\n  if (source.format !== \"gik-github-context-recent/1\"\n    || source.scope !== scope || !Array.isArray(source.records)) {\n    throw new Error(\"GitHub context scope index is corrupt or belongs to another scope\");\n  }\n  return {\n    format: \"gik-github-context-recent/1\",\n    scope,\n    records: source.records.map((entry) => {\n      const record = object(entry, \"GitHub context scope index record\");\n      return {\n        id: text(record.id, \"indexed record id\"),\n        observedAt: text(record.observedAt, \"indexed record observedAt\"),\n      };\n    }),\n  };\n}\n\nexport function createGitHubContextStoreServiceKind(): ServiceKindFactory {\n  return {\n    manifest: {\n      id: provider.id,\n      version: provider.version,\n      title: \"GitHub-backed context store\",\n      description: \"Immutable bounded context records stored on a declared private GitHub ref\",\n      configSchema: {\n        type: \"object\",\n        additionalProperties: false,\n        required: [\"endpoint\", \"repository\", \"ref\", \"prefix\", \"credentialRef\"],\n        properties: {\n          endpoint: { const: \"https://api.github.com\" },\n          repository: { type: \"string\", pattern: \"^[A-Za-z0-9_.-]+/[A-Za-z0-9_.-]+$\" },\n          ref: {\n            type: \"string\",\n            pattern:\n              \"^refs/heads/(?!\\\\.{1,2}(?:/|$))[A-Za-z0-9._-]+(?:/(?!\\\\.{1,2}(?:/|$))[A-Za-z0-9._-]+)*$\",\n          },\n          prefix: { type: \"string\", minLength: 1 },\n          credentialRef: { type: \"string\", minLength: 1 },\n          maxRecordsPerScope: { type: \"integer\", minimum: 1, maximum: 5000 },\n          maxWriteAttempts: { type: \"integer\", minimum: 1, maximum: 5 },\n        },\n      },\n      subjects: [\"cell\", \"substrate-agent\", \"chat\", \"task\"],\n      executionModes: [\"immediate\", \"queued\"],\n      supports: { discover: true, probe: true },\n    },\n    describeDependencies: (declaration) => [credentialRequirement(declaration)],\n    validate(declaration, context) {\n      try {\n        if (declaration.version !== \"1\") {\n          throw new Error(\"github-context-store supports version 1 only\");\n        }\n        config(declaration);\n        if (!context.resolveCredential || !context.authorizeEndpoint) {\n          throw new Error(\n            \"github-context-store requires host credential resolution and endpoint authorization\",\n          );\n        }\n        if (!Object.keys(declaration.operations).length) {\n          throw new Error(\"github-context-store requires a declared operation\");\n        }\n        for (const operation of Object.values(declaration.operations)) {\n          const contract = operation.operation === \"query\"\n            ? CONTEXT_STORE_QUERY_CONTRACT\n            : operation.operation === \"ingest\"\n              ? CONTEXT_STORE_INGEST_CONTRACT\n              : undefined;\n          if (!contract || operation.contract !== contract || operation.sense) {\n            throw new Error(\"Unsupported github-context-store operation or contract\");\n          }\n        }\n        return { ok: true };\n      } catch (error) {\n        return { ok: false, errors: [error instanceof Error ? error.message : String(error)] };\n      }\n    },\n    create(declaration, context) {\n      const configured = config(declaration);\n      const ref = normalizedRef(configured.ref);\n      const requirement = credentialRequirement(declaration);\n      const operations = [...new Set(\n        Object.values(declaration.operations).map(({ operation }) => operation),\n      )];\n\n      async function call(\n        path: string,\n        method: GitHubContextStoreHttpRequest[\"method\"],\n        body?: Json,\n        signal?: AbortSignal,\n        allowedStatuses: readonly number[] = [],\n      ): Promise<{ response: Response; value?: unknown }> {\n        requireServiceDependency(context, requirement, context.identity?.serviceId ?? provider.id);\n        const url = endpoint(configured, path);\n        if (!context.authorizeEndpoint\n          || !await context.authorizeEndpoint(provider.id, url)) {\n          throw new Error(\"Host denied the declared GitHub context-store endpoint\");\n        }\n        const connection = await context.resolveCredential?.(configured.credentialRef);\n        if (!isConnection(connection)) {\n          throw new UnsatisfiedServiceDependencyError(\n            \"Host must supply a GitHub context-store connection\",\n            requirement,\n            {\n              dependencyStatus: {\n                state: \"missing\",\n                message: \"Configure the host-managed GitHub App connection\",\n              },\n            },\n          );\n        }\n        const abort = AbortSignal.any([\n          ...(signal ? [signal] : []),\n          AbortSignal.timeout(30000),\n        ]);\n        abort.throwIfAborted();\n        requireServiceDependency(context, requirement, context.identity?.serviceId ?? provider.id);\n        const response = await connection.request({\n          url: url.href,\n          method,\n          headers: {\n            accept: \"application/vnd.github+json\",\n            \"content-type\": \"application/json\",\n            \"x-github-api-version\": \"2026-03-10\",\n          },\n          ...(body === undefined ? {} : { body: JSON.stringify(body) }),\n          signal: abort,\n        });\n        if (response.status === 401) {\n          await context.clearCredential?.(configured.credentialRef);\n          throw new UnsatisfiedServiceDependencyError(\n            \"GitHub context-store authorization expired\",\n            requirement,\n            {\n              dependencyStatus: {\n                state: \"authorization-required\",\n                message: \"Reconnect the GitHub App installation\",\n              },\n            },\n          );\n        }\n        if (!response.ok && !allowedStatuses.includes(response.status)) {\n          throw new Error(\n            `GitHub context-store ${method} ${url.pathname} failed with HTTP ${response.status}`,\n          );\n        }\n        if (response.status === 204 || allowedStatuses.includes(response.status)) {\n          return { response };\n        }\n        let value: unknown;\n        try {\n          value = await response.json();\n        } catch (error) {\n          throw new Error(\"GitHub context-store response is not valid JSON\", { cause: error });\n        }\n        return { response, value };\n      }\n\n      async function head(signal?: AbortSignal): Promise<GitHubCommitResponse> {\n        const reference = refResponse(\n          (await call(`git/ref/${apiPath(ref.split(\"/\"))}`, \"GET\", undefined, signal)).value,\n        );\n        const commit = commitResponse(\n          (await call(\n            `git/commits/${encodeURIComponent(reference.object.sha)}`,\n            \"GET\",\n            undefined,\n            signal,\n          )).value,\n        );\n        return commit;\n      }\n\n      async function readPath(\n        path: string,\n        revision: string,\n        signal?: AbortSignal,\n      ): Promise<Json | undefined> {\n        const url = `contents/${apiPath(path.split(\"/\"))}?ref=${encodeURIComponent(revision)}`;\n        const result = await call(url, \"GET\", undefined, signal, [404]);\n        if (result.response.status === 404) return undefined;\n        const content = contentResponse(result.value);\n        try {\n          const value: unknown = JSON.parse(\n            Buffer.from(content.content.replace(/\\s+/g, \"\"), \"base64\").toString(\"utf8\"),\n          );\n          if (!isJson(value)) throw new Error(\"Decoded value is not JSON data\");\n          return value;\n        } catch (error) {\n          throw new Error(`GitHub context path '${path}' contains invalid JSON`, { cause: error });\n        }\n      }\n\n      async function createBlob(content: string, signal?: AbortSignal): Promise<string> {\n        const response = apiObject(\n          (await call(\"git/blobs\", \"POST\", { content, encoding: \"utf-8\" }, signal)).value,\n          \"GitHub blob response\",\n        );\n        return response.sha;\n      }\n\n      async function commit(\n        base: GitHubCommitResponse,\n        changes: Array<{ path: string; content: string }>,\n        message: string,\n        signal?: AbortSignal,\n      ): Promise<string | undefined> {\n        const treeEntries = await Promise.all(changes.map(async ({ path, content }) => ({\n          path,\n          mode: recordMode,\n          type: recordType,\n          sha: await createBlob(content, signal),\n        })));\n        const tree = apiObject(\n          (await call(\"git/trees\", \"POST\", {\n            base_tree: base.tree.sha,\n            tree: treeEntries,\n          }, signal)).value,\n          \"GitHub tree response\",\n        );\n        const created = apiObject(\n          (await call(\"git/commits\", \"POST\", {\n            message,\n            tree: tree.sha,\n            parents: [base.sha],\n          }, signal)).value,\n          \"GitHub commit response\",\n        );\n        const revision = created.sha;\n        const update = await call(\n          `git/refs/${apiPath(ref.split(\"/\"))}`,\n          \"PATCH\",\n          { sha: revision, force: false },\n          signal,\n          [409, 422],\n        );\n        return update.response.ok ? revision : undefined;\n      }\n\n      async function query(\n        input: ContextStoreQueryInput,\n        signal?: AbortSignal,\n      ): Promise<{ output: ContextStoreQueryOutput; revision: string }> {\n        const current = await head(signal);\n        const paths = scopePaths(configured, input.scope);\n        const storedIndex = await readPath(paths.index, current.sha, signal);\n        if (storedIndex === undefined) {\n          return {\n            output: { scope: input.scope, requestKey: input.requestKey, records: [] },\n            revision: current.sha,\n          };\n        }\n        const index = scopeIndex(storedIndex, input.scope);\n        const records = await Promise.all(index.records.slice(0, input.limit).map(async (entry) => {\n          const id = text(entry?.id, \"indexed record id\");\n          const value = await readPath(paths.record(id), current.sha, signal);\n          if (value === undefined) {\n            throw new Error(`GitHub context scope index references missing record '${id}'`);\n          }\n          const record = validatedRecord(value);\n          if (record.id !== id) {\n            throw new Error(`GitHub context record path identity mismatch for '${id}'`);\n          }\n          return record;\n        }));\n        return {\n          output: {\n            scope: input.scope,\n            requestKey: input.requestKey,\n            records,\n          },\n          revision: current.sha,\n        };\n      }\n\n      async function ingest(\n        input: ContextStoreIngestInput,\n        signal?: AbortSignal,\n      ): Promise<{ output: ContextStoreIngestOutput; revision: string }> {\n        const paths = scopePaths(configured, input.scope);\n        for (let attempt = 1; attempt <= configured.maxWriteAttempts; attempt += 1) {\n          const current = await head(signal);\n          const metadataValue = await readPath(paths.metadata, current.sha, signal);\n          if (metadataValue !== undefined) {\n            const metadata = object(metadataValue, \"GitHub context scope metadata\");\n            if (metadata.format !== \"gik-github-context-scope/1\"\n              || metadata.scope !== input.scope) {\n              throw new Error(\"GitHub context scope metadata is corrupt or hash-collided\");\n            }\n          }\n          const storedIndex = await readPath(paths.index, current.sha, signal);\n          let index: ScopeIndex = {\n            format: \"gik-github-context-recent/1\",\n            scope: input.scope,\n            records: [],\n          };\n          if (storedIndex !== undefined) {\n            index = scopeIndex(storedIndex, input.scope);\n          }\n\n          const changes: Array<{ path: string; content: string }> = [];\n          const entries = new Map(index.records.map((entry) => [entry.id, entry]));\n          const unique = new Map<string, ContextRecord>();\n          for (const record of input.records) unique.set(record.id, record);\n          for (const record of unique.values()) {\n            const path = paths.record(record.id);\n            const encoded = serialize(record);\n            const existing = await readPath(path, current.sha, signal);\n            if (existing !== undefined) {\n              const stored = validatedRecord(existing);\n              if (stored.id !== record.id || serialize(stored) !== encoded) {\n                throw new GitHubContextRecordConflictError(record.id);\n              }\n            } else {\n              changes.push({ path, content: encoded });\n            }\n            entries.set(record.id, { id: record.id, observedAt: record.observedAt });\n          }\n\n          const nextRecords = [...entries.values()]\n            .sort((left, right) =>\n              right.observedAt.localeCompare(left.observedAt)\n              || left.id.localeCompare(right.id))\n            .slice(0, configured.maxRecordsPerScope);\n          const nextIndex: ScopeIndex = { ...index, records: nextRecords };\n          if (metadataValue === undefined) {\n            changes.push({\n              path: paths.metadata,\n              content: serialize({\n                format: \"gik-github-context-scope/1\",\n                scope: input.scope,\n              }),\n            });\n          }\n          if (storedIndex === undefined\n            || serialize(storedIndex) !== serialize(nextIndex)) {\n            changes.push({\n              path: paths.index,\n              content: serialize(nextIndex),\n            });\n          }\n\n          if (!changes.length) {\n            return {\n              output: {\n                scope: input.scope,\n                recordIds: input.records.map(({ id }) => id),\n                status: \"stored\",\n              },\n              revision: current.sha,\n            };\n          }\n          const revision = await commit(\n            current,\n            changes,\n            `context: ingest ${input.records.length} record(s) for ${digest(input.scope).slice(0, 12)}`,\n            signal,\n          );\n          if (revision) {\n            return {\n              output: {\n                scope: input.scope,\n                recordIds: input.records.map(({ id }) => id),\n                status: \"stored\",\n              },\n              revision,\n            };\n          }\n        }\n        throw new GitHubContextStoreRevisionConflictError(\n          configured.ref,\n          configured.maxWriteAttempts,\n        );\n      }\n\n      return {\n        provider,\n        discover: async () => ({\n          provider,\n          revision: \"1\",\n          discoveredAt: new Date().toISOString(),\n          capabilities: operations.map((operation) => ({\n            id: operation === \"query\"\n              ? CONTEXT_STORE_QUERY_CONTRACT\n              : CONTEXT_STORE_INGEST_CONTRACT,\n            operation,\n            name: operation === \"query\"\n              ? \"Query GitHub context\"\n              : \"Ingest GitHub context\",\n            version: \"1\",\n            inputSchema: operation === \"query\"\n              ? contextStoreQueryInputSchema\n              : contextStoreIngestInputSchema,\n            outputSchema: operation === \"query\"\n              ? contextStoreQueryOutputSchema\n              : contextStoreIngestOutputSchema,\n            assurance: \"declared-and-locally-validated\",\n          })),\n        }),\n        async probe(adapterContext) {\n          const current = await head(adapterContext.signal);\n          return {\n            ok: true,\n            detail: {\n              repository: configured.repository,\n              ref: configured.ref,\n              revision: current.sha,\n            },\n          };\n        },\n        async execute(request: ServiceRequest, adapterContext) {\n          if (!operations.includes(request.operation)) {\n            throw new Error(\"GitHub context-store operation is not declared\");\n          }\n          if (request.operation === \"query\") {\n            const result = await query(queryInput(request.input), adapterContext.signal);\n            return {\n              output: jsonValue(result.output, \"GitHub context query output\"),\n              detail: {\n                repository: configured.repository,\n                ref: configured.ref,\n                revision: result.revision,\n              },\n            };\n          }\n          if (request.operation === \"ingest\") {\n            const result = await ingest(ingestInput(request.input), adapterContext.signal);\n            return {\n              output: jsonValue(result.output, \"GitHub context ingestion output\"),\n              detail: {\n                repository: configured.repository,\n                ref: configured.ref,\n                revision: result.revision,\n              },\n            };\n          }\n          throw new Error(\"Unsupported GitHub context-store operation\");\n        },\n      };\n    },\n  };\n}\n","import type { Json } from \"gik-kernel\";\n\nexport function object(value: unknown, label: string): Record<string, unknown> {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) throw new Error(`${label} must be an object`);\n  return value as Record<string, unknown>;\n}\n\nexport function text(value: unknown, label: string): string {\n  if (typeof value !== \"string\" || !value.trim()) throw new Error(`${label} must be a nonempty string`);\n  return value;\n}\n\nexport function integer(value: unknown, label: string, minimum: number, maximum: number): number {\n  if (typeof value !== \"number\" || !Number.isInteger(value) || value < minimum || value > maximum) {\n    throw new Error(`${label} must be an integer between ${minimum} and ${maximum}`);\n  }\n  return value;\n}\n\nexport function keys(value: Record<string, unknown>, allowed: string[]): void {\n  const unexpected = Object.keys(value).filter((key) => !allowed.includes(key));\n  if (unexpected.length) throw new Error(`Unsupported input fields: ${unexpected.join(\", \")}`);\n}\n\nexport function isJson(value: unknown): value is Json {\n  return value === null || typeof value === \"string\" || typeof value === \"boolean\"\n    || typeof value === \"number\" && Number.isFinite(value)\n    || Array.isArray(value) && value.every(isJson)\n    || !!value && typeof value === \"object\" && Object.values(value).every(isJson);\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAC3B,SAAS,cAAc;AAEvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAUK;;;ACrBA,SAAS,OAAO,OAAgB,OAAwC;AAC7E,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,oBAAoB;AAC7G,SAAO;AACT;AAEO,SAAS,KAAK,OAAgB,OAAuB;AAC1D,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,4BAA4B;AACpG,SAAO;AACT;AAEO,SAAS,QAAQ,OAAgB,OAAe,SAAiB,SAAyB;AAC/F,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,WAAW,QAAQ,SAAS;AAC/F,UAAM,IAAI,MAAM,GAAG,KAAK,+BAA+B,OAAO,QAAQ,OAAO,EAAE;AAAA,EACjF;AACA,SAAO;AACT;AAEO,SAAS,KAAK,OAAgC,SAAyB;AAC5E,QAAM,aAAa,OAAO,KAAK,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,SAAS,GAAG,CAAC;AAC5E,MAAI,WAAW,OAAQ,OAAM,IAAI,MAAM,6BAA6B,WAAW,KAAK,IAAI,CAAC,EAAE;AAC7F;AAEO,SAAS,OAAO,OAA+B;AACpD,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,OAAO,UAAU,aAClE,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAClD,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,MAAM,KAC1C,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,OAAO,OAAO,KAAK,EAAE,MAAM,MAAM;AAChF;;;ADFA,IAAM,WAAW,EAAE,IAAI,wBAAwB,SAAS,IAAI;AAC5D,IAAM,aAAa;AACnB,IAAM,aAAa;AACnB,IAAM,4BAA4B;AAClC,IAAM,0BAA0B;AAezB,IAAM,mCAAN,cAA+C,MAAM;AAAA,EACjD,OAAO;AAAA,EAEhB,YAAY,UAAkB;AAC5B,UAAM,0BAA0B,QAAQ,yCAAyC;AACjF,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,0CAAN,cAAsD,MAAM;AAAA,EAGjE,YAAqB,KAAsB,UAAkB;AAC3D,UAAM,uBAAuB,GAAG,oBAAoB,QAAQ,iBAAiB;AAD1D;AAAsB;AAEzC,SAAK,OAAO;AAAA,EACd;AAAA,EAHqB;AAAA,EAAsB;AAAA,EAFlC,OAAO;AAMlB;AAoCA,SAAS,aAAa,OAAuD;AAC3E,SAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAC9B,aAAa,SAAS,OAAO,MAAM,YAAY;AACtD;AAEA,SAAS,UAAU,OAAmB;AACpC,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,SAAS;AACpD,MAAI,SAAS,OAAO,UAAU,UAAU;AACtC,WAAO,OAAO;AAAA,MACZ,OAAO,QAAQ,KAAK,EACjB,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,MAAM,KAAK,cAAc,KAAK,CAAC,EACnD,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,CAAC;AAAA,IAClD;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,UAAU,OAAwB;AACzC,MAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,wCAAwC;AAC5E,SAAO,GAAG,KAAK,UAAU,UAAU,KAAK,CAAC,CAAC;AAAA;AAC5C;AAEA,SAAS,UAAU,OAAgB,OAAqB;AACtD,MAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,oBAAoB;AAChE,SAAO;AACT;AAEA,SAAS,OAAO,OAAuB;AACrC,SAAO,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK;AACxD;AAEA,SAAS,gBAAgB,YAAsC;AAC7D,QAAM,QAAQ,WAAW,MAAM,GAAG;AAClC,MAAI,MAAM,WAAW,KAAK,MAAM,KAAK,CAAC,SAAS,CAAC,oBAAoB,KAAK,IAAI,CAAC,GAAG;AAC/E,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AACA,SAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAC5B;AAEA,SAAS,cAAc,OAAuB;AAC5C,MAAI,CAAC,MAAM,WAAW,aAAa,GAAG;AACpC,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AACA,QAAM,SAAS,MAAM,MAAM,cAAc,MAAM;AAC/C,MAAI,CAAC,UAAU,OAAO,WAAW,GAAG,KAAK,OAAO,SAAS,GAAG,KACvD,OAAO,SAAS,IAAI,KAAK,OAAO,MAAM,GAAG,EAAE,KAAK,CAAC,SAClD,CAAC,QAAQ,SAAS,OAAO,SAAS,QAAQ,CAAC,oBAAoB,KAAK,IAAI,CAAC,GAAG;AAC9E,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AACA,SAAO,SAAS,MAAM;AACxB;AAEA,SAAS,iBAAiB,OAAuB;AAC/C,MAAI,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,IAAI,KAClE,MAAM,MAAM,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,SAAS,OAAO,SAAS,IAAI,GAAG;AAC5E,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,SAAO;AACT;AAEA,SAAS,OAAO,aAAiE;AAC/E,QAAM,QAAQ,cAAc,WAAW;AACvC,QAAMA,YAAW,KAAK,MAAM,UAAU,UAAU;AAChD,QAAM,MAAM,KAAK,MAAM,KAAK,KAAK;AACjC,MAAIA,cAAa,0BAA0B;AACzC,UAAM,IAAI,MAAM,wDAAwD;AAAA,EAC1E;AACA,gBAAc,GAAG;AACjB,SAAO;AAAA,IACL,UAAAA;AAAA,IACA,YAAY,KAAK,MAAM,YAAY,YAAY;AAAA,IAC/C;AAAA,IACA,QAAQ,iBAAiB,KAAK,MAAM,QAAQ,QAAQ,CAAC;AAAA,IACrD,eAAe,KAAK,MAAM,eAAe,eAAe;AAAA,IACxD,oBAAoB;AAAA,MAClB,MAAM,sBAAsB;AAAA,MAC5B;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,kBAAkB;AAAA,MAChB,MAAM,oBAAoB;AAAA,MAC1B;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,sBAAsB,aAAqE;AAClG,QAAM,aAAa,OAAO,WAAW;AACrC,QAAM,SAAS,OAAO,OAAO,YAAY,UAAU,EAChD,KAAK,CAAC,EAAE,UAAU,MAAM,cAAc,QAAQ;AACjD,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,KAAK,WAAW;AAAA,IAChB,QAAQ;AAAA,IACR,aAAa,CAAC,SAAS,mBAAmB,eAAe;AAAA,EAC3D;AACF;AAEA,SAAS,gBAAgB,OAA+B;AACtD,MAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,yCAAyC;AAC7E,QAAM,SAAS,OAAO,OAAO,uBAAuB;AACpD,QAAM,KAAK,KAAK,OAAO,IAAI,WAAW;AACtC,QAAM,OAAO,KAAK,OAAO,MAAM,aAAa;AAC5C,QAAM,aAAa,KAAK,OAAO,YAAY,mBAAmB;AAC9D,MAAI,OAAO,MAAM,KAAK,MAAM,UAAU,CAAC,GAAG;AACxC,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,MAAI,OAAO,eAAe,UAAa,CAAC,MAAM,QAAQ,OAAO,UAAU,GAAG;AACxE,UAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AACA,QAAM,SAAwB,EAAE,IAAI,MAAM,WAAW;AACrD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,QAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,gCAAgC,GAAG,oBAAoB;AAC3F,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO;AACT;AAEA,SAAS,WAAW,OAAgB,OAAqC;AACvE,QAAM,SAAS,OAAO,OAAO,KAAK;AAClC,QAAM,SAA+B,CAAC;AACtC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,QAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,WAAW,GAAG,oBAAoB;AAC9E,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO;AACT;AAEA,SAAS,WAAW,OAAwC;AAC1D,QAAM,QAAQ,OAAO,OAAO,sBAAsB;AAClD,OAAK,OAAO,CAAC,SAAS,cAAc,SAAS,OAAO,CAAC;AACrD,SAAO;AAAA,IACL,OAAO,KAAK,MAAM,OAAO,OAAO;AAAA,IAChC,YAAY,KAAK,MAAM,YAAY,YAAY;AAAA,IAC/C,OAAO,WAAW,MAAM,OAAO,OAAO;AAAA,IACtC,OAAO,QAAQ,MAAM,OAAO,SAAS,GAAG,6BAA6B;AAAA,EACvE;AACF;AAEA,SAAS,YAAY,OAAyC;AAC5D,QAAM,QAAQ,OAAO,OAAO,0BAA0B;AACtD,OAAK,OAAO,CAAC,SAAS,SAAS,CAAC;AAChC,MAAI,CAAC,MAAM,QAAQ,MAAM,OAAO,EAAG,OAAM,IAAI,MAAM,yCAAyC;AAC5F,QAAM,UAAU,MAAM,QAAQ,IAAI,eAAe;AACjD,QAAM,aAAa,oBAAI,IAAoB;AAC3C,aAAW,UAAU,SAAS;AAC5B,UAAM,UAAU,UAAU,MAAM;AAChC,UAAM,WAAW,WAAW,IAAI,OAAO,EAAE;AACzC,QAAI,aAAa,UAAa,aAAa,SAAS;AAClD,YAAM,IAAI,iCAAiC,OAAO,EAAE;AAAA,IACtD;AACA,eAAW,IAAI,OAAO,IAAI,OAAO;AAAA,EACnC;AACA,SAAO,EAAE,OAAO,KAAK,MAAM,OAAO,OAAO,GAAG,QAAQ;AACtD;AAEA,SAAS,QAAQ,OAAyB;AACxC,SAAO,MAAM,IAAI,CAAC,SAAS,mBAAmB,IAAI,CAAC,EAAE,KAAK,GAAG;AAC/D;AAEA,SAAS,SAAS,YAAsC,QAAqB;AAC3E,QAAM,CAAC,OAAO,UAAU,IAAI,gBAAgB,WAAW,UAAU;AACjE,SAAO,IAAI,IAAI,UAAU,QAAQ,CAAC,OAAO,UAAU,CAAC,CAAC,IAAI,MAAM,IAAI,WAAW,QAAQ;AACxF;AAEA,SAAS,WAAW,YAAsC,OAAe;AACvE,QAAM,OAAO,GAAG,WAAW,MAAM,WAAW,OAAO,KAAK,CAAC;AACzD,SAAO;AAAA,IACL,UAAU,GAAG,IAAI;AAAA,IACjB,OAAO,GAAG,IAAI;AAAA,IACd,QAAQ,CAAC,OAAe,GAAG,IAAI,YAAY,OAAO,EAAE,CAAC;AAAA,EACvD;AACF;AAEA,SAAS,aAAa,OAAgB,OAAwC;AAC5E,MAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,mBAAmB;AAC/D,SAAO,OAAO,OAAO,KAAK;AAC5B;AAEA,SAAS,UAAU,OAAgB,OAAgC;AACjE,QAAM,WAAW,aAAa,OAAO,KAAK;AAC1C,SAAO,EAAE,KAAK,KAAK,SAAS,KAAK,GAAG,KAAK,MAAM,EAAE;AACnD;AAEA,SAAS,YAAY,OAAmC;AACtD,QAAM,WAAW,aAAa,OAAO,qBAAqB;AAC1D,QAAM,SAAS,OAAO,SAAS,QAAQ,mBAAmB;AAC1D,SAAO,EAAE,QAAQ,EAAE,KAAK,KAAK,OAAO,KAAK,uBAAuB,EAAE,EAAE;AACtE;AAEA,SAAS,eAAe,OAAsC;AAC5D,QAAM,WAAW,aAAa,OAAO,wBAAwB;AAC7D,QAAM,OAAO,OAAO,SAAS,MAAM,oBAAoB;AACvD,SAAO;AAAA,IACL,KAAK,KAAK,SAAS,KAAK,mBAAmB;AAAA,IAC3C,MAAM,EAAE,KAAK,KAAK,KAAK,KAAK,wBAAwB,EAAE;AAAA,EACxD;AACF;AAEA,SAAS,gBAAgB,OAAuC;AAC9D,QAAM,WAAW,aAAa,OAAO,yBAAyB;AAC9D,MAAI,SAAS,SAAS,UAAU,SAAS,aAAa,UAAU;AAC9D,UAAM,IAAI,MAAM,8CAA8C;AAAA,EAChE;AACA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS,KAAK,SAAS,SAAS,gBAAgB;AAAA,EAClD;AACF;AAEA,SAAS,WAAW,OAAgB,OAA2B;AAC7D,QAAM,SAAS,aAAa,OAAO,4BAA4B;AAC/D,MAAI,OAAO,WAAW,iCACjB,OAAO,UAAU,SAAS,CAAC,MAAM,QAAQ,OAAO,OAAO,GAAG;AAC7D,UAAM,IAAI,MAAM,mEAAmE;AAAA,EACrF;AACA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR;AAAA,IACA,SAAS,OAAO,QAAQ,IAAI,CAAC,UAAU;AACrC,YAAM,SAAS,OAAO,OAAO,mCAAmC;AAChE,aAAO;AAAA,QACL,IAAI,KAAK,OAAO,IAAI,mBAAmB;AAAA,QACvC,YAAY,KAAK,OAAO,YAAY,2BAA2B;AAAA,MACjE;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAEO,SAAS,sCAA0D;AACxE,SAAO;AAAA,IACL,UAAU;AAAA,MACR,IAAI,SAAS;AAAA,MACb,SAAS,SAAS;AAAA,MAClB,OAAO;AAAA,MACP,aAAa;AAAA,MACb,cAAc;AAAA,QACZ,MAAM;AAAA,QACN,sBAAsB;AAAA,QACtB,UAAU,CAAC,YAAY,cAAc,OAAO,UAAU,eAAe;AAAA,QACrE,YAAY;AAAA,UACV,UAAU,EAAE,OAAO,yBAAyB;AAAA,UAC5C,YAAY,EAAE,MAAM,UAAU,SAAS,oCAAoC;AAAA,UAC3E,KAAK;AAAA,YACH,MAAM;AAAA,YACN,SACE;AAAA,UACJ;AAAA,UACA,QAAQ,EAAE,MAAM,UAAU,WAAW,EAAE;AAAA,UACvC,eAAe,EAAE,MAAM,UAAU,WAAW,EAAE;AAAA,UAC9C,oBAAoB,EAAE,MAAM,WAAW,SAAS,GAAG,SAAS,IAAK;AAAA,UACjE,kBAAkB,EAAE,MAAM,WAAW,SAAS,GAAG,SAAS,EAAE;AAAA,QAC9D;AAAA,MACF;AAAA,MACA,UAAU,CAAC,QAAQ,mBAAmB,QAAQ,MAAM;AAAA,MACpD,gBAAgB,CAAC,aAAa,QAAQ;AAAA,MACtC,UAAU,EAAE,UAAU,MAAM,OAAO,KAAK;AAAA,IAC1C;AAAA,IACA,sBAAsB,CAAC,gBAAgB,CAAC,sBAAsB,WAAW,CAAC;AAAA,IAC1E,SAAS,aAAa,SAAS;AAC7B,UAAI;AACF,YAAI,YAAY,YAAY,KAAK;AAC/B,gBAAM,IAAI,MAAM,8CAA8C;AAAA,QAChE;AACA,eAAO,WAAW;AAClB,YAAI,CAAC,QAAQ,qBAAqB,CAAC,QAAQ,mBAAmB;AAC5D,gBAAM,IAAI;AAAA,YACR;AAAA,UACF;AAAA,QACF;AACA,YAAI,CAAC,OAAO,KAAK,YAAY,UAAU,EAAE,QAAQ;AAC/C,gBAAM,IAAI,MAAM,oDAAoD;AAAA,QACtE;AACA,mBAAW,aAAa,OAAO,OAAO,YAAY,UAAU,GAAG;AAC7D,gBAAM,WAAW,UAAU,cAAc,UACrC,+BACA,UAAU,cAAc,WACtB,gCACA;AACN,cAAI,CAAC,YAAY,UAAU,aAAa,YAAY,UAAU,OAAO;AACnE,kBAAM,IAAI,MAAM,wDAAwD;AAAA,UAC1E;AAAA,QACF;AACA,eAAO,EAAE,IAAI,KAAK;AAAA,MACpB,SAAS,OAAO;AACd,eAAO,EAAE,IAAI,OAAO,QAAQ,CAAC,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,EAAE;AAAA,MACvF;AAAA,IACF;AAAA,IACA,OAAO,aAAa,SAAS;AAC3B,YAAM,aAAa,OAAO,WAAW;AACrC,YAAM,MAAM,cAAc,WAAW,GAAG;AACxC,YAAM,cAAc,sBAAsB,WAAW;AACrD,YAAM,aAAa,CAAC,GAAG,IAAI;AAAA,QACzB,OAAO,OAAO,YAAY,UAAU,EAAE,IAAI,CAAC,EAAE,UAAU,MAAM,SAAS;AAAA,MACxE,CAAC;AAED,qBAAe,KACb,MACA,QACA,MACA,QACA,kBAAqC,CAAC,GACY;AAClD,iCAAyB,SAAS,aAAa,QAAQ,UAAU,aAAa,SAAS,EAAE;AACzF,cAAM,MAAM,SAAS,YAAY,IAAI;AACrC,YAAI,CAAC,QAAQ,qBACR,CAAC,MAAM,QAAQ,kBAAkB,SAAS,IAAI,GAAG,GAAG;AACvD,gBAAM,IAAI,MAAM,wDAAwD;AAAA,QAC1E;AACA,cAAM,aAAa,MAAM,QAAQ,oBAAoB,WAAW,aAAa;AAC7E,YAAI,CAAC,aAAa,UAAU,GAAG;AAC7B,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA;AAAA,cACE,kBAAkB;AAAA,gBAChB,OAAO;AAAA,gBACP,SAAS;AAAA,cACX;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,cAAM,QAAQ,YAAY,IAAI;AAAA,UAC5B,GAAI,SAAS,CAAC,MAAM,IAAI,CAAC;AAAA,UACzB,YAAY,QAAQ,GAAK;AAAA,QAC3B,CAAC;AACD,cAAM,eAAe;AACrB,iCAAyB,SAAS,aAAa,QAAQ,UAAU,aAAa,SAAS,EAAE;AACzF,cAAM,WAAW,MAAM,WAAW,QAAQ;AAAA,UACxC,KAAK,IAAI;AAAA,UACT;AAAA,UACA,SAAS;AAAA,YACP,QAAQ;AAAA,YACR,gBAAgB;AAAA,YAChB,wBAAwB;AAAA,UAC1B;AAAA,UACA,GAAI,SAAS,SAAY,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE;AAAA,UAC3D,QAAQ;AAAA,QACV,CAAC;AACD,YAAI,SAAS,WAAW,KAAK;AAC3B,gBAAM,QAAQ,kBAAkB,WAAW,aAAa;AACxD,gBAAM,IAAI;AAAA,YACR;AAAA,YACA;AAAA,YACA;AAAA,cACE,kBAAkB;AAAA,gBAChB,OAAO;AAAA,gBACP,SAAS;AAAA,cACX;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,YAAI,CAAC,SAAS,MAAM,CAAC,gBAAgB,SAAS,SAAS,MAAM,GAAG;AAC9D,gBAAM,IAAI;AAAA,YACR,wBAAwB,MAAM,IAAI,IAAI,QAAQ,qBAAqB,SAAS,MAAM;AAAA,UACpF;AAAA,QACF;AACA,YAAI,SAAS,WAAW,OAAO,gBAAgB,SAAS,SAAS,MAAM,GAAG;AACxE,iBAAO,EAAE,SAAS;AAAA,QACpB;AACA,YAAI;AACJ,YAAI;AACF,kBAAQ,MAAM,SAAS,KAAK;AAAA,QAC9B,SAAS,OAAO;AACd,gBAAM,IAAI,MAAM,mDAAmD,EAAE,OAAO,MAAM,CAAC;AAAA,QACrF;AACA,eAAO,EAAE,UAAU,MAAM;AAAA,MAC3B;AAEA,qBAAe,KAAK,QAAqD;AACvE,cAAM,YAAY;AAAA,WACf,MAAM,KAAK,WAAW,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,OAAO,QAAW,MAAM,GAAG;AAAA,QAC/E;AACA,cAAMC,UAAS;AAAA,WACZ,MAAM;AAAA,YACL,eAAe,mBAAmB,UAAU,OAAO,GAAG,CAAC;AAAA,YACvD;AAAA,YACA;AAAA,YACA;AAAA,UACF,GAAG;AAAA,QACL;AACA,eAAOA;AAAA,MACT;AAEA,qBAAe,SACb,MACA,UACA,QAC2B;AAC3B,cAAM,MAAM,YAAY,QAAQ,KAAK,MAAM,GAAG,CAAC,CAAC,QAAQ,mBAAmB,QAAQ,CAAC;AACpF,cAAM,SAAS,MAAM,KAAK,KAAK,OAAO,QAAW,QAAQ,CAAC,GAAG,CAAC;AAC9D,YAAI,OAAO,SAAS,WAAW,IAAK,QAAO;AAC3C,cAAM,UAAU,gBAAgB,OAAO,KAAK;AAC5C,YAAI;AACF,gBAAM,QAAiB,KAAK;AAAA,YAC1B,OAAO,KAAK,QAAQ,QAAQ,QAAQ,QAAQ,EAAE,GAAG,QAAQ,EAAE,SAAS,MAAM;AAAA,UAC5E;AACA,cAAI,CAAC,OAAO,KAAK,EAAG,OAAM,IAAI,MAAM,gCAAgC;AACpE,iBAAO;AAAA,QACT,SAAS,OAAO;AACd,gBAAM,IAAI,MAAM,wBAAwB,IAAI,2BAA2B,EAAE,OAAO,MAAM,CAAC;AAAA,QACzF;AAAA,MACF;AAEA,qBAAe,WAAW,SAAiB,QAAuC;AAChF,cAAM,WAAW;AAAA,WACd,MAAM,KAAK,aAAa,QAAQ,EAAE,SAAS,UAAU,QAAQ,GAAG,MAAM,GAAG;AAAA,UAC1E;AAAA,QACF;AACA,eAAO,SAAS;AAAA,MAClB;AAEA,qBAAe,OACb,MACA,SACA,SACA,QAC6B;AAC7B,cAAM,cAAc,MAAM,QAAQ,IAAI,QAAQ,IAAI,OAAO,EAAE,MAAM,QAAQ,OAAO;AAAA,UAC9E;AAAA,UACA,MAAM;AAAA,UACN,MAAM;AAAA,UACN,KAAK,MAAM,WAAW,SAAS,MAAM;AAAA,QACvC,EAAE,CAAC;AACH,cAAM,OAAO;AAAA,WACV,MAAM,KAAK,aAAa,QAAQ;AAAA,YAC/B,WAAW,KAAK,KAAK;AAAA,YACrB,MAAM;AAAA,UACR,GAAG,MAAM,GAAG;AAAA,UACZ;AAAA,QACF;AACA,cAAM,UAAU;AAAA,WACb,MAAM,KAAK,eAAe,QAAQ;AAAA,YACjC;AAAA,YACA,MAAM,KAAK;AAAA,YACX,SAAS,CAAC,KAAK,GAAG;AAAA,UACpB,GAAG,MAAM,GAAG;AAAA,UACZ;AAAA,QACF;AACA,cAAM,WAAW,QAAQ;AACzB,cAAM,SAAS,MAAM;AAAA,UACnB,YAAY,QAAQ,IAAI,MAAM,GAAG,CAAC,CAAC;AAAA,UACnC;AAAA,UACA,EAAE,KAAK,UAAU,OAAO,MAAM;AAAA,UAC9B;AAAA,UACA,CAAC,KAAK,GAAG;AAAA,QACX;AACA,eAAO,OAAO,SAAS,KAAK,WAAW;AAAA,MACzC;AAEA,qBAAe,MACb,OACA,QACgE;AAChE,cAAM,UAAU,MAAM,KAAK,MAAM;AACjC,cAAM,QAAQ,WAAW,YAAY,MAAM,KAAK;AAChD,cAAM,cAAc,MAAM,SAAS,MAAM,OAAO,QAAQ,KAAK,MAAM;AACnE,YAAI,gBAAgB,QAAW;AAC7B,iBAAO;AAAA,YACL,QAAQ,EAAE,OAAO,MAAM,OAAO,YAAY,MAAM,YAAY,SAAS,CAAC,EAAE;AAAA,YACxE,UAAU,QAAQ;AAAA,UACpB;AAAA,QACF;AACA,cAAM,QAAQ,WAAW,aAAa,MAAM,KAAK;AACjD,cAAM,UAAU,MAAM,QAAQ,IAAI,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,EAAE,IAAI,OAAO,UAAU;AACzF,gBAAM,KAAK,KAAK,OAAO,IAAI,mBAAmB;AAC9C,gBAAM,QAAQ,MAAM,SAAS,MAAM,OAAO,EAAE,GAAG,QAAQ,KAAK,MAAM;AAClE,cAAI,UAAU,QAAW;AACvB,kBAAM,IAAI,MAAM,yDAAyD,EAAE,GAAG;AAAA,UAChF;AACA,gBAAM,SAAS,gBAAgB,KAAK;AACpC,cAAI,OAAO,OAAO,IAAI;AACpB,kBAAM,IAAI,MAAM,qDAAqD,EAAE,GAAG;AAAA,UAC5E;AACA,iBAAO;AAAA,QACT,CAAC,CAAC;AACF,eAAO;AAAA,UACL,QAAQ;AAAA,YACN,OAAO,MAAM;AAAA,YACb,YAAY,MAAM;AAAA,YAClB;AAAA,UACF;AAAA,UACA,UAAU,QAAQ;AAAA,QACpB;AAAA,MACF;AAEA,qBAAe,OACb,OACA,QACiE;AACjE,cAAM,QAAQ,WAAW,YAAY,MAAM,KAAK;AAChD,iBAAS,UAAU,GAAG,WAAW,WAAW,kBAAkB,WAAW,GAAG;AAC1E,gBAAM,UAAU,MAAM,KAAK,MAAM;AACjC,gBAAM,gBAAgB,MAAM,SAAS,MAAM,UAAU,QAAQ,KAAK,MAAM;AACxE,cAAI,kBAAkB,QAAW;AAC/B,kBAAM,WAAW,OAAO,eAAe,+BAA+B;AACtE,gBAAI,SAAS,WAAW,gCACnB,SAAS,UAAU,MAAM,OAAO;AACnC,oBAAM,IAAI,MAAM,2DAA2D;AAAA,YAC7E;AAAA,UACF;AACA,gBAAM,cAAc,MAAM,SAAS,MAAM,OAAO,QAAQ,KAAK,MAAM;AACnE,cAAI,QAAoB;AAAA,YACtB,QAAQ;AAAA,YACR,OAAO,MAAM;AAAA,YACb,SAAS,CAAC;AAAA,UACZ;AACA,cAAI,gBAAgB,QAAW;AAC7B,oBAAQ,WAAW,aAAa,MAAM,KAAK;AAAA,UAC7C;AAEA,gBAAM,UAAoD,CAAC;AAC3D,gBAAM,UAAU,IAAI,IAAI,MAAM,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AACvE,gBAAM,SAAS,oBAAI,IAA2B;AAC9C,qBAAW,UAAU,MAAM,QAAS,QAAO,IAAI,OAAO,IAAI,MAAM;AAChE,qBAAW,UAAU,OAAO,OAAO,GAAG;AACpC,kBAAM,OAAO,MAAM,OAAO,OAAO,EAAE;AACnC,kBAAM,UAAU,UAAU,MAAM;AAChC,kBAAM,WAAW,MAAM,SAAS,MAAM,QAAQ,KAAK,MAAM;AACzD,gBAAI,aAAa,QAAW;AAC1B,oBAAM,SAAS,gBAAgB,QAAQ;AACvC,kBAAI,OAAO,OAAO,OAAO,MAAM,UAAU,MAAM,MAAM,SAAS;AAC5D,sBAAM,IAAI,iCAAiC,OAAO,EAAE;AAAA,cACtD;AAAA,YACF,OAAO;AACL,sBAAQ,KAAK,EAAE,MAAM,SAAS,QAAQ,CAAC;AAAA,YACzC;AACA,oBAAQ,IAAI,OAAO,IAAI,EAAE,IAAI,OAAO,IAAI,YAAY,OAAO,WAAW,CAAC;AAAA,UACzE;AAEA,gBAAM,cAAc,CAAC,GAAG,QAAQ,OAAO,CAAC,EACrC,KAAK,CAAC,MAAM,UACX,MAAM,WAAW,cAAc,KAAK,UAAU,KAC3C,KAAK,GAAG,cAAc,MAAM,EAAE,CAAC,EACnC,MAAM,GAAG,WAAW,kBAAkB;AACzC,gBAAM,YAAwB,EAAE,GAAG,OAAO,SAAS,YAAY;AAC/D,cAAI,kBAAkB,QAAW;AAC/B,oBAAQ,KAAK;AAAA,cACX,MAAM,MAAM;AAAA,cACZ,SAAS,UAAU;AAAA,gBACjB,QAAQ;AAAA,gBACR,OAAO,MAAM;AAAA,cACf,CAAC;AAAA,YACH,CAAC;AAAA,UACH;AACA,cAAI,gBAAgB,UACf,UAAU,WAAW,MAAM,UAAU,SAAS,GAAG;AACpD,oBAAQ,KAAK;AAAA,cACX,MAAM,MAAM;AAAA,cACZ,SAAS,UAAU,SAAS;AAAA,YAC9B,CAAC;AAAA,UACH;AAEA,cAAI,CAAC,QAAQ,QAAQ;AACnB,mBAAO;AAAA,cACL,QAAQ;AAAA,gBACN,OAAO,MAAM;AAAA,gBACb,WAAW,MAAM,QAAQ,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE;AAAA,gBAC3C,QAAQ;AAAA,cACV;AAAA,cACA,UAAU,QAAQ;AAAA,YACpB;AAAA,UACF;AACA,gBAAM,WAAW,MAAM;AAAA,YACrB;AAAA,YACA;AAAA,YACA,mBAAmB,MAAM,QAAQ,MAAM,kBAAkB,OAAO,MAAM,KAAK,EAAE,MAAM,GAAG,EAAE,CAAC;AAAA,YACzF;AAAA,UACF;AACA,cAAI,UAAU;AACZ,mBAAO;AAAA,cACL,QAAQ;AAAA,gBACN,OAAO,MAAM;AAAA,gBACb,WAAW,MAAM,QAAQ,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE;AAAA,gBAC3C,QAAQ;AAAA,cACV;AAAA,cACA;AAAA,YACF;AAAA,UACF;AAAA,QACF;AACA,cAAM,IAAI;AAAA,UACR,WAAW;AAAA,UACX,WAAW;AAAA,QACb;AAAA,MACF;AAEA,aAAO;AAAA,QACL;AAAA,QACA,UAAU,aAAa;AAAA,UACrB;AAAA,UACA,UAAU;AAAA,UACV,eAAc,oBAAI,KAAK,GAAE,YAAY;AAAA,UACrC,cAAc,WAAW,IAAI,CAAC,eAAe;AAAA,YAC3C,IAAI,cAAc,UACd,+BACA;AAAA,YACJ;AAAA,YACA,MAAM,cAAc,UAChB,yBACA;AAAA,YACJ,SAAS;AAAA,YACT,aAAa,cAAc,UACvB,+BACA;AAAA,YACJ,cAAc,cAAc,UACxB,gCACA;AAAA,YACJ,WAAW;AAAA,UACb,EAAE;AAAA,QACJ;AAAA,QACA,MAAM,MAAM,gBAAgB;AAC1B,gBAAM,UAAU,MAAM,KAAK,eAAe,MAAM;AAChD,iBAAO;AAAA,YACL,IAAI;AAAA,YACJ,QAAQ;AAAA,cACN,YAAY,WAAW;AAAA,cACvB,KAAK,WAAW;AAAA,cAChB,UAAU,QAAQ;AAAA,YACpB;AAAA,UACF;AAAA,QACF;AAAA,QACA,MAAM,QAAQ,SAAyB,gBAAgB;AACrD,cAAI,CAAC,WAAW,SAAS,QAAQ,SAAS,GAAG;AAC3C,kBAAM,IAAI,MAAM,gDAAgD;AAAA,UAClE;AACA,cAAI,QAAQ,cAAc,SAAS;AACjC,kBAAM,SAAS,MAAM,MAAM,WAAW,QAAQ,KAAK,GAAG,eAAe,MAAM;AAC3E,mBAAO;AAAA,cACL,QAAQ,UAAU,OAAO,QAAQ,6BAA6B;AAAA,cAC9D,QAAQ;AAAA,gBACN,YAAY,WAAW;AAAA,gBACvB,KAAK,WAAW;AAAA,gBAChB,UAAU,OAAO;AAAA,cACnB;AAAA,YACF;AAAA,UACF;AACA,cAAI,QAAQ,cAAc,UAAU;AAClC,kBAAM,SAAS,MAAM,OAAO,YAAY,QAAQ,KAAK,GAAG,eAAe,MAAM;AAC7E,mBAAO;AAAA,cACL,QAAQ,UAAU,OAAO,QAAQ,iCAAiC;AAAA,cAClE,QAAQ;AAAA,gBACN,YAAY,WAAW;AAAA,gBACvB,KAAK,WAAW;AAAA,gBAChB,UAAU,OAAO;AAAA,cACnB;AAAA,YACF;AAAA,UACF;AACA,gBAAM,IAAI,MAAM,4CAA4C;AAAA,QAC9D;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;","names":["endpoint","commit"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gik-service-providers",
-  "version": "0.1.0",
-  "description": "Individually imported host-managed scheduler and Gmail providers for GIK.",
+  "version": "0.2.0",
+  "description": "Individually imported host-managed service providers for GIK.",
   "type": "module",
   "license": "MIT",
   "author": "nsreehari",
@@ -11,10 +11,24 @@
     "directory": "packages/service-providers"
   },
   "sideEffects": false,
-  "files": ["dist", "README.md", "examples"],
+  "files": [
+    "dist",
+    "README.md",
+    "examples"
+  ],
   "exports": {
-    "./scheduler": { "types": "./dist/scheduler.d.ts", "import": "./dist/scheduler.js" },
-    "./gmail": { "types": "./dist/gmail.d.ts", "import": "./dist/gmail.js" }
+    "./scheduler": {
+      "types": "./dist/scheduler.d.ts",
+      "import": "./dist/scheduler.js"
+    },
+    "./gmail": {
+      "types": "./dist/gmail.d.ts",
+      "import": "./dist/gmail.js"
+    },
+    "./github-context-store": {
+      "types": "./dist/github-context-store.d.ts",
+      "import": "./dist/github-context-store.js"
+    }
   },
   "dependencies": {
     "croner": "^9.1.0",
@@ -26,5 +40,8 @@
     "prepack": "npm run build",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
-  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" }
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
 }