@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/README.md +2 -5
- package/content/agents-section.md +1 -1
- package/content/skills/coding.md +149 -0
- package/content/{skill.md → skills/jeeves.md} +1 -1
- package/content/skills/operations.md +125 -0
- package/content/skills/playbooks.md +75 -0
- package/content/skills/slack-bot-provisioner.md +57 -0
- package/content/tools-platform.md +34 -4
- package/dist/cli/jeeves/index.js +521 -116
- package/dist/cli/plugin/index.js +459 -32
- package/dist/cli/service/index.js +18 -25
- package/dist/index.d.ts +38 -30
- package/dist/index.js +564 -143
- package/package.json +26 -25
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
|
|
1355
|
+
* Memory budget accounting for MEMORY.md.
|
|
1359
1356
|
*
|
|
1360
1357
|
* @remarks
|
|
1361
|
-
*
|
|
1362
|
-
*
|
|
1363
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
1477
|
+
* Backward-compatible re-export of `seedSkills`.
|
|
1492
1478
|
*
|
|
1493
1479
|
* @remarks
|
|
1494
|
-
*
|
|
1495
|
-
*
|
|
1496
|
-
*
|
|
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
|
|
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,
|
|
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 };
|