@smoothbricks/lmao 0.1.0

package/dist/lib/opContext/featureFlagTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureFlagTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/featureFlagTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAMhE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACjE;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,CAAC,EAAE,SAAS,iBAAiB,IAAI;IAC5D,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,GAC1E;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;KAAE,GAAG,SAAS,GAC3G,EAAE,CAAC,CAAC,CAAC,SAAS,qBAAqB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,GACnD;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;KAAE,GAAG,SAAS,GAC3G,KAAK;CACZ,GAAG;IACF,mFAAmF;IACnF,GAAG,CACD,IAAI,EAAE,MAAM,GACX,OAAO,CACR;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,cAAc,CAAC,SAAS,CAAC,CAAA;KAAE,GAAG,SAAS,CAClH,CAAC;CACH,CAAC"}

package/dist/lib/opContext/featureFlagTypes.js

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

package/dist/lib/opContext/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Op-Centric API - Module Index
+ *
+ * Re-exports all types and implementation functions for the Op-centric API.
+ * Consumers should import from this file for a single entry point.
+ *
+ * @module opContext
+ */
+export { createOpGroup } from './createOpGroup.js';
+export { createDefineOp, createDefineOps, createOpMetadata, DEFAULT_METADATA } from './defineOp.js';
+export * from './opGroupTypes.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/opContext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEpG,cAAc,mBAAmB,CAAC;AAElC,cAAc,YAAY,CAAC"}

package/dist/lib/opContext/index.js

@@ -0,0 +1,15 @@
+/**
+ * Op-Centric API - Module Index
+ *
+ * Re-exports all types and implementation functions for the Op-centric API.
+ * Consumers should import from this file for a single entry point.
+ *
+ * @module opContext
+ */
+// Re-export implementation functions
+export { createOpGroup } from './createOpGroup.js';
+export { createDefineOp, createDefineOps, createOpMetadata, DEFAULT_METADATA } from './defineOp.js';
+// Re-export OpGroup types and helpers
+export * from './opGroupTypes.js';
+// Re-export all types from the hub
+export * from './types.js';

package/dist/lib/opContext/opGroupTypes.d.ts

@@ -0,0 +1,250 @@
+/**
+ * OpGroup Types
+ *
+ * Type definitions for OpGroups - collections of Ops that can be mapped
+ * and wired as dependencies. These types enable:
+ * - Column mapping (prefix, rename, drop)
+ * - Schema contribution tracking
+ * - Type-safe dependency resolution
+ *
+ * Public interfaces (OpGroup, MappedOpGroup) hide internal properties from
+ * intellisense - users only see ops and methods they need.
+ * Internal interfaces (OpGroupInternal, MappedOpGroupInternal) expose all
+ * properties for library implementation.
+ *
+ * @module opContext/opGroupTypes
+ */
+import type { Op } from '../op.js';
+import type { LogSchema } from '../schema/LogSchema.js';
+import type { SchemaFields } from '../schema/types.js';
+import type { OpContext } from './types.js';
+/**
+ * Column mapping for wiring OpGroups.
+ *
+ * Maps the library's column names to the app's column names:
+ * - `string` → map to that column name (must be type-compatible)
+ * - `null` → drop the column (library writes are ignored)
+ *
+ * @example
+ * ```typescript
+ * // Map query to shared column, rows to prefixed, drop internal column
+ * { query: 'query', rows: 'pg_rows', _internal: null }
+ * ```
+ */
+export type ColumnMapping<LibSchema extends SchemaFields = SchemaFields> = {
+    [K in keyof LibSchema]?: string | null;
+};
+/**
+ * Apply a prefix to all schema field names.
+ * `{ status: S.number() }` with prefix 'http' → `{ http_status: S.number() }`
+ */
+export type PrefixedSchema<T extends SchemaFields, P extends string> = {
+    [K in keyof T as `${P}_${K & string}`]: T[K];
+};
+/**
+ * Extract the schema fields from a LogSchema
+ */
+export type SchemaFieldsOf<T> = T extends LogSchema<infer Fields> ? Fields : never;
+/**
+ * Apply column mapping to schema.
+ * - Mapped columns get new names
+ * - Columns mapped to null are dropped
+ * - Unmapped columns keep original names (with prefix if using prefix())
+ */
+export type MappedSchema<T extends SchemaFields, M extends ColumnMapping<T>> = {
+    [K in keyof T as M[K] extends string ? M[K] : M[K] extends null ? never : K]: T[K];
+};
+/**
+ * Reserved names that cannot be used as op names.
+ * These conflict with OpGroup methods or internal properties.
+ */
+export declare const RESERVED_OP_NAMES: readonly ["prefix", "mapColumns"];
+/**
+ * Validate that an op name is allowed.
+ * Throws if the name is reserved or starts with underscore.
+ *
+ * @param name - The op name to validate
+ * @throws Error if name is invalid
+ */
+export declare function validateOpName(name: string): void;
+export type OpGroupOps<Ctx extends OpContext> = Record<string, Op<Ctx, unknown[], unknown, unknown>>;
+type NoOpMembers = Record<never, never>;
+/**
+ * A group of Ops that can be mapped and wired as a dependency.
+ *
+ * Created by defineOps() - represents a library's exported operations.
+ * Libraries declare their schema but don't know how the app will wire them.
+ *
+ * Note: Ops are accessed directly as properties (`.opName` not `.ops.opName`)
+ * for V8 hidden class optimization and cleaner API ergonomics.
+ *
+ * Internal properties (_logSchema, _flags) are hidden from intellisense
+ * but accessible at runtime for library implementation.
+ */
+interface OpGroupMethods<Ctx extends OpContext, Ops extends object> {
+    /**
+     * Apply a prefix to all schema columns.
+     *
+     * Shorthand for mapColumns where each column gets the prefix.
+     * E.g., `httpOps.prefix('http')` transforms 'status' -> 'http_status'
+     *
+     * The prefixed columns become part of the combined app schema:
+     * `appSchema & { http_status: S.number(), http_url: S.category() }`
+     *
+     * @param prefix - Prefix to apply to all schema columns
+     * @returns MappedOpGroup with prefixed schema contribution
+     */
+    prefix<P extends string>(prefix: P): MappedOpGroup<Ctx, PrefixedSchema<SchemaFieldsOf<Ctx['logSchema']>, P>, Ops>;
+    /**
+     * Map schema columns to different names in the app's schema.
+     *
+     * Use this for:
+     * - Deduplication: `{ query: 'query' }` - multiple libs share same column
+     * - Renaming: `{ rows: 'pg_row_count' }`
+     * - Dropping: `{ _internal: null }` - ignore library's internal column
+     * - Mixed: `{ query: 'query', rows: 'pg_rows', _debug: null }`
+     *
+     * Type-safety: Target columns must have compatible schema types.
+     *
+     * @param mapping - Maps library column names to app column names (or null to drop)
+     * @returns MappedOpGroup with mapped schema contribution
+     *
+     * @example
+     * ```typescript
+     * // Two DB libs share 'query' column, each has unique columns, drop debug
+     * deps: {
+     *   pg: postgresOps.mapColumns({ query: 'query', rows: 'pg_rows', _debug: null }),
+     *   mysql: mysqlOps.mapColumns({ query: 'query', duration: 'mysql_duration' }),
+     * }
+     * ```
+     */
+    mapColumns<M extends ColumnMapping<SchemaFieldsOf<Ctx['logSchema']>>>(mapping: M): MappedOpGroup<Ctx, MappedSchema<SchemaFieldsOf<Ctx['logSchema']>, M>, Ops>;
+}
+export type OpGroup<Ctx extends OpContext, Ops extends object = NoOpMembers> = OpGroupMethods<Ctx, Ops> & Ops;
+/**
+ * An OpGroup with column mapping applied.
+ *
+ * The mapping is used during wiring to create RemappedBufferView
+ * that translates the library's column writes to the app's column names.
+ *
+ * Note: Ops are accessed directly as properties (`.opName` not `.ops.opName`)
+ * for V8 hidden class optimization and cleaner API ergonomics.
+ *
+ * Internal properties (_logSchema, _flags, _contributedSchema, _columnMapping)
+ * are hidden from intellisense but accessible at runtime.
+ *
+ * @template Ctx - OpContext (bundled type with logSchema, flags, deps, userCtx)
+ * @template ContributedSchema - Schema fields this group contributes to app (after mapping)
+ */
+interface MappedOpGroupMethods<Ctx extends OpContext, ContributedSchema extends SchemaFields, Ops extends object> {
+    /** Chain with prefix (applies prefix to current mapping) */
+    prefix<P extends string>(prefix: P): MappedOpGroup<Ctx, PrefixedSchema<ContributedSchema, P>, Ops>;
+    /** Override/extend the mapping */
+    mapColumns<M extends ColumnMapping<ContributedSchema>>(mapping: M): MappedOpGroup<Ctx, MappedSchema<ContributedSchema, M>, Ops>;
+}
+export type MappedOpGroup<Ctx extends OpContext, ContributedSchema extends SchemaFields, Ops extends object = NoOpMembers> = MappedOpGroupMethods<Ctx, ContributedSchema, Ops> & Ops;
+/**
+ * Internal OpGroup interface with all properties exposed.
+ * Used by library implementation code that needs access to schema/flags.
+ *
+ * NOT exported from public API - use type assertion to access:
+ * `(opGroup as OpGroupInternal<Ctx>)._logSchema`
+ */
+export interface OpGroupInternal<Ctx extends OpContext, Ops extends object = NoOpMembers> extends OpGroupMethods<Ctx, Ops> {
+    /** The log schema for this group's ops (internal) */
+    readonly _logSchema: Ctx['logSchema'];
+    /** The feature flag schema (internal) */
+    readonly _flags: Ctx['flags'];
+}
+/**
+ * Internal MappedOpGroup interface with all properties exposed.
+ * Used by library implementation code that needs access to mapping details.
+ */
+export interface MappedOpGroupInternal<Ctx extends OpContext, ContributedSchema extends SchemaFields, Ops extends object = NoOpMembers> extends MappedOpGroupMethods<Ctx, ContributedSchema, Ops> {
+    /** The log schema for this group's ops (internal) */
+    readonly _logSchema: Ctx['logSchema'];
+    /** The feature flag schema (internal) */
+    readonly _flags: Ctx['flags'];
+    /** The schema fields this group contributes to the app's combined schema (internal) */
+    readonly _contributedSchema: ContributedSchema;
+    /** The column mapping (library column -> app column, or null to drop) (internal) */
+    readonly _columnMapping: ColumnMapping<SchemaFieldsOf<Ctx['logSchema']>>;
+}
+/**
+ * Minimal structural interface for any OpGroup (internal use only).
+ *
+ * This captures only the internal properties we need to read from an OpGroup
+ * in dependency wiring. The internal properties exist at runtime but are
+ * hidden from the public TypeScript interfaces.
+ *
+ * Note: No `.ops` property - ops are accessed directly as own properties.
+ */
+export interface AnyOpGroup {
+    /** The log schema - read-only access for wiring (internal property) */
+    readonly _logSchema: LogSchema;
+}
+/**
+ * Minimal structural interface for a MappedOpGroup (internal use only).
+ * Used for dependency wiring when we need access to contributed schema.
+ */
+export interface AnyMappedOpGroup extends AnyOpGroup {
+    /** The contributed schema after mapping (internal property) */
+    readonly _contributedSchema: SchemaFields;
+}
+/**
+ * Type guard to check if an OpGroup has been mapped (has _contributedSchema)
+ */
+export declare function isMappedOpGroup(dep: AnyOpGroup): dep is AnyMappedOpGroup;
+/**
+ * Minimal public interface for OpGroups used in deps config.
+ * Accepts any OpGroup or MappedOpGroup without requiring internal properties.
+ * Internal properties are accessed at runtime via type assertion.
+ */
+export interface AnyOpGroupPublic {
+    /** Apply a prefix to all schema columns */
+    prefix(prefix: string): AnyOpGroupPublic;
+    /** Map schema columns to different names */
+    mapColumns(mapping: ColumnMapping): AnyOpGroupPublic;
+}
+/**
+ * Type for deps config - maps names to OpGroups (optionally mapped)
+ *
+ * This is used as a constraint (`Deps extends DepsConfig`) so it needs
+ * to be wide enough to accept any specific deps configuration.
+ *
+ * Uses AnyOpGroupPublic to accept OpGroup/MappedOpGroup without requiring
+ * internal properties in the type signature.
+ */
+export type DepsConfig = Record<string, AnyOpGroupPublic>;
+/**
+ * Extract the contributed schema from a dep (for combining into app schema)
+ */
+export type ContributedSchemaOf<D> = D extends MappedOpGroup<infer _Ctx, infer CS, infer _Ops> ? CS : D extends OpGroup<infer Ctx, infer _Ops> ? SchemaFieldsOf<Ctx['logSchema']> : never;
+/**
+ * Combine all contributed schemas from deps into a union of all their fields.
+ * App's effective schema = appSchema & pg_contributed & mysql_contributed & ...
+ *
+ * This is used to type the combined LogSchema that has access to all columns
+ * from both the app and all wired dependencies.
+ */
+export type CombinedDepsSchema<D extends DepsConfig> = UnionToIntersection<{
+    [K in keyof D]: ContributedSchemaOf<D[K]>;
+}[keyof D]>;
+/**
+ * Helper: Convert union to intersection
+ * `A | B | C` → `A & B & C`
+ */
+export type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * The effective schema for an OpContext: app schema + all dep contributed schemas.
+ */
+export type EffectiveSchema<T extends SchemaFields, D extends DepsConfig> = T & CombinedDepsSchema<D>;
+/**
+ * Extract the typed deps interface from a DepsConfig.
+ * Each dep becomes accessible via ctx.deps.name
+ */
+export type ResolvedDeps<D extends DepsConfig> = {
+    readonly [K in keyof D]: D[K] extends OpGroup<infer Ctx, infer Ops> ? OpGroup<Ctx, Ops> : D[K] extends MappedOpGroup<infer Ctx, infer _CS, infer Ops> ? OpGroup<Ctx, Ops> : never;
+};
+export {};
+//# sourceMappingURL=opGroupTypes.d.ts.map

package/dist/lib/opContext/opGroupTypes.d.ts.map

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

package/dist/lib/opContext/opGroupTypes.js

@@ -0,0 +1,31 @@
+// =============================================================================
+// RESERVED OP NAMES
+// =============================================================================
+/**
+ * Reserved names that cannot be used as op names.
+ * These conflict with OpGroup methods or internal properties.
+ */
+export const RESERVED_OP_NAMES = ['prefix', 'mapColumns'];
+/**
+ * Validate that an op name is allowed.
+ * Throws if the name is reserved or starts with underscore.
+ *
+ * @param name - The op name to validate
+ * @throws Error if name is invalid
+ */
+export function validateOpName(name) {
+    if (name.startsWith('_')) {
+        throw new Error(`Op name "${name}" cannot start with underscore (reserved for internal properties). ` +
+            `Consider using "${name.slice(1)}" instead.`);
+    }
+    if (RESERVED_OP_NAMES.includes(name)) {
+        throw new Error(`Op name "${name}" is reserved (conflicts with OpGroup method). ` +
+            `Consider using a more descriptive name like "${name}Op" or "${name}Operation".`);
+    }
+}
+/**
+ * Type guard to check if an OpGroup has been mapped (has _contributedSchema)
+ */
+export function isMappedOpGroup(dep) {
+    return '_contributedSchema' in dep;
+}

package/dist/lib/opContext/opTypes.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Op Type Definitions
+ *
+ * Core type definitions for Ops - the first-class citizens of the Op-centric API.
+ * Ops wrap functions with metadata and enable composition.
+ *
+ * The Op class and OpMetadata interface are defined in ../op.ts (single source of truth)
+ * and re-exported here for convenience.
+ *
+ * ## Dependency Layer
+ * This module is at Layer 3 in the type hierarchy:
+ * - Depends on: spanContextTypes (Layer 2), featureFlagTypes (Layer 1)
+ * - Depended on by: opGroupTypes (Layer 4)
+ */
+import type { ExtractError, ExtractSuccess, Result } from '../result.js';
+import type { SpanContext } from './spanContextTypes.js';
+import type { OpContext } from './types.js';
+export { Op, type OpMetadata } from '../op.js';
+/**
+ * Op function signature - what the user provides to defineOp.
+ * MUST return Result<S, E> or Promise<Result<S, E>>.
+ *
+ * @template Ctx - Bundled OpContext (logSchema, flags, deps, userCtx)
+ * @template Args - Function arguments (after ctx)
+ * @template S - Success type
+ * @template E - Error type
+ */
+export type OpFn<Ctx extends OpContext, Args extends unknown[], S, E> = (ctx: SpanContext<Ctx>, ...args: Args) => Result<S, E> | Promise<Result<S, E>>;
+import type { Op } from '../op.js';
+/**
+ * Convert a single definition (Op or OpFn) to an Op type.
+ * Uses ExtractSuccess/ExtractError from result.ts to infer types from return value.
+ */
+type DefToOp<Ctx extends OpContext, Def> = Def extends Op<Ctx, infer Args, infer S, infer E> ? Op<Ctx, Args, S, E> : Def extends (ctx: SpanContext<Ctx>, ...args: infer Args) => infer R ? Op<Ctx, Args, ExtractSuccess<R>, ExtractError<R>> : never;
+/**
+ * Transform a record of Op functions into Ops
+ *
+ * Used by defineOps for batch definition. Takes a record where values are either:
+ * - Existing Op instances (passed through)
+ * - Op function signatures (wrapped into Ops)
+ *
+ * @template Ctx - Bundled OpContext (logSchema, flags, deps, userCtx)
+ * @template Defs - Record of Op definitions (functions or existing Ops)
+ */
+export type OpsFromRecord<Ctx extends OpContext, Defs extends Record<string, Op<Ctx, unknown[], unknown, unknown> | OpFn<Ctx, unknown[], unknown, unknown>>> = {
+    [K in keyof Defs]: DefToOp<Ctx, Defs[K]>;
+};
+//# sourceMappingURL=opTypes.d.ts.map

package/dist/lib/opContext/opTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opTypes.d.ts","sourceRoot":"","sources":["../../../src/lib/opContext/opTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS5C,OAAO,EAAE,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAM/C;;;;;;;;GAQG;AACH,MAAM,MAAM,IAAI,CAAC,GAAG,SAAS,SAAS,EAAE,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CACtE,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EACrB,GAAG,IAAI,EAAE,IAAI,KACV,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAO1C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC;;;GAGG;AACH,KAAK,OAAO,CAAC,GAAG,SAAS,SAAS,EAAE,GAAG,IACrC,GAAG,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7C,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,GACnB,GAAG,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,MAAM,CAAC,GACjE,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,GACjD,KAAK,CAAC;AAEd;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CACvB,GAAG,SAAS,SAAS,EACrB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,IACxG;KACD,CAAC,IAAI,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC"}

package/dist/lib/opContext/opTypes.js

@@ -0,0 +1,7 @@
+// =============================================================================
+// OP CLASS & METADATA RE-EXPORTS
+// =============================================================================
+// Re-export the Op class and OpMetadata from op.ts - single source of truth
+// The class is defined in op.ts to be the canonical type used by both
+// defineOp (creates instances) and Tracer (checks instanceof)
+export { Op } from '../op.js';