@pikku/addon-graph 0.0.2 → 0.12.0

package/.pikku/rpc/pikku-rpc-wirings-map.internal.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.19
  */
 /**
  * This provides the structure needed for typescript to be aware of RPCs and their return types
@@ -9,6 +9,34 @@
 
 
 
+export type AggregateInput = {
+    /** The array of items to aggregate */
+    items: {
+        [key: string]: unknown;
+    }[];
+    /** The field path to collect values from */
+    field: string;
+    /** The name of the output field containing the list */
+    outputField?: string | undefined;
+    /** Only include unique values */
+    unique?: boolean | undefined;
+}
+export type AggregateOutput = {
+    /** The output object with aggregated values */
+    item: {
+        [key: string]: unknown;
+    };
+}
+export type ChunkInput = {
+    /** The array to split into chunks */
+    items: unknown[];
+    /** Size of each chunk */
+    size: number;
+}
+export type ChunkOutput = {
+    /** Array of chunks */
+    chunks: unknown[][];
+}
 export type CoalesceInput = {
     /** Values to check in order */
     values: unknown[];
@@ -65,113 +93,29 @@ export type DateTimeOutput = {
     /** Unix timestamp in milliseconds */
     timestamp: number;
 }
-export type JwtSignInput = {
-    /** The payload to encode into the JWT */
-    payload: any;
-    /** Token expiration time */
-    expiresIn: {
-        /** Duration value */
-        value: number;
-        /** Time unit */
-        unit: "second" | "minute" | "hour" | "day" | "week" | "year";
-    };
-}
-export type JwtSignOutput = {
-    /** The signed JWT token */
-    token: string;
-}
-export type JwtDecodeInput = {
-    /** The JWT token to decode */
-    token: string;
-}
-export type JwtDecodeOutput = {
-    /** The decoded payload */
-    payload: any;
-}
-export type MathInput = {
-    /** The math operation to perform */
-    operation: "add" | "subtract" | "multiply" | "divide" | "modulo" | "power" | "sqrt" | "abs" | "round" | "floor" | "ceil" | "min" | "max" | "random";
-    /** First operand */
-    a?: number | undefined;
-    /** Second operand (for binary operations) */
-    b?: number | undefined;
-    /** Decimal places for round operation */
-    decimals?: number | undefined;
-}
-export type MathOutput = {
-    /** The result of the operation */
-    result: number;
-}
-export type StringTransformInput = {
-    /** The input string */
-    value: string;
-    /** The transformation to apply */
-    operation: "uppercase" | "lowercase" | "capitalize" | "camelCase" | "snakeCase" | "kebabCase" | "trim" | "trimStart" | "trimEnd" | "split" | "replace" | "slice" | "padStart" | "padEnd";
-    /** Separator for split operation */
-    separator?: string | undefined;
-    /** Search string for replace operation */
-    search?: string | undefined;
-    /** Replacement string for replace operation */
-    replacement?: string | undefined;
-    /** Replace all occurrences */
-    replaceAll?: boolean | undefined;
-    /** Start index for slice */
-    start?: number | undefined;
-    /** End index for slice */
-    end?: number | undefined;
-    /** Target length for pad operations */
-    length?: number | undefined;
-    /** Character to pad with */
-    padChar?: string | undefined;
-}
-export type StringTransformOutput = {
-    /** The transformed result */
-    result: string | string[];
-}
-export type TypeConvertInput = {
-    /** The value to convert */
-    value: unknown;
-    /** Target type */
-    to: "string" | "number" | "boolean" | "json" | "array";
-    /** Radix for number parsing (e.g., 10, 16) */
-    radix?: number | undefined;
-}
-export type TypeConvertOutput = {
-    /** The converted value */
-    result: unknown;
-    /** Whether the conversion succeeded */
-    success: boolean;
-    /** The original type of the value */
-    originalType: string;
-}
-export type AggregateInput = {
-    /** The array of items to aggregate */
-    items: {
+export type EditFieldsInput = {
+    /** The input object to transform */
+    item: {
         [key: string]: unknown;
+    };
+    /** List of field operations to perform */
+    operations: {
+        /** The field path to operate on (supports dot notation) */
+        field: string;
+        /** The operation to perform */
+        operation: "set" | "remove" | "rename";
+        /** The value to set (for set operation) */
+        value?: unknown | undefined;
+        /** The new field name (for rename operation) */
+        newName?: string | undefined;
     }[];
-    /** The field path to collect values from */
-    field: string;
-    /** The name of the output field containing the list */
-    outputField?: string | undefined;
-    /** Only include unique values */
-    unique?: boolean | undefined;
 }
-export type AggregateOutput = {
-    /** The output object with aggregated values */
+export type EditFieldsOutput = {
+    /** The transformed object */
     item: {
         [key: string]: unknown;
     };
 }
-export type ChunkInput = {
-    /** The array to split into chunks */
-    items: unknown[];
-    /** Size of each chunk */
-    size: number;
-}
-export type ChunkOutput = {
-    /** Array of chunks */
-    chunks: unknown[][];
-}
 export type FindInput = {
     /** The array to search */
     items: {
@@ -210,6 +154,29 @@ export type GroupByOutput = {
         }[];
     };
 }
+export type JwtDecodeInput = {
+    /** The JWT token to decode */
+    token: string;
+}
+export type JwtDecodeOutput = {
+    /** The decoded payload */
+    payload: any;
+}
+export type JwtSignInput = {
+    /** The payload to encode into the JWT */
+    payload: any;
+    /** Token expiration time */
+    expiresIn: {
+        /** Duration value */
+        value: number;
+        /** Time unit */
+        unit: "second" | "minute" | "hour" | "day" | "week" | "year";
+    };
+}
+export type JwtSignOutput = {
+    /** The signed JWT token */
+    token: string;
+}
 export type LimitInput = {
     /** The array of items to limit */
     items: unknown[];
@@ -224,6 +191,62 @@ export type LimitOutput = {
     /** The original total count before limiting */
     totalCount: number;
 }
+export type MathInput = {
+    /** The math operation to perform */
+    operation: "add" | "subtract" | "multiply" | "divide" | "modulo" | "power" | "sqrt" | "abs" | "round" | "floor" | "ceil" | "min" | "max" | "random";
+    /** First operand */
+    a?: number | undefined;
+    /** Second operand (for binary operations) */
+    b?: number | undefined;
+    /** Decimal places for round operation */
+    decimals?: number | undefined;
+}
+export type MathOutput = {
+    /** The result of the operation */
+    result: number;
+}
+export type MergeInput = {
+    /** Objects to merge (later objects override earlier ones) */
+    items: {
+        [key: string]: unknown;
+    }[];
+    /** Perform deep merge of nested objects */
+    deep?: boolean | undefined;
+}
+export type MergeOutput = {
+    /** The merged object */
+    item: {
+        [key: string]: unknown;
+    };
+}
+export type OmitInput = {
+    /** The input object */
+    item: {
+        [key: string]: unknown;
+    };
+    /** Fields to remove */
+    fields: string[];
+}
+export type OmitOutput = {
+    /** Object without the specified fields */
+    item: {
+        [key: string]: unknown;
+    };
+}
+export type PickInput = {
+    /** The input object */
+    item: {
+        [key: string]: unknown;
+    };
+    /** Fields to keep (supports dot notation for nested fields) */
+    fields: string[];
+}
+export type PickOutput = {
+    /** Object with only the specified fields */
+    item: {
+        [key: string]: unknown;
+    };
+}
 export type RemoveDuplicatesInput = {
     /** The array of items to deduplicate */
     items: {
@@ -242,6 +265,27 @@ export type RemoveDuplicatesOutput = {
     /** Number of duplicates removed */
     removedCount: number;
 }
+export type RenameKeysInput = {
+    /** The input object to transform */
+    item: {
+        [key: string]: unknown;
+    };
+    /** List of key rename mappings */
+    mappings: {
+        /** The original key name */
+        oldKey: string;
+        /** The new key name */
+        newKey: string;
+    }[];
+    /** Whether to keep keys that are not in the mapping */
+    keepUnmapped?: boolean | undefined;
+}
+export type RenameKeysOutput = {
+    /** The transformed object with renamed keys */
+    item: {
+        [key: string]: unknown;
+    };
+}
 export type ReverseInput = {
     /** The array to reverse */
     items: unknown[];
@@ -250,6 +294,12 @@ export type ReverseOutput = {
     /** The reversed array */
     items: unknown[];
 }
+export type SleepInput = {
+    /** A unique name for this sleep step */
+    name: string;
+    /** Duration to sleep in milliseconds */
+    ms: number;
+}
 export type SortInput = {
     /** The array of items to sort */
     items: {
@@ -285,6 +335,32 @@ export type SplitOutOutput = {
         [key: string]: unknown;
     }[];
 }
+export type StringTransformInput = {
+    /** The input string */
+    value: string;
+    /** The transformation to apply */
+    operation: "uppercase" | "lowercase" | "capitalize" | "camelCase" | "snakeCase" | "kebabCase" | "trim" | "trimStart" | "trimEnd" | "split" | "replace" | "slice" | "padStart" | "padEnd";
+    /** Separator for split operation */
+    separator?: string | undefined;
+    /** Search string for replace operation */
+    search?: string | undefined;
+    /** Replacement string for replace operation */
+    replacement?: string | undefined;
+    /** Replace all occurrences */
+    replaceAll?: boolean | undefined;
+    /** Start index for slice */
+    start?: number | undefined;
+    /** End index for slice */
+    end?: number | undefined;
+    /** Target length for pad operations */
+    length?: number | undefined;
+    /** Character to pad with */
+    padChar?: string | undefined;
+}
+export type StringTransformOutput = {
+    /** The transformed result */
+    result: string | string[];
+}
 export type SummarizeInput = {
     /** The array of items to summarize */
     items: {
@@ -308,6 +384,22 @@ export type SummarizeOutput = {
         [key: string]: unknown;
     }[];
 }
+export type TypeConvertInput = {
+    /** The value to convert */
+    value: unknown;
+    /** Target type */
+    to: "string" | "number" | "boolean" | "json" | "array";
+    /** Radix for number parsing (e.g., 10, 16) */
+    radix?: number | undefined;
+}
+export type TypeConvertOutput = {
+    /** The converted value */
+    result: unknown;
+    /** Whether the conversion succeeded */
+    success: boolean;
+    /** The original type of the value */
+    originalType: string;
+}
 export type UniqueInput = {
     /** The array to get unique values from */
     items: unknown[];
@@ -318,92 +410,6 @@ export type UniqueOutput = {
     /** Array with only unique values */
     items: unknown[];
 }
-export type EditFieldsInput = {
-    /** The input object to transform */
-    item: {
-        [key: string]: unknown;
-    };
-    /** List of field operations to perform */
-    operations: {
-        /** The field path to operate on (supports dot notation) */
-        field: string;
-        /** The operation to perform */
-        operation: "set" | "remove" | "rename";
-        /** The value to set (for set operation) */
-        value?: unknown | undefined;
-        /** The new field name (for rename operation) */
-        newName?: string | undefined;
-    }[];
-}
-export type EditFieldsOutput = {
-    /** The transformed object */
-    item: {
-        [key: string]: unknown;
-    };
-}
-export type MergeInput = {
-    /** Objects to merge (later objects override earlier ones) */
-    items: {
-        [key: string]: unknown;
-    }[];
-    /** Perform deep merge of nested objects */
-    deep?: boolean | undefined;
-}
-export type MergeOutput = {
-    /** The merged object */
-    item: {
-        [key: string]: unknown;
-    };
-}
-export type OmitInput = {
-    /** The input object */
-    item: {
-        [key: string]: unknown;
-    };
-    /** Fields to remove */
-    fields: string[];
-}
-export type OmitOutput = {
-    /** Object without the specified fields */
-    item: {
-        [key: string]: unknown;
-    };
-}
-export type PickInput = {
-    /** The input object */
-    item: {
-        [key: string]: unknown;
-    };
-    /** Fields to keep (supports dot notation for nested fields) */
-    fields: string[];
-}
-export type PickOutput = {
-    /** Object with only the specified fields */
-    item: {
-        [key: string]: unknown;
-    };
-}
-export type RenameKeysInput = {
-    /** The input object to transform */
-    item: {
-        [key: string]: unknown;
-    };
-    /** List of key rename mappings */
-    mappings: {
-        /** The original key name */
-        oldKey: string;
-        /** The new key name */
-        newKey: string;
-    }[];
-    /** Whether to keep keys that are not in the mapping */
-    keepUnmapped?: boolean | undefined;
-}
-export type RenameKeysOutput = {
-    /** The transformed object with renamed keys */
-    item: {
-        [key: string]: unknown;
-    };
-}
 
 interface RPCHandler<I, O> {
     input: I;
@@ -411,14 +417,6 @@ interface RPCHandler<I, O> {
 }
 
 export type RPCMap = {
-  readonly 'coalesce': RPCHandler<CoalesceInput, CoalesceOutput>,
-  readonly 'crypto': RPCHandler<CryptoInput, CryptoOutput>,
-  readonly 'dateTime': RPCHandler<DateTimeInput, DateTimeOutput>,
-  readonly 'jwtSign': RPCHandler<JwtSignInput, JwtSignOutput>,
-  readonly 'jwtDecode': RPCHandler<JwtDecodeInput, JwtDecodeOutput>,
-  readonly 'math': RPCHandler<MathInput, MathOutput>,
-  readonly 'stringTransform': RPCHandler<StringTransformInput, StringTransformOutput>,
-  readonly 'typeConvert': RPCHandler<TypeConvertInput, TypeConvertOutput>,
   readonly 'aggregate': RPCHandler<AggregateInput, AggregateOutput>,
   readonly 'chunk': RPCHandler<ChunkInput, ChunkOutput>,
   readonly 'find': RPCHandler<FindInput, FindOutput>,
@@ -430,6 +428,15 @@ export type RPCMap = {
   readonly 'splitOut': RPCHandler<SplitOutInput, SplitOutOutput>,
   readonly 'summarize': RPCHandler<SummarizeInput, SummarizeOutput>,
   readonly 'unique': RPCHandler<UniqueInput, UniqueOutput>,
+  readonly 'coalesce': RPCHandler<CoalesceInput, CoalesceOutput>,
+  readonly 'crypto': RPCHandler<CryptoInput, CryptoOutput>,
+  readonly 'dateTime': RPCHandler<DateTimeInput, DateTimeOutput>,
+  readonly 'jwtSign': RPCHandler<JwtSignInput, JwtSignOutput>,
+  readonly 'jwtDecode': RPCHandler<JwtDecodeInput, JwtDecodeOutput>,
+  readonly 'math': RPCHandler<MathInput, MathOutput>,
+  readonly 'sleep': RPCHandler<SleepInput, null>,
+  readonly 'stringTransform': RPCHandler<StringTransformInput, StringTransformOutput>,
+  readonly 'typeConvert': RPCHandler<TypeConvertInput, TypeConvertOutput>,
   readonly 'editFields': RPCHandler<EditFieldsInput, EditFieldsOutput>,
   readonly 'merge': RPCHandler<MergeInput, MergeOutput>,
   readonly 'omit': RPCHandler<OmitInput, OmitOutput>,
@@ -444,16 +451,18 @@ export type FlattenedRPCMap = RPCMap
 
 
 export type RPCInvoke = <Name extends keyof FlattenedRPCMap>(
-  name: Name,
-  data: FlattenedRPCMap[Name]['input']
+  ...args: FlattenedRPCMap[Name]['input'] extends void | null
+    ? [name: Name]
+    : [name: Name, data: FlattenedRPCMap[Name]['input']]
 ) => Promise<FlattenedRPCMap[Name]['output']>
 
 export type RPCRemote = <Name extends keyof FlattenedRPCMap>(
-  name: Name,
-  data: FlattenedRPCMap[Name]['input']
+  ...args: FlattenedRPCMap[Name]['input'] extends void | null
+    ? [name: Name]
+    : [name: Name, data: FlattenedRPCMap[Name]['input']]
 ) => Promise<FlattenedRPCMap[Name]['output']>
 
-import type { WorkflowMap } from '../workflow/pikku-workflow-map.gen.d.js'
+import type { FlattenedWorkflowMap } from '../workflow/pikku-workflow-map.gen.d.js'
 
 import type { AgentMap } from '../agent/pikku-agent-map.gen.d.js'
 
@@ -469,12 +478,22 @@ interface AIAgentInput {
   resourceId: string
 }
 
-export type TypedStartWorkflow = <Name extends keyof WorkflowMap>(
+export type TypedStartWorkflow = <Name extends keyof FlattenedWorkflowMap>(
   name: Name,
-  input: WorkflowMap[Name]['input'],
+  input: FlattenedWorkflowMap[Name]['input'],
   options?: { startNode?: string }
 ) => Promise<{ runId: string }>
 
+export type TypedRunWorkflow = <Name extends keyof FlattenedWorkflowMap>(
+  name: Name,
+  input: FlattenedWorkflowMap[Name]['input']
+) => Promise<FlattenedWorkflowMap[Name]['output']>
+
+export type TypedWorkflowStatus = (
+  workflowName: string,
+  runId: string
+) => Promise<{ id: string; status: 'running' | 'suspended' | 'completed' | 'failed' | 'cancelled'; output?: unknown; error?: { message?: string } }>
+
 type TypedAgentRun = [keyof FlattenedAgentMap] extends [never]
   ? (name: string, input: AIAgentInput) => Promise<any>
   : <Name extends keyof FlattenedAgentMap>(

package/.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.json

@@ -0,0 +1,27 @@
+{
+  "aggregate": "aggregate",
+  "chunk": "chunk",
+  "find": "find",
+  "groupBy": "groupBy",
+  "limit": "limit",
+  "removeDuplicates": "removeDuplicates",
+  "reverse": "reverse",
+  "sort": "sort",
+  "splitOut": "splitOut",
+  "summarize": "summarize",
+  "unique": "unique",
+  "coalesce": "coalesce",
+  "crypto": "crypto",
+  "dateTime": "dateTime",
+  "jwtSign": "jwtSign",
+  "jwtDecode": "jwtDecode",
+  "math": "math",
+  "sleep": "sleep",
+  "stringTransform": "stringTransform",
+  "typeConvert": "typeConvert",
+  "editFields": "editFields",
+  "merge": "merge",
+  "omit": "omit",
+  "pick": "pick",
+  "renameKeys": "renameKeys"
+}

package/.pikku/rpc/pikku-rpc-wirings-meta.internal.gen.ts

@@ -0,0 +1,6 @@
+/**
+ * This file was generated by @pikku/cli@0.12.19
+ */
+import { pikkuState } from '@pikku/core/internal'
+import metaData from './pikku-rpc-wirings-meta.internal.gen.json' with { type: 'json' }
+pikkuState('@pikku/addon-graph', 'rpc', 'meta', metaData as Record<string, string>)

package/.pikku/scheduler/pikku-scheduler-types.gen.ts

@@ -0,0 +1,25 @@
+/**
+ * This file was generated by @pikku/cli@0.12.19
+ */
+/**
+ * Scheduler-specific type definitions for tree-shaking optimization
+ */
+
+import { CoreScheduledTask, wireScheduler as wireSchedulerCore } from '@pikku/core/scheduler'
+import type { PikkuFunctionConfig, PikkuMiddleware } from '../function/pikku-function-types.gen.js'
+
+/**
+ * Type definition for scheduled tasks that run at specified intervals.
+ * These are sessionless functions that execute based on cron expressions.
+ */
+type SchedulerWiring = CoreScheduledTask<PikkuFunctionConfig<void, void, 'session' | 'rpc'>, PikkuMiddleware>
+
+/**
+ * Registers a scheduled task with the Pikku framework.
+ * Tasks run based on cron expressions and are sessionless.
+ *
+ * @param task - Scheduled task definition with cron expression and handler
+ */
+export const wireScheduler = (task: SchedulerWiring) => {
+  wireSchedulerCore(task as any)
+}