npm - @pikku/cli - Versions diffs - 0.12.2 → 0.12.3 - Mend

@pikku/cli 0.12.2 → 0.12.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (110) hide show

package/console-app/index.html CHANGED Viewed

@@ -25,8 +25,8 @@
         }
       } catch (e) {}
     </script>
-    <script type="module" crossorigin src="/assets/index-DRJQtv3c.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-0Ui5UudO.css">
+    <script type="module" crossorigin src="/assets/index-Ci24-VT-.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DvrDbftC.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/.pikku/agent/pikku-agent-types.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import { CoreAIAgent, PikkuAIMiddlewareHooks } from '@pikku/core/ai-agent';
 import type { PikkuPermission, PikkuMiddleware, Services, PikkuFunctionConfig } from '../function/pikku-function-types.gen.js';

package/dist/.pikku/agent/pikku-agent-wirings-meta.gen.js CHANGED Viewed

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

package/dist/.pikku/agent/pikku-agent-wirings.gen.d.ts CHANGED Viewed

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

package/dist/.pikku/agent/pikku-agent-wirings.gen.js CHANGED Viewed

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

package/dist/.pikku/channel/pikku-channel-types.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization

package/dist/.pikku/channel/pikku-channel-types.gen.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**
  * Channel-specific type definitions for tree-shaking optimization

package/dist/.pikku/channel/pikku-channels-meta.gen.js CHANGED Viewed

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

package/dist/.pikku/channel/pikku-channels.gen.d.ts CHANGED Viewed

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

package/dist/.pikku/channel/pikku-channels.gen.js CHANGED Viewed

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

package/dist/.pikku/cli/pikku-cli-channel.d.ts CHANGED Viewed

@@ -1 +1,13 @@
-export {};
+export declare const cliHelp: import("../function/pikku-function-types.gen.js").PikkuFunctionConfig<{
+    args?: string[];
+}, {
+    help: string;
+}, "session" | "rpc", import("../function/pikku-function-types.gen.js").PikkuFunctionSessionless<{
+    args?: string[];
+}, {
+    help: string;
+}, "session" | "rpc", import("../function/pikku-function-types.gen.js").Services> | import("../function/pikku-function-types.gen.js").PikkuFunction<{
+    args?: string[];
+}, {
+    help: string;
+}, "session" | "rpc", import("../function/pikku-function-types.gen.js").Services>, undefined, undefined>;

package/dist/.pikku/cli/pikku-cli-channel.js CHANGED Viewed

@@ -1,11 +1,13 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**
  * WebSocket channel backend for 'pikku' CLI commands
  */
 import { wireChannel } from '../channel/pikku-channel-types.gen.js';
-import { pikkuMiddleware } from '../function/pikku-function-types.gen.js';
+import { pikkuMiddleware, pikkuSessionlessFunc } from '../function/pikku-function-types.gen.js';
+import { generateCommandHelp } from '@pikku/core/cli';
+import { pikkuState } from '@pikku/core/internal';
 import { all } from '../../src/functions/commands/all.js';
 import { bootstrap } from '../../src/functions/commands/bootstrap.js';
 import { watch } from '../../src/functions/commands/watch.js';
@@ -56,12 +58,25 @@ const cliCloseOnComplete = pikkuMiddleware(async (_services, { channel }, next)
         throw error;
     }
 });
+export const cliHelp = pikkuSessionlessFunc({
+    auth: false,
+    func: async (_services, data) => {
+        const cliMeta = pikkuState(null, 'cli', 'meta');
+        const commandPath = data?.args?.length ? data.args : [];
+        const helpText = generateCommandHelp('pikku', cliMeta, commandPath);
+        return { help: helpText };
+    },
+});
 wireChannel({
     name: 'pikku-cli',
     route: '/cli/pikku',
     auth: false,
     onMessageWiring: {
         command: {
+            '__help': {
+                func: cliHelp,
+                middleware: [cliCloseOnComplete],
+            },
             'all': {
                 func: all,
                 middleware: [cliCloseOnComplete],

package/dist/.pikku/cli/pikku-cli-client.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import '../pikku-bootstrap.gen.js';
 /**

package/dist/.pikku/cli/pikku-cli-client.gen.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import { executeCLIViaChannel } from '@pikku/core/cli/channel';
 import { CorePikkuWebsocket } from '@pikku/websocket';

package/dist/.pikku/cli/pikku-cli-types.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**

package/dist/.pikku/cli/pikku-cli-types.gen.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**

package/dist/.pikku/cli/pikku-cli-wirings-meta.gen.js CHANGED Viewed

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

package/dist/.pikku/cli/pikku-cli-wirings-meta.gen.json CHANGED Viewed

@@ -52,6 +52,11 @@
                             "description": "Port for the console server",
                             "default": "51442",
                             "short": "p"
+                        },
+                        "open": {
+                            "description": "Open the console in the browser",
+                            "default": "false",
+                            "short": "o"
                         }
                     },
                     "description": "Start the Pikku Console UI with live file watching"
@@ -269,6 +274,10 @@
                                 },
                                 "openapi": {
                                     "description": "Path to OpenAPI YAML/JSON spec to generate functions from"
+                                },
+                                "mcp": {
+                                    "description": "Add mcp: true to generated functions (expose as MCP tools)",
+                                    "default": false
                                 }
                             },
                             "description": "Scaffold a new addon package",
@@ -440,7 +449,9 @@
                     "aiStorage",
                     "content",
                     "aiAgentRunner",
-                    "aiRunState"
+                    "aiRunState",
+                    "agentRunService",
+                    "workflowRunService"
                 ]
             },
             "filePath": "/home/runner/work/pikku/pikku/packages/cli/src/services.ts"

package/dist/.pikku/cli/pikku-cli-wirings.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import '../../src/cli.wiring.js';
 import '../../src/services.js';

package/dist/.pikku/cli/pikku-cli-wirings.gen.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /* The files with an wireCLI function call */
 import '../../src/cli.wiring.js';

package/dist/.pikku/cli/pikku-cli.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import '../pikku-bootstrap.gen.js';
 export declare function PikkuCLI(args: string[]): Promise<void>;

package/dist/.pikku/cli/pikku-cli.gen.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import { executeCLI, CLIError } from '@pikku/core/cli';
 import { createConfig as createConfig } from '../../src/services.js';

package/dist/.pikku/console/pikku-node-types.gen.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 import type { FlattenedRPCMap } from '../rpc/pikku-rpc-wirings-map.internal.gen.js';
 export type NodeCategory = never;

package/dist/.pikku/function/pikku-function-types.gen.d.ts CHANGED Viewed

@@ -1,11 +1,12 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**
  * Core function, middleware, and permission types for all wirings
  */
 import { CorePikkuFunctionConfig, CorePikkuAuth, CorePikkuAuthConfig, CorePikkuPermission, CorePikkuMiddleware, CorePermissionGroup, PikkuWire, PickRequired } from '@pikku/core';
 import { CreateWireServices } from '@pikku/core/internal';
+import { PikkuError } from '@pikku/core/errors';
 import type { NodeType } from '@pikku/core/node';
 import type { StandardSchemaV1 } from '@standard-schema/spec';
 import { CorePikkuFunction, CorePikkuFunctionSessionless } from '@pikku/core/function';
@@ -184,6 +185,28 @@ export declare const pikkuMiddlewareFactory: <In = any>(factory: (input: In) =>
  * ```
  */
 export declare const pikkuPermissionFactory: <In = any>(factory: (input: In) => PikkuPermission<any>) => ((input: In) => PikkuPermission<any>);
+/**
+ * A function that generates a human-readable description of a pending approval action.
+ * Used by AI agents to show meaningful approval prompts instead of raw tool arguments.
+ *
+ * @template In - The input type (same as the function it describes)
+ * @template RequiredServices - The services required for this description function
+ */
+export type PikkuApprovalDescription<In = unknown, RequiredServices extends Services = Services> = (services: RequiredServices, data: In) => Promise<string>;
+/**
+ * Factory function for creating approval description functions with tree-shaking support.
+ *
+ * @example
+ * ```typescript
+ * export const deleteTodoApproval = pikkuApprovalDescription(
+ *   async ({ todoStore }, { id }) => {
+ *     const todo = await todoStore.get(id)
+ *     return \`Delete todo: "${todo.title}"\`
+ *   }
+ * )
+ * ```
+ */
+export declare const pikkuApprovalDescription: <In = unknown, RequiredServices extends Services = Services>(fn: PikkuApprovalDescription<In, RequiredServices>) => PikkuApprovalDescription<In, RequiredServices>;
 /**
  * A sessionless API function that doesn't require user authentication.
  * Use this for public endpoints, health checks, or operations that don't need user context.
@@ -226,6 +249,8 @@ export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1,
     expose?: boolean;
     mcp?: boolean;
     internal?: boolean;
+    approvalRequired?: boolean;
+    approvalDescription?: PikkuApprovalDescription<InferSchemaOutput<InputSchema>>;
     func: PikkuFunction<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, RequiredWires> | PikkuFunctionSessionless<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, RequiredWires>;
     auth?: boolean;
     permissions?: CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>;
@@ -233,6 +258,7 @@ export type PikkuFunctionConfigWithSchema<InputSchema extends StandardSchemaV1,
     input: InputSchema;
     output?: OutputSchema;
     node?: NodeConfig;
+    errors?: Array<typeof PikkuError>;
 };
 /**
  * Creates a Pikku function that can be either session-aware or sessionless.
@@ -285,6 +311,8 @@ export type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends Standar
     mcp?: boolean;
     internal?: boolean;
     remote?: boolean;
+    approvalRequired?: boolean;
+    approvalDescription?: PikkuApprovalDescription<InferSchemaOutput<InputSchema>>;
     func: PikkuFunctionSessionless<InferSchemaOutput<InputSchema>, OutputSchema extends StandardSchemaV1 ? InferSchemaOutput<OutputSchema> : unknown, RequiredWires>;
     auth?: boolean;
     permissions?: CorePermissionGroup<PikkuPermission<InferSchemaOutput<InputSchema>>>;
@@ -292,6 +320,7 @@ export type PikkuFunctionSessionlessConfigWithSchema<InputSchema extends Standar
     input: InputSchema;
     output?: OutputSchema;
     node?: NodeConfig;
+    errors?: Array<typeof PikkuError>;
 };
 /**
  * Creates a sessionless Pikku function that doesn't require user authentication.

package/dist/.pikku/function/pikku-function-types.gen.js CHANGED Viewed

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.2
+ * This file was generated by @pikku/cli@0.12.3
  */
 /**
  * Core function, middleware, and permission types for all wirings
@@ -124,6 +124,22 @@ export const pikkuMiddlewareFactory = (factory) => {
 export const pikkuPermissionFactory = (factory) => {
     return factory;
 };
+/**
+ * Factory function for creating approval description functions with tree-shaking support.
+ *
+ * @example
+ * ```typescript
+ * export const deleteTodoApproval = pikkuApprovalDescription(
+ *   async ({ todoStore }, { id }) => {
+ *     const todo = await todoStore.get(id)
+ *     return \`Delete todo: "${todo.title}"\`
+ *   }
+ * )
+ * ```
+ */
+export const pikkuApprovalDescription = (fn) => {
+    return fn;
+};
 export function pikkuFunc(func) {
     return typeof func === 'function' ? { func } : func;
 }

package/dist/.pikku/function/pikku-functions-meta.gen.js CHANGED Viewed

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