@far-world-labs/verblets 0.6.0 → 0.6.3

package/README.md

@@ -6,6 +6,49 @@ Instead of mimicking humans in order to automate tasks, an AI standard library *
 
 Why the name? Verblets are *verbally* based: they're LLM-powered; and you can think of functions as verbs.
 
+## Install
+
+```sh
+npm install @far-world-labs/verblets
+```
+
+Set an API key as an environment variable — either works:
+
+```sh
+export OPENAI_API_KEY=sk-...
+# or
+export ANTHROPIC_API_KEY=sk-ant-...
+```
+
+Or use a `.env` file in your project root (loaded automatically via dotenv).
+
+Then initialize and call a function:
+
+```js
+import { init, score } from '@far-world-labs/verblets';
+
+init();
+
+const results = await score(
+  ['reliability', 'performance', 'ease of use'],
+  'Rate each quality for a bicycle',
+);
+```
+
+`init()` validates that an API key is present and sets up internal services. Call it once at startup. It accepts optional configuration:
+
+```js
+init({
+  embed: true,            // enable local embedding model
+  redis: redisClient,     // pre-configured Redis client for caching
+  modelOverrides: {       // override default model selection
+    modelName: 'claude-sonnet-4-20250514',
+  },
+});
+```
+
+Without Redis, caching is disabled and the library operates statelessly.
+
 ## Repository Guide
 
 ### Quick Links

package/dist/index.browser.js

@@ -1,5 +1,5 @@
-import { cC as a } from "./shared-CX9VHytb.js";
-import { cz as i, F as r, C as c, G as n, aQ as o, D as l, E as b, ao as p, Q as u, bg as m, bj as g, c1 as d, bx as S, c0 as I, $ as T, A as y, a8 as h, _ as R, b6 as v, o as C, au as f, aE as E, bv as F, f as M, aN as B, a5 as N, y as P, z as x, aM as A, bt as O, a1 as L, a2 as k, ch as w, bW as D, i as G, aO as z, bU as U, aP as V, ci as W, bl as _, cB as q, e as Q, aR as Y, cj as j, bY as K, B as J, H as X, a9 as H, c as Z, b7 as $, p as aa, aF as sa, aG as ea, R as ta, g as ia, bX as ra, a as ca, O as na, a3 as oa, a4 as la, ap as ba, aS as pa, aU as ua, aW as ma, aX as ga, bD as da, bS as Sa, bE as Ia, bQ as Ta, bF as ya, bR as ha, bK as Ra, bP as va, bO as Ca, bJ as fa, bN as Ea, bI as Fa, bT as Ma, bL as Ba, bM as Na, bG as Pa, a6 as xa, ab as Aa, ad as Oa, ae as La, aa as ka, ac as wa, a7 as Da, Y as Ga, Z as za, S as Ua, bw as Va, af as Wa, c8 as _a, aY as qa, ag as Qa, aZ as Ya, ah as ja, am as Ka, cy as Ja, aT as Xa, K as Ha, L as Za, M as $a, ai as as, aj as ss, cA as es, by as ts, ak as is, a_ as rs, ck as cs, al as ns, an as os, aq as ls, a as bs, bz as ps, bA as us, ar as ms, a$ as gs, b0 as ds, n as Ss, bZ as Is, h as Ts, k as ys, I as hs, J as Rs, cl as vs, b_ as Cs, b$ as fs, cg as Es, b8 as Fs, b9 as Ms, b1 as Bs, bA as Ns, cm as Ps, cs as xs, b2 as As, x as Os, cv as Ls, cw as ks, ct as ws, b3 as Ds, bV as Gs, r as zs, b5 as Us, b4 as Vs, bb as Ws, bd as _s, be as qs, ba as Qs, bc as Ys, cx as js, d as Ks, c3 as Js, l as Xs, t as Hs, v as Zs, w as $s, q as ae, u as se, m as ee, bf as te, cu as ie, bs as re, c4 as ce, as as ne, ax as oe, az as le, aA as be, av as pe, aw as ue, ay as me, at as ge, bB as de, s as Se, bH as Ie, bC as Te, cr as ye, aV as he, bh as Re, bu as ve, aB as Ce, cn as fe, bi as Ee, ca as Fe, c9 as Me, a0 as Be, aD as Ne, bk as Pe, aC as xe, aI as Ae, aK as Oe, aL as Le, aH as ke, aJ as we, U as De, V as Ge, T as ze, X as Ue, c2 as Ve, bm as We, bn as _e, cb as qe, cd as Qe, ce as Ye, cc as je, cf as Ke, bo as Je, bp as Xe, co as He, W as Ze, P as $e, cp as at, br as st, bq as et, c5 as tt, c6 as it, c7 as rt, N as ct, cq as nt } from "./shared-CX9VHytb.js";
+import { cM as a } from "./shared-BSAzZOFX.js";
+import { cJ as i, P as r, L as c, R as n, aY as o, N as l, M as b, aw as p, Q as u, bo as m, br as g, cc as d, bI as I, bD as S, bE as T, cb as y, a7 as h, J as R, ag as v, a6 as C, be as E, z as f, aC as M, aM as F, bG as P, p as B, aV as L, bF as N, ad as x, H as A, I as O, aU as k, bB as w, a9 as D, aa as G, cr as z, c5 as V, t as U, aW as W, c3 as _, aX as q, cs as K, bt as Q, cL as Y, m as j, aZ as J, ct as H, c7 as X, K as Z, S as $, ah as aa, c as sa, bf as ea, A as ta, aN as ia, aO as ra, Z as ca, q as na, c6 as oa, r as la, X as ba, ab as pa, ac as ua, ax as ma, a_ as ga, b0 as da, b2 as Ia, b3 as Sa, bO as Ta, c1 as ya, bP as ha, b$ as Ra, bQ as va, c0 as Ca, bV as Ea, b_ as fa, bZ as Ma, bU as Fa, bY as Pa, bT as Ba, c2 as La, bW as Na, bX as xa, bR as Aa, ae as Oa, aj as ka, al as wa, am as Da, ai as Ga, ak as za, af as Va, a4 as Ua, a5 as Wa, _ as _a, bH as qa, an as Ka, ci as Qa, b4 as Ya, ao as ja, b5 as Ja, ap as Ha, au as Xa, cI as Za, a$ as $a, V as as, W as ss, g as es, aq as ts, ar as is, cK as rs, bJ as cs, as as ns, b6 as os, cu as ls, at as bs, av as ps, ay as us, r as ms, bK as gs, bL as ds, az as Is, b7 as Ss, b8 as Ts, n as ys, c8 as hs, u as Rs, v as vs, T as Cs, U as Es, cv as fs, c9 as Ms, ca as Fs, cq as Ps, bg as Bs, bh as Ls, b9 as Ns, bL as xs, cw as As, cC as Os, ba as ks, G as ws, cF as Ds, cG as Gs, cD as zs, bb as Vs, c4 as Us, d as Ws, bd as _s, bc as qs, bj as Ks, bl as Qs, bm as Ys, bi as js, bk as Js, cH as Hs, f as Xs, ce as Zs, x as $s, C as ae, E as se, F as ee, B as te, D as ie, y as re, bn as ce, cE as ne, bA as oe, s as le, aA as be, aF as pe, aH as ue, aI as me, aD as ge, aE as de, aG as Ie, aB as Se, bM as Te, o as ye, bS as he, bN as Re, cB as ve, b1 as Ce, bp as Ee, bC as fe, aJ as Me, cx as Fe, bq as Pe, ck as Be, cj as Le, a8 as Ne, aL as xe, bs as Ae, aK as Oe, aQ as ke, aS as we, aT as De, aP as Ge, aR as ze, a0 as Ve, a1 as Ue, $ as We, a3 as _e, cd as qe, bu as Ke, bv as Qe, cl as Ye, cn as je, co as Je, cm as He, cp as Xe, bw as Ze, bx as $e, cy as at, a2 as st, Y as et, cz as tt, bz as it, by as rt, cf as ct, cg as nt, ch as ot, w as lt, cA as bt } from "./shared-BSAzZOFX.js";
 a();
 export {
   i as CAPABILITY_KEYS,
@@ -14,212 +14,215 @@ export {
   m as SocraticMethod,
   g as SummaryMap,
   d as TimedAbortController,
-  S as aiExpect,
-  I as anySignal,
-  T as applyAllTargetingRules,
-  y as applyCalibrate,
-  h as applyEntities,
-  R as applyFirstTargetingRule,
-  v as applyRelations,
-  C as applyScale,
-  f as applyScore,
-  E as applyTags,
-  F as auto,
-  M as bool,
-  B as buildSeedGenerationPrompt,
-  N as calculateStatistics,
-  P as calibrate,
-  x as calibrateSpec,
-  A as categorySamples,
-  O as causalFramePrompt,
-  L as centralTendency,
-  k as centralTendencyLines,
-  w as chunk,
-  D as chunkSentences,
-  G as classify,
-  z as collectTerms,
-  U as combinations,
-  V as commonalities,
-  W as compact,
-  _ as computeTagStatistics,
-  q as config,
-  Q as constants,
-  Y as conversationTurnReduce,
-  j as cosineSimilarity,
-  K as createBatches,
-  J as createCalibratedClassifier,
-  X as createContextBuilder,
-  H as createEntityExtractor,
-  Z as createProgressEmitter,
-  $ as createRelationExtractor,
-  aa as createScale,
-  sa as createTagExtractor,
-  ea as createTagger,
-  ta as createTraceCollector,
-  ia as date,
-  ra as debug,
-  ca as default,
-  na as descriptorToSchema,
-  oa as detectPatterns,
-  la as detectThreshold,
-  ba as determineStyle,
-  pa as disambiguate,
-  ua as dismantle,
-  ma as dismantleFactory,
-  ga as documentShrink,
-  da as embed,
-  Sa as embedAssembleSpan,
-  Ia as embedBatch,
-  Ta as embedBuildIndex,
-  ya as embedChunked,
-  ha as embedMergeRanges,
-  Ra as embedMultiQuery,
-  va as embedNeighborChunks,
-  Ca as embedNormalizeText,
-  fa as embedRewriteQuery,
-  Ea as embedRewriteToOutputDoc,
-  Fa as embedScore,
-  Ma as embedStandaloneSpan,
-  Ba as embedStepBack,
-  Na as embedSubquestions,
-  Pa as embedWarmup,
-  xa as entities,
-  Aa as entitiesFilterInstructions,
-  Oa as entitiesFindInstructions,
-  La as entitiesGroupInstructions,
-  ka as entitiesMapInstructions,
-  wa as entitiesReduceInstructions,
-  Da as entitySpec,
-  Ga as evaluateTargetingClause,
-  za as evaluateTargetingRule,
-  Ua as eventToTrace,
-  Va as expect,
-  Wa as extractBlocks,
-  _a as extractJson,
-  qa as fillMissing,
-  Qa as filter,
-  Ya as filterAmbiguous,
-  ja as find,
-  Ka as generateList,
-  Ja as getCapabilities,
-  Xa as getMeanings,
-  Ha as getOption,
-  Za as getOptionDetail,
-  $a as getOptions,
-  as as glossary,
-  ss as group,
-  es as init,
-  ts as intent,
-  is as intersections,
-  rs as join,
-  cs as last,
-  ns as list,
-  os as listBatch,
-  ls as listExpand,
-  bs as llm,
-  ps as llmLogger,
-  us as makePrompt,
-  ms as map,
-  gs as name,
-  ds as nameSimilarTo,
-  Ss as nameStep,
-  Is as normalizeLlm,
-  Ts as number,
-  ys as numberWithUnits,
-  hs as observeApplication,
-  Rs as observeProviders,
-  vs as omit,
-  Cs as parallel,
-  fs as parallelMap,
-  Es as parseLLMList,
-  Fs as parseRDFLiteral,
-  Ms as parseRelations,
-  Bs as people,
-  Ns as phailForge,
-  Ps as pick,
-  xs as pipe,
-  As as popReference,
-  Os as probeScan,
-  Ls as promptCache,
-  ks as promptPiece,
-  ws as prompts,
-  Ds as questions,
-  Gs as rangeCombinations,
-  zs as reduce,
-  Us as relationSpec,
-  Vs as relations,
-  Ws as relationsFilterInstructions,
-  _s as relationsFindInstructions,
-  qs as relationsGroupInstructions,
-  Qs as relationsMapInstructions,
-  Ys as relationsReduceInstructions,
-  js as resolveModel,
-  Ks as retry,
-  Js as ringBuffer,
-  Xs as scale,
-  Hs as scaleFilterInstructions,
-  Zs as scaleFindInstructions,
-  $s as scaleGroupInstructions,
-  ae as scaleMapInstructions,
-  se as scaleReduceInstructions,
-  ee as scaleSpec,
-  te as schemaOrg,
-  ie as schemas,
-  re as scientificFramingPrompt,
-  ce as scopePhase,
-  ne as score,
-  oe as scoreFilterInstructions,
-  le as scoreFindInstructions,
-  be as scoreGroupInstructions,
-  pe as scoreItem,
-  ue as scoreMapInstructions,
-  me as scoreReduceInstructions,
-  ge as scoreSpec,
-  de as sentiment,
-  Se as services,
-  Ie as setEmbedEnabled,
-  Te as setInterval,
-  ye as shuffle,
-  he as simplifyTree,
-  Re as socratic,
-  ve as softCoverPrompt,
-  Ce as sort,
-  fe as sortBy,
-  Ee as split,
-  Fe as stripNumeric,
-  Me as stripResponse,
-  Be as suggestTargetingRules,
-  Ne as tagSpec,
-  Pe as tagVocabulary,
-  xe as tags,
-  Ae as tagsFilterInstructions,
-  Oe as tagsFindInstructions,
-  Le as tagsGroupInstructions,
-  ke as tagsMapInstructions,
-  we as tagsReduceInstructions,
-  De as targetingClause,
-  Ge as targetingRule,
-  ze as targetingRuleOps,
-  Ue as targetingRuleSchema,
-  Ve as templateReplace,
-  We as themes,
-  _e as timeline,
-  qe as toBool,
-  Qe as toDate,
-  Ye as toEnum,
-  je as toNumber,
-  Ke as toNumberWithUnits,
-  Je as toObject,
-  Xe as truncate,
-  He as unionBy,
-  Ze as validateTargetingRules,
-  $e as valueArbitrate,
-  at as vectorSearch,
-  st as veiledVariantStrategies,
-  et as veiledVariants,
-  tt as version,
-  it as windowFor,
-  rt as withInactivityTimeout,
-  ct as withPolicy,
-  nt as zipWith
+  I as aiExpect,
+  S as analyzeImage,
+  T as analyzeImageMapDetail,
+  y as anySignal,
+  h as applyAllTargetingRules,
+  R as applyCalibrate,
+  v as applyEntities,
+  C as applyFirstTargetingRule,
+  E as applyRelations,
+  f as applyScale,
+  M as applyScore,
+  F as applyTags,
+  P as auto,
+  B as bool,
+  L as buildSeedGenerationPrompt,
+  N as buildVisionPrompt,
+  x as calculateStatistics,
+  A as calibrate,
+  O as calibrateSpec,
+  k as categorySamples,
+  w as causalFramePrompt,
+  D as centralTendency,
+  G as centralTendencyLines,
+  z as chunk,
+  V as chunkSentences,
+  U as classify,
+  W as collectTerms,
+  _ as combinations,
+  q as commonalities,
+  K as compact,
+  Q as computeTagStatistics,
+  Y as config,
+  j as constants,
+  J as conversationTurnReduce,
+  H as cosineSimilarity,
+  X as createBatches,
+  Z as createCalibratedClassifier,
+  $ as createContextBuilder,
+  aa as createEntityExtractor,
+  sa as createProgressEmitter,
+  ea as createRelationExtractor,
+  ta as createScale,
+  ia as createTagExtractor,
+  ra as createTagger,
+  ca as createTraceCollector,
+  na as date,
+  oa as debug,
+  la as default,
+  ba as descriptorToSchema,
+  pa as detectPatterns,
+  ua as detectThreshold,
+  ma as determineStyle,
+  ga as disambiguate,
+  da as dismantle,
+  Ia as dismantleFactory,
+  Sa as documentShrink,
+  Ta as embed,
+  ya as embedAssembleSpan,
+  ha as embedBatch,
+  Ra as embedBuildIndex,
+  va as embedChunked,
+  Ca as embedMergeRanges,
+  Ea as embedMultiQuery,
+  fa as embedNeighborChunks,
+  Ma as embedNormalizeText,
+  Fa as embedRewriteQuery,
+  Pa as embedRewriteToOutputDoc,
+  Ba as embedScore,
+  La as embedStandaloneSpan,
+  Na as embedStepBack,
+  xa as embedSubquestions,
+  Aa as embedWarmup,
+  Oa as entities,
+  ka as entitiesFilterInstructions,
+  wa as entitiesFindInstructions,
+  Da as entitiesGroupInstructions,
+  Ga as entitiesMapInstructions,
+  za as entitiesReduceInstructions,
+  Va as entitySpec,
+  Ua as evaluateTargetingClause,
+  Wa as evaluateTargetingRule,
+  _a as eventToTrace,
+  qa as expect,
+  Ka as extractBlocks,
+  Qa as extractJson,
+  Ya as fillMissing,
+  ja as filter,
+  Ja as filterAmbiguous,
+  Ha as find,
+  Xa as generateList,
+  Za as getCapabilities,
+  $a as getMeanings,
+  as as getOption,
+  ss as getOptionDetail,
+  es as getOptions,
+  ts as glossary,
+  is as group,
+  rs as init,
+  cs as intent,
+  ns as intersections,
+  os as join,
+  ls as last,
+  bs as list,
+  ps as listBatch,
+  us as listExpand,
+  ms as llm,
+  gs as llmLogger,
+  ds as makePrompt,
+  Is as map,
+  Ss as name,
+  Ts as nameSimilarTo,
+  ys as nameStep,
+  hs as normalizeLlm,
+  Rs as number,
+  vs as numberWithUnits,
+  Cs as observeApplication,
+  Es as observeProviders,
+  fs as omit,
+  Ms as parallel,
+  Fs as parallelMap,
+  Ps as parseLLMList,
+  Bs as parseRDFLiteral,
+  Ls as parseRelations,
+  Ns as people,
+  xs as phailForge,
+  As as pick,
+  Os as pipe,
+  ks as popReference,
+  ws as probeScan,
+  Ds as promptCache,
+  Gs as promptPiece,
+  zs as prompts,
+  Vs as questions,
+  Us as rangeCombinations,
+  Ws as reduce,
+  _s as relationSpec,
+  qs as relations,
+  Ks as relationsFilterInstructions,
+  Qs as relationsFindInstructions,
+  Ys as relationsGroupInstructions,
+  js as relationsMapInstructions,
+  Js as relationsReduceInstructions,
+  Hs as resolveModel,
+  Xs as retry,
+  Zs as ringBuffer,
+  $s as scale,
+  ae as scaleFilterInstructions,
+  se as scaleFindInstructions,
+  ee as scaleGroupInstructions,
+  te as scaleMapInstructions,
+  ie as scaleReduceInstructions,
+  re as scaleSpec,
+  ce as schemaOrg,
+  ne as schemas,
+  oe as scientificFramingPrompt,
+  le as scopePhase,
+  be as score,
+  pe as scoreFilterInstructions,
+  ue as scoreFindInstructions,
+  me as scoreGroupInstructions,
+  ge as scoreItem,
+  de as scoreMapInstructions,
+  Ie as scoreReduceInstructions,
+  Se as scoreSpec,
+  Te as sentiment,
+  ye as services,
+  he as setEmbedEnabled,
+  Re as setInterval,
+  ve as shuffle,
+  Ce as simplifyTree,
+  Ee as socratic,
+  fe as softCoverPrompt,
+  Me as sort,
+  Fe as sortBy,
+  Pe as split,
+  Be as stripNumeric,
+  Le as stripResponse,
+  Ne as suggestTargetingRules,
+  xe as tagSpec,
+  Ae as tagVocabulary,
+  Oe as tags,
+  ke as tagsFilterInstructions,
+  we as tagsFindInstructions,
+  De as tagsGroupInstructions,
+  Ge as tagsMapInstructions,
+  ze as tagsReduceInstructions,
+  Ve as targetingClause,
+  Ue as targetingRule,
+  We as targetingRuleOps,
+  _e as targetingRuleSchema,
+  qe as templateReplace,
+  Ke as themes,
+  Qe as timeline,
+  Ye as toBool,
+  je as toDate,
+  Je as toEnum,
+  He as toNumber,
+  Xe as toNumberWithUnits,
+  Ze as toObject,
+  $e as truncate,
+  at as unionBy,
+  st as validateTargetingRules,
+  et as valueArbitrate,
+  tt as vectorSearch,
+  it as veiledVariantStrategies,
+  rt as veiledVariants,
+  ct as version,
+  nt as windowFor,
+  ot as withInactivityTimeout,
+  lt as withPolicy,
+  bt as zipWith
 };