@runflow-ai/sdk 1.1.10 → 1.1.12

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,7 +7,7 @@ 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, message, createSpan, withSpan, track, flushTrackEvents, } 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";

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.login = exports.BrowserSession = exports.createBrowserTool = exports.traced = exports.createTraceCollector = exports.RunflowTraceSpan = exports.RunflowTraceCollector = 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 = 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; } });
@@ -63,6 +63,8 @@ Object.defineProperty(exports, "createSpan", { enumerable: true, get: function (
 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

@@ -8,6 +8,7 @@ export { log, logEvent, logError, startSpan, configureLogging, message } from '.
 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,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,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.message = 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; } });
@@ -26,6 +26,10 @@ Object.defineProperty(exports, "message", { enumerable: true, get: function () {
 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,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,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/metrics.d.ts

@@ -0,0 +1,120 @@
+/**
+ * ============================================================================
+ * METRICS - Code-first dashboard definitions for Runflow
+ * ============================================================================
+ *
+ * Lets agent code declare its own dashboard tabs and cards, then sync them
+ * to the platform with `runflow.metrics.sync()` (or auto-sync on first
+ * `track()`). Mirrors the same API surface used by the CLI `rf metrics
+ * sync` command — same canonical shape, same idempotency.
+ *
+ * Quick example:
+ *
+ *   import { metrics } from '@runflow-ai/sdk/observability';
+ *
+ *   metrics.defineTab({ name: 'Vendas' });
+ *   metrics.defineCard({
+ *     tab: 'Vendas',
+ *     title: 'Funil de checkout',
+ *     cardType: 'funnel',
+ *     config: {
+ *       funnelMode: 'multi_event',
+ *       steps: [
+ *         { eventName: 'cart_open',        label: 'Carrinho aberto' },
+ *         { eventName: 'checkout_started', label: 'Início checkout' },
+ *         { eventName: 'sale',             label: 'Pagamento' },
+ *       ],
+ *     },
+ *     gridLayout: { x: 0, y: 0, w: 6, h: 5 },
+ *   });
+ *
+ *   await metrics.sync();   // POSTs to /api/v1/runtime/observability/...
+ *
+ * Validation happens at registration time using the shared zod schemas, so
+ * shape mistakes are caught before deploy. The registry is process-wide
+ * (mirrors how `track()` and `identify()` are stored).
+ */
+import { type CardType, type DashboardCardConfig, type GridLayoutItem, type DefineCardInput, type DefineTabInput } from "../_runflow-shared";
+interface RegisteredTab {
+    name: string;
+    sortOrder?: number;
+}
+interface RegisteredCard {
+    title: string;
+    cardType: CardType;
+    config: DashboardCardConfig;
+    /** Tab name — resolved to tabId at sync time. */
+    tab?: string;
+    gridLayout?: GridLayoutItem;
+    sortOrder?: number;
+}
+interface SyncResult {
+    agentId: string;
+    tabs: {
+        created: number;
+        updated: number;
+        total: number;
+    };
+    cards: {
+        created: number;
+        updated: number;
+        failed: number;
+        total: number;
+    };
+}
+interface SyncOptions {
+    /** Override the agent id (default: SDK runtime context). */
+    agentId?: string;
+    /** Override the base URL (default: SDK runtime context). */
+    baseUrl?: string;
+    /** Override the API key (default: SDK runtime context). */
+    apiKey?: string;
+    /** Throw on any validation/network error instead of returning a tally. */
+    strict?: boolean;
+}
+export declare class MetricsRegistry {
+    private tabs;
+    /** key = `${cardType}:${title}` — same dedup as the CLI uses. */
+    private cards;
+    /**
+     * Register a dashboard tab. Idempotent on `name`. Re-registering with the
+     * same name updates `sortOrder`.
+     */
+    defineTab(input: DefineTabInput): RegisteredTab;
+    /**
+     * Register a dashboard card. Throws (synchronously) if the config doesn't
+     * match the shape required by the chosen cardType. Legacy aliases are
+     * auto-normalized before validation.
+     */
+    defineCard<T extends CardType>(input: DefineCardInput<T>): RegisteredCard;
+    /** Inspect what's currently registered. Read-only. */
+    list(): {
+        tabs: RegisteredTab[];
+        cards: RegisteredCard[];
+    };
+    /** Drop everything. Mostly useful in tests. */
+    reset(): void;
+    /**
+     * Push the registered tabs and cards to the Runflow platform.
+     *
+     * Two-phase: upsert tabs first (matching by name → tabId), then upsert
+     * cards with their resolved tabId. Talks to the runtime endpoints used
+     * by the CLI:
+     *
+     *   POST /api/v1/runtime/observability/dashboard-tabs    (tabs)
+     *   POST /api/v1/runtime/observability/dashboard-cards   (cards)
+     *
+     * Per-card idempotency key = `hash(cardType + title + tab?)`. On the
+     * server, table/funnel/gauge cards (no eventName at root) dedupe via the
+     * idempotency key; KPI-shaped cards continue using the (event_name,
+     * card_type, aggregation, property_key) unique index.
+     */
+    sync(options?: SyncOptions): Promise<SyncResult>;
+}
+/**
+ * Process-wide metrics registry. `import { metrics }` returns the same
+ * instance every time, so it can be safely required from multiple modules.
+ */
+export declare const metrics: MetricsRegistry;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAML,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAMzB,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E;AAED,UAAU,WAAW;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAoC;IAChD,iEAAiE;IACjE,OAAO,CAAC,KAAK,CAAqC;IAElD;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,aAAa;IAU/C;;;;OAIG;IACH,UAAU,CAAC,CAAC,SAAS,QAAQ,EAC3B,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GACxB,cAAc;IA6DjB,sDAAsD;IACtD,IAAI,IAAI;QAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAAC,KAAK,EAAE,cAAc,EAAE,CAAA;KAAE;IAO1D,+CAA+C;IAC/C,KAAK,IAAI,IAAI;IAKb;;;;;;;;;;;;;;OAcG;IACG,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;CA6E3D;AAgFD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,eAA+B,CAAC"}