@fenglimg/fabric-shared 2.2.0-rc.4 → 2.2.0-rc.9

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.
@@ -1,8 +1,6 @@
1
1
  import { z } from 'zod';
2
2
 
3
- type AgentsLayer = "L0" | "L1" | "L2";
4
3
  type AgentsTopologyType = "mirror" | "cross-cutting" | "domain" | "local" | "global";
5
- type AgentsActivationTier = "always" | "path" | "description";
6
4
  type AgentsIdentitySource = "declared" | "derived";
7
5
  interface RuleDescription {
8
6
  summary: string;
@@ -26,10 +24,7 @@ interface RuleDescription {
26
24
  interface RuleDescriptionIndexItem {
27
25
  stable_id: string;
28
26
  description: RuleDescription;
29
- }
30
- interface AgentsMetaNodeActivation {
31
- tier: AgentsActivationTier;
32
- description?: string;
27
+ always_active?: boolean;
33
28
  }
34
29
  interface AgentsMetaNode {
35
30
  file: string;
@@ -38,12 +33,10 @@ interface AgentsMetaNode {
38
33
  hash: string;
39
34
  stable_id?: string;
40
35
  identity_source?: AgentsIdentitySource;
41
- activation?: AgentsMetaNodeActivation;
42
36
  description?: RuleDescription;
43
37
  sections?: string[];
44
38
  deps?: string[];
45
39
  priority?: "high" | "medium" | "low";
46
- level?: AgentsLayer;
47
40
  topology_type?: AgentsTopologyType;
48
41
  }
49
42
  interface AgentsMetaKnowledgeTypeCounters {
@@ -94,17 +87,14 @@ declare const auditModeSchema: z.ZodEnum<["strict", "warn", "off"]>;
94
87
  declare const clientPathsSchema: z.ZodObject<{
95
88
  claudeCodeCLI: z.ZodOptional<z.ZodString>;
96
89
  claudeCodeDesktop: z.ZodOptional<z.ZodString>;
97
- cursor: z.ZodOptional<z.ZodString>;
98
90
  codexCLI: z.ZodOptional<z.ZodString>;
99
91
  }, "strict", z.ZodTypeAny, {
100
92
  claudeCodeCLI?: string | undefined;
101
93
  claudeCodeDesktop?: string | undefined;
102
- cursor?: string | undefined;
103
94
  codexCLI?: string | undefined;
104
95
  }, {
105
96
  claudeCodeCLI?: string | undefined;
106
97
  claudeCodeDesktop?: string | undefined;
107
- cursor?: string | undefined;
108
98
  codexCLI?: string | undefined;
109
99
  }>;
110
100
  declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
@@ -119,26 +109,48 @@ declare const mcpPayloadLimitsSchema: z.ZodOptional<z.ZodObject<{
119
109
  }>>;
120
110
  declare const selectionTokenTtlMsSchema: z.ZodNumber;
121
111
  declare const planContextTopKSchema: z.ZodNumber;
122
- declare const fabricLanguageSchema: z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>;
112
+ declare const fabricLanguageSchema: z.ZodEnum<["zh-CN", "en"]>;
123
113
  declare const defaultLayerFilterSchema: z.ZodEnum<["team", "personal", "both"]>;
114
+ declare const nudgeModeSchema: z.ZodEnum<["silent", "minimal", "normal", "verbose"]>;
115
+ declare const observeConfigSchema: z.ZodObject<{
116
+ session_start: z.ZodOptional<z.ZodBoolean>;
117
+ pre_tool_use: z.ZodOptional<z.ZodBoolean>;
118
+ stop: z.ZodOptional<z.ZodBoolean>;
119
+ }, "strict", z.ZodTypeAny, {
120
+ session_start?: boolean | undefined;
121
+ pre_tool_use?: boolean | undefined;
122
+ stop?: boolean | undefined;
123
+ }, {
124
+ session_start?: boolean | undefined;
125
+ pre_tool_use?: boolean | undefined;
126
+ stop?: boolean | undefined;
127
+ }>;
128
+ declare const writeRouteSchema: z.ZodObject<{
129
+ scope: z.ZodString;
130
+ store: z.ZodString;
131
+ }, "strict", z.ZodTypeAny, {
132
+ scope: string;
133
+ store: string;
134
+ }, {
135
+ scope: string;
136
+ store: string;
137
+ }>;
124
138
  declare const fabricConfigSchema: z.ZodObject<{
125
139
  clientPaths: z.ZodOptional<z.ZodObject<{
126
140
  claudeCodeCLI: z.ZodOptional<z.ZodString>;
127
141
  claudeCodeDesktop: z.ZodOptional<z.ZodString>;
128
- cursor: z.ZodOptional<z.ZodString>;
129
142
  codexCLI: z.ZodOptional<z.ZodString>;
130
143
  }, "strict", z.ZodTypeAny, {
131
144
  claudeCodeCLI?: string | undefined;
132
145
  claudeCodeDesktop?: string | undefined;
133
- cursor?: string | undefined;
134
146
  codexCLI?: string | undefined;
135
147
  }, {
136
148
  claudeCodeCLI?: string | undefined;
137
149
  claudeCodeDesktop?: string | undefined;
138
- cursor?: string | undefined;
139
150
  codexCLI?: string | undefined;
140
151
  }>>;
141
152
  project_id: z.ZodOptional<z.ZodString>;
153
+ workspace_binding_id: z.ZodOptional<z.ZodString>;
142
154
  required_stores: z.ZodOptional<z.ZodArray<z.ZodObject<{
143
155
  id: z.ZodString;
144
156
  suggested_remote: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodLiteral<"$personal">]>>;
@@ -151,6 +163,17 @@ declare const fabricConfigSchema: z.ZodObject<{
151
163
  }>, "many">>;
152
164
  active_write_store: z.ZodOptional<z.ZodString>;
153
165
  active_project: z.ZodOptional<z.ZodString>;
166
+ write_routes: z.ZodOptional<z.ZodArray<z.ZodObject<{
167
+ scope: z.ZodString;
168
+ store: z.ZodString;
169
+ }, "strict", z.ZodTypeAny, {
170
+ scope: string;
171
+ store: string;
172
+ }, {
173
+ scope: string;
174
+ store: string;
175
+ }>, "many">>;
176
+ default_write_store: z.ZodOptional<z.ZodString>;
154
177
  scanIgnores: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
155
178
  audit_mode: z.ZodOptional<z.ZodEnum<["strict", "warn", "off"]>>;
156
179
  mcpPayloadLimits: z.ZodOptional<z.ZodObject<{
@@ -163,8 +186,21 @@ declare const fabricConfigSchema: z.ZodObject<{
163
186
  warnBytes?: number | undefined;
164
187
  hardBytes?: number | undefined;
165
188
  }>>;
166
- fabric_language: z.ZodDefault<z.ZodOptional<z.ZodEnum<["match-existing", "zh-CN", "en", "zh-CN-hybrid"]>>>;
167
189
  default_layer_filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<["team", "personal", "both"]>>>;
190
+ nudge_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["silent", "minimal", "normal", "verbose"]>>>;
191
+ observe: z.ZodOptional<z.ZodObject<{
192
+ session_start: z.ZodOptional<z.ZodBoolean>;
193
+ pre_tool_use: z.ZodOptional<z.ZodBoolean>;
194
+ stop: z.ZodOptional<z.ZodBoolean>;
195
+ }, "strict", z.ZodTypeAny, {
196
+ session_start?: boolean | undefined;
197
+ pre_tool_use?: boolean | undefined;
198
+ stop?: boolean | undefined;
199
+ }, {
200
+ session_start?: boolean | undefined;
201
+ pre_tool_use?: boolean | undefined;
202
+ stop?: boolean | undefined;
203
+ }>>;
168
204
  archive_hint_cooldown_hours: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
169
205
  underseed_node_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
170
206
  archive_edit_threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -193,7 +229,7 @@ declare const fabricConfigSchema: z.ZodObject<{
193
229
  fabric_event_retention_days: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<7>, z.ZodLiteral<30>, z.ZodLiteral<90>]>>;
194
230
  onboard_slots_opted_out: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
195
231
  hint_broad_top_k: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
196
- hint_broad_budget_chars: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
232
+ broad_index_backstop: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
197
233
  hint_dismiss_signals: z.ZodOptional<z.ZodArray<z.ZodEnum<["archive", "review", "import", "maintenance"]>, "many">>;
198
234
  cite_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
199
235
  self_archive_policy_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -204,19 +240,17 @@ declare const fabricConfigSchema: z.ZodObject<{
204
240
  orphan_demote_proven_days: z.ZodOptional<z.ZodNumber>;
205
241
  orphan_demote_verified_days: z.ZodOptional<z.ZodNumber>;
206
242
  orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
207
- orphan_demote_stable_days: z.ZodOptional<z.ZodNumber>;
208
- orphan_demote_endorsed_days: z.ZodOptional<z.ZodNumber>;
209
243
  hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
210
244
  hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
211
245
  selection_token_ttl_ms: z.ZodOptional<z.ZodNumber>;
212
246
  plan_context_top_k: z.ZodOptional<z.ZodNumber>;
213
- retrieval_budget_profile: z.ZodOptional<z.ZodEnum<["conservative", "balanced", "generous"]>>;
247
+ recall_relevance_ratio: z.ZodOptional<z.ZodNumber>;
214
248
  embed_enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
215
249
  embed_weight: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
216
250
  embed_model: z.ZodDefault<z.ZodOptional<z.ZodEnum<["fast-bge-small-zh-v1.5", "fast-multilingual-e5-large", "fast-bge-small-en-v1.5", "fast-bge-small-en", "fast-bge-base-en-v1.5", "fast-bge-base-en", "fast-all-MiniLM-L6-v2"]>>>;
217
251
  }, "strip", z.ZodTypeAny, {
218
- fabric_language: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
219
252
  default_layer_filter: "personal" | "team" | "both";
253
+ nudge_mode: "silent" | "minimal" | "normal" | "verbose";
220
254
  archive_hint_cooldown_hours: number;
221
255
  underseed_node_threshold: number;
222
256
  archive_edit_threshold: number;
@@ -243,7 +277,7 @@ declare const fabricConfigSchema: z.ZodObject<{
243
277
  conflict_lint_similarity_threshold: number;
244
278
  onboard_slots_opted_out: string[];
245
279
  hint_broad_top_k: number;
246
- hint_broad_budget_chars: number;
280
+ broad_index_backstop: number;
247
281
  cite_policy_enabled: boolean;
248
282
  self_archive_policy_enabled: boolean;
249
283
  hint_narrow_top_k: number;
@@ -258,55 +292,73 @@ declare const fabricConfigSchema: z.ZodObject<{
258
292
  clientPaths?: {
259
293
  claudeCodeCLI?: string | undefined;
260
294
  claudeCodeDesktop?: string | undefined;
261
- cursor?: string | undefined;
262
295
  codexCLI?: string | undefined;
263
296
  } | undefined;
264
297
  project_id?: string | undefined;
298
+ workspace_binding_id?: string | undefined;
265
299
  required_stores?: {
266
300
  id: string;
267
301
  suggested_remote?: string | undefined;
268
302
  }[] | undefined;
269
303
  active_write_store?: string | undefined;
270
304
  active_project?: string | undefined;
305
+ write_routes?: {
306
+ scope: string;
307
+ store: string;
308
+ }[] | undefined;
309
+ default_write_store?: string | undefined;
271
310
  scanIgnores?: string[] | undefined;
272
311
  audit_mode?: "strict" | "warn" | "off" | undefined;
273
312
  mcpPayloadLimits?: {
274
313
  warnBytes?: number | undefined;
275
314
  hardBytes?: number | undefined;
276
315
  } | undefined;
316
+ observe?: {
317
+ session_start?: boolean | undefined;
318
+ pre_tool_use?: boolean | undefined;
319
+ stop?: boolean | undefined;
320
+ } | undefined;
277
321
  cite_nudge_ignore_globs?: string[] | undefined;
278
322
  fabric_event_retention_days?: 7 | 30 | 90 | undefined;
279
323
  hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
280
324
  orphan_demote_proven_days?: number | undefined;
281
325
  orphan_demote_verified_days?: number | undefined;
282
326
  orphan_demote_draft_days?: number | undefined;
283
- orphan_demote_stable_days?: number | undefined;
284
- orphan_demote_endorsed_days?: number | undefined;
285
327
  selection_token_ttl_ms?: number | undefined;
286
328
  plan_context_top_k?: number | undefined;
287
- retrieval_budget_profile?: "conservative" | "balanced" | "generous" | undefined;
329
+ recall_relevance_ratio?: number | undefined;
288
330
  }, {
289
331
  clientPaths?: {
290
332
  claudeCodeCLI?: string | undefined;
291
333
  claudeCodeDesktop?: string | undefined;
292
- cursor?: string | undefined;
293
334
  codexCLI?: string | undefined;
294
335
  } | undefined;
295
336
  project_id?: string | undefined;
337
+ workspace_binding_id?: string | undefined;
296
338
  required_stores?: {
297
339
  id: string;
298
340
  suggested_remote?: string | undefined;
299
341
  }[] | undefined;
300
342
  active_write_store?: string | undefined;
301
343
  active_project?: string | undefined;
344
+ write_routes?: {
345
+ scope: string;
346
+ store: string;
347
+ }[] | undefined;
348
+ default_write_store?: string | undefined;
302
349
  scanIgnores?: string[] | undefined;
303
350
  audit_mode?: "strict" | "warn" | "off" | undefined;
304
351
  mcpPayloadLimits?: {
305
352
  warnBytes?: number | undefined;
306
353
  hardBytes?: number | undefined;
307
354
  } | undefined;
308
- fabric_language?: "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid" | undefined;
309
355
  default_layer_filter?: "personal" | "team" | "both" | undefined;
356
+ nudge_mode?: "silent" | "minimal" | "normal" | "verbose" | undefined;
357
+ observe?: {
358
+ session_start?: boolean | undefined;
359
+ pre_tool_use?: boolean | undefined;
360
+ stop?: boolean | undefined;
361
+ } | undefined;
310
362
  archive_hint_cooldown_hours?: number | undefined;
311
363
  underseed_node_threshold?: number | undefined;
312
364
  archive_edit_threshold?: number | undefined;
@@ -335,7 +387,7 @@ declare const fabricConfigSchema: z.ZodObject<{
335
387
  fabric_event_retention_days?: 7 | 30 | 90 | undefined;
336
388
  onboard_slots_opted_out?: string[] | undefined;
337
389
  hint_broad_top_k?: number | undefined;
338
- hint_broad_budget_chars?: number | undefined;
390
+ broad_index_backstop?: number | undefined;
339
391
  hint_dismiss_signals?: ("archive" | "review" | "import" | "maintenance")[] | undefined;
340
392
  cite_policy_enabled?: boolean | undefined;
341
393
  self_archive_policy_enabled?: boolean | undefined;
@@ -346,13 +398,11 @@ declare const fabricConfigSchema: z.ZodObject<{
346
398
  orphan_demote_proven_days?: number | undefined;
347
399
  orphan_demote_verified_days?: number | undefined;
348
400
  orphan_demote_draft_days?: number | undefined;
349
- orphan_demote_stable_days?: number | undefined;
350
- orphan_demote_endorsed_days?: number | undefined;
351
401
  hint_summary_max_len?: number | undefined;
352
402
  hint_reminder_to_context?: boolean | undefined;
353
403
  selection_token_ttl_ms?: number | undefined;
354
404
  plan_context_top_k?: number | undefined;
355
- retrieval_budget_profile?: "conservative" | "balanced" | "generous" | undefined;
405
+ recall_relevance_ratio?: number | undefined;
356
406
  embed_enabled?: boolean | undefined;
357
407
  embed_weight?: number | undefined;
358
408
  embed_model?: "fast-bge-small-zh-v1.5" | "fast-multilingual-e5-large" | "fast-bge-small-en-v1.5" | "fast-bge-small-en" | "fast-bge-base-en-v1.5" | "fast-bge-base-en" | "fast-all-MiniLM-L6-v2" | undefined;
@@ -361,7 +411,6 @@ declare const fabricConfigSchema: z.ZodObject<{
361
411
  interface ClientPaths {
362
412
  claudeCodeCLI?: string;
363
413
  claudeCodeDesktop?: string;
364
- cursor?: string;
365
414
  codexCLI?: string;
366
415
  }
367
416
  type AuditMode = "strict" | "warn" | "off";
@@ -373,4 +422,4 @@ type FabricLanguage = "match-existing" | "zh-CN" | "en" | "zh-CN-hybrid";
373
422
  type DefaultLayerFilter = "team" | "personal" | "both";
374
423
  type FabricConfig = z.input<typeof fabricConfigSchema>;
375
424
 
376
- export { type AgentsMetaNode as A, type ClientPaths as C, type DefaultLayerFilter as D, type FabricConfig as F, type HumanLockEntry as H, type LedgerEntry as L, type McpPayloadLimits as M, type RuleDescription as R, type AgentsIdentitySource as a, type AgentsLayer as b, type AgentsTopologyType as c, type AgentsMeta as d, type AgentsActivationTier as e, fabricConfigSchema as f, type AgentsMetaCountersEnvelope as g, type AgentsMetaKnowledgeTypeCounters as h, type AgentsMetaNodeActivation as i, type AiLedgerEntry as j, type AuditMode as k, type FabricLanguage as l, type HumanLedgerEntry as m, type RuleDescriptionIndexItem as n, auditModeSchema as o, clientPathsSchema as p, defaultLayerFilterSchema as q, fabricLanguageSchema as r, mcpPayloadLimitsSchema as s, planContextTopKSchema as t, selectionTokenTtlMsSchema as u };
425
+ export { type AgentsMetaNode as A, type ClientPaths as C, type DefaultLayerFilter as D, type FabricConfig as F, type HumanLockEntry as H, type LedgerEntry as L, type McpPayloadLimits as M, type RuleDescription as R, type AgentsIdentitySource as a, type AgentsTopologyType as b, type AgentsMeta as c, type AgentsMetaCountersEnvelope as d, type AgentsMetaKnowledgeTypeCounters as e, fabricConfigSchema as f, type AiLedgerEntry as g, type AuditMode as h, type FabricLanguage as i, type HumanLedgerEntry as j, type RuleDescriptionIndexItem as k, auditModeSchema as l, clientPathsSchema as m, defaultLayerFilterSchema as n, fabricLanguageSchema as o, mcpPayloadLimitsSchema as p, nudgeModeSchema as q, observeConfigSchema as r, planContextTopKSchema as s, selectionTokenTtlMsSchema as t, writeRouteSchema as w };