@alpic80/rivet-core 1.19.1-aidon.3 → 1.24.0-aidon.3

package/dist/types/integrations/CodeRunner.d.ts

@@ -0,0 +1,18 @@
+import type { Inputs, Outputs } from '../index.js';
+export interface CodeRunnerOptions {
+    includeRequire: boolean;
+    includeFetch: boolean;
+    includeRivet: boolean;
+    includeProcess: boolean;
+    includeConsole: boolean;
+}
+/** An object that can run arbitrary code (evals it). */
+export interface CodeRunner {
+    runCode: (code: string, inputs: Inputs, options: CodeRunnerOptions) => Promise<Outputs>;
+}
+export declare class IsomorphicCodeRunner implements CodeRunner {
+    runCode(code: string, inputs: Inputs, options: CodeRunnerOptions): Promise<Outputs>;
+}
+export declare class NotAllowedCodeRunner implements CodeRunner {
+    runCode(_code: string, _inputs: Inputs, _options: CodeRunnerOptions): Promise<Outputs>;
+}

package/dist/types/integrations/DatasetProvider.d.ts

@@ -19,7 +19,7 @@ export declare class InMemoryDatasetProvider implements DatasetProvider {
     #private;
     constructor(datasets: CombinedDataset[]);
     getDatasetMetadata(id: DatasetId): Promise<DatasetMetadata | undefined>;
-    getDatasetsForProject(projectId: ProjectId): Promise<DatasetMetadata[]>;
+    getDatasetsForProject(): Promise<DatasetMetadata[]>;
     getDatasetData(id: DatasetId): Promise<Dataset>;
     putDatasetRow(id: DatasetId, row: DatasetRow): Promise<void>;
     putDatasetData(id: DatasetId, data: Dataset): Promise<void>;

package/dist/types/model/DataValue.d.ts

@@ -10,10 +10,14 @@ export type BoolDataValue = DataValueDef<'boolean', boolean>;
 export type SystemChatMessage = {
     type: 'system';
     message: ChatMessageMessagePart | ChatMessageMessagePart[];
+    /** If true, this message marks a breakpoint when used with prompt caching (as of right now, Anthropic-only). */
+    isCacheBreakpoint?: boolean;
 };
 export type UserChatMessage = {
     type: 'user';
     message: ChatMessageMessagePart | ChatMessageMessagePart[];
+    /** If true, this message marks a breakpoint when used with prompt caching (as of right now, Anthropic-only). */
+    isCacheBreakpoint?: boolean;
 };
 export type AssistantChatMessageFunctionCall = {
     id: string | undefined;
@@ -31,22 +35,34 @@ export type AssistantChatMessage = {
     /** @deprecated use function_calls instead */
     function_call: AssistantChatMessageFunctionCall | undefined;
     function_calls: AssistantChatMessageFunctionCall[] | undefined;
+    /** If true, this message marks a breakpoint when used with prompt caching (as of right now, Anthropic-only). */
+    isCacheBreakpoint?: boolean;
 };
 export type FunctionResponseChatMessage = {
     type: 'function';
     message: ChatMessageMessagePart | ChatMessageMessagePart[];
     name: string;
+    /** If true, this message marks a breakpoint when used with prompt caching (as of right now, Anthropic-only). */
+    isCacheBreakpoint?: boolean;
 };
 export type ChatMessage = SystemChatMessage | UserChatMessage | AssistantChatMessage | FunctionResponseChatMessage;
 export type ChatMessageMessagePart = string | {
     type: 'image';
-    mediaType: SupportedMediaTypes;
+    mediaType: SupportedImageMediaTypes;
     data: Uint8Array;
 } | {
     type: 'url';
     url: string;
+} | {
+    type: 'document';
+    title: string | undefined;
+    context: string | undefined;
+    mediaType: SupportedDocumentMediaTypes;
+    data: Uint8Array;
+    enableCitations: boolean;
 };
-export type SupportedMediaTypes = 'image/jpeg' | 'image/png' | 'image/gif';
+export type SupportedImageMediaTypes = 'image/jpeg' | 'image/png' | 'image/gif';
+export type SupportedDocumentMediaTypes = 'application/pdf' | 'text/plain';
 export type ChatMessageDataValue = DataValueDef<'chat-message', ChatMessage>;
 export type DateDataValue = DataValueDef<'date', string>;
 export type TimeDataValue = DataValueDef<'time', string>;
@@ -56,7 +72,7 @@ export type ObjectDataValue = DataValueDef<'object', Record<string, unknown>>;
 export type VectorDataValue = DataValueDef<'vector', number[]>;
 export type BinaryDataValue = DataValueDef<'binary', Uint8Array>;
 export type ImageDataValue = DataValueDef<'image', {
-    mediaType: SupportedMediaTypes;
+    mediaType: SupportedImageMediaTypes;
     data: Uint8Array;
 }>;
 export type AudioDataValue = DataValueDef<'audio', {
@@ -67,6 +83,13 @@ export type GraphReferenceValue = DataValueDef<'graph-reference', {
     graphId: GraphId;
     graphName: string;
 }>;
+export type DocumentDataValue = DataValueDef<'document', {
+    mediaType: SupportedDocumentMediaTypes;
+    data: Uint8Array;
+    title: string | undefined;
+    context: string | undefined;
+    enableCitations: boolean;
+}>;
 /** GPT function definition */
 export type GptFunction = {
     name: string;
@@ -77,7 +100,7 @@ export type GptFunction = {
 };
 export type GptFunctionDataValue = DataValueDef<'gpt-function', GptFunction>;
 export type ControlFlowExcludedDataValue = DataValueDef<'control-flow-excluded', undefined | 'loop-not-broken'>;
-export type ScalarDataValue = StringDataValue | NumberDataValue | DateDataValue | TimeDataValue | DateTimeDataValue | BoolDataValue | ChatMessageDataValue | ControlFlowExcludedDataValue | AnyDataValue | ObjectDataValue | GptFunctionDataValue | VectorDataValue | ImageDataValue | BinaryDataValue | AudioDataValue | GraphReferenceValue;
+export type ScalarDataValue = StringDataValue | NumberDataValue | DateDataValue | TimeDataValue | DateTimeDataValue | BoolDataValue | ChatMessageDataValue | ControlFlowExcludedDataValue | AnyDataValue | ObjectDataValue | GptFunctionDataValue | VectorDataValue | ImageDataValue | BinaryDataValue | AudioDataValue | GraphReferenceValue | DocumentDataValue;
 export type ScalarType = ScalarDataValue['type'];
 export type ArrayDataValue<T extends ScalarDataValue> = DataValueDef<`${T['type']}[]`, T['value'][]>;
 export type FunctionDataValue<T extends ScalarOrArrayDataValue> = DataValueDef<`fn<${T['type']}>`, () => T['value']>;
@@ -106,8 +129,8 @@ export type GetDataValue<Type extends DataType> = Extract<DataValue, {
 export type DataRef = {
     refId: DataId;
 };
-export declare const dataTypes: ["any", "any[]", "boolean", "boolean[]", "string", "string[]", "number", "number[]", "date", "date[]", "time", "time[]", "datetime", "datetime[]", "chat-message", "chat-message[]", "control-flow-excluded", "control-flow-excluded[]", "object", "object[]", "fn<string>", "fn<number>", "fn<boolean>", "fn<date>", "fn<time>", "fn<datetime>", "fn<any>", "fn<object>", "fn<chat-message>", "fn<control-flow-excluded>", "fn<string[]>", "fn<number[]>", "fn<boolean[]>", "fn<date[]>", "fn<time[]>", "fn<datetime[]>", "fn<any[]>", "fn<object[]>", "fn<chat-message[]>", "fn<control-flow-excluded[]>", "gpt-function", "gpt-function[]", "fn<gpt-function[]>", "fn<gpt-function>", "vector", "vector[]", "fn<vector>", "fn<vector[]>", "image", "image[]", "fn<image>", "fn<image[]>", "binary", "binary[]", "fn<binary>", "fn<binary[]>", "audio", "audio[]", "fn<audio>", "fn<audio[]>", "graph-reference", "graph-reference[]", "fn<graph-reference>", "fn<graph-reference[]>"];
-export declare const scalarTypes: ["any", "boolean", "string", "number", "date", "time", "datetime", "chat-message", "control-flow-excluded", "object", "gpt-function", "vector", "image", "binary", "audio", "graph-reference"];
+export declare const dataTypes: ["any", "any[]", "boolean", "boolean[]", "string", "string[]", "number", "number[]", "date", "date[]", "time", "time[]", "datetime", "datetime[]", "chat-message", "chat-message[]", "control-flow-excluded", "control-flow-excluded[]", "object", "object[]", "fn<string>", "fn<number>", "fn<boolean>", "fn<date>", "fn<time>", "fn<datetime>", "fn<any>", "fn<object>", "fn<chat-message>", "fn<control-flow-excluded>", "fn<string[]>", "fn<number[]>", "fn<boolean[]>", "fn<date[]>", "fn<time[]>", "fn<datetime[]>", "fn<any[]>", "fn<object[]>", "fn<chat-message[]>", "fn<control-flow-excluded[]>", "gpt-function", "gpt-function[]", "fn<gpt-function[]>", "fn<gpt-function>", "vector", "vector[]", "fn<vector>", "fn<vector[]>", "image", "image[]", "fn<image>", "fn<image[]>", "binary", "binary[]", "fn<binary>", "fn<binary[]>", "audio", "audio[]", "fn<audio>", "fn<audio[]>", "graph-reference", "graph-reference[]", "fn<graph-reference>", "fn<graph-reference[]>", "document", "document[]", "fn<document>", "fn<document[]>"];
+export declare const scalarTypes: ["any", "boolean", "string", "number", "date", "time", "datetime", "chat-message", "control-flow-excluded", "object", "gpt-function", "vector", "image", "binary", "audio", "graph-reference", "document"];
 export declare const dataTypeDisplayNames: Record<DataType, string>;
 export declare function isScalarDataValue(value: DataValue | undefined): value is ScalarDataValue;
 export declare function isScalarDataType(type: DataType): type is ScalarDataType;

package/dist/types/model/EditorDefinition.d.ts

@@ -94,6 +94,11 @@ export type FileBrowserEditorDefinition<T extends ChartNode> = SharedEditorDefin
     useInputToggleDataKey?: DataOfType<T, boolean>;
     accept?: string;
 };
+export type DirectoryBrowserEditorDefinition<T extends ChartNode> = SharedEditorDefinitionProps<T> & {
+    type: 'directoryBrowser';
+    dataKey: DataOfType<T, string>;
+    useInputToggleDataKey?: DataOfType<T, boolean>;
+};
 export type ImageBrowserEditorDefinition<T extends ChartNode> = SharedEditorDefinitionProps<T> & {
     type: 'imageBrowser';
     dataKey: DataOfType<T, DataRef>;
@@ -138,5 +143,5 @@ export type DynamicEditorDefinition<T extends ChartNode> = SharedEditorDefinitio
     dataType: DataType;
     editor: DynamicEditorEditor;
 };
-export type EditorDefinition<T extends ChartNode> = StringEditorDefinition<T> | ToggleEditorDefinition<T> | DataTypeSelectorEditorDefinition<T> | AnyDataEditorDefinition<T> | DropdownEditorDefinition<T> | NumberEditorDefinition<T> | CodeEditorDefinition<T> | GraphSelectorEditorDefinition<T> | ColorEditorDefinition<T> | GraphSelectorEditorDefinition<T> | FileBrowserEditorDefinition<T> | ImageBrowserEditorDefinition<T> | DatasetSelectorEditorDefinition<T> | KeyValuePairEditorDefinition<T> | EditorDefinitionGroup<T> | StringListEditorDefinition<T> | CustomEditorDefinition<T> | DynamicEditorDefinition<T> | FilePathBrowserEditorDefinition<T>;
+export type EditorDefinition<T extends ChartNode> = StringEditorDefinition<T> | ToggleEditorDefinition<T> | DataTypeSelectorEditorDefinition<T> | AnyDataEditorDefinition<T> | DropdownEditorDefinition<T> | NumberEditorDefinition<T> | CodeEditorDefinition<T> | GraphSelectorEditorDefinition<T> | ColorEditorDefinition<T> | GraphSelectorEditorDefinition<T> | FileBrowserEditorDefinition<T> | ImageBrowserEditorDefinition<T> | DatasetSelectorEditorDefinition<T> | KeyValuePairEditorDefinition<T> | EditorDefinitionGroup<T> | StringListEditorDefinition<T> | CustomEditorDefinition<T> | DynamicEditorDefinition<T> | FilePathBrowserEditorDefinition<T> | DirectoryBrowserEditorDefinition<T>;
 export {};

package/dist/types/model/GraphProcessor.d.ts

@@ -1,12 +1,11 @@
 import { type DataValue, type StringArrayDataValue, type ScalarOrArrayDataValue } from './DataValue.js';
-import type { ChartNode, NodeConnection, NodeId, PortId } from './NodeBase.js';
+import { type ChartNode, type NodeConnection, type NodeId, type PortId } from './NodeBase.js';
 import type { GraphId, NodeGraph } from './NodeGraph.js';
-import type { UserInputNode } from './nodes/UserInputNode.js';
 import Emittery from 'emittery';
-import type { Project } from './Project.js';
+import { type Project } from './Project.js';
 import type { InternalProcessContext, ProcessContext, ProcessId } from './ProcessContext.js';
 import type { ExecutionRecorder } from '../recording/ExecutionRecorder.js';
-import type { Opaque } from 'type-fest';
+import type { Tagged } from 'type-fest';
 import type { NodeRegistration } from './NodeRegistration.js';
 export type ProcessEvents = {
     /** Called when processing has started. */
@@ -65,10 +64,13 @@ export type ProcessEvents = {
     };
     /** Called when a user input node requires user input. Call the callback when finished, or call userInput() on the GraphProcessor with the results. */
     userInput: {
-        node: UserInputNode;
+        node: ChartNode;
+        inputStrings: string[];
+        /** @deprecated use inputStrings instead */
         inputs: Inputs;
         callback: (values: StringArrayDataValue) => void;
         processId: ProcessId;
+        renderingType: 'text' | 'markdown';
     };
     /** Called when a node has partially processed, with the current partial output values for the node. */
     partialOutput: {
@@ -131,7 +133,7 @@ export type ExternalFunctionProcessContext = Omit<InternalProcessContext, 'setGl
 export type ExternalFunction = (context: ExternalFunctionProcessContext, ...args: unknown[]) => Promise<DataValue & {
     cost?: number;
 }>;
-export type RaceId = Opaque<string, 'RaceId'>;
+export type RaceId = Tagged<string, 'RaceId'>;
 export type LoopInfo = AttachedNodeDataItem & {
     /** ID of the controller of the loop */
     loopControllerId: NodeId;
@@ -158,11 +160,13 @@ export declare class GraphProcessor {
     executor?: 'nodejs' | 'browser';
     /** If set, specifies the node(s) that the graph will run TO, instead of the nodes without any dependents. */
     runToNodeIds?: NodeId[];
+    /** If set, specifies the node that the graph will run FROM, instead of the start nodes. Requires preloading data. */
+    runFromNodeId?: NodeId;
     /** The interval between nodeFinish events when playing back a recording. I.e. how fast the playback is. */
     recordingPlaybackChatLatency: number;
     warnOnInvalidGraph: boolean;
     get isRunning(): boolean;
-    constructor(project: Project, graphId?: GraphId, registry?: NodeRegistration);
+    constructor(project: Project, graphId?: GraphId, registry?: NodeRegistration, includeTrace?: boolean);
     on: Emittery<ProcessEvents>["on"];
     off: Emittery<ProcessEvents>["off"];
     once: Emittery<ProcessEvents>["once"];
@@ -177,6 +181,9 @@ export declare class GraphProcessor {
     resume(): void;
     setSlowMode(slowMode: boolean): void;
     events(): AsyncGenerator<ProcessEvent>;
+    preloadNodeData(nodeId: NodeId, data: Outputs): void;
+    /** Gets all node IDs that a given node ID depends on being complete before the given node ID can start. */
+    getDependencyNodesDeep(nodeId: NodeId): NodeId[];
     replayRecording(recorder: ExecutionRecorder): Promise<GraphOutputs>;
     /** Main function for running a graph. Runs a graph and returns the outputs from the output nodes of the graph. */
     processGraph(

package/dist/types/model/NodeBase.d.ts

@@ -41,6 +41,8 @@ export interface NodeBase {
     tests?: NodeTestGroup[];
     /** If true, the node is disabled and effectively "not ran" */
     disabled?: boolean;
+    /** If true, the node exposes an `if` port that lets it run conditionally. */
+    isConditional?: boolean;
 }
 /** Base type for a typed node. */
 export type ChartNode<Type extends string = string, Data = unknown> = NodeBase & {
@@ -108,3 +110,5 @@ export type NodeConnection = {
     /** The unique identifier of the input. */
     inputId: PortId;
 };
+export declare const IF_PORT: NodeInputDefinition;
+export declare function isBuiltInInputDefinition(input: NodeInputDefinition): boolean;

package/dist/types/model/NodeImpl.d.ts

@@ -1,6 +1,6 @@
 import type { Inputs, Outputs } from './GraphProcessor.js';
-import type { ChartNode, NodeConnection, NodeId, NodeInputDefinition, NodeOutputDefinition } from './NodeBase.js';
-import type { Project } from './Project.js';
+import { type ChartNode, type NodeConnection, type NodeId, type NodeInputDefinition, type NodeOutputDefinition } from './NodeBase.js';
+import type { Project, ProjectId } from './Project.js';
 import type { InternalProcessContext } from './ProcessContext.js';
 import type { EditorDefinition } from './EditorDefinition.js';
 import type { NodeBodySpec } from './NodeBodySpec.js';
@@ -25,8 +25,9 @@ export declare abstract class NodeImpl<T extends ChartNode, Type extends T['type
         y: number;
     };
     get data(): T['data'];
-    abstract getInputDefinitions(connections: NodeConnection[], nodes: Record<NodeId, ChartNode>, project: Project): NodeInputDefinition[];
-    abstract getOutputDefinitions(connections: NodeConnection[], nodes: Record<NodeId, ChartNode>, project: Project): NodeOutputDefinition[];
+    abstract getInputDefinitions(connections: NodeConnection[], nodes: Record<NodeId, ChartNode>, project: Project, referencedProjects: Record<ProjectId, Project>): NodeInputDefinition[];
+    getInputDefinitionsIncludingBuiltIn(connections: NodeConnection[], nodes: Record<NodeId, ChartNode>, project: Project, referencedProjects: Record<ProjectId, Project>): NodeInputDefinition[];
+    abstract getOutputDefinitions(connections: NodeConnection[], nodes: Record<NodeId, ChartNode>, project: Project, referencedProjects: Record<ProjectId, Project>): NodeOutputDefinition[];
     abstract process(inputData: Inputs, context: InternalProcessContext): Promise<Outputs>;
     getEditors(_context: RivetUIContext): EditorDefinition<T>[] | Promise<EditorDefinition<T>[]>;
     getBody(_context: RivetUIContext): NodeBody | Promise<NodeBody>;

package/dist/types/model/Nodes.d.ts

@@ -2,6 +2,7 @@ import { NodeRegistration } from './NodeRegistration.js';
 export * from './nodes/UserInputNode.js';
 export * from './nodes/TextNode.js';
 export * from './nodes/ChatNode.js';
+export * from './nodes/ChatNodeBase.js';
 export * from './nodes/PromptNode.js';
 export * from './nodes/ExtractRegexNode.js';
 export * from './nodes/CodeNode.js';
@@ -9,6 +10,7 @@ export * from './nodes/MatchNode.js';
 export * from './nodes/IfNode.js';
 export * from './nodes/ReadDirectoryNode.js';
 export * from './nodes/ReadFileNode.js';
+export * from './nodes/WriteFileNode.js';
 export * from './nodes/IfElseNode.js';
 export * from './nodes/ChunkNode.js';
 export * from './nodes/GraphInputNode.js';
@@ -30,7 +32,7 @@ export * from './nodes/PopNode.js';
 export * from './nodes/SetGlobalNode.js';
 export * from './nodes/GetGlobalNode.js';
 export * from './nodes/WaitForEventNode.js';
-export * from './nodes/GptFunctionNode.js';
+export * from './nodes/ToolNode.js';
 export * from './nodes/ToYamlNode.js';
 export * from './nodes/GetEmbeddingNode.js';
 export * from './nodes/VectorStoreNode.js';
@@ -72,9 +74,16 @@ export * from './nodes/GraphReferenceNode.js';
 export * from './nodes/CallGraphNode.js';
 export * from './nodes/DelegateFunctionCallNode.js';
 export * from './nodes/PlayAudioNode.js';
-export * from './nodes/CallGraphNode.js';
-export declare const registerBuiltInNodes: (registry: NodeRegistration) => NodeRegistration<"number" | "boolean" | "object" | "pop" | "join" | "slice" | "filter" | "match" | "split" | "image" | "audio" | "code" | "array" | "userInput" | "prompt" | "text" | "chat" | "extractRegex" | "if" | "readDirectory" | "readFile" | "ifElse" | "chunk" | "graphInput" | "graphOutput" | "subGraph" | "extractJson" | "assemblePrompt" | "extractYaml" | "loopController" | "trimChatMessages" | "externalCall" | "setGlobal" | "raiseEvent" | "getGlobal" | "abortGraph" | "extractObjectPath" | "context" | "coalesce" | "passthrough" | "waitForEvent" | "gptFunction" | "toYaml" | "getEmbedding" | "vectorStore" | "vectorNearestNeighbors" | "hash" | "raceInputs" | "toJson" | "compare" | "evaluate" | "randomNumber" | "shuffle" | "comment" | "imagetoMD" | "httpCall" | "delay" | "appendToDataset" | "createDataset" | "loadDataset" | "getAllDatasets" | "datasetNearestNeighbors" | "getDatasetRow" | "extractMarkdownCodeBlocks" | "assembleMessage" | "urlReference" | "destructure" | "replaceDataset" | "listGraphs" | "graphReference" | "callGraph" | "delegateFunctionCall" | "playAudio", import("./nodes/UserInputNode.js").UserInputNode | import("./nodes/TextNode.js").TextNode | import("./nodes/ChatNode.js").ChatNode | import("./nodes/PromptNode.js").PromptNode | import("./nodes/ExtractRegexNode.js").ExtractRegexNode | import("./nodes/CodeNode.js").CodeNode | import("./nodes/MatchNode.js").MatchNode | import("./nodes/IfNode.js").IfNode | import("./nodes/ReadDirectoryNode.js").ReadDirectoryNode | import("./nodes/ReadFileNode.js").ReadFileNode | import("./nodes/IfElseNode.js").IfElseNode | import("./nodes/ChunkNode.js").ChunkNode | import("./nodes/GraphInputNode.js").GraphInputNode | import("./nodes/GraphOutputNode.js").GraphOutputNode | import("./nodes/SubGraphNode.js").SubGraphNode | import("./nodes/ArrayNode.js").ArrayNode | import("./nodes/ExtractJsonNode.js").ExtractJsonNode | import("./nodes/AssemblePromptNode.js").AssemblePromptNode | import("./nodes/ExtractYamlNode.js").ExtractYamlNode | import("./nodes/LoopControllerNode.js").LoopControllerNode | import("./nodes/TrimChatMessagesNode.js").TrimChatMessagesNode | import("./nodes/ExternalCallNode.js").ExternalCallNode | import("./nodes/ExtractObjectPathNode.js").ExtractObjectPathNode | import("./nodes/RaiseEventNode.js").RaiseEventNode | import("./nodes/ContextNode.js").ContextNode | import("./nodes/CoalesceNode.js").CoalesceNode | import("./nodes/PassthroughNode.js").PassthroughNode | import("./nodes/PopNode.js").PopNode | import("./nodes/SetGlobalNode.js").SetGlobalNode | import("./nodes/GetGlobalNode.js").GetGlobalNode | import("./nodes/WaitForEventNode.js").WaitForEventNode | import("./nodes/GptFunctionNode.js").GptFunctionNode | import("./nodes/ToYamlNode.js").ToYamlNode | import("./nodes/GetEmbeddingNode.js").GetEmbeddingNode | import("./nodes/VectorStoreNode.js").VectorStoreNode | import("./nodes/VectorNearestNeighborsNode.js").VectorNearestNeighborsNode | import("./nodes/HashNode.js").HashNode | import("./nodes/AbortGraphNode.js").AbortGraphNode | import("./nodes/RaceInputsNode.js").RaceInputsNode | import("./nodes/ToJsonNode.js").ToJsonNode | import("./nodes/JoinNode.js").JoinNode | import("./nodes/FilterNode.js").FilterNode | import("./nodes/ObjectNode.js").ObjectNode | import("./nodes/BooleanNode.js").BooleanNode | import("./nodes/CompareNode.js").CompareNode | import("./nodes/EvaluateNode.js").EvaluateNode | import("./nodes/NumberNode.js").NumberNode | import("./nodes/RandomNumberNode.js").RandomNumberNode | import("./nodes/ShuffleNode.js").ShuffleNode | import("./nodes/CommentNode.js").CommentNode | import("./nodes/ImageToMDNode.js").ImageToMDNode | import("./nodes/ImageNode.js").ImageNode | import("./nodes/AudioNode.js").AudioNode | import("./nodes/HttpCallNode.js").HttpCallNode | import("./nodes/DelayNode.js").DelayNode | import("./nodes/AppendToDatasetNode.js").AppendToDatasetNode | import("./nodes/CreateDatasetNode.js").CreateDatasetNode | import("./nodes/LoadDatasetNode.js").LoadDatasetNode | import("./nodes/GetAllDatasetsNode.js").GetAllDatasetsNode | import("./nodes/SplitNode.js").SplitNode | import("./nodes/DatasetNearestNeigborsNode.js").DatasetNearestNeighborsNode | import("./nodes/GetDatasetRowNode.js").GetDatasetRowNode | import("./nodes/SliceNode.js").SliceNode | import("./nodes/ExtractMarkdownCodeBlocksNode.js").ExtractMarkdownCodeBlocksNode | import("./nodes/AssembleMessageNode.js").AssembleMessageNode | import("./nodes/URLReferenceNode.js").UrlReferenceNode | import("./nodes/DestructureNode.js").DestructureNode | import("./nodes/ReplaceDatasetNode.js").ReplaceDatasetNode | import("./nodes/ListGraphsNode.js").ListGraphsNode | import("./nodes/GraphReferenceNode.js").GraphReferenceNode | import("./nodes/CallGraphNode.js").CallGraphNode | import("./nodes/DelegateFunctionCallNode.js").DelegateFunctionCallNode | import("./nodes/PlayAudioNode.js").PlayAudioNode>;
-declare let globalRivetNodeRegistry: NodeRegistration<"number" | "boolean" | "object" | "pop" | "join" | "slice" | "filter" | "match" | "split" | "image" | "audio" | "code" | "array" | "userInput" | "prompt" | "text" | "chat" | "extractRegex" | "if" | "readDirectory" | "readFile" | "ifElse" | "chunk" | "graphInput" | "graphOutput" | "subGraph" | "extractJson" | "assemblePrompt" | "extractYaml" | "loopController" | "trimChatMessages" | "externalCall" | "setGlobal" | "raiseEvent" | "getGlobal" | "abortGraph" | "extractObjectPath" | "context" | "coalesce" | "passthrough" | "waitForEvent" | "gptFunction" | "toYaml" | "getEmbedding" | "vectorStore" | "vectorNearestNeighbors" | "hash" | "raceInputs" | "toJson" | "compare" | "evaluate" | "randomNumber" | "shuffle" | "comment" | "imagetoMD" | "httpCall" | "delay" | "appendToDataset" | "createDataset" | "loadDataset" | "getAllDatasets" | "datasetNearestNeighbors" | "getDatasetRow" | "extractMarkdownCodeBlocks" | "assembleMessage" | "urlReference" | "destructure" | "replaceDataset" | "listGraphs" | "graphReference" | "callGraph" | "delegateFunctionCall" | "playAudio", import("./nodes/UserInputNode.js").UserInputNode | import("./nodes/TextNode.js").TextNode | import("./nodes/ChatNode.js").ChatNode | import("./nodes/PromptNode.js").PromptNode | import("./nodes/ExtractRegexNode.js").ExtractRegexNode | import("./nodes/CodeNode.js").CodeNode | import("./nodes/MatchNode.js").MatchNode | import("./nodes/IfNode.js").IfNode | import("./nodes/ReadDirectoryNode.js").ReadDirectoryNode | import("./nodes/ReadFileNode.js").ReadFileNode | import("./nodes/IfElseNode.js").IfElseNode | import("./nodes/ChunkNode.js").ChunkNode | import("./nodes/GraphInputNode.js").GraphInputNode | import("./nodes/GraphOutputNode.js").GraphOutputNode | import("./nodes/SubGraphNode.js").SubGraphNode | import("./nodes/ArrayNode.js").ArrayNode | import("./nodes/ExtractJsonNode.js").ExtractJsonNode | import("./nodes/AssemblePromptNode.js").AssemblePromptNode | import("./nodes/ExtractYamlNode.js").ExtractYamlNode | import("./nodes/LoopControllerNode.js").LoopControllerNode | import("./nodes/TrimChatMessagesNode.js").TrimChatMessagesNode | import("./nodes/ExternalCallNode.js").ExternalCallNode | import("./nodes/ExtractObjectPathNode.js").ExtractObjectPathNode | import("./nodes/RaiseEventNode.js").RaiseEventNode | import("./nodes/ContextNode.js").ContextNode | import("./nodes/CoalesceNode.js").CoalesceNode | import("./nodes/PassthroughNode.js").PassthroughNode | import("./nodes/PopNode.js").PopNode | import("./nodes/SetGlobalNode.js").SetGlobalNode | import("./nodes/GetGlobalNode.js").GetGlobalNode | import("./nodes/WaitForEventNode.js").WaitForEventNode | import("./nodes/GptFunctionNode.js").GptFunctionNode | import("./nodes/ToYamlNode.js").ToYamlNode | import("./nodes/GetEmbeddingNode.js").GetEmbeddingNode | import("./nodes/VectorStoreNode.js").VectorStoreNode | import("./nodes/VectorNearestNeighborsNode.js").VectorNearestNeighborsNode | import("./nodes/HashNode.js").HashNode | import("./nodes/AbortGraphNode.js").AbortGraphNode | import("./nodes/RaceInputsNode.js").RaceInputsNode | import("./nodes/ToJsonNode.js").ToJsonNode | import("./nodes/JoinNode.js").JoinNode | import("./nodes/FilterNode.js").FilterNode | import("./nodes/ObjectNode.js").ObjectNode | import("./nodes/BooleanNode.js").BooleanNode | import("./nodes/CompareNode.js").CompareNode | import("./nodes/EvaluateNode.js").EvaluateNode | import("./nodes/NumberNode.js").NumberNode | import("./nodes/RandomNumberNode.js").RandomNumberNode | import("./nodes/ShuffleNode.js").ShuffleNode | import("./nodes/CommentNode.js").CommentNode | import("./nodes/ImageToMDNode.js").ImageToMDNode | import("./nodes/ImageNode.js").ImageNode | import("./nodes/AudioNode.js").AudioNode | import("./nodes/HttpCallNode.js").HttpCallNode | import("./nodes/DelayNode.js").DelayNode | import("./nodes/AppendToDatasetNode.js").AppendToDatasetNode | import("./nodes/CreateDatasetNode.js").CreateDatasetNode | import("./nodes/LoadDatasetNode.js").LoadDatasetNode | import("./nodes/GetAllDatasetsNode.js").GetAllDatasetsNode | import("./nodes/SplitNode.js").SplitNode | import("./nodes/DatasetNearestNeigborsNode.js").DatasetNearestNeighborsNode | import("./nodes/GetDatasetRowNode.js").GetDatasetRowNode | import("./nodes/SliceNode.js").SliceNode | import("./nodes/ExtractMarkdownCodeBlocksNode.js").ExtractMarkdownCodeBlocksNode | import("./nodes/AssembleMessageNode.js").AssembleMessageNode | import("./nodes/URLReferenceNode.js").UrlReferenceNode | import("./nodes/DestructureNode.js").DestructureNode | import("./nodes/ReplaceDatasetNode.js").ReplaceDatasetNode | import("./nodes/ListGraphsNode.js").ListGraphsNode | import("./nodes/GraphReferenceNode.js").GraphReferenceNode | import("./nodes/CallGraphNode.js").CallGraphNode | import("./nodes/DelegateFunctionCallNode.js").DelegateFunctionCallNode | import("./nodes/PlayAudioNode.js").PlayAudioNode>;
+export * from './nodes/DocumentNode.js';
+export * from './nodes/ChatLoopNode.js';
+export * from './nodes/ReadAllFilesNode.js';
+export * from './nodes/ToMarkdownTableNode.js';
+export * from './nodes/CronNode.js';
+export * from './nodes/ToTreeNode.js';
+export * from './nodes/LoopUntilNode.js';
+export * from './nodes/ReferencedGraphAliasNode.js';
+export declare const registerBuiltInNodes: (registry: NodeRegistration) => NodeRegistration<"number" | "boolean" | "object" | "pop" | "join" | "slice" | "filter" | "match" | "split" | "image" | "audio" | "document" | "if" | "code" | "context" | "array" | "text" | "userInput" | "prompt" | "chat" | "extractRegex" | "readDirectory" | "readFile" | "writeFile" | "ifElse" | "chunk" | "graphInput" | "graphOutput" | "subGraph" | "extractJson" | "assemblePrompt" | "extractYaml" | "loopController" | "trimChatMessages" | "externalCall" | "setGlobal" | "raiseEvent" | "getGlobal" | "abortGraph" | "extractObjectPath" | "coalesce" | "passthrough" | "waitForEvent" | "gptFunction" | "toYaml" | "getEmbedding" | "vectorStore" | "vectorNearestNeighbors" | "hash" | "raceInputs" | "toJson" | "compare" | "evaluate" | "randomNumber" | "shuffle" | "comment" | "imagetoMD" | "httpCall" | "delay" | "appendToDataset" | "createDataset" | "loadDataset" | "getAllDatasets" | "datasetNearestNeighbors" | "getDatasetRow" | "extractMarkdownCodeBlocks" | "assembleMessage" | "urlReference" | "destructure" | "replaceDataset" | "listGraphs" | "graphReference" | "callGraph" | "delegateFunctionCall" | "playAudio" | "chatLoop" | "readAllFiles" | "toMarkdownTable" | "cron" | "toTree" | "loopUntil" | "referencedGraphAlias", import("./nodes/UserInputNode.js").UserInputNode | import("./nodes/TextNode.js").TextNode | import("./nodes/ChatNode.js").ChatNode | import("./nodes/PromptNode.js").PromptNode | import("./nodes/ExtractRegexNode.js").ExtractRegexNode | import("./nodes/CodeNode.js").CodeNode | import("./nodes/MatchNode.js").MatchNode | import("./nodes/IfNode.js").IfNode | import("./nodes/ReadDirectoryNode.js").ReadDirectoryNode | import("./nodes/ReadFileNode.js").ReadFileNode | import("./nodes/WriteFileNode.js").WriteFileNode | import("./nodes/IfElseNode.js").IfElseNode | import("./nodes/ChunkNode.js").ChunkNode | import("./nodes/GraphInputNode.js").GraphInputNode | import("./nodes/GraphOutputNode.js").GraphOutputNode | import("./nodes/SubGraphNode.js").SubGraphNode | import("./nodes/ArrayNode.js").ArrayNode | import("./nodes/ExtractJsonNode.js").ExtractJsonNode | import("./nodes/AssemblePromptNode.js").AssemblePromptNode | import("./nodes/ExtractYamlNode.js").ExtractYamlNode | import("./nodes/LoopControllerNode.js").LoopControllerNode | import("./nodes/TrimChatMessagesNode.js").TrimChatMessagesNode | import("./nodes/ExternalCallNode.js").ExternalCallNode | import("./nodes/ExtractObjectPathNode.js").ExtractObjectPathNode | import("./nodes/RaiseEventNode.js").RaiseEventNode | import("./nodes/ContextNode.js").ContextNode | import("./nodes/CoalesceNode.js").CoalesceNode | import("./nodes/PassthroughNode.js").PassthroughNode | import("./nodes/PopNode.js").PopNode | import("./nodes/SetGlobalNode.js").SetGlobalNode | import("./nodes/GetGlobalNode.js").GetGlobalNode | import("./nodes/WaitForEventNode.js").WaitForEventNode | import("./nodes/ToolNode.js").GptFunctionNode | import("./nodes/ToYamlNode.js").ToYamlNode | import("./nodes/GetEmbeddingNode.js").GetEmbeddingNode | import("./nodes/VectorStoreNode.js").VectorStoreNode | import("./nodes/VectorNearestNeighborsNode.js").VectorNearestNeighborsNode | import("./nodes/HashNode.js").HashNode | import("./nodes/AbortGraphNode.js").AbortGraphNode | import("./nodes/RaceInputsNode.js").RaceInputsNode | import("./nodes/ToJsonNode.js").ToJsonNode | import("./nodes/JoinNode.js").JoinNode | import("./nodes/FilterNode.js").FilterNode | import("./nodes/ObjectNode.js").ObjectNode | import("./nodes/BooleanNode.js").BooleanNode | import("./nodes/CompareNode.js").CompareNode | import("./nodes/EvaluateNode.js").EvaluateNode | import("./nodes/NumberNode.js").NumberNode | import("./nodes/RandomNumberNode.js").RandomNumberNode | import("./nodes/ShuffleNode.js").ShuffleNode | import("./nodes/CommentNode.js").CommentNode | import("./nodes/ImageToMDNode.js").ImageToMDNode | import("./nodes/ImageNode.js").ImageNode | import("./nodes/AudioNode.js").AudioNode | import("./nodes/HttpCallNode.js").HttpCallNode | import("./nodes/DelayNode.js").DelayNode | import("./nodes/AppendToDatasetNode.js").AppendToDatasetNode | import("./nodes/CreateDatasetNode.js").CreateDatasetNode | import("./nodes/LoadDatasetNode.js").LoadDatasetNode | import("./nodes/GetAllDatasetsNode.js").GetAllDatasetsNode | import("./nodes/SplitNode.js").SplitNode | import("./nodes/DatasetNearestNeigborsNode.js").DatasetNearestNeighborsNode | import("./nodes/GetDatasetRowNode.js").GetDatasetRowNode | import("./nodes/SliceNode.js").SliceNode | import("./nodes/ExtractMarkdownCodeBlocksNode.js").ExtractMarkdownCodeBlocksNode | import("./nodes/AssembleMessageNode.js").AssembleMessageNode | import("./nodes/URLReferenceNode.js").UrlReferenceNode | import("./nodes/DestructureNode.js").DestructureNode | import("./nodes/ReplaceDatasetNode.js").ReplaceDatasetNode | import("./nodes/ListGraphsNode.js").ListGraphsNode | import("./nodes/GraphReferenceNode.js").GraphReferenceNode | import("./nodes/CallGraphNode.js").CallGraphNode | import("./nodes/DelegateFunctionCallNode.js").DelegateFunctionCallNode | import("./nodes/PlayAudioNode.js").PlayAudioNode | import("./nodes/DocumentNode.js").DocumentNode | import("./nodes/ChatLoopNode.js").ChatLoopNode | import("./nodes/ReadAllFilesNode.js").ReadAllFilesNode | import("./nodes/ToMarkdownTableNode.js").ToMarkdownTableNode | import("./nodes/CronNode.js").CronNode | import("./nodes/ToTreeNode.js").ToTreeNode | import("./nodes/LoopUntilNode.js").LoopUntilNode | import("./nodes/ReferencedGraphAliasNode.js").ReferencedGraphAliasNode>;
+declare let globalRivetNodeRegistry: NodeRegistration<"number" | "boolean" | "object" | "pop" | "join" | "slice" | "filter" | "match" | "split" | "image" | "audio" | "document" | "if" | "code" | "context" | "array" | "text" | "userInput" | "prompt" | "chat" | "extractRegex" | "readDirectory" | "readFile" | "writeFile" | "ifElse" | "chunk" | "graphInput" | "graphOutput" | "subGraph" | "extractJson" | "assemblePrompt" | "extractYaml" | "loopController" | "trimChatMessages" | "externalCall" | "setGlobal" | "raiseEvent" | "getGlobal" | "abortGraph" | "extractObjectPath" | "coalesce" | "passthrough" | "waitForEvent" | "gptFunction" | "toYaml" | "getEmbedding" | "vectorStore" | "vectorNearestNeighbors" | "hash" | "raceInputs" | "toJson" | "compare" | "evaluate" | "randomNumber" | "shuffle" | "comment" | "imagetoMD" | "httpCall" | "delay" | "appendToDataset" | "createDataset" | "loadDataset" | "getAllDatasets" | "datasetNearestNeighbors" | "getDatasetRow" | "extractMarkdownCodeBlocks" | "assembleMessage" | "urlReference" | "destructure" | "replaceDataset" | "listGraphs" | "graphReference" | "callGraph" | "delegateFunctionCall" | "playAudio" | "chatLoop" | "readAllFiles" | "toMarkdownTable" | "cron" | "toTree" | "loopUntil" | "referencedGraphAlias", import("./nodes/UserInputNode.js").UserInputNode | import("./nodes/TextNode.js").TextNode | import("./nodes/ChatNode.js").ChatNode | import("./nodes/PromptNode.js").PromptNode | import("./nodes/ExtractRegexNode.js").ExtractRegexNode | import("./nodes/CodeNode.js").CodeNode | import("./nodes/MatchNode.js").MatchNode | import("./nodes/IfNode.js").IfNode | import("./nodes/ReadDirectoryNode.js").ReadDirectoryNode | import("./nodes/ReadFileNode.js").ReadFileNode | import("./nodes/WriteFileNode.js").WriteFileNode | import("./nodes/IfElseNode.js").IfElseNode | import("./nodes/ChunkNode.js").ChunkNode | import("./nodes/GraphInputNode.js").GraphInputNode | import("./nodes/GraphOutputNode.js").GraphOutputNode | import("./nodes/SubGraphNode.js").SubGraphNode | import("./nodes/ArrayNode.js").ArrayNode | import("./nodes/ExtractJsonNode.js").ExtractJsonNode | import("./nodes/AssemblePromptNode.js").AssemblePromptNode | import("./nodes/ExtractYamlNode.js").ExtractYamlNode | import("./nodes/LoopControllerNode.js").LoopControllerNode | import("./nodes/TrimChatMessagesNode.js").TrimChatMessagesNode | import("./nodes/ExternalCallNode.js").ExternalCallNode | import("./nodes/ExtractObjectPathNode.js").ExtractObjectPathNode | import("./nodes/RaiseEventNode.js").RaiseEventNode | import("./nodes/ContextNode.js").ContextNode | import("./nodes/CoalesceNode.js").CoalesceNode | import("./nodes/PassthroughNode.js").PassthroughNode | import("./nodes/PopNode.js").PopNode | import("./nodes/SetGlobalNode.js").SetGlobalNode | import("./nodes/GetGlobalNode.js").GetGlobalNode | import("./nodes/WaitForEventNode.js").WaitForEventNode | import("./nodes/ToolNode.js").GptFunctionNode | import("./nodes/ToYamlNode.js").ToYamlNode | import("./nodes/GetEmbeddingNode.js").GetEmbeddingNode | import("./nodes/VectorStoreNode.js").VectorStoreNode | import("./nodes/VectorNearestNeighborsNode.js").VectorNearestNeighborsNode | import("./nodes/HashNode.js").HashNode | import("./nodes/AbortGraphNode.js").AbortGraphNode | import("./nodes/RaceInputsNode.js").RaceInputsNode | import("./nodes/ToJsonNode.js").ToJsonNode | import("./nodes/JoinNode.js").JoinNode | import("./nodes/FilterNode.js").FilterNode | import("./nodes/ObjectNode.js").ObjectNode | import("./nodes/BooleanNode.js").BooleanNode | import("./nodes/CompareNode.js").CompareNode | import("./nodes/EvaluateNode.js").EvaluateNode | import("./nodes/NumberNode.js").NumberNode | import("./nodes/RandomNumberNode.js").RandomNumberNode | import("./nodes/ShuffleNode.js").ShuffleNode | import("./nodes/CommentNode.js").CommentNode | import("./nodes/ImageToMDNode.js").ImageToMDNode | import("./nodes/ImageNode.js").ImageNode | import("./nodes/AudioNode.js").AudioNode | import("./nodes/HttpCallNode.js").HttpCallNode | import("./nodes/DelayNode.js").DelayNode | import("./nodes/AppendToDatasetNode.js").AppendToDatasetNode | import("./nodes/CreateDatasetNode.js").CreateDatasetNode | import("./nodes/LoadDatasetNode.js").LoadDatasetNode | import("./nodes/GetAllDatasetsNode.js").GetAllDatasetsNode | import("./nodes/SplitNode.js").SplitNode | import("./nodes/DatasetNearestNeigborsNode.js").DatasetNearestNeighborsNode | import("./nodes/GetDatasetRowNode.js").GetDatasetRowNode | import("./nodes/SliceNode.js").SliceNode | import("./nodes/ExtractMarkdownCodeBlocksNode.js").ExtractMarkdownCodeBlocksNode | import("./nodes/AssembleMessageNode.js").AssembleMessageNode | import("./nodes/URLReferenceNode.js").UrlReferenceNode | import("./nodes/DestructureNode.js").DestructureNode | import("./nodes/ReplaceDatasetNode.js").ReplaceDatasetNode | import("./nodes/ListGraphsNode.js").ListGraphsNode | import("./nodes/GraphReferenceNode.js").GraphReferenceNode | import("./nodes/CallGraphNode.js").CallGraphNode | import("./nodes/DelegateFunctionCallNode.js").DelegateFunctionCallNode | import("./nodes/PlayAudioNode.js").PlayAudioNode | import("./nodes/DocumentNode.js").DocumentNode | import("./nodes/ChatLoopNode.js").ChatLoopNode | import("./nodes/ReadAllFilesNode.js").ReadAllFilesNode | import("./nodes/ToMarkdownTableNode.js").ToMarkdownTableNode | import("./nodes/CronNode.js").CronNode | import("./nodes/ToTreeNode.js").ToTreeNode | import("./nodes/LoopUntilNode.js").LoopUntilNode | import("./nodes/ReferencedGraphAliasNode.js").ReferencedGraphAliasNode>;
 export { globalRivetNodeRegistry };
 export type BuiltInNodes = typeof globalRivetNodeRegistry.NodesType;
 export type BuiltInNodeType = typeof globalRivetNodeRegistry.NodeTypesType;

package/dist/types/model/ProcessContext.d.ts

@@ -1,6 +1,8 @@
 import type { Opaque } from 'type-fest';
-import { type Settings, type NativeApi, type Project, type DataValue, type ExternalFunction, type Outputs, type GraphId, type GraphProcessor, type ScalarOrArrayDataValue, type DatasetProvider, type ChartNode, type AttachedNodeData, type AudioProvider } from '../index.js';
+import { type Settings, type NativeApi, type Project, type DataValue, type ExternalFunction, type Outputs, type GraphId, type GraphProcessor, type ScalarOrArrayDataValue, type DatasetProvider, type ChartNode, type AttachedNodeData, type AudioProvider, type StringArrayDataValue, type ProjectId } from '../index.js';
 import type { Tokenizer } from '../integrations/Tokenizer.js';
+import type { CodeRunner } from '../integrations/CodeRunner.js';
+import type { ProjectReferenceLoader } from './ProjectReferenceLoader.js';
 export type ProcessContext = {
     settings: Settings;
     nativeApi?: NativeApi;
@@ -10,6 +12,12 @@ export type ProcessContext = {
     audioProvider?: AudioProvider;
     /** Sets the tokenizer that will be used for all nodes. If unset, the default GptTokenizerTokenizer will be used. */
     tokenizer?: Tokenizer;
+    /** The provider for running arbitrary code in the Code Node. */
+    codeRunner?: CodeRunner;
+    /** The loader for loading project references. */
+    projectReferenceLoader?: ProjectReferenceLoader;
+    /** The path to the current project. Required if project references are being used. */
+    projectPath?: string;
     /**
      * If implemented, chat nodes will first call this to resolve their configured endpoint to a final endpoint.
      * You can use this for adding auth headers, or to load balance between multiple endpoints.
@@ -26,6 +34,8 @@ export type InternalProcessContext<T extends ChartNode = ChartNode> = ProcessCon
     executor: 'nodejs' | 'browser';
     /** The project being executed. */
     project: Project;
+    /** All referenced (and deep referenced) projects from the current project. */
+    referencedProjects: Record<ProjectId, Project>;
     /** A signal that can be used when abort() is called on the GraphProcessor to abort the node's execution. */
     signal: AbortSignal;
     /** A unique ID for this specific execution of the node. */
@@ -54,6 +64,7 @@ export type InternalProcessContext<T extends ChartNode = ChartNode> = ProcessCon
     /** Creates a subprocessor, for executing subgraphs. */
     createSubProcessor: (subGraphId: GraphId | undefined, options?: {
         signal?: AbortSignal;
+        project?: Project;
     }) => GraphProcessor;
     /** Like context, but variables that are set during the run of the graph and can be read during the graph. Shared among all graphs and subgraphs. */
     getGlobal: (id: string) => ScalarOrArrayDataValue | undefined;
@@ -66,4 +77,8 @@ export type InternalProcessContext<T extends ChartNode = ChartNode> = ProcessCon
     abortGraph: (error?: Error | string) => void;
     /** Gets a string plugin config value from the settings, falling back to a specified environment variable if set. */
     getPluginConfig(name: string): string | undefined;
+    /** Requests that the user input some text in response to the specified prompt. */
+    requestUserInput(inputs: string[], renderingType: 'text' | 'markdown'): Promise<StringArrayDataValue>;
+    /** The object used for running arbitrary code with the Code Node. */
+    codeRunner: CodeRunner;
 };

package/dist/types/model/Project.d.ts

@@ -4,14 +4,26 @@ import { type PluginLoadSpec } from './PluginLoadSpec.js';
 export type ProjectId = Opaque<string, 'ProjectId'>;
 export type DataId = Opaque<string, 'DataId'>;
 export type Project = {
-    metadata: {
-        id: ProjectId;
-        title: string;
-        description: string;
-        mainGraphId?: GraphId;
-        path?: string;
-    };
+    metadata: ProjectMetadata;
     plugins?: PluginLoadSpec[];
     graphs: Record<GraphId, NodeGraph>;
     data?: Record<DataId, string>;
+    /** References to other projects. */
+    references?: ProjectReference[];
+};
+export type ProjectMetadata = {
+    id: ProjectId;
+    title: string;
+    description: string;
+    mainGraphId?: GraphId;
+    path?: string;
+};
+/** A reference to another project file. Project references cannot be cyclic. */
+export type ProjectReference = {
+    /** The ID of the project being referenced. */
+    id: ProjectId;
+    /** Paths to use to attempt to resolve the reference. */
+    hintPaths?: string[];
+    /** A human-readable title for the project. */
+    title?: string;
 };

package/dist/types/model/ProjectReferenceLoader.d.ts

@@ -0,0 +1,5 @@
+import type { Project, ProjectReference } from './Project.js';
+export type ProjectReferenceLoader = {
+    /** Loads a project based on the given reference. */
+    loadProject: (currentProjectPath: string | undefined, reference: ProjectReference) => Promise<Project>;
+};

package/dist/types/model/RivetPlugin.d.ts

@@ -9,6 +9,7 @@ export type RivetPlugin = {
     register?: (register: <T extends ChartNode>(definition: PluginNodeDefinition<T>) => void) => void;
     /** The available configuration items and their specification, for configuring a plugin in the UI. */
     configSpec?: RivetPluginConfigSpecs;
+    configPage?: RivetPluginConfigPage;
     /** Defines additional context menu groups that the plugin adds. */
     contextMenuGroups?: Array<{
         id: string;
@@ -16,6 +17,11 @@ export type RivetPlugin = {
     }>;
 };
 export type RivetPluginConfigSpecs = Record<string, PluginConfigurationSpec>;
+export type RivetPluginConfigPage = {
+    id: string;
+    label: string;
+    description?: string;
+};
 export type PluginConfigurationSpecBase<T> = {
     /** The type of the config value, how it should show as an editor in the UI. */
     type: string;

package/dist/types/model/RivetUIContext.d.ts

@@ -1,4 +1,4 @@
-import { type ChartNode, type DatasetProvider, type NodeGraph, type Project, type Settings } from '../index.js';
+import { type ChartNode, type DatasetProvider, type NativeApi, type NodeGraph, type Project, type ProjectId, type Settings } from '../index.js';
 /** Context accessible to UI functions such as getEditors() and getBody(). */
 export type RivetUIContext = {
     /** The settings configured in the UI. */
@@ -9,10 +9,14 @@ export type RivetUIContext = {
     datasetProvider: DatasetProvider;
     /** The current project loaded in the UI. */
     project: Project;
+    /** Other projects referenced by the current project. */
+    referencedProjects: Record<ProjectId, Project>;
     /** The current graph selected in the UI. */
     graph?: NodeGraph;
     /** The current node selected in the UI. */
     node?: ChartNode;
+    /** The configured native API. */
+    nativeApi: NativeApi;
     /** Gets a string plugin config value from the settings, falling back to a specified environment variable if set. */
     getPluginConfig(name: string): string | undefined;
 };

package/dist/types/model/Settings.d.ts

@@ -12,4 +12,5 @@ export interface Settings<PluginSettings = Record<string, Record<string, unknown
     /** Timeout in milliseconds before retrying a chat node call. */
     chatNodeTimeout?: number;
     chatNodeHeaders?: Record<string, string>;
+    throttleChatNode?: number;
 }

package/dist/types/model/nodes/AssemblePromptNode.d.ts

@@ -1,5 +1,5 @@
 import { type ChartNode, type NodeConnection, type NodeInputDefinition, type NodeOutputDefinition } from '../NodeBase.js';
-import { NodeImpl, type NodeUIData } from '../NodeImpl.js';
+import { NodeImpl, type NodeBody, type NodeUIData } from '../NodeImpl.js';
 import { type Inputs, type Outputs } from '../GraphProcessor.js';
 import type { EditorDefinition } from '../EditorDefinition.js';
 import type { RivetUIContext } from '../RivetUIContext.js';
@@ -7,6 +7,8 @@ import type { InternalProcessContext } from '../ProcessContext.js';
 export type AssemblePromptNode = ChartNode<'assemblePrompt', AssemblePromptNodeData>;
 export type AssemblePromptNodeData = {
     computeTokenCount?: boolean;
+    isLastMessageCacheBreakpoint?: boolean;
+    useIsLastMessageCacheBreakpointInput?: boolean;
 };
 export declare class AssemblePromptNodeImpl extends NodeImpl<AssemblePromptNode> {
     #private;
@@ -15,6 +17,7 @@ export declare class AssemblePromptNodeImpl extends NodeImpl<AssemblePromptNode>
     getOutputDefinitions(): NodeOutputDefinition[];
     static getUIData(): NodeUIData;
     getEditors(_context: RivetUIContext): EditorDefinition<AssemblePromptNode>[];
+    getBody(_context: RivetUIContext): NodeBody | Promise<NodeBody>;
     process(inputs: Inputs, context: InternalProcessContext): Promise<Outputs>;
 }
 export declare const assemblePromptNode: import("../NodeDefinition.js").NodeDefinition<AssemblePromptNode>;

package/dist/types/model/nodes/ChatLoopNode.d.ts

@@ -0,0 +1,21 @@
+import { type ChartNode, type NodeInputDefinition, type NodeOutputDefinition } from '../NodeBase.js';
+import { NodeImpl, type NodeUIData } from '../NodeImpl.js';
+import type { Inputs, Outputs } from '../GraphProcessor.js';
+import { type InternalProcessContext } from '../ProcessContext.js';
+import { type EditorDefinition } from '../../index.js';
+import { type ChatNodeData } from './ChatNodeBase.js';
+export type ChatLoopNode = ChartNode<'chatLoop', ChatLoopNodeData>;
+export type ChatLoopNodeData = ChatNodeData & {
+    userPrompt: string;
+    renderingFormat?: 'text' | 'markdown';
+};
+export declare class ChatLoopNodeImpl extends NodeImpl<ChatLoopNode> {
+    static create(): ChatLoopNode;
+    getInputDefinitions(): NodeInputDefinition[];
+    getOutputDefinitions(): NodeOutputDefinition[];
+    static getUIData(): NodeUIData;
+    getEditors(): EditorDefinition<ChatLoopNode>[];
+    getBody(): string | undefined;
+    process(inputs: Inputs, context: InternalProcessContext): Promise<Outputs>;
+}
+export declare const chatLoopNode: import("../NodeDefinition.js").NodeDefinition<ChatLoopNode>;

package/dist/types/model/nodes/ChatNode.d.ts

@@ -1,77 +1,17 @@
 import { type ChartNode, type NodeInputDefinition, type NodeOutputDefinition } from '../NodeBase.js';
 import { NodeImpl, type NodeUIData } from '../NodeImpl.js';
-import { type ChatMessage } from '../DataValue.js';
 import type { Inputs, Outputs } from '../GraphProcessor.js';
 import { type InternalProcessContext } from '../ProcessContext.js';
 import { type EditorDefinition } from '../../index.js';
+import { type ChatNodeData } from './ChatNodeBase.js';
 export type ChatNode = ChartNode<'chat', ChatNodeData>;
-export type ChatNodeConfigData = {
-    model: string;
-    temperature: number;
-    useTopP: boolean;
-    top_p?: number;
-    maxTokens: number;
-    stop?: string;
-    presencePenalty?: number;
-    frequencyPenalty?: number;
-    enableFunctionUse?: boolean;
-    user?: string;
-    numberOfChoices?: number;
-    endpoint?: string;
-    overrideModel?: string;
-    overrideMaxTokens?: number;
-    headers?: {
-        key: string;
-        value: string;
-    }[];
-    seed?: number;
-    toolChoice?: 'none' | 'auto' | 'function';
-    toolChoiceFunction?: string;
-    responseFormat?: '' | 'text' | 'json' | 'json_schema';
-    parallelFunctionCalling?: boolean;
-    additionalParameters?: {
-        key: string;
-        value: string;
-    }[];
-    responseSchemaName?: string;
-};
-export type ChatNodeData = ChatNodeConfigData & {
-    useModelInput: boolean;
-    useTemperatureInput: boolean;
-    useTopPInput: boolean;
-    useTopP: boolean;
-    useUseTopPInput: boolean;
-    useMaxTokensInput: boolean;
-    useStop: boolean;
-    useStopInput: boolean;
-    usePresencePenaltyInput: boolean;
-    useFrequencyPenaltyInput: boolean;
-    useUserInput?: boolean;
-    useNumberOfChoicesInput?: boolean;
-    useEndpointInput?: boolean;
-    useHeadersInput?: boolean;
-    useSeedInput?: boolean;
-    useToolChoiceInput?: boolean;
-    useToolChoiceFunctionInput?: boolean;
-    useResponseFormatInput?: boolean;
-    useAdditionalParametersInput?: boolean;
-    useResponseSchemaNameInput?: boolean;
-    /** Given the same set of inputs, return the same output without hitting GPT */
-    cache: boolean;
-    useAsGraphPartialOutput?: boolean;
-};
 export declare class ChatNodeImpl extends NodeImpl<ChatNode> {
     static create(): ChatNode;
     getInputDefinitions(): NodeInputDefinition[];
     getOutputDefinitions(): NodeOutputDefinition[];
     static getUIData(): NodeUIData;
     getEditors(): EditorDefinition<ChatNode>[];
-    getBody(): string;
+    getBody(): string | undefined;
     process(inputs: Inputs, context: InternalProcessContext): Promise<Outputs>;
 }
 export declare const chatNode: import("../NodeDefinition.js").NodeDefinition<ChatNode>;
-export declare function getChatNodeMessages(inputs: Inputs): {
-    messages: ChatMessage[];
-    systemPrompt: import("../DataValue.js").DataValue | undefined;
-};
-export declare function getCostForTokens(tokenCount: number, type: 'prompt' | 'completion', costPerThousand: number): number;