@karmaniverous/jeeves-meta 0.17.0 → 0.18.0-1

package/dist/ema.d.ts

@@ -1,14 +0,0 @@
-/**
- * Exponential moving average helper for token tracking.
- *
- * @module ema
- */
-/**
- * Compute exponential moving average.
- *
- * @param current - New observation.
- * @param previous - Previous EMA value, or undefined for first observation.
- * @param decay - Decay factor (0-1). Higher = more weight on new value. Default 0.3.
- * @returns Updated EMA.
- */
-export declare function computeEma(current: number, previous: number | undefined, decay?: number): number;

package/dist/errors.d.ts

@@ -1,15 +0,0 @@
-/**
- * Shared error utilities.
- *
- * @module errors
- */
-import type { MetaError } from './schema/index.js';
-/**
- * Wrap an unknown caught value into a MetaError.
- *
- * @param step - Which synthesis step failed.
- * @param err - The caught error value.
- * @param code - Error classification code.
- * @returns A structured MetaError.
- */
-export declare function toMetaError(step: MetaError['step'], err: unknown, code?: string): MetaError;

package/dist/escapeGlob.d.ts

@@ -1,23 +0,0 @@
-/**
- * Escape special glob characters in a path so it can be used as a literal
- * prefix in glob patterns.
- *
- * Glob metacharacters `* ? [ ] { } ( ) !` are escaped with a backslash so
- * that paths containing parentheses (e.g. Slack channel IDs) or other
- * special characters are matched literally by the watcher's walk endpoint.
- *
- * @module escapeGlob
- */
-/**
- * Escape glob metacharacters in a string using character-class wrapping.
- *
- * Backslash escaping (`\(`) does not work reliably on Windows where `\` is
- * the path separator. Instead, each metacharacter is wrapped in a character
- * class (e.g. `(` → `[(]`) which is universally supported by glob libraries.
- *
- * Square brackets themselves are escaped as `[[]` and `[]]`.
- *
- * @param s - Raw path string.
- * @returns String with glob metacharacters wrapped in character classes.
- */
-export declare function escapeGlob(s: string): string;

package/dist/executor/GatewayExecutor.d.ts

@@ -1,79 +0,0 @@
-/**
- * MetaExecutor implementation using the OpenClaw gateway HTTP API.
- *
- * Lives in the library package so both plugin and runner can import it.
- * Spawns sub-agent sessions via the gateway's `/tools/invoke` endpoint,
- * polls for completion, and extracts output text.
- *
- * @module executor/GatewayExecutor
- */
-import type { MetaExecutor, MetaSpawnOptions, MetaSpawnResult } from '../interfaces/index.js';
-/** Options for the GatewayExecutor. */
-export interface GatewayExecutorOptions {
-    /** OpenClaw gateway base URL. Default: http://127.0.0.1:18789 */
-    gatewayUrl?: string;
-    /** Bearer token for gateway authentication. */
-    apiKey?: string;
-    /** Polling interval in ms. Default: 5000. */
-    pollIntervalMs?: number;
-    /** Workspace directory for output staging. Default: OS temp dir + /jeeves-meta. */
-    workspaceDir?: string;
-    /** Max retries when staging file not yet visible after session completion. Default: 10. */
-    stagingRetries?: number;
-    /** Delay between retries in ms. Default: 250. */
-    stagingRetryDelayMs?: number;
-}
-/**
- * MetaExecutor that spawns OpenClaw sessions via the gateway's
- * `/tools/invoke` endpoint.
- *
- * Used by both the OpenClaw plugin (in-process tool calls) and the
- * runner/CLI (external invocation). Constructs from `gatewayUrl` and
- * optional `apiKey` — typically sourced from `MetaConfig`.
- */
-export declare class GatewayExecutor implements MetaExecutor {
-    private readonly gatewayUrl;
-    private readonly apiKey;
-    private readonly pollIntervalMs;
-    private readonly workspaceDir;
-    private readonly stagingRetries;
-    private readonly stagingRetryDelayMs;
-    private controller;
-    constructor(options?: GatewayExecutorOptions);
-    /** Remove a temp output file if it exists. */
-    private cleanupOutputFile;
-    /** Read and clean up the staging output file. Returns content or undefined if absent. */
-    private readStagingFile;
-    /** Extract plain text from a message content field, skipping ANNOUNCE_SKIP sentinels. */
-    private static extractMessageText;
-    /**
-     * Check history messages for timeout detection.
-     *
-     * Does NOT determine completion — session completion is authoritative
-     * (via sessions_list). History stop reasons can false-positive on
-     * sessions_yield artifacts (#200).
-     */
-    private static checkHistoryCompletion;
-    /** Invoke a gateway tool via the /tools/invoke HTTP endpoint. */
-    private invoke;
-    /**
-     * Look up session metadata (tokens, completion status) via sessions_list.
-     *
-     * Detects gateway-side timeout (`status: "timeout"`) and killed sessions
-     * (`status: "killed"`) as completed, with a `timedOut` flag to distinguish
-     * timeout from normal completion.
-     */
-    private getSessionInfo;
-    /** Whether this executor has been aborted by the operator. */
-    get aborted(): boolean;
-    /** Abort the currently running spawn, if any. */
-    abort(): void;
-    /**
-     * Query the gateway's configured subagent run timeout.
-     *
-     * Returns the value in milliseconds, or `undefined` if the query fails
-     * or the value is absent/zero (no timeout configured).
-     */
-    private queryGatewayRunTimeout;
-    spawn(task: string, options?: MetaSpawnOptions): Promise<MetaSpawnResult>;
-}

package/dist/executor/SpawnAbortedError.d.ts

@@ -1,9 +0,0 @@
-/**
- * Error thrown when a spawned subprocess is aborted via AbortController.
- *
- * @module executor/SpawnAbortedError
- */
-/** Error indicating a spawn was deliberately aborted. */
-export declare class SpawnAbortedError extends Error {
-    constructor(message?: string);
-}

package/dist/executor/SpawnTimeoutError.d.ts

@@ -1,13 +0,0 @@
-/**
- * Error thrown when a spawned subprocess times out.
- *
- * Carries the output file path so callers can attempt partial output recovery.
- *
- * @module executor/SpawnTimeoutError
- */
-/** Error indicating a spawn timeout with a recoverable output path. */
-export declare class SpawnTimeoutError extends Error {
-    /** Path to the (possibly partial) output file written before timeout. */
-    readonly outputPath: string;
-    constructor(message: string, outputPath: string);
-}

package/dist/executor/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Re-exports for the executor module.
- *
- * @module executor
- */
-export { GatewayExecutor, type GatewayExecutorOptions, } from './GatewayExecutor.js';
-export { SpawnAbortedError } from './SpawnAbortedError.js';
-export { SpawnTimeoutError } from './SpawnTimeoutError.js';

package/dist/index.d.ts

@@ -1,35 +0,0 @@
-/**
- * Jeeves Meta Service — knowledge synthesis HTTP service for the Jeeves platform.
- *
- * @packageDocumentation
- */
-export { createSnapshot, listArchiveFiles, pruneArchive, readLatestArchive, } from './archive/index.js';
-export { DEFAULT_PORT, DEFAULT_PORT_STR, SERVICE_NAME, SERVICE_VERSION, } from './constants.js';
-export { registerCustomCliCommands } from './customCliCommands.js';
-export { metaDescriptor, RESTART_REQUIRED_FIELDS } from './descriptor.js';
-export { loadServiceConfig, migrateConfigPath, resolveConfigPath, } from './configLoader.js';
-export { buildOwnershipTree, discoverMetas, filterInScope, findNode, getScopePrefix, listMetas, type MetaEntry, type MetaListResult, type MetaListSummary, type MetaNode, type OwnershipTree, } from './discovery/index.js';
-export { computeEma } from './ema.js';
-export { toMetaError } from './errors.js';
-export { acquireLock, cleanupStaleLocks, isLocked, type LockState, readLockState, releaseLock, resolveMetaDir, } from './lock.js';
-export { normalizePath } from './normalizePath.js';
-export { computeStructureHash } from './structureHash.js';
-export { GatewayExecutor, type GatewayExecutorOptions, } from './executor/index.js';
-export type { InferenceRuleSpec, MetaContext, MetaExecutor, MetaSpawnOptions, MetaSpawnResult, WatcherClient, WatcherScanPoint, WatcherScanRequest, WatcherScanResult, } from './interfaces/index.js';
-export type { LoggerConfig } from './logger/index.js';
-export { createLogger, type MinimalLogger } from './logger/index.js';
-export { buildArchitectTask, buildBuilderTask, buildContextPackage, buildCriticTask, type BuilderOutput, orchestratePhase, type OrchestratePhaseResult, parseArchitectOutput, parseBuilderOutput, parseCriticOutput, type PhaseProgressCallback, type PhaseResult, runArchitect, runBuilder, runCritic, } from './orchestrator/index.js';
-export { type ProgressEvent, type ProgressPhase, ProgressReporter, type ProgressReporterConfig, renderProgressEvent, type TemplateStrings, } from './progress/index.js';
-export { actualStaleness, computeEffectiveStaleness, hasSteerChanged, isArchitectTriggered, isStale, MAX_STALENESS_SECONDS, type StalenessCandidate, } from './scheduling/index.js';
-export { type MetaConfig, metaConfigSchema, type MetaError, metaErrorSchema, type MetaJson, metaJsonSchema, type ServiceConfig, serviceConfigSchema, } from './schema/index.js';
-export { Scheduler } from './scheduler/index.js';
-export { type CurrentItem, type EnqueueResult, type QueueEntry, type QueueState, SynthesisQueue, } from './queue/index.js';
-export { registerRoutes, type RouteDeps, type ServiceStats, } from './routes/index.js';
-export { RuleRegistrar } from './rules/index.js';
-export { verifyRuleApplication } from './rules/verify.js';
-export { sleepAsync as sleep } from '@karmaniverous/jeeves';
-export type { ServerOptions } from './server.js';
-export { createServer } from './server.js';
-export { registerShutdownHandlers } from './shutdown/index.js';
-export { HttpWatcherClient, type HttpWatcherClientOptions, } from './watcher-client/index.js';
-export { startService } from './bootstrap.js';