@agentworkforce/sage 1.0.6 → 1.1.1

package/dist/integrations/cloud-proxy-provider.d.ts

@@ -0,0 +1,42 @@
+export type ProxyMethod = "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+export type ProxyHeaders = Record<string, string>;
+export type ProxyQuery = Record<string, string>;
+export interface ProxyRequest {
+    method: ProxyMethod;
+    endpoint: string;
+    workspaceId?: string;
+    data?: unknown;
+    params?: ProxyQuery;
+}
+export interface ProxyResponse<T = unknown> {
+    status: number;
+    headers: ProxyHeaders;
+    data: T;
+}
+export interface ConnectionProvider {
+    readonly name: string;
+    proxy<T = unknown>(request: ProxyRequest): Promise<ProxyResponse<T>>;
+    healthCheck(): Promise<boolean>;
+}
+export declare class CloudProxyError extends Error {
+    readonly status?: number;
+    readonly code: string;
+    readonly retryAfterMs?: number;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        retryAfterMs?: number;
+    });
+}
+export declare class CloudProxyProvider implements ConnectionProvider {
+    readonly name = "cloud-proxy";
+    private readonly baseUrl;
+    private readonly cloudApiToken;
+    constructor(config: {
+        cloudApiUrl: string;
+        cloudApiToken: string;
+    });
+    proxy<T = unknown>(request: ProxyRequest): Promise<ProxyResponse<T>>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=cloud-proxy-provider.d.ts.map

package/dist/integrations/cloud-proxy-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-proxy-provider.d.ts","sourceRoot":"","sources":["../../src/integrations/cloud-proxy-provider.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAClD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAsDD,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;CAOjG;AAwBD,qBAAa,kBAAmB,YAAW,kBAAkB;IAC3D,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;IAK5D,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IA0DpE,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAWtC"}

package/dist/integrations/cloud-proxy-provider.js

@@ -0,0 +1,139 @@
+const HEALTH_ENDPOINT = "/api/health";
+const SLACK_PROXY_ENDPOINT = "/api/v1/proxy/slack";
+const REQUEST_TIMEOUT_MS = 30_000;
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const SLACK_TEAM_ID_PATTERN = /^[TE][A-Z0-9]{6,}$/;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readString(value) {
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
+function readNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function requireNonEmpty(value, field) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new CloudProxyError(`Cloud proxy configuration is missing ${field}`);
+    }
+    return normalized;
+}
+function readWorkspaceId(request) {
+    const workspaceId = readString(request.workspaceId);
+    if (!workspaceId) {
+        throw new CloudProxyError("Cloud Slack proxy request is missing workspaceId", {
+            code: "invalid_request",
+        });
+    }
+    return workspaceId;
+}
+function toCloudWorkspaceIdentity(workspaceId) {
+    if (SLACK_TEAM_ID_PATTERN.test(workspaceId) && !UUID_PATTERN.test(workspaceId)) {
+        return { slackTeamId: workspaceId };
+    }
+    return { workspaceId };
+}
+export class CloudProxyError extends Error {
+    status;
+    code;
+    retryAfterMs;
+    constructor(message, options) {
+        super(message);
+        this.name = "CloudProxyError";
+        this.status = options?.status;
+        this.code = options?.code ?? "cloud_proxy_error";
+        this.retryAfterMs = options?.retryAfterMs;
+    }
+}
+function parseEnvelope(payload) {
+    if (!isRecord(payload) || typeof payload.ok !== "boolean") {
+        throw new CloudProxyError("Cloud Slack proxy returned an invalid response");
+    }
+    if (payload.ok) {
+        return {
+            ok: true,
+            data: ("data" in payload ? payload.data : undefined),
+        };
+    }
+    return {
+        ok: false,
+        ...(readString(payload.error) ? { error: readString(payload.error) } : {}),
+        ...(readString(payload.code) ? { code: readString(payload.code) } : {}),
+        ...(readNumber(payload.retryAfterMs) !== undefined
+            ? { retryAfterMs: readNumber(payload.retryAfterMs) }
+            : {}),
+    };
+}
+export class CloudProxyProvider {
+    name = "cloud-proxy";
+    baseUrl;
+    cloudApiToken;
+    constructor(config) {
+        this.baseUrl = requireNonEmpty(config.cloudApiUrl, "cloudApiUrl").replace(/\/+$/, "");
+        this.cloudApiToken = requireNonEmpty(config.cloudApiToken, "cloudApiToken");
+    }
+    async proxy(request) {
+        let response;
+        const workspaceId = readWorkspaceId(request);
+        try {
+            response = await fetch(`${this.baseUrl}${SLACK_PROXY_ENDPOINT}`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.cloudApiToken}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    ...toCloudWorkspaceIdentity(workspaceId),
+                    endpoint: request.endpoint,
+                    method: request.method,
+                    ...(request.data !== undefined ? { data: request.data } : {}),
+                    ...(request.params !== undefined ? { params: request.params } : {}),
+                }),
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+        }
+        catch (error) {
+            throw new CloudProxyError(error instanceof Error ? error.message : "Cloud Slack proxy request failed", { code: "network_error" });
+        }
+        if (!response.ok) {
+            throw new CloudProxyError(`Cloud Slack proxy request failed: ${response.status} ${response.statusText}`, {
+                code: "upstream_error",
+                status: response.status,
+            });
+        }
+        let payload;
+        try {
+            payload = parseEnvelope(await response.json());
+        }
+        catch (error) {
+            if (error instanceof CloudProxyError) {
+                throw error;
+            }
+            throw new CloudProxyError("Cloud Slack proxy returned invalid JSON");
+        }
+        if (!payload.ok) {
+            throw new CloudProxyError(payload.error ?? "Cloud Slack proxy returned an error", {
+                code: payload.code,
+                retryAfterMs: payload.retryAfterMs,
+            });
+        }
+        return {
+            status: response.status,
+            headers: {},
+            data: payload.data,
+        };
+    }
+    async healthCheck() {
+        try {
+            const response = await fetch(`${this.baseUrl}${HEALTH_ENDPOINT}`, {
+                method: "GET",
+                signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/integrations/freshness-envelope.d.ts

@@ -0,0 +1,17 @@
+export type FreshnessSource = "overlay" | "relayfile" | "proxy" | "cache" | "fallback";
+export type EnvelopeStatus = "hit" | "miss" | "stale" | "error";
+export interface FreshnessEnvelope<T> {
+    data: T | null;
+    status: EnvelopeStatus;
+    source: FreshnessSource;
+    asOf: number;
+    ageMs: number;
+    error?: string;
+}
+export declare const DEFAULT_FRESHNESS_MAX_AGE_MS = 60000;
+export declare function hit<T>(data: T, source: FreshnessSource): FreshnessEnvelope<T>;
+export declare function miss<T>(source: FreshnessSource): FreshnessEnvelope<T>;
+export declare function stale<T>(data: T, source: FreshnessSource, ageMs: number): FreshnessEnvelope<T>;
+export declare function error<T>(message: string, source: FreshnessSource): FreshnessEnvelope<T>;
+export declare function isFresh<T>(envelope: FreshnessEnvelope<T>, maxAgeMs?: number): boolean;
+//# sourceMappingURL=freshness-envelope.d.ts.map

package/dist/integrations/freshness-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness-envelope.d.ts","sourceRoot":"","sources":["../../src/integrations/freshness-envelope.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,wBAAgB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAQ7E;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAQrE;AAED,wBAAgB,KAAK,CAAC,CAAC,EACrB,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,iBAAiB,CAAC,CAAC,CAAC,CAQtB;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAAC,CAAC,CAAC,CASvF;AAED,wBAAgB,OAAO,CAAC,CAAC,EACvB,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,QAAQ,SAA+B,GACtC,OAAO,CAET"}

package/dist/integrations/freshness-envelope.js

@@ -0,0 +1,41 @@
+export const DEFAULT_FRESHNESS_MAX_AGE_MS = 60_000;
+export function hit(data, source) {
+    return {
+        data,
+        status: "hit",
+        source,
+        asOf: Date.now(),
+        ageMs: 0,
+    };
+}
+export function miss(source) {
+    return {
+        data: null,
+        status: "miss",
+        source,
+        asOf: Date.now(),
+        ageMs: 0,
+    };
+}
+export function stale(data, source, ageMs) {
+    return {
+        data,
+        status: "stale",
+        source,
+        asOf: Date.now() - ageMs,
+        ageMs,
+    };
+}
+export function error(message, source) {
+    return {
+        data: null,
+        status: "error",
+        source,
+        asOf: Date.now(),
+        ageMs: 0,
+        error: message,
+    };
+}
+export function isFresh(envelope, maxAgeMs = DEFAULT_FRESHNESS_MAX_AGE_MS) {
+    return envelope.status === "hit" && envelope.ageMs <= maxAgeMs;
+}

package/dist/integrations/freshness-envelope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=freshness-envelope.test.d.ts.map

package/dist/integrations/freshness-envelope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness-envelope.test.d.ts","sourceRoot":"","sources":["../../src/integrations/freshness-envelope.test.ts"],"names":[],"mappings":""}

package/dist/integrations/freshness-envelope.test.js

@@ -0,0 +1,56 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { error, hit, isFresh, miss, stale } from "./freshness-envelope.js";
+describe("freshness envelope", () => {
+    const now = new Date("2026-04-15T12:00:00.000Z");
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it("creates a hit envelope with data and source", () => {
+        const data = { workspaceId: "rw_cloudws1" };
+        expect(hit(data, "overlay")).toEqual({
+            data,
+            status: "hit",
+            source: "overlay",
+            asOf: now.getTime(),
+            ageMs: 0,
+        });
+    });
+    it("creates a miss envelope with null data", () => {
+        expect(miss("relayfile")).toEqual({
+            data: null,
+            status: "miss",
+            source: "relayfile",
+            asOf: now.getTime(),
+            ageMs: 0,
+        });
+    });
+    it("creates a stale envelope carrying ageMs", () => {
+        expect(stale({ count: 2 }, "cache", 5_000)).toEqual({
+            data: { count: 2 },
+            status: "stale",
+            source: "cache",
+            asOf: now.getTime() - 5_000,
+            ageMs: 5_000,
+        });
+    });
+    it("creates an error envelope carrying the error string", () => {
+        expect(error("proxy unavailable", "proxy")).toEqual({
+            data: null,
+            status: "error",
+            source: "proxy",
+            asOf: now.getTime(),
+            ageMs: 0,
+            error: "proxy unavailable",
+        });
+    });
+    it("checks freshness against a strict max age", () => {
+        const envelope = hit({ id: "fresh-context" }, "cache");
+        expect(isFresh({ ...envelope, ageMs: 99 }, 100)).toBe(true);
+        expect(isFresh({ ...envelope, ageMs: 100 }, 100)).toBe(false);
+        expect(isFresh({ ...envelope, ageMs: 101 }, 100)).toBe(false);
+    });
+});

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

@@ -6,10 +6,11 @@ export interface GitHubContextProviderOptions {
 }
 export declare class GitHubContextProvider {
     private readonly nangoClient;
+    private readonly providerConfigKey;
     private readonly cache;
     private readonly cacheTtlMs;
     private readonly logger;
-    constructor(nangoClient: NangoClient, options?: GitHubContextProviderOptions);
+    constructor(nangoClient: NangoClient, providerConfigKey: string, options?: GitHubContextProviderOptions);
     getOrgsAndRepos(connectionId: string, relayfileReader?: SageRelayFileReader | null): Promise<GitHubOrgDiscovery>;
     private setCache;
 }

package/dist/integrations/github-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github-context.d.ts","sourceRoot":"","sources":["../../src/integrations/github-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AASjE,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,qBAAa,qBAAqB;IAM9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAL9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAG5B,WAAW,EAAE,WAAW,EACzC,OAAO,GAAE,4BAAiC;IAMtC,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAC3C,OAAO,CAAC,kBAAkB,CAAC;IAwB9B,OAAO,CAAC,QAAQ;CAMjB"}
+{"version":3,"file":"github-context.d.ts","sourceRoot":"","sources":["../../src/integrations/github-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AASjE,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,qBAAa,qBAAqB;IAM9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IANpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAG5B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,MAAM,EAC1C,OAAO,GAAE,4BAAiC;IAMtC,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,mBAAmB,GAAG,IAAI,GAC3C,OAAO,CAAC,kBAAkB,CAAC;IAwB9B,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/integrations/github-context.js

@@ -1,11 +1,13 @@
 const DEFAULT_CACHE_TTL_MS = 5 * 60_000;
 export class GitHubContextProvider {
     nangoClient;
+    providerConfigKey;
     cache = new Map();
     cacheTtlMs;
     logger;
-    constructor(nangoClient, options = {}) {
+    constructor(nangoClient, providerConfigKey, options = {}) {
         this.nangoClient = nangoClient;
+        this.providerConfigKey = providerConfigKey;
         this.cacheTtlMs = options.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
         this.logger = options.logger ?? console;
     }
@@ -27,7 +29,7 @@ export class GitHubContextProvider {
                 this.logger.warn('[sage] RelayFile GitHub discovery failed, falling back to Nango', error);
             }
         }
-        const discovery = await this.nangoClient.discoverGitHubOrgs(connectionId);
+        const discovery = await this.nangoClient.discoverGitHubOrgs(connectionId, this.providerConfigKey);
         this.setCache(connectionId, discovery);
         return cloneGitHubOrgDiscovery(discovery);
     }

package/dist/integrations/github.d.ts

@@ -3,16 +3,18 @@
  *
  * All GitHub API calls are routed through Nango's proxy so that
  * authentication is handled automatically via the stored connection.
- * Uses the 'github' integration key for repo access.
+ * Uses the workspace-resolved provider config key for repo access.
  */
 import { NangoClient } from '../nango.js';
 import type { IntegrationResult, GitHubFile, GitHubIssue, GitHubPR, GitHubSearchResult } from './types.js';
 export declare class GitHubIntegration {
     private readonly nango;
     private readonly connectionId;
-    constructor({ nangoClient, connectionId, }: {
+    private readonly providerConfigKey;
+    constructor({ nangoClient, connectionId, providerConfigKey, }: {
         nangoClient: NangoClient;
         connectionId: string;
+        providerConfigKey?: string | null;
     });
     private errorResult;
     private execute;

package/dist/integrations/github.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/integrations/github.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAkC,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA6EpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,EACV,WAAW,EACX,YAAY,GACb,EAAE;QACD,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB;IAKD,OAAO,CAAC,WAAW;YAOL,OAAO;IAcf,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IAmCxF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC;IAmCrF,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAmCnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAuC7F,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;IAmBjC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;CA+BrG"}
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/integrations/github.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,QAAQ,EACR,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA4EpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,EAAE;QACD,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC;IAWD,OAAO,CAAC,WAAW;YAOL,OAAO;IAcf,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IAmCxF,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,EAAE,CAAC,CAAC;IAmCrF,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAmCnC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAuC7F,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC;IAmBjC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;CA+BrG"}

package/dist/integrations/github.js

@@ -3,11 +3,10 @@
  *
  * All GitHub API calls are routed through Nango's proxy so that
  * authentication is handled automatically via the stored connection.
- * Uses the 'github' integration key for repo access.
+ * Uses the workspace-resolved provider config key for repo access.
  */
-import { NangoError, NANGO_INTEGRATIONS } from '../nango.js';
+import { NangoError } from '../nango.js';
 const SOURCE = 'github';
-const PROVIDER = NANGO_INTEGRATIONS.GITHUB;
 function result(data, summary) {
     return {
         source: SOURCE,
@@ -64,9 +63,15 @@ function encodeRepoPath(path) {
 export class GitHubIntegration {
     nango;
     connectionId;
-    constructor({ nangoClient, connectionId, }) {
+    providerConfigKey;
+    constructor({ nangoClient, connectionId, providerConfigKey, }) {
+        const resolvedProviderConfigKey = providerConfigKey?.trim();
+        if (!resolvedProviderConfigKey) {
+            throw new Error('GitHubIntegration requires a providerConfigKey');
+        }
         this.nango = nangoClient;
         this.connectionId = connectionId;
+        this.providerConfigKey = resolvedProviderConfigKey;
     }
     errorResult(action, fallback, error) {
         const prefix = isRateLimited(error)
@@ -88,7 +93,7 @@ export class GitHubIntegration {
         return this.execute(`searching code for "${query}"${repo ? ` in ${repo}` : ''}`, { items: [] }, async () => {
             const data = await this.nango.proxy({
                 connectionId: this.connectionId,
-                providerConfigKey: PROVIDER,
+                providerConfigKey: this.providerConfigKey,
                 method: 'GET',
                 endpoint: `/search/code?q=${encodeURIComponent(scopedQuery)}`,
                 headers: { Accept: 'application/vnd.github.text-match+json' },
@@ -108,7 +113,7 @@ export class GitHubIntegration {
         return this.execute(`searching issues for "${query}"${repo ? ` in ${repo}` : ''}`, [], async () => {
             const data = await this.nango.proxy({
                 connectionId: this.connectionId,
-                providerConfigKey: PROVIDER,
+                providerConfigKey: this.providerConfigKey,
                 method: 'GET',
                 endpoint: `/search/issues?q=${encodeURIComponent(scopedQuery)}`,
             });
@@ -130,7 +135,7 @@ export class GitHubIntegration {
         return this.execute(`reading file ${owner}/${repo}/${path}${ref ? ` @ ${ref}` : ''}`, { path, content: '', sha: '' }, async () => {
             const data = await this.nango.proxy({
                 connectionId: this.connectionId,
-                providerConfigKey: PROVIDER,
+                providerConfigKey: this.providerConfigKey,
                 method: 'GET',
                 endpoint,
             });
@@ -148,13 +153,13 @@ export class GitHubIntegration {
             const [pr, files] = await Promise.all([
                 this.nango.proxy({
                     connectionId: this.connectionId,
-                    providerConfigKey: PROVIDER,
+                    providerConfigKey: this.providerConfigKey,
                     method: 'GET',
                     endpoint: `/repos/${owner}/${repo}/pulls/${number}`,
                 }),
                 this.nango.proxy({
                     connectionId: this.connectionId,
-                    providerConfigKey: PROVIDER,
+                    providerConfigKey: this.providerConfigKey,
                     method: 'GET',
                     endpoint: `/repos/${owner}/${repo}/pulls/${number}/files`,
                 }),
@@ -174,7 +179,7 @@ export class GitHubIntegration {
         return this.execute(`listing repository contents for ${owner}/${repo}${path ? `/${path}` : ''}`, [], async () => {
             const data = await this.nango.proxy({
                 connectionId: this.connectionId,
-                providerConfigKey: PROVIDER,
+                providerConfigKey: this.providerConfigKey,
                 method: 'GET',
                 endpoint: `/repos/${owner}/${repo}/contents${encodedPath}`,
             });
@@ -185,7 +190,7 @@ export class GitHubIntegration {
         return this.execute(`loading issue #${number} in ${owner}/${repo}`, { number, title: '', body: '', state: 'error', labels: [], url: '' }, async () => {
             const data = await this.nango.proxy({
                 connectionId: this.connectionId,
-                providerConfigKey: PROVIDER,
+                providerConfigKey: this.providerConfigKey,
                 method: 'GET',
                 endpoint: `/repos/${owner}/${repo}/issues/${number}`,
             });

package/dist/integrations/recent-actions-overlay.d.ts

@@ -0,0 +1,31 @@
+export declare const DEFAULT_OVERLAY_TTL_MS = 120000;
+export declare const DEFAULT_OVERLAY_MAX_ENTRIES = 500;
+export interface OverlayEntry {
+    path: string;
+    data: Record<string, unknown>;
+    writtenAt: number;
+    provider: string;
+    action: string;
+}
+export interface RecentActionsOverlayOptions {
+    ttlMs?: number;
+    maxEntries?: number;
+}
+export declare class RecentActionsOverlay {
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly entries;
+    constructor(options?: RecentActionsOverlayOptions);
+    record(entry: Omit<OverlayEntry, "writtenAt">): void;
+    lookup(path: string): OverlayEntry | null;
+    search(query: {
+        provider?: string;
+        pathPrefix?: string;
+        since?: number;
+    }): OverlayEntry[];
+    clear(): void;
+    get size(): number;
+    private isExpired;
+    private evictOldestEntries;
+}
+//# sourceMappingURL=recent-actions-overlay.d.ts.map

package/dist/integrations/recent-actions-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-actions-overlay.d.ts","sourceRoot":"","sources":["../../src/integrations/recent-actions-overlay.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAC9C,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAE/C,OAAO,CAAC,EAAE,2BAA2B;IAKjD,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,IAAI;IAcpD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAgBzC,MAAM,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,EAAE;IA2BzF,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAWjB;IAED,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,kBAAkB;CAU3B"}

package/dist/integrations/recent-actions-overlay.js

@@ -0,0 +1,80 @@
+export const DEFAULT_OVERLAY_TTL_MS = 120_000;
+export const DEFAULT_OVERLAY_MAX_ENTRIES = 500;
+export class RecentActionsOverlay {
+    ttlMs;
+    maxEntries;
+    entries = new Map();
+    constructor(options) {
+        this.ttlMs = options?.ttlMs ?? DEFAULT_OVERLAY_TTL_MS;
+        this.maxEntries = options?.maxEntries ?? DEFAULT_OVERLAY_MAX_ENTRIES;
+    }
+    record(entry) {
+        const overlayEntry = {
+            ...entry,
+            writtenAt: Date.now(),
+        };
+        if (this.entries.has(entry.path)) {
+            this.entries.delete(entry.path);
+        }
+        this.entries.set(entry.path, overlayEntry);
+        this.evictOldestEntries();
+    }
+    lookup(path) {
+        const entry = this.entries.get(path);
+        if (!entry) {
+            return null;
+        }
+        if (this.isExpired(entry, Date.now())) {
+            this.entries.delete(path);
+            return null;
+        }
+        this.entries.delete(path);
+        this.entries.set(path, entry);
+        return entry;
+    }
+    search(query) {
+        const now = Date.now();
+        const results = [];
+        for (const entry of this.entries.values()) {
+            if (this.isExpired(entry, now)) {
+                continue;
+            }
+            if (query.provider !== undefined && entry.provider !== query.provider) {
+                continue;
+            }
+            if (query.pathPrefix !== undefined && !entry.path.startsWith(query.pathPrefix)) {
+                continue;
+            }
+            if (query.since !== undefined && entry.writtenAt < query.since) {
+                continue;
+            }
+            results.push(entry);
+        }
+        return results.sort((left, right) => right.writtenAt - left.writtenAt);
+    }
+    clear() {
+        this.entries.clear();
+    }
+    get size() {
+        const now = Date.now();
+        let count = 0;
+        for (const entry of this.entries.values()) {
+            if (!this.isExpired(entry, now)) {
+                count += 1;
+            }
+        }
+        return count;
+    }
+    isExpired(entry, now) {
+        return now - entry.writtenAt >= this.ttlMs;
+    }
+    evictOldestEntries() {
+        while (this.entries.size > this.maxEntries) {
+            const oldestKey = this.entries.keys().next().value;
+            if (oldestKey === undefined) {
+                return;
+            }
+            this.entries.delete(oldestKey);
+        }
+    }
+}

package/dist/integrations/recent-actions-overlay.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recent-actions-overlay.test.d.ts.map

package/dist/integrations/recent-actions-overlay.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-actions-overlay.test.d.ts","sourceRoot":"","sources":["../../src/integrations/recent-actions-overlay.test.ts"],"names":[],"mappings":""}