@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillTemplatePageMount.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview FDE Skill 模板区域挂载工具 - 解析 region 名与 mapping
+ * @author seadon
+ * @created 2026-07-10
+ */
+import type { FdeSkillCardIntent } from './fdeSkillCardTypes';
+import type { FdeSkillTemplatePageManifest } from './fdeSkillTemplatePageTypes';
+/**
+ * 将具名插槽名解析为区域编号。
+ * @param name - 如 region-3
+ * @returns 区域编号或 null
+ */
+export declare function parseFdeSkillTemplateRegionName(name: string): number | null;
+/**
+ * 格式化区域插槽名。
+ * @param regionNo - 区域编号
+ * @returns region-N
+ */
+export declare function formatFdeSkillTemplateRegionName(regionNo: number): string;
+/**
+ * 按 card.id 建索引。
+ * @param cards - 卡列表
+ * @returns id → Intent
+ */
+export declare function indexFdeSkillTemplateCardsById(cards: readonly FdeSkillCardIntent[]): Map<string, FdeSkillCardIntent>;
+/**
+ * 根据 mappings 构建 region_no → 卡。
+ * @param manifest - 模板页协议
+ * @returns 区域到卡的映射
+ */
+export declare function resolveFdeSkillTemplateRegionCardMap(manifest: FdeSkillTemplatePageManifest): Map<number, FdeSkillCardIntent>;
+/**
+ * 深拷贝模板页协议。
+ * @param page - 源协议
+ * @returns 可写副本
+ */
+export declare function cloneFdeSkillTemplatePage(page: FdeSkillTemplatePageManifest): FdeSkillTemplatePageManifest;

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillTemplatePageTypes.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview FDE Skill 模板内容页类型 - 定义自由模板区域与 MD 映射协议
+ * @author seadon
+ * @created 2026-07-10
+ */
+import type { FdeSkillCardIntent, FdeSkillPageFilterBar } from './fdeSkillCardTypes';
+/** 模板壳组件固定名 */
+export type FdeSkillTemplateShellComponentName = 'FdeSkillGeneratedTemplateShell';
+/** 区域期望内容类型 */
+export type FdeSkillTemplateRegionContentKind = 'chart' | 'list' | 'number' | 'text' | 'unknown';
+/**
+ * 模板壳中的可替换区域声明。
+ * region_no 对应 data-fde-region 与具名插槽 region-${region_no}。
+ */
+export interface FdeSkillTemplateRegionSpec {
+    region_no: number;
+    label: string;
+    content_kind?: FdeSkillTemplateRegionContentKind;
+    size?: 'sm' | 'md' | 'lg';
+}
+/**
+ * MD 卡序号 → 模板区域映射。
+ */
+export interface FdeSkillTemplateRegionMapping {
+    md_card_index: number;
+    region_no: number;
+    card_id: string;
+    /** 默认 true：用文档标题更新区域标题文案（由壳/宿主约定节点） */
+    update_title?: boolean;
+}
+export interface FdeSkillTemplateShellSpec {
+    component: FdeSkillTemplateShellComponentName;
+}
+export interface FdeSkillTemplatePageSourcePatch {
+    target_project: 'release/web-workbench';
+    container_selector: '.fde-contain';
+    mode: 'insert' | 'update';
+    target_file?: string;
+    target_runtime: 'fde-skill-template-page-runtime';
+}
+/**
+ * 模板内容替换页完整协议。
+ */
+export interface FdeSkillTemplatePageManifest {
+    version: '1.0';
+    meta: {
+        id: string;
+        title: string;
+        description?: string;
+        generated_at?: string;
+    };
+    shell: FdeSkillTemplateShellSpec;
+    /** 页面级筛选条；与 cards 中 kind=query 二选一或并存时由 Host 归一 */
+    filter_bar?: FdeSkillPageFilterBar | null;
+    regions: FdeSkillTemplateRegionSpec[];
+    mappings: FdeSkillTemplateRegionMapping[];
+    cards: FdeSkillCardIntent[];
+    source_patch: FdeSkillTemplatePageSourcePatch;
+}

package/dist/internal/personal-workbench/fde-skill-cards/runtime/fdeSkillTimeRangeDefault.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview 时间范围筛选器默认值解析 - 与 skill time_range_default.py 口径对齐
+ * @author seadon
+ * @created 2026-07-27
+ */
+export type FdeSkillTimeRangeDefaultPreset = {
+    kind: 'relative_days';
+    amount: number;
+} | {
+    kind: 'relative_months';
+    amount: number;
+} | {
+    kind: 'absolute';
+    default_value?: [string, string];
+};
+/**
+ * 最近 N 天（含当天共 N 个自然日）。
+ * @param amount - 天数。
+ * @param now - 锚点。
+ * @returns [start, end]。
+ */
+export declare function resolveRelativeDays(amount: number, now?: Date): [string, string];
+/**
+ * 最近 N 个月。
+ * @param amount - 月数。
+ * @param now - 锚点。
+ * @returns [start, end]。
+ */
+export declare function resolveRelativeMonths(amount: number, now?: Date): [string, string];
+/**
+ * 从相对文案解析 preset（兼容旧 generated 残留字符串）。
+ * @param raw - 文案。
+ * @returns preset 或 null。
+ */
+export declare function parseRelativeTimeRangeText(raw: string): FdeSkillTimeRangeDefaultPreset | null;
+/**
+ * 按打开时 now 解析控件默认时间范围。
+ * @param control - 查询控件（可含 default_preset / default_value）。
+ * @param now - 锚点，默认当前浏览器本地时间。
+ * @returns [start, end]；无默认返回 undefined。
+ */
+export declare function resolveFdeSkillTimeRangeDefault(control: {
+    default_preset?: FdeSkillTimeRangeDefaultPreset | null;
+    default_value?: unknown;
+} | null | undefined, now?: Date): [string, string] | undefined;

package/dist/internal/personal-workbench/lib/agentMemoryClient.d.ts

@@ -0,0 +1,376 @@
+export type AgentMemoryAgentType = 'query' | 'approval' | 'workbench' | 'common';
+export type AgentMemoryType = 'metric_definition' | 'filter_preference' | 'business_rule' | 'approval_preference' | 'ui_preference' | 'user_profile' | 'other';
+export type AgentMemoryStatus = 'candidate' | 'approved' | 'rejected' | 'forgotten';
+export type AgentMemoryEventAction = 'propose' | 'edit_content' | 'edit_policy' | 'approve' | 'reject' | 'forget' | 'source_deleted' | 'recall' | 'inject' | 'skip' | 'conflict' | 'confirm';
+export interface AgentMemoryScope {
+    level: 'conversation' | 'app' | 'user' | 'tenant' | 'global';
+    userId?: string;
+    tenantId?: string;
+    conversationId?: string;
+    appId?: string;
+    workspaceId?: string;
+}
+export interface AgentMemoryEvidence {
+    type: 'conversation' | 'trace' | 'manual' | 'document';
+    text: string;
+    refId?: string;
+    createdAt?: string;
+    sourceDeleted?: boolean;
+    sourceDeletedAt?: string;
+}
+export interface AgentMemoryRecallPolicy {
+    enabled: boolean;
+    priority?: number;
+    maxInjectPerSession?: number;
+    conditions?: Record<string, unknown>;
+}
+export interface AgentMemoryItem {
+    id: string;
+    agentType: AgentMemoryAgentType;
+    type: AgentMemoryType;
+    title: string;
+    content: string;
+    scope: AgentMemoryScope;
+    layerPath: string[];
+    tags: string[];
+    status: AgentMemoryStatus;
+    sourceType: 'manual' | 'conversation' | 'trace' | 'system' | 'imported';
+    reviewRequired: boolean;
+    confidence: number;
+    evidence: AgentMemoryEvidence[];
+    sourceConversationIds?: string[];
+    sourceTraceIds?: string[];
+    recallPolicy: AgentMemoryRecallPolicy;
+    createdBy: string;
+    updatedBy: string;
+    createdAt: string;
+    updatedAt: string;
+    lastUsedAt?: string;
+}
+export interface AgentMemoryEvent {
+    id: string;
+    memoryId: string;
+    action: AgentMemoryEventAction;
+    actorId: string;
+    traceId?: string;
+    conversationId?: string;
+    details?: Record<string, unknown>;
+    readOnly: boolean;
+    createdAt: string;
+}
+export interface ListAgentMemoryQuery {
+    agentType?: AgentMemoryAgentType;
+    type?: AgentMemoryType;
+    status?: AgentMemoryStatus;
+    scopeLevel?: AgentMemoryScope['level'];
+    userId?: string;
+    tenantId?: string;
+    conversationId?: string;
+    appId?: string;
+    keyword?: string;
+}
+export interface CreateManualMemoryCandidatePayload {
+    actorId?: string;
+    agentType: AgentMemoryAgentType;
+    type: AgentMemoryType;
+    title: string;
+    content: string;
+    scope: AgentMemoryScope;
+    layerPath?: string[];
+    tags?: string[];
+    evidence?: AgentMemoryEvidence[];
+    recallPolicy?: Partial<AgentMemoryRecallPolicy>;
+}
+export interface CreateConversationMemoryCandidatePayload {
+    actorId?: string;
+    agentType: AgentMemoryAgentType;
+    type: AgentMemoryType;
+    title: string;
+    content: string;
+    scope: AgentMemoryScope;
+    layerPath?: string[];
+    tags?: string[];
+    evidence: AgentMemoryEvidence;
+    traceId?: string;
+    recallPolicy?: Partial<AgentMemoryRecallPolicy>;
+    confidence?: number;
+}
+export interface ExtractConversationMemoryPayload {
+    actorId?: string;
+    agentType?: AgentMemoryAgentType;
+    conversationId: string;
+    traceId?: string;
+    tenantId?: string;
+    userId?: string;
+    appId?: string;
+    workspaceId?: string;
+    messages: Array<{
+        role?: string;
+        content?: unknown;
+    }>;
+}
+export interface ExtractConversationMemoryResult {
+    created: AgentMemoryItem[];
+    skipped: Array<{
+        title: string;
+        reason: 'no_memory_signal' | 'duplicate_existing_or_batch' | 'invalid_scope';
+        content?: string;
+    }>;
+}
+export interface AgentMemoryCandidateDraft extends CreateConversationMemoryCandidatePayload {
+    sourceType: 'conversation' | 'trace';
+    confidence: number;
+}
+export interface PreviewConversationMemoryResult {
+    drafts: AgentMemoryCandidateDraft[];
+    skipped: ExtractConversationMemoryResult['skipped'];
+}
+export interface UpdateMemoryContentPayload {
+    actorId?: string;
+    title?: string;
+    content?: string;
+    tags?: string[];
+    evidence?: AgentMemoryEvidence[];
+    layerPath?: string[];
+}
+export interface UpdateMemoryPolicyPayload {
+    actorId?: string;
+    status?: AgentMemoryStatus;
+    reviewRequired?: boolean;
+    recallPolicy?: Partial<AgentMemoryRecallPolicy>;
+    confidence?: number;
+}
+export interface AgentConversationContextSnapshot {
+    id: string;
+    conversationId: string;
+    sourceMessageCount: number;
+    coveredMessageIds: string[];
+    coveredTurnRange: {
+        start: number;
+        end: number;
+    };
+    summary: string;
+    recentMessages: Array<{
+        role?: string;
+        content?: unknown;
+        parts?: unknown[];
+    }>;
+    tokenEstimate: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AgentMemoryRecallPreviewPayload {
+    query: string;
+    tenantId?: string;
+    appId?: string;
+    workspaceId?: string;
+    userId?: string;
+    conversationId?: string;
+    traceId?: string;
+    maxItems?: number;
+    dryRun?: boolean;
+}
+export interface AgentMemoryCandidateHint {
+    id: string;
+    title: string;
+    content: string;
+    type: AgentMemoryType;
+    scope: AgentMemoryScope['level'];
+    confidence: number;
+    layerPath: string[];
+    evidenceRefs: string[];
+    candidateOnly: true;
+    source: 'memory';
+    reason: string;
+}
+export interface AgentMemorySkippedHint {
+    id: string;
+    title: string;
+    reason: string;
+}
+export interface AgentMemoryRecallPreviewResult {
+    candidates: AgentMemoryCandidateHint[];
+    skipped: AgentMemorySkippedHint[];
+    conflicts: AgentMemorySkippedHint[];
+    injectableContext: string;
+}
+export interface ReviewConversationMemoriesPayload {
+    actorId?: string;
+    tenantId?: string;
+    userId?: string;
+    appId?: string;
+    workspaceId?: string;
+    limit?: number;
+}
+export interface SimplifiedConversationMemoryPayload {
+    title: string;
+    content: string;
+    usageHint: string;
+    agentType?: AgentMemoryAgentType;
+    type?: AgentMemoryType;
+    scope?: Partial<AgentMemoryScope>;
+    context: {
+        tenantId?: string;
+        userId?: string;
+        appId?: string;
+        workspaceId?: string;
+        conversationId?: string;
+        traceId?: string;
+    };
+}
+export interface RecentConversationMemoryExtractionPayload {
+    conversationId: string;
+    traceId?: string;
+    rawText: string;
+    tenantId?: string;
+    userId?: string;
+    appId?: string;
+    workspaceId?: string;
+}
+export interface ReviewConversationMemoriesResult {
+    reviewedConversationCount: number;
+    createdCount: number;
+    skippedCount: number;
+    conversations: Array<{
+        conversationId: string;
+        traceId?: string;
+        candidateCount: number;
+        skippedCount: number;
+        skippedFailedTurnCount: number;
+        error?: string;
+    }>;
+}
+export interface DeleteMemoryResult {
+    deletedMemoryId: string;
+}
+/**
+ * 查询智能体记忆列表。
+ * @param query - 筛选条件
+ * @returns 记忆记录列表
+ */
+export declare function listAgentMemoryItems(query?: ListAgentMemoryQuery): Promise<AgentMemoryItem[]>;
+/**
+ * 创建手工候选记忆。
+ * @param payload - 候选记忆参数
+ * @returns 新建的记忆记录
+ */
+export declare function createManualMemoryCandidate(payload: CreateManualMemoryCandidatePayload): Promise<AgentMemoryItem>;
+/**
+ * 从对话或 trace 证据沉淀候选记忆。
+ * @param payload - 候选记忆、作用域和来源证据
+ * @returns 新建的记忆记录
+ */
+export declare function createConversationMemoryCandidate(payload: CreateConversationMemoryCandidatePayload): Promise<AgentMemoryItem>;
+/**
+ * 预览对话中可沉淀的候选记忆草稿，不写入远端记录。
+ * @param payload - 对话消息、trace 和运行时作用域
+ * @returns 候选草稿与跳过原因
+ */
+export declare function previewConversationMemoryCandidates(payload: ExtractConversationMemoryPayload): Promise<PreviewConversationMemoryResult>;
+/**
+ * 用面向用户的简化字段创建对话来源候选记忆。
+ * @param payload - 简化记忆内容、使用场景和当前运行上下文
+ * @returns 新建的候选记忆
+ */
+export declare function saveSimplifiedConversationMemory(payload: SimplifiedConversationMemoryPayload): Promise<AgentMemoryItem>;
+/**
+ * 从对话原始轮次批量抽取候选记忆。
+ * @param payload - 对话消息、trace 和运行时作用域
+ * @returns 新建候选与跳过原因
+ */
+export declare function extractConversationMemoryCandidates(payload: ExtractConversationMemoryPayload): Promise<ExtractConversationMemoryResult>;
+/**
+ * 从用户选择的最近对话文本预览候选记忆。
+ * @param payload - 已由页面选择好的对话文本和上下文
+ * @returns 候选草稿和跳过原因
+ */
+export declare function previewRecentConversationMemory(payload: RecentConversationMemoryExtractionPayload): Promise<PreviewConversationMemoryResult>;
+/**
+ * 预览当前问数上下文会召回哪些候选记忆。
+ * @param payload - 问题文本和运行上下文
+ * @returns 召回候选、跳过项和候选上下文
+ */
+export declare function previewMemoryRecall(payload: AgentMemoryRecallPreviewPayload): Promise<AgentMemoryRecallPreviewResult>;
+/**
+ * 更新记忆内容字段。
+ * @param id - 记忆 ID
+ * @param payload - 内容编辑参数
+ * @returns 更新后的记忆记录
+ */
+export declare function updateMemoryContent(id: string, payload: UpdateMemoryContentPayload): Promise<AgentMemoryItem>;
+/**
+ * 更新记忆策略字段。
+ * @param id - 记忆 ID
+ * @param payload - 策略编辑参数
+ * @returns 更新后的记忆记录
+ */
+export declare function updateMemoryPolicy(id: string, payload: UpdateMemoryPolicyPayload): Promise<AgentMemoryItem>;
+/**
+ * 审核通过记忆。
+ * @param id - 记忆 ID
+ * @param actorId - 操作人 ID
+ * @returns 更新后的记忆记录
+ */
+export declare function approveMemory(id: string, actorId?: string): Promise<AgentMemoryItem>;
+/**
+ * 驳回记忆。
+ * @param id - 记忆 ID
+ * @param actorId - 操作人 ID
+ * @returns 更新后的记忆记录
+ */
+export declare function rejectMemory(id: string, actorId?: string): Promise<AgentMemoryItem>;
+/**
+ * 忘记记忆。
+ * @param id - 记忆 ID
+ * @param actorId - 操作人 ID
+ * @returns 更新后的记忆记录
+ */
+export declare function forgetMemory(id: string, actorId?: string): Promise<AgentMemoryItem>;
+/**
+ * 物理删除记忆及其使用记录。
+ * @param id - 记忆 ID
+ * @param actorId - 操作人 ID
+ * @returns 被删除的记忆 ID
+ */
+export declare function deleteMemoryPermanently(id: string, actorId?: string): Promise<DeleteMemoryResult>;
+/**
+ * 查询记忆事件。
+ * @param id - 记忆 ID
+ * @returns 事件列表
+ */
+export declare function listMemoryEvents(id: string): Promise<AgentMemoryEvent[]>;
+/**
+ * 查询记忆 Markdown 投影。
+ * @param id - 记忆 ID
+ * @returns Markdown 文本
+ */
+export declare function getMemoryMarkdown(id: string): Promise<string>;
+/**
+ * 用 Markdown 投影更新记忆。
+ * @param id - 记忆 ID
+ * @param markdown - Markdown 投影文本
+ * @param actorId - 操作人 ID
+ * @returns 更新后的记忆记录和服务端重新渲染的 Markdown
+ */
+export declare function updateMemoryMarkdown(id: string, markdown: string, actorId?: string): Promise<{
+    item: AgentMemoryItem;
+    markdown: string;
+}>;
+/**
+ * 查询会话压缩上下文快照。
+ * @param conversationId - 会话 ID
+ * @returns 当前快照；不存在时返回 null
+ */
+export declare function getConversationContextSnapshot(conversationId: string): Promise<AgentConversationContextSnapshot | null>;
+/**
+ * 重新生成会话压缩上下文快照后读取最新快照。
+ * @param conversationId - 会话 ID
+ * @returns 最新快照；对话不足以压缩时可能为 null
+ */
+export declare function refreshConversationContextSnapshot(conversationId: string): Promise<AgentConversationContextSnapshot | null>;
+/**
+ * 复盘历史会话并抽取候选长期记忆。
+ * @param payload - 复盘范围、作用域和操作者
+ * @returns 复盘统计
+ */
+export declare function reviewConversationMemories(payload: ReviewConversationMemoriesPayload): Promise<ReviewConversationMemoriesResult>;

package/dist/internal/personal-workbench/lib/aiChartProtocol.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview AI 图表协议构建 - 将右侧聊天图表卡转换为左侧工作台 ECharts protocolRender 数据。
+ * @author seadon
+ * @created 2026-05-20
+ */
+import type { ChartCardSpec } from '@fses/workbench-app/types';
+import type { ChartFamily, ProtocolConfigPayload, ProtocolDataPayload, ProtocolType } from '@fses/workbench-app/types';
+interface AiChartProtocolMapping {
+    protocolType: ProtocolType;
+    family: ChartFamily;
+    seriesType: string;
+}
+/**
+ * 获取图表类型对应的协议映射。
+ * @param card - AI 图表卡。
+ * @returns 协议映射；未知类型回退为柱状图。
+ */
+export declare function aiChartProtocolMapping(card: ChartCardSpec): AiChartProtocolMapping;
+/**
+ * 构建 AI 图表的 ECharts 协议配置。
+ * @param card - AI 图表卡。
+ * @returns ECharts protocol config。
+ */
+export declare function buildAiChartProtocolConfig(card: ChartCardSpec): ProtocolConfigPayload;
+/**
+ * 构建 AI 图表的 ECharts 协议数据。
+ * @param card - AI 图表卡。
+ * @returns ECharts protocol data。
+ */
+export declare function buildAiChartProtocolData(card: ChartCardSpec): ProtocolDataPayload;
+export {};

package/dist/internal/personal-workbench/lib/aiMetricCardSpec.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview AI 指标卡规格 - 在 web-workbench 内恢复运行态指标查询结果并生成可插入卡片。
+ * @author seadon
+ * @created 2026-05-29
+ */
+import type { ConversationTurn } from '@fses/workbench-app/types';
+export type MetricWorkbenchCardFormat = 'currency' | 'number' | 'percent';
+export interface MetricWorkbenchCardSpec {
+    type: 'metric-card';
+    id: string;
+    title: string;
+    metricName: string;
+    metricCode?: string;
+    metricId?: string;
+    value: number;
+    displayValue?: string;
+    unit?: string;
+    displaySpec?: MetricWorkbenchCardDisplaySpec;
+    format: MetricWorkbenchCardFormat;
+    source: {
+        label: string;
+        value?: string;
+    };
+    dataBinding?: {
+        question?: string;
+        bindingId?: string;
+        contractHash?: string;
+        executeApi?: string;
+        metricCode?: string;
+        metricId?: string;
+        readbackApi?: string;
+        refreshApi?: string;
+        displaySpec?: MetricWorkbenchCardDisplaySpec;
+        displayValue?: string;
+        unitCode?: string;
+        unitLabel?: string;
+        valueFormat?: string;
+        decimalPlaces?: number;
+        queryFilters?: unknown[];
+        paramsSchema?: Record<string, unknown>;
+        permissionContext?: {
+            tenantId?: string;
+            appId?: string;
+            [key: string]: unknown;
+        };
+    };
+    permission: {
+        label: string;
+        level?: 'self' | 'team' | 'org';
+    };
+    meta?: {
+        generatedBy?: 'agent';
+        prompt?: string;
+        version?: number;
+    };
+}
+export interface MetricWorkbenchCardDisplaySpec {
+    unitCode?: string;
+    unitLabel?: string;
+    valueFormat?: string;
+    decimalPlaces?: number;
+    displayValue?: string;
+}
+/**
+ * 判断文本是否是“把刚才指标插入工作台”的追问。
+ * @param text - 用户输入。
+ * @returns 命中插卡意图返回 true。
+ */
+export declare function isMetricWorkbenchInsertPrompt(text: string): boolean;
+/**
+ * 从 execute_metric_api 输出生成工作台指标卡。
+ * @param output - 工具输出。
+ * @param prompt - 指标查询原问题。
+ * @returns 可插入指标卡；无法识别返回 null。
+ */
+export declare function deriveMetricWorkbenchCardFromToolOutput(output: unknown, prompt?: string): MetricWorkbenchCardSpec | null;
+/**
+ * 从单个 turn 中读取最近一次成功指标查询卡片。
+ * @param turn - 工作台 turn。
+ * @returns 指标卡或 null。
+ */
+export declare function latestMetricWorkbenchCardFromTurn(turn: ConversationTurn): MetricWorkbenchCardSpec | null;
+/**
+ * 为“插入左侧”追问查找最近可插入的指标卡。
+ * @param turns - 当前对话 turn 列表。
+ * @param currentTurn - 正在完成的插卡追问 turn。
+ * @returns 指标卡或 null。
+ */
+export declare function resolveMetricInsertFallbackCard(turns: ConversationTurn[], currentTurn: ConversationTurn): MetricWorkbenchCardSpec | null;

package/dist/internal/personal-workbench/lib/artifactRules.d.ts

@@ -0,0 +1,15 @@
+import type { ArtifactIndexItem, ArtifactStatus, ArtifactType } from '@fses/workbench-app/types';
+export declare const ARTIFACT_TYPES: readonly ArtifactType[];
+export declare const ARTIFACT_STATUSES: readonly ArtifactStatus[];
+export declare function chineseOrdinalLabel(value: number): string;
+export declare function normalizeArtifactTypeValue(value: string): ArtifactType | '';
+export declare function normalizeArtifactStatusValue(value: string, fallback?: ArtifactStatus): ArtifactStatus;
+export declare function statusFromConfirmationValue(status: string | undefined): ArtifactStatus;
+export declare function cardArtifactAliases(title: string, ordinal: number, isLatest: boolean): string[];
+export declare function canvasBlockArtifactAliases(title: string, ordinal: number, selected: boolean): string[];
+export declare function createArtifactIndexItem(item: Omit<ArtifactIndexItem, 'aliases' | 'createdAt' | 'updatedAt' | 'lightweightPayload'> & {
+    aliases?: string[];
+    createdAt?: string;
+    updatedAt?: string;
+    lightweightPayload?: Record<string, unknown>;
+}, now?: () => string): ArtifactIndexItem;

package/dist/internal/personal-workbench/lib/assistantPersona.d.ts

@@ -0,0 +1,28 @@
+import type { AssistantPersonaKey } from '@fses/workbench-app/types';
+import { DEFAULT_ASSISTANT_PERSONA, getAssistantPersonaProfile, normalizeAssistantPersonaKey } from './assistantPersonaProfiles';
+export interface AssistantPersonaOption {
+    id: AssistantPersonaKey;
+    label: string;
+    shortDescription: string;
+    accentClass: string;
+    comic: {
+        background: string;
+        face: string;
+        accent: string;
+        prop: 'spark' | 'document' | 'line';
+    };
+    prompt: string;
+}
+type AssistantPersonaPromptOverrides = Partial<Record<AssistantPersonaKey, string>>;
+export declare const ASSISTANT_PERSONA_OPTIONS: AssistantPersonaOption[];
+export declare function readAssistantPersonaPromptOverrides(): AssistantPersonaPromptOverrides;
+export declare function writeAssistantPersonaPromptOverride(personaKey: AssistantPersonaKey, prompt: string): void;
+export declare function getAssistantPersonaOptions(): AssistantPersonaOption[];
+export declare function getAssistantPersonaOption(value: unknown): AssistantPersonaOption;
+export declare function buildAssistantPersonaPayload(value: unknown): {
+    prompt: string;
+    key: AssistantPersonaKey;
+    label: string;
+    shortDescription: string;
+};
+export { DEFAULT_ASSISTANT_PERSONA, getAssistantPersonaProfile, normalizeAssistantPersonaKey, };