@karmaniverous/jeeves 0.5.8 → 0.5.10

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/dist/index.d.ts CHANGED
@@ -295,11 +295,11 @@ declare const workspaceConfigSchema: z.ZodObject<{
295
295
  workspace: z.ZodOptional<z.ZodOptional<z.ZodString>>;
296
296
  configRoot: z.ZodOptional<z.ZodOptional<z.ZodString>>;
297
297
  gatewayUrl: z.ZodOptional<z.ZodOptional<z.ZodString>>;
298
+ devRepos: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
298
299
  }, z.core.$strip>>;
299
300
  memory: z.ZodOptional<z.ZodObject<{
300
301
  budget: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
301
302
  warningThreshold: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
302
- staleDays: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
303
303
  }, z.core.$strip>>;
304
304
  }, z.core.$strip>;
305
305
  /** Workspace config type. */
@@ -327,8 +327,6 @@ declare const WORKSPACE_CONFIG_DEFAULTS: {
327
327
  readonly budget: 20_000;
328
328
  /** Default warning threshold as a fraction of budget (80%). */
329
329
  readonly warningThreshold: 0.8;
330
- /** Default staleness threshold in days. */
331
- readonly staleDays: 30;
332
330
  };
333
331
  };
334
332
  /** Provenance source for a resolved config value. */
@@ -396,8 +394,6 @@ interface ResolvedCliConfig {
396
394
  budget: ResolvedValue<number>;
397
395
  /** Resolved warning threshold as a fraction of budget. */
398
396
  warningThreshold: ResolvedValue<number>;
399
- /** Resolved staleness threshold in days. */
400
- staleDays: ResolvedValue<number>;
401
397
  };
402
398
  }
403
399
 
@@ -576,6 +572,7 @@ declare class ComponentWriter {
576
572
  private readonly gatewayUrl;
577
573
  private readonly pendingCleanups;
578
574
  private cyclePromise;
575
+ private stopped;
579
576
  /** @internal */
580
577
  constructor(component: JeevesComponentDescriptor, options?: ComponentWriterOptions);
581
578
  /** The component's config directory path. */
@@ -1355,13 +1352,12 @@ declare function formatEndMarker(markerText: string): string;
1355
1352
  declare function shouldWrite(myVersion: string, existing: VersionStamp | undefined, stalenessThresholdMs?: number): boolean;
1356
1353
 
1357
1354
  /**
1358
- * Memory budget accounting and staleness detection for MEMORY.md.
1355
+ * Memory budget accounting for MEMORY.md.
1359
1356
  *
1360
1357
  * @remarks
1361
- * Scans MEMORY.md for ISO date patterns in H2/H3 headings and bullet items.
1362
- * Reports character count against a configured budget, warning threshold state,
1363
- * and stale section candidates. Does not auto-delete: review remains
1364
- * human- or agent-mediated (Decision 42).
1358
+ * Reports character count against a configured budget and warning threshold
1359
+ * state. Does not auto-delete: review remains human- or agent-mediated
1360
+ * (Decision 42). Staleness detection removed in v0.5.9 (Decision 45).
1365
1361
  */
1366
1362
  /** Result of memory hygiene analysis. */
1367
1363
  interface MemoryHygieneResult {
@@ -1377,10 +1373,6 @@ interface MemoryHygieneResult {
1377
1373
  warning: boolean;
1378
1374
  /** Whether usage exceeds the budget. */
1379
1375
  overBudget: boolean;
1380
- /** Number of H2 sections flagged as stale candidates. */
1381
- staleCandidates: number;
1382
- /** Names of stale sections. */
1383
- staleSectionNames: string[];
1384
1376
  }
1385
1377
  /** Options for memory hygiene analysis. */
1386
1378
  interface MemoryHygieneOptions {
@@ -1390,18 +1382,9 @@ interface MemoryHygieneOptions {
1390
1382
  budget: number;
1391
1383
  /** Warning threshold as a fraction of budget (0–1). */
1392
1384
  warningThreshold: number;
1393
- /** Staleness threshold in days. */
1394
- staleDays: number;
1395
1385
  }
1396
1386
  /**
1397
- * Extract the most recent ISO date from a string.
1398
- *
1399
- * @param text - Text to scan for dates.
1400
- * @returns The most recent date found, or undefined.
1401
- */
1402
- declare function extractMostRecentDate(text: string): Date | undefined;
1403
- /**
1404
- * Analyze MEMORY.md for budget and staleness.
1387
+ * Analyze MEMORY.md for budget health.
1405
1388
  *
1406
1389
  * @param options - Analysis configuration.
1407
1390
  * @returns Memory hygiene result.
@@ -1439,6 +1422,7 @@ declare function checkMemoryHealth(options: MemoryHygieneOptions): HeartbeatEntr
1439
1422
  * Platform template with live data, and writes managed sections using
1440
1423
  * `updateManagedSection`.
1441
1424
  */
1425
+
1442
1426
  /** Options for refreshPlatformContent. */
1443
1427
  interface RefreshPlatformContentOptions {
1444
1428
  /** Core library version for version-stamp convergence. */
@@ -1453,6 +1437,8 @@ interface RefreshPlatformContentOptions {
1453
1437
  pluginPackage?: string;
1454
1438
  /** Staleness threshold override in ms. */
1455
1439
  stalenessThresholdMs?: number;
1440
+ /** Pre-loaded workspace config (avoids redundant reads when caller already loaded it). */
1441
+ workspaceConfig?: WorkspaceConfig;
1456
1442
  }
1457
1443
  /**
1458
1444
  * Refresh platform content: SOUL.md, AGENTS.md, and TOOLS.md Platform section.
@@ -1488,20 +1474,42 @@ interface SeedContentOptions {
1488
1474
  declare function seedContent(options: SeedContentOptions): Promise<void>;
1489
1475
 
1490
1476
  /**
1491
- * Skill seeding: write the `jeeves` workspace skill unconditionally.
1477
+ * Backward-compatible re-export of `seedSkills`.
1492
1478
  *
1493
1479
  * @remarks
1494
- * The skill file is entirely generated — no user-authored content (Decision 48).
1495
- * Every installer (core CLI and component plugins) writes it unconditionally.
1496
- * Content is inlined at build time via `rollup-plugin-md.ts`.
1480
+ * Delegates to `seedSkills` which seeds all bundled platform skills.
1481
+ * Retained for API compatibility with existing component plugins.
1482
+ *
1483
+ * @module
1497
1484
  */
1498
1485
  /**
1499
- * Seed the jeeves workspace skill file.
1486
+ * Seed all bundled platform skills into the workspace.
1500
1487
  *
1501
1488
  * @param workspacePath - Workspace root directory.
1502
1489
  */
1503
1490
  declare function seedSkill(workspacePath: string): void;
1504
1491
 
1492
+ /**
1493
+ * Skill seeding: write all bundled platform skills to the workspace.
1494
+ *
1495
+ * @remarks
1496
+ * Skill files are entirely generated — no user-authored content (Decision 48).
1497
+ * Every installer (core CLI and component plugins) writes them unconditionally.
1498
+ * Content is inlined at build time via `rollup-plugin-md.ts`.
1499
+ *
1500
+ * @module
1501
+ */
1502
+ /**
1503
+ * Seed all bundled platform skills into the workspace.
1504
+ *
1505
+ * @remarks
1506
+ * Writes each skill to `{workspace}/skills/{name}/SKILL.md`, creating
1507
+ * directories as needed. Overwrites existing content unconditionally.
1508
+ *
1509
+ * @param workspacePath - Workspace root directory.
1510
+ */
1511
+ declare function seedSkills(workspacePath: string): void;
1512
+
1505
1513
  /**
1506
1514
  * Factory for the standard plugin tool set.
1507
1515
  *
@@ -1939,5 +1947,5 @@ declare function getErrorMessage(err: unknown): string;
1939
1947
  */
1940
1948
  declare function isTransientError(err: unknown): boolean;
1941
1949
 
1942
- export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, extractMostRecentDate, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getComponentConfigPath, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getErrorMessage, getPackageRoot, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, isTransientError, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, registerComponentConfigPath, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
1950
+ export { AGENTS_MARKERS, CLEANUP_FLAG, COMPONENT_CONFIG_PREFIX, COMPONENT_VERSIONS_FILE, CONFIG_FILE, CORE_CONFIG_DIR, CORE_VERSION, ComponentWriter, DEFAULT_BIND_ADDRESS, DEFAULT_CORE_VERSION, DEFAULT_PORTS, HEARTBEAT_HEADING, JEEVES_SKILL_DIR, MEMORY_HEARTBEAT_NAME, META_PORT, PLATFORM_COMPONENTS, REGISTRY_CACHE_FILE, RUNNER_PORT, SECTION_IDS, SECTION_ORDER, SERVER_PORT, SKILLS_DIR, SOUL_MARKERS, STALENESS_THRESHOLD_MS, STALE_LOCK_MS, TEMPLATES_DIR, TOOLS_MARKERS, VERSION_STAMP_PATTERN, WATCHER_PORT, WORKSPACE_CONFIG_DEFAULTS, WORKSPACE_CONFIG_FILE, WORKSPACE_FILES, analyzeMemory, appendJsonl, atomicWrite, buildEffectiveConfig, buildHeartbeatSection, checkMemoryHealth, checkNodeVersion, checkRegistryVersion, connectionFail, coreConfigSchema, createAsyncContentCache, createComponentWriter, createConfigApplyHandler, createConfigQueryHandler, createGoogleAuth, createPluginCli, createPluginToolset, createServiceCli, createServiceManager, createStatusHandler, ensureDir, fail, fetchJson, fetchWithTimeout, formatBeginMarker, formatEndMarker, generateJsonSchema, generateWorkspaceJsonSchema, getArg, getBindAddress, getChannelWorkspace, getComponentConfigDir, getComponentConfigPath, getConfigRoot, getCoreConfigDir, getCoreConfigFile, getEffectiveServiceName, getErrorMessage, getPackageRoot, getPackageVersion, getServiceState, getServiceUrl, getWorkspacePath, init, isPrime, isTransientError, jaccard, jeevesComponentDescriptorSchema, loadEnvFile, loadWorkspaceConfig, needsCleanup, nowIso, ok, orchestrateHeartbeat, parseArgs, parseHeartbeat, parseManaged, patchConfig, postJson, readComponentVersions, readJson, readJsonl, refreshPlatformContent, registerComponentConfigPath, removeComponentVersion, removeManagedSection, resetInit, resolveConfigPath, resolveConfigValue, resolveOpenClawHome, resolveOptionalPluginSetting, resolvePluginSetting, resolveWorkspacePath, run, runScript, runWithRetry, saveCache, seedContent, seedSkill, seedSkills, shingles, shouldWrite, sleepAsync, sleepMs, updateManagedSection, uuid, withFileLock, workspaceConfigSchema, writeComponentVersion, writeHeartbeatSection, writeJsonAtomic, writeJsonl };
1943
1951
  export type { AccountConfig, AsyncContentCacheOptions, ComponentDependencies, ComponentState, ComponentVersionEntry, ComponentVersionsState, ComponentWriterOptions, ConfigApplyHandler, ConfigApplyRequest, ConfigApplyResult, ConfigProvenance, ConfigQueryHandler, ConfigQueryResponse, CoreConfig, CreatePluginCliOptions, CreateStatusHandlerOptions, GoogleAuthOptions, HeartbeatEntry, InitOptions, JeevesComponentDescriptor, ManagedMarkers, ManagedSection, MemoryHygieneOptions, MemoryHygieneResult, OrchestrateHeartbeatOptions, ParseManagedResult, ParsedHeartbeat, PlatformComponent, PluginApi, PluginInstallRecord, RefreshPlatformContentOptions, RemoveManagedSectionOptions, ResolvedCliConfig, ResolvedValue, RetryOptions, RunOptions, SectionId, SeedContentOptions, ServiceAccountFileConfig, ServiceManager, ServiceManagerOptions, ServiceState, SlackWorkspaceOptions, StatusHandler, StatusHandlerResult, StatusResponse, ToolDescriptor, ToolRegistrationOptions, ToolResult, UpdateManagedSectionOptions, VersionStamp, WorkspaceConfig, WorkspaceOptions, WriteComponentVersionOptions };