@frontmcp/adapters 1.4.1 → 1.5.0

package/skills/sources/saas-pull.source.d.ts

@@ -1,6 +1,7 @@
 import type { FrontMcpLogger } from '@frontmcp/sdk';
+import type { ResolvedBundle } from '../bundle/bundle.types';
 import type { SaasSourceOptions } from '../source-options';
-import type { BundleSourceListener, SkillBundleSource } from './skill-bundle-source.interface';
+import type { BundleSourceDeps, BundleSourceListener, SkillBundleSource } from './skill-bundle-source.interface';
 /**
  * Pulls bundles from a configured SaaS endpoint via authenticated HTTPS.
  *
@@ -23,16 +24,25 @@ export declare class SaasPullSource implements SkillBundleSource {
     private readonly options;
     private readonly cacheDir;
     private readonly logger;
+    private readonly deps;
     readonly id: string;
     private listeners;
     private pollHandle;
     private inFlight;
     private stopped;
-    constructor(options: SaasSourceOptions, cacheDir: string | undefined, logger: FrontMcpLogger);
+    constructor(options: SaasSourceOptions, cacheDir: string | undefined, logger: FrontMcpLogger, deps?: BundleSourceDeps);
     start(): Promise<void>;
     onChange(listener: BundleSourceListener): () => void;
     stop(): Promise<void>;
     private schedulePoll;
+    /**
+     * Manually pull a fresh bundle, persist it, and notify listeners. Drive this
+     * from a Cron Trigger / Durable Object alarm on runtimes without background
+     * timers (where `disablePolling` is set). Single-flight: returns `undefined`
+     * if a pull is already in flight; throws if the pull itself fails (the caller
+     * — e.g. a scheduled handler — decides how to surface it).
+     */
+    refresh(): Promise<ResolvedBundle | undefined>;
     private pollOnce;
     protected httpGet(url: string, headers: Record<string, string>): Promise<{
         status: number;

package/skills/sources/saas-pull.source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saas-pull.source.d.ts","sourceRoot":"","sources":["../../../src/skills/sources/saas-pull.source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAKpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAK/F;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IASpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAGL,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,cAAc;IAKnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAO9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,YAAY;YAQN,QAAQ;cAqBN,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;YAgBlG,SAAS;IAiBvB,OAAO,CAAC,SAAS;YAKH,YAAY;YAUZ,SAAS;IAUvB,OAAO,CAAC,MAAM;CASf"}
+{"version":3,"file":"saas-pull.source.d.ts","sourceRoot":"","sources":["../../../src/skills/sources/saas-pull.source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAKjH;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAe,YAAW,iBAAiB;IASpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAXvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAGL,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,gBAAqB;IAKxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC5B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAO9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,OAAO,CAAC,YAAY;IAcpB;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;YAatC,QAAQ;cAqBN,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;YAgBlG,SAAS;IAiBvB,OAAO,CAAC,SAAS;YAKH,YAAY;YAeZ,SAAS;IAkBvB,OAAO,CAAC,MAAM;CASf"}

package/skills/sources/skill-bundle-source.interface.d.ts

@@ -29,8 +29,49 @@ export interface SkillBundleSource {
      * notification fires on or shortly after `start()` resolves.
      */
     onChange(listener: BundleSourceListener): () => void;
+    /**
+     * Pull a fresh bundle on demand and notify listeners — the manual,
+     * externally-driven counterpart to background polling. Optional: only
+     * remote/pulling sources implement it. On runtimes with no background
+     * execution (Cloudflare Workers) a Cron Trigger / Durable Object alarm
+     * calls this instead of relying on an internal timer. Resolves to the new
+     * bundle, or `undefined` if a pull is already in flight / the source is
+     * stopped.
+     */
+    refresh?(): Promise<ResolvedBundle | undefined>;
     /** Halt background work; idempotent. */
     stop(): Promise<void>;
 }
 export type BundleSourceListener = (bundle: ResolvedBundle) => void;
+/**
+ * Pluggable last-good bundle cache. The default (Node) implementation writes to
+ * disk; V8-isolate runtimes (Cloudflare Workers) inject a KV-backed store
+ * instead — there is no filesystem on a Worker.
+ */
+export interface BundleCacheStore {
+    read(): Promise<ResolvedBundle | undefined>;
+    write(bundle: ResolvedBundle): Promise<void>;
+}
+/**
+ * Optional runtime dependencies any pulling bundle source can accept. NOT
+ * SaaS-specific — these are the knobs a host injects to make a source run on a
+ * constrained runtime:
+ *   - `cache` replaces the on-disk last-good cache (no filesystem on a Worker),
+ *   - `disablePolling` turns off the internal `setInterval` loop (no background
+ *     execution on a Worker; a Cron Trigger / DO alarm drives {@link
+ *     SkillBundleSource.refresh} instead).
+ */
+export interface BundleSourceDeps {
+    /**
+     * Override the on-disk cache with a custom store (e.g. KV on Cloudflare).
+     * When provided, NO filesystem APIs are touched — required on V8 isolates.
+     */
+    cache?: BundleCacheStore;
+    /**
+     * Disable the internal `setInterval` poll loop. Use on runtimes with no
+     * background execution where a Cron Trigger / Durable Object alarm drives
+     * {@link SkillBundleSource.refresh} instead.
+     */
+    disablePolling?: boolean;
+}
 //# sourceMappingURL=skill-bundle-source.interface.d.ts.map

package/skills/sources/skill-bundle-source.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-bundle-source.interface.d.ts","sourceRoot":"","sources":["../../../src/skills/sources/skill-bundle-source.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAErD,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC"}
+{"version":3,"file":"skill-bundle-source.interface.d.ts","sourceRoot":"","sources":["../../../src/skills/sources/skill-bundle-source.interface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IAErD;;;;;;;;OAQG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAEhD,wCAAwC;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC5C,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}