@hugex/ai 3.2.0 → 3.4.0

package/dist/common/constants/clef-models.d.ts

@@ -0,0 +1,48 @@
+import type { ClassifierRoute } from '../types/classifier-types';
+export declare const CLEF_MODELS: {
+    readonly 'clef-omni': {
+        readonly id: '@cf/cloudflare/clef-omni';
+        readonly contextWindow: 65529;
+        readonly pricePerMillionInputTokens: 0.15;
+    };
+    readonly clef: {
+        readonly id: '@cf/cloudflare/clef';
+        readonly contextWindow: 65536;
+        readonly pricePerMillionInputTokens: 0.24;
+    };
+    readonly 'clef-flash': {
+        readonly id: '@cf/cloudflare/clef-flash';
+        readonly contextWindow: 24576;
+        readonly pricePerMillionInputTokens: 0.038;
+    };
+};
+export declare const CLASSIFIER_DEFAULTS: {
+    readonly model: 'clef-omni';
+    readonly question: '';
+    readonly options: readonly [{
+        readonly id: 'option';
+        readonly label: '';
+        readonly criteria: '';
+    }, {
+        readonly id: 'option_2';
+        readonly label: '';
+        readonly criteria: '';
+    }];
+    readonly checks: readonly [];
+    readonly input: {
+        readonly message: 'user_input';
+        readonly historyTurns: 3;
+        readonly vars: string[];
+    };
+    readonly confidence: {
+        readonly threshold: 0.6;
+        readonly margin: 0.15;
+    };
+};
+export declare const CLASSIFIER_RESERVED_HANDLES: {
+    readonly uncertain: 'source-__uncertain';
+    readonly blocked: 'source-__blocked';
+    readonly error: 'source-__error';
+};
+/** Pass ('class', id) for class ids that also happen to be route names. */
+export declare function classifierHandle(routeOrClassId: ClassifierRoute | string, classId?: string): string;

package/dist/common/constants/tenant-only-nodes.d.ts

@@ -1,4 +1,4 @@
 import { NodeType } from '../types/node-types';
-/** Node types only available to specific tenants (designer palette + runtime where applicable). */
+/** Node types are available across environments. Retained for existing consumers. */
 export declare const TENANT_ONLY_NODES: Partial<Record<NodeType, readonly string[]>>;
 export declare function isNodeTypeAllowedForTenant(type: string, tenant: string | null | undefined): boolean;

package/dist/common/flow-graph/catalog.d.ts

@@ -0,0 +1,40 @@
+import type { NodeTypeName } from './schema';
+export type ExternalRefKind = 'model' | 'clefModel' | 'tool' | 'composioSlug' | 'memo' | 'worker' | 'secret';
+export interface FieldSpec {
+    name: string;
+    type: 'string' | 'template' | 'ref' | 'ref[]' | 'number' | 'integer' | 'boolean' | 'enum' | 'object' | 'array';
+    required: boolean;
+    persisted: boolean;
+    default?: unknown;
+    enum?: readonly string[];
+    min?: number;
+    max?: number;
+    description: string;
+    externalRef?: ExternalRefKind;
+}
+export interface NodeSpec {
+    type: NodeTypeName;
+    label: string;
+    idPrefix: string;
+    summary: string;
+    fields: FieldSpec[];
+    outputs: {
+        name: string;
+        type?: string;
+        path: string;
+        description: string;
+    }[];
+    handles: {
+        target: boolean;
+        source: 'none' | 'single' | 'classifier';
+    };
+    refFields: {
+        templates: string[];
+        nestedTemplates: string[];
+        directRefs: string[];
+    };
+    discovery: Partial<Record<ExternalRefKind, string>>;
+    example: Record<string, unknown>;
+}
+export declare const NODE_CATALOG: Readonly<Record<NodeTypeName, NodeSpec>>;
+export declare function defaultNodeData(type: NodeTypeName): Record<string, unknown>;

package/dist/common/flow-graph/classifier.d.ts

@@ -0,0 +1,2 @@
+/** Same stem rules as the canvas helper in hx-base classifier-data.ts. */
+export declare function classifierIdFromLabel(label: string, taken: Iterable<string>): string;

package/dist/common/flow-graph/composio.d.ts

@@ -0,0 +1,2 @@
+/** Slugs listed in execution.tools[*].enable. Same result as flattenEnabledToolSlugs. */
+export declare function enabledComposioSlugs(execution: unknown): string[];

package/dist/common/flow-graph/credentials.d.ts

@@ -0,0 +1,3 @@
+import type { GraphIssue, WorkerGraph } from './schema';
+/** L4 findings. The value itself is never copied into the issue. */
+export declare function detectInlineCredentials(graph: WorkerGraph): GraphIssue[];

package/dist/common/flow-graph/index.d.ts

@@ -0,0 +1,11 @@
+export * from './schema';
+export * from './catalog';
+export * from './validate';
+export * from './refs';
+export * from './ops';
+export * from './credentials';
+export * from './templates';
+export * from './composio';
+export * from './classifier';
+export { CLEF_MODELS } from '../constants/clef-models';
+export { TOOL_REGISTRY_SNAPSHOT } from '../constants/tools-registry';

package/dist/common/flow-graph/ops.d.ts

@@ -0,0 +1,21 @@
+import type { GraphIssue, NodeTypeName, WorkerGraph, WorkerOp } from './schema';
+export interface GraphChanges {
+    nodesAdded: string[];
+    nodesRemoved: string[];
+    nodesChanged: string[];
+    edgesAdded: string[];
+    edgesRemoved: string[];
+}
+export declare function edgeId(source: string, target: string, sourceHandle?: string | null): string;
+export declare function nextNodeId(graph: WorkerGraph, type: NodeTypeName): string;
+/** Stable JSON shape: sorted keys, nodes by id, edges by id. UI keys stay. */
+export declare function canonicalGraph(graph: WorkerGraph): unknown;
+export declare function diffGraphs(before: WorkerGraph, after: WorkerGraph): GraphChanges;
+export declare function applyWorkerOps(graph: WorkerGraph, ops: WorkerOp[]): {
+    ok: true;
+    graph: WorkerGraph;
+    changes: GraphChanges;
+} | {
+    ok: false;
+    issue: GraphIssue;
+};

package/dist/common/flow-graph/refs.d.ts

@@ -0,0 +1,18 @@
+import type { AuthoringNode, WorkerGraph } from './schema';
+import type { ExternalRefKind } from './catalog';
+export interface ExternalRef {
+    kind: ExternalRefKind;
+    id: string;
+    nodeId: string;
+    field: string;
+    extra?: Record<string, unknown>;
+}
+/** Template and direct refs the runners actually resolve. jsonPrompt is excluded. */
+export declare function collectNodeRefs(node: AuthoringNode): {
+    field: string;
+    ref: string;
+}[];
+/** Rewrites ancestor refs, including string leaves of an object or array body. Leaves jsonPrompt, keys, and defaults alone. */
+export declare function rewriteNodeDataRefs(data: Record<string, unknown>, oldId: string, newId: string): Record<string, unknown>;
+export declare function collectExternalRefs(graph: WorkerGraph): ExternalRef[];
+export declare function newExternalRefs(before: WorkerGraph | null, after: WorkerGraph): ExternalRef[];