@singi-labs/sifa-sdk 0.19.23 → 0.19.24

package/dist/index.cjs

@@ -6637,7 +6637,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.23";
+var SIFA_SDK_VERSION = "0.19.24";
 
 exports.ACTIVITY_TIERS = ACTIVITY_TIERS;
 exports.ACTIVITY_VERBS = ACTIVITY_VERBS;

package/dist/index.js

@@ -6635,7 +6635,7 @@ function describeSifaRecord(collection, value) {
 }
 
 // src/index.ts
-var SIFA_SDK_VERSION = "0.19.23";
+var SIFA_SDK_VERSION = "0.19.24";
 
 export { ACTIVITY_TIERS, ACTIVITY_VERBS, ACTIVITY_VISIBILITY_RULES, ADULT_CONTENT_LABELS, ALL_SECTIONS, APP_CATEGORIES, APP_CATEGORY_IDS, APP_CATEGORY_MAP, APP_URL_PATTERNS, ARTIFACT_LINK_KIND_LABELS, ARTIFACT_LINK_KIND_OPTIONS, ArtifactLinkSchema, AtmosphereFeedItemSchema, BlobRefSchema, CALENDAR_EVENT_MODE_LABELS, CALENDAR_EVENT_STATUS_LABELS, CATEGORY_LABELS, CATEGORY_ORDER, COLLECTION_TO_APP, COMPANY_OPTIONAL_EMPLOYMENT_TYPES, COMPANY_PAGE_MIN_FIRMOGRAPHIC_FIELDS, COMPLETENESS_MAX_SCORE, CONTINENTS, COUNTRIES, DIMENSIONS_MAX_SCORE, EMPLOYMENT_TYPE_GROUPS, EMPLOYMENT_TYPE_LABELS, ENTITY_REF_ANCHORS, EndorsementConfirmationRecordSchema, EndorsementRecordSchema, EntityImportSearchResponseSchema, EntityMintDomainResponseSchema, EntityResolveDomainRequestSchema, EntityResolveDomainResponseSchema, EntitySearchResponseSchema, EntitySearchResultSchema, EntitySelectRequestSchema, EntitySelectResponseSchema, FEATURE_FLAGS, FeatureAllowlistEntrySchema, FeedActorSchema, FollowFeedItemSchema, FollowFeedPageSchema, FollowProfilePageSchema, FollowProfileSchema, GraphFollowRecordSchema, INDUSTRY_OPTIONS, INVESTMENT_ROLE_LABELS, INVESTMENT_ROLE_OPTIONS, INVESTMENT_STAGE_LABELS, INVESTMENT_STAGE_OPTIONS, INVESTMENT_STATUS_LABELS, INVESTMENT_STATUS_OPTIONS, INVOLVEMENT_HEADING_ORDER, INVOLVEMENT_KIND_HEADINGS, INVOLVEMENT_KIND_LABELS, INVOLVEMENT_KIND_OPTIONS, InvestmentAmountSchema, MIN_SKILLS, ON_BEHALF_OF_EMPLOYMENT_TYPES, OPEN_TO_OPTIONS, OPEN_TO_TOKENS, OPEN_TO_TOKEN_TO_VALUE, OPEN_TO_VALUE_TO_TOKEN, OrgEmploymentAttestationRecordSchema, OrgProfileRecordSchema, PLATFORM_LABELS, PLATFORM_OPTIONS, PRESENTATION_LINK_TYPE_LABELS, PRESENTATION_LINK_TYPE_OPTIONS, PRESENTATION_ROLE_LABELS, PRESENTATION_ROLE_OPTIONS, PROFILE_INVESTMENT_NSID, PROFILE_INVOLVEMENT_NSID, PROJECT_ROLES, PUBLICATION_TYPE_LABELS, PUBLICATION_TYPE_OPTIONS, PUBLISHERS, PresentationDurationSchema, PresentationLinkSchema, ProfileCertificationRecordSchema, ProfileCourseRecordSchema, ProfileEducationRecordSchema, ProfileExternalAccountRecordSchema, ProfileHonorRecordSchema, ProfileInvestmentRecordSchema, ProfileInvolvementRecordSchema, ProfileLanguageRecordSchema, ProfilePositionRecordSchema, ProfilePresentationDeliveryRecordSchema, ProfilePresentationRecordSchema, ProfileProjectRecordSchema, ProfilePublicationRecordSchema, ProfileSelfRecordSchema, ProfileSkillRecordSchema, ProfileVolunteeringRecordSchema, PublicationAuthorSchema, ROADMAP_ISSUES_REPO, ROADMAP_ITEM_META, SECTION_GROUPS, SECTION_LABELS, SELF_APP_ID, SIFA_REPO_GROUPS, SIFA_SDK_VERSION, SKILL_CATEGORIES, STANDARD_PUBLISHER_ID, STREAM_VERBS, SifaFeedItemSchema, VERIFICATION_PROVIDERS, WORKPLACE_TYPE_LABELS, WORKPLACE_TYPE_OPTIONS, actorShowsIdentity, agentRefSchema, atUriSchema, buildMetaDescription, buildProfileHighlights, buildTalkSlug, categoryForApp, certDateExtractor, cidSchema, classifyEntityRef, completenessPercent, completenessScore, contrastRatio, countFilledDimensions, countRecentActivity, countryCodeToFlag, dateRangeExtractor, datetimeSchema, decodeFeedCursor, dedupeSkills, describeSifaRecord, detectPdsProvider, didSchema, dimensionsFromInputs, durationFromMinutes, encodeFeedCursor, entityDisambiguationLabel, entityResultKey, excludeSelfApp, externalRecordRefSchema, filterHidden, findIndustry, formatCompanyName, formatDateRange, formatDisplayUrl, formatDistanceToNow, formatEventDate, formatLocation, formatPresentationDuration, formatRelationship, formatRelativeTime, formatSingleDate, formatSpanDate, formatTimelineDate, getActivityTaxonomyVersion, getActivityTier, getActivityVerbsVersion, getAppCategoryIcon, getAppIdForCollection, getArtifactLinkKindLabel, getCalendarEventModeLabel, getCalendarEventStatusLabel, getContinent, getDisplayLabel, getEmploymentTypeLabel, getFaviconUrl, getFilledDimensionsMap, getHandleStem, getIndustryLabelKey, getInvestmentRoleLabel, getInvestmentStageLabel, getInvestmentStatusLabel, getInvolvementKindHeading, getInvolvementKindLabel, getLexiconEntry, getOpenToLabelKey, getPdsDisplayName, getPlatformLabel, getPresentationLinkTypeLabel, getPresentationRoleLabel, getPublicationTypeLabel, getPublisherByHost, getPublisherById, getPublisherFromSiteUrl, getTierMeta, getVerificationProvider, getVisibleSectionIds, getWorkplaceTypeLabel, groupInvolvementByHeading, groupSkillsByCategory, groupSkillsBySubCategory, groupSkillsForDisplay, hasAdultContent, hasPersonalProfileContent, hoistPrimary, isAppCategory, isCompanyPageIndexable, isCompanyRequired, isKnownAppId, isKnownPlatform, isKnownVerificationProvider, isLinked, isOnBehalfOfApplicable, isPseudoEmployer, isRegistrableDomainHandle, isRelationalActivity, isRoleLineRedundant, isSectionPopulated, isSelfAuthoredRich, isValidRgbColor, isVisibleActivityItem, languageTagSchema, lexiconDateExtractor, limitCombiningMarks, locationSegments, looksLikeDomain, makeGraphFollowRecordSchema, maxGraphemes, meetsContrastAA, normalizeCompanyKey, normalizeDoi, normalizeLegalForm, normalizeOpenTo, normalizePlatformId, normalizePresentationMode, normalizePresentationRole, normalizeSkillCategory, normalizeWorkplaceTypes, openToTokenToValue, openToValueToToken, parseEndorsementComment, parseIntendedAudiences, parseLocationString, parsePresentationDuration, parseTalkRkey, partialDateSchema, pdsProviderFromApi, pickPrimaryFlagged, pickPrimaryPosition, presentationCsvRowToRecord, presentationDeliveryCsvRowToRecord, primaryVerification, profileToDimensionInputs, qualifiesAsOrg, relativeLuminance, renderAsLine, rendersCompanyProfile, rendersPersonalProfile, repoGroupForCollection, resolveAccountFacetMode, resolveAgentRef, resolveCardHealth, resolveCardUrl, resolveEmbed, resolveVerifierProvider, rgbToString, roadmapIssueUrl, sanitizeDisplayText, sanitizeHandleInput, searchResultDisambiguation, selfLabelsSchema, shouldRenderHighlights, singleDateExtractor, skillRefSchema, slugifyTitle, sortByActiveDateRange, sortByDateDesc, sortCertifications, sortEducation, sortHonors, sortLanguages, sortLanguagesByProficiency, sortPositions, sortProjects, sortPublications, streamAddressSchema, streamAuthorSchema, streamCardBodySchema, streamCardSubjectSchema, streamCardVMSchema, streamExternalLinkSchema, streamGeoSchema, streamMediaSchema, streamRichSegmentSchema, streamSourceSchema, streamThemeSchema, streamVerbSchema, stripHtmlToText, strongRefSchema, summarizePresentationDeliveries, summarizeProfileView, toStreamCardVM, toStreamCardVMs, truncateGraphemes, uriSchema, verbForCollection, visibleItems, youtubeThumbnailUrl, youtubeVideoId };
 //# sourceMappingURL=index.js.map

package/dist/jev/index.cjs

@@ -0,0 +1,113 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/jev/index.ts
+var noulAnswerSchema = zod.z.object({
+  type: zod.z.literal("noul"),
+  noul: zod.z.number().min(0).max(1)
+});
+var choiceAnswerSchema = zod.z.object({
+  type: zod.z.literal("choice"),
+  choice: zod.z.string(),
+  confidence: zod.z.number().min(0).max(1),
+  probabilities: zod.z.record(zod.z.string(), zod.z.number())
+});
+function compact(obj) {
+  const out = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (v !== void 0 && v !== null && v !== "") out[k] = v;
+  }
+  return out;
+}
+function buildOrgPairState(a, b) {
+  return { orgA: compact(a), orgB: compact(b) };
+}
+var ORG_PAIR_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "The state holds two organisation records, orgA and orgB. Do they refer to the same real-world organisation?",
+  criteria: {
+    true: "Same organisation, e.g. a legal-suffix or abbreviation variant of the same name, or the same primary domain.",
+    false: "Distinct organisations, e.g. a shared word in the name but different domains, locations, or lines of business."
+  }
+};
+var SAME_ORG_THRESHOLD = 0.85;
+function isLikelySameOrg(noul, threshold = SAME_ORG_THRESHOLD) {
+  return noul >= threshold;
+}
+var INDUSTRY_TAXONOMY = {
+  technology: "Software, IT services, internet, hardware, telecoms",
+  finance: "Banking, insurance, investment, fintech, accounting",
+  healthcare: "Medical care, pharma, biotech, health services",
+  education: "Schools, universities, training, edtech",
+  manufacturing: "Industrial production, hardware, materials, automotive",
+  retail: "Retail, ecommerce, consumer goods, hospitality, food",
+  media: "Media, publishing, entertainment, marketing, advertising",
+  energy: "Energy, utilities, oil and gas, renewables",
+  construction: "Construction, real estate, architecture, engineering",
+  transport: "Transport, logistics, shipping, aviation",
+  professional_services: "Legal, consulting, HR, business services",
+  public_sector: "Government, defence, public administration",
+  nonprofit: "Charities, NGOs, foundations, associations",
+  agriculture: "Agriculture, farming, fishing, forestry",
+  other: "None of the above, or not enough information to decide"
+};
+var ORG_TYPE_TAXONOMY = {
+  company: "For-profit company or corporation",
+  nonprofit: "Nonprofit, charity, NGO, or foundation",
+  government: "Government body or public-sector entity",
+  educational: "School, university, or research institution",
+  agency: "Agency, consultancy, or professional-services firm",
+  other: "None of the above, or not enough information to decide"
+};
+var SIZE_BAND_TAXONOMY = {
+  solo: "1 person",
+  small: "2 to 10 people",
+  medium: "11 to 50 people",
+  large: "51 to 250 people",
+  enterprise: "More than 250 people",
+  unknown: "Not enough information to decide"
+};
+function choiceQuestion(instructions, criteria) {
+  return { type: "choice", instructions, criteria };
+}
+var INDUSTRY_CHOICE_QUESTION = choiceQuestion(
+  "Based on the org state, which single industry best describes this organisation?",
+  INDUSTRY_TAXONOMY
+);
+var ORG_TYPE_CHOICE_QUESTION = choiceQuestion(
+  "Based on the org state, which single type best describes this organisation?",
+  ORG_TYPE_TAXONOMY
+);
+var SIZE_BAND_CHOICE_QUESTION = choiceQuestion(
+  "Based on the org state, which employee-size band best fits this organisation?",
+  SIZE_BAND_TAXONOMY
+);
+function buildFirmographicState(org) {
+  return compact(org);
+}
+var FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;
+function pickChoiceAboveFloor(answer, opts = {}) {
+  const floor = opts.floor ?? FIRMOGRAPHIC_CONFIDENCE_FLOOR;
+  if (answer.confidence < floor) return null;
+  if (opts.noMatch !== void 0 && answer.choice === opts.noMatch) return null;
+  return answer.choice;
+}
+
+exports.FIRMOGRAPHIC_CONFIDENCE_FLOOR = FIRMOGRAPHIC_CONFIDENCE_FLOOR;
+exports.INDUSTRY_CHOICE_QUESTION = INDUSTRY_CHOICE_QUESTION;
+exports.INDUSTRY_TAXONOMY = INDUSTRY_TAXONOMY;
+exports.ORG_PAIR_NOUL_QUESTION = ORG_PAIR_NOUL_QUESTION;
+exports.ORG_TYPE_CHOICE_QUESTION = ORG_TYPE_CHOICE_QUESTION;
+exports.ORG_TYPE_TAXONOMY = ORG_TYPE_TAXONOMY;
+exports.SAME_ORG_THRESHOLD = SAME_ORG_THRESHOLD;
+exports.SIZE_BAND_CHOICE_QUESTION = SIZE_BAND_CHOICE_QUESTION;
+exports.SIZE_BAND_TAXONOMY = SIZE_BAND_TAXONOMY;
+exports.buildFirmographicState = buildFirmographicState;
+exports.buildOrgPairState = buildOrgPairState;
+exports.choiceAnswerSchema = choiceAnswerSchema;
+exports.isLikelySameOrg = isLikelySameOrg;
+exports.noulAnswerSchema = noulAnswerSchema;
+exports.pickChoiceAboveFloor = pickChoiceAboveFloor;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/jev/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/jev/index.ts"],"names":["z"],"mappings":";;;;;AA+CO,IAAM,gBAAA,GAAmBA,MAAE,MAAA,CAAO;AAAA,EACvC,IAAA,EAAMA,KAAA,CAAE,OAAA,CAAQ,MAAM,CAAA;AAAA,EACtB,IAAA,EAAMA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC;AAC/B,CAAC;AAOM,IAAM,kBAAA,GAAqBA,MAAE,MAAA,CAAO;AAAA,EACzC,IAAA,EAAMA,KAAA,CAAE,OAAA,CAAQ,QAAQ,CAAA;AAAA,EACxB,MAAA,EAAQA,MAAE,MAAA,EAAO;AAAA,EACjB,UAAA,EAAYA,MAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,CAAC,CAAA;AAAA,EACnC,aAAA,EAAeA,MAAE,MAAA,CAAOA,KAAA,CAAE,QAAO,EAAGA,KAAA,CAAE,QAAQ;AAChD,CAAC;AAgBD,SAAS,QAA0B,GAAA,EAAoB;AACrD,EAAA,MAAM,MAAkB,EAAC;AACzB,EAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA,EAAG;AACxC,IAAA,IAAI,CAAA,KAAM,UAAa,CAAA,KAAM,IAAA,IAAQ,MAAM,EAAA,EAAI,GAAA,CAAI,CAAY,CAAA,GAAI,CAAA;AAAA,EACrE;AACA,EAAA,OAAO,GAAA;AACT;AAMO,SAAS,iBAAA,CACd,GACA,CAAA,EACkE;AAClE,EAAA,OAAO,EAAE,MAAM,OAAA,CAAQ,CAAC,GAAG,IAAA,EAAM,OAAA,CAAQ,CAAC,CAAA,EAAE;AAC9C;AAGO,IAAM,sBAAA,GAAuC;AAAA,EAClD,IAAA,EAAM,MAAA;AAAA,EACN,YAAA,EACE,6GAAA;AAAA,EACF,QAAA,EAAU;AAAA,IACR,IAAA,EAAM,8GAAA;AAAA,IACN,KAAA,EACE;AAAA;AAEN;AAMO,IAAM,kBAAA,GAAqB;AAG3B,SAAS,eAAA,CAAgB,IAAA,EAAc,SAAA,GAAoB,kBAAA,EAA6B;AAC7F,EAAA,OAAO,IAAA,IAAQ,SAAA;AACjB;AAOO,IAAM,iBAAA,GAA4C;AAAA,EACvD,UAAA,EAAY,qDAAA;AAAA,EACZ,OAAA,EAAS,qDAAA;AAAA,EACT,UAAA,EAAY,gDAAA;AAAA,EACZ,SAAA,EAAW,yCAAA;AAAA,EACX,aAAA,EAAe,wDAAA;AAAA,EACf,MAAA,EAAQ,sDAAA;AAAA,EACR,KAAA,EAAO,0DAAA;AAAA,EACP,MAAA,EAAQ,4CAAA;AAAA,EACR,YAAA,EAAc,sDAAA;AAAA,EACd,SAAA,EAAW,0CAAA;AAAA,EACX,qBAAA,EAAuB,0CAAA;AAAA,EACvB,aAAA,EAAe,4CAAA;AAAA,EACf,SAAA,EAAW,4CAAA;AAAA,EACX,WAAA,EAAa,yCAAA;AAAA,EACb,KAAA,EAAO;AACT;AAGO,IAAM,iBAAA,GAA4C;AAAA,EACvD,OAAA,EAAS,mCAAA;AAAA,EACT,SAAA,EAAW,wCAAA;AAAA,EACX,UAAA,EAAY,yCAAA;AAAA,EACZ,WAAA,EAAa,6CAAA;AAAA,EACb,MAAA,EAAQ,oDAAA;AAAA,EACR,KAAA,EAAO;AACT;AAGO,IAAM,kBAAA,GAA6C;AAAA,EACxD,IAAA,EAAM,UAAA;AAAA,EACN,KAAA,EAAO,gBAAA;AAAA,EACP,MAAA,EAAQ,iBAAA;AAAA,EACR,KAAA,EAAO,kBAAA;AAAA,EACP,UAAA,EAAY,sBAAA;AAAA,EACZ,OAAA,EAAS;AACX;AAEA,SAAS,cAAA,CAAe,cAAsB,QAAA,EAAkD;AAC9F,EAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,YAAA,EAAc,QAAA,EAAS;AAClD;AAEO,IAAM,wBAAA,GAA2B,cAAA;AAAA,EACtC,iFAAA;AAAA,EACA;AACF;AAEO,IAAM,wBAAA,GAA2B,cAAA;AAAA,EACtC,6EAAA;AAAA,EACA;AACF;AAEO,IAAM,yBAAA,GAA4B,cAAA;AAAA,EACvC,+EAAA;AAAA,EACA;AACF;AAUO,SAAS,uBAAuB,GAAA,EAAoD;AACzF,EAAA,OAAO,QAAQ,GAAG,CAAA;AACpB;AAMO,IAAM,6BAAA,GAAgC;AAOtC,SAAS,oBAAA,CACd,MAAA,EACA,IAAA,GAA6C,EAAC,EAC/B;AACf,EAAA,MAAM,KAAA,GAAQ,KAAK,KAAA,IAAS,6BAAA;AAC5B,EAAA,IAAI,MAAA,CAAO,UAAA,GAAa,KAAA,EAAO,OAAO,IAAA;AACtC,EAAA,IAAI,KAAK,OAAA,KAAY,MAAA,IAAa,OAAO,MAAA,KAAW,IAAA,CAAK,SAAS,OAAO,IAAA;AACzE,EAAA,OAAO,MAAA,CAAO,MAAA;AAChB","file":"index.cjs","sourcesContent":["/**\n * `@singi-labs/sifa-sdk/jev` -- TypeSafe System One (Jev) question builders,\n * taxonomies, result schemas, and threshold predicates for Sifa's organisation\n * intelligence.\n *\n * This subpath is pure: it defines the typed *questions* to ask Jev, validates\n * the *answers*, and holds the policy constants (thresholds, taxonomies) that\n * turn a raw judgment into a decision. It performs no network calls and needs\n * no API key, so it is safe to import anywhere. The actual `systemOne` call\n * lives server-side in sifa-api, which passes an API key that must never reach\n * the browser.\n *\n * Judgment shapes:\n * - Duplicate-org detection: a single Noul over a candidate pair.\n * - Firmographic classification: independent Choice questions (industry, type,\n *   size) asked together over one org's state.\n *\n * See docs.typesafe.ai for the wire contract. Typed output guarantees the\n * interface, not truth: validate thresholds on labelled Sifa data before\n * enabling any write.\n */\n\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// Wire question types\n// ---------------------------------------------------------------------------\n\n/** A yes/no judgment. `criteria` clarifies what true vs false means. */\nexport interface NoulQuestion {\n  type: 'noul';\n  instructions: string;\n  criteria?: { true: string; false: string };\n}\n\n/** A single-selection judgment. `criteria` maps each option to its description. */\nexport interface ChoiceQuestion {\n  type: 'choice';\n  instructions: string;\n  criteria: Record<string, string>;\n}\n\n// ---------------------------------------------------------------------------\n// Answer schemas (validate Jev's response before code trusts it)\n// ---------------------------------------------------------------------------\n\n/** Jev's Noul answer: `noul` is the probability that the answer is yes (0..1). */\nexport const noulAnswerSchema = z.object({\n  type: z.literal('noul'),\n  noul: z.number().min(0).max(1),\n});\nexport type NoulAnswer = z.infer<typeof noulAnswerSchema>;\n\n/**\n * Jev's Choice answer: `choice` is the highest-probability option, `confidence`\n * summarises how concentrated the distribution is, `probabilities` sums to 1.\n */\nexport const choiceAnswerSchema = z.object({\n  type: z.literal('choice'),\n  choice: z.string(),\n  confidence: z.number().min(0).max(1),\n  probabilities: z.record(z.string(), z.number()),\n});\nexport type ChoiceAnswer = z.infer<typeof choiceAnswerSchema>;\n\n// ---------------------------------------------------------------------------\n// Duplicate-org detection (Noul) -- ticket #560\n// ---------------------------------------------------------------------------\n\n/** Public, non-user fields we compare when judging whether two orgs are the same. */\nexport interface OrgRecordInput {\n  name: string;\n  domain?: string;\n  location?: string;\n  description?: string;\n}\n\n/** Build a plain object with only the defined keys (Jev sees no `undefined`). */\nfunction compact<T extends object>(obj: T): Partial<T> {\n  const out: Partial<T> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (v !== undefined && v !== null && v !== '') out[k as keyof T] = v as T[keyof T];\n  }\n  return out;\n}\n\n/**\n * State for the org-pair judgment. Both records live under stable named fields\n * so the question can reference them unambiguously.\n */\nexport function buildOrgPairState(\n  a: OrgRecordInput,\n  b: OrgRecordInput,\n): { orgA: Partial<OrgRecordInput>; orgB: Partial<OrgRecordInput> } {\n  return { orgA: compact(a), orgB: compact(b) };\n}\n\n/** Static Noul question paired with {@link buildOrgPairState}. */\nexport const ORG_PAIR_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'The state holds two organisation records, orgA and orgB. Do they refer to the same real-world organisation?',\n  criteria: {\n    true: 'Same organisation, e.g. a legal-suffix or abbreviation variant of the same name, or the same primary domain.',\n    false:\n      'Distinct organisations, e.g. a shared word in the name but different domains, locations, or lines of business.',\n  },\n};\n\n/**\n * Threshold favouring precision: a wrong merge is worse than a missed one.\n * Validate on labelled pairs (ticket #560) before enabling merges in prod.\n */\nexport const SAME_ORG_THRESHOLD = 0.85;\n\n/** True when the Noul probability clears the merge threshold. */\nexport function isLikelySameOrg(noul: number, threshold: number = SAME_ORG_THRESHOLD): boolean {\n  return noul >= threshold;\n}\n\n// ---------------------------------------------------------------------------\n// Firmographic classification (Choice) -- ticket #561\n// ---------------------------------------------------------------------------\n\n/** Industry taxonomy. Single source of truth; `other` is the no-match option. */\nexport const INDUSTRY_TAXONOMY: Record<string, string> = {\n  technology: 'Software, IT services, internet, hardware, telecoms',\n  finance: 'Banking, insurance, investment, fintech, accounting',\n  healthcare: 'Medical care, pharma, biotech, health services',\n  education: 'Schools, universities, training, edtech',\n  manufacturing: 'Industrial production, hardware, materials, automotive',\n  retail: 'Retail, ecommerce, consumer goods, hospitality, food',\n  media: 'Media, publishing, entertainment, marketing, advertising',\n  energy: 'Energy, utilities, oil and gas, renewables',\n  construction: 'Construction, real estate, architecture, engineering',\n  transport: 'Transport, logistics, shipping, aviation',\n  professional_services: 'Legal, consulting, HR, business services',\n  public_sector: 'Government, defence, public administration',\n  nonprofit: 'Charities, NGOs, foundations, associations',\n  agriculture: 'Agriculture, farming, fishing, forestry',\n  other: 'None of the above, or not enough information to decide',\n};\n\n/** Organisation type taxonomy; `other` is the no-match option. */\nexport const ORG_TYPE_TAXONOMY: Record<string, string> = {\n  company: 'For-profit company or corporation',\n  nonprofit: 'Nonprofit, charity, NGO, or foundation',\n  government: 'Government body or public-sector entity',\n  educational: 'School, university, or research institution',\n  agency: 'Agency, consultancy, or professional-services firm',\n  other: 'None of the above, or not enough information to decide',\n};\n\n/** Ordered employee-size bands; `unknown` is the no-match option. */\nexport const SIZE_BAND_TAXONOMY: Record<string, string> = {\n  solo: '1 person',\n  small: '2 to 10 people',\n  medium: '11 to 50 people',\n  large: '51 to 250 people',\n  enterprise: 'More than 250 people',\n  unknown: 'Not enough information to decide',\n};\n\nfunction choiceQuestion(instructions: string, criteria: Record<string, string>): ChoiceQuestion {\n  return { type: 'choice', instructions, criteria };\n}\n\nexport const INDUSTRY_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which single industry best describes this organisation?',\n  INDUSTRY_TAXONOMY,\n);\n\nexport const ORG_TYPE_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which single type best describes this organisation?',\n  ORG_TYPE_TAXONOMY,\n);\n\nexport const SIZE_BAND_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which employee-size band best fits this organisation?',\n  SIZE_BAND_TAXONOMY,\n);\n\n/** Input for firmographic classification. Enrichment text is the primary evidence. */\nexport interface FirmographicInput {\n  name: string;\n  domain?: string;\n  enrichmentText: string;\n}\n\n/** State for the firmographic questions. */\nexport function buildFirmographicState(org: FirmographicInput): Partial<FirmographicInput> {\n  return compact(org);\n}\n\n/**\n * Below this confidence a firmographic field is left unset rather than guessed.\n * Validate per field on labelled orgs (ticket #561).\n */\nexport const FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;\n\n/**\n * Select the classified option, or `null` to leave the field unset. Returns\n * null when confidence is below the floor, or when the selected option is the\n * taxonomy's no-match option.\n */\nexport function pickChoiceAboveFloor(\n  answer: ChoiceAnswer,\n  opts: { floor?: number; noMatch?: string } = {},\n): string | null {\n  const floor = opts.floor ?? FIRMOGRAPHIC_CONFIDENCE_FLOOR;\n  if (answer.confidence < floor) return null;\n  if (opts.noMatch !== undefined && answer.choice === opts.noMatch) return null;\n  return answer.choice;\n}\n"]}

package/dist/jev/index.d.cts

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+
+/**
+ * `@singi-labs/sifa-sdk/jev` -- TypeSafe System One (Jev) question builders,
+ * taxonomies, result schemas, and threshold predicates for Sifa's organisation
+ * intelligence.
+ *
+ * This subpath is pure: it defines the typed *questions* to ask Jev, validates
+ * the *answers*, and holds the policy constants (thresholds, taxonomies) that
+ * turn a raw judgment into a decision. It performs no network calls and needs
+ * no API key, so it is safe to import anywhere. The actual `systemOne` call
+ * lives server-side in sifa-api, which passes an API key that must never reach
+ * the browser.
+ *
+ * Judgment shapes:
+ * - Duplicate-org detection: a single Noul over a candidate pair.
+ * - Firmographic classification: independent Choice questions (industry, type,
+ *   size) asked together over one org's state.
+ *
+ * See docs.typesafe.ai for the wire contract. Typed output guarantees the
+ * interface, not truth: validate thresholds on labelled Sifa data before
+ * enabling any write.
+ */
+
+/** A yes/no judgment. `criteria` clarifies what true vs false means. */
+interface NoulQuestion {
+    type: 'noul';
+    instructions: string;
+    criteria?: {
+        true: string;
+        false: string;
+    };
+}
+/** A single-selection judgment. `criteria` maps each option to its description. */
+interface ChoiceQuestion {
+    type: 'choice';
+    instructions: string;
+    criteria: Record<string, string>;
+}
+/** Jev's Noul answer: `noul` is the probability that the answer is yes (0..1). */
+declare const noulAnswerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"noul">;
+    noul: z.ZodNumber;
+}, z.core.$strip>;
+type NoulAnswer = z.infer<typeof noulAnswerSchema>;
+/**
+ * Jev's Choice answer: `choice` is the highest-probability option, `confidence`
+ * summarises how concentrated the distribution is, `probabilities` sums to 1.
+ */
+declare const choiceAnswerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"choice">;
+    choice: z.ZodString;
+    confidence: z.ZodNumber;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+type ChoiceAnswer = z.infer<typeof choiceAnswerSchema>;
+/** Public, non-user fields we compare when judging whether two orgs are the same. */
+interface OrgRecordInput {
+    name: string;
+    domain?: string;
+    location?: string;
+    description?: string;
+}
+/**
+ * State for the org-pair judgment. Both records live under stable named fields
+ * so the question can reference them unambiguously.
+ */
+declare function buildOrgPairState(a: OrgRecordInput, b: OrgRecordInput): {
+    orgA: Partial<OrgRecordInput>;
+    orgB: Partial<OrgRecordInput>;
+};
+/** Static Noul question paired with {@link buildOrgPairState}. */
+declare const ORG_PAIR_NOUL_QUESTION: NoulQuestion;
+/**
+ * Threshold favouring precision: a wrong merge is worse than a missed one.
+ * Validate on labelled pairs (ticket #560) before enabling merges in prod.
+ */
+declare const SAME_ORG_THRESHOLD = 0.85;
+/** True when the Noul probability clears the merge threshold. */
+declare function isLikelySameOrg(noul: number, threshold?: number): boolean;
+/** Industry taxonomy. Single source of truth; `other` is the no-match option. */
+declare const INDUSTRY_TAXONOMY: Record<string, string>;
+/** Organisation type taxonomy; `other` is the no-match option. */
+declare const ORG_TYPE_TAXONOMY: Record<string, string>;
+/** Ordered employee-size bands; `unknown` is the no-match option. */
+declare const SIZE_BAND_TAXONOMY: Record<string, string>;
+declare const INDUSTRY_CHOICE_QUESTION: ChoiceQuestion;
+declare const ORG_TYPE_CHOICE_QUESTION: ChoiceQuestion;
+declare const SIZE_BAND_CHOICE_QUESTION: ChoiceQuestion;
+/** Input for firmographic classification. Enrichment text is the primary evidence. */
+interface FirmographicInput {
+    name: string;
+    domain?: string;
+    enrichmentText: string;
+}
+/** State for the firmographic questions. */
+declare function buildFirmographicState(org: FirmographicInput): Partial<FirmographicInput>;
+/**
+ * Below this confidence a firmographic field is left unset rather than guessed.
+ * Validate per field on labelled orgs (ticket #561).
+ */
+declare const FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;
+/**
+ * Select the classified option, or `null` to leave the field unset. Returns
+ * null when confidence is below the floor, or when the selected option is the
+ * taxonomy's no-match option.
+ */
+declare function pickChoiceAboveFloor(answer: ChoiceAnswer, opts?: {
+    floor?: number;
+    noMatch?: string;
+}): string | null;
+
+export { type ChoiceAnswer, type ChoiceQuestion, FIRMOGRAPHIC_CONFIDENCE_FLOOR, type FirmographicInput, INDUSTRY_CHOICE_QUESTION, INDUSTRY_TAXONOMY, type NoulAnswer, type NoulQuestion, ORG_PAIR_NOUL_QUESTION, ORG_TYPE_CHOICE_QUESTION, ORG_TYPE_TAXONOMY, type OrgRecordInput, SAME_ORG_THRESHOLD, SIZE_BAND_CHOICE_QUESTION, SIZE_BAND_TAXONOMY, buildFirmographicState, buildOrgPairState, choiceAnswerSchema, isLikelySameOrg, noulAnswerSchema, pickChoiceAboveFloor };

package/dist/jev/index.d.ts

@@ -0,0 +1,113 @@
+import { z } from 'zod';
+
+/**
+ * `@singi-labs/sifa-sdk/jev` -- TypeSafe System One (Jev) question builders,
+ * taxonomies, result schemas, and threshold predicates for Sifa's organisation
+ * intelligence.
+ *
+ * This subpath is pure: it defines the typed *questions* to ask Jev, validates
+ * the *answers*, and holds the policy constants (thresholds, taxonomies) that
+ * turn a raw judgment into a decision. It performs no network calls and needs
+ * no API key, so it is safe to import anywhere. The actual `systemOne` call
+ * lives server-side in sifa-api, which passes an API key that must never reach
+ * the browser.
+ *
+ * Judgment shapes:
+ * - Duplicate-org detection: a single Noul over a candidate pair.
+ * - Firmographic classification: independent Choice questions (industry, type,
+ *   size) asked together over one org's state.
+ *
+ * See docs.typesafe.ai for the wire contract. Typed output guarantees the
+ * interface, not truth: validate thresholds on labelled Sifa data before
+ * enabling any write.
+ */
+
+/** A yes/no judgment. `criteria` clarifies what true vs false means. */
+interface NoulQuestion {
+    type: 'noul';
+    instructions: string;
+    criteria?: {
+        true: string;
+        false: string;
+    };
+}
+/** A single-selection judgment. `criteria` maps each option to its description. */
+interface ChoiceQuestion {
+    type: 'choice';
+    instructions: string;
+    criteria: Record<string, string>;
+}
+/** Jev's Noul answer: `noul` is the probability that the answer is yes (0..1). */
+declare const noulAnswerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"noul">;
+    noul: z.ZodNumber;
+}, z.core.$strip>;
+type NoulAnswer = z.infer<typeof noulAnswerSchema>;
+/**
+ * Jev's Choice answer: `choice` is the highest-probability option, `confidence`
+ * summarises how concentrated the distribution is, `probabilities` sums to 1.
+ */
+declare const choiceAnswerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"choice">;
+    choice: z.ZodString;
+    confidence: z.ZodNumber;
+    probabilities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+}, z.core.$strip>;
+type ChoiceAnswer = z.infer<typeof choiceAnswerSchema>;
+/** Public, non-user fields we compare when judging whether two orgs are the same. */
+interface OrgRecordInput {
+    name: string;
+    domain?: string;
+    location?: string;
+    description?: string;
+}
+/**
+ * State for the org-pair judgment. Both records live under stable named fields
+ * so the question can reference them unambiguously.
+ */
+declare function buildOrgPairState(a: OrgRecordInput, b: OrgRecordInput): {
+    orgA: Partial<OrgRecordInput>;
+    orgB: Partial<OrgRecordInput>;
+};
+/** Static Noul question paired with {@link buildOrgPairState}. */
+declare const ORG_PAIR_NOUL_QUESTION: NoulQuestion;
+/**
+ * Threshold favouring precision: a wrong merge is worse than a missed one.
+ * Validate on labelled pairs (ticket #560) before enabling merges in prod.
+ */
+declare const SAME_ORG_THRESHOLD = 0.85;
+/** True when the Noul probability clears the merge threshold. */
+declare function isLikelySameOrg(noul: number, threshold?: number): boolean;
+/** Industry taxonomy. Single source of truth; `other` is the no-match option. */
+declare const INDUSTRY_TAXONOMY: Record<string, string>;
+/** Organisation type taxonomy; `other` is the no-match option. */
+declare const ORG_TYPE_TAXONOMY: Record<string, string>;
+/** Ordered employee-size bands; `unknown` is the no-match option. */
+declare const SIZE_BAND_TAXONOMY: Record<string, string>;
+declare const INDUSTRY_CHOICE_QUESTION: ChoiceQuestion;
+declare const ORG_TYPE_CHOICE_QUESTION: ChoiceQuestion;
+declare const SIZE_BAND_CHOICE_QUESTION: ChoiceQuestion;
+/** Input for firmographic classification. Enrichment text is the primary evidence. */
+interface FirmographicInput {
+    name: string;
+    domain?: string;
+    enrichmentText: string;
+}
+/** State for the firmographic questions. */
+declare function buildFirmographicState(org: FirmographicInput): Partial<FirmographicInput>;
+/**
+ * Below this confidence a firmographic field is left unset rather than guessed.
+ * Validate per field on labelled orgs (ticket #561).
+ */
+declare const FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;
+/**
+ * Select the classified option, or `null` to leave the field unset. Returns
+ * null when confidence is below the floor, or when the selected option is the
+ * taxonomy's no-match option.
+ */
+declare function pickChoiceAboveFloor(answer: ChoiceAnswer, opts?: {
+    floor?: number;
+    noMatch?: string;
+}): string | null;
+
+export { type ChoiceAnswer, type ChoiceQuestion, FIRMOGRAPHIC_CONFIDENCE_FLOOR, type FirmographicInput, INDUSTRY_CHOICE_QUESTION, INDUSTRY_TAXONOMY, type NoulAnswer, type NoulQuestion, ORG_PAIR_NOUL_QUESTION, ORG_TYPE_CHOICE_QUESTION, ORG_TYPE_TAXONOMY, type OrgRecordInput, SAME_ORG_THRESHOLD, SIZE_BAND_CHOICE_QUESTION, SIZE_BAND_TAXONOMY, buildFirmographicState, buildOrgPairState, choiceAnswerSchema, isLikelySameOrg, noulAnswerSchema, pickChoiceAboveFloor };

package/dist/jev/index.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+
+// src/jev/index.ts
+var noulAnswerSchema = z.object({
+  type: z.literal("noul"),
+  noul: z.number().min(0).max(1)
+});
+var choiceAnswerSchema = z.object({
+  type: z.literal("choice"),
+  choice: z.string(),
+  confidence: z.number().min(0).max(1),
+  probabilities: z.record(z.string(), z.number())
+});
+function compact(obj) {
+  const out = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (v !== void 0 && v !== null && v !== "") out[k] = v;
+  }
+  return out;
+}
+function buildOrgPairState(a, b) {
+  return { orgA: compact(a), orgB: compact(b) };
+}
+var ORG_PAIR_NOUL_QUESTION = {
+  type: "noul",
+  instructions: "The state holds two organisation records, orgA and orgB. Do they refer to the same real-world organisation?",
+  criteria: {
+    true: "Same organisation, e.g. a legal-suffix or abbreviation variant of the same name, or the same primary domain.",
+    false: "Distinct organisations, e.g. a shared word in the name but different domains, locations, or lines of business."
+  }
+};
+var SAME_ORG_THRESHOLD = 0.85;
+function isLikelySameOrg(noul, threshold = SAME_ORG_THRESHOLD) {
+  return noul >= threshold;
+}
+var INDUSTRY_TAXONOMY = {
+  technology: "Software, IT services, internet, hardware, telecoms",
+  finance: "Banking, insurance, investment, fintech, accounting",
+  healthcare: "Medical care, pharma, biotech, health services",
+  education: "Schools, universities, training, edtech",
+  manufacturing: "Industrial production, hardware, materials, automotive",
+  retail: "Retail, ecommerce, consumer goods, hospitality, food",
+  media: "Media, publishing, entertainment, marketing, advertising",
+  energy: "Energy, utilities, oil and gas, renewables",
+  construction: "Construction, real estate, architecture, engineering",
+  transport: "Transport, logistics, shipping, aviation",
+  professional_services: "Legal, consulting, HR, business services",
+  public_sector: "Government, defence, public administration",
+  nonprofit: "Charities, NGOs, foundations, associations",
+  agriculture: "Agriculture, farming, fishing, forestry",
+  other: "None of the above, or not enough information to decide"
+};
+var ORG_TYPE_TAXONOMY = {
+  company: "For-profit company or corporation",
+  nonprofit: "Nonprofit, charity, NGO, or foundation",
+  government: "Government body or public-sector entity",
+  educational: "School, university, or research institution",
+  agency: "Agency, consultancy, or professional-services firm",
+  other: "None of the above, or not enough information to decide"
+};
+var SIZE_BAND_TAXONOMY = {
+  solo: "1 person",
+  small: "2 to 10 people",
+  medium: "11 to 50 people",
+  large: "51 to 250 people",
+  enterprise: "More than 250 people",
+  unknown: "Not enough information to decide"
+};
+function choiceQuestion(instructions, criteria) {
+  return { type: "choice", instructions, criteria };
+}
+var INDUSTRY_CHOICE_QUESTION = choiceQuestion(
+  "Based on the org state, which single industry best describes this organisation?",
+  INDUSTRY_TAXONOMY
+);
+var ORG_TYPE_CHOICE_QUESTION = choiceQuestion(
+  "Based on the org state, which single type best describes this organisation?",
+  ORG_TYPE_TAXONOMY
+);
+var SIZE_BAND_CHOICE_QUESTION = choiceQuestion(
+  "Based on the org state, which employee-size band best fits this organisation?",
+  SIZE_BAND_TAXONOMY
+);
+function buildFirmographicState(org) {
+  return compact(org);
+}
+var FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;
+function pickChoiceAboveFloor(answer, opts = {}) {
+  const floor = opts.floor ?? FIRMOGRAPHIC_CONFIDENCE_FLOOR;
+  if (answer.confidence < floor) return null;
+  if (opts.noMatch !== void 0 && answer.choice === opts.noMatch) return null;
+  return answer.choice;
+}
+
+export { FIRMOGRAPHIC_CONFIDENCE_FLOOR, INDUSTRY_CHOICE_QUESTION, INDUSTRY_TAXONOMY, ORG_PAIR_NOUL_QUESTION, ORG_TYPE_CHOICE_QUESTION, ORG_TYPE_TAXONOMY, SAME_ORG_THRESHOLD, SIZE_BAND_CHOICE_QUESTION, SIZE_BAND_TAXONOMY, buildFirmographicState, buildOrgPairState, choiceAnswerSchema, isLikelySameOrg, noulAnswerSchema, pickChoiceAboveFloor };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/jev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/jev/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * `@singi-labs/sifa-sdk/jev` -- TypeSafe System One (Jev) question builders,\n * taxonomies, result schemas, and threshold predicates for Sifa's organisation\n * intelligence.\n *\n * This subpath is pure: it defines the typed *questions* to ask Jev, validates\n * the *answers*, and holds the policy constants (thresholds, taxonomies) that\n * turn a raw judgment into a decision. It performs no network calls and needs\n * no API key, so it is safe to import anywhere. The actual `systemOne` call\n * lives server-side in sifa-api, which passes an API key that must never reach\n * the browser.\n *\n * Judgment shapes:\n * - Duplicate-org detection: a single Noul over a candidate pair.\n * - Firmographic classification: independent Choice questions (industry, type,\n *   size) asked together over one org's state.\n *\n * See docs.typesafe.ai for the wire contract. Typed output guarantees the\n * interface, not truth: validate thresholds on labelled Sifa data before\n * enabling any write.\n */\n\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// Wire question types\n// ---------------------------------------------------------------------------\n\n/** A yes/no judgment. `criteria` clarifies what true vs false means. */\nexport interface NoulQuestion {\n  type: 'noul';\n  instructions: string;\n  criteria?: { true: string; false: string };\n}\n\n/** A single-selection judgment. `criteria` maps each option to its description. */\nexport interface ChoiceQuestion {\n  type: 'choice';\n  instructions: string;\n  criteria: Record<string, string>;\n}\n\n// ---------------------------------------------------------------------------\n// Answer schemas (validate Jev's response before code trusts it)\n// ---------------------------------------------------------------------------\n\n/** Jev's Noul answer: `noul` is the probability that the answer is yes (0..1). */\nexport const noulAnswerSchema = z.object({\n  type: z.literal('noul'),\n  noul: z.number().min(0).max(1),\n});\nexport type NoulAnswer = z.infer<typeof noulAnswerSchema>;\n\n/**\n * Jev's Choice answer: `choice` is the highest-probability option, `confidence`\n * summarises how concentrated the distribution is, `probabilities` sums to 1.\n */\nexport const choiceAnswerSchema = z.object({\n  type: z.literal('choice'),\n  choice: z.string(),\n  confidence: z.number().min(0).max(1),\n  probabilities: z.record(z.string(), z.number()),\n});\nexport type ChoiceAnswer = z.infer<typeof choiceAnswerSchema>;\n\n// ---------------------------------------------------------------------------\n// Duplicate-org detection (Noul) -- ticket #560\n// ---------------------------------------------------------------------------\n\n/** Public, non-user fields we compare when judging whether two orgs are the same. */\nexport interface OrgRecordInput {\n  name: string;\n  domain?: string;\n  location?: string;\n  description?: string;\n}\n\n/** Build a plain object with only the defined keys (Jev sees no `undefined`). */\nfunction compact<T extends object>(obj: T): Partial<T> {\n  const out: Partial<T> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (v !== undefined && v !== null && v !== '') out[k as keyof T] = v as T[keyof T];\n  }\n  return out;\n}\n\n/**\n * State for the org-pair judgment. Both records live under stable named fields\n * so the question can reference them unambiguously.\n */\nexport function buildOrgPairState(\n  a: OrgRecordInput,\n  b: OrgRecordInput,\n): { orgA: Partial<OrgRecordInput>; orgB: Partial<OrgRecordInput> } {\n  return { orgA: compact(a), orgB: compact(b) };\n}\n\n/** Static Noul question paired with {@link buildOrgPairState}. */\nexport const ORG_PAIR_NOUL_QUESTION: NoulQuestion = {\n  type: 'noul',\n  instructions:\n    'The state holds two organisation records, orgA and orgB. Do they refer to the same real-world organisation?',\n  criteria: {\n    true: 'Same organisation, e.g. a legal-suffix or abbreviation variant of the same name, or the same primary domain.',\n    false:\n      'Distinct organisations, e.g. a shared word in the name but different domains, locations, or lines of business.',\n  },\n};\n\n/**\n * Threshold favouring precision: a wrong merge is worse than a missed one.\n * Validate on labelled pairs (ticket #560) before enabling merges in prod.\n */\nexport const SAME_ORG_THRESHOLD = 0.85;\n\n/** True when the Noul probability clears the merge threshold. */\nexport function isLikelySameOrg(noul: number, threshold: number = SAME_ORG_THRESHOLD): boolean {\n  return noul >= threshold;\n}\n\n// ---------------------------------------------------------------------------\n// Firmographic classification (Choice) -- ticket #561\n// ---------------------------------------------------------------------------\n\n/** Industry taxonomy. Single source of truth; `other` is the no-match option. */\nexport const INDUSTRY_TAXONOMY: Record<string, string> = {\n  technology: 'Software, IT services, internet, hardware, telecoms',\n  finance: 'Banking, insurance, investment, fintech, accounting',\n  healthcare: 'Medical care, pharma, biotech, health services',\n  education: 'Schools, universities, training, edtech',\n  manufacturing: 'Industrial production, hardware, materials, automotive',\n  retail: 'Retail, ecommerce, consumer goods, hospitality, food',\n  media: 'Media, publishing, entertainment, marketing, advertising',\n  energy: 'Energy, utilities, oil and gas, renewables',\n  construction: 'Construction, real estate, architecture, engineering',\n  transport: 'Transport, logistics, shipping, aviation',\n  professional_services: 'Legal, consulting, HR, business services',\n  public_sector: 'Government, defence, public administration',\n  nonprofit: 'Charities, NGOs, foundations, associations',\n  agriculture: 'Agriculture, farming, fishing, forestry',\n  other: 'None of the above, or not enough information to decide',\n};\n\n/** Organisation type taxonomy; `other` is the no-match option. */\nexport const ORG_TYPE_TAXONOMY: Record<string, string> = {\n  company: 'For-profit company or corporation',\n  nonprofit: 'Nonprofit, charity, NGO, or foundation',\n  government: 'Government body or public-sector entity',\n  educational: 'School, university, or research institution',\n  agency: 'Agency, consultancy, or professional-services firm',\n  other: 'None of the above, or not enough information to decide',\n};\n\n/** Ordered employee-size bands; `unknown` is the no-match option. */\nexport const SIZE_BAND_TAXONOMY: Record<string, string> = {\n  solo: '1 person',\n  small: '2 to 10 people',\n  medium: '11 to 50 people',\n  large: '51 to 250 people',\n  enterprise: 'More than 250 people',\n  unknown: 'Not enough information to decide',\n};\n\nfunction choiceQuestion(instructions: string, criteria: Record<string, string>): ChoiceQuestion {\n  return { type: 'choice', instructions, criteria };\n}\n\nexport const INDUSTRY_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which single industry best describes this organisation?',\n  INDUSTRY_TAXONOMY,\n);\n\nexport const ORG_TYPE_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which single type best describes this organisation?',\n  ORG_TYPE_TAXONOMY,\n);\n\nexport const SIZE_BAND_CHOICE_QUESTION = choiceQuestion(\n  'Based on the org state, which employee-size band best fits this organisation?',\n  SIZE_BAND_TAXONOMY,\n);\n\n/** Input for firmographic classification. Enrichment text is the primary evidence. */\nexport interface FirmographicInput {\n  name: string;\n  domain?: string;\n  enrichmentText: string;\n}\n\n/** State for the firmographic questions. */\nexport function buildFirmographicState(org: FirmographicInput): Partial<FirmographicInput> {\n  return compact(org);\n}\n\n/**\n * Below this confidence a firmographic field is left unset rather than guessed.\n * Validate per field on labelled orgs (ticket #561).\n */\nexport const FIRMOGRAPHIC_CONFIDENCE_FLOOR = 0.6;\n\n/**\n * Select the classified option, or `null` to leave the field unset. Returns\n * null when confidence is below the floor, or when the selected option is the\n * taxonomy's no-match option.\n */\nexport function pickChoiceAboveFloor(\n  answer: ChoiceAnswer,\n  opts: { floor?: number; noMatch?: string } = {},\n): string | null {\n  const floor = opts.floor ?? FIRMOGRAPHIC_CONFIDENCE_FLOOR;\n  if (answer.confidence < floor) return null;\n  if (opts.noMatch !== undefined && answer.choice === opts.noMatch) return null;\n  return answer.choice;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@singi-labs/sifa-sdk",
-  "version": "0.19.23",
+  "version": "0.19.24",
   "description": "Sifa SDK — public client library for the Sifa AppView on AT Protocol. Shared by sifa-web and sifa-app.",
   "license": "MIT",
   "type": "module",
@@ -162,6 +162,16 @@
         "default": "./dist/resume/index.cjs"
       }
     },
+    "./jev": {
+      "import": {
+        "types": "./dist/jev/index.d.ts",
+        "default": "./dist/jev/index.js"
+      },
+      "require": {
+        "types": "./dist/jev/index.d.cts",
+        "default": "./dist/jev/index.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.cjs",