@pikku/cli 0.12.93 → 0.12.99

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

@@ -37,7 +37,6 @@
     "dbGenerate": "dbGenerate",
     "dbMigrate": "dbMigrate",
     "dbReset": "dbReset",
-    "dbSeed": "dbSeed",
     "deployApply": "deployApply",
     "deployInfo": "deployInfo",
     "deployPlan": "deployPlan",
@@ -85,8 +84,13 @@
     "pikkuNewMiddleware": "pikkuNewMiddleware",
     "pikkuNewPermission": "pikkuNewPermission",
     "pikkuNewWiring": "pikkuNewWiring",
+    "personaSync": "personaSync",
+    "personaRun": "personaRun",
+    "personaList": "personaList",
     "pikkuBootstrap": "pikkuBootstrap",
     "pikkuSummary": "pikkuSummary",
+    "rolesAudit": "rolesAudit",
+    "rolesPrune": "rolesPrune",
     "scenarioList": "scenarioList",
     "scenarioRun": "scenarioRun",
     "scopesAudit": "scopesAudit",
@@ -141,6 +145,7 @@
     "pikkuVariableDefinitionTypes": "pikkuVariableDefinitionTypes",
     "pikkuPackage": "pikkuPackage",
     "pikkuPermissions": "pikkuPermissions",
+    "pikkuPersonas": "pikkuPersonas",
     "pikkuCommandQueueMap": "pikkuCommandQueueMap",
     "pikkuQueueService": "pikkuQueueService",
     "pikkuQueueTypes": "pikkuQueueTypes",
@@ -149,6 +154,7 @@
     "pikkuQueue": "pikkuQueue",
     "pikkuEventsScaffold": "pikkuEventsScaffold",
     "pikkuRealtime": "pikkuRealtime",
+    "pikkuRoles": "pikkuRoles",
     "pikkuPublicRPC": "pikkuPublicRPC",
     "pikkuReactQuery": "pikkuReactQuery",
     "pikkuRemoteRPC": "pikkuRemoteRPC",
@@ -165,6 +171,7 @@
     "pikkuTrigger": "pikkuTrigger",
     "pikkuUserAdminFunctions": "pikkuUserAdminFunctions",
     "pikkuVariables": "pikkuVariables",
+    "pikkuVirtualUserFunctions": "pikkuVirtualUserFunctions",
     "pikkuWebhook": "pikkuWebhook",
     "pikkuWorkflowRoutes": "pikkuWorkflowRoutes",
     "pikkuWorkflow": "pikkuWorkflow"

package/dist/.pikku/scenarios/pikku-scenario-functions-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { pikkuState } from '@pikku/core/internal';
 import '../function/pikku-functions-meta.gen.js';

package/dist/.pikku/scenarios/pikku-scenario-functions.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 export {};

package/dist/.pikku/scenarios/pikku-scenario-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { pikkuState } from '@pikku/core/internal';
 import '../workflow/pikku-workflow-wirings-meta.gen.js';

package/dist/.pikku/scenarios/pikku-scenario-wirings.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 export {};

package/dist/.pikku/scenarios/schemas/register.gen.d.ts

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 export declare const empty: null;

package/dist/.pikku/scenarios/schemas/register.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 export const empty = null;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 /**
  * Scheduler-specific type definitions for tree-shaking optimization

package/dist/.pikku/scheduler/pikku-scheduler-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 /**
  * Scheduler-specific type definitions for tree-shaking optimization

package/dist/.pikku/schemas/register.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { addSchema } from '@pikku/core/schema';
 import * as BinaryInput from './schemas/BinaryInput.schema.json' with { type: 'json' };
@@ -20,8 +20,6 @@ import * as DbMigrateInput from './schemas/DbMigrateInput.schema.json' with { ty
 addSchema('DbMigrateInput', DbMigrateInput);
 import * as DbResetInput from './schemas/DbResetInput.schema.json' with { type: 'json' };
 addSchema('DbResetInput', DbResetInput);
-import * as DbSeedInput from './schemas/DbSeedInput.schema.json' with { type: 'json' };
-addSchema('DbSeedInput', DbSeedInput);
 import * as DeployApplyInput from './schemas/DeployApplyInput.schema.json' with { type: 'json' };
 addSchema('DeployApplyInput', DeployApplyInput);
 import * as DeployPlanInput from './schemas/DeployPlanInput.schema.json' with { type: 'json' };
@@ -142,6 +140,10 @@ import * as KnowledgeValidateOutput from './schemas/KnowledgeValidateOutput.sche
 addSchema('KnowledgeValidateOutput', KnowledgeValidateOutput);
 import * as LogoutInput from './schemas/LogoutInput.schema.json' with { type: 'json' };
 addSchema('LogoutInput', LogoutInput);
+import * as PersonaRunInput from './schemas/PersonaRunInput.schema.json' with { type: 'json' };
+addSchema('PersonaRunInput', PersonaRunInput);
+import * as PersonaSyncInput from './schemas/PersonaSyncInput.schema.json' with { type: 'json' };
+addSchema('PersonaSyncInput', PersonaSyncInput);
 import * as PikkuAIAgentOutput from './schemas/PikkuAIAgentOutput.schema.json' with { type: 'json' };
 addSchema('PikkuAIAgentOutput', PikkuAIAgentOutput);
 import * as PikkuAuthInput from './schemas/PikkuAuthInput.schema.json' with { type: 'json' };
@@ -234,6 +236,8 @@ import * as PikkuPackageOutput from './schemas/PikkuPackageOutput.schema.json' w
 addSchema('PikkuPackageOutput', PikkuPackageOutput);
 import * as PikkuPermissionsOutput from './schemas/PikkuPermissionsOutput.schema.json' with { type: 'json' };
 addSchema('PikkuPermissionsOutput', PikkuPermissionsOutput);
+import * as PikkuPersonasInput from './schemas/PikkuPersonasInput.schema.json' with { type: 'json' };
+addSchema('PikkuPersonasInput', PikkuPersonasInput);
 import * as PikkuPublicAgentOutput from './schemas/PikkuPublicAgentOutput.schema.json' with { type: 'json' };
 addSchema('PikkuPublicAgentOutput', PikkuPublicAgentOutput);
 import * as PikkuPublicRPCOutput from './schemas/PikkuPublicRPCOutput.schema.json' with { type: 'json' };
@@ -244,6 +248,8 @@ import * as PikkuRPCOutput from './schemas/PikkuRPCOutput.schema.json' with { ty
 addSchema('PikkuRPCOutput', PikkuRPCOutput);
 import * as PikkuRemoteRPCOutput from './schemas/PikkuRemoteRPCOutput.schema.json' with { type: 'json' };
 addSchema('PikkuRemoteRPCOutput', PikkuRemoteRPCOutput);
+import * as PikkuRolesInput from './schemas/PikkuRolesInput.schema.json' with { type: 'json' };
+addSchema('PikkuRolesInput', PikkuRolesInput);
 import * as PikkuSchedulerOutput from './schemas/PikkuSchedulerOutput.schema.json' with { type: 'json' };
 addSchema('PikkuSchedulerOutput', PikkuSchedulerOutput);
 import * as PikkuSchemasOutput from './schemas/PikkuSchemasOutput.schema.json' with { type: 'json' };
@@ -262,16 +268,20 @@ import * as PikkuUserAdminFunctionsOutput from './schemas/PikkuUserAdminFunction
 addSchema('PikkuUserAdminFunctionsOutput', PikkuUserAdminFunctionsOutput);
 import * as PikkuVersionsInitInput from './schemas/PikkuVersionsInitInput.schema.json' with { type: 'json' };
 addSchema('PikkuVersionsInitInput', PikkuVersionsInitInput);
+import * as PikkuVirtualUserFunctionsOutput from './schemas/PikkuVirtualUserFunctionsOutput.schema.json' with { type: 'json' };
+addSchema('PikkuVirtualUserFunctionsOutput', PikkuVirtualUserFunctionsOutput);
 import * as PikkuWebhookOutput from './schemas/PikkuWebhookOutput.schema.json' with { type: 'json' };
 addSchema('PikkuWebhookOutput', PikkuWebhookOutput);
 import * as PikkuWorkflowOutput from './schemas/PikkuWorkflowOutput.schema.json' with { type: 'json' };
 addSchema('PikkuWorkflowOutput', PikkuWorkflowOutput);
 import * as PikkuWorkflowRoutesOutput from './schemas/PikkuWorkflowRoutesOutput.schema.json' with { type: 'json' };
 addSchema('PikkuWorkflowRoutesOutput', PikkuWorkflowRoutesOutput);
+import * as RolesAuditInput from './schemas/RolesAuditInput.schema.json' with { type: 'json' };
+addSchema('RolesAuditInput', RolesAuditInput);
+import * as RolesPruneInput from './schemas/RolesPruneInput.schema.json' with { type: 'json' };
+addSchema('RolesPruneInput', RolesPruneInput);
 import * as ScenarioListInput from './schemas/ScenarioListInput.schema.json' with { type: 'json' };
 addSchema('ScenarioListInput', ScenarioListInput);
-import * as ScenarioRunInput from './schemas/ScenarioRunInput.schema.json' with { type: 'json' };
-addSchema('ScenarioRunInput', ScenarioRunInput);
 import * as ScopesAuditInput from './schemas/ScopesAuditInput.schema.json' with { type: 'json' };
 addSchema('ScopesAuditInput', ScopesAuditInput);
 import * as ScopesPruneInput from './schemas/ScopesPruneInput.schema.json' with { type: 'json' };

package/dist/.pikku/schemas/schemas/DbResetInput.schema.json

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "additionalProperties": false, "definitions": {} }
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "noSeed": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/PersonaRunInput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "environment": { "type": "string" }, "persona": { "type": "string" }, "disposition": { "type": "string" }, "goals": { "type": "string" }, "steps": { "type": "string" }, "mutations": { "type": "string" }, "duration": { "type": "string" }, "seed": { "type": "string" }, "model": { "type": "string" }, "apiUrl": { "type": "string" }, "allowApproval": { "type": "boolean" }, "skipRoleCheck": { "type": "boolean" }, "out": { "type": "string" } }, "required": ["environment", "persona"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/PersonaSyncInput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "environment": { "type": "string" }, "apiUrl": { "type": "string" }, "dryRun": { "type": "boolean" } }, "required": ["environment"], "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/PikkuPersonasInput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "bootstrap": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/PikkuRolesInput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "bootstrap": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }

package/dist/.pikku/schemas/schemas/PikkuVirtualUserFunctionsOutput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "boolean", "enum": [false, true], "definitions": {} }

package/dist/.pikku/schemas/schemas/RolesPruneInput.schema.json

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "yes": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }

package/dist/.pikku/scopes/pikku-personas-meta.gen.json

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

package/dist/.pikku/scopes/pikku-personas.gen.d.ts

@@ -0,0 +1,36 @@
+import type { CorePersona, PersonaMeta, PersonasMeta } from '@pikku/core/persona';
+import type { SystemRoleName } from './pikku-roles.gen.js';
+/** Every declared persona. */
+export type PersonaId = never;
+/**
+ * The personas a virtual user can actually be.
+ *
+ * Excludes anyone whose only login is a provider account — driving a consent
+ * screen needs a human — and anyone declared `runnable: false`, who exists to
+ * be acted upon rather than to act.
+ */
+export type RunnablePersonaId = never;
+/** Every environment configured in pikku.config.json. */
+export type EnvironmentName = never;
+/**
+ * A persona whose roles are checked against `defineSystemRole` and whose
+ * environments are checked against the config.
+ *
+ * Omitting `environments` means every environment except the ones flagged
+ * `production: true`. Naming a production one additionally requires
+ * `disposition: 'accountable'`, which the type cannot express and `pikku`
+ * refuses at build time.
+ */
+export type TypedPersona = Omit<CorePersona, 'roles' | 'environments'> & {
+    roles?: SystemRoleName[];
+    environments?: EnvironmentName[];
+};
+/**
+ * Declare the people who use this application.
+ *
+ * A persona while running is a virtual user; there is no second declaration.
+ */
+export declare const definePersonas: (personas: Record<string, TypedPersona>) => void;
+/** Declared personas, keyed by id. Read by the console and `pikku persona`. */
+export declare const PERSONAS: PersonasMeta;
+export declare const PERSONA_LIST: PersonaMeta[];

package/dist/.pikku/scopes/pikku-personas.gen.js

@@ -0,0 +1,17 @@
+/**
+ * This file was generated by @pikku/cli@0.12.99
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+import { definePersonas as definePersonasCore } from '@pikku/core/persona';
+import definitions from './pikku-personas-meta.gen.json' with { type: 'json' };
+/**
+ * Declare the people who use this application.
+ *
+ * A persona while running is a virtual user; there is no second declaration.
+ */
+export const definePersonas = (personas) => definePersonasCore(personas);
+/** Declared personas, keyed by id. Read by the console and `pikku persona`. */
+export const PERSONAS = definitions;
+export const PERSONA_LIST = Object.values(PERSONAS);

package/dist/.pikku/scopes/pikku-roles-meta.gen.json

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

package/dist/.pikku/scopes/pikku-roles.gen.d.ts

@@ -0,0 +1,30 @@
+/**
+ * This file was generated by @pikku/cli@0.12.99
+ */
+/**
+ * This file was generated by the @pikku/cli
+ */
+import type { SystemRole } from '@pikku/core/role';
+/**
+ * Every role that ships with this application.
+ *
+ * Roles an admin composes in the console are not here and cannot be: they do
+ * not exist at build time, and can be deleted after it.
+ */
+export type SystemRoleName = never;
+/**
+ * The declared role set, for a ScopeService to sync into its store.
+ *
+ * Derived from the metadata sidecar rather than inlined, so 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 merge the addon's roles
+ * into its own union.
+ *
+ * Additive on removal: a deleted declaration leaves an inert row rather than
+ * revoking everyone's grant on deploy. Use `pikku roles prune` to remove them.
+ */
+export declare const SYSTEM_ROLES: SystemRole[];
+/** Declared roles, keyed by name. Rendered by the console when granting. */
+export declare const SYSTEM_ROLES_META: Record<string, SystemRole>;
+/** Whether a role name is declared in code, and therefore not editable. */
+export declare const isSystemRole: (name: string) => boolean;

package/dist/.pikku/scopes/pikku-roles.gen.js

@@ -0,0 +1,18 @@
+import { flattenSystemRoleDefinitions } from '@pikku/core/role';
+import definitions from './pikku-roles-meta.gen.json' with { type: 'json' };
+/**
+ * The declared role set, for a ScopeService to sync into its store.
+ *
+ * Derived from the metadata sidecar rather than inlined, so 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 merge the addon's roles
+ * into its own union.
+ *
+ * Additive on removal: a deleted declaration leaves an inert row rather than
+ * revoking everyone's grant on deploy. Use `pikku roles prune` to remove them.
+ */
+export const SYSTEM_ROLES = flattenSystemRoleDefinitions(Object.values(definitions));
+/** Declared roles, keyed by name. Rendered by the console when granting. */
+export const SYSTEM_ROLES_META = Object.fromEntries(SYSTEM_ROLES.map((role) => [role.name, role]));
+/** Whether a role name is declared in code, and therefore not editable. */
+export const isSystemRole = (name) => Object.prototype.hasOwnProperty.call(SYSTEM_ROLES_META, name);

package/dist/.pikku/scopes/pikku-scope-types.gen.d.ts

@@ -1,5 +1,7 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
-export { wireScope } from '@pikku/core/scope';
+export { defineScope } from '@pikku/core/scope';
 export type { CoreScopes, CoreScopeNode, FlatScope, ScopeDefinitionMeta, ScopeDefinitionsMeta } from '@pikku/core/scope';
+export { defineSystemRole } from '@pikku/core/role';
+export type { CoreSystemRole, CoreSystemRoles, SystemRole, SystemRoleDefinitionMeta, SystemRoleDefinitionsMeta } from '@pikku/core/role';

package/dist/.pikku/scopes/pikku-scope-types.gen.js

@@ -1,4 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
-export { wireScope } from '@pikku/core/scope';
+export { defineScope } from '@pikku/core/scope';
+export { defineSystemRole } from '@pikku/core/role';

package/dist/.pikku/scopes/pikku-scopes.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/secrets/pikku-secret-types.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
-export { wireSecret } from '@pikku/core/secret';
+export { defineSecret } from '@pikku/core/secret';
 export type { CoreSecret, SecretDefinitionMeta, SecretDefinitionsMeta } from '@pikku/core/secret';

package/dist/.pikku/secrets/pikku-secret-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
-export { wireSecret } from '@pikku/core/secret';
+export { defineSecret } from '@pikku/core/secret';

package/dist/.pikku/secrets/pikku-secrets.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import type { SecretService } from '@pikku/core/services';

package/dist/.pikku/secrets/pikku-secrets.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import secretsMeta from './pikku-secrets-meta.gen.json' with { type: 'json' };

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

package/dist/.pikku/trigger/pikku-trigger-types.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 /**
  * Trigger-specific type definitions for tree-shaking optimization

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

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

package/dist/.pikku/variables/pikku-variable-types.gen.js

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
-export { wireVariable } from '@pikku/core/variable';
+export { defineVariable } from '@pikku/core/variable';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import type { VariablesService } from '@pikku/core/services';

package/dist/.pikku/variables/pikku-variables.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.93
+ * This file was generated by @pikku/cli@0.12.99
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 import variablesMeta from './pikku-variables-meta.gen.json' with { type: 'json' };

package/dist/.pikku/workflow/meta/allWorkflow.gen.json

@@ -17,9 +17,21 @@
         "Bootstrap scopes": {
             "nodeId": "Bootstrap scopes",
             "rpcName": "pikkuScopes",
-            "next": "Bootstrap function types split",
+            "next": "Bootstrap roles",
             "stepHash": "41fa180b51ca"
         },
+        "Bootstrap roles": {
+            "nodeId": "Bootstrap roles",
+            "rpcName": "pikkuRoles",
+            "next": "Bootstrap personas",
+            "stepHash": "90dda4d88b2d"
+        },
+        "Bootstrap personas": {
+            "nodeId": "Bootstrap personas",
+            "rpcName": "pikkuPersonas",
+            "next": "Bootstrap function types split",
+            "stepHash": "f04e62ca075c"
+        },
         "Bootstrap function types split": {
             "nodeId": "Bootstrap function types split",
             "rpcName": "pikkuFunctionTypesSplit",
@@ -249,9 +261,15 @@
         "User admin functions": {
             "nodeId": "User admin functions",
             "rpcName": "pikkuUserAdminFunctions",
-            "next": "Events scaffold",
+            "next": "Virtual user functions",
             "stepHash": "831f37173651"
         },
+        "Virtual user functions": {
+            "nodeId": "Virtual user functions",
+            "rpcName": "pikkuVirtualUserFunctions",
+            "next": "Events scaffold",
+            "stepHash": "4f96c6158127"
+        },
         "Events scaffold": {
             "nodeId": "Events scaffold",
             "rpcName": "pikkuEventsScaffold",
@@ -297,9 +315,21 @@
         "Scopes": {
             "nodeId": "Scopes",
             "rpcName": "pikkuScopes",
-            "next": "Variable definition types",
+            "next": "Roles",
             "stepHash": "1ca929a3b6de"
         },
+        "Roles": {
+            "nodeId": "Roles",
+            "rpcName": "pikkuRoles",
+            "next": "Personas",
+            "stepHash": "fa13d3597a32"
+        },
+        "Personas": {
+            "nodeId": "Personas",
+            "rpcName": "pikkuPersonas",
+            "next": "Variable definition types",
+            "stepHash": "c17594d64ea5"
+        },
         "Variable definition types": {
             "nodeId": "Variable definition types",
             "rpcName": "pikkuVariableDefinitionTypes",
@@ -321,25 +351,25 @@
         "Re-inspect after agents": {
             "nodeId": "Re-inspect after agents",
             "flow": "inline",
-            "next": "Secrets (post-auth)"
+            "next": "Secrets (post-scaffold)"
         },
-        "Secrets (post-auth)": {
-            "nodeId": "Secrets (post-auth)",
+        "Secrets (post-scaffold)": {
+            "nodeId": "Secrets (post-scaffold)",
             "rpcName": "pikkuSecrets",
-            "next": "Credentials (post-auth)",
-            "stepHash": "f263e11ae304"
+            "next": "Credentials (post-scaffold)",
+            "stepHash": "39dc613ab885"
         },
-        "Credentials (post-auth)": {
-            "nodeId": "Credentials (post-auth)",
+        "Credentials (post-scaffold)": {
+            "nodeId": "Credentials (post-scaffold)",
             "rpcName": "pikkuCredentials",
-            "next": "Variables (post-auth)",
-            "stepHash": "ab2438dcbd2b"
+            "next": "Variables (post-scaffold)",
+            "stepHash": "c9c202f0bf70"
         },
-        "Variables (post-auth)": {
-            "nodeId": "Variables (post-auth)",
+        "Variables (post-scaffold)": {
+            "nodeId": "Variables (post-scaffold)",
             "rpcName": "pikkuVariables",
             "next": "Schemas",
-            "stepHash": "df261a647c97"
+            "stepHash": "047ea7a92357"
         },
         "Schemas": {
             "nodeId": "Schemas",
@@ -604,5 +634,5 @@
     "entryNodeIds": [
         "Bootstrap inspect"
     ],
-    "graphHash": "a06daef26bb3"
+    "graphHash": "c8f162576369"
 }

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

@@ -0,0 +1,15 @@
+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 declare const personaConfigs: {};
+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 declare const personaList: ResolvedPersona[];
+export type AgentName = keyof AgentMap & string;
+export type TypedPersonas = Record<PersonaName, ScenarioPersona<AgentName, FlattenedRPCMap>>;
+export declare const createPersonas: (options: Omit<HttpPersonasConfig, "personas">) => TypedPersonas;

package/dist/.pikku/workflow/pikku-personas.gen.js

@@ -0,0 +1,17 @@
+/**
+ * This file was generated by @pikku/cli@0.12.99
+ */
+/** Personas declared with definePersonas() */
+import { createHttpPersonas } from '@pikku/core/persona';
+export const 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 = Object.values(personaConfigs);
+export const createPersonas = (options) => createHttpPersonas({
+    ...options,
+    personas: personaConfigs,
+});