capman 0.5.5 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +1 -1
- package/bin/lib/cmd-generate.js +156 -12
- package/bin/lib/cmd-help.js +3 -0
- package/dist/cjs/engine.d.ts +53 -1
- package/dist/cjs/engine.d.ts.map +1 -1
- package/dist/cjs/engine.js +219 -9
- package/dist/cjs/engine.js.map +1 -1
- package/dist/cjs/index.d.ts +1 -0
- package/dist/cjs/index.d.ts.map +1 -1
- package/dist/cjs/index.js +3 -1
- package/dist/cjs/index.js.map +1 -1
- package/dist/cjs/learning.d.ts.map +1 -1
- package/dist/cjs/learning.js +12 -18
- package/dist/cjs/learning.js.map +1 -1
- package/dist/cjs/matcher.d.ts +55 -0
- package/dist/cjs/matcher.d.ts.map +1 -1
- package/dist/cjs/matcher.js +267 -31
- package/dist/cjs/matcher.js.map +1 -1
- package/dist/cjs/schema.d.ts +46 -28
- package/dist/cjs/schema.d.ts.map +1 -1
- package/dist/cjs/schema.js +1 -0
- package/dist/cjs/schema.js.map +1 -1
- package/dist/cjs/types.d.ts +7 -1
- package/dist/cjs/types.d.ts.map +1 -1
- package/dist/esm/engine.d.ts +53 -1
- package/dist/esm/engine.js +220 -10
- package/dist/esm/index.d.ts +1 -0
- package/dist/esm/index.js +1 -0
- package/dist/esm/learning.js +13 -19
- package/dist/esm/matcher.d.ts +55 -0
- package/dist/esm/matcher.js +261 -31
- package/dist/esm/schema.d.ts +46 -28
- package/dist/esm/schema.js +1 -0
- package/dist/esm/types.d.ts +7 -1
- package/package.json +1 -1
package/dist/cjs/schema.d.ts
CHANGED
|
@@ -13,18 +13,21 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
13
13
|
required: z.ZodBoolean;
|
|
14
14
|
source: z.ZodEnum<["user_query", "session"]>;
|
|
15
15
|
default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
|
|
16
|
+
pattern: z.ZodOptional<z.ZodString>;
|
|
16
17
|
}, "strip", z.ZodTypeAny, {
|
|
17
18
|
name: string;
|
|
18
|
-
required: boolean;
|
|
19
19
|
description: string;
|
|
20
|
+
required: boolean;
|
|
20
21
|
source: "user_query" | "session";
|
|
21
22
|
default?: string | number | boolean | undefined;
|
|
23
|
+
pattern?: string | undefined;
|
|
22
24
|
}, {
|
|
23
25
|
name: string;
|
|
24
|
-
required: boolean;
|
|
25
26
|
description: string;
|
|
27
|
+
required: boolean;
|
|
26
28
|
source: "user_query" | "session";
|
|
27
29
|
default?: string | number | boolean | undefined;
|
|
30
|
+
pattern?: string | undefined;
|
|
28
31
|
}>, "many">;
|
|
29
32
|
returns: z.ZodArray<z.ZodString, "many">;
|
|
30
33
|
resolver: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
|
|
@@ -147,14 +150,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
147
150
|
}, "strip", z.ZodTypeAny, {
|
|
148
151
|
name: string;
|
|
149
152
|
id: string;
|
|
153
|
+
description: string;
|
|
150
154
|
params: {
|
|
151
155
|
name: string;
|
|
152
|
-
required: boolean;
|
|
153
156
|
description: string;
|
|
157
|
+
required: boolean;
|
|
154
158
|
source: "user_query" | "session";
|
|
155
159
|
default?: string | number | boolean | undefined;
|
|
160
|
+
pattern?: string | undefined;
|
|
156
161
|
}[];
|
|
157
|
-
description: string;
|
|
158
162
|
returns: string[];
|
|
159
163
|
resolver: {
|
|
160
164
|
type: "api";
|
|
@@ -189,14 +193,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
189
193
|
}, {
|
|
190
194
|
name: string;
|
|
191
195
|
id: string;
|
|
196
|
+
description: string;
|
|
192
197
|
params: {
|
|
193
198
|
name: string;
|
|
194
|
-
required: boolean;
|
|
195
199
|
description: string;
|
|
200
|
+
required: boolean;
|
|
196
201
|
source: "user_query" | "session";
|
|
197
202
|
default?: string | number | boolean | undefined;
|
|
203
|
+
pattern?: string | undefined;
|
|
198
204
|
}[];
|
|
199
|
-
description: string;
|
|
200
205
|
returns: string[];
|
|
201
206
|
resolver: {
|
|
202
207
|
type: "api";
|
|
@@ -231,14 +236,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
231
236
|
}>, "many">, {
|
|
232
237
|
name: string;
|
|
233
238
|
id: string;
|
|
239
|
+
description: string;
|
|
234
240
|
params: {
|
|
235
241
|
name: string;
|
|
236
|
-
required: boolean;
|
|
237
242
|
description: string;
|
|
243
|
+
required: boolean;
|
|
238
244
|
source: "user_query" | "session";
|
|
239
245
|
default?: string | number | boolean | undefined;
|
|
246
|
+
pattern?: string | undefined;
|
|
240
247
|
}[];
|
|
241
|
-
description: string;
|
|
242
248
|
returns: string[];
|
|
243
249
|
resolver: {
|
|
244
250
|
type: "api";
|
|
@@ -273,14 +279,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
273
279
|
}[], {
|
|
274
280
|
name: string;
|
|
275
281
|
id: string;
|
|
282
|
+
description: string;
|
|
276
283
|
params: {
|
|
277
284
|
name: string;
|
|
278
|
-
required: boolean;
|
|
279
285
|
description: string;
|
|
286
|
+
required: boolean;
|
|
280
287
|
source: "user_query" | "session";
|
|
281
288
|
default?: string | number | boolean | undefined;
|
|
289
|
+
pattern?: string | undefined;
|
|
282
290
|
}[];
|
|
283
|
-
description: string;
|
|
284
291
|
returns: string[];
|
|
285
292
|
resolver: {
|
|
286
293
|
type: "api";
|
|
@@ -318,14 +325,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
318
325
|
capabilities: {
|
|
319
326
|
name: string;
|
|
320
327
|
id: string;
|
|
328
|
+
description: string;
|
|
321
329
|
params: {
|
|
322
330
|
name: string;
|
|
323
|
-
required: boolean;
|
|
324
331
|
description: string;
|
|
332
|
+
required: boolean;
|
|
325
333
|
source: "user_query" | "session";
|
|
326
334
|
default?: string | number | boolean | undefined;
|
|
335
|
+
pattern?: string | undefined;
|
|
327
336
|
}[];
|
|
328
|
-
description: string;
|
|
329
337
|
returns: string[];
|
|
330
338
|
resolver: {
|
|
331
339
|
type: "api";
|
|
@@ -364,14 +372,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
364
372
|
capabilities: {
|
|
365
373
|
name: string;
|
|
366
374
|
id: string;
|
|
375
|
+
description: string;
|
|
367
376
|
params: {
|
|
368
377
|
name: string;
|
|
369
|
-
required: boolean;
|
|
370
378
|
description: string;
|
|
379
|
+
required: boolean;
|
|
371
380
|
source: "user_query" | "session";
|
|
372
381
|
default?: string | number | boolean | undefined;
|
|
382
|
+
pattern?: string | undefined;
|
|
373
383
|
}[];
|
|
374
|
-
description: string;
|
|
375
384
|
returns: string[];
|
|
376
385
|
resolver: {
|
|
377
386
|
type: "api";
|
|
@@ -410,14 +419,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
410
419
|
capabilities: {
|
|
411
420
|
name: string;
|
|
412
421
|
id: string;
|
|
422
|
+
description: string;
|
|
413
423
|
params: {
|
|
414
424
|
name: string;
|
|
415
|
-
required: boolean;
|
|
416
425
|
description: string;
|
|
426
|
+
required: boolean;
|
|
417
427
|
source: "user_query" | "session";
|
|
418
428
|
default?: string | number | boolean | undefined;
|
|
429
|
+
pattern?: string | undefined;
|
|
419
430
|
}[];
|
|
420
|
-
description: string;
|
|
421
431
|
returns: string[];
|
|
422
432
|
resolver: {
|
|
423
433
|
type: "api";
|
|
@@ -456,14 +466,15 @@ export declare const CapmanConfigSchema: z.ZodEffects<z.ZodObject<{
|
|
|
456
466
|
capabilities: {
|
|
457
467
|
name: string;
|
|
458
468
|
id: string;
|
|
469
|
+
description: string;
|
|
459
470
|
params: {
|
|
460
471
|
name: string;
|
|
461
|
-
required: boolean;
|
|
462
472
|
description: string;
|
|
473
|
+
required: boolean;
|
|
463
474
|
source: "user_query" | "session";
|
|
464
475
|
default?: string | number | boolean | undefined;
|
|
476
|
+
pattern?: string | undefined;
|
|
465
477
|
}[];
|
|
466
|
-
description: string;
|
|
467
478
|
returns: string[];
|
|
468
479
|
resolver: {
|
|
469
480
|
type: "api";
|
|
@@ -513,18 +524,21 @@ export declare const ManifestSchema: z.ZodObject<{
|
|
|
513
524
|
required: z.ZodBoolean;
|
|
514
525
|
source: z.ZodEnum<["user_query", "session"]>;
|
|
515
526
|
default: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>>;
|
|
527
|
+
pattern: z.ZodOptional<z.ZodString>;
|
|
516
528
|
}, "strip", z.ZodTypeAny, {
|
|
517
529
|
name: string;
|
|
518
|
-
required: boolean;
|
|
519
530
|
description: string;
|
|
531
|
+
required: boolean;
|
|
520
532
|
source: "user_query" | "session";
|
|
521
533
|
default?: string | number | boolean | undefined;
|
|
534
|
+
pattern?: string | undefined;
|
|
522
535
|
}, {
|
|
523
536
|
name: string;
|
|
524
|
-
required: boolean;
|
|
525
537
|
description: string;
|
|
538
|
+
required: boolean;
|
|
526
539
|
source: "user_query" | "session";
|
|
527
540
|
default?: string | number | boolean | undefined;
|
|
541
|
+
pattern?: string | undefined;
|
|
528
542
|
}>, "many">;
|
|
529
543
|
returns: z.ZodArray<z.ZodString, "many">;
|
|
530
544
|
resolver: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
|
|
@@ -647,14 +661,15 @@ export declare const ManifestSchema: z.ZodObject<{
|
|
|
647
661
|
}, "strip", z.ZodTypeAny, {
|
|
648
662
|
name: string;
|
|
649
663
|
id: string;
|
|
664
|
+
description: string;
|
|
650
665
|
params: {
|
|
651
666
|
name: string;
|
|
652
|
-
required: boolean;
|
|
653
667
|
description: string;
|
|
668
|
+
required: boolean;
|
|
654
669
|
source: "user_query" | "session";
|
|
655
670
|
default?: string | number | boolean | undefined;
|
|
671
|
+
pattern?: string | undefined;
|
|
656
672
|
}[];
|
|
657
|
-
description: string;
|
|
658
673
|
returns: string[];
|
|
659
674
|
resolver: {
|
|
660
675
|
type: "api";
|
|
@@ -689,14 +704,15 @@ export declare const ManifestSchema: z.ZodObject<{
|
|
|
689
704
|
}, {
|
|
690
705
|
name: string;
|
|
691
706
|
id: string;
|
|
707
|
+
description: string;
|
|
692
708
|
params: {
|
|
693
709
|
name: string;
|
|
694
|
-
required: boolean;
|
|
695
710
|
description: string;
|
|
711
|
+
required: boolean;
|
|
696
712
|
source: "user_query" | "session";
|
|
697
713
|
default?: string | number | boolean | undefined;
|
|
714
|
+
pattern?: string | undefined;
|
|
698
715
|
}[];
|
|
699
|
-
description: string;
|
|
700
716
|
returns: string[];
|
|
701
717
|
resolver: {
|
|
702
718
|
type: "api";
|
|
@@ -735,14 +751,15 @@ export declare const ManifestSchema: z.ZodObject<{
|
|
|
735
751
|
capabilities: {
|
|
736
752
|
name: string;
|
|
737
753
|
id: string;
|
|
754
|
+
description: string;
|
|
738
755
|
params: {
|
|
739
756
|
name: string;
|
|
740
|
-
required: boolean;
|
|
741
757
|
description: string;
|
|
758
|
+
required: boolean;
|
|
742
759
|
source: "user_query" | "session";
|
|
743
760
|
default?: string | number | boolean | undefined;
|
|
761
|
+
pattern?: string | undefined;
|
|
744
762
|
}[];
|
|
745
|
-
description: string;
|
|
746
763
|
returns: string[];
|
|
747
764
|
resolver: {
|
|
748
765
|
type: "api";
|
|
@@ -782,14 +799,15 @@ export declare const ManifestSchema: z.ZodObject<{
|
|
|
782
799
|
capabilities: {
|
|
783
800
|
name: string;
|
|
784
801
|
id: string;
|
|
802
|
+
description: string;
|
|
785
803
|
params: {
|
|
786
804
|
name: string;
|
|
787
|
-
required: boolean;
|
|
788
805
|
description: string;
|
|
806
|
+
required: boolean;
|
|
789
807
|
source: "user_query" | "session";
|
|
790
808
|
default?: string | number | boolean | undefined;
|
|
809
|
+
pattern?: string | undefined;
|
|
791
810
|
}[];
|
|
792
|
-
description: string;
|
|
793
811
|
returns: string[];
|
|
794
812
|
resolver: {
|
|
795
813
|
type: "api";
|
package/dist/cjs/schema.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;
|
|
1
|
+
{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA4EvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB9B,CAAA;AAID,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKzB,CAAA;AAIF,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAQnE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAQvE"}
|
package/dist/cjs/schema.js
CHANGED
|
@@ -11,6 +11,7 @@ const CapabilityParamSchema = zod_1.z.object({
|
|
|
11
11
|
required: zod_1.z.boolean(),
|
|
12
12
|
source: zod_1.z.enum(['user_query', 'session']),
|
|
13
13
|
default: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()]).optional(),
|
|
14
|
+
pattern: zod_1.z.string().optional(),
|
|
14
15
|
});
|
|
15
16
|
// ─── Resolver Schemas ─────────────────────────────────────────────────────────
|
|
16
17
|
const ApiResolverSchema = zod_1.z.object({
|
package/dist/cjs/schema.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":";;;
|
|
1
|
+
{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/schema.ts"],"names":[],"mappings":"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"}
|
package/dist/cjs/types.d.ts
CHANGED
|
@@ -5,7 +5,13 @@ export interface CapabilityParam {
|
|
|
5
5
|
description: string;
|
|
6
6
|
required: boolean;
|
|
7
7
|
source: 'user_query' | 'session';
|
|
8
|
-
|
|
8
|
+
/**
|
|
9
|
+
* Optional extraction hint. Either a named type or an example template.
|
|
10
|
+
* Named types: 'email' | 'date' | 'orderId' | 'url'
|
|
11
|
+
* Example template: "order {paramName}" — extracts token after "order"
|
|
12
|
+
* When provided, pattern matching runs before keyword heuristics.
|
|
13
|
+
*/
|
|
14
|
+
pattern?: string;
|
|
9
15
|
}
|
|
10
16
|
export interface ApiResolver {
|
|
11
17
|
type: 'api';
|
package/dist/cjs/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAA;AACnD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;AAIpE,MAAM,WAAW,eAAe;IAC9B,IAAI,
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
|
package/dist/esm/engine.d.ts
CHANGED
|
@@ -47,6 +47,10 @@ export interface EngineOptions {
|
|
|
47
47
|
headers?: Record<string, string>;
|
|
48
48
|
/** Confidence threshold for keyword matcher (default: 50) */
|
|
49
49
|
threshold?: number;
|
|
50
|
+
/** BM25 TF saturation parameter (default: 1.5) */
|
|
51
|
+
bm25K1?: number;
|
|
52
|
+
/** BM25 length normalization parameter (default: 0.75) */
|
|
53
|
+
bm25B?: number;
|
|
50
54
|
/**
|
|
51
55
|
* Optional TTL for cache entries in milliseconds.
|
|
52
56
|
* Entries older than this are treated as misses and evicted on read.
|
|
@@ -97,14 +101,35 @@ export interface EngineOptions {
|
|
|
97
101
|
* @default 0.4
|
|
98
102
|
*/
|
|
99
103
|
fuzzyThreshold?: number;
|
|
104
|
+
/**
|
|
105
|
+
* When true, a 'marginal' verdict in balanced/accurate mode triggers a
|
|
106
|
+
* targeted LLM disambiguation between the top-2 candidates.
|
|
107
|
+
* Uses ~200 tokens vs ~4000 for full manifest — 93% cost reduction.
|
|
108
|
+
* Has no effect in cheap mode or when no llm is provided.
|
|
109
|
+
* @default false
|
|
110
|
+
*/
|
|
111
|
+
marginAwareLLM?: boolean;
|
|
112
|
+
/**
|
|
113
|
+
* Override the adaptive margin threshold (0-100 points).
|
|
114
|
+
* When undefined, calibrated automatically from manifest score distribution.
|
|
115
|
+
*/
|
|
116
|
+
adaptiveMarginOverride?: number;
|
|
100
117
|
}
|
|
101
118
|
export interface EngineResult {
|
|
102
119
|
match: MatchResult;
|
|
103
120
|
resolution: ResolveResult;
|
|
104
121
|
resolvedVia: 'cache' | 'keyword' | 'llm';
|
|
105
122
|
durationMs: number;
|
|
106
|
-
/** Full execution trace — always present */
|
|
107
123
|
trace: ExecutionTrace;
|
|
124
|
+
verdict: 'clear' | 'marginal' | 'uncertain';
|
|
125
|
+
margin: number;
|
|
126
|
+
/**
|
|
127
|
+
* Required params that could not be extracted from the query.
|
|
128
|
+
* Only populated when extraction failed AND LLM was not used.
|
|
129
|
+
* When present, the agent should prompt the user for these values.
|
|
130
|
+
* Undefined when all required params were successfully extracted.
|
|
131
|
+
*/
|
|
132
|
+
missingParams?: string[];
|
|
108
133
|
}
|
|
109
134
|
export declare class CapmanEngine {
|
|
110
135
|
/** Maximum allowed query length in characters. Queries exceeding this throw RangeError. */
|
|
@@ -121,6 +146,12 @@ export declare class CapmanEngine {
|
|
|
121
146
|
private cacheTtlMs;
|
|
122
147
|
private fuzzyMatch;
|
|
123
148
|
private fuzzyThreshold;
|
|
149
|
+
private bm25Index;
|
|
150
|
+
private bm25Ceiling;
|
|
151
|
+
private bm25K1;
|
|
152
|
+
private bm25B;
|
|
153
|
+
private marginAwareLLM;
|
|
154
|
+
private adaptiveMargin;
|
|
124
155
|
private maxLLMCallsPerMinute;
|
|
125
156
|
private llmCooldownMs;
|
|
126
157
|
private llmCircuitBreakerThreshold;
|
|
@@ -223,4 +254,25 @@ export declare class CapmanEngine {
|
|
|
223
254
|
private applyLearningBoost;
|
|
224
255
|
private resolveOptions;
|
|
225
256
|
private recordLearning;
|
|
257
|
+
private calibrateBM25Ceiling;
|
|
258
|
+
/**
|
|
259
|
+
* Calibrates the adaptive margin threshold from the manifest's own score
|
|
260
|
+
* distribution. Runs each capability's first example against all other
|
|
261
|
+
* capabilities to find the typical inter-capability score spread.
|
|
262
|
+
* Dense overlapping vocabulary → lower margin (harder to separate).
|
|
263
|
+
* Sparse vocabulary → higher margin (easier to separate).
|
|
264
|
+
*
|
|
265
|
+
* Complexity: O(capabilities²) — runs at constructor time and on loadManifest().
|
|
266
|
+
* For manifests with ≤100 capabilities this is negligible (<10ms).
|
|
267
|
+
* For very large manifests (500+ capabilities), consider passing
|
|
268
|
+
* `adaptiveMarginOverride` to skip calibration.
|
|
269
|
+
*/
|
|
270
|
+
private calibrateAdaptiveMargin;
|
|
271
|
+
private computeVerdict;
|
|
272
|
+
/**
|
|
273
|
+
* Targeted disambiguation between top-2 candidates.
|
|
274
|
+
* Sends ~200 tokens instead of full manifest (~4000 tokens) — 93% cost reduction.
|
|
275
|
+
* Returns updated matchResult with LLM-preferred winner, or original on failure.
|
|
276
|
+
*/
|
|
277
|
+
private disambiguateLLM;
|
|
226
278
|
}
|