dsh-daruma 0.1.0

package/lib/engine.js

@@ -0,0 +1,80 @@
+/**
+ * RecoveryEngine — the adapter-side state holder that wraps the pure
+ * `decide()` from daruma-core.
+ *
+ * It owns the mutable channel-health map, the per-session failover counter,
+ * and persistence through a `ChannelHealthStore`. All decision logic stays in
+ * daruma-core; this class only threads state and I/O.
+ */
+import { decide, freshHealth, } from 'daruma-core';
+const systemClock = { nowMs: () => Date.now() };
+const FAILOVER_HISTORY_LIMIT = 5;
+export class RecoveryEngine {
+    config;
+    store;
+    healths = new Map();
+    failoverTotal = 0;
+    failoverHistory = [];
+    clock;
+    constructor(config, store, clock) {
+        this.config = config;
+        this.store = store;
+        this.clock = clock ?? systemClock;
+        this.preload();
+    }
+    /** Load every configured channel's persisted health into memory. */
+    preload() {
+        for (const channel of this.config.channels) {
+            if (this.healths.has(channel.id))
+                continue;
+            const stored = this.store.load(channel.id);
+            this.healths.set(channel.id, stored ?? freshHealth(channel.id, this.clock.nowMs()));
+        }
+    }
+    /** Feed one failure signal and persist the resulting state. */
+    onFailure(signal, preferred) {
+        const plan = decide({
+            signal,
+            healths: this.healths,
+            failoverCount: this.failoverTotal,
+            config: this.config,
+            nowMs: this.clock.nowMs(),
+            ...(preferred !== undefined ? { preferred } : {}),
+        });
+        this.healths.set(signal.channel, plan.healthAfter);
+        this.store.save(plan.healthAfter);
+        if (plan.verdict.kind === 'FAILOVER') {
+            this.failoverTotal = plan.failoverCount;
+            this.failoverHistory.push({
+                from: signal.channel,
+                to: plan.verdict.target.id,
+                reason: signal.code,
+                at: this.clock.nowMs(),
+            });
+            if (this.failoverHistory.length > FAILOVER_HISTORY_LIMIT) {
+                this.failoverHistory.shift();
+            }
+        }
+        return plan;
+    }
+    /** Snapshot of every tracked channel's health, for the status UI. */
+    listHealth() {
+        return [...this.healths.values()].map((health) => ({
+            channel: health.channel,
+            state: health.state,
+            failures: health.consecutiveFailures,
+        }));
+    }
+    get failoverCount() {
+        return this.failoverTotal;
+    }
+    /** Configured failover channels (for provider discovery). */
+    get channels() {
+        return this.config.channels;
+    }
+    /** Recent failovers, newest last (bounded). */
+    get history() {
+        return this.failoverHistory;
+    }
+}
+//# sourceMappingURL=engine.js.map

package/lib/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * dsh-daruma — Daruma resilience plugin for DeepSeek Harness.
+ *
+ * Mounts the recovery engine on the agent loop's two model-request extension
+ * points:
+ *
+ * - `agent/request-error`: observe failures; when a channel trips, arm a
+ *   failover target and own recovery by returning `{ kind: 'retry' }`.
+ * - `agent/request`: swap the request config onto the armed target.
+ *
+ * It is intentionally downstream of the in-box `dsh-llm-retry`: that plugin
+ * owns same-channel retry and delegates here (via `next()`) when it gives up,
+ * so daruma only escalates after retry has exhausted its budget.
+ *
+ * Additionally mounts the `/dsh-daruma` RPC channel (status, candidate
+ * discovery, backup selection) for the web client UI, and appends a durable
+ * `daruma/failover` session event on every channel switch.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type PluginConfig } from './config.ts';
+export declare const name = "dsh-daruma";
+export declare const inject: readonly ["agents", "settings", "llm"];
+/** Durable session event appended on every channel switch. */
+export interface DarumaFailoverEvent {
+    from: string;
+    to: string;
+    reason: string;
+    at: number;
+}
+declare module '@deepseek-ai/dsh-session/types' {
+    interface SessionEventMap {
+        'daruma/failover': DarumaFailoverEvent;
+    }
+}
+export declare function apply(ctx: Context, rawConfig?: PluginConfig): void;

package/lib/index.js

@@ -0,0 +1,76 @@
+/**
+ * dsh-daruma — Daruma resilience plugin for DeepSeek Harness.
+ *
+ * Mounts the recovery engine on the agent loop's two model-request extension
+ * points:
+ *
+ * - `agent/request-error`: observe failures; when a channel trips, arm a
+ *   failover target and own recovery by returning `{ kind: 'retry' }`.
+ * - `agent/request`: swap the request config onto the armed target.
+ *
+ * It is intentionally downstream of the in-box `dsh-llm-retry`: that plugin
+ * owns same-channel retry and delegates here (via `next()`) when it gives up,
+ * so daruma only escalates after retry has exhausted its budget.
+ *
+ * Additionally mounts the `/dsh-daruma` RPC channel (status, candidate
+ * discovery, backup selection) for the web client UI, and appends a durable
+ * `daruma/failover` session event on every channel switch.
+ */
+import { channelIdOf, channelIdOfConfig, toCallConfig, toFailureSignal } from "./mapping.js";
+import { resolveConfig } from "./config.js";
+import { RecoveryEngine } from "./engine.js";
+import { JsonFileChannelHealthStore } from "./store.js";
+import { mountStatus } from "./status.js";
+import { mountRpc } from "./rpc.js";
+import { modelId } from 'daruma-core';
+export const name = 'dsh-daruma';
+export const inject = ['agents', 'settings', 'llm'];
+export function apply(ctx, rawConfig = {}) {
+    const config = resolveConfig(rawConfig);
+    const store = new JsonFileChannelHealthStore(config.stateFile);
+    const engine = new RecoveryEngine(config, store);
+    const status = mountStatus(ctx);
+    // Per-agent channel currently in use (tracked from the last request).
+    const currentChannel = new Map();
+    // Per-agent failover target armed on the previous failed request.
+    const pending = new Map();
+    /** The user-chosen backup channel, if set and healthy. */
+    const backupChannel = () => {
+        const backup = status.getBackup();
+        if (backup === undefined)
+            return undefined;
+        return { id: channelIdOf(backup.provider, backup.model), provider: backup.provider, model: modelId(backup.model) };
+    };
+    ctx.on('agent/request', async (payload, next) => {
+        const current = await next();
+        const armed = pending.get(payload.agent.id);
+        if (armed) {
+            pending.delete(payload.agent.id);
+            const swapped = toCallConfig(current, armed);
+            currentChannel.set(payload.agent.id, channelIdOfConfig(swapped));
+            ctx.logger.warn(`dsh-daruma: switching ${current.provider}/${current.model} -> ${swapped.provider}/${swapped.model}`);
+            return swapped;
+        }
+        currentChannel.set(payload.agent.id, channelIdOfConfig(current));
+        return current;
+    });
+    ctx.on('agent/request-error', async (payload, next) => {
+        const channel = currentChannel.get(payload.agent.id) ?? channelIdOf(payload.provider, '');
+        const signal = toFailureSignal(payload.failure, channel, Date.now());
+        const plan = engine.onFailure(signal, backupChannel());
+        if (plan.verdict.kind === 'FAILOVER') {
+            pending.set(payload.agent.id, plan.verdict.target);
+            const eventData = { from: channel, to: plan.verdict.target.id, reason: signal.code, at: Date.now() };
+            payload.agent.session.append('daruma/failover', eventData);
+            ctx.logger.warn(`dsh-daruma: failover ${channel} -> ${plan.verdict.target.id} (${signal.code})`);
+            return { kind: 'retry' };
+        }
+        if (plan.verdict.kind === 'GIVE_UP') {
+            ctx.logger.error(`dsh-daruma: giving up (${plan.verdict.reason})`);
+        }
+        // RETRY_NOW / GIVE_UP: delegate downstream (retry may still own it).
+        return next();
+    });
+    mountRpc(ctx, { engine, currentChannel, status, getLlm: () => ctx.llm, getSettings: () => ctx.settings });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/mapping.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Translation between DeepSeek Harness types and the daruma-core domain.
+ *
+ * DSH failure `code`s are stable provider-neutral strings; the domain
+ * taxonomy mirrors them. Anything unknown is downgraded to `UNKNOWN`
+ * (treated as retryable).
+ */
+import type { LlmCallConfig, LlmFailure } from '@deepseek-ai/dsh-llm';
+import { type Channel, type ChannelId, type FailureCode, type FailureSignal } from 'daruma-core';
+export declare function toFailureCode(code: string): FailureCode;
+/** Stable channel identity from a provider+model pair. */
+export declare function channelIdOf(provider: string, model: string): ChannelId;
+/** Channel identity of a resolved request config. */
+export declare function channelIdOfConfig(config: LlmCallConfig): ChannelId;
+export declare function toFailureSignal(failure: LlmFailure, channel: ChannelId, occurredAtMs: number): FailureSignal;
+/** Swap a request config onto a failover target channel. */
+export declare function toCallConfig(config: LlmCallConfig, target: Channel): LlmCallConfig;

package/lib/mapping.js

@@ -0,0 +1,43 @@
+/**
+ * Translation between DeepSeek Harness types and the daruma-core domain.
+ *
+ * DSH failure `code`s are stable provider-neutral strings; the domain
+ * taxonomy mirrors them. Anything unknown is downgraded to `UNKNOWN`
+ * (treated as retryable).
+ */
+import { channelId, } from 'daruma-core';
+const KNOWN_FAILURE_CODES = new Set([
+    'RATE_LIMIT',
+    'SERVER',
+    'TIMEOUT',
+    'TRANSPORT',
+    'EMPTY_RESPONSE',
+    'QUOTA',
+    'CONTEXT_WINDOW_EXCEEDED',
+    'INVALID_CREDENTIAL',
+]);
+export function toFailureCode(code) {
+    return (KNOWN_FAILURE_CODES.has(code) ? code : 'UNKNOWN');
+}
+/** Stable channel identity from a provider+model pair. */
+export function channelIdOf(provider, model) {
+    return channelId(model ? `${provider}::${model}` : provider);
+}
+/** Channel identity of a resolved request config. */
+export function channelIdOfConfig(config) {
+    return channelIdOf(config.provider, config.model);
+}
+export function toFailureSignal(failure, channel, occurredAtMs) {
+    return {
+        code: toFailureCode(failure.code),
+        status: failure.status,
+        channel,
+        occurredAtMs,
+        message: failure.message,
+    };
+}
+/** Swap a request config onto a failover target channel. */
+export function toCallConfig(config, target) {
+    return { ...config, provider: target.provider, model: target.model };
+}
+//# sourceMappingURL=mapping.js.map

package/lib/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../src/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,SAAS,GAKV,MAAM,aAAa,CAAA;AAEpB,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACvD,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,WAAW;IACX,gBAAgB;IAChB,OAAO;IACP,yBAAyB;IACzB,oBAAoB;CACrB,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAgB,CAAA;AAC1E,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,KAAa;IACzD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;AAC9D,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,OAAO,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAmB,EACnB,OAAkB,EAClB,YAAoB;IAEpB,OAAO;QACL,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO;QACP,YAAY;QACZ,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,MAAe;IACjE,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAA;AACtE,CAAC"}

package/lib/rpc.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `/dsh-daruma` RPC channel: status snapshot, candidate discovery, and
+ * backup-channel management for the client UI.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { LlmRuntime } from '@deepseek-ai/dsh-llm';
+import type { SettingsProvider } from '@deepseek-ai/dsh-settings';
+import type { Channel, ChannelId } from 'daruma-core';
+import type { RecoveryEngine } from './engine.ts';
+import type { StatusService } from './status.ts';
+export type RpcResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export interface RpcDeps {
+    readonly engine: RecoveryEngine;
+    readonly currentChannel: ReadonlyMap<string, ChannelId>;
+    readonly status: StatusService;
+    readonly getLlm: () => LlmRuntime | undefined;
+    readonly getSettings: () => SettingsProvider | undefined;
+}
+export declare function mountRpc(ctx: Context, deps: RpcDeps): void;
+export type { Channel };

package/lib/rpc.js

@@ -0,0 +1,122 @@
+/**
+ * `/dsh-daruma` RPC channel: status snapshot, candidate discovery, and
+ * backup-channel management for the client UI.
+ */
+import { channelIdOf } from "./mapping.js";
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isString(value) {
+    return typeof value === 'string';
+}
+/** `{ provider, model }` — a backup selection. */
+function isBackupPayload(value) {
+    return isRecord(value) && isString(value.provider) && value.provider !== ''
+        && isString(value.model) && value.model !== '';
+}
+/** Known provider names: daruma's configured channels plus settings providers. */
+function knownProviders(deps) {
+    const names = new Set();
+    for (const channel of deps.engine.channels)
+        names.add(channel.provider);
+    const settings = deps.getSettings();
+    if (settings !== undefined) {
+        try {
+            const section = settings.get('llm-pi-ai');
+            for (const provider of Object.keys(section?.providers ?? {}))
+                names.add(provider);
+        }
+        catch {
+            // settings unavailable — configured channels still known
+        }
+    }
+    return [...names];
+}
+async function listCandidates(llm, provider, settings) {
+    try {
+        const models = await llm.listModels(provider);
+        if (models.length > 0)
+            return models.map((info) => ({ provider, model: info.id }));
+    }
+    catch {
+        // fall through to the settings model directory
+    }
+    if (settings !== undefined) {
+        try {
+            const section = settings.get('llm-pi-ai');
+            const models = section?.providers?.[provider]?.models;
+            if (models !== undefined && models.length > 0) {
+                return models
+                    .map((model) => model.id)
+                    .filter((id) => id !== undefined && id !== '')
+                    .map((model) => ({ provider, model }));
+            }
+        }
+        catch {
+            // settings unavailable
+        }
+    }
+    return [];
+}
+export function mountRpc(ctx, deps) {
+    const connection = ctx.get('connection');
+    if (connection === undefined)
+        return; // no web transport (headless)
+    const dispatch = async (endpoint, payload, signal) => {
+        try {
+            switch (endpoint) {
+                case 'status': {
+                    const sessionId = isRecord(payload) && isString(payload.sessionId) ? payload.sessionId : undefined;
+                    const current = sessionId !== undefined ? deps.currentChannel.get(sessionId) : undefined;
+                    const backup = deps.status.getBackup();
+                    return {
+                        ok: true,
+                        value: {
+                            current: current ?? null,
+                            backup: backup ?? null,
+                            channels: deps.engine.listHealth(),
+                            failoverCount: deps.engine.failoverCount,
+                            failoverHistory: deps.engine.history,
+                            providers: knownProviders(deps),
+                        },
+                    };
+                }
+                case 'listCandidates': {
+                    const provider = isRecord(payload) && isString(payload.provider) ? payload.provider : undefined;
+                    if (provider === undefined)
+                        throw new Error('bad-request: listCandidates needs a provider');
+                    const llm = deps.getLlm();
+                    if (llm === undefined)
+                        throw new Error('llm service unavailable');
+                    return { ok: true, value: await listCandidates(llm, provider, deps.getSettings()) };
+                }
+                case 'setBackup': {
+                    if (!isBackupPayload(payload))
+                        throw new Error('bad-request: setBackup needs {provider, model}');
+                    await deps.status.setBackup({ provider: payload.provider, model: payload.model });
+                    return { ok: true, value: { ok: true } };
+                }
+                case 'clearBackup': {
+                    await deps.status.clearBackup();
+                    return { ok: true, value: { ok: true } };
+                }
+                default:
+                    throw new Error(`bad-request: unknown endpoint ${JSON.stringify(endpoint)}`);
+            }
+        }
+        catch (error) {
+            const message = messageOf(error);
+            const code = message.startsWith('bad-request:') ? 'bad-request' : 'internal';
+            return {
+                ok: false,
+                error: { code, message: message.replace(/^bad-request: /u, '') },
+            };
+        }
+    };
+    const dispose = connection.rpc.handle('/dsh-daruma', dispatch, { authority: 'loopback' });
+    ctx.effect(() => dispose, 'dsh-daruma: /dsh-daruma rpc channel');
+}
+//# sourceMappingURL=rpc.js.map

package/lib/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"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"}

package/lib/status.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Daruma status service: the `daruma` settings namespace (user-chosen backup
+ * channel) plus the runtime status snapshot surface.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { type SettingsProvider, type SettingsScope } from '@deepseek-ai/dsh-settings';
+export declare const DARUMA_NS: import("@deepseek-ai/dsh-settings").SettingsNamespace;
+/** The `daruma:` settings namespace schema. */
+export declare const DarumaSettingsSchema: z<Schemastery.ObjectS<{
+    backup: z<Schemastery.ObjectS<{
+        provider: z<string, string>;
+        model: z<string, string>;
+    }>, Schemastery.ObjectT<{
+        provider: z<string, string>;
+        model: z<string, string>;
+    }>>;
+}>, Schemastery.ObjectT<{
+    backup: z<Schemastery.ObjectS<{
+        provider: z<string, string>;
+        model: z<string, string>;
+    }>, Schemastery.ObjectT<{
+        provider: z<string, string>;
+        model: z<string, string>;
+    }>>;
+}>>;
+export interface DarumaSettings {
+    backup?: {
+        provider: string;
+        model: string;
+    };
+}
+export interface BackupSelection {
+    readonly provider: string;
+    readonly model: string;
+}
+export declare class StatusService {
+    private readonly settings;
+    private readonly scope;
+    constructor(settings: SettingsProvider, scope: SettingsScope<DarumaSettings>);
+    getBackup(): BackupSelection | undefined;
+    setBackup(selection: BackupSelection): Promise<void>;
+    clearBackup(): Promise<void>;
+}
+/** Register the namespace and return the service. */
+export declare function mountStatus(ctx: Context): StatusService;

package/lib/status.js

@@ -0,0 +1,49 @@
+/**
+ * Daruma status service: the `daruma` settings namespace (user-chosen backup
+ * channel) plus the runtime status snapshot surface.
+ */
+import z from '@deepseek-ai/schemastery';
+import { settingsNamespace } from '@deepseek-ai/dsh-settings';
+export const DARUMA_NS = settingsNamespace('daruma');
+const backupShape = z.object({
+    provider: z.string(),
+    model: z.string(),
+});
+/** The `daruma:` settings namespace schema. */
+export const DarumaSettingsSchema = z.object({
+    backup: backupShape,
+});
+/** True when a value is a usable backup selection (non-empty strings). */
+function isValidBackup(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.provider === 'string' && candidate.provider !== ''
+        && typeof candidate.model === 'string' && candidate.model !== '';
+}
+export class StatusService {
+    settings;
+    scope;
+    constructor(settings, scope) {
+        this.settings = settings;
+        this.scope = scope;
+    }
+    getBackup() {
+        const backup = this.scope.get().backup;
+        // The settings layer can resolve an absent section to an empty object;
+        // treat any selection without non-empty provider/model as unset.
+        return isValidBackup(backup) ? backup : undefined;
+    }
+    async setBackup(selection) {
+        await this.scope.update({ backup: selection });
+    }
+    async clearBackup() {
+        await this.settings.mutate(DARUMA_NS, [{ op: 'unset', path: ['backup'] }]);
+    }
+}
+/** Register the namespace and return the service. */
+export function mountStatus(ctx) {
+    const scope = ctx.settings.register(DARUMA_NS, DarumaSettingsSchema);
+    return new StatusService(ctx.settings, scope);
+}
+//# sourceMappingURL=status.js.map

package/lib/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,iBAAiB,EAA6C,MAAM,2BAA2B,CAAA;AAExG,MAAM,CAAC,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAA;AAEpD,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAA;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,WAAW;CACpB,CAAC,CAAA;AAWF,0EAA0E;AAC1E,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAA;IAC7D,MAAM,SAAS,GAAG,KAAiC,CAAA;IACnD,OAAO,OAAO,SAAS,CAAC,QAAQ,KAAK,QAAQ,IAAI,SAAS,CAAC,QAAQ,KAAK,EAAE;WACrE,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,KAAK,EAAE,CAAA;AACpE,CAAC;AAED,MAAM,OAAO,aAAa;IAEL;IACA;IAFnB,YACmB,QAA0B,EAC1B,KAAoC;QADpC,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,UAAK,GAAL,KAAK,CAA+B;IACpD,CAAC;IAEJ,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAA;QACtC,uEAAuE;QACvE,iEAAiE;QACjE,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IACnD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAA0B;QACxC,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5E,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,oBAA6B,CAA6C,CAAA;IACzH,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;AAC/C,CAAC"}

package/lib/store.d.ts

@@ -0,0 +1,17 @@
+/**
+ * JSON-file implementation of the domain's `ChannelHealthStore` port.
+ *
+ * Persistence is best-effort: a corrupt or unreadable state file makes the
+ * store start fresh rather than crashing the plugin.
+ */
+import type { ChannelHealth, ChannelHealthStore, ChannelId } from 'daruma-core';
+export declare class JsonFileChannelHealthStore implements ChannelHealthStore {
+    private readonly file;
+    private readonly healths;
+    private loaded;
+    constructor(file: string);
+    private ensureLoaded;
+    load(channel: ChannelId): ChannelHealth | undefined;
+    save(health: ChannelHealth): void;
+    private persist;
+}

package/lib/store.js

@@ -0,0 +1,54 @@
+/**
+ * JSON-file implementation of the domain's `ChannelHealthStore` port.
+ *
+ * Persistence is best-effort: a corrupt or unreadable state file makes the
+ * store start fresh rather than crashing the plugin.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+export class JsonFileChannelHealthStore {
+    file;
+    healths = new Map();
+    loaded = false;
+    constructor(file) {
+        this.file = file;
+    }
+    ensureLoaded() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        try {
+            if (!existsSync(this.file))
+                return;
+            const raw = JSON.parse(readFileSync(this.file, 'utf8'));
+            for (const [key, health] of Object.entries(raw.healths ?? {})) {
+                this.healths.set(key, health);
+            }
+        }
+        catch {
+            // Corrupt state: start fresh.
+        }
+    }
+    load(channel) {
+        this.ensureLoaded();
+        return this.healths.get(channel);
+    }
+    save(health) {
+        this.ensureLoaded();
+        this.healths.set(health.channel, health);
+        this.persist();
+    }
+    persist() {
+        try {
+            mkdirSync(dirname(this.file), { recursive: true });
+            const healths = {};
+            for (const [key, health] of this.healths)
+                healths[key] = health;
+            writeFileSync(this.file, JSON.stringify({ healths }, null, 2));
+        }
+        catch {
+            // Persistence failure must not take down the plugin.
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/lib/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,MAAM,OAAO,0BAA0B;IAIR;IAHZ,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAA;IACtD,MAAM,GAAG,KAAK,CAAA;IAEtB,YAA6B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAErC,YAAY;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAM;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAgB,CAAA;YACtE,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC9D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAgB,EAAE,MAAuB,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAkB;QACrB,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED,IAAI,CAAC,MAAqB;QACxB,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACxC,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAEO,OAAO;QACb,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAClD,MAAM,OAAO,GAAkC,EAAE,CAAA;YACjD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;YAC/D,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;IACH,CAAC;CACF"}