@arke-institute/rhiza 0.1.0

package/dist/types/refs.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Entity References
+ *
+ * EntityRef is a typed reference to a klados or rhiza entity within flow definitions.
+ * Follows the established Arke EntityRef convention (see arke_v1/src/schema/refs.ts).
+ *
+ * Key benefits:
+ * - Type hints avoid runtime discoverTargetType() API calls
+ * - Labels provide display context without fetching
+ * - Duck typing: any object with `pi` field is treated as EntityRef
+ */
+/**
+ * EntityRef - A typed reference to a klados or rhiza entity
+ *
+ * Example usage in flow definitions:
+ * ```typescript
+ * flow: {
+ *   'klados_a': {
+ *     then: {
+ *       pass: { pi: 'klados_b', type: 'klados', label: 'Processor' }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export interface EntityRef {
+    /** The referenced entity's persistent identifier (required) */
+    pi: string;
+    /** Type hint: "klados" or "rhiza" - avoids runtime type discovery when present */
+    type?: 'klados' | 'rhiza';
+    /** Display label - avoids needing to fetch the entity for display */
+    label?: string;
+    /** Human-readable description of why this reference exists */
+    description?: string;
+}
+/**
+ * Check if a value is an EntityRef
+ *
+ * Uses duck typing: any object with a `pi` string field is considered a ref.
+ */
+export declare function isEntityRef(value: unknown): value is EntityRef;
+/**
+ * Create an EntityRef with optional metadata
+ *
+ * @param pi - The entity ID
+ * @param options - Optional type, label, description
+ * @returns An EntityRef object
+ *
+ * @example
+ * ref('klados_worker', { type: 'klados' })
+ * ref('rhiza_subprocess', { type: 'rhiza', label: 'OCR Pipeline' })
+ */
+export declare function ref(pi: string, options?: {
+    type?: 'klados' | 'rhiza';
+    label?: string;
+    description?: string;
+}): EntityRef;
+//# sourceMappingURL=refs.d.ts.map

package/dist/types/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/types/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IAEX,kFAAkF;IAClF,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAE1B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAO9D;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,SAAS,CAEX"}

package/dist/types/refs.js

@@ -0,0 +1,43 @@
+/**
+ * Entity References
+ *
+ * EntityRef is a typed reference to a klados or rhiza entity within flow definitions.
+ * Follows the established Arke EntityRef convention (see arke_v1/src/schema/refs.ts).
+ *
+ * Key benefits:
+ * - Type hints avoid runtime discoverTargetType() API calls
+ * - Labels provide display context without fetching
+ * - Duck typing: any object with `pi` field is treated as EntityRef
+ */
+// =============================================================================
+// Type Guard
+// =============================================================================
+/**
+ * Check if a value is an EntityRef
+ *
+ * Uses duck typing: any object with a `pi` string field is considered a ref.
+ */
+export function isEntityRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'pi' in value &&
+        typeof value.pi === 'string');
+}
+// =============================================================================
+// Utilities
+// =============================================================================
+/**
+ * Create an EntityRef with optional metadata
+ *
+ * @param pi - The entity ID
+ * @param options - Optional type, label, description
+ * @returns An EntityRef object
+ *
+ * @example
+ * ref('klados_worker', { type: 'klados' })
+ * ref('rhiza_subprocess', { type: 'rhiza', label: 'OCR Pipeline' })
+ */
+export function ref(pi, options) {
+    return { pi, ...options };
+}
+//# sourceMappingURL=refs.js.map

package/dist/types/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/types/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkCH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,IAAI,IAAI,KAAK;QACb,OAAQ,KAAmB,CAAC,EAAE,KAAK,QAAQ,CAC5C,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,GAAG,CACjB,EAAU,EACV,OAA6E;IAE7E,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC;AAC5B,CAAC"}

package/dist/types/request.d.ts

@@ -0,0 +1,69 @@
+/**
+ * KladosRequest - What a klados receives when invoked (from the Arke API)
+ */
+export interface KladosRequest {
+    /** Unique job identifier */
+    job_id: string;
+    /** Target entity/collection to process */
+    target: string;
+    /** Job collection for logs */
+    job_collection: string;
+    /** Optional input data */
+    input?: Record<string, unknown>;
+    /** Arke API base URL for callbacks */
+    api_base: string;
+    /** When permissions expire (ISO 8601) */
+    expires_at: string;
+    /** Which network (test/main) */
+    network: 'test' | 'main';
+    /** Workflow context - present when invoked via rhiza */
+    rhiza?: RhizaContext;
+}
+/**
+ * RhizaContext - Workflow execution context
+ *
+ * The context passed to a klados when invoked as part of a workflow.
+ * Uses path-based tracking to handle multiple mentions of the same klados.
+ */
+export interface RhizaContext {
+    /** Rhiza entity ID */
+    id: string;
+    /**
+     * Path that got us here - sequence of klados IDs from entry to current
+     * This solves the problem of multiple mentions of the same klados:
+     * we know which instance we are by our position in the path.
+     *
+     * Example: ['II01klados_pdf...', 'II01klados_ocr...']
+     * The current klados looks up its position to find what to do next.
+     */
+    path: string[];
+    /**
+     * Immediate parent log entry ID(s)
+     * - For pass/scatter: single parent ID
+     * - For gather: array of all parent sibling IDs (fan-in)
+     *
+     * Children create log entries pointing back to these parents.
+     * No parent updates needed (fire-and-forget).
+     */
+    parent_logs: string[];
+    /**
+     * Batch context - present when part of scatter/gather
+     * Only exists within workflow context (no standalone batching)
+     */
+    batch?: BatchContext;
+}
+/**
+ * BatchContext - Context when part of scatter/gather
+ *
+ * Note: gather_target is NOT included here - it's in the workflow definition.
+ * The klados looks up what to do next from the rhiza flow.
+ */
+export interface BatchContext {
+    /** Batch entity ID */
+    id: string;
+    /** Our slot index (0-based) */
+    index: number;
+    /** Total slots in batch */
+    total: number;
+}
+//# sourceMappingURL=request.d.ts.map

package/dist/types/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/types/request.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IAEvB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB,gCAAgC;IAChC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAEzB,wDAAwD;IACxD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IAEX,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/request.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=request.js.map

package/dist/types/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/types/request.ts"],"names":[],"mappings":""}

package/dist/types/response.d.ts

@@ -0,0 +1,31 @@
+/**
+ * KladosResponse - What a klados returns after accepting/rejecting
+ */
+export interface KladosResponse {
+    /** Whether the klados accepted the job */
+    accepted: boolean;
+    /** Job ID (must match request) */
+    job_id: string;
+    /** Error message if rejected */
+    error?: string;
+    /** Retry delay in seconds (for transient errors) */
+    retry_after?: number;
+}
+/**
+ * KladosResult - Final result after klados completes
+ */
+export interface KladosResult {
+    /** Completion status */
+    status: 'done' | 'error';
+    /** Produced entity IDs (if done) */
+    outputs?: string[];
+    /** Error details (if error) */
+    error?: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+    /** Optional result metadata */
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=response.d.ts.map

package/dist/types/response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.ts","sourceRoot":"","sources":["../../src/types/response.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAElB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/types/response.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=response.js.map

package/dist/types/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/types/response.ts"],"names":[],"mappings":""}

package/dist/types/rhiza.d.ts

@@ -0,0 +1,100 @@
+import type { EntityRef } from './refs';
+/**
+ * RhizaEntity - A workflow entity
+ *
+ * Rhizai compose kladoi into executable workflows.
+ * They define the flow (what klados invokes what next).
+ */
+export interface RhizaEntity {
+    /** Unique identifier (Arke entity ID) */
+    id: string;
+    /** Entity type */
+    type: 'rhiza';
+    properties: RhizaProperties;
+    relationships?: Array<{
+        predicate: string;
+        peer: string;
+        peer_type?: string;
+        peer_label?: string;
+        properties?: Record<string, unknown>;
+    }>;
+}
+export interface RhizaProperties {
+    /** Human-readable name */
+    label: string;
+    /** Description of what this workflow does */
+    description?: string;
+    /** Semantic version */
+    version: string;
+    /** Entry point - reference to the klados that starts the workflow */
+    entry: EntityRef;
+    /** Flow definition - what happens after each klados */
+    flow: Record<string, FlowStep>;
+    /** Status */
+    status: 'development' | 'active' | 'disabled';
+    /** Timestamps */
+    created_at?: string;
+    updated_at?: string;
+}
+/**
+ * FlowStep - What happens after a klados completes
+ */
+export interface FlowStep {
+    /** Handoff specification */
+    then: ThenSpec;
+}
+/**
+ * ThenSpec - Handoff specification
+ *
+ * Three core operations: pass, scatter, gather (+ done for terminal)
+ * - Target is an EntityRef (type hint avoids runtime discovery)
+ * - Route conditions can be added to any operation via `route` array
+ */
+export type ThenSpec = {
+    done: true;
+} | {
+    pass: EntityRef;
+    route?: RouteRule[];
+} | {
+    scatter: EntityRef;
+    route?: RouteRule[];
+} | {
+    gather: EntityRef;
+    route?: RouteRule[];
+};
+/**
+ * RouteRule - Conditional routing rule
+ *
+ * Routes are evaluated in order. First matching rule wins.
+ * If no rule matches, the default target (pass/scatter/gather value) is used.
+ */
+export interface RouteRule {
+    /** Condition to match (supports AND/OR logic) */
+    where: WhereCondition;
+    /** Target reference if condition matches (overrides default) */
+    target: EntityRef;
+}
+/**
+ * WhereCondition - Property-based matching with AND/OR logic
+ *
+ * Examples:
+ * - Simple: { property: "type", equals: "File" }
+ * - AND: { and: [{ property: "type", equals: "File" }, { property: "file_type", equals: "image/jpeg" }] }
+ * - OR: { or: [{ property: "file_type", equals: "image/jpeg" }, { property: "file_type", equals: "image/png" }] }
+ */
+export type WhereCondition = WhereEquals | WhereAnd | WhereOr;
+export interface WhereEquals {
+    /** Property name to check (e.g., "type", "content_type") */
+    property: string;
+    /** Value to match (null to check for absent/null properties) */
+    equals: string | number | boolean | null;
+}
+export interface WhereAnd {
+    /** All conditions must match */
+    and: WhereCondition[];
+}
+export interface WhereOr {
+    /** Any condition must match */
+    or: WhereCondition[];
+}
+//# sourceMappingURL=rhiza.d.ts.map

package/dist/types/rhiza.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rhiza.d.ts","sourceRoot":"","sources":["../../src/types/rhiza.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAExC;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IAEX,kBAAkB;IAClB,IAAI,EAAE,OAAO,CAAC;IAEd,UAAU,EAAE,eAAe,CAAC;IAE5B,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IAEd,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAEhB,qEAAqE;IACrE,KAAK,EAAE,SAAS,CAAC;IAEjB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE/B,aAAa;IACb,MAAM,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE9C,iBAAiB;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GACxC;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,GAC3C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,KAAK,EAAE,cAAc,CAAC;IAEtB,gEAAgE;IAChE,MAAM,EAAE,SAAS,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,GAAG,EAAE,cAAc,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,+BAA+B;IAC/B,EAAE,EAAE,cAAc,EAAE,CAAC;CACtB"}

package/dist/types/rhiza.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rhiza.js.map

package/dist/types/rhiza.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rhiza.js","sourceRoot":"","sources":["../../src/types/rhiza.ts"],"names":[],"mappings":""}

package/dist/types/status.d.ts

@@ -0,0 +1,84 @@
+/**
+ * WorkflowStatus - Overall workflow execution status
+ */
+export interface WorkflowStatus {
+    /** Job ID */
+    job_id: string;
+    /** Rhiza entity ID */
+    rhiza_id: string;
+    /** Overall status */
+    status: 'pending' | 'running' | 'done' | 'error';
+    /** Progress counters */
+    progress: ProgressCounters;
+    /** Currently executing kladoi (if running) */
+    current_kladoi?: string[];
+    /** Simplified log chain for debugging */
+    log_chain: LogChainEntry[];
+    /** Error leaves (if any) */
+    errors?: ErrorSummary[];
+    /** Timing */
+    started_at: string;
+    completed_at?: string;
+}
+/**
+ * ProgressCounters - Aggregated progress
+ */
+export interface ProgressCounters {
+    total: number;
+    pending: number;
+    running: number;
+    done: number;
+    error: number;
+}
+/**
+ * LogChainEntry - Simplified log entry for status
+ */
+export interface LogChainEntry {
+    log_id: string;
+    klados_id: string;
+    status: 'running' | 'done' | 'error';
+    started_at: string;
+    completed_at?: string;
+    children?: LogChainEntry[];
+}
+/**
+ * ErrorSummary - Summary of an error leaf
+ */
+export interface ErrorSummary {
+    log_id: string;
+    klados_id: string;
+    job_id: string;
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+    };
+}
+/**
+ * ResumeResult - Result of resume operation
+ */
+export interface ResumeResult {
+    resumed: number;
+    skipped: number;
+    jobs: ResumedJob[];
+}
+/**
+ * ResumedJob - Record of a job that was resumed
+ *
+ * Resume creates a NEW job_id for the retry attempt. The original job_id
+ * remains in the log chain for audit trail. The new job's log entry will
+ * point back to the failed log entry, maintaining the chain.
+ */
+export interface ResumedJob {
+    /** Original failed job ID */
+    original_job_id: string;
+    /** New job ID for the retry */
+    new_job_id: string;
+    /** Klados that is being retried */
+    klados_id: string;
+    /** Target entity/entities being processed */
+    target: string | string[];
+    /** Original error message */
+    error: string;
+}
+//# sourceMappingURL=status.d.ts.map

package/dist/types/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/types/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa;IACb,MAAM,EAAE,MAAM,CAAC;IAEf,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAEjD,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAE3B,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,yCAAyC;IACzC,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IAExB,aAAa;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/status.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=status.js.map

package/dist/types/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/types/status.ts"],"names":[],"mappings":""}

package/dist/utils/id.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ID Generation Utility
+ *
+ * Generates unique identifiers for logs, batches, and jobs.
+ */
+/**
+ * Generate a unique identifier
+ *
+ * Uses crypto.randomUUID() for standard UUID v4 generation,
+ * with a fallback for environments where it's not available.
+ *
+ * @returns A unique identifier string (UUID v4 format)
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAWnC"}

package/dist/utils/id.js

@@ -0,0 +1,25 @@
+/**
+ * ID Generation Utility
+ *
+ * Generates unique identifiers for logs, batches, and jobs.
+ */
+/**
+ * Generate a unique identifier
+ *
+ * Uses crypto.randomUUID() for standard UUID v4 generation,
+ * with a fallback for environments where it's not available.
+ *
+ * @returns A unique identifier string (UUID v4 format)
+ */
+export function generateId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback for older environments
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU;IACxB,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED,kCAAkC;IAClC,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;QACnE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QAC1C,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { generateId } from './id';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export { generateId } from './id';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC"}

package/dist/validation/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Validation Module
+ *
+ * Exports validation functions for rhiza and klados entities.
+ * These are pure validation functions - no API calls.
+ */
+export { validateKladosProperties, type ValidationResult, type ValidationError, type ValidationWarning, } from './validate-klados';
+export { validateRhizaProperties, } from './validate-rhiza';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,9 @@
+/**
+ * Validation Module
+ *
+ * Exports validation functions for rhiza and klados entities.
+ * These are pure validation functions - no API calls.
+ */
+export { validateKladosProperties, } from './validate-klados';
+export { validateRhizaProperties, } from './validate-rhiza';
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,wBAAwB,GAIzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,uBAAuB,GACxB,MAAM,kBAAkB,CAAC"}

package/dist/validation/validate-klados.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Klados Validation
+ *
+ * Validates klados entity properties at creation/update time (static validation).
+ * This ensures klados definitions are well-formed before they can be activated.
+ */
+import type { KladosProperties } from '../types';
+/**
+ * ValidationResult - Result of validation
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    code: string;
+    message: string;
+    field?: string;
+}
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    field?: string;
+}
+/**
+ * Validate klados properties (static validation)
+ *
+ * Checks:
+ * - endpoint: Required, must be valid URL
+ * - accepts.types: Required, non-empty array
+ * - accepts.cardinality: Must be 'one' or 'many'
+ * - produces.types: Required, non-empty array
+ * - produces.cardinality: Must be 'one' or 'many'
+ * - actions_required: Required, non-empty array
+ */
+export declare function validateKladosProperties(properties: Partial<KladosProperties> | null | undefined): ValidationResult;
+//# sourceMappingURL=validate-klados.d.ts.map

package/dist/validation/validate-klados.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-klados.d.ts","sourceRoot":"","sources":["../../src/validation/validate-klados.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,GAAG,SAAS,GACvD,gBAAgB,CAgIlB"}