@freecallai/pro 0.0.0-stage → 0.0.2

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

@@ -0,0 +1,58 @@
+import { CapabilityId, CapabilitySlot, KnowledgeType, RichTextHostPorts } from '../public/types';
+export declare const optionSourcePort: {
+    readonly agents: "searchAgents";
+    readonly variables: "listVariables";
+    readonly flatTags: "listCapabilityOptions";
+    readonly capabilities: "listCapabilityOptions";
+};
+export declare const hostActions: {
+    readonly agentOpenConfig: {
+        readonly id: "agentSelect.openConfig";
+        readonly requiredPorts: readonly ["openAgentConfig"];
+    };
+    readonly imageUpload: {
+        readonly id: "image.upload";
+        readonly requiredPorts: readonly ["uploadMedia"];
+    };
+    readonly videoUpload: {
+        readonly id: "video.upload";
+        readonly requiredPorts: readonly ["uploadMedia"];
+    };
+    readonly reasoningPolishPropose: {
+        readonly id: "reasoningPolish.propose";
+        readonly requiredPorts: readonly ["proposeReasoning"];
+    };
+    readonly reasoningTemplateLoad: {
+        readonly id: "reasoningTemplate.load";
+        readonly requiredPorts: readonly ["getReasoningTemplate"];
+    };
+};
+export interface CapabilityDescriptor {
+    id: CapabilityId;
+    apiVersion: 1;
+    dataVersion: number;
+    implementation: 'plugin' | 'host';
+    label: string;
+    slot: CapabilitySlot;
+    order: number;
+    types: readonly KnowledgeType[];
+    icon: string;
+    actions?: readonly {
+        id: string;
+        requiredPorts: readonly (keyof RichTextHostPorts)[];
+    }[];
+    /** Read-only view data dependencies; they do not execute editor operations. */
+    readPorts?: readonly (keyof RichTextHostPorts)[];
+    primaryActionId?: string;
+    optionKind?: 'media' | 'selection';
+    optionSource?: keyof typeof optionSourcePort;
+    /** Selection menu opens on pointer hover instead of click. */
+    optionTrigger?: 'click' | 'hover';
+    /** Selection options can contain category entries that load child pages. */
+    optionHierarchy?: 'flat' | 'tree';
+    /** Ports used by host-owned selection UI before the plugin action runs. */
+    uiPorts?: readonly (keyof RichTextHostPorts)[];
+    questionTag?: {
+        kind: 'todo' | 'default';
+    };
+}

package/dist/types/rich-text/config/media-options.d.ts

@@ -0,0 +1,6 @@
+export interface MediaOptions {
+    maxBytes?: number;
+    mimeTypes?: string[];
+}
+export declare function parseMediaOptions(value: unknown, kind: 'image' | 'video'): MediaOptions | null;
+export declare function narrowMediaOptions(layers: readonly (MediaOptions | undefined)[], onWiden: () => void): MediaOptions;

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

@@ -0,0 +1,17 @@
+import { CapabilityDescriptor } from './catalog';
+import { MediaOptions } from './media-options';
+import { SelectionOptions } from './selection-options';
+import { EditorDiagnostic, FkpRichTextProps, KnowledgeType } from '../public/types';
+export interface ResolvedCapability extends CapabilityDescriptor {
+    canInsert: boolean;
+    visible: boolean;
+    options?: MediaOptions | SelectionOptions;
+}
+export interface ResolvedSceneConfig {
+    type: KnowledgeType;
+    mode: 'editable' | 'readonly';
+    capabilities: ResolvedCapability[];
+    diagnostics: EditorDiagnostic[];
+    fingerprint: string;
+}
+export declare function resolveSceneConfig(type: KnowledgeType, input: Pick<FkpRichTextProps, 'config' | 'policy' | 'ports' | 'readonly' | 'disabled'>, now?: number): ResolvedSceneConfig;

package/dist/types/rich-text/config/selection-options.d.ts

@@ -0,0 +1,6 @@
+export interface SelectionOptions {
+    pageSize?: number;
+}
+/** Parse options for paged variable, attribute, tool, Agent and template lists. */
+export declare function parseSelectionOptions(value: unknown): SelectionOptions | null;
+export declare function narrowSelectionOptions(layers: readonly (SelectionOptions | undefined)[], onWiden: () => void): Required<SelectionOptions>;

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

@@ -0,0 +1,6 @@
+import { Extension, Node } from '@tiptap/core';
+/** Keep copied extension nodes distinct without changing later original IDs. */
+export declare const UniqueExtensionNodeIds: Extension<any, any>;
+export declare const BusinessToken: Node<any, any>;
+export declare const OriginalReply: Node<any, any>;
+export declare const MessageSeparator: Node<any, any>;

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

@@ -0,0 +1,17 @@
+export { default } from './FkpRichText.vue';
+export { default as FkpRichText } from './FkpRichText.vue';
+export type { FkpRichTextProps, FkpRichTextHandle, KnowledgeSceneV1, KnowledgeConditionV1, MigrationIssueV1, LoadedConditionV1, LegacyReadonlyConditionV1, ConditionLoadV1, SaveConditionInputV1, SavedConditionV1, KnowledgePersistenceAdapterV1, KnowledgeType, AddKnowledgeSceneRequest, CapabilityId, CapabilitySlot, CapabilityRuleV1, SceneConfigInputV1, RichTextHostPorts, PortRequestContext, PortResult, PortErrorCode, Page, CapabilityOption, ToolFormField, ToolFormDefinition, VariableOption, AgentSummary, AgentPrompt, MediaAsset, SceneConfigLayersV1, HostPolicySnapshotV1, EditorDiagnostic, ChangeMeta, } from './public/types';
+export { emptyScene, emptyDoc } from './public/types';
+export { resolveSceneConfig } from './config/resolve';
+export { validateKnowledgeScenes } from './model/validate';
+export { parseKnowledgeConditionV1 } from './model/condition-contract';
+export type { ConditionParseResult } from './model/condition-contract';
+export { parseConditionLoadResult, parseLoadedConditionResult, parseSaveConditionInput, parseSavedConditionResult, verifySavedConditionEcho, } from './model/persistence-contract';
+export type { SavedConditionEchoResult } from './model/persistence-contract';
+export { assignLegacyExtensionIds, assignLegacyMediaIds, } from './model/media-migration';
+export { buildReasoningReferenceContext } from './model/reasoning-context';
+export type { ReasoningReferenceContext } from './model/reasoning-context';
+export { buildAgentInvocationContext } from './model/agent-context';
+export type { AgentInvocationContext } from './model/agent-context';
+export { serializeQuestionForModel, serializeQuestionTagsForModel, } from './model/question-text';
+export type { SceneValidationResult, SceneValidationIssue, } from './model/validate';

package/dist/types/rich-text/legacy-converter/business-attribute.d.ts

@@ -0,0 +1,32 @@
+/** csr-webui's bizAttributeCatalog response; IDs, keys and names are stable protocol data. */
+declare const catalog: readonly [{
+    readonly id: 1;
+    readonly key: "focus_goods_name";
+    readonly name: "焦点商品名称";
+}, {
+    readonly id: 2;
+    readonly key: "focus_goods_info";
+    readonly name: "焦点商品信息";
+}, {
+    readonly id: 3;
+    readonly key: "focus_goods_sku";
+    readonly name: "焦点商品sku信息";
+}, {
+    readonly id: 4;
+    readonly key: "focus_order_amount";
+    readonly name: "焦点订单实付金额";
+}, {
+    readonly id: 5;
+    readonly key: "focus_order_status";
+    readonly name: "焦点订单状态";
+}, {
+    readonly id: 6;
+    readonly key: "shop_name";
+    readonly name: "店铺名称";
+}];
+export type LegacyBusinessAttribute = (typeof catalog)[number];
+export declare const LEGACY_BUSINESS_ATTRIBUTES: readonly LegacyBusinessAttribute[];
+export declare function legacyBusinessAttributeByName(name: string): LegacyBusinessAttribute | undefined;
+export declare function legacyBusinessAttributeByKey(key: string): LegacyBusinessAttribute | undefined;
+export declare function legacyBusinessAttributeToken(name: string): string;
+export {};

package/dist/types/rich-text/legacy-converter/index.d.ts

@@ -0,0 +1,46 @@
+import { KnowledgeSceneV1 } from '../public/types';
+export { LEGACY_BUSINESS_ATTRIBUTES } from './business-attribute';
+/** The old knowledge item. Unrelated backend fields are copied through on export. */
+export interface LegacyKnowledgeItem {
+    web_content?: string;
+    content?: string;
+    [key: string]: unknown;
+}
+export interface LegacyReferenceResolver {
+    selection?: (kind: 'todo' | 'tagged', label: string) => {
+        id: string;
+        label: string;
+    } | null;
+    variable?: (name: string) => {
+        key: string;
+        label: string;
+    } | null;
+    agent?: (name: string) => {
+        id: string;
+        name: string;
+    } | null;
+}
+export interface LegacyImportOptions {
+    /** The parent condition owns the question when it is absent from web_content. */
+    questionText?: string;
+}
+export interface LegacyExportOptions {
+    /** Real updateCondition content items normally store the question outside web_content. */
+    questionStorage?: 'external' | 'inline';
+}
+export interface ConversionIssue {
+    path: string;
+    message: string;
+}
+export type ConversionResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    issues: ConversionIssue[];
+    raw: unknown;
+};
+/** Convert a legacy HTML item to the editor's structured scene. Never mutates the input. */
+export declare function legacyItemToScene(item: LegacyKnowledgeItem, sourceRecordKey: string, resolver?: LegacyReferenceResolver, options?: LegacyImportOptions): ConversionResult<KnowledgeSceneV1>;
+/** Export a supported structured scene to both legacy fields. Unrelated fields pass through. */
+export declare function sceneToLegacyItem(scene: KnowledgeSceneV1, baseline?: LegacyKnowledgeItem, options?: LegacyExportOptions): ConversionResult<LegacyKnowledgeItem>;

package/dist/types/rich-text/legacy-converter/tool-contract.d.ts

@@ -0,0 +1,5 @@
+import { JSONContent } from '@tiptap/core';
+export declare function parseLegacyToolText(text: string): JSONContent | null;
+export declare function formatLegacyToolText(node: JSONContent): string | null;
+/** Older csr-webui drafts stored encoded JSON before the explicit span protocol. */
+export declare function parseEncodedOrderRemark(value: string): JSONContent | null;

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

@@ -0,0 +1,4 @@
+import { Node } from '@tiptap/core';
+export declare const MediaBlock: Node<{
+    sceneStyle: boolean;
+}, any>;

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

@@ -0,0 +1,2 @@
+/** Media node IDs must also work on HTTP origins where randomUUID is unavailable. */
+export declare function createMediaId(): string;

package/dist/types/rich-text/model/agent-context.d.ts

@@ -0,0 +1,7 @@
+import { KnowledgeSceneV1 } from '../public/types';
+export interface AgentInvocationContext {
+    knowledgeType: 'agent';
+    agentId: string;
+}
+/** Backend-neutral Agent identity for the consumer's algorithm request adapter. */
+export declare function buildAgentInvocationContext(scene: KnowledgeSceneV1): AgentInvocationContext;

package/dist/types/rich-text/model/capability-diff.d.ts

@@ -0,0 +1,14 @@
+import { JSONContent } from '@tiptap/core';
+import { CapabilityId, CapabilitySlot } from '../public/types';
+interface CapabilityAccess {
+    id: CapabilityId;
+    slot: CapabilitySlot;
+    canInsert: boolean;
+}
+type CapabilityUse = {
+    id: CapabilityId;
+    slot: CapabilitySlot;
+};
+/** Existing disabled nodes may survive edits; new instances may not be inserted. */
+export declare function findAddedDisabledCapability(previous: JSONContent | null, next: JSONContent | null, capabilities: readonly CapabilityAccess[]): CapabilityUse | null;
+export {};

package/dist/types/rich-text/model/condition-contract.d.ts

@@ -0,0 +1,10 @@
+import { KnowledgeConditionV1 } from '../public/types';
+export type ConditionParseResult = {
+    ok: true;
+    data: KnowledgeConditionV1;
+} | {
+    ok: false;
+    path: string;
+};
+/** Parse a complete, backend-neutral condition without discarding unknown fields. */
+export declare function parseKnowledgeConditionV1(input: unknown): ConditionParseResult;

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

@@ -0,0 +1,6 @@
+import { KnowledgeSceneV1, KnowledgeType } from '../public/types';
+export interface SceneConversion {
+    scene: KnowledgeSceneV1;
+    removed: string[];
+}
+export declare function convertScene(source: KnowledgeSceneV1, targetType: KnowledgeType): SceneConversion;

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

@@ -0,0 +1,7 @@
+import { JSONContent } from '@tiptap/core';
+import { KnowledgeSceneV1 } from '../public/types';
+export declare const isKnownNodeType: (type: string) => boolean;
+export declare function findUnsupportedContent(doc: JSONContent | null, rootPath?: string): string | null;
+/** The minimum shape required for the scene shell to render safely. */
+export declare function isRenderableSceneShell(value: unknown): value is KnowledgeSceneV1;
+export declare function findUnsupportedScene(value: unknown): string | null;

package/dist/types/rich-text/model/json-value.d.ts

@@ -0,0 +1,2 @@
+/** Find values that JSON serialization would drop or change before editing them. */
+export declare function findNonJsonValue(value: unknown, rootPath?: string): string | null;

package/dist/types/rich-text/model/media-migration.d.ts

@@ -0,0 +1,8 @@
+import { JSONContent } from '@tiptap/core';
+/** Assign stable IDs and missing node versions before saving legacy JSON. */
+export declare function assignLegacyExtensionIds(source: JSONContent, sourceRecordKey: string): {
+    doc: JSONContent;
+    changed: boolean;
+};
+/** Kept for existing media migration callers; now reserves all extension IDs. */
+export declare const assignLegacyMediaIds: typeof assignLegacyExtensionIds;

package/dist/types/rich-text/model/node-contract.d.ts

@@ -0,0 +1,10 @@
+/** Persisted node kinds. A new kind must be added here before it can enter a scene. */
+export declare const BUSINESS_TOKEN_KINDS: readonly ["todo", "ticket", "variable", "attribute", "tool", "separator"];
+export type BusinessTokenKind = (typeof BUSINESS_TOKEN_KINDS)[number];
+export declare const CHOICE_TOKEN_KINDS: readonly ["todo", "ticket", "attribute"];
+export type ChoiceTokenKind = (typeof CHOICE_TOKEN_KINDS)[number];
+export declare const MEDIA_KINDS: readonly ["image", "video"];
+export type MediaKind = (typeof MEDIA_KINDS)[number];
+export declare const isBusinessTokenKind: (value: unknown) => value is BusinessTokenKind;
+export declare const isChoiceTokenKind: (value: unknown) => value is ChoiceTokenKind;
+export declare const isMediaKind: (value: unknown) => value is MediaKind;

package/dist/types/rich-text/model/node-identity.d.ts

@@ -0,0 +1,8 @@
+import { JSONContent } from '@tiptap/core';
+export declare const isIdentifiedNodeType: (type: string) => boolean;
+export declare function ownerOfIdentifiedNode(type: string, attrs?: Record<string, unknown>): string | null;
+export declare function hasNestedIdentifiedNode(node: JSONContent): boolean;
+export declare const trustedNodeIdsMeta = "fkpTrustedNodeIds";
+export declare function collectIdentifiedNodeIds(content: JSONContent | JSONContent[]): string[];
+/** Avoid an unbounded loop if the ID source repeatedly collides. */
+export declare function allocateUniqueNodeId(reserved: ReadonlySet<string>, createId: () => string): string;

package/dist/types/rich-text/model/persistence-contract.d.ts

@@ -0,0 +1,25 @@
+import { ConditionLoadV1, LoadedConditionV1, PortResult, SaveConditionInputV1, SavedConditionV1 } from '../public/types';
+type SaveInputParseResult = {
+    ok: true;
+    data: SaveConditionInputV1;
+} | {
+    ok: false;
+    path: string;
+};
+/** Validate a save request before a consumer adapter maps it to HTTP fields. */
+export declare function parseSaveConditionInput(input: unknown): SaveInputParseResult;
+/** Keep transport errors while rejecting incomplete structured load payloads. */
+export declare function parseLoadedConditionResult(raw: unknown): PortResult<LoadedConditionV1>;
+/** Preserve unconvertible legacy conditions without passing them to the new editor. */
+export declare function parseConditionLoadResult(raw: unknown): PortResult<ConditionLoadV1>;
+/** A successful save must return a complete condition and opaque revision. */
+export declare function parseSavedConditionResult(raw: unknown): PortResult<SavedConditionV1>;
+export type SavedConditionEchoResult = {
+    ok: true;
+} | {
+    ok: false;
+    path: string;
+};
+/** Check that readback preserved every submitted scene and its order. */
+export declare function verifySavedConditionEcho(input: unknown, response: unknown): SavedConditionEchoResult;
+export {};

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

@@ -0,0 +1,2 @@
+/** Readable fallback for unknown JSON. Never inserts raw attributes or HTML. */
+export declare function buildSafePreview(doc: unknown): string;

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

@@ -0,0 +1,15 @@
+import { KnowledgeSceneV1 } from '../public/types';
+type SelectionCapability = 'todo' | 'tagged';
+/** Historical/current brackets and line breaks are reserved intent delimiters. */
+export declare function hasQuestionDelimiter(text: string): boolean;
+/** Plan labels must remain one unambiguous model-protocol token. */
+export declare function hasPlanLabelDelimiter(label: string): boolean;
+export declare function selectedQuestionOption(scene: KnowledgeSceneV1, id: SelectionCapability): {
+    id: string;
+    label: string;
+} | null;
+/** Serialize display-only question selections for the model request boundary. */
+export declare function serializeQuestionTagsForModel(scene: KnowledgeSceneV1): string;
+/** Produces the complete intent line when the host sends a prompt to the model. */
+export declare function serializeQuestionForModel(scene: KnowledgeSceneV1): string;
+export {};

package/dist/types/rich-text/model/reasoning-context.d.ts

@@ -0,0 +1,24 @@
+import { KnowledgeSceneV1 } from '../public/types';
+export interface ReasoningReferenceContext {
+    /** The consumer maps this field to its real algorithm request contract. */
+    knowledgeType: 'reasoning';
+    tickets: Array<{
+        nodeId: string;
+        key: string;
+        label: string;
+    }>;
+    attributes: Array<{
+        nodeId: string;
+        key: string;
+        label: string;
+        value: unknown;
+    }>;
+    tools: Array<{
+        nodeId: string;
+        key: string;
+        label: string;
+        params: Record<string, unknown>;
+    }>;
+}
+/** Build backend-neutral reference data; the host resolves attribute values. */
+export declare function buildReasoningReferenceContext(scene: KnowledgeSceneV1, attributeValues: Record<string, unknown>): ReasoningReferenceContext;

package/dist/types/rich-text/model/scene-snapshot.d.ts

@@ -0,0 +1,4 @@
+import { KnowledgeSceneV1 } from '../public/types';
+/** Compare semantic JSON values independently of object key insertion order. */
+export declare function canonicalJsonSnapshot(value: unknown): string;
+export declare function canonicalSceneSnapshot(scene: KnowledgeSceneV1): string;

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

@@ -0,0 +1,19 @@
+import { JSONContent } from '@tiptap/core';
+import { KnowledgeSceneV1 } from '../public/types';
+export type SceneValidationCode = 'EMPTY_CONTENT' | 'AGENT_REQUIRED' | 'EMPTY_CONTENT_AND_AGENT' | 'DUPLICATE_INTENT' | 'INVALID_INTENT_BRACKET' | 'TOO_LONG' | 'MEDIA_PENDING' | 'UNSUPPORTED_CONTENT' | 'SCHEMA_VERSION';
+export interface SceneValidationIssue {
+    code: SceneValidationCode;
+    sceneIndex: number | null;
+    message: string;
+}
+export interface SceneValidationResult {
+    ok: boolean;
+    characterCount: number;
+    issues: SceneValidationIssue[];
+}
+export declare function hasPendingMedia(scene: KnowledgeSceneV1): boolean;
+export declare function hasKnowledgeContent(doc: JSONContent | null): boolean;
+/** Validate the complete condition before the host submits it to its backend. */
+export declare function validateKnowledgeScenes(scenes: readonly KnowledgeSceneV1[], options?: {
+    maxCharacters?: number;
+}): SceneValidationResult;

package/dist/types/rich-text/model/web-url.d.ts

@@ -0,0 +1,2 @@
+/** Only browser-safe web URLs are accepted in persisted rich-text links and media. */
+export declare function isWebUrl(value: unknown): value is string;

package/dist/types/rich-text/plugins/agentSelect/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const agentSelectDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/attribute/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const attributeDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/attribute/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

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

@@ -0,0 +1,3 @@
+import { SharedCapabilityImplementation } from './operations';
+declare const module: SharedCapabilityImplementation;
+export default module;

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

@@ -0,0 +1,4 @@
+import { SharedCapabilityImplementation } from './operations';
+/** Keep insert and in-place replacement behind the same capability action. */
+declare const choice: SharedCapabilityImplementation;
+export default choice;

package/dist/types/rich-text/plugins/image/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const imageDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/image/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

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

@@ -0,0 +1,3 @@
+import { SharedCapabilityImplementation } from './operations';
+declare const module: SharedCapabilityImplementation;
+export default module;

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

@@ -0,0 +1,3 @@
+import { CapabilityModule } from './operations';
+/** The host owns the file and pending node; the plugin only requests an asset. */
+export declare function createMediaUploadModule(kind: 'image' | 'video'): CapabilityModule;

package/dist/types/rich-text/plugins/memory/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const memoryDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/memory/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

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

@@ -0,0 +1,86 @@
+import { JSONContent } from '@tiptap/core';
+import { CapabilityId, CapabilitySlot, KnowledgeSceneV1, PortRequestContext, PortResult, RichTextHostPorts } from '../public/types';
+export type PluginOperation = {
+    kind: 'setOwnState';
+    capabilityId: CapabilityId;
+    data: Record<string, unknown>;
+} | {
+    kind: 'insertOwnToken';
+    capabilityId: CapabilityId;
+    key: string;
+    label: string;
+    token?: string;
+    params?: Record<string, unknown>;
+} | {
+    kind: 'insertOwnBlock';
+    capabilityId: CapabilityId;
+    block: 'originalReply';
+} | {
+    kind: 'replaceSceneDoc';
+    capabilityId: CapabilityId;
+    doc: JSONContent;
+    question?: string;
+    confirmation: string;
+} | {
+    kind: 'updateOwnNode';
+    capabilityId: CapabilityId;
+    nodeId: string;
+    expectedNodeVersion: number;
+    node: JSONContent;
+} | {
+    kind: 'removeOwnNode';
+    capabilityId: CapabilityId;
+    nodeId: string;
+    expectedNodeVersion: number;
+};
+interface OptionInput {
+    id: string;
+    label: string;
+    token?: string;
+    params?: Record<string, unknown>;
+}
+/** An edit always has a replacement choice; media uploads cannot carry menu data. */
+export type PluginInput = {
+    option: OptionInput;
+    edit?: {
+        nodeId: string;
+        nodeVersion: number;
+    };
+    upload?: never;
+} | {
+    upload: {
+        file: File;
+        nodeId: string;
+        expectedNodeVersion: number;
+    };
+    option?: never;
+    edit?: never;
+} | {
+    option?: never;
+    edit?: never;
+    upload?: never;
+};
+export interface PluginActionContext {
+    scene: Readonly<KnowledgeSceneV1>;
+    sceneKey: string;
+    revision: number;
+    options: unknown;
+    request: PortRequestContext;
+    ports: Readonly<Partial<RichTextHostPorts>>;
+}
+export interface CapabilityAction {
+    execute(input: PluginInput, context: PluginActionContext): Promise<PortResult<readonly PluginOperation[]>>;
+}
+export interface CapabilityModule {
+    id: CapabilityId;
+    slot: CapabilitySlot;
+    apiVersion: 1;
+    dataVersion: number;
+    actions: Readonly<Record<string, CapabilityAction>>;
+}
+/** Shared behavior used by individual, identity-bound plugin modules. */
+export interface SharedCapabilityImplementation {
+    execute(id: CapabilityId, input: PluginInput, scene: Readonly<KnowledgeSceneV1>): readonly PluginOperation[];
+}
+export declare function bindCapability(id: CapabilityId, slot: CapabilitySlot, implementation: SharedCapabilityImplementation): CapabilityModule;
+export {};

package/dist/types/rich-text/plugins/originalReply/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const originalReplyDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/originalReply/knowledge.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

package/dist/types/rich-text/plugins/originalReply/question.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

package/dist/types/rich-text/plugins/reasoningPolish/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const reasoningPolishDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/reasoningPolish/index.d.ts

@@ -0,0 +1,3 @@
+import { CapabilityModule } from '../operations';
+declare const module: CapabilityModule;
+export default module;

package/dist/types/rich-text/plugins/reasoningTemplate/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const reasoningTemplateDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/reasoningTemplate/index.d.ts

@@ -0,0 +1,3 @@
+import { CapabilityModule } from '../operations';
+declare const module: CapabilityModule;
+export default module;

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

@@ -0,0 +1,14 @@
+import { CapabilityDescriptor } from '../config/descriptor';
+import { CapabilityModule } from './operations';
+export type CapabilityLoader = () => Promise<{
+    default: CapabilityModule;
+}>;
+export declare function validateCapabilityModule(descriptor: CapabilityDescriptor, value: unknown): value is CapabilityModule;
+export type CapabilityLoadResult = {
+    ok: true;
+    module: CapabilityModule;
+} | {
+    ok: false;
+    reason: 'NOT_REGISTERED' | 'VERSION_MISMATCH';
+};
+export declare function loadCapability(descriptor: CapabilityDescriptor): Promise<CapabilityLoadResult>;

package/dist/types/rich-text/plugins/selection-state.d.ts

@@ -0,0 +1,4 @@
+import { SharedCapabilityImplementation } from './operations';
+/** An option selection enables the switch; toggling it preserves the selected option. */
+declare const selectionState: SharedCapabilityImplementation;
+export default selectionState;

package/dist/types/rich-text/plugins/separator/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const separatorDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/separator/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

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

@@ -0,0 +1,3 @@
+import { SharedCapabilityImplementation } from './operations';
+declare const module: SharedCapabilityImplementation;
+export default module;

package/dist/types/rich-text/plugins/tagged/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const taggedDescriptors: readonly CapabilityDescriptor[];

package/dist/types/rich-text/plugins/tagged/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('../operations').CapabilityModule;
+export default _default;

package/dist/types/rich-text/plugins/ticket/descriptor.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityDescriptor } from '../../config/descriptor';
+export declare const ticketDescriptors: readonly CapabilityDescriptor[];