@runflow-ai/sdk 1.1.9 → 1.1.11

package/dist/_runflow-shared/types/dashboard-cards.zod.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * Zod schemas for Dashboard Cards.
+ *
+ * Used at runtime by:
+ *   - MCP tool input validation (apps/api-portal/src/modules/mcp/tools)
+ *   - CLI `metrics.json` parser (packages/cli)
+ *   - SDK `defineCard()` runtime guard (packages/sdk)
+ *
+ * The API DTOs in apps/api-portal use class-validator/class-transformer (not
+ * zod) — but the shapes mirror these schemas 1:1. If a field is added here,
+ * mirror it there too. The dashboard-cards.ts types remain the canonical TS
+ * source.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRID_CONSTRAINTS = exports.MetricsFileSchema = exports.ReorderTabsInputSchema = exports.ReorderCardsInputSchema = exports.DashboardTabInputSchema = exports.DashboardCardInputSchema = exports.GridLayoutItemSchema = exports.GaugeCardConfigSchema = exports.GaugeZoneColorsSchema = exports.GaugeThresholdsSchema = exports.FunnelCardConfigSchema = exports.FunnelStepValueSchema = exports.FunnelStepSchema = exports.TableCardConfigSchema = exports.TablePaginationSchema = exports.TableConditionSchema = exports.TableConditionRuleSchema = exports.TableFilterSchema = exports.TableMetricSchema = exports.TableColumnConfigSchema = exports.BaseCardConfigSchema = exports.CardTypeSchema = exports.FilterOperatorSchema = exports.CardFormatSchema = exports.DateGroupingSchema = exports.AggregationSchema = void 0;
+exports.gridLayoutForCardType = gridLayoutForCardType;
+const zod_1 = require("zod");
+const dashboard_cards_1 = require("./dashboard-cards");
+Object.defineProperty(exports, "GRID_CONSTRAINTS", { enumerable: true, get: function () { return dashboard_cards_1.GRID_CONSTRAINTS; } });
+// -----------------------------------------------------------------------------
+// Atom enums
+// -----------------------------------------------------------------------------
+exports.AggregationSchema = zod_1.z.enum([
+    "count",
+    "rate",
+    "sum",
+    "avg",
+    "distinct_count",
+    "group_by",
+]);
+exports.DateGroupingSchema = zod_1.z.enum(["hour", "day", "week", "month"]);
+exports.CardFormatSchema = zod_1.z.enum([
+    "number",
+    "percentage",
+    "currency",
+    "duration",
+]);
+exports.FilterOperatorSchema = zod_1.z.enum([
+    "eq",
+    "neq",
+    "gt",
+    "lt",
+    "gte",
+    "lte",
+    "contains",
+    "in",
+]);
+exports.CardTypeSchema = zod_1.z.enum(dashboard_cards_1.ALL_CARD_TYPES);
+// -----------------------------------------------------------------------------
+// Config shapes — each card type carries `cardType` for discriminator support.
+// -----------------------------------------------------------------------------
+const BaseConfigFields = {
+    eventName: zod_1.z.string().min(1).optional(),
+    aggregation: exports.AggregationSchema.optional(),
+    propertyKey: zod_1.z.string().optional(),
+    propertyValue: zod_1.z.string().optional(),
+    dateGrouping: exports.DateGroupingSchema.optional(),
+    format: exports.CardFormatSchema.optional(),
+    color: zod_1.z.string().optional(),
+    icon: zod_1.z.string().optional(),
+};
+exports.BaseCardConfigSchema = zod_1.z.object(BaseConfigFields).strict();
+exports.TableColumnConfigSchema = zod_1.z
+    .object({
+    key: zod_1.z.string().min(1),
+    label: zod_1.z.string().optional(),
+    format: zod_1.z
+        .enum(["number", "percentage", "currency", "duration", "text"])
+        .optional(),
+    width: zod_1.z.number().positive().optional(),
+})
+    .strict();
+exports.TableMetricSchema = zod_1.z
+    .object({
+    aggregation: exports.AggregationSchema,
+    propertyKey: zod_1.z.string().optional(),
+    alias: zod_1.z.string().optional(),
+})
+    .strict();
+exports.TableFilterSchema = zod_1.z
+    .object({
+    key: zod_1.z.string().min(1),
+    operator: exports.FilterOperatorSchema,
+    value: zod_1.z.unknown(),
+})
+    .strict();
+exports.TableConditionRuleSchema = zod_1.z
+    .object({
+    operator: zod_1.z.enum(["eq", "neq", "gt", "lt", "gte", "lte"]),
+    value: zod_1.z.string(),
+    color: zod_1.z.string().min(1),
+    label: zod_1.z.string().optional(),
+})
+    .strict();
+exports.TableConditionSchema = zod_1.z
+    .object({
+    columnKey: zod_1.z.string().min(1),
+    type: zod_1.z.enum(["color", "badge"]),
+    rules: zod_1.z.array(exports.TableConditionRuleSchema).min(1),
+})
+    .strict();
+exports.TablePaginationSchema = zod_1.z
+    .object({
+    limit: zod_1.z.number().int().positive(),
+    offset: zod_1.z.number().int().nonnegative(),
+})
+    .strict();
+exports.TableCardConfigSchema = zod_1.z
+    .object({
+    ...BaseConfigFields,
+    mode: zod_1.z.enum(["raw", "aggregate"]),
+    columns: zod_1.z
+        .array(zod_1.z.union([zod_1.z.string().min(1), exports.TableColumnConfigSchema]))
+        .optional(),
+    groupByKey: zod_1.z.string().optional(),
+    metrics: zod_1.z.array(exports.TableMetricSchema).optional(),
+    filters: zod_1.z.array(exports.TableFilterSchema).optional(),
+    conditions: zod_1.z.array(exports.TableConditionSchema).optional(),
+    sortBy: zod_1.z.string().optional(),
+    sortOrder: zod_1.z.enum(["asc", "desc"]).optional(),
+    pagination: exports.TablePaginationSchema.optional(),
+    rowsPerPage: zod_1.z.number().int().positive().optional(),
+})
+    .strict();
+exports.FunnelStepSchema = zod_1.z
+    .object({
+    eventName: zod_1.z.string().min(1),
+    label: zod_1.z.string().optional(),
+})
+    .strict();
+exports.FunnelStepValueSchema = zod_1.z
+    .object({
+    value: zod_1.z.string().min(1),
+    label: zod_1.z.string().optional(),
+})
+    .strict();
+exports.FunnelCardConfigSchema = zod_1.z
+    .object({
+    ...BaseConfigFields,
+    funnelMode: zod_1.z.enum(["multi_event", "single_event"]),
+    layout: zod_1.z.enum(["vertical", "horizontal"]).optional(),
+    steps: zod_1.z.array(exports.FunnelStepSchema).optional(),
+    stepValues: zod_1.z.array(exports.FunnelStepValueSchema).optional(),
+})
+    .strict()
+    .superRefine((cfg, ctx) => {
+    if (cfg.funnelMode === "multi_event" && (!cfg.steps || cfg.steps.length < 2)) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "funnel.multi_event requires at least 2 steps",
+            path: ["steps"],
+        });
+    }
+    if (cfg.funnelMode === "single_event") {
+        if (!cfg.eventName) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: "funnel.single_event requires eventName",
+                path: ["eventName"],
+            });
+        }
+        if (!cfg.propertyKey) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: "funnel.single_event requires propertyKey",
+                path: ["propertyKey"],
+            });
+        }
+        if (!cfg.stepValues || cfg.stepValues.length < 2) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: "funnel.single_event requires at least 2 stepValues",
+                path: ["stepValues"],
+            });
+        }
+    }
+});
+exports.GaugeThresholdsSchema = zod_1.z
+    .object({
+    v1: zod_1.z.number(),
+    v2: zod_1.z.number(),
+})
+    .strict();
+exports.GaugeZoneColorsSchema = zod_1.z
+    .object({
+    low: zod_1.z.string().min(1),
+    mid: zod_1.z.string().min(1),
+    high: zod_1.z.string().min(1),
+})
+    .strict();
+exports.GaugeCardConfigSchema = zod_1.z
+    .object({
+    ...BaseConfigFields,
+    min: zod_1.z.number(),
+    max: zod_1.z.number(),
+    target: zod_1.z.number().optional(),
+    thresholds: exports.GaugeThresholdsSchema,
+    zoneColors: exports.GaugeZoneColorsSchema.optional(),
+    unit: zod_1.z.string().optional(),
+})
+    .strict()
+    .superRefine((cfg, ctx) => {
+    if (cfg.min >= cfg.max) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "gauge.min must be strictly less than gauge.max",
+            path: ["min"],
+        });
+    }
+    if (cfg.thresholds.v1 > cfg.thresholds.v2) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "thresholds.v1 must be <= thresholds.v2",
+            path: ["thresholds", "v1"],
+        });
+    }
+});
+// -----------------------------------------------------------------------------
+// Grid layout
+// -----------------------------------------------------------------------------
+exports.GridLayoutItemSchema = zod_1.z
+    .object({
+    x: zod_1.z.number().int().nonnegative(),
+    y: zod_1.z.number().int().nonnegative(),
+    w: zod_1.z.number().int().positive(),
+    h: zod_1.z.number().int().positive(),
+})
+    .strict();
+/** Returns a schema that enforces both the geometry AND the per-cardType constraints. */
+function gridLayoutForCardType(cardType) {
+    return exports.GridLayoutItemSchema.superRefine((layout, ctx) => {
+        const res = (0, dashboard_cards_1.isValidGridLayout)(cardType, layout);
+        if (!res.ok) {
+            ctx.addIssue({
+                code: zod_1.z.ZodIssueCode.custom,
+                message: res.reason,
+            });
+        }
+    });
+}
+// -----------------------------------------------------------------------------
+// DashboardCard — discriminated union on cardType
+// -----------------------------------------------------------------------------
+function cardSchema(cardType, configSchema) {
+    return zod_1.z
+        .object({
+        cardType: zod_1.z.literal(cardType),
+        title: zod_1.z.string().min(1),
+        config: configSchema,
+        tabId: zod_1.z.string().nullable().optional(),
+        gridLayout: gridLayoutForCardType(cardType).optional(),
+        sortOrder: zod_1.z.number().int().nonnegative().optional(),
+    })
+        .strict();
+}
+const numberCard = cardSchema("number", exports.BaseCardConfigSchema);
+const rateCard = cardSchema("rate", exports.BaseCardConfigSchema);
+const lineCard = cardSchema("line", exports.BaseCardConfigSchema);
+const barCard = cardSchema("bar", exports.BaseCardConfigSchema);
+const pieCard = cardSchema("pie", exports.BaseCardConfigSchema);
+const tableCard = cardSchema("table", exports.TableCardConfigSchema);
+const funnelCard = cardSchema("funnel", exports.FunnelCardConfigSchema);
+const gaugeCard = cardSchema("gauge", exports.GaugeCardConfigSchema);
+/** Discriminated union over `cardType`. */
+exports.DashboardCardInputSchema = zod_1.z.discriminatedUnion("cardType", [
+    numberCard,
+    rateCard,
+    lineCard,
+    barCard,
+    pieCard,
+    tableCard,
+    funnelCard,
+    gaugeCard,
+]);
+// -----------------------------------------------------------------------------
+// Tabs + reorder + CLI metrics.json
+// -----------------------------------------------------------------------------
+exports.DashboardTabInputSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1).max(80),
+    sortOrder: zod_1.z.number().int().nonnegative().optional(),
+})
+    .strict();
+exports.ReorderCardsInputSchema = zod_1.z
+    .object({
+    cards: zod_1.z
+        .array(zod_1.z
+        .object({
+        id: zod_1.z.string().min(1),
+        sortOrder: zod_1.z.number().int().nonnegative(),
+        gridLayout: exports.GridLayoutItemSchema.optional(),
+        tabId: zod_1.z.string().nullable().optional(),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+exports.ReorderTabsInputSchema = zod_1.z
+    .object({
+    tabs: zod_1.z
+        .array(zod_1.z
+        .object({
+        id: zod_1.z.string().min(1),
+        sortOrder: zod_1.z.number().int().nonnegative(),
+    })
+        .strict())
+        .min(1),
+})
+    .strict();
+/** Shape used by `rf metrics sync` / `pull`. The card's `tab` is the tab *name*. */
+exports.MetricsFileSchema = zod_1.z
+    .object({
+    tabs: zod_1.z.array(exports.DashboardTabInputSchema).optional(),
+    cards: zod_1.z.array(exports.DashboardCardInputSchema.and(zod_1.z
+        .object({
+        tab: zod_1.z.string().optional(),
+    })
+        .strict())),
+})
+    .strict();

package/dist/_runflow-shared/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./dashboard-cards";
+export * from "./dashboard-cards.normalize";
+export * from "./dashboard-cards.zod";

package/dist/_runflow-shared/types/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dashboard-cards"), exports);
+__exportStar(require("./dashboard-cards.normalize"), exports);
+__exportStar(require("./dashboard-cards.zod"), exports);

package/dist/_runflow-shared/utils/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/_runflow-shared/utils/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -7,8 +7,8 @@ export type { ScheduleCreateConfig, ScheduleUpdateConfig, ScheduleResponse, } fr
 export { connector, createConnectorTool, loadConnector } from "./connectors";
 export type { ConnectorParameters, ConnectorParameter, ConnectorToolOptions, ConnectorExecutionOptions, } from "./connectors";
 export { Workflow, WorkflowBuilder, createWorkflow, createStep, createAgentStep, createFunctionStep, createConnectorStep, FlowBuilder, flow, } from "./workflows";
-export { identify, detectIdentityType, startExecution, createExecutionContext, log, logEvent, logError, startSpan, configureLogging, createSpan, withSpan, track, flushTrackEvents, } from "./observability";
-export type { IdentifyConfig, ExecutionConfig, ExecutionController, ExecutionContextConfig, ExecutionContextEndOptions, LogData, LogOptions, SpanHandle, LoggingConfig, TrackOptions, } from "./observability";
+export { identify, detectIdentityType, startExecution, createExecutionContext, log, logEvent, logError, startSpan, configureLogging, message, createSpan, withSpan, track, flushTrackEvents, metrics, MetricsRegistry, } from "./observability";
+export type { IdentifyConfig, ExecutionConfig, ExecutionController, ExecutionContextConfig, ExecutionContextEndOptions, LogData, LogOptions, SpanHandle, LoggingConfig, MessageData, TrackOptions, } from "./observability";
 export { RunflowTraceCollector, RunflowTraceSpan, createTraceCollector, traced, } from "./observability";
 export type { AgentConfig, AgentInput, AgentOutput, AgentContext, ModelProvider, RunflowTool, ToolConfig, ToolContext, WorkflowConfig, WorkflowStep, WorkflowContext, WorkflowExecution, FlowContext, AgentStepResult, StepHandler, StepOpts, BranchOpts, SwitchOpts, SwitchStepConfig, ForeachStepConfig, WorkflowGraph, GraphNode, GraphEdge, WorkflowEvents, MemoryConfig, MemoryData, MemoryMessage, SearchResult, RerankConfig, RerankStrategy, StreamingConfig, ChatStreamChunk, TraceData, TraceMetadata, TraceCosts, TraceCollector, TraceSpan, EventData, EventsRequest, EventsResponse, RunflowAPIClient, ChatRequest, ChatResponse, VectorSearchOptions, VectorSearchResponse, RPAConfig, ExecutionContext, } from "./types";
 export { createBrowserTool, BrowserSession, login, fillForm, clickButton, waitAndClick, extractTable, extractText, downloadFile, screenshotPage, waitForResponse, } from './rpa';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,8 +4,8 @@
 // Version: 1.1.7 - URL-encode memoryId in runtime memory calls (fixes memory not saving when identify value contains @, +, etc.)
 // ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fillForm = exports.login = exports.BrowserSession = exports.createBrowserTool = exports.traced = exports.createTraceCollector = exports.RunflowTraceSpan = exports.RunflowTraceCollector = exports.flushTrackEvents = exports.track = exports.withSpan = exports.createSpan = exports.configureLogging = exports.startSpan = exports.logError = exports.logEvent = exports.log = exports.createExecutionContext = exports.startExecution = exports.detectIdentityType = exports.identify = exports.flow = exports.FlowBuilder = exports.createConnectorStep = exports.createFunctionStep = exports.createAgentStep = exports.createStep = exports.createWorkflow = exports.WorkflowBuilder = exports.Workflow = exports.loadConnector = exports.createConnectorTool = exports.connector = exports.createScheduleTools = exports.schedule = exports.createWebSearchTool = exports.webSearch = exports.createTool = exports.init = exports.Runflow = exports.RunflowAPIClientImpl = exports.createRunflowAPIClient = exports.custom = exports.xai = exports.gemini = exports.groq = exports.bedrock = exports.anthropic = exports.openai = exports.Agent = void 0;
-exports.SENSITIVE_TOKENS_COMPOUND = exports.SENSITIVE_TOKENS_ALWAYS = exports.DEFAULT_SENSITIVE_FIELDS = exports.getAllPatterns = exports.getPatterns = exports.composeTraceInterceptors = exports.buildPrivacyInterceptor = exports.createPIISanitizer = exports.PIISanitizer = exports.FileMemoryProvider = exports.RunflowMemoryProvider = exports.Media = exports.transcribe = exports.LLM = exports.getCredential = exports.Credentials = exports.isPromptRef = exports.loadPrompt = exports.Prompts = exports.RAG = exports.Knowledge = exports.Memory = exports.waitForResponse = exports.screenshotPage = exports.downloadFile = exports.extractText = exports.extractTable = exports.waitAndClick = exports.clickButton = void 0;
+exports.createBrowserTool = exports.traced = exports.createTraceCollector = exports.RunflowTraceSpan = exports.RunflowTraceCollector = exports.MetricsRegistry = exports.metrics = exports.flushTrackEvents = exports.track = exports.withSpan = exports.createSpan = exports.message = exports.configureLogging = exports.startSpan = exports.logError = exports.logEvent = exports.log = exports.createExecutionContext = exports.startExecution = exports.detectIdentityType = exports.identify = exports.flow = exports.FlowBuilder = exports.createConnectorStep = exports.createFunctionStep = exports.createAgentStep = exports.createStep = exports.createWorkflow = exports.WorkflowBuilder = exports.Workflow = exports.loadConnector = exports.createConnectorTool = exports.connector = exports.createScheduleTools = exports.schedule = exports.createWebSearchTool = exports.webSearch = exports.createTool = exports.init = exports.Runflow = exports.RunflowAPIClientImpl = exports.createRunflowAPIClient = exports.custom = exports.xai = exports.gemini = exports.groq = exports.bedrock = exports.anthropic = exports.openai = exports.Agent = void 0;
+exports.SENSITIVE_TOKENS_COMPOUND = exports.SENSITIVE_TOKENS_ALWAYS = exports.DEFAULT_SENSITIVE_FIELDS = exports.getAllPatterns = exports.getPatterns = exports.composeTraceInterceptors = exports.buildPrivacyInterceptor = exports.createPIISanitizer = exports.PIISanitizer = exports.FileMemoryProvider = exports.RunflowMemoryProvider = exports.Media = exports.transcribe = exports.LLM = exports.getCredential = exports.Credentials = exports.isPromptRef = exports.loadPrompt = exports.Prompts = exports.RAG = exports.Knowledge = exports.Memory = exports.waitForResponse = exports.screenshotPage = exports.downloadFile = exports.extractText = exports.extractTable = exports.waitAndClick = exports.clickButton = exports.fillForm = exports.login = exports.BrowserSession = void 0;
 // Core (Agent + Models + API Client + Context)
 var core_1 = require("./core");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return core_1.Agent; } });
@@ -58,10 +58,13 @@ Object.defineProperty(exports, "logEvent", { enumerable: true, get: function ()
 Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return observability_1.logError; } });
 Object.defineProperty(exports, "startSpan", { enumerable: true, get: function () { return observability_1.startSpan; } });
 Object.defineProperty(exports, "configureLogging", { enumerable: true, get: function () { return observability_1.configureLogging; } });
+Object.defineProperty(exports, "message", { enumerable: true, get: function () { return observability_1.message; } });
 Object.defineProperty(exports, "createSpan", { enumerable: true, get: function () { return observability_1.createSpan; } });
 Object.defineProperty(exports, "withSpan", { enumerable: true, get: function () { return observability_1.withSpan; } });
 Object.defineProperty(exports, "track", { enumerable: true, get: function () { return observability_1.track; } });
 Object.defineProperty(exports, "flushTrackEvents", { enumerable: true, get: function () { return observability_1.flushTrackEvents; } });
+Object.defineProperty(exports, "metrics", { enumerable: true, get: function () { return observability_1.metrics; } });
+Object.defineProperty(exports, "MetricsRegistry", { enumerable: true, get: function () { return observability_1.MetricsRegistry; } });
 // Observability (advanced tracing)
 var observability_2 = require("./observability");
 Object.defineProperty(exports, "RunflowTraceCollector", { enumerable: true, get: function () { return observability_2.RunflowTraceCollector; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/observability/index.d.ts

@@ -4,10 +4,11 @@ export { startExecution } from './execution';
 export type { ExecutionConfig, ExecutionController } from './execution';
 export { createExecutionContext } from './execution-context';
 export type { ExecutionContext, ExecutionContextConfig, ExecutionContextEndOptions } from './execution-context';
-export { log, logEvent, logError, startSpan, configureLogging } from './logging';
-export type { LogData, LogOptions, SpanHandle, LoggingConfig } from './logging';
+export { log, logEvent, logError, startSpan, configureLogging, message } from './logging';
+export type { LogData, LogOptions, SpanHandle, LoggingConfig, MessageData } from './logging';
 export { track, flushTrackEvents } from './tracking';
 export type { TrackOptions } from './tracking';
+export { metrics, MetricsRegistry } from './metrics';
 export { createSpan, withSpan } from './helpers';
 export { RunflowTraceCollector, RunflowTraceSpan, createTraceCollector, traced, } from './trace-collector';
 export type { TraceData, TraceMetadata, TraceCosts, TraceCollector, TraceSpan } from '../types';

package/dist/observability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGhH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACjF,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGhF,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,GACP,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAGhH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1F,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG7F,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,MAAM,GACP,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EACd,SAAS,EACV,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/observability/index.js

@@ -3,7 +3,7 @@
 // OBSERVABILITY API - Public Exports
 // ============================================================================
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Runflow = exports.traced = exports.createTraceCollector = exports.RunflowTraceSpan = exports.RunflowTraceCollector = exports.withSpan = exports.createSpan = exports.flushTrackEvents = exports.track = exports.configureLogging = exports.startSpan = exports.logError = exports.logEvent = exports.log = exports.createExecutionContext = exports.startExecution = exports.detectIdentityType = exports.identify = void 0;
+exports.Runflow = exports.traced = exports.createTraceCollector = exports.RunflowTraceSpan = exports.RunflowTraceCollector = exports.withSpan = exports.createSpan = exports.MetricsRegistry = exports.metrics = exports.flushTrackEvents = exports.track = exports.message = exports.configureLogging = exports.startSpan = exports.logError = exports.logEvent = exports.log = exports.createExecutionContext = exports.startExecution = exports.detectIdentityType = exports.identify = void 0;
 // Identification (smart identify with auto-detection)
 var identify_1 = require("./identify");
 Object.defineProperty(exports, "identify", { enumerable: true, get: function () { return identify_1.identify; } });
@@ -21,10 +21,15 @@ Object.defineProperty(exports, "logEvent", { enumerable: true, get: function ()
 Object.defineProperty(exports, "logError", { enumerable: true, get: function () { return logging_1.logError; } });
 Object.defineProperty(exports, "startSpan", { enumerable: true, get: function () { return logging_1.startSpan; } });
 Object.defineProperty(exports, "configureLogging", { enumerable: true, get: function () { return logging_1.configureLogging; } });
+Object.defineProperty(exports, "message", { enumerable: true, get: function () { return logging_1.message; } });
 // Business Events Tracking
 var tracking_1 = require("./tracking");
 Object.defineProperty(exports, "track", { enumerable: true, get: function () { return tracking_1.track; } });
 Object.defineProperty(exports, "flushTrackEvents", { enumerable: true, get: function () { return tracking_1.flushTrackEvents; } });
+// Code-first Metrics (dashboard tabs + cards + layout)
+var metrics_1 = require("./metrics");
+Object.defineProperty(exports, "metrics", { enumerable: true, get: function () { return metrics_1.metrics; } });
+Object.defineProperty(exports, "MetricsRegistry", { enumerable: true, get: function () { return metrics_1.MetricsRegistry; } });
 // Span Helpers
 var helpers_1 = require("./helpers");
 Object.defineProperty(exports, "createSpan", { enumerable: true, get: function () { return helpers_1.createSpan; } });

package/dist/observability/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;;;AAE/E,sDAAsD;AACtD,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAGrC,0CAA0C;AAC1C,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAGvB,wCAAwC;AACxC,yDAA6D;AAApD,2HAAA,sBAAsB,OAAA;AAG/B,iBAAiB;AACjB,qCAAiF;AAAxE,8FAAA,GAAG,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAG7D,2BAA2B;AAC3B,uCAAqD;AAA5C,iGAAA,KAAK,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAGhC,eAAe;AACf,qCAAiD;AAAxC,qGAAA,UAAU,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAE7B,8CAA8C;AAC9C,qDAK2B;AAJzB,wHAAA,qBAAqB,OAAA;AACrB,mHAAA,gBAAgB,OAAA;AAChB,uHAAA,oBAAoB,OAAA;AACpB,yGAAA,MAAM,OAAA;AAYR,uDAAuD;AACvD,2CAA0C;AAAjC,kGAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;;;AAE/E,sDAAsD;AACtD,uCAA0D;AAAjD,oGAAA,QAAQ,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAGrC,0CAA0C;AAC1C,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAGvB,wCAAwC;AACxC,yDAA6D;AAApD,2HAAA,sBAAsB,OAAA;AAG/B,iBAAiB;AACjB,qCAA0F;AAAjF,8FAAA,GAAG,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,kGAAA,OAAO,OAAA;AAGtE,2BAA2B;AAC3B,uCAAqD;AAA5C,iGAAA,KAAK,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AAGhC,uDAAuD;AACvD,qCAAqD;AAA5C,kGAAA,OAAO,OAAA;AAAE,0GAAA,eAAe,OAAA;AAEjC,eAAe;AACf,qCAAiD;AAAxC,qGAAA,UAAU,OAAA;AAAE,mGAAA,QAAQ,OAAA;AAE7B,8CAA8C;AAC9C,qDAK2B;AAJzB,wHAAA,qBAAqB,OAAA;AACrB,mHAAA,gBAAgB,OAAA;AAChB,uHAAA,oBAAoB,OAAA;AACpB,yGAAA,MAAM,OAAA;AAYR,uDAAuD;AACvD,2CAA0C;AAAjC,kGAAA,OAAO,OAAA"}

package/dist/observability/logging.d.ts

@@ -24,6 +24,12 @@ export interface SpanHandle {
         error?: string;
     }) => void;
 }
+export interface MessageData {
+    role: "user" | "assistant" | "system" | "tool" | string;
+    content: string | Record<string, any>;
+    metadata?: Record<string, any>;
+    parentId?: string;
+}
 export interface LoggingConfig {
     onTrace?: (trace: TraceData) => TraceData | null | void;
     /** PII sanitization for custom logs. Same formats as Agent privacy config. */
@@ -55,6 +61,35 @@ export declare function log(name: string, data?: any, options?: LogOptions): voi
  * });
  */
 export declare function logEvent(name: string, data: LogData, options?: LogOptions): void;
+/**
+ * Record a conversation message (user, assistant, system, tool, or any custom role).
+ *
+ * Emits a `conversation_message` trace that the Runflow portal renders as a chat
+ * bubble. Multiple calls per execution are expected (one user inbound, N assistant
+ * outbounds, etc.). The portal switches to chat view when an execution has at least
+ * one of these traces.
+ *
+ * @example
+ * // text exchange
+ * message({ role: 'user', content: 'Quais acomodações?' });
+ * message({ role: 'assistant', content: 'Oferecemos duas opções...' });
+ *
+ * @example
+ * // structured content (buttons, audio, image, template)
+ * message({
+ *   role: 'assistant',
+ *   content: { type: 'buttons', text: 'O que deseja?', items: [...] },
+ * });
+ *
+ * @example
+ * // grouped under a span
+ * const turn = startSpan('turn');
+ * message({ role: 'user', content: text, parentId: turn.traceId });
+ * // ...work...
+ * message({ role: 'assistant', content: reply, parentId: turn.traceId });
+ * turn.end();
+ */
+export declare function message(data: MessageData, options?: LogOptions): void;
 /**
  * Log an error
  *

package/dist/observability/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/observability/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAkB,SAAS,EAAE,MAAM,UAAU,CAAC;AAOrD,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IACxD,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7D;AA8ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAmExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAEN;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAuCN;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,UAAU,CAqDZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAkB5D"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/observability/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAkB,SAAS,EAAE,MAAM,UAAU,CAAC;AAOrD,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACxD,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IACxD,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7D;AA8ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAmExE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CA2CrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAuCN;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,UAAU,CAqDZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAkB5D"}

package/dist/observability/logging.js

@@ -10,6 +10,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.log = log;
 exports.logEvent = logEvent;
+exports.message = message;
 exports.logError = logError;
 exports.startSpan = startSpan;
 exports.configureLogging = configureLogging;
@@ -148,6 +149,66 @@ function log(name, data, options) {
 function logEvent(name, data, options) {
     log(name, data, { parentId: options?.parentId || data.parentId });
 }
+/**
+ * Record a conversation message (user, assistant, system, tool, or any custom role).
+ *
+ * Emits a `conversation_message` trace that the Runflow portal renders as a chat
+ * bubble. Multiple calls per execution are expected (one user inbound, N assistant
+ * outbounds, etc.). The portal switches to chat view when an execution has at least
+ * one of these traces.
+ *
+ * @example
+ * // text exchange
+ * message({ role: 'user', content: 'Quais acomodações?' });
+ * message({ role: 'assistant', content: 'Oferecemos duas opções...' });
+ *
+ * @example
+ * // structured content (buttons, audio, image, template)
+ * message({
+ *   role: 'assistant',
+ *   content: { type: 'buttons', text: 'O que deseja?', items: [...] },
+ * });
+ *
+ * @example
+ * // grouped under a span
+ * const turn = startSpan('turn');
+ * message({ role: 'user', content: text, parentId: turn.traceId });
+ * // ...work...
+ * message({ role: 'assistant', content: reply, parentId: turn.traceId });
+ * turn.end();
+ */
+function message(data, options) {
+    const state = context_1.Runflow.getState();
+    const traceCollector = getTraceCollector();
+    if (!traceCollector) {
+        console.warn("⚠️ TraceCollector not available, message will not be tracked");
+        return;
+    }
+    const executionId = state.executionId || generateExecutionId();
+    const parentTraceId = options?.parentId ||
+        data.parentId ||
+        global.__runflow_current_span_id;
+    const span = traceCollector.startSpan("conversation_message", {
+        executionId,
+        operation: "conversation_message",
+        custom: {
+            ...(data.metadata || {}),
+            role: data.role,
+        },
+        threadId: state.threadId,
+        userId: state.userId,
+        sessionId: state.sessionId,
+        entityType: state.entityType,
+        entityValue: state.entityValue,
+    }, parentTraceId);
+    // role + content go into output for portal extraction
+    span?.setOutput({
+        role: data.role,
+        content: data.content,
+    });
+    span?.finish();
+    scheduleAutoFlush();
+}
 /**
  * Log an error
  *