openings 0.1.6 → 0.1.7

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "openings",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "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" },
   "homepage": "https://github.com/abhay-avagama/hiring-agent#readme",
   "bugs": { "url": "https://github.com/abhay-avagama/hiring-agent/issues" },
-  "keywords": ["jobs", "resume", "matching", "mcp", "greenhouse", "lever", "ashby", "workday", "recruitee", "smartrecruiters", "workable", "breezy"],
+  "keywords": ["jobs", "resume", "matching", "mcp", "greenhouse", "lever", "ashby", "workday", "recruitee", "smartrecruiters", "workable", "breezy", "freshteam"],
   "type": "module",
   "bin": { "openings-mcp": "./src/package-mcp.ts" },
   "exports": "./src/index.ts",

package/src/board-verification.ts

@@ -7,8 +7,8 @@ import type { Ats, Company, SourceVerification } from "./types.ts";
 
 type Fetch = (input: string | URL, init?: RequestInit) => Promise<Response>;
 
-/** Providers whose public board is accepted as identity on its own. Workday stays on the company-identity path because its crawls are expensive. */
-export const BOARD_TIER_PROVIDERS: ReadonlySet<Ats> = new Set(["greenhouse", "lever", "ashby", "recruitee", "smartrecruiters", "workable", "breezy"]);
+/** Providers whose public board is accepted as identity on its own. Workday boards are identified by tenant; their crawls are heavier but they carry the large employers. */
+export const BOARD_TIER_PROVIDERS: ReadonlySet<Ats> = new Set(["greenhouse", "lever", "ashby", "recruitee", "smartrecruiters", "workable", "breezy", "workday", "freshteam"]);
 
 export interface BoardVerificationOptions {
   fetch?: Fetch;
@@ -124,17 +124,21 @@ async function probeBoard(lead: EnrichmentLead, fetcher: Fetch, timeoutMs: numbe
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(new Error(`Timed out after ${timeoutMs}ms`)), timeoutMs);
   try {
-    const response = await fetcher(source.structuredEndpoint, { signal: controller.signal });
+    const init: RequestInit = source.ats === "workday"
+      ? { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ appliedFacets: {}, limit: 20, offset: 0, searchText: "" }), signal: controller.signal }
+      : { signal: controller.signal };
+    const response = await fetcher(source.structuredEndpoint, init);
     if (!response.ok) { await response.body?.cancel().catch(() => undefined); throw new BoardError(response.status === 404 || response.status === 410 ? "invalid_payload" : "unreachable", `HTTP ${response.status}`); }
     let body: unknown;
     try { body = await response.json(); } catch { throw new BoardError("invalid_payload", "Endpoint did not return JSON"); }
     const spec = providerSpec(source.ats);
-    const jobs = spec ? spec.jobsFromBody(body) : source.ats === "lever" ? asArray(body) : asArray(isRecord(body) ? body[source.ats === "recruitee" ? "offers" : "jobs"] : undefined);
+    const jobs = spec ? spec.jobsFromBody(body) : source.ats === "lever" ? asArray(body) : asArray(isRecord(body) ? body[source.ats === "recruitee" ? "offers" : source.ats === "workday" ? "jobPostings" : "jobs"] : undefined);
     if (!jobs) throw new BoardError("invalid_payload", "Payload does not contain the expected jobs array");
     if (jobs.length === 0) throw new BoardError("empty_board", "Board has no jobs");
-    const providerName = spec ? spec.providerName(jobs, body) : source.ats === "greenhouse" ? majority(jobs.map((job) => typeof job.company_name === "string" ? job.company_name.trim() : "").filter(Boolean)) : "";
-    const payloadVersion = spec ? spec.payloadVersion(body) : source.ats === "greenhouse" ? "greenhouse-job-board:v1" : source.ats === "lever" ? "lever-postings:v0" : source.ats === "recruitee" ? "recruitee-careers:v1" : `ashby-job-board:${isRecord(body) && typeof body.apiVersion === "string" ? body.apiVersion : "unknown"}`;
-    return { providerName, contentType: response.headers.get("content-type") ?? "unknown", payloadVersion, jobCount: jobs.length };
+    const providerName = spec ? spec.providerName(jobs, body) : source.ats === "greenhouse" ? majority(jobs.map((job) => typeof job.company_name === "string" ? job.company_name.trim() : "").filter(Boolean)) : source.ats === "workday" ? humanize(source.token.split("/")[1] ?? source.token) : "";
+    const payloadVersion = spec ? spec.payloadVersion(body) : source.ats === "greenhouse" ? "greenhouse-job-board:v1" : source.ats === "lever" ? "lever-postings:v0" : source.ats === "recruitee" ? "recruitee-careers:v1" : source.ats === "workday" ? "workday-cxs:v1" : `ashby-job-board:${isRecord(body) && typeof body.apiVersion === "string" ? body.apiVersion : "unknown"}`;
+    const jobCount = source.ats === "workday" && isRecord(body) && typeof body.total === "number" ? body.total : jobs.length;
+    return { providerName, contentType: response.headers.get("content-type") ?? "unknown", payloadVersion, jobCount };
   } finally { clearTimeout(timer); }
 }
 
@@ -152,7 +156,8 @@ function withAttempt(lead: EnrichmentLead, attempt: LeadAttempt): EnrichmentLead
 }
 
 function uniqueSlug(lead: EnrichmentLead, used: Set<string>): string | null {
-  const base = lead.token.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || lead.ats;
+  const raw = lead.ats === "workday" ? (lead.token.split("/")[1] ?? lead.token) : lead.token;
+  const base = raw.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || lead.ats;
   for (const candidate of [base, `${lead.ats}-${base}`]) if (!used.has(candidate)) return candidate;
   return null;
 }

package/src/cli.ts

@@ -343,12 +343,13 @@ function parseCommonCrawlDiscovery(args: string[]) {
     else if (arg === "--registry") { if (reportOnly) return "Use either --registry or --report-only, not both"; registryPath = args[++index] ?? ""; if (!registryPath) return "--registry requires a file"; }
     else if (arg === "--report-only") { if (registryPath !== "data/enrichment-leads.json") return "Use either --registry or --report-only, not both"; reportOnly = true; registryPath = undefined; }
     else if (arg === "--provider") { const value = args[++index]; if (!value || !(ALL_PROVIDERS as readonly string[]).includes(value)) return `--provider must be one of ${ALL_PROVIDERS.join(", ")}`; provider = value as Ats; }
-    else if (arg === "--index-record-limit") { indexRecordLimit = Number(args[++index]); if (!Number.isInteger(indexRecordLimit) || indexRecordLimit < 1 || indexRecordLimit > 2_000) return "--index-record-limit must be an integer from 1 to 2000"; }
+    else if (arg === "--index-record-limit") { indexRecordLimit = Number(args[++index]); if (!Number.isInteger(indexRecordLimit) || indexRecordLimit < 1 || indexRecordLimit > 100_000) return "--index-record-limit must be an integer from 1 to 100000"; }
     else if (arg === "--sample-token-limit") { sampleTokenLimit = Number(args[++index]); if (!Number.isInteger(sampleTokenLimit) || sampleTokenLimit < 1 || sampleTokenLimit > 60) return "--sample-token-limit must be an integer from 1 to 60"; }
     else if (arg === "--exclude-token") { const value = args[++index]?.trim(); if (!value || !/^[a-z0-9-]+$/i.test(value)) return "--exclude-token requires an ATS token"; excludeTokens.push(value.toLowerCase()); }
     else return `Unknown option: ${arg}`;
   }
-  if ((indexRecordLimit !== undefined || sampleTokenLimit !== undefined || excludeTokens.length || registryPath === undefined) && provider !== "recruitee") return "bounded report-only discovery requires --provider recruitee";
+  if ((sampleTokenLimit !== undefined || excludeTokens.length || registryPath === undefined) && provider !== "recruitee") return "bounded report-only discovery requires --provider recruitee";
+  if (provider === "recruitee" && indexRecordLimit !== undefined && indexRecordLimit > 2_000) return "--index-record-limit must be an integer from 1 to 2000 for --provider recruitee";
   if (provider === "recruitee" && (!indexUrl || indexRecordLimit === undefined || sampleTokenLimit === undefined || !reportOnly)) return "--provider recruitee requires --index-url, --index-record-limit, --sample-token-limit, and --report-only";
   if (provider === "recruitee" && !underOpenings(report)) return "bounded Recruitee discovery --report must be under .openings";
   if (sampleTokenLimit !== undefined && indexRecordLimit !== undefined && sampleTokenLimit > indexRecordLimit) return "--sample-token-limit cannot exceed --index-record-limit";

package/src/common-crawl-discovery.ts

@@ -39,7 +39,7 @@ export interface CommonCrawlDiscoveryReport extends ReportMeta {
 
 const providerPatterns: Record<Ats, string[]> = {
   greenhouse: ["job-boards.greenhouse.io/*", "boards.greenhouse.io/*"], lever: ["jobs.lever.co/*"], ashby: ["jobs.ashbyhq.com/*"], workday: ["*.myworkdayjobs.com/*"], recruitee: ["*.recruitee.com/*"],
-  ...Object.fromEntries(PROVIDERS.map((spec) => [spec.ats, spec.crawlPatterns])) as Record<"smartrecruiters" | "workable" | "breezy", string[]>,
+  ...Object.fromEntries(PROVIDERS.map((spec) => [spec.ats, spec.crawlPatterns])) as Record<"smartrecruiters" | "workable" | "breezy" | "freshteam", string[]>,
 };
 const patterns = Object.values(providerPatterns).flat();
 const recordsPerPattern = 10_000;

package/src/mcp.ts

@@ -95,6 +95,7 @@ export async function serve() {
       }
     }
   }
+  await runtime.usage?.flush();
 }
 
 if (import.meta.main) await serve();

package/src/providers.ts

@@ -145,7 +145,41 @@ const breezy: ProviderSpec = {
   },
 };
 
-export const PROVIDERS: ReadonlyArray<ProviderSpec> = [smartrecruiters, workable, breezy];
+const freshteam: ProviderSpec = {
+  ats: "freshteam",
+  label: "Freshteam",
+  hosts: ["freshteam.com"],
+  crawlPatterns: ["*.freshteam.com/jobs*"],
+  resolve(url) {
+    const match = /^([a-z0-9-]+)\.freshteam\.com$/i.exec(url.hostname);
+    return match && !["www", "app", "api", "support", "help", "blog"].includes(match[1]!.toLowerCase()) ? match[1]!.toLowerCase() : null;
+  },
+  canonicalUrl: (token) => `https://${token}.freshteam.com/jobs`,
+  endpoint: (token) => `https://${token}.freshteam.com/hire/widgets/jobs.json`,
+  jobsFromBody(body) {
+    if (!isRecord(body)) return null;
+    const jobs = asRecords(body.jobs);
+    if (!jobs) return null;
+    const branches = new Map((asRecords(body.branches) ?? []).map((branch) => [String(branch.id), branch]));
+    // The widget lists branches separately; pin each job's branch onto the record so normalize() sees it.
+    return jobs.filter((job) => job.deleted !== true).map((job) => ({ ...job, branch: branches.get(String(job.branch_id)) }));
+  },
+  providerName: () => "",
+  payloadVersion: () => "freshteam-widget:v1",
+  normalize(company, job) {
+    const branch = isRecord(job.branch) ? job.branch : {};
+    const location = [str(branch.city), str(branch.state), str(branch.country_code).toUpperCase()].filter(Boolean).join(", ") || (job.remote === true ? "Remote" : "Unspecified");
+    const remote = job.remote === true;
+    return classifyJob({
+      id: `freshteam:${company.slug}:${str(job.unique_id) || str(job.id)}`, company: company.name, title: str(job.title), location,
+      remote, workMode: remote ? "remote" : "unknown",
+      eligibleCountries: [], excludedCountries: [], eligibleRegions: [], eligibilityConfidence: "unknown",
+      url: `https://${company.token}.freshteam.com/jobs/${encodeURIComponent(str(job.unique_id) || str(job.id))}`, updatedAt: str(job.created_at) || undefined, description: plainText(str(job.description)),
+    });
+  },
+};
+
+export const PROVIDERS: ReadonlyArray<ProviderSpec> = [smartrecruiters, workable, breezy, freshteam];
 
 export function providerSpec(ats: string): ProviderSpec | undefined {
   return PROVIDERS.find((spec) => spec.ats === ats);

package/src/types.ts

@@ -1,4 +1,4 @@
-export const ALL_PROVIDERS = ["greenhouse", "lever", "ashby", "workday", "recruitee", "smartrecruiters", "workable", "breezy"] as const;
+export const ALL_PROVIDERS = ["greenhouse", "lever", "ashby", "workday", "recruitee", "smartrecruiters", "workable", "breezy", "freshteam"] as const;
 export type Ats = (typeof ALL_PROVIDERS)[number];
 
 export interface DomainEvidence {

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.6";
+export const VERSION = "0.1.7";