@pikku/cli 0.12.115 → 0.12.117

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Middleware type definitions and registration for all wirings
@@ -7,7 +7,7 @@
 import { addTagMiddleware as addTagMiddlewareCore, addGlobalMiddleware as addGlobalMiddlewareCore, pikkuMiddleware as pikkuMiddlewareCore } from '@pikku/core/middleware';
 import { addHTTPMiddleware as addHTTPMiddlewareCore } from '@pikku/core/http';
 import { addChannelMiddleware as addChannelMiddlewareCore, } from '@pikku/core/channel';
-export { cors } from '@pikku/core/middleware';
+export { cors, authAPIKey, authBearer, authCookie } from '@pikku/core/middleware';
 /**
  * Factory function for creating middleware with tree-shaking support.
  * Supports both direct function and configuration object syntax.
@@ -39,18 +39,7 @@ export const pikkuMiddleware = (middleware) => {
  * Factory function for creating middleware factories
  * Use this when your middleware needs configuration/input parameters
  *
- * @example
- * ```typescript
- * export const logMiddleware = pikkuMiddlewareFactory<LogOptions>(({
- *   message,
- *   level = 'info'
- * }) => {
- *   return pikkuMiddleware(async ({ logger }, next) => {
- *     logger[level](message)
- *     await next()
- *   })
- * })
- * ```
+ * @example snippet: middlewareFactory
  */
 export const pikkuMiddlewareFactory = (factory) => {
     return factory;
@@ -70,8 +59,7 @@ export const addGlobalMiddleware = (middleware) => {
 /**
  * Tag-scoped middleware. Applies to any wiring that carries the matching tag.
  *
- * @example
- * addTagMiddleware('admin', [adminMiddleware])
+ * @example snippet: tagMiddleware
  */
 export const addTagMiddleware = (tag, middleware) => {
     addTagMiddlewareCore(tag, middleware, null);
@@ -86,23 +74,40 @@ export const addTagMiddleware = (tag, middleware) => {
  * @param routeOrMiddleware - Either a global middleware array or a route pattern string
  * @param middleware - The middleware array to apply when a route pattern is specified
  *
- * @example
- * ```typescript
- * // Add global HTTP middleware
- * addHTTPMiddleware([authMiddleware, loggingMiddleware])
- *
- * // Add route-specific middleware
- * addHTTPMiddleware('/api/admin/*', [adminAuthMiddleware])
- * ```
+ * @example snippet: httpMiddleware
  */
 export const addHTTPMiddleware = (routeOrMiddleware, middleware) => {
     addHTTPMiddlewareCore(routeOrMiddleware, middleware);
 };
+/**
+ * Declares middleware for a channel — it runs around the connection and its
+ * messages rather than around a single request.
+ *
+ * @example snippet: channelMiddleware
+ */
 export const pikkuChannelMiddleware = (middleware) => {
     return middleware;
 };
+/**
+ * Declares channel middleware that takes options, so one definition can be
+ * wired several times with different configuration.
+ *
+ * @example snippet: channelMiddlewareFactory
+ */
 export const pikkuChannelMiddlewareFactory = (factory) => {
     return factory;
 };
+/**
+ * Attaches channel middleware to every channel carrying the given tag, so the
+ * channels themselves stay free of the wiring.
+ *
+ * @example snippet: addChannelMiddleware
+ */
 export const addChannelMiddleware = (tag, middleware) => addChannelMiddlewareCore(tag, middleware, null);
+/**
+ * Declares middleware for an agent run — hooks around the model call, its tool
+ * calls and the run's state.
+ *
+ * @example snippet: agentMiddleware
+ */
 export const pikkuAgentMiddleware = (hooks) => hooks;

package/dist/.pikku/pikku-bootstrap-scenarios.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import './pikku-bootstrap.gen.js';
 import './scenarios/schemas/register.gen.js';

package/dist/.pikku/pikku-bootstrap-scenarios.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import './pikku-bootstrap.gen.js';
 import './scenarios/schemas/register.gen.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import './rpc/pikku-rpc-wirings-meta.internal.gen.js';
 import './function/pikku-functions-meta.gen.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import './rpc/pikku-rpc-wirings-meta.internal.gen.js';
 import './function/pikku-functions-meta.gen.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import type { SingletonServices } from '../types/application-types.d.js';
 import type { Services } from '../types/application-types.d.js';

package/dist/.pikku/queue/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/queue` resolves here.

package/dist/.pikku/queue/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/queue` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Queue-specific type definitions for tree-shaking optimization
@@ -18,6 +18,8 @@ type QueueWiring<In, Out> = CoreQueueWorker<PikkuFunctionConfig<In, Out, 'sessio
  * Workers process background jobs from queues.
  *
  * @param queueWorker - Queue worker definition with job handler
+ *
+ * @example snippet: wireQueue
  */
 export declare const wireQueueWorker: (queueWorker: QueueWiring<any, any>) => void;
 export {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Queue-specific type definitions for tree-shaking optimization
@@ -10,6 +10,8 @@ import { wireQueueWorker as wireQueueWorkerCore } from '@pikku/core/queue';
  * Workers process background jobs from queues.
  *
  * @param queueWorker - Queue worker definition with job handler
+ *
+ * @example snippet: wireQueue
  */
 export const wireQueueWorker = (queueWorker) => {
     wireQueueWorkerCore(queueWorker);

package/dist/.pikku/queue/pikku-queue-workers-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import { pikkuState } from '@pikku/core/state';
 import metaData from './pikku-queue-workers-wirings-meta.gen.json' with { type: 'json' };

package/dist/.pikku/queue/pikku-queue-workers-wirings.gen.d.ts

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

package/dist/.pikku/queue/pikku-queue-workers-wirings.gen.js

@@ -1,5 +1,5 @@
 export {};
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /* The files with an addQueueWorkers function call */ 

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import { pikkuState } from '@pikku/core/state';
 import metaData from './pikku-rpc-wirings-meta.internal.gen.json' with { type: 'json' };

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

@@ -4,7 +4,6 @@
     "FabricDbSchema": "FabricDbSchema",
     "FabricDeployList": "FabricDeployList",
     "FabricDeployUnits": "FabricDeployUnits",
-    "FabricDeployPlan": "FabricDeployPlan",
     "FabricDeployApply": "FabricDeployApply",
     "FabricDomainsAdd": "FabricDomainsAdd",
     "FabricDomainsList": "FabricDomainsList",
@@ -41,6 +40,7 @@
     "deployInfo": "deployInfo",
     "deployPlan": "deployPlan",
     "dev": "dev",
+    "doc": "doc",
     "pikkuEmailsInit": "pikkuEmailsInit",
     "enableRpc": "enableRpc",
     "enableConsole": "enableConsole",

package/dist/.pikku/scenarios/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/scenarios` resolves here.

package/dist/.pikku/scenarios/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/scenarios` resolves here.

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

@@ -13,5 +13,9 @@ export type PersonaName = keyof typeof personaConfigs;
  */
 export declare const personaList: ResolvedPersona[];
 export type AgentName = keyof AgentMap & string;
+/**
+ * The personas this project declares, keyed by name — the `actors` a scenario
+ * step runs as.
+ */
 export type TypedPersonas = Record<PersonaName, ScenarioPersona<AgentName, FlattenedRPCMap>>;
 export declare const createPersonas: (options: Omit<HttpPersonasConfig, "personas">) => TypedPersonas;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /** Personas declared with definePersonas() */
 import { createHttpPersonas } from '@pikku/core/persona';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import { pikkuState } from '@pikku/core/state';
 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.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 export {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import type { PikkuScenarioWire, ScenarioStepOptions } from '@pikku/core/scenario';
 import type { PikkuWorkflowWire } from '@pikku/core/workflow';
@@ -94,6 +94,8 @@ export type PikkuScenarioHook<InputSchema extends StandardSchemaV1 | undefined =
  * Declares a scenario hook. Returns the function verbatim — a hook is never
  * registered, so this exists purely to give an inline hook a call site to be
  * contextually typed from, the way every other pikku primitive is.
+ *
+ * @example snippet: scenarioHook
  */
 export declare function pikkuScenarioHook<In = unknown, Ctx = unknown>(hook: PikkuFunctionScenario<In, void, Ctx>): PikkuFunctionScenario<In, void, Ctx>;
 /**
@@ -101,6 +103,8 @@ export declare function pikkuScenarioHook<In = unknown, Ctx = unknown>(hook: Pik
  * Steps run as actors over the REAL transport — `scenario.do(step, rpc,
  * data, { actor: actors.yasser })` — so flows double as e2e tests and
  * staged/production health checks (no state reset; scope what you create).
+ *
+ * @example snippet: scenarioBasics
  */
 export declare function pikkuScenario<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuScenarioConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenario' | 'actors', PikkuFunctionScenario<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown>, InputSchema, OutputSchema>;
 export declare function pikkuScenario<In, Out = unknown>(func: PikkuFunctionScenario<In, Out> | PikkuFunctionConfig<In, Out, 'scenario' | 'actors', PikkuFunctionScenario<In, Out>>): PikkuFunctionConfig<In, Out, 'scenario' | 'actors'>;
@@ -160,6 +164,8 @@ type PikkuFeatureConfig<Scenarios extends readonly unknown[]> = {
  *   ],
  * })
  * ```
+ *
+ * @example snippet: scenarioFeature
  */
 export declare function pikkuFeature<const Scenarios extends readonly unknown[]>(config: PikkuFeatureConfig<Scenarios>): PikkuFeatureConfig<Scenarios>;
 /**
@@ -243,6 +249,8 @@ type PikkuScenarioStepConfig<In, Out, HasActor extends boolean = false> = Omit<P
  *
  * Steps are deliberately NOT registered as RPCs: a browser-driving step must
  * never be network-callable.
+ *
+ * @example snippet: scenarioStepDefinition
  */
 export declare function pikkuScenarioStep<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuScenarioStepConfigWithSchema<InputSchema, OutputSchema, true> & {
     actor: true;
@@ -284,6 +292,8 @@ type PikkuSubjectScenarioStepConfig<In, Out> = Omit<PikkuScenarioStepConfig<In,
  *
  * Local-test-only, and never in a virtual user's catalogue: a virtual user that
  * could expire its own trial is manufacturing the outcome it exists to discover.
+ *
+ * @example snippet: platformStep
  */
 export declare function pikkuPlatformScenarioStep<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuSubjectScenarioStepConfigWithSchema<InputSchema, OutputSchema>): PikkuFunctionConfig<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'scenarioStep', PikkuFunctionScenarioStep<InputSchema extends StandardSchemaV1 ? InferSchemaOutput<InputSchema> : unknown, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, 'default'>, InputSchema, OutputSchema>;
 export declare function pikkuPlatformScenarioStep<In, Out = unknown>(config: PikkuSubjectScenarioStepConfig<In, Out>): PikkuFunctionConfig<In, Out, 'scenarioStep'>;
@@ -301,6 +311,8 @@ export declare function pikkuPlatformScenarioStep<In, Out = unknown>(config: Pik
  *
  * Local-test-only, and never in a virtual user's catalogue: one that could
  * invoke this would forge its own payment success.
+ *
+ * @example snippet: addonStep
  */
 export declare function pikkuAddonScenarioStep<InputSchema extends StandardSchemaV1 | undefined = undefined, OutputSchema extends StandardSchemaV1 | undefined = undefined>(config: PikkuSubjectScenarioStepConfigWithSchema<InputSchema, OutputSchema> & {
     addon: string;

package/dist/.pikku/scenarios/pikku-scenario-types.gen.js

@@ -11,6 +11,8 @@ export { postScenarioJson, readScenarioHttpResponse } from '@pikku/core/persona'
  * Declares a scenario hook. Returns the function verbatim — a hook is never
  * registered, so this exists purely to give an inline hook a call site to be
  * contextually typed from, the way every other pikku primitive is.
+ *
+ * @example snippet: scenarioHook
  */
 export function pikkuScenarioHook(hook) {
     return hook;
@@ -41,6 +43,8 @@ export function pikkuScenario(func) {
  *   ],
  * })
  * ```
+ *
+ * @example snippet: scenarioFeature
  */
 export function pikkuFeature(config) {
     return config;

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import { pikkuState } from '@pikku/core/state';
 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.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 export {};

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

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 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.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 export const empty = null;

package/dist/.pikku/scheduler/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/scheduler` resolves here.

package/dist/.pikku/scheduler/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/scheduler` resolves here.

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Scheduler-specific type definitions for tree-shaking optimization
@@ -17,6 +17,8 @@ type SchedulerWiring = CoreScheduledTask<PikkuFunctionConfig<void, void, 'sessio
  * Tasks run based on cron expressions and are sessionless.
  *
  * @param task - Scheduled task definition with cron expression and handler
+ *
+ * @example snippet: wireScheduler
  */
 export declare const wireScheduler: (task: SchedulerWiring) => void;
 export {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Scheduler-specific type definitions for tree-shaking optimization
@@ -10,6 +10,8 @@ import { wireScheduler as wireSchedulerCore } from '@pikku/core/scheduler';
  * Tasks run based on cron expressions and are sessionless.
  *
  * @param task - Scheduled task definition with cron expression and handler
+ *
+ * @example snippet: wireScheduler
  */
 export const wireScheduler = (task) => {
     wireSchedulerCore(task);

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import { addSchema } from '@pikku/core/schema';
 import * as BinaryInput from './schemas/BinaryInput.schema.json' with { type: 'json' };
@@ -26,6 +26,10 @@ import * as DeployPlanInput from './schemas/DeployPlanInput.schema.json' with {
 addSchema('DeployPlanInput', DeployPlanInput);
 import * as DevInput from './schemas/DevInput.schema.json' with { type: 'json' };
 addSchema('DevInput', DevInput);
+import * as DocInput from './schemas/DocInput.schema.json' with { type: 'json' };
+addSchema('DocInput', DocInput);
+import * as DocOutput from './schemas/DocOutput.schema.json' with { type: 'json' };
+addSchema('DocOutput', DocOutput);
 import * as FabricAddInput from './schemas/FabricAddInput.schema.json' with { type: 'json' };
 addSchema('FabricAddInput', FabricAddInput);
 import * as FabricAddOutput from './schemas/FabricAddOutput.schema.json' with { type: 'json' };
@@ -46,10 +50,6 @@ import * as FabricDeployListInput from './schemas/FabricDeployListInput.schema.j
 addSchema('FabricDeployListInput', FabricDeployListInput);
 import * as FabricDeployListOutput from './schemas/FabricDeployListOutput.schema.json' with { type: 'json' };
 addSchema('FabricDeployListOutput', FabricDeployListOutput);
-import * as FabricDeployPlanInput from './schemas/FabricDeployPlanInput.schema.json' with { type: 'json' };
-addSchema('FabricDeployPlanInput', FabricDeployPlanInput);
-import * as FabricDeployPlanOutput from './schemas/FabricDeployPlanOutput.schema.json' with { type: 'json' };
-addSchema('FabricDeployPlanOutput', FabricDeployPlanOutput);
 import * as FabricDeployUnitsInput from './schemas/FabricDeployUnitsInput.schema.json' with { type: 'json' };
 addSchema('FabricDeployUnitsInput', FabricDeployUnitsInput);
 import * as FabricDeployUnitsOutput from './schemas/FabricDeployUnitsOutput.schema.json' with { type: 'json' };

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

@@ -0,0 +1 @@
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "topics": { "type": "array", "items": { "type": "string" } }, "ai": { "type": "boolean" }, "addon": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }

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

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

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "branch": { "type": "string" }, "production": { "type": "boolean" }, "ref": { "type": "string" }, "message": { "type": "string" }, "autoApply": { "type": "boolean" } }, "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "branch": { "type": "string" }, "production": { "type": "boolean" }, "ref": { "type": "string" }, "deploymentId": { "type": "string" }, "sync": { "type": "boolean" }, "autoApprove": { "type": "boolean" }, "allowDestructive": { "type": "boolean" }, "timeout": { "type": "number" }, "json": { "type": "boolean" } }, "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "projectId": { "type": "string" }, "branch": { "type": "string" }, "ref": { "type": "string" }, "deploymentId": { "type": "string" }, "stageId": { "type": "string" }, "runId": { "type": "string" } }, "required": ["projectId", "branch", "ref", "deploymentId", "stageId", "runId"], "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "event": { "type": "string", "const": "result" }, "outcome": { "type": "string", "enum": ["queued", "succeeded", "failed", "blocked", "timeout"] }, "projectId": { "type": "string" }, "deploymentId": { "type": "string" }, "branch": { "type": "string" }, "ref": { "type": "string" }, "status": { "type": "string" }, "statusReason": { "anyOf": [{ "type": "string" }, { "type": "null" }] }, "stageId": { "type": "string" }, "runId": { "type": "string" }, "blockedReason": { "type": "string", "enum": ["awaiting_approval", "needs_config", "needs_attention", "unknown"] }, "missingSecrets": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "displayName": { "anyOf": [{ "type": "string" }, { "type": "null" }] }, "description": { "anyOf": [{ "type": "string" }, { "type": "null" }] }, "docsUrl": { "anyOf": [{ "type": "string" }, { "type": "null" }] } }, "required": ["name", "displayName", "description", "docsUrl"], "additionalProperties": false } }, "missingVariables": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "displayName": { "anyOf": [{ "type": "string" }, { "type": "null" }] }, "description": { "anyOf": [{ "type": "string" }, { "type": "null" }] }, "docsUrl": { "anyOf": [{ "type": "string" }, { "type": "null" }] } }, "required": ["name", "displayName", "description", "docsUrl"], "additionalProperties": false } }, "approvalWithheld": { "type": "string", "const": "destructive_migrations" }, "changes": { "type": "object", "properties": { "unitsAdded": { "type": "array", "items": { "type": "string" } }, "unitsRemoved": { "type": "array", "items": { "type": "string" } }, "handlersAdded": { "type": "array", "items": { "type": "string" } }, "handlersRemoved": { "type": "array", "items": { "type": "string" } }, "workflowsAdded": { "type": "array", "items": { "type": "string" } }, "workflowsRemoved": { "type": "array", "items": { "type": "string" } }, "workflowsChanged": { "type": "array", "items": { "type": "string" } }, "functionsAdded": { "type": "array", "items": { "type": "string" } }, "functionsRemoved": { "type": "array", "items": { "type": "string" } }, "secretsChanged": { "type": "array", "items": { "type": "string" } }, "variablesChanged": { "type": "array", "items": { "type": "string" } }, "pendingMigrations": { "type": "array", "items": { "type": "string" } }, "migrationRisks": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "level": { "type": "string", "enum": ["destructive", "safe"] }, "reasons": { "type": "array", "items": { "type": "string" } } }, "required": ["name", "level", "reasons"], "additionalProperties": false } } }, "required": ["unitsAdded", "unitsRemoved", "handlersAdded", "handlersRemoved", "workflowsAdded", "workflowsRemoved", "workflowsChanged", "functionsAdded", "functionsRemoved", "secretsChanged", "variablesChanged", "pendingMigrations", "migrationRisks"], "additionalProperties": false }, "workers": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "role": { "type": "string" }, "status": { "type": "string" } }, "required": ["name", "role", "status"], "additionalProperties": false } }, "url": { "anyOf": [{ "type": "string" }, { "type": "null" }] }, "approved": { "type": "boolean" }, "elapsedMs": { "type": "number" }, "timeoutSeconds": { "type": "number" } }, "required": ["event", "outcome", "projectId", "deploymentId"], "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "retiredKeyId": { "type": "string" } }, "required": ["retiredKeyId"], "additionalProperties": false }
+{ "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "retiredKeyId": { "anyOf": [{ "type": "string" }, { "type": "null" }] } }, "required": ["retiredKeyId"], "additionalProperties": false }

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

@@ -1 +1 @@
-{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "agent": { "type": "string" }, "only": { "type": "string" }, "core": { "type": "boolean" }, "fabric": { "type": "boolean" }, "update": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }
+{ "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "agent": { "type": "string" }, "only": { "type": "string" }, "core": { "type": "boolean" }, "fabric": { "type": "boolean" }, "client": { "type": "boolean" }, "update": { "type": "boolean" } }, "additionalProperties": false, "definitions": {} }

package/dist/.pikku/scopes/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.

package/dist/.pikku/scopes/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/scopes` resolves here.

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

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

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

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

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

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

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 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.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * This file was generated by the @pikku/cli

package/dist/.pikku/secrets/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

package/dist/.pikku/secrets/index.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 /**
  * Subpath entry — `#pikku/secrets` resolves here.

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

@@ -1,4 +1,4 @@
 /**
- * This file was generated by @pikku/cli@0.12.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 export { defineSecret } 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.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 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.115
+ * This file was generated by @pikku/cli@0.12.117
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 import type { SecretService } from '@pikku/core/services';
@@ -11,7 +11,15 @@ import type { SecretService } from '@pikku/core/services';
  * sidecar is not part of `#pikku/secrets`.
  */
 import './pikku-secrets-meta.gen.json';
+/**
+ * Every secret this project declares with `defineSecret`, keyed by name. It is
+ * what gives `secrets.getSecret('NAME')` a real type.
+ */
 export type CredentialsMap = {};
+/**
+ * The `secrets` service as this project sees it: `getSecret('NAME')` resolves
+ * the value's type from `CredentialsMap` instead of returning `unknown`.
+ */
 export declare class TypedSecretService extends CoreTypedSecretService<CredentialsMap> {
     constructor(secrets: SecretService);
 }