agentsmesh 0.33.0 → 0.35.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.
@@ -172,11 +172,6 @@ interface GuardrailWarning {
172
172
  readonly message: string;
173
173
  }
174
174
 
175
- /**
176
- * Capture rejection errors thrown by {@link addLessonInto}. Kept in their own
177
- * module so `add.ts` stays focused on the mutation logic; re-exported from
178
- * `add.js` so every existing importer keeps its `from './add.js'` path.
179
- */
180
175
  declare class UnknownTopicError extends Error {
181
176
  readonly topic: string;
182
177
  readonly code = "UNKNOWN_TOPIC";
@@ -309,6 +304,8 @@ interface ValidationFinding {
309
304
  readonly code: string;
310
305
  readonly message: string;
311
306
  readonly lessonId?: string;
307
+ /** Every lesson one aggregate finding covers (machine-readable; the message names a few). */
308
+ readonly lessonIds?: readonly string[];
312
309
  readonly topicId?: string;
313
310
  readonly triggerId?: string;
314
311
  }
@@ -387,15 +384,20 @@ declare function importLegacyLessons(projectRoot: string, options: ImportLegacyO
387
384
  * cross-process mutex without any third-party dependency.
388
385
  *
389
386
  * Stale recovery: the holder writes its PID and start timestamp into the lock
390
- * dir. On contention we peek at the PID; if the process is gone or the lock is
391
- * older than `staleMs`, we evict it and retry.
387
+ * dir. On contention we peek at the PID: a dead same-host holder is evicted at
388
+ * once. A live holder (or one on another host, whose PID we cannot probe) is
389
+ * evicted only past `staleMs` — an hours-long bound that catches a hung
390
+ * process or a recycled PID, never a slow but healthy run.
392
391
  */
393
392
  interface LockOptions {
394
393
  /** Maximum retry attempts before throwing LockAcquisitionError. */
395
394
  retries?: number;
396
395
  /** Delay between retries in ms. */
397
396
  retryDelayMs?: number;
398
- /** Lock age beyond which an existing lock is treated as stale and evicted. */
397
+ /**
398
+ * Secondary age bound (default 6h): a lock older than this is evicted even
399
+ * when its holder PID is still alive or cannot be probed (other host).
400
+ */
399
401
  staleMs?: number;
400
402
  /** Human-readable lock name surfaced in LockAcquisitionError, e.g. "lessons lock". */
401
403
  label?: string;
package/dist/lessons.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { o as RankedLesson, j as LessonsQuery, A as AddLessonInput, a as AddLessonOptions, b as AddLessonResult } from './init-rvKjGLTB.js';
2
- export { c as AddLessonTriggers, D as DEFAULT_RECALL_LIMIT, X as DEFAULT_RECALL_MAX_TOKENS, I as ImportLegacyOptions, d as ImportLegacyReport, Y as LESSONS_LOCK_FILENAME, L as LESSONS_PROCEDURAL_RULE, e as Lesson, f as LessonStatus, g as LessonsGraph, Z as LessonsGraphExistsError, h as LessonsGraphSchema, i as LessonsPaths, M as MatchedLesson, k as MergeLessonsOptions, l as MergeLessonsResult, m as MutateOptions, R as RankOptions, n as RankReason, S as ScaffoldLessonsResult, p as StripMarkersOptions, q as StripMarkersReport, T as Topic, r as Trigger, s as TriggerKind, U as UnknownTopicError, V as ValidationFinding, t as ValidationLevel, u as ValidationReport, v as acquireLessonsLock, w as addLesson, x as graphFilePath, y as importLegacyLessons, _ as lessonsLockPath, z as lessonsPaths, B as loadLessonsGraph, C as mergeLessons, E as mutateLessonsGraph, F as parseGraph, G as queryLessons, H as rankLessons, J as scaffoldLessons, K as serializeGraph, N as stripLegacyMarkers, O as stripMarkersInGraph, P as toRelPath, Q as tryLoadLessonsGraph, W as validateLessonsGraph } from './init-rvKjGLTB.js';
1
+ import { o as RankedLesson, j as LessonsQuery, A as AddLessonInput, a as AddLessonOptions, b as AddLessonResult } from './init-C3pMnqoU.js';
2
+ export { c as AddLessonTriggers, D as DEFAULT_RECALL_LIMIT, X as DEFAULT_RECALL_MAX_TOKENS, I as ImportLegacyOptions, d as ImportLegacyReport, Y as LESSONS_LOCK_FILENAME, L as LESSONS_PROCEDURAL_RULE, e as Lesson, f as LessonStatus, g as LessonsGraph, Z as LessonsGraphExistsError, h as LessonsGraphSchema, i as LessonsPaths, M as MatchedLesson, k as MergeLessonsOptions, l as MergeLessonsResult, m as MutateOptions, R as RankOptions, n as RankReason, S as ScaffoldLessonsResult, p as StripMarkersOptions, q as StripMarkersReport, T as Topic, r as Trigger, s as TriggerKind, U as UnknownTopicError, V as ValidationFinding, t as ValidationLevel, u as ValidationReport, v as acquireLessonsLock, w as addLesson, x as graphFilePath, y as importLegacyLessons, _ as lessonsLockPath, z as lessonsPaths, B as loadLessonsGraph, C as mergeLessons, E as mutateLessonsGraph, F as parseGraph, G as queryLessons, H as rankLessons, J as scaffoldLessons, K as serializeGraph, N as stripLegacyMarkers, O as stripMarkersInGraph, P as toRelPath, Q as tryLoadLessonsGraph, W as validateLessonsGraph } from './init-C3pMnqoU.js';
3
3
  import 'zod';
4
4
 
5
5
  /**