@freecallai/pro 0.0.2 → 0.0.4

package/dist/types/rich-text/public/types.d.ts

@@ -6,7 +6,7 @@ export interface AddKnowledgeSceneRequest {
     position: 'start';
 }
 export type CapabilitySlot = 'questionAction' | 'knowledgeInline' | 'knowledgeBlock' | 'sceneAction' | 'toolbarOnly';
-export type CapabilityId = 'todo' | 'ticket' | 'originalReply' | 'memory' | 'tagged' | 'variable' | 'image' | 'video' | 'separator' | 'attribute' | 'tool' | 'agentSelect' | 'reasoningPolish' | 'reasoningTemplate';
+export type CapabilityId = 'todo' | 'ticket' | 'tableKnowledge' | 'originalReply' | 'memory' | 'tagged' | 'variable' | 'image' | 'video' | 'separator' | 'attribute' | 'tool' | 'agentSelect' | 'reasoningPolish' | 'reasoningTemplate';
 export interface KnowledgeSceneV1 {
     /** 场景数据版本，固定为 1。
      * @en Scene schema version, currently 1.
@@ -32,10 +32,18 @@ export interface KnowledgeSceneV1 {
     knowledge: {
         doc: JSONContent | null;
         retainedDoc?: JSONContent | null;
+        /** 旧 Agent 只有名称时 id 为空；invalid 引用仅展示，不用于调用。
+         * @en Name-only legacy references have an empty ID; invalid references cannot be invoked.
+         */
         agentRef?: {
             id: string;
             name: string;
+            invalid?: boolean;
         } | null;
+        /** 旧 Agent 记录附带的只读正文快照，与宿主实时提示词独立保存。
+         * @en Read-only legacy Agent body snapshot, separate from the host's live prompt.
+         */
+        agentBody?: JSONContent | null;
     };
     /** 按能力 ID 保存的版本化插件状态，不与问法文本混写。
      * @en Versioned plugin state keyed by capability ID, separate from question text.
@@ -271,9 +279,9 @@ export interface ChangeMeta {
     /** 变更来源。
      * @en Origin of the change.
      */
-    origin: 'user' | 'plugin' | 'typeSwitch' | 'undo';
-    /** 插件变更时的能力 ID。
-     * @en Capability ID for a plugin-origin change.
+    origin: 'user' | 'plugin' | 'api' | 'typeSwitch' | 'undo';
+    /** 插件或 API 插入能力内容时的能力 ID。
+     * @en Capability ID for plugin changes or API capability insertion.
      */
     capabilityId?: CapabilityId;
 }
@@ -449,11 +457,27 @@ export interface AgentPrompt extends AgentSummary {
      * @en Read-only preview of the Agent prompt.
      */
     prompt: string;
+    /** 宿主解析后的只读提示词片段；不写入知识正文。 */
+    preview?: AgentPromptPreviewPart[];
     /** 可选的 Agent 提示词版本。
      * @en Optional Agent prompt revision.
      */
     revision?: string;
 }
+export type AgentPromptPreviewPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'break';
+} | {
+    type: 'tag';
+    kind: string;
+    label: string;
+} | {
+    type: 'media';
+    kind: 'image' | 'video';
+    url: string;
+};
 export interface MediaAsset {
     /** 持久化资源 ID。
      * @en Persisted asset ID.
@@ -502,8 +526,8 @@ export interface RichTextHostPorts {
     getAgentPrompt?: (input: {
         agentId: string;
     }, ctx: PortRequestContext) => Promise<PortResult<AgentPrompt>>;
-    /** 查询待办、工单、打标、属性、工具和推理模板等能力选项；工单使用 capabilityId: 'ticket'。
-     * @en Query options for todo, tickets, tagging, attributes, tools, and reasoning templates; tickets use capabilityId: 'ticket'.
+    /** 查询待办、工单、表格知识、打标、属性、工具和推理模板等能力选项；表格知识使用 tableKnowledge，工单使用 capabilityId: 'ticket'。
+     * @en Query options for todo, tickets, tableKnowledge, tagging, attributes, tools, and reasoning templates; tickets use capabilityId: 'ticket'.
      */
     listCapabilityOptions?: (input: {
         capabilityId: string;
@@ -593,6 +617,39 @@ export interface FkpRichTextHandle {
      * @en Undo the most recent uninterrupted knowledge type switch.
      */
     undoTypeSwitch(): boolean;
+    /** 在最近的有效光标处插入纯文本、媒体资源或已注册的知识区插件内容；没有光标时追加到知识区末尾；失败时不修改场景。
+     * @en Insert plain text, a media asset, or a registered knowledge plugin action at the last valid caret, or append to the knowledge area when no caret exists; failures leave the scene unchanged.
+     */
+    insertContent(input: RichTextInsertInput): Promise<RichTextInsertResult>;
+}
+/** 插件选项由宿主提供，运行时仍按当前知识类型、权限和插件规则校验。
+ * @en Host-supplied plugin option, checked against the current type, policy, and plugin rules.
+ */
+export interface RichTextInsertOption {
+    id: string;
+    label: string;
+    token?: string;
+    params?: Record<string, unknown>;
 }
+export type RichTextInsertInput = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'media';
+    asset: MediaAsset;
+    name?: string;
+} | {
+    type: 'capability';
+    capabilityId: CapabilityId;
+    option?: RichTextInsertOption;
+};
+export type RichTextInsertResult = {
+    ok: true;
+    revision: number;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
 export declare const emptyDoc: () => JSONContent;
 export declare const emptyScene: (type?: KnowledgeType) => KnowledgeSceneV1;

package/dist/types/rich-text/runtime/action-ports.d.ts

@@ -5,7 +5,12 @@ export type HostActionId = HostAction['id'];
 type HostActionPort<A extends HostActionId> = Extract<HostAction, {
     id: A;
 }>['requiredPorts'][number];
-export type ActionPorts<A extends HostActionId> = Readonly<Required<Pick<RichTextHostPorts, HostActionPort<A>>>>;
+type OptionalActionPort<A extends HostActionId> = Extract<HostAction, {
+    id: A;
+}> extends {
+    optionalPorts: readonly (infer P)[];
+} ? Extract<P, keyof RichTextHostPorts> : never;
+export type ActionPorts<A extends HostActionId> = Readonly<Required<Pick<RichTextHostPorts, HostActionPort<A>>> & Partial<Pick<RichTextHostPorts, OptionalActionPort<A>>>>;
 /** Only callbacks named by this action enter its execution context. */
 export declare function projectDeclaredPorts(descriptor: CapabilityDescriptor, actionId: string, ports: RichTextHostPorts | undefined): Readonly<Partial<RichTextHostPorts>> | null;
 /** Read-only view data is projected without creating an editor action. */

package/dist/types/rich-text/runtime/knowledge-clipboard.d.ts

@@ -0,0 +1,16 @@
+import { Slice, Schema } from '@tiptap/pm/model';
+import { CapabilityId, CapabilitySlot } from '../public/types';
+export type PasteCapability = Pick<{
+    id: CapabilityId;
+    slot: CapabilitySlot;
+}, 'id' | 'slot'>;
+/** The copied fragment has node markers, with no editor-specific outer wrapper. */
+export declare function writeKnowledgeClipboard(data: DataTransfer, slice: Slice, schema: Schema): boolean;
+export interface KnowledgeHtmlReadResult {
+    slice: Slice | null;
+    /** True when HTML was parsed, including content intentionally filtered out. */
+    handled: boolean;
+}
+/** Parse only structural text and currently insertable rich-text nodes. */
+export declare function readKnowledgeHtmlResult(html: string, schema: Schema, capabilities: readonly PasteCapability[], files?: readonly File[]): KnowledgeHtmlReadResult;
+export declare function readKnowledgeHtml(html: string, schema: Schema, capabilities: readonly PasteCapability[], files?: readonly File[]): Slice | null;

package/dist/types/rich-text/runtime/media-target.d.ts

@@ -5,5 +5,7 @@ export interface MediaTarget {
     dispose(): void;
 }
 export declare function captureMediaTarget(editor: Editor): MediaTarget;
+/** Insert after already pasted content without replacing a selected media node. */
+export declare function captureMediaTargetAtBoundary(editor: Editor, initialPosition: number): MediaTarget | null;
 export declare function captureMediaTargetAt(editor: Editor, clientX: number, clientY: number): MediaTarget | null;
 export declare function captureMediaTargetAtPosition(editor: Editor, position: number): MediaTarget | null;

package/dist/types/rich-text/runtime/media-upload-session.d.ts

@@ -44,7 +44,7 @@ export interface MediaUploadSessionHost {
     track(controller: AbortController, start: boolean): void;
     diagnostic(code: string, message: string, source: 'config' | 'plugin' | 'port' | 'validation', kind?: MediaKind): void;
     portDiagnostic(error: PortError, kind: MediaKind): void;
-    notify?(type: 'info' | 'success' | 'error', message: string): void;
+    notify?(type: 'info' | 'success' | 'warning' | 'error', message: string): void;
     applyNodeUpdate(plan: UpdatePlan, kind: MediaKind): boolean;
 }
 /** Owns upload files, selection bookmark, and async completion across scene changes. */

package/dist/types/rich-text/runtime/schema-plan.d.ts

@@ -4,6 +4,7 @@ type CapabilityAccess = {
     id: CapabilityId;
     slot: CapabilitySlot;
     canInsert: boolean;
+    canInsertProvided?: boolean;
 };
 export interface KnowledgeSchemaPlan {
     businessToken: boolean;

package/dist/types/rich-text/types.d.ts

@@ -1,40 +1,3 @@
-import { JSONContent } from '@tiptap/core';
-export type KnowledgeMode = 'normal' | 'reasoning';
-export interface KnowledgeSettings {
-    mode: KnowledgeMode;
-    memory: boolean;
-    tagged: boolean;
-    todo: boolean;
-    original: boolean;
-}
-export interface VariableOption {
-    key: string;
-    label: string;
-    group?: string;
-}
-export interface MediaUploadResult {
-    url: string;
-    id?: string;
-    poster?: string;
-}
-export type MediaUploader = (file: File, context: {
-    signal: AbortSignal;
-}) => Promise<MediaUploadResult>;
-export interface EditorChange {
-    json: JSONContent;
-    html: string;
-    text: string;
-}
-export interface FkpRichTextProps {
-    modelValue?: JSONContent;
-    question?: string;
-    settings?: KnowledgeSettings;
-    variables?: VariableOption[];
-    readonly?: boolean;
-    disabled?: boolean;
-    placeholder?: string;
-    maxHeight?: number;
-    maxFileSize?: number;
-    upload?: MediaUploader;
-}
-export declare const defaultSettings: () => KnowledgeSettings;
+import { KnowledgeType } from './public/types';
+/** @deprecated Use KnowledgeType for the current three-type scene model. */
+export type KnowledgeMode = Extract<KnowledgeType, 'normal' | 'reasoning'>;

package/dist/types/rich-text/ui/FkpKnowledgeTypePicker.vue.d.ts

@@ -0,0 +1,38 @@
+import { AddKnowledgeSceneRequest, KnowledgeType } from '../public/types';
+import { FkpKnowledgeTypePickerProps } from './knowledge-type-picker-types';
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): any;
+    };
+    refs: {
+        root: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<FkpKnowledgeTypePickerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    create: (request: AddKnowledgeSceneRequest) => any;
+    select: (type: KnowledgeType) => any;
+    "update:open": (open: boolean, source: "click" | "hover" | "select" | "leave" | "outside" | "escape") => any;
+}, string, import('vue').PublicProps, Readonly<FkpKnowledgeTypePickerProps> & Readonly<{
+    onCreate?: ((request: AddKnowledgeSceneRequest) => any) | undefined;
+    onSelect?: ((type: KnowledgeType) => any) | undefined;
+    "onUpdate:open"?: ((open: boolean, source: "click" | "hover" | "select" | "leave" | "outside" | "escape") => any) | undefined;
+}>, {
+    open: boolean | null;
+    disabled: boolean;
+    currentType: KnowledgeType;
+    mode: "add" | "switch";
+    trigger: "button" | "toolbar";
+    buttonLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    root: HTMLDivElement;
+}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/rich-text/ui/KnowledgeArea.vue.d.ts

@@ -1,5 +1,6 @@
 import { JSONContent } from '@tiptap/core';
 import { KnowledgeSchemaPlan } from '../runtime/schema-plan';
+import { PasteCapability } from '../runtime/knowledge-clipboard';
 import { ChoiceTokenKind } from '../model/node-contract';
 import { MediaNodeState } from '../runtime/media-state';
 import { NodeMutationPlan, PluginPlan } from '../runtime/operations';
@@ -10,6 +11,7 @@ type __VLS_Props = {
     placeholder?: string;
     referencePlaceholder?: boolean;
     schemaPlan: KnowledgeSchemaPlan;
+    pasteCapabilities?: readonly PasteCapability[];
     activeChoiceId?: string | null;
 };
 declare function insertToken(kind: string, key: string, label: string, token?: string): void;
@@ -22,7 +24,7 @@ declare function insertMedia(asset: {
     url: string;
     kind: 'image' | 'video';
     posterUrl?: string;
-}, name: string, target?: MediaTarget): boolean;
+}, name: string, target: MediaTarget, refocus: boolean): JSONContent | null;
 declare function insertPendingMedia(file: File, kind: 'image' | 'video', target: MediaTarget): string | null;
 declare function insertPendingMediaBatch(files: Array<{
     file: File;
@@ -54,9 +56,9 @@ declare function captureSelection(): {
     focused: boolean;
 } | null;
 declare function restoreSelection(selection: ReturnType<typeof captureSelection>): void;
-declare function pasteFileText(event: ClipboardEvent): void;
+declare function pasteClipboardContent(event: ClipboardEvent): MediaTarget | null;
 declare const _default: import('vue').DefineComponent<__VLS_Props, {
-    pasteFileText: typeof pasteFileText;
+    pasteClipboardContent: typeof pasteClipboardContent;
     isSelectionInsideOriginalReply: () => boolean;
     insertToken: typeof insertToken;
     insertOriginal: typeof insertOriginal;
@@ -77,6 +79,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
     captureSelection: typeof captureSelection;
     restoreSelection: typeof restoreSelection;
     captureMediaTarget: () => MediaTarget | null;
+    whenReady: () => Promise<boolean>;
+    captureEndTarget: () => MediaTarget | null;
     captureMediaTargetAt: (clientX: number, clientY: number) => MediaTarget | null;
     focus: () => boolean | undefined;
     getJSON: () => import('@tiptap/core').DocumentType<Record<string, any> | undefined, import('@tiptap/core').NodeType<string, Record<string, any> | undefined, any, (import('@tiptap/core').NodeType<any, any, any, any> | import('@tiptap/core').TextType<import('@tiptap/core').MarkType<any, any>>)[]>[]> | undefined;

package/dist/types/rich-text/ui/knowledge-type-picker-types.d.ts

@@ -0,0 +1,14 @@
+import { KnowledgeType } from '../public/types';
+export interface FkpKnowledgeTypePickerProps {
+    /** 当前工具栏显示的知识类型。 */
+    currentType?: KnowledgeType;
+    /** add 发出 create 回调；switch 仅发出 select 供宿主确认切换。 */
+    mode?: 'add' | 'switch';
+    /** button 用于业务页面独立的“添加知识”入口；toolbar 用于富文本工具栏。 */
+    trigger?: 'button' | 'toolbar';
+    buttonLabel?: string;
+    disabled?: boolean;
+    /** 可选受控展开状态；不传时组件自行管理。 */
+    open?: boolean | null;
+    ariaKeyshortcuts?: string;
+}

package/dist/types/rich-text/ui/token-renderer.d.ts

@@ -0,0 +1,5 @@
+import { DOMOutputSpec } from '@tiptap/pm/model';
+import { TokenAttrs } from '../plugins/token-definition';
+/** Structural templates shared across plugins; no capability IDs are enumerated. */
+export declare function renderBusinessToken(attrs: TokenAttrs): DOMOutputSpec;
+export declare function serializeBusinessToken(attrs: TokenAttrs): string;

package/dist/types/switcher/FkpSwitcher.vue.d.ts

@@ -0,0 +1,52 @@
+import { SwitcherOption, SwitcherValue } from './types';
+type __VLS_Props = {
+    modelValue?: SwitcherValue;
+    options?: SwitcherOption[];
+    disabled?: boolean;
+    loading?: boolean;
+    placeholder?: string;
+    ariaLabel?: string;
+    iconUrl?: string;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'option-icon'?(_: {
+            option: any;
+        }): any;
+        icon?(_: {
+            option: SwitcherOption | undefined;
+        }): any;
+    };
+    refs: {
+        root: HTMLSpanElement;
+    };
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: SwitcherValue, option: SwitcherOption) => any;
+    "update:modelValue": (value: SwitcherValue) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((value: SwitcherValue, option: SwitcherOption) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: SwitcherValue) => any) | undefined;
+}>, {
+    options: SwitcherOption[];
+    disabled: boolean;
+    placeholder: string;
+    loading: boolean;
+    searchPlaceholder: string;
+    ariaLabel: string;
+    searchable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    root: HTMLSpanElement;
+}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/switcher/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FkpSwitcher } from './FkpSwitcher.vue';
+export type { SwitcherOption, SwitcherValue } from './types';

package/dist/types/switcher/types.d.ts

@@ -0,0 +1,7 @@
+export type SwitcherValue = string | number | boolean;
+export interface SwitcherOption {
+    value: SwitcherValue;
+    label: string;
+    disabled?: boolean;
+    iconUrl?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freecallai/pro",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "福客AI业务组件库",
   "license": "MIT",
   "repository": {
@@ -21,11 +21,31 @@
       "types": "./dist/types/rich-text/index.d.ts",
       "import": "./dist/rich-text/index.js"
     },
+    "./knowledge-type-picker": {
+      "types": "./dist/types/knowledge-type-picker/index.d.ts",
+      "import": "./dist/knowledge-type-picker/index.js"
+    },
     "./rich-text/legacy-converter": {
       "types": "./dist/types/rich-text/legacy-converter/index.d.ts",
       "import": "./dist/rich-text/legacy-converter/index.js"
     },
-    "./style.css": "./dist/style.css"
+    "./style.css": "./dist/style.css",
+    "./switcher": {
+      "types": "./dist/types/switcher/index.d.ts",
+      "import": "./dist/switcher/index.js"
+    },
+    "./edition-info": {
+      "types": "./dist/types/edition-info/index.d.ts",
+      "import": "./dist/edition-info/index.js"
+    },
+    "./filters": {
+      "types": "./dist/types/filters/index.d.ts",
+      "import": "./dist/filters/index.js"
+    },
+    "./navigation": {
+      "types": "./dist/types/navigation/index.d.ts",
+      "import": "./dist/navigation/index.js"
+    }
   },
   "files": [
     "dist",
@@ -35,7 +55,7 @@
     "**/*.css"
   ],
   "peerDependencies": {
-    "@freecallai/ui": "^0.0.1",
+    "@freecallai/ui": "^0.0.3",
     "vue": "^3.5.13"
   },
   "dependencies": {
@@ -44,7 +64,7 @@
     "@tiptap/pm": "^3.0.0",
     "@tiptap/starter-kit": "^3.0.0",
     "@tiptap/vue-3": "^3.0.0",
-    "@freecallai/icons": "0.0.1"
+    "@freecallai/icons": "0.0.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
@@ -57,15 +77,15 @@
     "vue": "^3.5.13",
     "vue-tsc": "^2.2.0",
     "@arco-design/arco-vue-scripts": "0.2.10",
-    "@freecallai/ui": "0.0.1"
+    "@freecallai/ui": "0.0.3"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "scripts": {
-    "build": "node scripts/check-rich-text-boundaries.mjs && vue-tsc --noEmit && vite build",
-    "check:boundaries": "node scripts/check-rich-text-boundaries.mjs",
+    "build": "pnpm check:boundaries && vue-tsc --noEmit && vite build",
+    "check:boundaries": "node scripts/check-workspace-boundaries.mjs && node scripts/check-rich-text-boundaries.mjs",
     "docgen": "arco-vue-scripts docgen",
     "typecheck": "vue-tsc --noEmit",
     "test": "vitest run"