@defai.digital/contracts 13.0.3

package/dist/storage/v1/schema.d.ts

@@ -0,0 +1,411 @@
+/**
+ * Storage Contract V1 - Schemas and Port Interfaces
+ *
+ * Defines storage port interfaces following Ports & Adapters (Hexagonal Architecture).
+ * Application layers depend on these interfaces, not concrete implementations.
+ *
+ * Storage Types:
+ * - Key-Value Storage (memory)
+ * - Event Storage (event sourcing)
+ * - Trace Storage (observability)
+ * - FTS Storage (full-text search)
+ */
+import { z } from 'zod';
+/**
+ * Storage mode enum
+ */
+export declare const StorageModeSchema: z.ZodEnum<["sqlite", "memory"]>;
+export type StorageMode = z.infer<typeof StorageModeSchema>;
+/**
+ * Storage configuration
+ */
+export declare const StorageConfigSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<["sqlite", "memory"]>>;
+    dbPath: z.ZodOptional<z.ZodString>;
+    maxConnections: z.ZodOptional<z.ZodNumber>;
+    enableWAL: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    mode: "sqlite" | "memory";
+    dbPath?: string | undefined;
+    maxConnections?: number | undefined;
+    enableWAL?: boolean | undefined;
+}, {
+    mode?: "sqlite" | "memory" | undefined;
+    dbPath?: string | undefined;
+    maxConnections?: number | undefined;
+    enableWAL?: boolean | undefined;
+}>;
+export type StorageConfig = z.infer<typeof StorageConfigSchema>;
+/**
+ * Key-value entry schema
+ */
+export declare const KVEntrySchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnknown;
+    namespace: z.ZodOptional<z.ZodString>;
+    ttlMs: z.ZodOptional<z.ZodNumber>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    createdAt: string;
+    updatedAt: string;
+    key: string;
+    value?: unknown;
+    tags?: string[] | undefined;
+    namespace?: string | undefined;
+    ttlMs?: number | undefined;
+    expiresAt?: string | undefined;
+}, {
+    createdAt: string;
+    updatedAt: string;
+    key: string;
+    value?: unknown;
+    tags?: string[] | undefined;
+    namespace?: string | undefined;
+    ttlMs?: number | undefined;
+    expiresAt?: string | undefined;
+}>;
+export type KVEntry = z.infer<typeof KVEntrySchema>;
+/**
+ * Key-value search result
+ */
+export declare const KVSearchResultSchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnknown;
+    score: z.ZodOptional<z.ZodNumber>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    value?: unknown;
+    namespace?: string | undefined;
+    score?: number | undefined;
+}, {
+    key: string;
+    value?: unknown;
+    namespace?: string | undefined;
+    score?: number | undefined;
+}>;
+export type KVSearchResult = z.infer<typeof KVSearchResultSchema>;
+/**
+ * Trace summary schema (for listing traces)
+ */
+export declare const TraceSummarySchema: z.ZodObject<{
+    traceId: z.ZodString;
+    startTime: z.ZodString;
+    endTime: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["pending", "running", "success", "failure", "skipped"]>;
+    eventCount: z.ZodNumber;
+    errorCount: z.ZodNumber;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    workflowId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "pending" | "skipped" | "success" | "failure" | "running";
+    traceId: string;
+    startTime: string;
+    eventCount: number;
+    errorCount: number;
+    workflowId?: string | undefined;
+    durationMs?: number | undefined;
+    endTime?: string | undefined;
+}, {
+    status: "pending" | "skipped" | "success" | "failure" | "running";
+    traceId: string;
+    startTime: string;
+    eventCount: number;
+    errorCount: number;
+    workflowId?: string | undefined;
+    durationMs?: number | undefined;
+    endTime?: string | undefined;
+}>;
+export type TraceSummary = z.infer<typeof TraceSummarySchema>;
+/**
+ * FTS item schema (document to index)
+ */
+export declare const FTSItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    namespace: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown> | undefined;
+    namespace?: string | undefined;
+}, {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown> | undefined;
+    namespace?: string | undefined;
+}>;
+export type FTSItem = z.infer<typeof FTSItemSchema>;
+/**
+ * FTS search result
+ */
+export declare const FTSResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodString;
+    score: z.ZodNumber;
+    highlights: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    content: string;
+    score: number;
+    metadata?: Record<string, unknown> | undefined;
+    highlights?: string[] | undefined;
+}, {
+    id: string;
+    content: string;
+    score: number;
+    metadata?: Record<string, unknown> | undefined;
+    highlights?: string[] | undefined;
+}>;
+export type FTSResult = z.infer<typeof FTSResultSchema>;
+/**
+ * FTS search options
+ */
+export declare const FTSSearchOptionsSchema: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    namespace: z.ZodOptional<z.ZodString>;
+    minScore: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    namespace?: string | undefined;
+    minScore?: number | undefined;
+}, {
+    limit?: number | undefined;
+    namespace?: string | undefined;
+    offset?: number | undefined;
+    minScore?: number | undefined;
+}>;
+export type FTSSearchOptions = z.infer<typeof FTSSearchOptionsSchema>;
+/**
+ * Key-Value Storage Port Interface
+ *
+ * Generic key-value storage for memory and configuration.
+ *
+ * INV-KV-001: Keys must be unique within namespace
+ * INV-KV-002: TTL expiration is best-effort (may lag)
+ * INV-KV-003: Namespace isolation - keys in different namespaces are independent
+ */
+export interface KVStoragePort {
+    /**
+     * Store a value
+     * INV-KV-001: Overwrites existing key in same namespace
+     */
+    store(key: string, value: unknown, options?: {
+        namespace?: string;
+        ttlMs?: number;
+        tags?: string[];
+    }): Promise<void>;
+    /**
+     * Retrieve a value
+     * Returns undefined if key doesn't exist or is expired
+     */
+    retrieve(key: string, namespace?: string): Promise<unknown | undefined>;
+    /**
+     * Delete a key
+     * @returns true if key existed and was deleted
+     */
+    delete(key: string, namespace?: string): Promise<boolean>;
+    /**
+     * List keys
+     */
+    list(options?: {
+        namespace?: string;
+        prefix?: string;
+        limit?: number;
+    }): Promise<string[]>;
+    /**
+     * Search by value content or tags
+     */
+    search(query: string, options?: {
+        namespace?: string;
+        limit?: number;
+    }): Promise<KVSearchResult[]>;
+}
+/**
+ * Event Storage Port Interface
+ *
+ * Append-only event store for event sourcing.
+ *
+ * INV-EVT-001: Events are immutable after storage
+ * INV-EVT-002: Events within aggregate are strictly ordered
+ * INV-EVT-003: Event IDs are globally unique
+ */
+export interface EventStoragePort {
+    /**
+     * Append an event
+     * INV-EVT-001: Event cannot be modified after append
+     */
+    append(event: {
+        eventId: string;
+        aggregateId: string;
+        type: string;
+        timestamp: string;
+        payload: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Get events for an aggregate
+     * INV-EVT-002: Returns in order (by version/sequence)
+     */
+    getEvents(aggregateId: string, options?: {
+        fromVersion?: number;
+        toVersion?: number;
+        limit?: number;
+    }): Promise<{
+        eventId: string;
+        aggregateId: string;
+        type: string;
+        timestamp: string;
+        version: number;
+        payload: Record<string, unknown>;
+        metadata?: Record<string, unknown>;
+    }[]>;
+    /**
+     * Get events by type
+     */
+    getEventsByType(type: string, options?: {
+        fromTime?: string;
+        toTime?: string;
+        limit?: number;
+    }): Promise<{
+        eventId: string;
+        aggregateId: string;
+        type: string;
+        timestamp: string;
+        payload: Record<string, unknown>;
+    }[]>;
+}
+/**
+ * Trace Storage Port Interface
+ *
+ * Storage for execution traces and observability.
+ *
+ * INV-TR-STORE-001: Traces are append-only during execution
+ * INV-TR-STORE-002: Events within trace maintain sequence order
+ * INV-TR-STORE-003: Trace deletion removes all associated events
+ */
+export interface TraceStoragePort {
+    /**
+     * Write a trace event
+     * INV-TR-STORE-001: Appends to existing trace
+     */
+    write(event: {
+        traceId: string;
+        eventId: string;
+        type: string;
+        timestamp: string;
+        sequence?: number;
+        parentEventId?: string;
+        payload?: Record<string, unknown>;
+        status?: string;
+        durationMs?: number;
+    }): Promise<void>;
+    /**
+     * Flush pending writes
+     */
+    flush(): Promise<void>;
+    /**
+     * Get all events for a trace
+     * INV-TR-STORE-002: Returns in sequence order
+     */
+    getTrace(traceId: string): Promise<{
+        traceId: string;
+        eventId: string;
+        type: string;
+        timestamp: string;
+        sequence?: number;
+        parentEventId?: string;
+        payload?: Record<string, unknown>;
+        status?: string;
+        durationMs?: number;
+    }[]>;
+    /**
+     * Get a specific event
+     */
+    getEvent(traceId: string, eventId: string): Promise<{
+        traceId: string;
+        eventId: string;
+        type: string;
+        timestamp: string;
+        payload?: Record<string, unknown>;
+    } | undefined>;
+    /**
+     * List trace summaries
+     */
+    listTraces(limit?: number): Promise<TraceSummary[]>;
+    /**
+     * Delete a trace
+     * INV-TR-STORE-003: Removes all events
+     * @returns true if trace existed
+     */
+    deleteTrace(traceId: string): Promise<boolean>;
+}
+/**
+ * FTS (Full-Text Search) Storage Port Interface
+ *
+ * Full-text search for content discovery.
+ *
+ * INV-FTS-001: Index updates are eventually consistent
+ * INV-FTS-002: Search results are ranked by relevance score
+ * INV-FTS-003: Namespace isolation for multi-tenant search
+ */
+export interface FTSStoragePort {
+    /**
+     * Index a document
+     */
+    index(item: FTSItem): Promise<void>;
+    /**
+     * Search indexed documents
+     * INV-FTS-002: Results ordered by score (descending)
+     */
+    search(query: string, options?: FTSSearchOptions): Promise<FTSResult[]>;
+    /**
+     * Delete a document from index
+     * @returns true if document existed
+     */
+    delete(id: string, namespace?: string): Promise<boolean>;
+    /**
+     * Clear all documents in a namespace
+     */
+    clear(namespace?: string): Promise<number>;
+}
+/**
+ * Validate storage configuration
+ */
+export declare function validateStorageConfig(data: unknown): StorageConfig;
+/**
+ * Safe validate storage configuration
+ */
+export declare function safeValidateStorageConfig(data: unknown): z.SafeParseReturnType<unknown, StorageConfig>;
+/**
+ * Validate KV entry
+ */
+export declare function validateKVEntry(data: unknown): KVEntry;
+/**
+ * Validate FTS item
+ */
+export declare function validateFTSItem(data: unknown): FTSItem;
+/**
+ * Validate trace summary
+ */
+export declare function validateTraceSummary(data: unknown): TraceSummary;
+/**
+ * Create default storage configuration
+ */
+export declare function createDefaultStorageConfig(): StorageConfig;
+/**
+ * Create a KV entry
+ */
+export declare function createKVEntry(key: string, value: unknown, options?: {
+    namespace?: string;
+    ttlMs?: number;
+    tags?: string[];
+}): KVEntry;
+//# sourceMappingURL=schema.d.ts.map

package/dist/storage/v1/schema.d.ts.map

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

package/dist/storage/v1/schema.js

@@ -0,0 +1,167 @@
+/**
+ * Storage Contract V1 - Schemas and Port Interfaces
+ *
+ * Defines storage port interfaces following Ports & Adapters (Hexagonal Architecture).
+ * Application layers depend on these interfaces, not concrete implementations.
+ *
+ * Storage Types:
+ * - Key-Value Storage (memory)
+ * - Event Storage (event sourcing)
+ * - Trace Storage (observability)
+ * - FTS Storage (full-text search)
+ */
+import { z } from 'zod';
+// ============================================================================
+// Storage Mode Configuration
+// ============================================================================
+/**
+ * Storage mode enum
+ */
+export const StorageModeSchema = z.enum(['sqlite', 'memory']);
+/**
+ * Storage configuration
+ */
+export const StorageConfigSchema = z.object({
+    mode: StorageModeSchema.default('sqlite'),
+    dbPath: z.string().optional(),
+    maxConnections: z.number().int().min(1).max(100).optional(),
+    enableWAL: z.boolean().optional(),
+});
+// ============================================================================
+// Key-Value Storage Schemas
+// ============================================================================
+/**
+ * Key-value entry schema
+ */
+export const KVEntrySchema = z.object({
+    key: z.string().min(1).max(512),
+    value: z.unknown(),
+    namespace: z.string().max(128).optional(),
+    ttlMs: z.number().int().min(0).optional(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    expiresAt: z.string().datetime().optional(),
+    tags: z.array(z.string().max(64)).max(20).optional(),
+});
+/**
+ * Key-value search result
+ */
+export const KVSearchResultSchema = z.object({
+    key: z.string(),
+    value: z.unknown(),
+    score: z.number().min(0).max(1).optional(),
+    namespace: z.string().optional(),
+});
+// ============================================================================
+// Trace Storage Schemas
+// ============================================================================
+/**
+ * Trace summary schema (for listing traces)
+ */
+export const TraceSummarySchema = z.object({
+    traceId: z.string().uuid(),
+    startTime: z.string().datetime(),
+    endTime: z.string().datetime().optional(),
+    status: z.enum(['pending', 'running', 'success', 'failure', 'skipped']),
+    eventCount: z.number().int().min(0),
+    errorCount: z.number().int().min(0),
+    durationMs: z.number().int().min(0).optional(),
+    workflowId: z.string().optional(),
+});
+// ============================================================================
+// FTS (Full-Text Search) Storage Schemas
+// ============================================================================
+/**
+ * FTS item schema (document to index)
+ */
+export const FTSItemSchema = z.object({
+    id: z.string().min(1).max(256),
+    content: z.string(),
+    metadata: z.record(z.unknown()).optional(),
+    namespace: z.string().max(128).optional(),
+});
+/**
+ * FTS search result
+ */
+export const FTSResultSchema = z.object({
+    id: z.string(),
+    content: z.string(),
+    score: z.number().min(0),
+    highlights: z.array(z.string()).optional(),
+    metadata: z.record(z.unknown()).optional(),
+});
+/**
+ * FTS search options
+ */
+export const FTSSearchOptionsSchema = z.object({
+    limit: z.number().int().min(1).max(1000).default(10),
+    offset: z.number().int().min(0).default(0),
+    namespace: z.string().optional(),
+    minScore: z.number().min(0).max(1).optional(),
+});
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Validate storage configuration
+ */
+export function validateStorageConfig(data) {
+    return StorageConfigSchema.parse(data);
+}
+/**
+ * Safe validate storage configuration
+ */
+export function safeValidateStorageConfig(data) {
+    return StorageConfigSchema.safeParse(data);
+}
+/**
+ * Validate KV entry
+ */
+export function validateKVEntry(data) {
+    return KVEntrySchema.parse(data);
+}
+/**
+ * Validate FTS item
+ */
+export function validateFTSItem(data) {
+    return FTSItemSchema.parse(data);
+}
+/**
+ * Validate trace summary
+ */
+export function validateTraceSummary(data) {
+    return TraceSummarySchema.parse(data);
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Create default storage configuration
+ */
+export function createDefaultStorageConfig() {
+    return {
+        mode: 'sqlite',
+        dbPath: undefined,
+        maxConnections: undefined,
+        enableWAL: undefined,
+    };
+}
+/**
+ * Create a KV entry
+ */
+export function createKVEntry(key, value, options) {
+    const now = new Date().toISOString();
+    return {
+        key,
+        value,
+        namespace: options?.namespace,
+        ttlMs: options?.ttlMs,
+        createdAt: now,
+        updatedAt: now,
+        expiresAt: options?.ttlMs
+            ? new Date(Date.now() + options.ttlMs).toISOString()
+            : undefined,
+        tags: options?.tags,
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/storage/v1/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/v1/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAG9D;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC3D,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACvE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AA2NH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,IAAa;IAEb,OAAO,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,SAAS;QACjB,cAAc,EAAE,SAAS;QACzB,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,KAAc,EACd,OAIC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,GAAG;QACH,KAAK;QACL,SAAS,EAAE,OAAO,EAAE,SAAS;QAC7B,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,OAAO,EAAE,KAAK;YACvB,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE;YACpD,CAAC,CAAC,SAAS;QACb,IAAI,EAAE,OAAO,EAAE,IAAI;KACpB,CAAC;AACJ,CAAC"}

package/dist/telemetry/v1/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Telemetry Contracts v1
+ */
+export { MetricTypeSchema, MetricUnitSchema, MetricCategorySchema, HistogramBucketsSchema, SummaryPercentilesSchema, MetricLabelsSchema, MetricDefinitionSchema, MetricDataPointSchema, RecordMetricRequestSchema, IncrementCounterRequestSchema, RecordHistogramRequestSchema, StartTimerRequestSchema, TimerHandleSchema, AggregationFunctionSchema, TimeRangeSchema, QueryMetricsRequestSchema, QueryMetricsResultSchema, TelemetrySummaryRequestSchema, CategorySummarySchema, TelemetrySummaryResultSchema, SystemMetrics, AgentMetrics, WorkflowMetrics, ProviderMetrics, TelemetryErrorCode, validateMetricDefinition, validateRecordMetricRequest, validateQueryMetricsRequest, safeValidateRecordMetricRequest, type MetricType, type MetricUnit, type MetricCategory, type HistogramBuckets, type SummaryPercentiles, type MetricLabels, type MetricDefinition, type MetricDataPoint, type RecordMetricRequest, type IncrementCounterRequest, type RecordHistogramRequest, type StartTimerRequest, type TimerHandle, type AggregationFunction, type TimeRange, type QueryMetricsRequest, type QueryMetricsResult, type TelemetrySummaryRequest, type CategorySummary, type TelemetrySummaryResult, } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/v1/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,EACb,YAAY,EACZ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,EAC/B,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC"}

package/dist/telemetry/v1/index.js

@@ -0,0 +1,5 @@
+/**
+ * Telemetry Contracts v1
+ */
+export { MetricTypeSchema, MetricUnitSchema, MetricCategorySchema, HistogramBucketsSchema, SummaryPercentilesSchema, MetricLabelsSchema, MetricDefinitionSchema, MetricDataPointSchema, RecordMetricRequestSchema, IncrementCounterRequestSchema, RecordHistogramRequestSchema, StartTimerRequestSchema, TimerHandleSchema, AggregationFunctionSchema, TimeRangeSchema, QueryMetricsRequestSchema, QueryMetricsResultSchema, TelemetrySummaryRequestSchema, CategorySummarySchema, TelemetrySummaryResultSchema, SystemMetrics, AgentMetrics, WorkflowMetrics, ProviderMetrics, TelemetryErrorCode, validateMetricDefinition, validateRecordMetricRequest, validateQueryMetricsRequest, safeValidateRecordMetricRequest, } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/v1/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,EACvB,iBAAiB,EACjB,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,aAAa,EACb,YAAY,EACZ,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,+BAA+B,GAqBhC,MAAM,aAAa,CAAC"}