@pikku/addon-meta-conversions 0.1.1 → 0.1.3

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

@@ -0,0 +1,160 @@
+/**
+ * This file was generated by @pikku/cli@0.12.96
+ */
+/**
+ * Trigger-specific type definitions for tree-shaking optimization
+ */
+
+import { CorePikkuTriggerFunction, CorePikkuTriggerFunctionConfig, CoreTrigger, wireTrigger as wireTriggerCore, wireTriggerSource as wireTriggerSourceCore } from '@pikku/core/trigger'
+import type { CoreNodeConfig } from '@pikku/core/node'
+import type { SingletonServices } from '../../types/application-types.d.js'
+import type { StandardSchemaV1 } from '@standard-schema/spec'
+
+
+
+/**
+ * A trigger function that sets up a subscription and returns a teardown function.
+ * The trigger is fired via wire.trigger.invoke(data).
+ *
+ * @template TInput - Input type (configuration passed when wired)
+ * @template TOutput - Output type produced when trigger fires
+ */
+export type PikkuTriggerFunction<
+  TInput = unknown,
+  TOutput = unknown
+> = CorePikkuTriggerFunction<TInput, TOutput, SingletonServices>
+
+/**
+ * Configuration object for creating a trigger function with metadata
+ */
+export type PikkuTriggerFunctionConfig<
+  TInput = unknown,
+  TOutput = unknown,
+  InputSchema extends StandardSchemaV1 | undefined = undefined,
+  OutputSchema extends StandardSchemaV1 | undefined = undefined
+> = CorePikkuTriggerFunctionConfig<TInput, TOutput, SingletonServices, InputSchema, OutputSchema>
+
+/**
+ * Helper type to infer the output type from a Standard Schema
+ */
+type InferSchemaOutput<T> = T extends StandardSchemaV1<any, infer Output> ? Output : never
+
+/**
+ * Configuration object for trigger functions with Zod schema validation.
+ * Use this when you want to define input/output schemas using Zod.
+ * Types are automatically inferred from the schemas.
+ */
+export type PikkuTriggerFunctionConfigWithSchema<
+  InputSchema extends StandardSchemaV1,
+  OutputSchema extends StandardSchemaV1 | undefined = undefined
+> = {
+  title?: string
+  description?: string
+  tags?: string[]
+  func: PikkuTriggerFunction<
+    InferSchemaOutput<InputSchema>,
+    OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown
+  >
+  input: InputSchema
+  output?: OutputSchema
+  node?: CoreNodeConfig
+}
+
+/**
+ * Type definition for trigger wirings.
+ * Declares a trigger name and its target pikku function.
+ */
+export type TriggerWiring = CoreTrigger
+
+/**
+ * A trigger source with the subscription function, using project-specific services.
+ *
+ * @template TInput - Input type passed to the trigger function
+ * @template TOutput - Output type produced when trigger fires
+ */
+export type TriggerSource<
+  TInput = unknown,
+  TOutput = unknown
+> = {
+  name: string
+  func: PikkuTriggerFunctionConfig<TInput, TOutput>
+} & (unknown extends TInput ? { input?: TInput } : { input: TInput })
+
+/**
+ * Creates a trigger function configuration.
+ * Use this to define trigger functions that set up subscriptions.
+ *
+ * @param triggerOrConfig - Function definition or configuration object
+ * @returns The normalized configuration object
+ *
+ * @example
+ * ```typescript
+ * export const redisSubscribeTrigger = pikkuTriggerFunc<
+ *   { channel: string },
+ *   { message: string }
+ * >(async ({ redis }, { channel }, { trigger }) => {
+ *   const subscriber = redis.duplicate()
+ *   await subscriber.subscribe(channel, (msg) => {
+ *     trigger.invoke({ message: msg })
+ *   })
+ *   return () => subscriber.unsubscribe()
+ * })
+ *
+ * export const redisSubscribeTrigger = pikkuTriggerFunc({
+ *   title: 'Redis Subscribe Trigger',
+ *   description: 'Listens to Redis pub/sub channel',
+ *   input: z.object({ channel: z.string() }),
+ *   output: z.object({ message: z.string() }),
+ *   func: async ({ redis }, { channel }, { trigger }) => {
+ *     const subscriber = redis.duplicate()
+ *     await subscriber.subscribe(channel, (msg) => {
+ *       trigger.invoke({ message: msg })
+ *     })
+ *     return () => subscriber.unsubscribe()
+ *   }
+ * })
+ * ```
+ */
+export function pikkuTriggerFunc<
+  InputSchema extends StandardSchemaV1,
+  OutputSchema extends StandardSchemaV1 | undefined = undefined
+>(
+  config: PikkuTriggerFunctionConfigWithSchema<InputSchema, OutputSchema>
+): PikkuTriggerFunctionConfig<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, InputSchema, OutputSchema>
+export function pikkuTriggerFunc<TInput, TOutput = unknown>(
+  triggerOrConfig:
+    | PikkuTriggerFunction<TInput, TOutput>
+    | PikkuTriggerFunctionConfig<TInput, TOutput>
+): PikkuTriggerFunctionConfig<TInput, TOutput>
+export function pikkuTriggerFunc(triggerOrConfig: any) {
+  if (typeof triggerOrConfig === 'function') {
+    return { func: triggerOrConfig }
+  }
+  return triggerOrConfig
+}
+
+/**
+ * Registers a trigger with the Pikku framework.
+ * Declares a trigger name and its target pikku function.
+ * Runs everywhere — inspector extracts at build time.
+ *
+ * @param trigger - Trigger definition with name and function config
+ */
+export const wireTrigger = (
+  trigger: TriggerWiring
+) => {
+  wireTriggerCore(trigger as any)
+}
+
+/**
+ * Registers a trigger source with the Pikku framework.
+ * Provides the subscription function and input data.
+ * Only imported in the trigger worker process.
+ *
+ * @param source - Trigger source with name, func, and input
+ */
+export const wireTriggerSource = <TInput = unknown, TOutput = unknown>(
+  source: TriggerSource<TInput, TOutput>
+) => {
+  wireTriggerSourceCore(source as any)
+}

package/.pikku/variables/pikku-variable-types.gen.ts

@@ -0,0 +1,5 @@
+/**
+ * This file was generated by @pikku/cli@0.12.96
+ */
+export { defineVariable } from '@pikku/core/variable'
+export type { CoreVariable, VariableDefinitionMeta, VariableDefinitionsMeta } from '@pikku/core/variable'

package/.pikku/variables/pikku-variables-meta.gen.json

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

package/.pikku/variables/pikku-variables.gen.ts

@@ -0,0 +1,34 @@
+/**
+ * This file was generated by @pikku/cli@0.12.96
+ */
+import { TypedVariablesService as CoreTypedVariablesService, type VariableMeta } from '@pikku/core/services'
+import type { VariablesService } from '@pikku/core/services'
+import type { VariableDefinitionsMeta } from '@pikku/core/variable'
+import variablesMeta from './pikku-variables-meta.gen.json' with { type: 'json' }
+
+/**
+ * Every variable declared in this package.
+ *
+ * Read from the metadata sidecar rather than inlined, so that the import above
+ * forces tsc to emit the .json alongside this file. An addon publishes only its
+ * compiled output, and a host reads that .json to discover the addon's declared
+ * variables — an uncopied sidecar leaves them invisible to the host.
+ */
+export const VARIABLES_META: VariableDefinitionsMeta =
+  variablesMeta as VariableDefinitionsMeta
+
+export interface VariablesMap {
+
+}
+
+export type VariableId = keyof VariablesMap
+
+const TYPED_VARIABLES_META: Record<string, VariableMeta> = {
+
+}
+
+export class TypedVariablesService extends CoreTypedVariablesService<VariablesMap> {
+  constructor(variables: VariablesService) {
+    super(variables, TYPED_VARIABLES_META)
+  }
+}

package/.pikku/workflow/personas.gen.json

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

package/.pikku/workflow/pikku-personas.gen.ts

@@ -0,0 +1,38 @@
+/**
+ * This file was generated by @pikku/cli@0.12.96
+ */
+/** Personas declared with definePersonas() */
+import { createHttpPersonas } from '@pikku/core/persona'
+import type {
+  HttpPersonasConfig,
+  ScenarioPersona,
+  ResolvedPersona,
+} from '@pikku/core/services'
+import type { AgentMap } from '../agent/pikku-agent-map.gen.d.js'
+import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.gen.d.js'
+
+export const personaConfigs = {} as const satisfies Record<string, ResolvedPersona>
+
+export type PersonaName = keyof typeof personaConfigs
+
+/**
+ * The same personas as a list, widened to `ResolvedPersona`. Iterating
+ * `personaConfigs` directly yields the literal type of each entry, on which an
+ * optional field a persona did not declare does not exist — so a seed reading
+ * `roles` off every persona needs this instead.
+ */
+export const personaList: ResolvedPersona[] = Object.values(personaConfigs)
+
+export type AgentName = keyof AgentMap & string
+export type TypedPersonas = Record<
+  PersonaName,
+  ScenarioPersona<AgentName, FlattenedRPCMap>
+>
+
+export const createPersonas = (
+  options: Omit<HttpPersonasConfig, 'personas'>
+): TypedPersonas =>
+  createHttpPersonas({
+    ...options,
+    personas: personaConfigs,
+  }) as TypedPersonas

package/.pikku/workflow/pikku-scenario-step-map.gen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file was generated by @pikku/cli@0.12.96
+ */
+/**
+ * Scenario step map: the names `scenario.step/given/when/then` accepts, with
+ * the input and output types of each step.
+ */
+
+
+
+
+interface ScenarioStepHandler<I, O> {
+    input: I;
+    output: O;
+}
+
+export type FlattenedScenarioStepMap = {
+};

package/.pikku/workflow/pikku-workflow-map.gen.d.ts

@@ -0,0 +1,38 @@
+/**
+ * This file was generated by @pikku/cli@0.12.96
+ */
+/**
+ * Workflow type map with input/output types for each workflow
+ */
+
+
+
+
+
+interface WorkflowHandler<I, O> {
+    input: I;
+    output: O;
+}
+
+interface GraphNodeHandler<I> {
+    input: I;
+}
+
+export type WorkflowMap = {
+};
+
+export type GraphsMap = {
+};
+
+export type FlattenedWorkflowMap = WorkflowMap
+
+
+export type WorkflowClient<Name extends keyof FlattenedWorkflowMap> = {
+  start: (input: FlattenedWorkflowMap[Name]['input']) => Promise<{ runId: string }>;
+  getRun: <output extends keyof FlattenedWorkflowMap[Name]>(runId: string) => Promise<FlattenedWorkflowMap[Name][output]>;
+  cancelRun: (runId: string) => Promise<boolean>;
+}
+
+export type TypedWorkflowClients = {
+  [Name in keyof FlattenedWorkflowMap]: WorkflowClient<Name>;
+}