openings 0.1.22 → 0.1.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openings",
-  "version": "0.1.22",
+  "version": "0.1.24",
   "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/board-verification.ts

@@ -157,7 +157,7 @@ function withAttempt(lead: EnrichmentLead, attempt: LeadAttempt): EnrichmentLead
 }
 
 function uniqueSlug(lead: EnrichmentLead, used: Set<string>): string | null {
-  const raw = lead.ats === "workday" ? (lead.token.split("/")[1] ?? lead.token) : lead.token;
+  const raw = lead.ats === "workday" ? (lead.token.split("/")[1] ?? lead.token) : lead.ats === "keka" ? lead.token.split("/")[0]! : lead.ats === "zohorecruit" ? lead.token.split(".")[0]! : 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/job-recommendations.ts

@@ -22,7 +22,8 @@ export interface RecommendJobsResult {
   profile: CandidateProfile;
   matches: JobMatch[];
   exploration: ReturnType<typeof matchJobs>["exploration"];
-  filteredOut: FilteredJob[];
+  /** Counts by reason plus a small sample: the full list once ran to every job in the index and blew past MCP payload limits. */
+  filteredOut: { total: number; byReason: Record<string, number>; sample: FilteredJob[] };
   assumptions: string[];
   ranking: { mode: "evidence" | "keyword"; minimumPercent: number };
   snapshot: SnapshotStatus;
@@ -143,15 +144,20 @@ function matchSnapshot(profile: CandidateProfile, intent: CandidateIntent, snaps
   return matchJobs(profile, intent, jobs, jobs.length, ranking);
 }
 
-function limitMatching<T extends ReturnType<typeof matchSnapshot>>(matching: T, limit = 20): T {
-  const matches = matching.matches.slice(0, Math.max(0, limit));
-  const ids = new Set(matches.map((match) => match.job.id));
-  return { ...matching, matches, exploration: {
-    ...matching.exploration,
-    directMatches: matching.exploration.directMatches.filter((match) => ids.has(match.job.id)),
-    hiddenMatches: matching.exploration.hiddenMatches.filter((match) => ids.has(match.job.id)),
-    stretchMatches: matching.exploration.stretchMatches.filter((match) => ids.has(match.job.id)),
-  } };
+const EXCERPT_CHARS = 280;
+/** Transport shape: descriptions become excerpts (get_job returns the full text), exploration lists carry the same compact matches, filtered jobs are summarised. */
+function limitMatching(matching: ReturnType<typeof matchSnapshot>, limit = 20): Omit<ReturnType<typeof matchSnapshot>, "filteredOut"> & { filteredOut: RecommendJobsResult["filteredOut"] } {
+  const compact = (match: JobMatch): JobMatch => ({ ...match, job: { ...match.job, description: match.job.description.length > EXCERPT_CHARS ? `${match.job.description.slice(0, EXCERPT_CHARS).trimEnd()}…` : match.job.description } });
+  const matches = matching.matches.slice(0, Math.max(0, limit)).map(compact);
+  const byId = new Map(matches.map((match) => [match.job.id, match]));
+  const pick = (list: JobMatch[]) => list.filter((match) => byId.has(match.job.id)).map((match) => byId.get(match.job.id)!);
+  const byReason: Record<string, number> = {};
+  for (const entry of matching.filteredOut) for (const reason of entry.reasons) { const key = reason.split(":")[0]!; byReason[key] = (byReason[key] ?? 0) + 1; }
+  return {
+    ...matching, matches,
+    exploration: { ...matching.exploration, directMatches: pick(matching.exploration.directMatches), hiddenMatches: pick(matching.exploration.hiddenMatches), stretchMatches: pick(matching.exploration.stretchMatches) },
+    filteredOut: { total: matching.filteredOut.length, byReason, sample: matching.filteredOut.slice(0, 20) },
+  };
 }
 
 function preCutoffMatchCount(matching: ReturnType<typeof matchSnapshot>): number {

package/src/providers.ts

@@ -192,10 +192,11 @@ const keka: ProviderSpec = {
   resolve(url) {
     const tenant = /^([a-z0-9-]+)\.keka\.com$/i.exec(url.hostname)?.[1]?.toLowerCase();
     if (!tenant || ["www", "app", "hr", "academy", "developers", "help", "cdn", "api"].includes(tenant) && tenant !== "hr") return null;
-    const org = /\/(?:careers\/api\/embedjobs\/default\/active|ats\/documents)\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i.exec(url.pathname)?.[1];
+    const org = /\/(?:careers\/api\/embedjobs(?:\/default\/active)?|ats\/documents)\/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/i.exec(url.pathname)?.[1];
     return org ? `${tenant}/${org.toLowerCase()}` : null;
   },
-  canonicalUrl: (token) => `https://${token.split("/")[0]}.keka.com/careers`,
+  // The embed page is a real listing a person can open and it carries the org id, so the canonical URL round-trips through resolve().
+  canonicalUrl: (token) => `https://${token.split("/")[0]}.keka.com/careers/api/embedjobs/${token.split("/")[1] ?? ""}`,
   endpoint: (token) => `https://${token.split("/")[0]}.keka.com/careers/api/embedjobs/default/active/${token.split("/")[1] ?? ""}`,
   jobsFromBody: (body) => asRecords(body),
   providerName: () => "",

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.1.22";
+export const VERSION = "0.1.24";