botmux 3.13.0 → 3.15.0

package/dist/services/feedback-analytics.d.ts

@@ -0,0 +1,82 @@
+export interface FeedbackAnalyticsFilters {
+    from: string;
+    to: string;
+    teamId?: string;
+    botAppId?: string;
+    chatId?: string;
+    topicRootId?: string;
+    semantic?: string;
+    verdictKey?: string;
+    reasonKey?: string;
+    model?: string;
+    cliId?: string;
+    cliVersion?: string;
+    skillName?: string;
+    skillVersion?: string;
+    workflowId?: string;
+    taskId?: string;
+    status?: string;
+}
+export interface FeedbackAnalyticsSummary {
+    delivered: number;
+    ratedDeliveries: number;
+    ratings: number;
+    positive: number;
+    negative: number;
+    progress: number;
+    ratingCoverage: number;
+    positiveRate: number;
+    deliveryFailures: number;
+    outboxFailures: number;
+}
+export interface FeedbackDeliveryAnalyticsItem {
+    deliveryId: string;
+    createdAt: string;
+    completedAt?: string;
+    status?: string;
+    contentHash: string;
+    contentRef?: string;
+    platform: string;
+    platformMessageId: string;
+    platformAppId: string;
+    botAppId?: string;
+    sessionId?: string;
+    turnId?: string;
+    chatId?: string;
+    topicRootId?: string;
+    workflowId?: string;
+    taskId?: string;
+    cliId?: string;
+    cliVersion?: string;
+    model?: string;
+    skillName?: string;
+    skillVersion?: string;
+    semantic?: string;
+    verdictKey?: string;
+    reasonKey?: string;
+}
+export declare class FeedbackAnalyticsService {
+    private readonly db;
+    constructor(dataDir: string);
+    close(): void;
+    summary(filters: FeedbackAnalyticsFilters): FeedbackAnalyticsSummary;
+    trend(filters: FeedbackAnalyticsFilters): Array<{
+        bucket: string;
+        positive: number;
+        negative: number;
+        progress: number;
+        ratings: number;
+    }>;
+    reasons(filters: FeedbackAnalyticsFilters): Array<{
+        reasonKey: string;
+        count: number;
+    }>;
+    deliveries(filters: FeedbackAnalyticsFilters, page?: {
+        limit?: number;
+        cursor?: string;
+    }): {
+        items: FeedbackDeliveryAnalyticsItem[];
+        nextCursor?: string;
+    };
+}
+//# sourceMappingURL=feedback-analytics.d.ts.map

package/dist/services/feedback-analytics.d.ts.map

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

package/dist/services/feedback-analytics.js

@@ -0,0 +1,95 @@
+import { join } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+function bounded(filters) {
+    const from = Date.parse(filters.from);
+    const to = Date.parse(filters.to);
+    if (!Number.isFinite(from) || !Number.isFinite(to) || from >= to)
+        throw new Error('feedback_analytics_invalid_range');
+    if (to - from > 366 * 24 * 60 * 60 * 1000)
+        throw new Error('feedback_analytics_range_too_large');
+}
+function deliveryWhere(filters) {
+    bounded(filters);
+    const clauses = ['d.created_at>=?', 'd.created_at<?'];
+    const params = [filters.from, filters.to];
+    const columns = [
+        ['botAppId', 'd.bot_app_id'], ['chatId', 'd.chat_id'], ['topicRootId', 'd.topic_root_id'], ['model', 'd.model'],
+        ['cliId', 'd.cli_id'], ['cliVersion', 'd.cli_version'], ['skillName', 'd.skill_name'], ['skillVersion', 'd.skill_version'],
+        ['workflowId', 'd.workflow_id'], ['taskId', 'd.task_id'], ['status', 'd.status'],
+    ];
+    for (const [key, column] of columns)
+        if (filters[key]) {
+            clauses.push(`${column}=?`);
+            params.push(filters[key]);
+        }
+    if (filters.teamId) {
+        clauses.push("json_extract(d.context_json,'$.teamId')=?");
+        params.push(filters.teamId);
+    }
+    return { where: clauses.join(' AND '), params };
+}
+function feedbackWhere(filters) {
+    const base = deliveryWhere(filters);
+    const clauses = [base.where];
+    const params = [...base.params];
+    const fields = [['semantic', 'lf.semantic'], ['verdictKey', 'lf.result'], ['reasonKey', 'lf.reason_key']];
+    for (const [key, column] of fields)
+        if (filters[key]) {
+            clauses.push(`${column}=?`);
+            params.push(filters[key]);
+        }
+    return { where: clauses.join(' AND '), params };
+}
+const LATEST = `SELECT f.* FROM feedback_revisions f JOIN (SELECT delivery_id,operator_subject_id,MAX(revision) revision FROM feedback_revisions GROUP BY delivery_id,operator_subject_id) x ON x.delivery_id=f.delivery_id AND x.operator_subject_id=f.operator_subject_id AND x.revision=f.revision`;
+export class FeedbackAnalyticsService {
+    db;
+    constructor(dataDir) {
+        this.db = new DatabaseSync(join(dataDir, 'botmux-feedback.sqlite'), { readOnly: true });
+    }
+    close() { this.db.close(); }
+    summary(filters) {
+        const delivery = deliveryWhere(filters);
+        const feedback = feedbackWhere(filters);
+        const d = this.db.prepare(`SELECT COUNT(*) delivered, SUM(CASE WHEN d.status='failed' THEN 1 ELSE 0 END) delivery_failures FROM deliveries d WHERE ${delivery.where}`).get(...delivery.params);
+        const f = this.db.prepare(`SELECT COUNT(*) ratings, COUNT(DISTINCT d.delivery_id) rated_deliveries, SUM(CASE WHEN lf.semantic='positive' THEN 1 ELSE 0 END) positive, SUM(CASE WHEN lf.semantic='negative' THEN 1 ELSE 0 END) negative, SUM(CASE WHEN lf.semantic='progress' THEN 1 ELSE 0 END) progress FROM deliveries d JOIN (${LATEST}) lf ON lf.delivery_id=d.delivery_id WHERE ${feedback.where}`).get(...feedback.params);
+        const outbox = this.db.prepare(`SELECT COUNT(*) failures FROM feedback_outbox WHERE status='failed' AND created_at>=? AND created_at<?`).get(filters.from, filters.to);
+        const delivered = Number(d.delivered ?? 0);
+        const ratings = Number(f.ratings ?? 0);
+        const ratedDeliveries = Number(f.rated_deliveries ?? 0);
+        const positive = Number(f.positive ?? 0);
+        return { delivered, ratedDeliveries, ratings, positive, negative: Number(f.negative ?? 0), progress: Number(f.progress ?? 0), ratingCoverage: delivered ? ratedDeliveries / delivered : 0, positiveRate: ratings ? positive / ratings : 0, deliveryFailures: Number(d.delivery_failures ?? 0), outboxFailures: Number(outbox.failures ?? 0) };
+    }
+    trend(filters) {
+        const sql = feedbackWhere(filters);
+        return this.db.prepare(`SELECT substr(d.created_at,1,10) bucket, SUM(lf.semantic='positive') positive, SUM(lf.semantic='negative') negative, SUM(lf.semantic='progress') progress, COUNT(*) ratings FROM deliveries d JOIN (${LATEST}) lf ON lf.delivery_id=d.delivery_id WHERE ${sql.where} GROUP BY bucket ORDER BY bucket`).all(...sql.params)
+            .map(row => ({ bucket: row.bucket, positive: Number(row.positive), negative: Number(row.negative), progress: Number(row.progress), ratings: Number(row.ratings) }));
+    }
+    reasons(filters) {
+        const sql = feedbackWhere(filters);
+        return this.db.prepare(`SELECT lf.reason_key reason_key,COUNT(*) count FROM deliveries d JOIN (${LATEST}) lf ON lf.delivery_id=d.delivery_id WHERE ${sql.where} AND lf.reason_key IS NOT NULL GROUP BY lf.reason_key ORDER BY count DESC,reason_key`).all(...sql.params)
+            .map(row => ({ reasonKey: row.reason_key, count: Number(row.count) }));
+    }
+    deliveries(filters, page = {}) {
+        const sql = feedbackWhere(filters);
+        const limit = Math.max(1, Math.min(page.limit ?? 50, 100));
+        if (page.cursor) {
+            let cursor;
+            try {
+                cursor = JSON.parse(Buffer.from(page.cursor, 'base64url').toString('utf8'));
+            }
+            catch {
+                throw new Error('feedback_analytics_invalid_cursor');
+            }
+            sql.where += ' AND (d.created_at<? OR (d.created_at=? AND d.delivery_id<?))';
+            sql.params.push(cursor.createdAt, cursor.createdAt, cursor.deliveryId);
+        }
+        const rows = this.db.prepare(`SELECT d.delivery_id,d.created_at,d.completed_at,d.status,r.content_hash,r.content_ref,d.platform,d.platform_message_id,d.platform_app_id,d.bot_app_id,d.session_id,d.turn_id,d.chat_id,d.topic_root_id,d.workflow_id,d.task_id,d.cli_id,d.cli_version,d.model,d.skill_name,d.skill_version,lf.semantic,lf.result,lf.reason_key FROM deliveries d JOIN responses r ON r.response_id=d.response_id LEFT JOIN (${LATEST}) lf ON lf.delivery_id=d.delivery_id WHERE ${sql.where} ORDER BY d.created_at DESC,d.delivery_id DESC LIMIT ?`).all(...sql.params, limit + 1);
+        const hasMore = rows.length > limit;
+        const selected = rows.slice(0, limit);
+        const items = selected.map(row => ({ deliveryId: row.delivery_id, createdAt: row.created_at, ...(row.completed_at ? { completedAt: row.completed_at } : {}), ...(row.status ? { status: row.status } : {}), contentHash: row.content_hash, ...(row.content_ref ? { contentRef: row.content_ref } : {}), platform: row.platform, platformMessageId: row.platform_message_id, platformAppId: row.platform_app_id, ...(row.bot_app_id ? { botAppId: row.bot_app_id } : {}), ...(row.session_id ? { sessionId: row.session_id } : {}), ...(row.turn_id ? { turnId: row.turn_id } : {}), ...(row.chat_id ? { chatId: row.chat_id } : {}), ...(row.topic_root_id ? { topicRootId: row.topic_root_id } : {}), ...(row.workflow_id ? { workflowId: row.workflow_id } : {}), ...(row.task_id ? { taskId: row.task_id } : {}), ...(row.cli_id ? { cliId: row.cli_id } : {}), ...(row.cli_version ? { cliVersion: row.cli_version } : {}), ...(row.model ? { model: row.model } : {}), ...(row.skill_name ? { skillName: row.skill_name } : {}), ...(row.skill_version ? { skillVersion: row.skill_version } : {}), ...(row.semantic ? { semantic: row.semantic } : {}), ...(row.result ? { verdictKey: row.result } : {}), ...(row.reason_key ? { reasonKey: row.reason_key } : {}) }));
+        const last = selected.at(-1);
+        const nextCursor = hasMore && last ? Buffer.from(JSON.stringify({ createdAt: last.created_at, deliveryId: last.delivery_id })).toString('base64url') : undefined;
+        return { items, ...(nextCursor ? { nextCursor } : {}) };
+    }
+}
+//# sourceMappingURL=feedback-analytics.js.map

package/dist/services/feedback-analytics.js.map

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

package/dist/services/feedback-outbox.d.ts

@@ -0,0 +1,24 @@
+export type FeedbackEventType = 'turn.completed' | 'feedback.revised';
+export interface FeedbackWebhookDestination {
+    id: string;
+    enabled: boolean;
+    url: string;
+    eventTypes: FeedbackEventType[];
+    secretRef: string;
+    timeoutMs?: number;
+}
+export interface FeedbackEventEnvelope<T = Record<string, unknown>> {
+    eventId: string;
+    type: FeedbackEventType;
+    version: 1;
+    time: string;
+    data: T;
+}
+export interface FrozenWebhookDestination {
+    id: string;
+    url: string;
+    secretRef: string;
+    timeoutMs: number;
+}
+export declare function effectiveWebhookDestinations(eventType: FeedbackEventType, groups: ReadonlyArray<ReadonlyArray<FeedbackWebhookDestination> | undefined>): FrozenWebhookDestination[];
+//# sourceMappingURL=feedback-outbox.d.ts.map

package/dist/services/feedback-outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-outbox.d.ts","sourceRoot":"","sources":["../../src/services/feedback-outbox.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAEtE,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,0BAA0B,CAAC,GAAG,SAAS,CAAC,GAC3E,wBAAwB,EAAE,CAS5B"}

package/dist/services/feedback-outbox.js

@@ -0,0 +1,12 @@
+export function effectiveWebhookDestinations(eventType, groups) {
+    const byId = new Map();
+    for (const group of groups) {
+        for (const item of group ?? [])
+            byId.set(item.id, item);
+    }
+    return [...byId.values()]
+        .filter(item => item.enabled && item.eventTypes.includes(eventType))
+        .sort((a, b) => a.id.localeCompare(b.id))
+        .map(item => ({ id: item.id, url: item.url, secretRef: item.secretRef, timeoutMs: item.timeoutMs ?? 10_000 }));
+}
+//# sourceMappingURL=feedback-outbox.js.map

package/dist/services/feedback-outbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-outbox.js","sourceRoot":"","sources":["../../src/services/feedback-outbox.ts"],"names":[],"mappings":"AA0BA,MAAM,UAAU,4BAA4B,CAC1C,SAA4B,EAC5B,MAA4E;IAE5E,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsC,CAAC;IAC3D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI,EAAE;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;SACtB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;SACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACxC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;AACnH,CAAC"}

package/dist/services/feedback-policy-resolver.d.ts

@@ -0,0 +1,56 @@
+import type { BotConfig } from '../bot-registry.js';
+import { type FeedbackPolicy } from './feedback-policy.js';
+export interface FeedbackPolicyLayer {
+    enabled?: boolean;
+    audience?: 'requester';
+    visibleSemantics?: unknown[];
+    buttons?: unknown[];
+    negativeFollowup?: {
+        reasons?: unknown[];
+        comment?: {
+            enabled?: boolean;
+            required?: boolean;
+            placeholder?: string;
+            maxLength?: number;
+        };
+    };
+    allowReselect?: boolean;
+}
+/** Validate and defensively copy a persisted policy layer without filling defaults. */
+export declare function normalizeFeedbackPolicyLayer(raw: unknown): FeedbackPolicyLayer;
+export declare function resolveEffectiveFeedbackPolicy(input: {
+    team?: FeedbackPolicyLayer;
+    bot?: FeedbackPolicyLayer;
+    chat?: FeedbackPolicyLayer;
+    apiOnly?: boolean;
+}): FeedbackPolicy | undefined;
+/** Resolve local hosted-team, bot, and bot-scoped chat layers at delivery time. */
+export declare function resolveFeedbackTeamId(input: {
+    dataDir: string;
+    chatId?: string;
+}): string | undefined;
+export declare function resolveFeedbackPolicyForDelivery(input: {
+    dataDir: string;
+    larkAppId: string;
+    chatId?: string;
+    bot: Pick<BotConfig, 'apiOnly' | 'feedback' | 'chatFeedbackPolicies'>;
+}): FeedbackPolicy | undefined;
+export interface FeedbackPolicyTrace {
+    teamId: string | null;
+    layers: {
+        team?: FeedbackPolicyLayer;
+        bot?: FeedbackPolicyLayer;
+        chat?: FeedbackPolicyLayer;
+    };
+    effective: FeedbackPolicy | null;
+    sources: Record<string, 'team' | 'bot' | 'chat'>;
+    reason: 'enabled' | 'disabled' | 'api_only' | 'ambiguous_team';
+}
+/** Dashboard-safe explanation of the same delivery-time resolution contract. */
+export declare function traceFeedbackPolicyForDelivery(input: {
+    dataDir: string;
+    larkAppId: string;
+    chatId?: string;
+    bot: Pick<BotConfig, 'apiOnly' | 'feedback' | 'chatFeedbackPolicies'>;
+}): FeedbackPolicyTrace;
+//# sourceMappingURL=feedback-policy-resolver.d.ts.map

package/dist/services/feedback-policy-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-policy-resolver.d.ts","sourceRoot":"","sources":["../../src/services/feedback-policy-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIpF,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE;QACjB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAgBD,uFAAuF;AACvF,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CA8C9E;AAmBD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,cAAc,GAAG,SAAS,CAQ7B;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAMrG;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,sBAAsB,CAAC,CAAC;CACvE,GAAG,cAAc,GAAG,SAAS,CAa7B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,mBAAmB,CAAC;QAAC,GAAG,CAAC,EAAE,mBAAmB,CAAC;QAAC,IAAI,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAC9F,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IACjD,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;CAChE;AAED,gFAAgF;AAChF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,sBAAsB,CAAC,CAAC;CACvE,GAAG,mBAAmB,CAuBtB"}

package/dist/services/feedback-policy-resolver.js

@@ -0,0 +1,156 @@
+import { normalizeFeedbackPolicy } from './feedback-policy.js';
+import { getTeam } from './team-store.js';
+import { listTeamGroups } from './team-groups-store.js';
+const TOP_LEVEL = new Set(['enabled', 'audience', 'visibleSemantics', 'buttons', 'negativeFollowup', 'allowReselect']);
+const FOLLOWUP = new Set(['reasons', 'comment']);
+const COMMENT = new Set(['enabled', 'required', 'placeholder', 'maxLength']);
+function record(value, path) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`${path} must be an object`);
+    return value;
+}
+function rejectUnknown(value, allowed, path) {
+    const unknown = Object.keys(value).find(key => !allowed.has(key));
+    if (unknown)
+        throw new Error(`${path}.${unknown} is unknown`);
+}
+/** Validate and defensively copy a persisted policy layer without filling defaults. */
+export function normalizeFeedbackPolicyLayer(raw) {
+    const input = record(raw, 'feedback');
+    rejectUnknown(input, TOP_LEVEL, 'feedback');
+    if (input.enabled !== undefined && typeof input.enabled !== 'boolean')
+        throw new Error('feedback.enabled must be boolean');
+    if (input.audience !== undefined && input.audience !== 'requester')
+        throw new Error('feedback.audience must be requester');
+    if (input.allowReselect !== undefined && typeof input.allowReselect !== 'boolean')
+        throw new Error('feedback.allowReselect must be boolean');
+    if (input.visibleSemantics !== undefined && !Array.isArray(input.visibleSemantics))
+        throw new Error('feedback.visibleSemantics must be an array');
+    if (input.buttons !== undefined && !Array.isArray(input.buttons))
+        throw new Error('feedback.buttons must be an array');
+    let negativeFollowup;
+    if (input.negativeFollowup !== undefined) {
+        const followup = record(input.negativeFollowup, 'feedback.negativeFollowup');
+        rejectUnknown(followup, FOLLOWUP, 'feedback.negativeFollowup');
+        if (followup.reasons !== undefined && !Array.isArray(followup.reasons))
+            throw new Error('feedback.negativeFollowup.reasons must be an array');
+        let comment;
+        if (followup.comment !== undefined) {
+            const rawComment = record(followup.comment, 'feedback.negativeFollowup.comment');
+            rejectUnknown(rawComment, COMMENT, 'feedback.negativeFollowup.comment');
+            if (rawComment.enabled !== undefined && typeof rawComment.enabled !== 'boolean')
+                throw new Error('feedback.negativeFollowup.comment.enabled must be boolean');
+            if (rawComment.required !== undefined && typeof rawComment.required !== 'boolean')
+                throw new Error('feedback.negativeFollowup.comment.required must be boolean');
+            if (rawComment.placeholder !== undefined && typeof rawComment.placeholder !== 'string')
+                throw new Error('feedback.negativeFollowup.comment.placeholder must be string');
+            if (rawComment.maxLength !== undefined && !Number.isInteger(rawComment.maxLength))
+                throw new Error('feedback.negativeFollowup.comment.maxLength must be integer');
+            comment = structuredClone(rawComment);
+        }
+        negativeFollowup = {
+            ...(followup.reasons !== undefined ? { reasons: structuredClone(followup.reasons) } : {}),
+            ...(comment !== undefined ? { comment } : {}),
+        };
+    }
+    const layer = {
+        ...(input.enabled !== undefined ? { enabled: input.enabled } : {}),
+        ...(input.audience !== undefined ? { audience: input.audience } : {}),
+        ...(input.visibleSemantics !== undefined ? { visibleSemantics: structuredClone(input.visibleSemantics) } : {}),
+        ...(input.buttons !== undefined ? { buttons: structuredClone(input.buttons) } : {}),
+        ...(negativeFollowup !== undefined ? { negativeFollowup } : {}),
+        ...(input.allowReselect !== undefined ? { allowReselect: input.allowReselect } : {}),
+    };
+    // Validate supplied atomic values without expanding this persisted layer with
+    // defaults. Layers remain partial so a restart cannot turn inherited values
+    // into stale bot/chat-owned copies.
+    if (layer.visibleSemantics !== undefined || layer.buttons !== undefined || layer.negativeFollowup !== undefined) {
+        normalizeFeedbackPolicy({ enabled: true, ...layer });
+    }
+    return layer;
+}
+function mergeLayer(target, raw) {
+    if (!raw)
+        return;
+    const layer = normalizeFeedbackPolicyLayer(raw);
+    for (const field of ['enabled', 'audience', 'visibleSemantics', 'buttons', 'allowReselect']) {
+        if (layer[field] !== undefined)
+            target[field] = structuredClone(layer[field]);
+    }
+    if (layer.negativeFollowup) {
+        const prior = (target.negativeFollowup ?? {});
+        const next = { ...prior };
+        if (layer.negativeFollowup.reasons !== undefined)
+            next.reasons = structuredClone(layer.negativeFollowup.reasons);
+        if (layer.negativeFollowup.comment !== undefined) {
+            next.comment = { ...(prior.comment ?? {}), ...structuredClone(layer.negativeFollowup.comment) };
+        }
+        target.negativeFollowup = next;
+    }
+}
+export function resolveEffectiveFeedbackPolicy(input) {
+    if (input.apiOnly)
+        return undefined;
+    const merged = { enabled: false };
+    mergeLayer(merged, input.team);
+    mergeLayer(merged, input.bot);
+    mergeLayer(merged, input.chat);
+    if (merged.enabled !== true)
+        return undefined;
+    return structuredClone(normalizeFeedbackPolicy(merged));
+}
+/** Resolve local hosted-team, bot, and bot-scoped chat layers at delivery time. */
+export function resolveFeedbackTeamId(input) {
+    if (!input.chatId)
+        return undefined;
+    const teamIds = [...new Set(listTeamGroups(input.dataDir)
+            .filter(binding => binding.chatId === input.chatId && !binding.teamId.startsWith('platform:'))
+            .map(binding => binding.teamId))];
+    return teamIds.length === 1 ? teamIds[0] : undefined;
+}
+export function resolveFeedbackPolicyForDelivery(input) {
+    const bindings = input.chatId
+        ? listTeamGroups(input.dataDir).filter(binding => binding.chatId === input.chatId && !binding.teamId.startsWith('platform:'))
+        : [];
+    const teamIds = [...new Set(bindings.map(binding => binding.teamId))];
+    if (teamIds.length > 1)
+        return undefined;
+    const team = teamIds.length === 1 ? getTeam(input.dataDir, teamIds[0]) : null;
+    return resolveEffectiveFeedbackPolicy({
+        team: team?.feedback,
+        bot: input.bot.feedback,
+        chat: input.chatId ? input.bot.chatFeedbackPolicies?.[input.chatId] : undefined,
+        apiOnly: input.bot.apiOnly,
+    });
+}
+/** Dashboard-safe explanation of the same delivery-time resolution contract. */
+export function traceFeedbackPolicyForDelivery(input) {
+    const bindings = input.chatId
+        ? listTeamGroups(input.dataDir).filter(binding => binding.chatId === input.chatId && !binding.teamId.startsWith('platform:'))
+        : [];
+    const teamIds = [...new Set(bindings.map(binding => binding.teamId))];
+    if (teamIds.length > 1)
+        return { teamId: null, layers: {}, effective: null, sources: {}, reason: 'ambiguous_team' };
+    const teamId = teamIds[0] ?? null;
+    const layers = {
+        ...(teamId && getTeam(input.dataDir, teamId)?.feedback ? { team: normalizeFeedbackPolicyLayer(getTeam(input.dataDir, teamId).feedback) } : {}),
+        ...(input.bot.feedback ? { bot: normalizeFeedbackPolicyLayer(input.bot.feedback) } : {}),
+        ...(input.chatId && input.bot.chatFeedbackPolicies?.[input.chatId]
+            ? { chat: normalizeFeedbackPolicyLayer(input.bot.chatFeedbackPolicies[input.chatId]) } : {}),
+    };
+    const sources = {};
+    for (const [scope, layer] of Object.entries(layers)) {
+        for (const key of Object.keys(layer))
+            sources[key] = scope;
+        if (layer.negativeFollowup) {
+            for (const key of Object.keys(layer.negativeFollowup))
+                sources[`negativeFollowup.${key}`] = scope;
+            if (layer.negativeFollowup.comment)
+                for (const key of Object.keys(layer.negativeFollowup.comment))
+                    sources[`negativeFollowup.comment.${key}`] = scope;
+        }
+    }
+    const effective = resolveEffectiveFeedbackPolicy({ ...layers, apiOnly: input.bot.apiOnly }) ?? null;
+    return { teamId, layers, effective, sources, reason: input.bot.apiOnly ? 'api_only' : effective ? 'enabled' : 'disabled' };
+}
+//# sourceMappingURL=feedback-policy-resolver.js.map

package/dist/services/feedback-policy-resolver.js.map

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

package/dist/services/feedback-policy.d.ts

@@ -0,0 +1,41 @@
+export type FeedbackSemantic = 'positive' | 'progress' | 'negative';
+export type FeedbackButtonStyle = 'primary' | 'default' | 'danger';
+export interface FeedbackButton {
+    key: string;
+    label: string;
+    semantic: FeedbackSemantic;
+    style: FeedbackButtonStyle;
+}
+export interface FeedbackReason {
+    key: string;
+    label: string;
+}
+export interface FeedbackPolicy {
+    enabled: true;
+    audience: 'requester';
+    visibleSemantics: FeedbackSemantic[];
+    buttons: FeedbackButton[];
+    negativeFollowup: {
+        reasons: FeedbackReason[];
+        comment: {
+            enabled: boolean;
+            required: boolean;
+            placeholder: string;
+            maxLength: number;
+        };
+    };
+    allowReselect: boolean;
+}
+export interface FeedbackPolicyInput {
+    enabled?: boolean;
+    audience?: unknown;
+    visibleSemantics?: unknown;
+    buttons?: unknown;
+    negativeFollowup?: unknown;
+    allowReselect?: unknown;
+}
+export declare function normalizeFeedbackPolicy(raw: unknown): FeedbackPolicy;
+export declare function resolveFeedbackPolicy(raw: unknown, bot?: {
+    apiOnly?: boolean;
+}): FeedbackPolicy | undefined;
+//# sourceMappingURL=feedback-policy.d.ts.map

package/dist/services/feedback-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-policy.d.ts","sourceRoot":"","sources":["../../src/services/feedback-policy.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAE9D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,WAAW,CAAC;IACtB,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACrC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,gBAAgB,EAAE;QAChB,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,OAAO,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,QAAQ,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1F,CAAC;IACF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAkCD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CA4DpE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,GAAG,SAAS,CAG3G"}

package/dist/services/feedback-policy.js

@@ -0,0 +1,102 @@
+const SEMANTICS = ['positive', 'progress', 'negative'];
+const DEFAULT_BUTTONS = [
+    { key: 'conclusive_usable', label: '结论可用', semantic: 'positive', style: 'primary' },
+    { key: 'effective_progress', label: '有效推进', semantic: 'progress', style: 'default' },
+    { key: 'incorrect', label: '结论有误', semantic: 'negative', style: 'danger' },
+];
+const KEY = /^[a-z0-9_-]+$/;
+function object(value, path) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`${path} must be an object`);
+    return value;
+}
+function text(value, path, max) {
+    if (typeof value !== 'string' || value.length < 1 || value.length > max)
+        throw new Error(`${path} must be 1-${max} characters`);
+    return value;
+}
+function key(value, path) {
+    if (typeof value !== 'string' || !KEY.test(value))
+        throw new Error(`${path} key must match [a-z0-9_-]+`);
+    return value;
+}
+function unique(values, path) {
+    if (new Set(values).size !== values.length)
+        throw new Error(`${path} keys must be unique`);
+}
+function semantic(value, path) {
+    if (value !== 'positive' && value !== 'progress' && value !== 'negative')
+        throw new Error(`${path}.semantic is invalid`);
+    return value;
+}
+export function normalizeFeedbackPolicy(raw) {
+    const input = object(raw, 'feedback');
+    if (input.enabled !== true)
+        throw new Error('feedback.enabled must be true');
+    if (input.audience !== undefined && input.audience !== 'requester')
+        throw new Error('feedback.audience must be requester');
+    let visibleSemantics = [...SEMANTICS];
+    if (input.visibleSemantics !== undefined) {
+        if (!Array.isArray(input.visibleSemantics) || input.visibleSemantics.length < 1 || input.visibleSemantics.length > 3) {
+            throw new Error('feedback.visibleSemantics must contain 1-3 semantics');
+        }
+        visibleSemantics = input.visibleSemantics.map((value, index) => semantic(value, `feedback.visibleSemantics[${index}]`));
+        unique(visibleSemantics, 'feedback.visibleSemantics');
+    }
+    let buttons = DEFAULT_BUTTONS.map(button => ({ ...button }));
+    if (input.buttons !== undefined) {
+        if (!Array.isArray(input.buttons) || input.buttons.length < 2 || input.buttons.length > 4)
+            throw new Error('feedback.buttons must contain 2-4 buttons');
+        buttons = input.buttons.map((rawButton, index) => {
+            const button = object(rawButton, `feedback.buttons[${index}]`);
+            // Compatibility boundary for legacy config and persisted policy snapshots.
+            const value = button.semantic ?? button.sentiment;
+            const normalizedSemantic = semantic(value, `feedback.buttons[${index}]`);
+            const style = button.style ?? (normalizedSemantic === 'positive' ? 'primary' : 'default');
+            if (style !== 'primary' && style !== 'default' && style !== 'danger')
+                throw new Error(`feedback.buttons[${index}].style is invalid`);
+            return { key: key(button.key, `feedback.buttons[${index}]`), label: text(button.label, `feedback.buttons[${index}].label`, 24), semantic: normalizedSemantic, style };
+        });
+        unique(buttons.map(button => button.key), 'feedback.buttons');
+    }
+    for (const required of visibleSemantics) {
+        if (!buttons.some(button => button.semantic === required))
+            throw new Error(`feedback.buttons requires at least one ${required} button`);
+    }
+    if (buttons.some(button => !visibleSemantics.includes(button.semantic))) {
+        throw new Error('feedback.buttons semantic must be included in feedback.visibleSemantics');
+    }
+    const followup = input.negativeFollowup === undefined ? {} : object(input.negativeFollowup, 'feedback.negativeFollowup');
+    let reasons = [];
+    if (followup.reasons !== undefined) {
+        if (!Array.isArray(followup.reasons) || followup.reasons.length > 6)
+            throw new Error('feedback.negativeFollowup.reasons allows 0-6 reasons');
+        reasons = followup.reasons.map((rawReason, index) => {
+            const reason = object(rawReason, `feedback.negativeFollowup.reasons[${index}]`);
+            return { key: key(reason.key, `feedback.negativeFollowup.reasons[${index}]`), label: text(reason.label, `feedback.negativeFollowup.reasons[${index}].label`, 32) };
+        });
+        unique(reasons.map(reason => reason.key), 'feedback.negativeFollowup.reasons');
+    }
+    const rawComment = followup.comment === undefined ? {} : object(followup.comment, 'feedback.negativeFollowup.comment');
+    const maxLength = rawComment.maxLength ?? 1000;
+    if (!Number.isInteger(maxLength) || Number(maxLength) < 1 || Number(maxLength) > 2000)
+        throw new Error('feedback.negativeFollowup.comment.maxLength must be 1-2000');
+    const placeholder = rawComment.placeholder === undefined ? '可以补充哪里需要改进' : text(rawComment.placeholder, 'feedback.negativeFollowup.comment.placeholder', 100);
+    return {
+        enabled: true,
+        audience: 'requester',
+        allowReselect: input.allowReselect === true,
+        visibleSemantics,
+        buttons,
+        negativeFollowup: {
+            reasons,
+            comment: { enabled: rawComment.enabled !== false, required: rawComment.required === true, placeholder, maxLength: Number(maxLength) },
+        },
+    };
+}
+export function resolveFeedbackPolicy(raw, bot) {
+    if (bot?.apiOnly || !raw || typeof raw !== 'object' || Array.isArray(raw) || raw.enabled !== true)
+        return undefined;
+    return normalizeFeedbackPolicy(raw);
+}
+//# sourceMappingURL=feedback-policy.js.map