@pikku/core 0.12.83 → 0.12.84

package/src/ecosystem/middleware.ts

@@ -0,0 +1,27 @@
+export { runMiddleware } from '../middleware-runner.js'
+export { authAPIKey } from '../middleware/auth-apikey.js'
+export { authCookie } from '../middleware/auth-cookie.js'
+export { pikkuRemoteAuthMiddleware } from '../middleware/remote-auth.js'
+export { telemetryInner, telemetryOuter } from '../middleware/telemetry.js'
+export { addGlobalPermission } from '../permissions.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type {
+  CorePermissionGroup,
+  CorePikkuPermission,
+} from '../function/functions.types.js'
+export type { LogLevel } from '../services/logger.js'
+export type { WebhookServiceConfig } from '../services/webhook-service.js'
+export type { RelativeTimeInput } from '../time-utils.js'
+export type {
+  CorePikkuMiddleware,
+  CorePikkuMiddlewareFactory,
+  CoreSingletonServices,
+  CoreUserSession,
+  PostgresConfig,
+} from '../types/core.types.js'
+export type { WorkflowServiceConfig } from '../wirings/workflow/workflow.types.js'

package/src/ecosystem/node-host-resolver.ts

@@ -0,0 +1 @@
+export { installNodeHostResolver } from '../utils/node-host-resolver.js'

package/src/ecosystem/node.ts

@@ -0,0 +1,5 @@
+export type {
+  CoreNodeConfig,
+  NodeType,
+  NodesMeta,
+} from '../wirings/node/node.types.js'

package/src/ecosystem/oauth2.ts

@@ -0,0 +1,4 @@
+export type {
+  OAuth2AppCredential,
+  OAuth2Token,
+} from '../wirings/oauth2/oauth2.types.js'

package/src/ecosystem/persona.ts

@@ -0,0 +1,30 @@
+export { HttpPersona, createHttpPersonas } from '../services/http-personas.js'
+export type { HttpPersonasConfig } from '../services/http-personas.js'
+export { personaEmails } from '../wirings/persona/persona-email.js'
+export {
+  personaEnvironmentErrors,
+  personaEnvironmentRefusal,
+} from '../wirings/persona/persona-environments.js'
+export type {
+  CorePersona,
+  PersonaAccountMeta,
+  PersonaDefinitions,
+} from '../wirings/persona/persona.types.js'
+export {
+  roleMismatchMessage,
+  validateAndBuildPersonasMeta,
+  verifyPersonaRoles,
+} from '../wirings/persona/validate-personas.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { ScenarioPersonas } from '../services/personas-service.js'
+export type {
+  PersonaEnvironment,
+  PersonaEnvironmentSubject,
+} from '../wirings/persona/persona-environments.js'
+export type { PersonasMeta } from '../wirings/persona/persona.types.js'
+export type { RoleVerification } from '../wirings/persona/validate-personas.js'

package/src/ecosystem/queue.ts

@@ -0,0 +1,23 @@
+export {
+  QueueJobDiscardedError,
+  QueueJobFailedError,
+} from '../wirings/queue/queue-runner.js'
+export type {
+  ConfigValidationResult,
+  CoreQueueWorker,
+  JobOptions,
+  PikkuJobConfig,
+  PikkuWorkerConfig,
+  QueueWorkers,
+  QueueWorkersMeta,
+} from '../wirings/queue/queue.types.js'
+export { registerQueueWorkers } from '../wirings/queue/register-queue-helper.js'
+export type { QueueConfigMapping } from '../wirings/queue/validate-worker-config.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { Logger } from '../services/logger.js'
+export type { QueueRegistrationCallback } from '../wirings/queue/register-queue-helper.js'

package/src/ecosystem/remote.ts

@@ -0,0 +1,9 @@
+export { buildRemoteHeaders } from '../remote.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { JWTService } from '../services/jwt-service.js'
+export type { SecretService } from '../services/secret-service.js'

package/src/ecosystem/role.ts

@@ -0,0 +1,13 @@
+export { defineSystemRole } from '../wirings/role/define-system-role.js'
+export type {
+  CoreSystemRole,
+  CoreSystemRoles,
+  SystemRole,
+  SystemRoleDefinitionMeta,
+  SystemRoleDefinitions,
+  SystemRoleDefinitionsMeta,
+} from '../wirings/role/role.types.js'
+export {
+  flattenSystemRoleDefinitions,
+  validateAndBuildSystemRoleDefinitionsMeta,
+} from '../wirings/role/validate-role-definitions.js'

package/src/ecosystem/rpc.ts

@@ -0,0 +1,7 @@
+export { wireAddon } from '../wirings/rpc/wire-addon.js'
+export type { WireAddonConfig } from '../wirings/rpc/wire-addon.js'
+export { wireRemoteAddon } from '../wirings/rpc/wire-remote-addon.js'
+export type {
+  RemoteAddonAuth,
+  WireRemoteAddonConfig,
+} from '../wirings/rpc/wire-remote-addon.js'

package/src/ecosystem/safe-fetch.ts

@@ -0,0 +1,8 @@
+export { safeFetch } from '../utils/safe-fetch.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { SafeFetchOptions } from '../utils/safe-fetch.js'

package/src/ecosystem/scenario.ts

@@ -0,0 +1,32 @@
+export type {
+  PikkuScenarioWire,
+  ScenarioStepMeta,
+} from '../wirings/workflow/dsl/workflow-dsl.types.js'
+export {
+  addFeature,
+  resolveFeatureScenarios,
+} from '../wirings/workflow/feature.js'
+export { PikkuScenarioService } from '../wirings/workflow/pikku-scenario-service.js'
+export { composeStepProse } from '../wirings/workflow/scenario-prose.js'
+export { SCENARIO_SURFACES } from '../wirings/workflow/scenario-step.types.js'
+export type {
+  PikkuBrowserWire,
+  ScenarioBrowserFailure,
+  ScenarioBrowserProvider,
+  ScenarioStepKind,
+  ScenarioStepOptions,
+  ScenarioStepPhase,
+} from '../wirings/workflow/scenario-step.types.js'
+export type {
+  CoreFeature,
+  FeaturesMeta,
+} from '../wirings/workflow/scenario.types.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { ScenarioSurface } from '../wirings/workflow/scenario-step.types.js'
+export type { FeaturePlanEntry } from '../wirings/workflow/scenario.types.js'
+export type { CoreWorkflow } from '../wirings/workflow/workflow.types.js'

package/src/ecosystem/scheduler.ts

@@ -0,0 +1,5 @@
+export { getScheduledTasks } from '../wirings/scheduler/scheduler-runner.js'
+export type {
+  CoreScheduledTask,
+  ScheduledTasksMeta,
+} from '../wirings/scheduler/scheduler.types.js'

package/src/ecosystem/schema.ts

@@ -0,0 +1 @@
+export { addSchema } from '../schema.js'

package/src/ecosystem/scope.ts

@@ -0,0 +1,14 @@
+export { defineScope } from '../wirings/scope/define-scope.js'
+export type {
+  CoreScopeNode,
+  CoreScopes,
+  FlatScope,
+  ScopeDefinitionMeta,
+  ScopeDefinitions,
+  ScopeDefinitionsMeta,
+  ScopeNodeMeta,
+} from '../wirings/scope/scope.types.js'
+export {
+  flattenScopeDefinitions,
+  validateAndBuildScopeDefinitionsMeta,
+} from '../wirings/scope/validate-scope-definitions.js'

package/src/ecosystem/secret.ts

@@ -0,0 +1,15 @@
+export type {
+  CoreSecret,
+  OAuth2CredentialConfig,
+  SecretDefinitionMeta,
+  SecretDefinitions,
+} from '../wirings/secret/secret.types.js'
+export { validateAndBuildSecretDefinitionsMeta } from '../wirings/secret/validate-secret-definitions.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { SchemaRefLike } from '../types/core.types.js'
+export type { SecretDefinitionsMeta } from '../wirings/secret/secret.types.js'

package/src/ecosystem/services/istanbul-coverage.ts

@@ -0,0 +1 @@
+export { IstanbulCoverageService } from '../../services/istanbul-coverage-service.js'

package/src/ecosystem/services/local-content-request-handler.ts

@@ -0,0 +1,16 @@
+export {
+  createLocalContentRequestHandler,
+  verifySignedContentRequest,
+} from '../../services/local-content-request-handler.js'
+export type { LocalContentRequestHandler } from '../../services/local-content-request-handler.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { JWTService } from '../../services/jwt-service.js'
+export type {
+  LocalContentRequestHandlerOptions,
+  SignedContentVerification,
+} from '../../services/local-content-request-handler.js'

package/src/ecosystem/services/local-content.ts

@@ -0,0 +1 @@
+export { signedContentPath } from '../../services/local-content.js'

package/src/ecosystem/services/v8-coverage.ts

@@ -0,0 +1 @@
+export { V8CoverageService } from '../../services/v8-coverage-service.js'

package/src/ecosystem/services.ts

@@ -0,0 +1,82 @@
+export type {
+  AuditDurability,
+  AuditEvent,
+  AuditEventBatch,
+} from '../services/audit-service.js'
+export type {
+  DeploymentConfig,
+  DeploymentService,
+  DeploymentServiceConfig,
+} from '../services/deployment-service.js'
+export { InMemoryAgentRunStateService } from '../services/in-memory-agent-run-state-service.js'
+export type {
+  AgentMeta,
+  AgentsMeta,
+  EmailTemplateMeta,
+  EmailsMeta,
+  GroupMeta,
+  MCPMeta,
+  MetaService,
+  MiddlewareDefinitionMeta,
+  MiddlewareGroupsMeta,
+  MiddlewareInstanceMeta,
+  PermissionDefinitionMeta,
+  PermissionsGroupsMeta,
+  RPCMetaRecord,
+  ServiceMeta,
+  ServicesMetaRecord,
+} from '../services/meta-service.js'
+export type {
+  ResolvedPersona,
+  ScenarioPersonas,
+} from '../services/personas-service.js'
+export { pikkuWebhookWorkerFunc } from '../services/queue-webhook-service.js'
+export type {
+  ScheduledTaskInfo,
+  ScheduledTaskSummary,
+} from '../services/scheduler-service.js'
+export type { Role } from '../services/scope-service.js'
+export { getStubTracker, spy } from '../services/stub-tracker.js'
+export type { CredentialMetaInfo } from '../services/typed-credential-service.js'
+export type { CredentialMeta } from '../services/typed-secret-service.js'
+export { TypedVariablesService } from '../services/typed-variables-service.js'
+export type { VariableMeta } from '../services/typed-variables-service.js'
+export {
+  PikkuSessionService,
+  createMiddlewareSessionWireProps,
+} from '../services/user-session-service.js'
+export type {
+  CoverageFunctionMeta,
+  CoverageService,
+  FunctionCoverageEntry,
+  FunctionCoverageReport,
+  ScriptCoverage,
+} from '../services/v8-coverage-service.js'
+export { PIKKU_OUTGOING_WEBHOOK_QUEUE_NAME } from '../services/webhook-service.js'
+export type {
+  SendWebhookInput,
+  SendWebhookResult,
+  WebhookAttemptResult,
+  WebhookDeliveryRecord,
+  WebhookDeliveryWithAttempts,
+} from '../services/webhook-service.js'
+export type {
+  FunctionMeta,
+  FunctionsMeta,
+  MiddlewareMetadata as MiddlewareMeta,
+  PermissionMetadata as PermissionMeta,
+} from '../types/core.types.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { Logger } from '../services/logger.js'
+export type { StubTracker } from '../services/stub-tracker.js'
+export type { SessionService } from '../services/user-session-service.js'
+export type {
+  WebhookJobData,
+  WebhookService,
+} from '../services/webhook-service.js'
+export type { CoreUserSession } from '../types/core.types.js'

package/src/ecosystem/testing.ts

@@ -0,0 +1,8 @@
+export { defineServiceTests } from '../testing/service-tests.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { ServiceTestConfig } from '../testing/service-tests.js'

package/src/ecosystem/trigger.ts

@@ -0,0 +1,7 @@
+export type {
+  CorePikkuTriggerFunction,
+  CorePikkuTriggerFunctionConfig,
+  CoreTrigger,
+  TriggerMeta,
+  TriggerSourceMeta,
+} from '../wirings/trigger/trigger.types.js'

package/src/ecosystem/types.ts

@@ -0,0 +1,34 @@
+export { isExpectedError } from '../errors/error-handler.js'
+export type { CorePermissionGroup } from '../function/functions.types.js'
+export { PikkuRequest } from '../pikku-request.js'
+export type {
+  AuditFacets,
+  AuditQuery,
+  AuditQueryResult,
+} from '../services/audit-service.js'
+export { parseDurationString } from '../time-utils.js'
+export type { RelativeTimeInput } from '../time-utils.js'
+export type {
+  AuthInstance,
+  FunctionServicesMeta,
+  FunctionWiresMeta,
+  JSONValue,
+  MiddlewareMetadata,
+  PermissionMetadata,
+  PikkuWire,
+  PikkuWiringTypes,
+  PostgresConfig,
+  SecretlessServices,
+  SecurityAuditIssue,
+  SecurityAuditReport,
+  SecurityAuditUpdate,
+  SecuritySeverity,
+  SecurityUpdateLevel,
+  SerializedError,
+} from '../types/core.types.js'
+export { isSerializable } from '../utils.js'
+export {
+  formatVersionedId,
+  isVersionedId,
+  parseVersionedId,
+} from '../version.js'

package/src/ecosystem/variable.ts

@@ -0,0 +1,14 @@
+export { validateAndBuildVariableDefinitionsMeta } from '../wirings/variable/validate-variable-definitions.js'
+export type {
+  CoreVariable,
+  VariableDefinitionMeta,
+  VariableDefinitions,
+  VariableDefinitionsMeta,
+} from '../wirings/variable/variable.types.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { SchemaRefLike } from '../types/core.types.js'

package/src/ecosystem/virtual-user.ts

@@ -0,0 +1,48 @@
+export {
+  personaScopes,
+  prepareVirtualUserRun,
+} from '../wirings/virtual-user/prepare-virtual-user-run.js'
+export {
+  catalogueClassification,
+  isReadOnly,
+  reachableCatalogue,
+  unreachableCatalogue,
+} from '../wirings/virtual-user/virtual-user-catalogue.js'
+export {
+  DISPOSITIONS,
+  dispositionProfile,
+} from '../wirings/virtual-user/virtual-user-dispositions.js'
+export type { DispositionProfile } from '../wirings/virtual-user/virtual-user-dispositions.js'
+export { intentsForPersona } from '../wirings/virtual-user/virtual-user-intents.js'
+export type {
+  VirtualUserRunOutcome,
+  VirtualUserRunRecord,
+  VirtualUserRunStart,
+  VirtualUserRunStore,
+} from '../wirings/virtual-user/virtual-user-run-store.js'
+export { PRODUCTION_DISPOSITION } from '../wirings/virtual-user/virtual-user.types.js'
+export type {
+  IntentSource,
+  VirtualUserFinding,
+  VirtualUserRunResult,
+} from '../wirings/virtual-user/virtual-user.types.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { FunctionsMeta } from '../types/core.types.js'
+export type {
+  SystemRoleDefinitions,
+  SystemRoleDefinitionsMeta,
+} from '../wirings/role/role.types.js'
+export type { VirtualUserPreparation } from '../wirings/virtual-user/prepare-virtual-user-run.js'
+export type { AgentReachability } from '../wirings/virtual-user/virtual-user-agents.js'
+export type { SchemaMap } from '../wirings/virtual-user/virtual-user-derive.js'
+export type { VirtualUserTuning } from '../wirings/virtual-user/virtual-user-dispositions.js'
+export type {
+  ApiCatalogueEntry,
+  VirtualUserDisposition,
+} from '../wirings/virtual-user/virtual-user.types.js'
+export type { WorkflowsMeta } from '../wirings/workflow/workflow.types.js'

package/src/ecosystem/workflow.ts

@@ -0,0 +1,68 @@
+export type { WorkflowService } from '../services/workflow-service.js'
+export type {
+  ApprovalStepMeta,
+  ArrayPredicateStepMeta,
+  BranchStepMeta,
+  CancelStepMeta,
+  Condition,
+  FanoutStepMeta,
+  FilterStepMeta,
+  InlineStepMeta,
+  InputSource,
+  OutputBinding,
+  ParallelGroupStepMeta,
+  PikkuWorkflowWire,
+  RpcStepMeta,
+  SetStepMeta,
+  SleepStepMeta,
+  SuspendStepMeta,
+  SwitchCaseMeta,
+  SwitchStepMeta,
+  WorkflowStepMeta,
+  WorkflowStepOptions,
+  WorkflowWireDoRPC,
+} from '../wirings/workflow/dsl/workflow-dsl.types.js'
+export { template } from '../wirings/workflow/graph/template.js'
+export type {
+  PikkuWorkflowGraphConfig,
+  PikkuWorkflowGraphResult,
+} from '../wirings/workflow/graph/wire-workflow-graph.js'
+export { isRef } from '../wirings/workflow/graph/workflow-graph.types.js'
+export {
+  buildRunTimeline,
+  reconstructFinalState,
+  reconstructStateAt,
+} from '../wirings/workflow/run-timeline.js'
+export type {
+  ReconstructedRunState,
+  RunTimeline,
+} from '../wirings/workflow/run-timeline.js'
+export { assertWorkflowRunOwner } from '../wirings/workflow/workflow-run-ownership.js'
+export type {
+  ContextVariable,
+  CoreWorkflow,
+  StepState,
+  StepStatus,
+  WorkflowContext,
+  WorkflowPlannedStep,
+  WorkflowQueueOptions,
+  WorkflowRun,
+  WorkflowRunMirror,
+  WorkflowRunService,
+  WorkflowRunStatus,
+  WorkflowRunWire,
+  WorkflowStatus,
+  WorkflowVersionStatus,
+  WorkflowsMeta,
+  WorkflowsRuntimeMeta,
+} from '../wirings/workflow/workflow.types.js'
+
+/**
+ * Types the exports above mention but do not themselves export. Without
+ * them a consumer's declaration emit has no name for the type it infers,
+ * and fails with TS2883 rather than reaching for the original entry point.
+ */
+export type { CoreUserSession } from '../types/core.types.js'
+export type { TemplateString } from '../wirings/workflow/graph/template.js'
+export type { RefValue } from '../wirings/workflow/graph/workflow-graph.types.js'
+export type { HistoryEntry } from '../wirings/workflow/run-timeline.js'

package/src/index.ts

@@ -28,7 +28,7 @@ export type {
   PermissionMetadata,
   PickOptional,
   PickRequired,
-  PikkuAIMiddlewareHooks,
+  PikkuAgentMiddlewareHooks,
   PikkuWire,
   PikkuRawWire,
   PikkuWiringTypes,
@@ -43,7 +43,7 @@ export type {
   SerializedError,
 } from './types/core.types.js'
 export {
-  pikkuAIMiddleware,
+  pikkuAgentMiddleware,
   pikkuChannelMiddleware,
   pikkuChannelMiddlewareFactory,
   pikkuMiddleware,
@@ -67,11 +67,7 @@ export {
   pikkuApprovalDescription,
 } from './function/functions.types.js'
 export { getAllFunctionNames } from './function/index.js'
-export type {
-  ListInput,
-  ListOutput,
-  Filter,
-} from './function/list.types.js'
+export type { ListInput, ListOutput, Filter } from './function/list.types.js'
 export { pikkuCLIRender } from './wirings/cli/cli-runner.js'
 export { PikkuRequest } from './pikku-request.js'
 export {
@@ -84,10 +80,7 @@ export {
   isVersionedId,
   parseVersionedId,
 } from './version.js'
-export {
-  AbandonedError,
-  type AbortScope,
-} from './function/abort-scope.js'
+export { AbandonedError, type AbortScope } from './function/abort-scope.js'
 export { fetch } from './wirings/http/http-runner.js'
 export type {
   MCPToolResponse,
@@ -192,12 +185,10 @@ export type {
   AuditUserIdentity,
   ResolvedAuditConfig,
 } from './services/audit-service.js'
-export type {
-  AIAgentRunnerService,
-} from './services/ai-agent-runner-service.js'
+export type { AgentRunnerService } from './services/agent-runner-service.js'
 export type { AIEmbeddingService } from './services/ai-embedding-service.js'
-export type { AIRunStateService } from './services/ai-run-state-service.js'
-export type { AIStorageService } from './services/ai-storage-service.js'
+export type { AgentRunStateService } from './services/agent-run-state-service.js'
+export type { AgentStorageService } from './services/agent-storage-service.js'
 export type {
   EmailsMeta,
   EmailTemplateMeta,
@@ -242,9 +233,7 @@ export type {
   HashedValue,
 } from './data-classification.js'
 
-export {
-  hashToken,
-} from './column-form.js'
+export { hashToken } from './column-form.js'
 
 export type { SecretValue, Safe } from './secret-value.js'
 export {

package/src/pikku-state.ts

@@ -9,8 +9,8 @@ import type {
   MCPToolMeta,
   MCPPromptMeta,
 } from './wirings/mcp/mcp.types.js'
-import type { AIAgentMeta } from './wirings/ai-agent/ai-agent.types.js'
-import type { ScorerMeta } from './wirings/ai-scorer/ai-scorer.types.js'
+import type { AgentsMeta } from './wirings/agent/agent.types.js'
+import type { ScorerMeta } from './wirings/agent-scorer/agent-scorer.types.js'
 import type { GatewaysMeta } from './wirings/gateway/gateway.types.js'
 import type { ScheduledTasksMeta } from './wirings/scheduler/scheduler.types.js'
 import type { TriggerMeta } from './wirings/trigger/trigger.types.js'
@@ -118,7 +118,7 @@ const createEmptyPackageState = (): PikkuPackageState => ({
   },
   agent: {
     agents: new Map(),
-    agentsMeta: {} as AIAgentMeta,
+    agentsMeta: {} as AgentsMeta,
     scorers: new Map(),
     scorersMeta: {} as ScorerMeta,
     modelAliases: {},