openings 0.1.4 → 0.1.5

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Find evidence-grounded jobs, including relevant roles you may not have searched for, without accounts or API keys.",
   "author": { "name": "Openings contributors" },
   "license": "MIT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A free, candidate-safe job-search substrate for AI agents",
   "license": "MIT",
   "repository": { "type": "git", "url": "git+https://github.com/abhay-avagama/hiring-agent.git" },

package/src/crawl-reporting.ts

@@ -43,9 +43,11 @@ export function createCrawlReporter(options: { url: string; fetcher?: Fetch; tim
 }
 
 /** Downloads the aggregator's published snapshot; returns null on any failure so setup falls back to crawling. */
-export async function fetchSeedSnapshot(url: string, fetcher: Fetch = globalThis.fetch, timeoutMs = 20_000): Promise<JobSnapshot | null> {
+export async function fetchSeedSnapshot(url: string, fetcher: Fetch = globalThis.fetch, timeoutMs = 20_000, countries: string[] = []): Promise<JobSnapshot | null> {
   try {
-    const response = await fetcher(endpoint(url, "v1/snapshot"), { signal: AbortSignal.timeout(timeoutMs) });
+    const codes = countries.map((code) => code.toUpperCase()).filter((code) => /^[A-Z]{2}$/.test(code));
+    const target = endpoint(url, "v1/snapshot") + (codes.length ? `?countries=${codes.join(",")}` : "");
+    const response = await fetcher(target, { signal: AbortSignal.timeout(timeoutMs) });
     if (!response.ok) return null;
     const snapshot = await response.json() as JobSnapshot;
     if (snapshot?.version !== 1 || !snapshot.partitions || typeof snapshot.partitions !== "object" || !snapshot.lastCrawl) return null;

package/src/job-search-preparation.ts

@@ -18,7 +18,7 @@ export function createJobSearchPreparer(options: {
   store: SnapshotStore;
   crawl(scope: CrawlScope): Promise<CrawlReport>;
   /** Optional published snapshot used instead of crawling when no local snapshot exists yet. */
-  seed?(): Promise<JobSnapshot | null>;
+  seed?(countries: string[]): Promise<JobSnapshot | null>;
   now?: () => Date;
   freshnessDays?: number;
   batchSize?: number;
@@ -32,7 +32,7 @@ export function createJobSearchPreparer(options: {
       const { countries } = input;
       let snapshot = await options.store.read();
       if (!snapshot && options.seed) {
-        const seeded = await options.seed().catch(() => null);
+        const seeded = await options.seed(countries).catch(() => null);
         if (seeded) { await options.store.write(seeded); snapshot = seeded; }
       }
       const pendingBefore = pendingSources(options.sources, snapshot, now(), freshnessMs);

package/src/mcp.ts

@@ -22,7 +22,7 @@ export function createMcpHandler(tools: ToolHandler) {
     const base = { jsonrpc: "2.0" as const, id: request.id ?? null };
     try {
       if (request.method === "initialize") {
-        return { ...base, result: { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "openings", version: "0.1.4" } } };
+        return { ...base, result: { protocolVersion: "2025-06-18", capabilities: { tools: {} }, serverInfo: { name: "openings", version: "0.1.5" } } };
       }
       if (request.method === "ping") return { ...base, result: {} };
       if (request.method === "tools/list") return { ...base, result: { tools: tools.list() } };

package/src/runtime.ts

@@ -40,7 +40,7 @@ export function createRuntime(options: { dataDir?: string; concurrency?: number;
     workdayPageDelayMs: options.workdayPageDelayMs,
     onCrawled,
   });
-  const preparation = createJobSearchPreparer({ sources: companies, store, crawl: preparationLocal.crawl, seed: aggregatorUrl ? () => fetchSeedSnapshot(aggregatorUrl) : undefined });
+  const preparation = createJobSearchPreparer({ sources: companies, store, crawl: preparationLocal.crawl, seed: aggregatorUrl ? (countries) => fetchSeedSnapshot(aggregatorUrl, globalThis.fetch, 20_000, countries) : undefined });
   const getSelectedJob = createSelectedJobLookup({
     getSnapshotJob: async (id) => (await local.get(id, { offline: true, staleDays: 14 })).job,
     getDetailedJob: (id) => liveCatalog.get(id),