openings 0.1.25 → 0.1.26

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "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.25",
+  "version": "0.1.26",
   "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/index.ts

@@ -35,3 +35,9 @@ export { createSelectedJobLookup } from "./selected-job-lookup.ts";
 export type { SelectedJobLookupOptions } from "./selected-job-lookup.ts";
 export { createJobCoverageReader, projectJobCoverage } from "./job-coverage.ts";
 export type { CountryJobCoverage, JobCoverageSummary } from "./job-coverage.ts";
+export { createHostedRuntime } from "./runtime.ts";
+export type { SnapshotStore } from "./crawler.ts";
+export { createToolHandler } from "./tools.ts";
+export { createMcpHandler, FLOW_INSTRUCTIONS } from "./mcp.ts";
+export type { UpdateNotice } from "./update-check.ts";
+export { VERSION } from "./version.ts";

package/src/runtime.ts

@@ -1,4 +1,6 @@
 import { join } from "node:path";
+import type { SnapshotStore } from "./crawler.ts";
+import type { Company, SearchQuery } from "./types.ts";
 import { fetchSourceJobs } from "./catalog.ts";
 import { createCrawlReporter, fetchSeedSnapshot, resolveAggregatorUrl } from "./crawl-reporting.ts";
 import { createUsageReporter, type UsageReporter } from "./usage.ts";
@@ -56,3 +58,25 @@ export function createRuntime(options: { dataDir?: string; concurrency?: number;
   const optimizer = createResumeOptimizer({ analyzeJobFit: analyzer.analyze });
   return { ...local, prepareJobSearch: preparation.prepare, getJobCoverage: coverage.getCoverage, recommend: recommender.recommend, analyzeJobFit: analyzer.analyze, optimizeResume: optimizer.optimize, usage };
 }
+
+/**
+ * The same workflows over a read-only shared index, for the hosted connector. The store is supplied by the host
+ * (the aggregator's live index), nothing is crawled, and the sources are exactly those the store holds so
+ * preparation reports ready at once. No usage reporter: the host meters by account instead.
+ */
+export function createHostedRuntime(options: { sources: Company[]; store: SnapshotStore; now?: () => Date }) {
+  const readOnly = async () => { throw new Error("The hosted index is read-only; it refreshes from the nightly crawl"); };
+  const local = createLocalJobs({ sources: options.sources, store: options.store, fetchJobs: readOnly, now: options.now, sourceFreshnessMs: 0 });
+  const noCrawl = async () => ({ startedAt: new Date().toISOString(), finishedAt: new Date().toISOString(), selected: 0, succeeded: 0, failed: [] });
+  const recommender = createJobRecommender({ sources: options.sources, store: options.store, crawl: noCrawl, now: options.now });
+  const coverage = createJobCoverageReader({ sources: options.sources, store: options.store });
+  const preparation = createJobSearchPreparer({ sources: options.sources, store: options.store, crawl: noCrawl, now: options.now, freshnessDays: 3650 });
+  const getSelectedJob = createSelectedJobLookup({ getSnapshotJob: async (id) => (await local.get(id, { offline: true, staleDays: 3650 })).job, getDetailedJob: async () => null });
+  const analyzer = createJobFitAnalyzer({ getJob: getSelectedJob });
+  const optimizer = createResumeOptimizer({ analyzeJobFit: analyzer.analyze });
+  return {
+    search: (query: SearchQuery) => local.search(query, { offline: true, staleDays: 3650 }),
+    get: (id: string) => local.get(id, { offline: true, staleDays: 3650 }),
+    prepareJobSearch: preparation.prepare, getJobCoverage: coverage.getCoverage, recommend: recommender.recommend, analyzeJobFit: analyzer.analyze, optimizeResume: optimizer.optimize,
+  };
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.25";
+export const VERSION = "0.1.26";