@ixo/oracle-runtime 0.0.1

package/dist/plugins/editor/blocknote-tools.d.ts

@@ -0,0 +1,364 @@
+/**
+ * LangChain Tools for BlockNote Y.js Editing
+ */
+import * as z from 'zod';
+import type { MatrixClient } from 'matrix-js-sdk';
+import { type AppConfig } from './provider.js';
+/** Matrix admin credentials the blocknote tools use to read/write Y.Docs. */
+export interface BlocknoteToolsMatrixConfig {
+    baseUrl: string;
+    accessToken: string;
+    userId: string;
+}
+/**
+ * Build the default `BLOCKNOTE_TOOLS_CONFIG` from a runtime config bag. The
+ * editor plugin builds this once at boot from its declared env vars and
+ * threads it through every tool factory, replacing the legacy module-level
+ * `getConfig()` call.
+ */
+export declare function buildBlocknoteToolsConfig(matrix: BlocknoteToolsMatrixConfig): {
+    matrix: {
+        baseUrl: string;
+        accessToken: string;
+        userId: string;
+        initialSyncTimeoutMs: number;
+    };
+    provider: {
+        docName: string;
+        enableAwareness: boolean;
+        retryAttempts: number;
+        retryDelayMs: number;
+    };
+    blocknote: {
+        defaultBlockId: undefined;
+        blockNamespace: undefined;
+        mutableAttributeKeys: string[];
+    };
+};
+/**
+ * The blocknote tools' config, optionally augmented with a host-provided
+ * `MatrixClient`. When `matrixClient` is set, `resolveEditorMatrixClient`
+ * uses it directly; when absent, the editor falls back to constructing
+ * its internal singleton from the matrix credentials.
+ */
+export type BlocknoteToolsConfig = ReturnType<typeof buildBlocknoteToolsConfig> & {
+    matrixClient?: MatrixClient;
+};
+/**
+ * Creates BlockNote tools that use a shared Matrix client
+ *
+ * @param matrixClient - The singleton Matrix client (already synced)
+ * @param config - Configuration for the provider and room
+ * @param readOnly - If true, only returns read-only tools (list_blocks). Write tools are disabled but code is preserved.
+ */
+export declare const createBlocknoteTools: (matrixClient: MatrixClient, config: AppConfig, readOnly?: boolean) => Promise<{
+    listBlocksTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        includeText: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        blockType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        start: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        end: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, {
+        includeText: boolean;
+        start: number;
+        end: number;
+        blockType?: string | null | undefined;
+    }, {
+        includeText?: boolean | undefined;
+        blockType?: string | null | undefined;
+        start?: number | undefined;
+        end?: number | undefined;
+    }, string, unknown, "list_blocks">;
+    readBlockByIdTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        evaluateConditions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        resolveReferences: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, {
+        blockId: string;
+        evaluateConditions: boolean;
+        resolveReferences: boolean;
+    }, {
+        blockId: string;
+        evaluateConditions?: boolean | undefined;
+        resolveReferences?: boolean | undefined;
+    }, string, unknown, "read_block_by_id">;
+    searchBlocksTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        propKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        propValue: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        textContains: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, {
+        blockType?: string | null | undefined;
+        propKey?: string | null | undefined;
+        propValue?: string | null | undefined;
+        textContains?: string | null | undefined;
+    }, {
+        blockType?: string | null | undefined;
+        propKey?: string | null | undefined;
+        propValue?: string | null | undefined;
+        textContains?: string | null | undefined;
+    }, string, unknown, "search_blocks">;
+    readFlowContextTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{}, z.core.$strip>, Record<string, never>, Record<string, never>, string, unknown, "read_flow_context">;
+    readFlowStatusTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        nodeId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, {
+        nodeId?: string | null | undefined;
+    }, {
+        nodeId?: string | null | undefined;
+    }, string, unknown, "read_flow_status">;
+    readBlockHistoryTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+    }, z.core.$strip>, {
+        blockId: string;
+    }, {
+        blockId: string;
+    }, string, unknown, "read_block_history">;
+    readPermissionsTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        audienceDid: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        capability: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, {
+        audienceDid?: string | null | undefined;
+        capability?: string | null | undefined;
+    }, {
+        audienceDid?: string | null | undefined;
+        capability?: string | null | undefined;
+    }, string, unknown, "read_permissions">;
+    readSurveyTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+    }, z.core.$strip>, {
+        blockId: string;
+    }, {
+        blockId: string;
+    }, string, unknown, "read_survey">;
+    validateSurveyAnswersTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+    }, z.core.$strip>, {
+        blockId: string;
+    }, {
+        blockId: string;
+    }, string, unknown, "validate_survey_answers">;
+    editBlockTool?: undefined;
+    createBlockTool?: undefined;
+    deleteBlockTool?: undefined;
+    fillSurveyAnswersTool?: undefined;
+    executeActionTool?: undefined;
+    findAndReplaceTool?: undefined;
+    moveBlockTool?: undefined;
+    bulkEditBlocksTool?: undefined;
+} | {
+    listBlocksTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        includeText: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        blockType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        start: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        end: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, {
+        includeText: boolean;
+        start: number;
+        end: number;
+        blockType?: string | null | undefined;
+    }, {
+        includeText?: boolean | undefined;
+        blockType?: string | null | undefined;
+        start?: number | undefined;
+        end?: number | undefined;
+    }, string, unknown, "list_blocks">;
+    editBlockTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        updates: z.ZodRecord<z.ZodAny, z.ZodAny>;
+        removeAttributes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        runtimeUpdates: z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>;
+    }, z.core.$strip>, {
+        blockId: string;
+        updates: Record<any, any>;
+        removeAttributes: string[];
+        text?: string | null | undefined;
+        runtimeUpdates?: Record<any, any> | undefined;
+    }, {
+        blockId: string;
+        updates: Record<any, any>;
+        removeAttributes?: string[] | undefined;
+        text?: string | null | undefined;
+        runtimeUpdates?: Record<any, any> | undefined;
+    }, string, unknown, "edit_block">;
+    createBlockTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockType: z.ZodString;
+        text: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        attributes: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>>;
+        blockId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        referenceBlockId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        placement: z.ZodNullable<z.ZodOptional<z.ZodEnum<{
+            before: "before";
+            after: "after";
+        }>>>;
+    }, z.core.$strip>, {
+        blockType: string;
+        text: string;
+        attributes: Record<any, any>;
+        blockId?: string | null | undefined;
+        referenceBlockId?: string | null | undefined;
+        placement?: "before" | "after" | null | undefined;
+    }, {
+        blockType: string;
+        text?: string | undefined;
+        attributes?: Record<any, any> | undefined;
+        blockId?: string | null | undefined;
+        referenceBlockId?: string | null | undefined;
+        placement?: "before" | "after" | null | undefined;
+    }, string, unknown, "create_block">;
+    deleteBlockTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        confirm: z.ZodBoolean;
+    }, z.core.$strip>, {
+        blockId: string;
+        confirm: boolean;
+    }, {
+        blockId: string;
+        confirm: boolean;
+    }, string, unknown, "delete_block">;
+    readBlockByIdTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        evaluateConditions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        resolveReferences: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, {
+        blockId: string;
+        evaluateConditions: boolean;
+        resolveReferences: boolean;
+    }, {
+        blockId: string;
+        evaluateConditions?: boolean | undefined;
+        resolveReferences?: boolean | undefined;
+    }, string, unknown, "read_block_by_id">;
+    searchBlocksTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockType: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        propKey: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        propValue: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        textContains: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, {
+        blockType?: string | null | undefined;
+        propKey?: string | null | undefined;
+        propValue?: string | null | undefined;
+        textContains?: string | null | undefined;
+    }, {
+        blockType?: string | null | undefined;
+        propKey?: string | null | undefined;
+        propValue?: string | null | undefined;
+        textContains?: string | null | undefined;
+    }, string, unknown, "search_blocks">;
+    readFlowContextTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{}, z.core.$strip>, Record<string, never>, Record<string, never>, string, unknown, "read_flow_context">;
+    readFlowStatusTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        nodeId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, {
+        nodeId?: string | null | undefined;
+    }, {
+        nodeId?: string | null | undefined;
+    }, string, unknown, "read_flow_status">;
+    readBlockHistoryTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+    }, z.core.$strip>, {
+        blockId: string;
+    }, {
+        blockId: string;
+    }, string, unknown, "read_block_history">;
+    readPermissionsTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        audienceDid: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        capability: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, {
+        audienceDid?: string | null | undefined;
+        capability?: string | null | undefined;
+    }, {
+        audienceDid?: string | null | undefined;
+        capability?: string | null | undefined;
+    }, string, unknown, "read_permissions">;
+    readSurveyTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+    }, z.core.$strip>, {
+        blockId: string;
+    }, {
+        blockId: string;
+    }, string, unknown, "read_survey">;
+    fillSurveyAnswersTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        answers: z.ZodRecord<z.ZodAny, z.ZodAny>;
+        merge: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, {
+        blockId: string;
+        answers: Record<any, any>;
+        merge: boolean;
+    }, {
+        blockId: string;
+        answers: Record<any, any>;
+        merge?: boolean | undefined;
+    }, string, unknown, "fill_survey_answers">;
+    validateSurveyAnswersTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+    }, z.core.$strip>, {
+        blockId: string;
+    }, {
+        blockId: string;
+    }, string, unknown, "validate_survey_answers">;
+    executeActionTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        inputOverrides: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>>;
+    }, z.core.$strip>, {
+        blockId: string;
+        inputOverrides: Record<any, any>;
+    }, {
+        blockId: string;
+        inputOverrides?: Record<any, any> | undefined;
+    }, string, unknown, "execute_action">;
+    findAndReplaceTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        searchText: z.ZodString;
+        replaceText: z.ZodString;
+        caseSensitive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        replaceAll: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>, {
+        searchText: string;
+        replaceText: string;
+        caseSensitive: boolean;
+        replaceAll: boolean;
+    }, {
+        searchText: string;
+        replaceText: string;
+        caseSensitive?: boolean | undefined;
+        replaceAll?: boolean | undefined;
+    }, string, unknown, "find_and_replace">;
+    moveBlockTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        blockId: z.ZodString;
+        referenceBlockId: z.ZodString;
+        placement: z.ZodEnum<{
+            before: "before";
+            after: "after";
+        }>;
+    }, z.core.$strip>, {
+        blockId: string;
+        referenceBlockId: string;
+        placement: "before" | "after";
+    }, {
+        blockId: string;
+        referenceBlockId: string;
+        placement: "before" | "after";
+    }, string, unknown, "move_block">;
+    bulkEditBlocksTool: import("@langchain/core/tools").DynamicStructuredTool<z.ZodObject<{
+        edits: z.ZodArray<z.ZodObject<{
+            blockId: z.ZodString;
+            updates: z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>;
+            text: z.ZodOptional<z.ZodString>;
+            runtimeUpdates: z.ZodOptional<z.ZodRecord<z.ZodAny, z.ZodAny>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, {
+        edits: {
+            blockId: string;
+            updates?: Record<any, any> | undefined;
+            text?: string | undefined;
+            runtimeUpdates?: Record<any, any> | undefined;
+        }[];
+    }, {
+        edits: {
+            blockId: string;
+            updates?: Record<any, any> | undefined;
+            text?: string | undefined;
+            runtimeUpdates?: Record<any, any> | undefined;
+        }[];
+    }, string, unknown, "bulk_edit_blocks">;
+}>;
+//# sourceMappingURL=blocknote-tools.d.ts.map

package/dist/plugins/editor/blocknote-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocknote-tools.d.ts","sourceRoot":"","sources":["../../../src/plugins/editor/blocknote-tools.ts"],"names":[],"mappings":"AACA;;GAEG;AAGH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAGzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA8BlD,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,eAAe,CAAC;AAkBtE,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,0BAA0B;;;;;;;;;;;;;;;;8BAiB1C,MAAM,EAAE;;EAGzC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,CAC3C,OAAO,yBAAyB,CACjC,GAAG;IACF,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAgIF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,cAAc,YAAY,EAC1B,QAAQ,SAAS,EACjB,WAAU,OAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAo4E1B,CAAC"}