@pikku/addon-graph 0.0.1

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

@@ -0,0 +1,78 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+/**
+ * Addon package types for pikkuAddonConfig and pikkuAddonServices
+ */
+
+import type { CreateConfig } from '@pikku/core'
+import type { SingletonServices } from '../../types/application-types.d.js'
+import type { Config } from '../../types/application-types.d.js'
+import type { RequiredSingletonServices } from '../pikku-services.gen.js'
+import { TypedSecretService } from '../secrets/pikku-secrets.gen.js'
+import { TypedVariablesService } from '../variables/pikku-variables.gen.js'
+
+
+
+
+/**
+ * Base services provided to addon package service factories.
+ * These are always available from the parent application.
+ */
+export type AddonBaseServices = {
+  logger: SingletonServices['logger']
+  variables: TypedVariablesService
+  secrets: TypedSecretService
+}
+
+/**
+ * Creates a Pikku config factory for addon packages.
+ * Unlike pikkuConfig, this receives AddonBaseServices (logger, variables, secrets)
+ * from the parent application, so addon packages can read variables/secrets during config creation.
+ */
+export const pikkuAddonConfig = <ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(
+  func: (services: ExistingServices) => Promise<Config>
+): CreateConfig<Config> => {
+  return (async (_variables: any, existingServices?: Partial<SingletonServices>): Promise<Config> => {
+    const { secrets, variables, ...rest } = (existingServices ?? {}) as unknown as SingletonServices
+    return func({ ...rest, secrets: new TypedSecretService(secrets), variables: new TypedVariablesService(variables) } as ExistingServices)
+  }) as unknown as CreateConfig<Config>
+}
+
+/**
+ * Creates a Pikku singleton services factory for addon packages.
+ * Unlike pikkuServices, this expects the parent application to provide
+ * logger, variables, and secrets - no fallbacks needed.
+ *
+ * @param func - Addon services factory function that receives config and base services
+ * @returns The singleton services factory function
+ *
+ * @example
+ * ```typescript
+ * export const createSingletonServices = pikkuAddonServices(async (
+ *   config,
+ *   { secrets }
+ * ) => {
+ *   const creds = await secrets.getSecretJSON<GithubCredentials>('GITHUB_CREDENTIALS')
+ *   const github = new GithubService(creds)
+ *   return { github }
+ * })
+ * ```
+ */
+export const pikkuAddonServices = <T extends Record<string, any>, ExistingServices extends Omit<Partial<SingletonServices>, 'variables' | 'secrets'> & AddonBaseServices>(
+  func: (config: Config, services: ExistingServices) => Promise<T>
+) => {
+  return async (config: Config, existingServices?: Partial<SingletonServices>): Promise<RequiredSingletonServices> => {
+    const { logger, variables, secrets } = (existingServices ?? {}) as unknown as SingletonServices
+    const typedVariables = new TypedVariablesService(variables)
+    const typedSecrets = new TypedSecretService(secrets)
+    const result = await func(config, { ...existingServices, logger, variables: typedVariables, secrets: typedSecrets } as ExistingServices)
+    return {
+      config,
+      logger,
+      variables: typedVariables,
+      secrets: typedSecrets,
+      ...result,
+    } as unknown as RequiredSingletonServices
+  }
+}

package/.pikku/addon/pikku-package.gen.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import { pikkuState } from '@pikku/core/internal'
+import { createSingletonServices as createSingletonServices } from '../../src/services.js'
+
+pikkuState('@pikku/addon-graph', 'package', 'factories', {
+  createSingletonServices,
+})

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

@@ -0,0 +1,16 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+/**
+ * Agent type map with output types for each agent
+ */
+
+
+
+
+interface AgentHandler<O> {
+    output: O;
+}
+
+export type AgentMap = {
+};

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

@@ -0,0 +1,76 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import {
+  CoreAIAgent,
+  PikkuAIMiddlewareHooks,
+} from '@pikku/core/ai-agent'
+import {
+  agent as coreAgent,
+  agentStream as coreAgentStream,
+  agentResume as coreAgentResume,
+  agentApprove as coreAgentApprove,
+} from '@pikku/core/ai-agent'
+import type { PikkuPermission, PikkuMiddleware, Services, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js'
+import type { StandardSchemaV1 } from '@standard-schema/spec'
+import type { AIAgentMemoryConfig, AIAgentInput } from '@pikku/core/ai-agent'
+import type { AgentMap } from './pikku-agent-map.gen.d.js'
+
+type AIAgentConfig = Omit<CoreAIAgent<PikkuPermission, PikkuMiddleware>, 'tools' | 'agents' | 'memory'> & {
+  input?: StandardSchemaV1
+  output?: StandardSchemaV1
+  memory?: Omit<AIAgentMemoryConfig, 'workingMemory'> & { workingMemory?: StandardSchemaV1 }
+  tools?: object[]
+  agents?: AIAgentConfig[]
+}
+
+export const pikkuAIAgent = (
+  agent: AIAgentConfig
+) => {
+  return agent
+}
+
+export const pikkuAIMiddleware = <
+  State extends Record<string, unknown> = Record<string, unknown>,
+  RequiredServices extends Services = Services,
+>(
+  hooks: PikkuAIMiddlewareHooks<State, RequiredServices>
+): PikkuAIMiddlewareHooks<State, RequiredServices> => hooks
+
+export const agent = <Name extends keyof AgentMap>(
+  agentName: Name
+) => {
+  return coreAgent<AgentMap>(agentName as string & keyof AgentMap) as PikkuFunctionConfig<
+    AIAgentInput,
+    { runId: string; result: AgentMap[Name]['output']; usage: { inputTokens: number; outputTokens: number } },
+    'session' | 'rpc'
+  >
+}
+
+export const agentStream = <Name extends keyof AgentMap>(
+  agentName?: Name
+) => {
+  return coreAgentStream<AgentMap>(agentName as string & keyof AgentMap) as PikkuFunctionConfig<
+    { agentName?: string; message: string; threadId: string; resourceId: string },
+    void,
+    'session' | 'rpc'
+  >
+}
+
+export const agentResume = () => {
+  return coreAgentResume() as PikkuFunctionConfig<
+    { runId: string; toolCallId: string; approved: boolean },
+    void,
+    'session' | 'rpc'
+  >
+}
+
+export const agentApprove = <Name extends keyof AgentMap>(
+  agentName: Name
+) => {
+  return coreAgentApprove<AgentMap>(agentName as string & keyof AgentMap) as PikkuFunctionConfig<
+    { runId: string; approvals: { toolCallId: string; approved: boolean }[] },
+    unknown,
+    'session' | 'rpc'
+  >
+}

package/.pikku/agent/pikku-agent-wirings-meta.gen.json

@@ -0,0 +1,3 @@
+{
+  "agentsMeta": {}
+}

package/.pikku/agent/pikku-agent-wirings-meta.gen.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import { pikkuState } from '@pikku/core/internal'
+import type { AIAgentMeta } from '@pikku/core/ai-agent'
+import metaData from './pikku-agent-wirings-meta.gen.json' with { type: 'json' }
+pikkuState('@pikku/addon-graph', 'agent', 'agentsMeta', metaData.agentsMeta as AIAgentMeta)

package/.pikku/agent/pikku-agent-wirings.gen.ts

@@ -0,0 +1,3 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */

package/.pikku/console/pikku-node-types.gen.ts

@@ -0,0 +1,8 @@
+/**
+ * This file was generated by @pikku/cli@0.12.1
+ */
+import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.js'
+
+export type NodeCategory = 'Transform' | 'Array' | 'Data'
+
+export type NodeRPCName = keyof FlattenedRPCMap

package/.pikku/console/pikku-nodes-meta.gen.json

@@ -0,0 +1,278 @@
+{
+  "nodes": {
+    "aggregate": {
+      "name": "aggregate",
+      "displayName": "Aggregate",
+      "category": "Array",
+      "type": "action",
+      "rpc": "aggregate",
+      "description": "Combine a field from many items into a list in a single item",
+      "errorOutput": false,
+      "inputSchemaName": "AggregateInput",
+      "outputSchemaName": "AggregateOutput"
+    },
+    "chunk": {
+      "name": "chunk",
+      "displayName": "Chunk",
+      "category": "Array",
+      "type": "action",
+      "rpc": "chunk",
+      "description": "Split array into chunks of specified size",
+      "errorOutput": false,
+      "inputSchemaName": "ChunkInput",
+      "outputSchemaName": "ChunkOutput"
+    },
+    "find": {
+      "name": "find",
+      "displayName": "Find",
+      "category": "Array",
+      "type": "action",
+      "rpc": "find",
+      "description": "Find the first item matching a field value",
+      "errorOutput": false,
+      "inputSchemaName": "FindInput",
+      "outputSchemaName": "FindOutput"
+    },
+    "groupBy": {
+      "name": "groupBy",
+      "displayName": "Group By",
+      "category": "Array",
+      "type": "action",
+      "rpc": "groupBy",
+      "description": "Group items by a field value",
+      "errorOutput": false,
+      "inputSchemaName": "GroupByInput",
+      "outputSchemaName": "GroupByOutput"
+    },
+    "limit": {
+      "name": "limit",
+      "displayName": "Limit",
+      "category": "Array",
+      "type": "action",
+      "rpc": "limit",
+      "description": "Restrict the number of items",
+      "errorOutput": false,
+      "inputSchemaName": "LimitInput",
+      "outputSchemaName": "LimitOutput"
+    },
+    "removeDuplicates": {
+      "name": "removeDuplicates",
+      "displayName": "Remove Duplicates",
+      "category": "Array",
+      "type": "action",
+      "rpc": "removeDuplicates",
+      "description": "Delete items with matching field values",
+      "errorOutput": false,
+      "inputSchemaName": "RemoveDuplicatesInput",
+      "outputSchemaName": "RemoveDuplicatesOutput"
+    },
+    "reverse": {
+      "name": "reverse",
+      "displayName": "Reverse",
+      "category": "Array",
+      "type": "action",
+      "rpc": "reverse",
+      "description": "Reverse the order of items in an array",
+      "errorOutput": false,
+      "inputSchemaName": "ReverseInput",
+      "outputSchemaName": "ReverseOutput"
+    },
+    "sort": {
+      "name": "sort",
+      "displayName": "Sort",
+      "category": "Array",
+      "type": "action",
+      "rpc": "sort",
+      "description": "Change items order",
+      "errorOutput": false,
+      "inputSchemaName": "SortInput",
+      "outputSchemaName": "SortOutput"
+    },
+    "splitOut": {
+      "name": "splitOut",
+      "displayName": "Split Out",
+      "category": "Array",
+      "type": "action",
+      "rpc": "splitOut",
+      "description": "Turn a list inside item(s) into separate items",
+      "errorOutput": false,
+      "inputSchemaName": "SplitOutInput",
+      "outputSchemaName": "SplitOutOutput"
+    },
+    "summarize": {
+      "name": "summarize",
+      "displayName": "Summarize",
+      "category": "Array",
+      "type": "action",
+      "rpc": "summarize",
+      "description": "Sum, count, max, etc. across items",
+      "errorOutput": false,
+      "inputSchemaName": "SummarizeInput",
+      "outputSchemaName": "SummarizeOutput"
+    },
+    "unique": {
+      "name": "unique",
+      "displayName": "Unique",
+      "category": "Array",
+      "type": "action",
+      "rpc": "unique",
+      "description": "Get unique values from an array",
+      "errorOutput": false,
+      "inputSchemaName": "UniqueInput",
+      "outputSchemaName": "UniqueOutput"
+    },
+    "coalesce": {
+      "name": "coalesce",
+      "displayName": "Coalesce",
+      "category": "Data",
+      "type": "action",
+      "rpc": "coalesce",
+      "description": "Return the first non-null value",
+      "errorOutput": false,
+      "inputSchemaName": "CoalesceInput",
+      "outputSchemaName": "CoalesceOutput"
+    },
+    "crypto": {
+      "name": "crypto",
+      "displayName": "Crypto",
+      "category": "Data",
+      "type": "action",
+      "rpc": "crypto",
+      "description": "Provide cryptographic utilities",
+      "errorOutput": false,
+      "inputSchemaName": "CryptoInput",
+      "outputSchemaName": "CryptoOutput"
+    },
+    "dateTime": {
+      "name": "dateTime",
+      "displayName": "Date & Time",
+      "category": "Data",
+      "type": "action",
+      "rpc": "dateTime",
+      "description": "Manipulate date and time values",
+      "errorOutput": false,
+      "inputSchemaName": "DateTimeInput",
+      "outputSchemaName": "DateTimeOutput"
+    },
+    "jwtSign": {
+      "name": "jwtSign",
+      "displayName": "JWT Sign",
+      "category": "Data",
+      "type": "action",
+      "rpc": "jwtSign",
+      "description": "Sign a payload into a JWT token",
+      "errorOutput": false,
+      "inputSchemaName": "JwtSignInput",
+      "outputSchemaName": "JwtSignOutput"
+    },
+    "jwtDecode": {
+      "name": "jwtDecode",
+      "displayName": "JWT Decode",
+      "category": "Data",
+      "type": "action",
+      "rpc": "jwtDecode",
+      "description": "Decode a JWT token into its payload",
+      "errorOutput": false,
+      "inputSchemaName": "JwtDecodeInput",
+      "outputSchemaName": "JwtDecodeOutput"
+    },
+    "math": {
+      "name": "math",
+      "displayName": "Math",
+      "category": "Data",
+      "type": "action",
+      "rpc": "math",
+      "description": "Perform math operations",
+      "errorOutput": false,
+      "inputSchemaName": "MathInput",
+      "outputSchemaName": "MathOutput"
+    },
+    "stringTransform": {
+      "name": "stringTransform",
+      "displayName": "String Transform",
+      "category": "Data",
+      "type": "action",
+      "rpc": "stringTransform",
+      "description": "Transform strings (case, trim, split, replace, etc.)",
+      "errorOutput": false,
+      "inputSchemaName": "StringTransformInput",
+      "outputSchemaName": "StringTransformOutput"
+    },
+    "typeConvert": {
+      "name": "typeConvert",
+      "displayName": "Type Convert",
+      "category": "Data",
+      "type": "action",
+      "rpc": "typeConvert",
+      "description": "Convert between types (string, number, boolean, json, array)",
+      "errorOutput": false,
+      "inputSchemaName": "TypeConvertInput",
+      "outputSchemaName": "TypeConvertOutput"
+    },
+    "editFields": {
+      "name": "editFields",
+      "displayName": "Edit Fields",
+      "category": "Transform",
+      "type": "action",
+      "rpc": "editFields",
+      "description": "Modify, add, or remove item fields",
+      "errorOutput": false,
+      "inputSchemaName": "EditFieldsInput",
+      "outputSchemaName": "EditFieldsOutput"
+    },
+    "merge": {
+      "name": "merge",
+      "displayName": "Merge",
+      "category": "Transform",
+      "type": "action",
+      "rpc": "merge",
+      "description": "Merge multiple objects into one",
+      "errorOutput": false,
+      "inputSchemaName": "MergeInput",
+      "outputSchemaName": "MergeOutput"
+    },
+    "omit": {
+      "name": "omit",
+      "displayName": "Omit",
+      "category": "Transform",
+      "type": "action",
+      "rpc": "omit",
+      "description": "Remove specified fields from an object",
+      "errorOutput": false,
+      "inputSchemaName": "OmitInput",
+      "outputSchemaName": "OmitOutput"
+    },
+    "pick": {
+      "name": "pick",
+      "displayName": "Pick",
+      "category": "Transform",
+      "type": "action",
+      "rpc": "pick",
+      "description": "Keep only specified fields from an object",
+      "errorOutput": false,
+      "inputSchemaName": "PickInput",
+      "outputSchemaName": "PickOutput"
+    },
+    "renameKeys": {
+      "name": "renameKeys",
+      "displayName": "Rename Keys",
+      "category": "Transform",
+      "type": "action",
+      "rpc": "renameKeys",
+      "description": "Update item field names",
+      "errorOutput": false,
+      "inputSchemaName": "RenameKeysInput",
+      "outputSchemaName": "RenameKeysOutput"
+    }
+  },
+  "secrets": {},
+  "package": {
+    "displayName": "Pikku Utils",
+    "description": "Data transformation and utility functions",
+    "categories": [
+      "Transform",
+      "Array",
+      "Data"
+    ]
+  }
+}