@keyueclaw/web-sdk 0.1.82 → 0.1.83

package/dist/src/config/mcp-config.d.ts

@@ -1,33 +0,0 @@
-import type { OpenClawConfig } from "./types.openclaw.js";
-export type ConfigMcpServers = Record<string, Record<string, unknown>>;
-type ConfigMcpReadResult = {
-    ok: true;
-    path: string;
-    config: OpenClawConfig;
-    mcpServers: ConfigMcpServers;
-} | {
-    ok: false;
-    path: string;
-    error: string;
-};
-type ConfigMcpWriteResult = {
-    ok: true;
-    path: string;
-    config: OpenClawConfig;
-    mcpServers: ConfigMcpServers;
-    removed?: boolean;
-} | {
-    ok: false;
-    path: string;
-    error: string;
-};
-export declare function normalizeConfiguredMcpServers(value: unknown): ConfigMcpServers;
-export declare function listConfiguredMcpServers(): Promise<ConfigMcpReadResult>;
-export declare function setConfiguredMcpServer(params: {
-    name: string;
-    server: unknown;
-}): Promise<ConfigMcpWriteResult>;
-export declare function unsetConfiguredMcpServer(params: {
-    name: string;
-}): Promise<ConfigMcpWriteResult>;
-export {};

package/dist/src/config/merge-patch.d.ts

@@ -1,5 +0,0 @@
-type MergePatchOptions = {
-    mergeObjectArraysById?: boolean;
-};
-export declare function applyMergePatch(base: unknown, patch: unknown, options?: MergePatchOptions): unknown;
-export {};

package/dist/src/config/model-input.d.ts

@@ -1,9 +0,0 @@
-import type { AgentModelConfig } from "./types.agents-shared.js";
-type AgentModelListLike = {
-    primary?: string;
-    fallbacks?: string[];
-};
-export declare function resolveAgentModelPrimaryValue(model?: AgentModelConfig): string | undefined;
-export declare function resolveAgentModelFallbackValues(model?: AgentModelConfig): string[];
-export declare function toAgentModelListLike(model?: AgentModelConfig): AgentModelListLike | undefined;
-export {};

package/dist/src/config/normalize-exec-safe-bin.d.ts

@@ -1,2 +0,0 @@
-import type { OpenClawConfig } from "./types.js";
-export declare function normalizeExecSafeBinProfilesInConfig(cfg: OpenClawConfig): void;

package/dist/src/config/normalize-paths.d.ts

@@ -1,8 +0,0 @@
-import type { OpenClawConfig } from "./types.js";
-/**
- * Normalize "~" paths in path-ish config fields.
- *
- * Goal: accept `~/...` consistently across config file + env overrides, while
- * keeping the surface area small and predictable.
- */
-export declare function normalizeConfigPaths(cfg: OpenClawConfig): OpenClawConfig;

package/dist/src/config/paths.d.ts

@@ -1,57 +0,0 @@
-import type { OpenClawConfig } from "./types.js";
-/**
- * Nix mode detection: When OPENCLAW_NIX_MODE=1, the gateway is running under Nix.
- * In this mode:
- * - No auto-install flows should be attempted
- * - Missing dependencies should produce actionable Nix-specific error messages
- * - Config is managed externally (read-only from Nix perspective)
- */
-export declare function resolveIsNixMode(env?: NodeJS.ProcessEnv): boolean;
-export declare const isNixMode: boolean;
-export declare function resolveLegacyStateDir(homedir?: () => string): string;
-export declare function resolveLegacyStateDirs(homedir?: () => string): string[];
-export declare function resolveNewStateDir(homedir?: () => string): string;
-/**
- * State directory for mutable data (sessions, logs, caches).
- * Can be overridden via OPENCLAW_STATE_DIR.
- * Default: ~/.openclaw
- */
-export declare function resolveStateDir(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
-export declare const STATE_DIR: string;
-/**
- * Config file path (JSON5).
- * Can be overridden via OPENCLAW_CONFIG_PATH.
- * Default: ~/.openclaw/openclaw.json (or $OPENCLAW_STATE_DIR/openclaw.json)
- */
-export declare function resolveCanonicalConfigPath(env?: NodeJS.ProcessEnv, stateDir?: string): string;
-/**
- * Resolve the active config path by preferring existing config candidates
- * before falling back to the canonical path.
- */
-export declare function resolveConfigPathCandidate(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
-/**
- * Active config path (prefers existing config files).
- */
-export declare function resolveConfigPath(env?: NodeJS.ProcessEnv, stateDir?: string, homedir?: () => string): string;
-export declare const CONFIG_PATH: string;
-/**
- * Resolve default config path candidates across default locations.
- * Order: explicit config path → state-dir-derived paths → new default.
- */
-export declare function resolveDefaultConfigCandidates(env?: NodeJS.ProcessEnv, homedir?: () => string): string[];
-export declare const DEFAULT_GATEWAY_PORT = 18789;
-/**
- * Gateway lock directory (ephemeral).
- * Default: os.tmpdir()/openclaw-<uid> (uid suffix when available).
- */
-export declare function resolveGatewayLockDir(tmpdir?: () => string): string;
-/**
- * OAuth credentials storage directory.
- *
- * Precedence:
- * - `OPENCLAW_OAUTH_DIR` (explicit override)
- * - `$*_STATE_DIR/credentials` (canonical server/default)
- */
-export declare function resolveOAuthDir(env?: NodeJS.ProcessEnv, stateDir?: string): string;
-export declare function resolveOAuthPath(env?: NodeJS.ProcessEnv, stateDir?: string): string;
-export declare function resolveGatewayPort(cfg?: OpenClawConfig, env?: NodeJS.ProcessEnv): number;

package/dist/src/config/plugin-auto-enable.d.ts

@@ -1,15 +0,0 @@
-import { type PluginManifestRegistry } from "../plugins/manifest-registry.js";
-import type { OpenClawConfig } from "./config.js";
-export type PluginAutoEnableResult = {
-    config: OpenClawConfig;
-    changes: string[];
-};
-export declare function isChannelConfigured(cfg: OpenClawConfig, channelId: string, env?: NodeJS.ProcessEnv): boolean;
-export declare function applyPluginAutoEnable(params: {
-    config: OpenClawConfig;
-    env?: NodeJS.ProcessEnv;
-    /** Pre-loaded manifest registry. When omitted, the registry is loaded from
-     *  the installed plugins on disk. Pass an explicit registry in tests to
-     *  avoid filesystem access and control what plugins are "installed". */
-    manifestRegistry?: PluginManifestRegistry;
-}): PluginAutoEnableResult;

package/dist/src/config/plugins-allowlist.d.ts

@@ -1,2 +0,0 @@
-import type { OpenClawConfig } from "./config.js";
-export declare function ensurePluginAllowlisted(cfg: OpenClawConfig, pluginId: string): OpenClawConfig;

package/dist/src/config/port-defaults.d.ts

@@ -1,13 +0,0 @@
-export type PortRange = {
-    start: number;
-    end: number;
-};
-export declare const DEFAULT_BRIDGE_PORT = 18790;
-export declare const DEFAULT_BROWSER_CONTROL_PORT = 18791;
-export declare const DEFAULT_CANVAS_HOST_PORT = 18793;
-export declare const DEFAULT_BROWSER_CDP_PORT_RANGE_START = 18800;
-export declare const DEFAULT_BROWSER_CDP_PORT_RANGE_END = 18899;
-export declare function deriveDefaultBridgePort(gatewayPort: number): number;
-export declare function deriveDefaultBrowserControlPort(gatewayPort: number): number;
-export declare function deriveDefaultCanvasHostPort(gatewayPort: number): number;
-export declare function deriveDefaultBrowserCdpPortRange(browserControlPort: number): PortRange;

package/dist/src/config/prototype-keys.d.ts

@@ -1 +0,0 @@
-export { isBlockedObjectKey } from "../infra/prototype-keys.js";

package/dist/src/config/runtime-group-policy.d.ts

@@ -1,56 +0,0 @@
-import type { GroupPolicy } from "./types.base.js";
-export type RuntimeGroupPolicyResolution = {
-    groupPolicy: GroupPolicy;
-    providerMissingFallbackApplied: boolean;
-};
-export type RuntimeGroupPolicyParams = {
-    providerConfigPresent: boolean;
-    groupPolicy?: GroupPolicy;
-    defaultGroupPolicy?: GroupPolicy;
-    configuredFallbackPolicy?: GroupPolicy;
-    missingProviderFallbackPolicy?: GroupPolicy;
-};
-export declare function resolveRuntimeGroupPolicy(params: RuntimeGroupPolicyParams): RuntimeGroupPolicyResolution;
-export type ResolveProviderRuntimeGroupPolicyParams = {
-    providerConfigPresent: boolean;
-    groupPolicy?: GroupPolicy;
-    defaultGroupPolicy?: GroupPolicy;
-};
-export type GroupPolicyDefaultsConfig = {
-    channels?: {
-        defaults?: {
-            groupPolicy?: GroupPolicy;
-        };
-    };
-};
-export declare function resolveDefaultGroupPolicy(cfg: GroupPolicyDefaultsConfig): GroupPolicy | undefined;
-export declare const GROUP_POLICY_BLOCKED_LABEL: {
-    readonly group: "group messages";
-    readonly guild: "guild messages";
-    readonly room: "room messages";
-    readonly channel: "channel messages";
-    readonly space: "space messages";
-};
-/**
- * Standard provider runtime policy:
- * - configured provider fallback: open
- * - missing provider fallback: allowlist (fail-closed)
- */
-export declare function resolveOpenProviderRuntimeGroupPolicy(params: ResolveProviderRuntimeGroupPolicyParams): RuntimeGroupPolicyResolution;
-/**
- * Strict provider runtime policy:
- * - configured provider fallback: allowlist
- * - missing provider fallback: allowlist (fail-closed)
- */
-export declare function resolveAllowlistProviderRuntimeGroupPolicy(params: ResolveProviderRuntimeGroupPolicyParams): RuntimeGroupPolicyResolution;
-export declare function warnMissingProviderGroupPolicyFallbackOnce(params: {
-    providerMissingFallbackApplied: boolean;
-    providerKey: string;
-    accountId?: string;
-    blockedLabel?: string;
-    log: (message: string) => void;
-}): boolean;
-/**
- * Test helper. Keeps warning-cache state deterministic across test files.
- */
-export declare function resetMissingProviderGroupPolicyFallbackWarningsForTesting(): void;

package/dist/src/config/runtime-overrides.d.ts

@@ -1,15 +0,0 @@
-import type { OpenClawConfig } from "./types.js";
-type OverrideTree = Record<string, unknown>;
-export declare function getConfigOverrides(): OverrideTree;
-export declare function resetConfigOverrides(): void;
-export declare function setConfigOverride(pathRaw: string, value: unknown): {
-    ok: boolean;
-    error?: string;
-};
-export declare function unsetConfigOverride(pathRaw: string): {
-    ok: boolean;
-    removed: boolean;
-    error?: string;
-};
-export declare function applyConfigOverrides(cfg: OpenClawConfig): OpenClawConfig;
-export {};

package/dist/src/config/sessions/artifacts.d.ts

@@ -1,5 +0,0 @@
-export type SessionArchiveReason = "bak" | "reset" | "deleted";
-export declare function isSessionArchiveArtifactName(fileName: string): boolean;
-export declare function isPrimarySessionTranscriptFileName(fileName: string): boolean;
-export declare function formatSessionArchiveTimestamp(nowMs?: number): string;
-export declare function parseSessionArchiveTimestamp(fileName: string, reason: SessionArchiveReason): number | null;

package/dist/src/config/sessions/delivery-info.d.ts

@@ -1,16 +0,0 @@
-/**
- * Extract deliveryContext and threadId from a sessionKey.
- * Supports both :thread: (most channels) and :topic: (Telegram).
- */
-export declare function parseSessionThreadInfo(sessionKey: string | undefined): {
-    baseSessionKey: string | undefined;
-    threadId: string | undefined;
-};
-export declare function extractDeliveryInfo(sessionKey: string | undefined): {
-    deliveryContext: {
-        channel?: string;
-        to?: string;
-        accountId?: string;
-    } | undefined;
-    threadId: string | undefined;
-};

package/dist/src/config/sessions/disk-budget.d.ts

@@ -1,28 +0,0 @@
-import type { SessionEntry } from "./types.js";
-export type SessionDiskBudgetConfig = {
-    maxDiskBytes: number | null;
-    highWaterBytes: number | null;
-};
-export type SessionDiskBudgetSweepResult = {
-    totalBytesBefore: number;
-    totalBytesAfter: number;
-    removedFiles: number;
-    removedEntries: number;
-    freedBytes: number;
-    maxBytes: number;
-    highWaterBytes: number;
-    overBudget: boolean;
-};
-export type SessionDiskBudgetLogger = {
-    warn: (message: string, context?: Record<string, unknown>) => void;
-    info: (message: string, context?: Record<string, unknown>) => void;
-};
-export declare function enforceSessionDiskBudget(params: {
-    store: Record<string, SessionEntry>;
-    storePath: string;
-    activeSessionKey?: string;
-    maintenance: SessionDiskBudgetConfig;
-    warnOnly: boolean;
-    dryRun?: boolean;
-    log?: SessionDiskBudgetLogger;
-}): Promise<SessionDiskBudgetSweepResult | null>;

package/dist/src/config/sessions/explicit-session-key-normalization.d.ts

@@ -1,2 +0,0 @@
-import type { MsgContext } from "../../auto-reply/templating.js";
-export declare function normalizeExplicitSessionKey(sessionKey: string, ctx: MsgContext): string;

package/dist/src/config/sessions/group.d.ts

@@ -1,11 +0,0 @@
-import type { MsgContext } from "../../auto-reply/templating.js";
-import type { GroupKeyResolution } from "./types.js";
-export declare function buildGroupDisplayName(params: {
-    provider?: string;
-    subject?: string;
-    groupChannel?: string;
-    space?: string;
-    id?: string;
-    key: string;
-}): string;
-export declare function resolveGroupSessionKey(ctx: MsgContext): GroupKeyResolution | null;

package/dist/src/config/sessions/main-session.d.ts

@@ -1,42 +0,0 @@
-import { resolveAgentIdFromSessionKey } from "../../routing/session-key.js";
-import type { SessionScope } from "./types.js";
-export declare function resolveMainSessionKey(cfg?: {
-    session?: {
-        scope?: SessionScope;
-        mainKey?: string;
-    };
-    agents?: {
-        list?: Array<{
-            id?: string;
-            default?: boolean;
-        }>;
-    };
-}): string;
-export { resolveAgentIdFromSessionKey };
-export declare function resolveAgentMainSessionKey(params: {
-    cfg?: {
-        session?: {
-            mainKey?: string;
-        };
-    };
-    agentId: string;
-}): string;
-export declare function resolveExplicitAgentSessionKey(params: {
-    cfg?: {
-        session?: {
-            scope?: SessionScope;
-            mainKey?: string;
-        };
-    };
-    agentId?: string | null;
-}): string | undefined;
-export declare function canonicalizeMainSessionAlias(params: {
-    cfg?: {
-        session?: {
-            scope?: SessionScope;
-            mainKey?: string;
-        };
-    };
-    agentId: string;
-    sessionKey: string;
-}): string;

package/dist/src/config/sessions/main-session.runtime.d.ts

@@ -1 +0,0 @@
-export declare function resolveMainSessionKeyFromConfig(): string;

package/dist/src/config/sessions/metadata.d.ts

@@ -1,16 +0,0 @@
-import type { MsgContext } from "../../auto-reply/templating.js";
-import type { GroupKeyResolution, SessionEntry, SessionOrigin } from "./types.js";
-export declare function deriveSessionOrigin(ctx: MsgContext): SessionOrigin | undefined;
-export declare function snapshotSessionOrigin(entry?: SessionEntry): SessionOrigin | undefined;
-export declare function deriveGroupSessionPatch(params: {
-    ctx: MsgContext;
-    sessionKey: string;
-    existing?: SessionEntry;
-    groupResolution?: GroupKeyResolution | null;
-}): Partial<SessionEntry> | null;
-export declare function deriveSessionMetaPatch(params: {
-    ctx: MsgContext;
-    sessionKey: string;
-    existing?: SessionEntry;
-    groupResolution?: GroupKeyResolution | null;
-}): Partial<SessionEntry> | null;

package/dist/src/config/sessions/paths.d.ts

@@ -1,23 +0,0 @@
-export declare function resolveSessionTranscriptsDir(env?: NodeJS.ProcessEnv, homedir?: () => string): string;
-export declare function resolveSessionTranscriptsDirForAgent(agentId?: string, env?: NodeJS.ProcessEnv, homedir?: () => string): string;
-export declare function resolveDefaultSessionStorePath(agentId?: string): string;
-export type SessionFilePathOptions = {
-    agentId?: string;
-    sessionsDir?: string;
-};
-export declare function resolveSessionFilePathOptions(params: {
-    agentId?: string;
-    storePath?: string;
-}): SessionFilePathOptions | undefined;
-export declare const SAFE_SESSION_ID_RE: RegExp;
-export declare function validateSessionId(sessionId: string): string;
-export declare function resolveSessionTranscriptPathInDir(sessionId: string, sessionsDir: string, topicId?: string | number): string;
-export declare function resolveSessionTranscriptPath(sessionId: string, agentId?: string, topicId?: string | number): string;
-export declare function resolveSessionFilePath(sessionId: string, entry?: {
-    sessionFile?: string;
-}, opts?: SessionFilePathOptions): string;
-export declare function resolveStorePath(store?: string, opts?: {
-    agentId?: string;
-    env?: NodeJS.ProcessEnv;
-}): string;
-export declare function resolveAgentsDirFromSessionStorePath(storePath: string): string | undefined;

package/dist/src/config/sessions/reset.d.ts

@@ -1,43 +0,0 @@
-import type { SessionConfig, SessionResetConfig } from "../types.base.js";
-export type SessionResetMode = "daily" | "idle";
-export type SessionResetType = "direct" | "group" | "thread";
-export type SessionResetPolicy = {
-    mode: SessionResetMode;
-    atHour: number;
-    idleMinutes?: number;
-};
-export type SessionFreshness = {
-    fresh: boolean;
-    dailyResetAt?: number;
-    idleExpiresAt?: number;
-};
-export declare const DEFAULT_RESET_MODE: SessionResetMode;
-export declare const DEFAULT_RESET_AT_HOUR = 4;
-export declare function isThreadSessionKey(sessionKey?: string | null): boolean;
-export declare function resolveSessionResetType(params: {
-    sessionKey?: string | null;
-    isGroup?: boolean;
-    isThread?: boolean;
-}): SessionResetType;
-export declare function resolveThreadFlag(params: {
-    sessionKey?: string | null;
-    messageThreadId?: string | number | null;
-    threadLabel?: string | null;
-    threadStarterBody?: string | null;
-    parentSessionKey?: string | null;
-}): boolean;
-export declare function resolveDailyResetAtMs(now: number, atHour: number): number;
-export declare function resolveSessionResetPolicy(params: {
-    sessionCfg?: SessionConfig;
-    resetType: SessionResetType;
-    resetOverride?: SessionResetConfig;
-}): SessionResetPolicy;
-export declare function resolveChannelResetConfig(params: {
-    sessionCfg?: SessionConfig;
-    channel?: string | null;
-}): SessionResetConfig | undefined;
-export declare function evaluateSessionFreshness(params: {
-    updatedAt: number;
-    now: number;
-    policy: SessionResetPolicy;
-}): SessionFreshness;

package/dist/src/config/sessions/session-file.d.ts

@@ -1,15 +0,0 @@
-import type { SessionEntry } from "./types.js";
-export declare function resolveAndPersistSessionFile(params: {
-    sessionId: string;
-    sessionKey: string;
-    sessionStore: Record<string, SessionEntry>;
-    storePath: string;
-    sessionEntry?: SessionEntry;
-    agentId?: string;
-    sessionsDir?: string;
-    fallbackSessionFile?: string;
-    activeSessionKey?: string;
-}): Promise<{
-    sessionFile: string;
-    sessionEntry: SessionEntry;
-}>;

package/dist/src/config/sessions/session-key.d.ts

@@ -1,8 +0,0 @@
-import type { MsgContext } from "../../auto-reply/templating.js";
-import type { SessionScope } from "./types.js";
-export declare function deriveSessionKey(scope: SessionScope, ctx: MsgContext): string;
-/**
- * Resolve the session key with a canonical direct-chat bucket (default: "main").
- * All non-group direct chats collapse to this bucket; groups stay isolated.
- */
-export declare function resolveSessionKey(scope: SessionScope, ctx: MsgContext, mainKey?: string): string;

package/dist/src/config/sessions/store-cache.d.ts

@@ -1,19 +0,0 @@
-import type { SessionEntry } from "./types.js";
-export declare function clearSessionStoreCaches(): void;
-export declare function invalidateSessionStoreCache(storePath: string): void;
-export declare function getSerializedSessionStore(storePath: string): string | undefined;
-export declare function setSerializedSessionStore(storePath: string, serialized?: string): void;
-export declare function dropSessionStoreObjectCache(storePath: string): void;
-export declare function readSessionStoreCache(params: {
-    storePath: string;
-    ttlMs: number;
-    mtimeMs?: number;
-    sizeBytes?: number;
-}): Record<string, SessionEntry> | null;
-export declare function writeSessionStoreCache(params: {
-    storePath: string;
-    store: Record<string, SessionEntry>;
-    mtimeMs?: number;
-    sizeBytes?: number;
-    serialized?: string;
-}): void;

package/dist/src/config/sessions/store-maintenance.d.ts

@@ -1,62 +0,0 @@
-import type { SessionMaintenanceMode } from "../types.base.js";
-import type { SessionEntry } from "./types.js";
-export type SessionMaintenanceWarning = {
-    activeSessionKey: string;
-    activeUpdatedAt?: number;
-    totalEntries: number;
-    pruneAfterMs: number;
-    maxEntries: number;
-    wouldPrune: boolean;
-    wouldCap: boolean;
-};
-export type ResolvedSessionMaintenanceConfig = {
-    mode: SessionMaintenanceMode;
-    pruneAfterMs: number;
-    maxEntries: number;
-    rotateBytes: number;
-    resetArchiveRetentionMs: number | null;
-    maxDiskBytes: number | null;
-    highWaterBytes: number | null;
-};
-/**
- * Resolve maintenance settings from openclaw.json (`session.maintenance`).
- * Falls back to built-in defaults when config is missing or unset.
- */
-export declare function resolveMaintenanceConfig(): ResolvedSessionMaintenanceConfig;
-/**
- * Remove entries whose `updatedAt` is older than the configured threshold.
- * Entries without `updatedAt` are kept (cannot determine staleness).
- * Mutates `store` in-place.
- */
-export declare function pruneStaleEntries(store: Record<string, SessionEntry>, overrideMaxAgeMs?: number, opts?: {
-    log?: boolean;
-    onPruned?: (params: {
-        key: string;
-        entry: SessionEntry;
-    }) => void;
-}): number;
-export declare function getActiveSessionMaintenanceWarning(params: {
-    store: Record<string, SessionEntry>;
-    activeSessionKey: string;
-    pruneAfterMs: number;
-    maxEntries: number;
-    nowMs?: number;
-}): SessionMaintenanceWarning | null;
-/**
- * Cap the store to the N most recently updated entries.
- * Entries without `updatedAt` are sorted last (removed first when over limit).
- * Mutates `store` in-place.
- */
-export declare function capEntryCount(store: Record<string, SessionEntry>, overrideMax?: number, opts?: {
-    log?: boolean;
-    onCapped?: (params: {
-        key: string;
-        entry: SessionEntry;
-    }) => void;
-}): number;
-/**
- * Rotate the sessions file if it exceeds the configured size threshold.
- * Renames the current file to `sessions.json.bak.{timestamp}` and cleans up
- * old rotation backups, keeping only the 3 most recent `.bak.*` files.
- */
-export declare function rotateSessionFile(storePath: string, overrideBytes?: number): Promise<boolean>;

package/dist/src/config/sessions/store-migrations.d.ts

@@ -1,2 +0,0 @@
-import type { SessionEntry } from "./types.js";
-export declare function applySessionStoreMigrations(store: Record<string, SessionEntry>): void;

package/dist/src/config/sessions/store.d.ts

@@ -1,86 +0,0 @@
-import type { MsgContext } from "../../auto-reply/templating.js";
-import { type DeliveryContext } from "../../utils/delivery-context.js";
-import { type SessionDiskBudgetSweepResult } from "./disk-budget.js";
-import { capEntryCount, getActiveSessionMaintenanceWarning, pruneStaleEntries, resolveMaintenanceConfig, rotateSessionFile, type ResolvedSessionMaintenanceConfig, type SessionMaintenanceWarning } from "./store-maintenance.js";
-import { type SessionEntry } from "./types.js";
-export declare function normalizeStoreSessionKey(sessionKey: string): string;
-export declare function resolveSessionStoreEntry(params: {
-    store: Record<string, SessionEntry>;
-    sessionKey: string;
-}): {
-    normalizedKey: string;
-    existing: SessionEntry | undefined;
-    legacyKeys: string[];
-};
-export declare function clearSessionStoreCacheForTest(): void;
-/** Expose lock queue size for tests. */
-export declare function getSessionStoreLockQueueSizeForTest(): number;
-export declare function withSessionStoreLockForTest<T>(storePath: string, fn: () => Promise<T>, opts?: SessionStoreLockOptions): Promise<T>;
-type LoadSessionStoreOptions = {
-    skipCache?: boolean;
-};
-export declare function loadSessionStore(storePath: string, opts?: LoadSessionStoreOptions): Record<string, SessionEntry>;
-export declare function readSessionUpdatedAt(params: {
-    storePath: string;
-    sessionKey: string;
-}): number | undefined;
-export type SessionMaintenanceApplyReport = {
-    mode: ResolvedSessionMaintenanceConfig["mode"];
-    beforeCount: number;
-    afterCount: number;
-    pruned: number;
-    capped: number;
-    diskBudget: SessionDiskBudgetSweepResult | null;
-};
-export { capEntryCount, getActiveSessionMaintenanceWarning, pruneStaleEntries, resolveMaintenanceConfig, rotateSessionFile, };
-export type { ResolvedSessionMaintenanceConfig, SessionMaintenanceWarning };
-type SaveSessionStoreOptions = {
-    /** Skip pruning, capping, and rotation (e.g. during one-time migrations). */
-    skipMaintenance?: boolean;
-    /** Active session key for warn-only maintenance. */
-    activeSessionKey?: string;
-    /** Optional callback for warn-only maintenance. */
-    onWarn?: (warning: SessionMaintenanceWarning) => void | Promise<void>;
-    /** Optional callback with maintenance stats after a save. */
-    onMaintenanceApplied?: (report: SessionMaintenanceApplyReport) => void | Promise<void>;
-    /** Optional overrides used by maintenance commands. */
-    maintenanceOverride?: Partial<ResolvedSessionMaintenanceConfig>;
-};
-export declare function saveSessionStore(storePath: string, store: Record<string, SessionEntry>, opts?: SaveSessionStoreOptions): Promise<void>;
-export declare function updateSessionStore<T>(storePath: string, mutator: (store: Record<string, SessionEntry>) => Promise<T> | T, opts?: SaveSessionStoreOptions): Promise<T>;
-type SessionStoreLockOptions = {
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-    staleMs?: number;
-};
-export declare function archiveRemovedSessionTranscripts(params: {
-    removedSessionFiles: Iterable<[string, string | undefined]>;
-    referencedSessionIds: ReadonlySet<string>;
-    storePath: string;
-    reason: "deleted" | "reset";
-    restrictToStoreDir?: boolean;
-}): Set<string>;
-export declare function withSessionStoreLock<T>(storePath: string, fn: () => Promise<T>, opts?: SessionStoreLockOptions): Promise<T>;
-export declare function updateSessionStoreEntry(params: {
-    storePath: string;
-    sessionKey: string;
-    update: (entry: SessionEntry) => Promise<Partial<SessionEntry> | null>;
-}): Promise<SessionEntry | null>;
-export declare function recordSessionMetaFromInbound(params: {
-    storePath: string;
-    sessionKey: string;
-    ctx: MsgContext;
-    groupResolution?: import("./types.js").GroupKeyResolution | null;
-    createIfMissing?: boolean;
-}): Promise<SessionEntry | null>;
-export declare function updateLastRoute(params: {
-    storePath: string;
-    sessionKey: string;
-    channel?: SessionEntry["lastChannel"];
-    to?: string;
-    accountId?: string;
-    threadId?: string | number;
-    deliveryContext?: DeliveryContext;
-    ctx?: MsgContext;
-    groupResolution?: import("./types.js").GroupKeyResolution | null;
-}): Promise<SessionEntry>;

package/dist/src/config/sessions/targets.d.ts

@@ -1,19 +0,0 @@
-import type { OpenClawConfig } from "../types.openclaw.js";
-export type SessionStoreSelectionOptions = {
-    store?: string;
-    agent?: string;
-    allAgents?: boolean;
-};
-export type SessionStoreTarget = {
-    agentId: string;
-    storePath: string;
-};
-export declare function resolveAllAgentSessionStoreTargetsSync(cfg: OpenClawConfig, params?: {
-    env?: NodeJS.ProcessEnv;
-}): SessionStoreTarget[];
-export declare function resolveAllAgentSessionStoreTargets(cfg: OpenClawConfig, params?: {
-    env?: NodeJS.ProcessEnv;
-}): Promise<SessionStoreTarget[]>;
-export declare function resolveSessionStoreTargets(cfg: OpenClawConfig, opts: SessionStoreSelectionOptions, params?: {
-    env?: NodeJS.ProcessEnv;
-}): SessionStoreTarget[];