@dsh-enhanced/assistant-health 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-enhanced contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# @dsh-enhanced/assistant-health
+
+聚合个人助理各 provider 的公开 `health()` seam，输出低基数、无正文/路径/secret 的 liveness、readiness 和 Policy-gated 详细报告。它不读取其他插件的 SQLite/Vault，不执行修复，也不是第五个业务真源。
+
+## 安装与使用
+
+```sh
+dsh plugin --profile web add @dsh-enhanced/assistant-health
+dsh --profile web --dump-config
+```
+
+默认把 Policy、Memory、Wiki、Automations 设为 required；Delivery、Credentials、Event、Heartbeat、Lark 未安装不会让 core readiness 失败。`ctx.assistantHealth.liveness()` 只表示进程内 service 活着；`readiness()` 只调用本地 content-free health seam，不调用模型、工具或外网。详细 `assistant_health` tool 还需目标 Agent 对 `tool:assistant-health` 的 `inspect` Policy 规则。
+
+输出字段是逐 provider 白名单：未知 key、error message、content、prompt、cwd、vault/database path、消息、secret 和 tenant 标识不会透出。Provider 抛错只标记 `error`，不会包含异常正文。
+
+## 权限与限制
+
+- 文件系统、网络、子进程、凭据、浏览器、安装脚本：无。
+- 只读 Cordis service；health 故障不能阻塞其他业务。
+- 本包不提供公网 `/healthz`/`readyz`。如需 route，由宿主用强认证的本地 adapter 映射这两个 service 方法，不能把 detailed report 暴露为匿名端点。
+- detect 与 fix 永远分离；无 UI、无进程 supervisor、无篡改证明 ledger。
+
+## 兼容性
+
+以 DSH rc.8 `141eb6fef83422698aef7a981029e843e8161534` 验证；参考官方 session telemetry/OTel 的观测边界，不把 best-effort telemetry 当审计。

package/cordis.patch.yml

@@ -0,0 +1,11 @@
+- insert:
+    - id: dsh-enhanced-assistant-health
+      name: '@dsh-enhanced/assistant-health'
+      inject:
+        - assistantPolicy
+      config:
+        requiredProviders:
+          - assistantPolicy
+          - personalMemory
+          - personalWiki
+          - assistantAutomations

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { AssistantHealthService, Config } from './service.js';
+import { version } from './version.js';
+export declare const name = "dsh-enhanced-assistant-health";
+export { AssistantHealthService, Config, version };
+export * from './service.js';
+export declare function apply(ctx: Context, config: import('./service.js').Config): void;
+export default AssistantHealthService;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,eAAO,MAAM,IAAI,kCAAkC,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAClD,cAAc,cAAc,CAAA;AAE5B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,cAAc,EAAE,MAAM,GAAG,IAAI,CAE/E;AAED,eAAe,sBAAsB,CAAA"}

package/lib/index.js

@@ -0,0 +1,10 @@
+import { AssistantHealthService, Config } from './service.js';
+import { version } from './version.js';
+export const name = 'dsh-enhanced-assistant-health';
+export { AssistantHealthService, Config, version };
+export * from './service.js';
+export function apply(ctx, config) {
+    new AssistantHealthService(ctx, config);
+}
+export default AssistantHealthService;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,+BAA+B,CAAA;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;AAClD,cAAc,cAAc,CAAA;AAE5B,MAAM,UAAU,KAAK,CAAC,GAAY,EAAE,MAAqC;IACvE,IAAI,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;AACzC,CAAC;AAED,eAAe,sBAAsB,CAAA"}

package/lib/service.d.ts

@@ -0,0 +1,53 @@
+import { Context, Service } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import Schema from '@deepseek-ai/schemastery';
+export declare const providerIds: readonly ["assistantPolicy", "personalMemory", "personalWiki", "assistantAutomations", "assistantDelivery", "credentialsKeychain", "eventTriggers", "assistantHeartbeat", "larkChannel"];
+export type HealthProviderId = typeof providerIds[number];
+export type HealthMetric = boolean | number | string;
+export interface Config {
+    requiredProviders?: HealthProviderId[];
+}
+export interface ProviderHealth {
+    id: HealthProviderId;
+    status: 'error' | 'missing' | 'ready';
+    metrics: Readonly<Record<string, HealthMetric>>;
+}
+export interface AssistantHealthReport {
+    ready: boolean;
+    generatedAt: number;
+    providers: readonly ProviderHealth[];
+    warnings: readonly string[];
+}
+export type AssistantHealthErrorCode = 'disposed' | 'policy-denied';
+export declare class AssistantHealthError extends Error {
+    readonly code: AssistantHealthErrorCode;
+    constructor(code: AssistantHealthErrorCode, message: string);
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        assistantHealth: AssistantHealthService;
+    }
+}
+export declare class AssistantHealthService extends Service {
+    static Config: Schema<Config>;
+    private readonly context;
+    private readonly policy;
+    private readonly required;
+    private readonly now;
+    private active;
+    constructor(ctx: Context, input?: Config, options?: {
+        now?: () => number;
+    });
+    liveness(): {
+        alive: true;
+    };
+    readiness(): {
+        ready: boolean;
+        warnings: string[];
+    };
+    report(agent: Agent | undefined): AssistantHealthReport;
+    private collect;
+    private assertActive;
+}
+export declare const Config: Schema<Config>;
+//# sourceMappingURL=service.d.ts.map

package/lib/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAI7C,eAAO,MAAM,WAAW,0LAUd,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;AACzD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,MAAM,WAAW,MAAM;IACrB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,gBAAgB,CAAA;IACpB,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IACrC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;IACpC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5B;AAED,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,eAAe,CAAA;AACnE,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,wBAAwB;gBAA9B,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM;CAIrE;AAuBD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QAAG,eAAe,EAAE,sBAAsB,CAAA;KAAE;CAC9D;AAsBD,qBAAa,sBAAuB,SAAQ,OAAO;IACjD,MAAM,CAAC,MAAM,iBAAe;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,MAAM,CAAO;gBAET,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,MAAW,EAAE,OAAO,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO;IAmBlF,QAAQ,IAAI;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE;IAK3B,SAAS,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IASnD,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,qBAAqB;IAkBvD,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,YAAY;CAGrB;AAED,eAAO,MAAM,MAAM,gBAAe,CAAA"}

package/lib/service.js

@@ -0,0 +1,147 @@
+import { Context, Service } from '@deepseek-ai/cordis';
+import Schema from '@deepseek-ai/schemastery';
+import { registerAssistantHealthTool } from './tools.js';
+export const providerIds = [
+    'assistantPolicy',
+    'personalMemory',
+    'personalWiki',
+    'assistantAutomations',
+    'assistantDelivery',
+    'credentialsKeychain',
+    'eventTriggers',
+    'assistantHeartbeat',
+    'larkChannel',
+];
+export class AssistantHealthError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'AssistantHealthError';
+    }
+}
+const configSchema = Schema.object({
+    requiredProviders: Schema.array(Schema.union(providerIds)).default([
+        'assistantPolicy', 'personalMemory', 'personalWiki', 'assistantAutomations',
+    ]),
+});
+const keys = {
+    assistantPolicy: { emergencyStop: 'boolean', lastAuditSequence: 'number' },
+    personalMemory: { activeRecords: 'number', removedRecords: 'number', expiredRecords: 'number', pendingProposals: 'number' },
+    personalWiki: { pages: 'number', lintErrors: 'number', lintWarnings: 'number', pendingProposals: 'number' },
+    assistantAutomations: { activeAutomations: 'number', pausedAutomations: 'number', pendingTasks: 'number',
+        runningTasks: 'number', failedRuns: 'number', unknownRuns: 'number' },
+    assistantDelivery: { pendingInbox: 'number', deadLetterInbox: 'number', pendingOutbox: 'number',
+        deadLetterOutbox: 'number', unknownOutbox: 'number', adapters: 'number' },
+    credentialsKeychain: { handles: 'number', activeLeases: 'number', failedLeases: 'number' },
+    eventTriggers: { pendingEvents: 'number', deliveredEvents: 'number', triggersObserved: 'number' },
+    assistantHeartbeat: { active: 'number', paused: 'number', empty: 'number' },
+    larkChannel: { state: ['connected', 'connected-with-gap', 'connecting', 'disabled', 'disconnected', 'reconnecting'],
+        gapGeneration: 'number' },
+};
+function metrics(id, value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        throw new Error('invalid health payload');
+    const input = value;
+    const output = {};
+    for (const [key, specification] of Object.entries(keys[id])) {
+        const current = input[key];
+        if (specification === 'number') {
+            if (!Number.isSafeInteger(current) || current < 0)
+                throw new Error('invalid numeric health metric');
+            output[key] = current;
+        }
+        else if (specification === 'boolean') {
+            if (typeof current !== 'boolean')
+                throw new Error('invalid boolean health metric');
+            output[key] = current;
+        }
+        else {
+            if (typeof current !== 'string' || !specification.includes(current))
+                throw new Error('invalid status health metric');
+            output[key] = current;
+        }
+    }
+    return Object.freeze(output);
+}
+export class AssistantHealthService extends Service {
+    static Config = configSchema;
+    context;
+    policy;
+    required;
+    now;
+    active = true;
+    constructor(ctx, input = {}, options = {}) {
+        super(ctx, 'assistantHealth');
+        let config;
+        try {
+            config = configSchema(input);
+        }
+        catch (error) {
+            throw new Error(`assistant-health: invalid configuration: ${String(error)}`, { cause: error });
+        }
+        if (new Set(config.requiredProviders).size !== config.requiredProviders.length) {
+            throw new Error('assistant-health: requiredProviders contains a duplicate');
+        }
+        const policy = ctx.get('assistantPolicy');
+        if (policy === undefined)
+            throw new Error('assistant-health: assistantPolicy service is required');
+        this.context = ctx;
+        this.policy = policy;
+        this.required = new Set(config.requiredProviders);
+        this.now = options.now ?? Date.now;
+        ctx.inject(['tools'], toolsCtx => registerAssistantHealthTool(toolsCtx, this));
+        ctx.effect(() => () => { this.active = false; }, 'assistant-health.runtime');
+    }
+    liveness() {
+        this.assertActive();
+        return { alive: true };
+    }
+    readiness() {
+        this.assertActive();
+        const providers = this.collect();
+        const warnings = providers
+            .filter(item => this.required.has(item.id) && item.status !== 'ready')
+            .map(item => `provider-${item.status}:${item.id}`);
+        return { ready: warnings.length === 0, warnings };
+    }
+    report(agent) {
+        this.assertActive();
+        const decision = this.policy.authorizeAgent(agent, 'inspect', { kind: 'tool', id: 'assistant-health' });
+        if (decision.effect !== 'allow') {
+            throw new AssistantHealthError('policy-denied', `assistant-health policy denied report: ${decision.reasonCode}`);
+        }
+        const providers = this.collect();
+        const warnings = providers
+            .filter(item => this.required.has(item.id) && item.status !== 'ready')
+            .map(item => `provider-${item.status}:${item.id}`);
+        return Object.freeze({
+            ready: warnings.length === 0,
+            generatedAt: this.now(),
+            providers: Object.freeze(providers),
+            warnings: Object.freeze(warnings),
+        });
+    }
+    collect() {
+        const get = this.context.get.bind(this.context);
+        return providerIds.map(id => {
+            const provider = get(id);
+            if (provider === undefined)
+                return Object.freeze({ id, status: 'missing', metrics: Object.freeze({}) });
+            if (typeof provider.health !== 'function')
+                return Object.freeze({ id, status: 'error', metrics: Object.freeze({}) });
+            try {
+                return Object.freeze({ id, status: 'ready', metrics: metrics(id, provider.health()) });
+            }
+            catch {
+                return Object.freeze({ id, status: 'error', metrics: Object.freeze({}) });
+            }
+        });
+    }
+    assertActive() {
+        if (!this.active)
+            throw new AssistantHealthError('disposed', 'assistant-health service is disposed');
+    }
+}
+export const Config = configSchema;
+//# sourceMappingURL=service.js.map

package/lib/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAE7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAExD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iBAAiB;IACjB,gBAAgB;IAChB,cAAc;IACd,sBAAsB;IACtB,mBAAmB;IACnB,qBAAqB;IACrB,eAAe;IACf,oBAAoB;IACpB,aAAa;CACL,CAAA;AAuBV,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACxB;IAArB,YAAqB,IAA8B,EAAE,OAAe;QAClE,KAAK,CAAC,OAAO,CAAC,CAAA;QADK,SAAI,GAAJ,IAAI,CAA0B;QAEjD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AAED,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;QACjE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,sBAAsB;KAC5E,CAAC;CACH,CAAmB,CAAA;AAEpB,MAAM,IAAI,GAAiG;IACzG,eAAe,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,QAAQ,EAAE;IAC1E,cAAc,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE;IAC3H,YAAY,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE;IAC3G,oBAAoB,EAAE,EAAE,iBAAiB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ;QACtG,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE;IACvE,iBAAiB,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ;QAC7F,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAC3E,mBAAmB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE;IAC1F,aAAa,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE;IACjG,kBAAkB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;IAC3E,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,CAAC;QACjH,aAAa,EAAE,QAAQ,EAAE;CAC5B,CAAA;AAMD,SAAS,OAAO,CAAC,EAAoB,EAAE,KAAc;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;IAClH,MAAM,KAAK,GAAG,KAAgC,CAAA;IAC9C,MAAM,MAAM,GAAiC,EAAE,CAAA;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,IAAK,OAAkB,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;YAC/G,MAAM,CAAC,GAAG,CAAC,GAAG,OAAiB,CAAA;QACjC,CAAC;aAAM,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,IAAI,OAAO,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;YAClF,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAA;QACvB,CAAC;aAAM,CAAC;YACN,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;YACpH,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAA;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;AAC9B,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,OAAO;IACjD,MAAM,CAAC,MAAM,GAAG,YAAY,CAAA;IACX,OAAO,CAAS;IAChB,MAAM,CAAwB;IAC9B,QAAQ,CAA+B;IACvC,GAAG,CAAc;IAC1B,MAAM,GAAG,IAAI,CAAA;IAErB,YAAY,GAAY,EAAE,QAAgB,EAAE,EAAE,UAAkC,EAAE;QAChF,KAAK,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAA;QAC7B,IAAI,MAAwB,CAAA;QAC5B,IAAI,CAAC;YAAC,MAAM,GAAG,YAAY,CAAC,KAAK,CAAqB,CAAA;QAAC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QAChG,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAA;QAC7E,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAuC,CAAA;QAC/E,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;QAClG,IAAI,CAAC,OAAO,GAAG,GAAG,CAAA;QAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAA;QACjD,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAA;QAClC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAA;QAC9E,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA,CAAC,CAAC,EAAE,0BAA0B,CAAC,CAAA;IAC7E,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IACxB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAChC,MAAM,QAAQ,GAAG,SAAS;aACvB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC;aACrE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnD,CAAC;IAED,MAAM,CAAC,KAAwB;QAC7B,IAAI,CAAC,YAAY,EAAE,CAAA;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC,CAAA;QACvG,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,oBAAoB,CAAC,eAAe,EAAE,0CAA0C,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;QAClH,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAChC,MAAM,QAAQ,GAAG,SAAS;aACvB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC;aACrE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAA;QACpD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC5B,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;YACvB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAwB;SACzD,CAAC,CAAA;IACJ,CAAC;IAEO,OAAO;QACb,MAAM,GAAG,GAAI,IAAI,CAAC,OAAqD,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9F,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YAC1B,MAAM,QAAQ,GAAG,GAAG,CAAC,EAAE,CAA2C,CAAA;YAClE,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAChH,IAAI,OAAO,QAAQ,CAAC,MAAM,KAAK,UAAU;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAC7H,IAAI,CAAC;gBACH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAA;YACjG,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACpF,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,oBAAoB,CAAC,UAAU,EAAE,sCAAsC,CAAC,CAAA;IACtG,CAAC;;AAGH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAA"}

package/lib/tools.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { AssistantHealthService } from './service.js';
+export declare function registerAssistantHealthTool(ctx: Context, service: AssistantHealthService): void;
+//# sourceMappingURL=tools.d.ts.map

package/lib/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAE1D,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CA8B/F"}

package/lib/tools.js

@@ -0,0 +1,33 @@
+import { defineTool } from '@deepseek-ai/dsh-tools';
+export function registerAssistantHealthTool(ctx, service) {
+    ctx.tools.register(defineTool({
+        name: 'assistant_health',
+        description: 'Read a policy-gated, content-free health report. This detects issues and never repairs state.',
+        parameters: {},
+        output: {
+            schema: { type: 'object', additionalProperties: false, properties: {
+                    ready: { type: 'boolean', required: true }, generatedAt: { type: 'integer', required: true },
+                    warnings: { type: 'array', required: true, items: { type: 'string' } },
+                    providers: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: {
+                                id: { type: 'string', required: true }, status: { type: 'string', required: true },
+                                metrics: { type: 'object', required: true, additionalProperties: true, properties: {} },
+                            } } },
+                } },
+            render: (_args, value) => [{ type: 'text', text: JSON.stringify(value) }],
+        },
+        async execute(_args, exec) {
+            const report = service.report(exec.agent);
+            return {
+                ready: report.ready,
+                generatedAt: report.generatedAt,
+                warnings: [...report.warnings],
+                providers: report.providers.map(provider => ({
+                    id: provider.id,
+                    status: provider.status,
+                    metrics: { ...provider.metrics },
+                })),
+            };
+        },
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGnD,MAAM,UAAU,2BAA2B,CAAC,GAAY,EAAE,OAA+B;IACvF,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,+FAA+F;QAC5G,UAAU,EAAE,EAAE;QACd,MAAM,EAAE;YACN,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE;oBACjE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAC5F,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;oBACtE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,UAAU,EAAE;gCAC5G,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;gCAClF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE;6BACxF,EAAE,EAAE;iBACN,EAAE;YACH,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SAC1E;QACD,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI;YACvB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACzC,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;gBAC9B,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBAC3C,EAAE,EAAE,QAAQ,CAAC,EAAE;oBACf,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,OAAO,EAAE,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE;iBACjC,CAAC,CAAC;aACJ,CAAA;QACH,CAAC;KACF,CAAC,CAAC,CAAA;AACL,CAAC"}

package/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "0.1.3";
+//# sourceMappingURL=version.d.ts.map

package/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/lib/version.js

@@ -0,0 +1,2 @@
+export const version = '0.1.3';
+//# sourceMappingURL=version.js.map

package/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@dsh-enhanced/assistant-health",
+  "version": "0.1.3",
+  "description": "Policy-gated, content-free health and readiness aggregation for DSH assistant services.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/22-ai-00/dsh-enhanced.git",
+    "directory": "plugins/assistant-health"
+  },
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh-plugin"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "3.18.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-agent": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/dsh-tools": ">=0.1.0-rc.8 <0.2.0",
+    "@dsh-enhanced/assistant-policy": ">=0.1.0 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-tools": {
+      "optional": true
+    },
+    "@dsh-enhanced/assistant-policy": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
+    "@types/node": "22.20.0",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8",
+    "@dsh-enhanced/assistant-policy": "0.1.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}