@pikku/cli 0.12.40 → 0.12.42

package/dist/src/fabric/functions/status.function.d.ts

@@ -7,13 +7,13 @@ export declare const FabricStatusOutput: z.ZodObject<{
 export declare const FabricStatus: import("../../../.pikku/pikku-types.gen.js").PikkuFunctionConfig<Record<string, never>, {
     projectId: string;
     status: any;
-}, "rpc" | "session", import("../../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
+}, "session" | "rpc", import("../../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
     projectId: string;
     status: any;
-}, "rpc" | "session", import("../../../types/application-types.js").Services> | import("../../../.pikku/pikku-types.gen.js").PikkuFunction<Record<string, never>, {
+}, "session" | "rpc", import("../../../types/application-types.js").Services> | import("../../../.pikku/pikku-types.gen.js").PikkuFunction<Record<string, never>, {
     projectId: string;
     status: any;
-}, "rpc" | "session", import("../../../types/application-types.js").Services>, undefined, undefined>;
+}, "session" | "rpc", import("../../../types/application-types.js").Services>, undefined, undefined>;
 type StageState = {
     stageBranch: string;
     gitSha?: string | null;

package/dist/src/fabric/functions/trace.function.d.ts

@@ -13,16 +13,16 @@ export declare const FabricTrace: import("../../../.pikku/pikku-types.gen.js").P
     json?: boolean | undefined;
 }, {
     count: number;
-}, "rpc" | "session", import("../../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
+}, "session" | "rpc", import("../../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<{
     branch: string;
     traceId: string;
     json?: boolean | undefined;
 }, {
     count: number;
-}, "rpc" | "session", import("../../../types/application-types.js").Services> | import("../../../.pikku/pikku-types.gen.js").PikkuFunction<{
+}, "session" | "rpc", import("../../../types/application-types.js").Services> | import("../../../.pikku/pikku-types.gen.js").PikkuFunction<{
     branch: string;
     traceId: string;
     json?: boolean | undefined;
 }, {
     count: number;
-}, "rpc" | "session", import("../../../types/application-types.js").Services>, undefined, undefined>;
+}, "session" | "rpc", import("../../../types/application-types.js").Services>, undefined, undefined>;

package/dist/src/fabric/functions/validate.function.d.ts

@@ -26,7 +26,7 @@ export declare const FabricValidate: import("../../../.pikku/pikku-types.gen.js"
         path: string;
         fixHint: string;
     }[];
-}, "rpc" | "session", import("../../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
+}, "session" | "rpc", import("../../../.pikku/pikku-types.gen.js").PikkuFunctionSessionless<Record<string, never>, {
     ok: boolean;
     root: string;
     findings: {
@@ -36,7 +36,7 @@ export declare const FabricValidate: import("../../../.pikku/pikku-types.gen.js"
         path: string;
         fixHint: string;
     }[];
-}, "rpc" | "session", import("../../../types/application-types.js").Services> | import("../../../.pikku/pikku-types.gen.js").PikkuFunction<Record<string, never>, {
+}, "session" | "rpc", import("../../../types/application-types.js").Services> | import("../../../.pikku/pikku-types.gen.js").PikkuFunction<Record<string, never>, {
     ok: boolean;
     root: string;
     findings: {
@@ -46,5 +46,5 @@ export declare const FabricValidate: import("../../../.pikku/pikku-types.gen.js"
         path: string;
         fixHint: string;
     }[];
-}, "rpc" | "session", import("../../../types/application-types.js").Services>, undefined, undefined>;
+}, "session" | "rpc", import("../../../types/application-types.js").Services>, undefined, undefined>;
 export declare const renderValidate: (_s: unknown, { ok, root, findings }: z.infer<typeof FabricValidateOutput>) => void;

package/dist/src/functions/commands/all.d.ts

@@ -1 +1 @@
-export declare const all: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const all: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/binary.d.ts

@@ -1,7 +1,7 @@
 export declare const binary: import("#pikku").PikkuFunctionConfig<{
     compileTarget?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     compileTarget?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     compileTarget?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/bootstrap.d.ts

@@ -1 +1 @@
-export declare const bootstrap: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const bootstrap: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/console.d.ts

@@ -2,12 +2,12 @@ export declare const consoleCommand: import("#pikku").PikkuFunctionConfig<{
     port?: string;
     open?: string;
     hmr?: boolean;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     port?: string;
     open?: string;
     hmr?: boolean;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     port?: string;
     open?: string;
     hmr?: boolean;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/db-audit.d.ts

@@ -1 +1 @@
-export declare const dbAudit: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const dbAudit: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/db-generate.d.ts

@@ -1 +1 @@
-export declare const dbGenerate: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const dbGenerate: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/db-migrate.d.ts

@@ -1 +1 @@
-export declare const dbMigrate: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const dbMigrate: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/db-reset.d.ts

@@ -1 +1 @@
-export declare const dbReset: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const dbReset: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/db-seed.d.ts

@@ -1 +1 @@
-export declare const dbSeed: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const dbSeed: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/deploy-apply.d.ts

@@ -11,12 +11,12 @@ export declare const deployApply: import("#pikku").PikkuFunctionConfig<{
     fromPlan?: boolean;
     provider?: string;
     resultFile?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     fromPlan?: boolean;
     provider?: string;
     resultFile?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     fromPlan?: boolean;
     provider?: string;
     resultFile?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/deploy-info.d.ts

@@ -1 +1 @@
-export declare const deployInfo: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const deployInfo: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/deploy-plan.d.ts

@@ -1,10 +1,10 @@
 export declare const deployPlan: import("#pikku").PikkuFunctionConfig<{
     resultFile?: string;
     provider?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     resultFile?: string;
     provider?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     resultFile?: string;
     provider?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/dev.d.ts

@@ -2,12 +2,12 @@ export declare const dev: import("#pikku").PikkuFunctionConfig<{
     port?: string;
     watch?: boolean;
     hmr?: boolean;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     port?: string;
     watch?: boolean;
     hmr?: boolean;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     port?: string;
     watch?: boolean;
     hmr?: boolean;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/emails-init.d.ts

@@ -1,5 +1,5 @@
 type EmailsInitInput = {
     force?: boolean;
 };
-export declare const pikkuEmailsInit: import("#pikku").PikkuFunctionConfig<EmailsInitInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<EmailsInitInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<EmailsInitInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuEmailsInit: import("#pikku").PikkuFunctionConfig<EmailsInitInput, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<EmailsInitInput, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<EmailsInitInput, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export {};

package/dist/src/functions/commands/enable.d.ts

@@ -1,5 +1,5 @@
-export declare const enableRpc: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const enableConsole: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const enableAgent: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const enableWorkflow: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const enableEvents: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const enableRpc: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const enableConsole: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const enableAgent: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const enableWorkflow: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const enableEvents: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/info.d.ts

@@ -2,8 +2,8 @@ type InfoInput = {
     limit?: string;
     verbose?: boolean;
 };
-export declare const pikkuInfoFunctions: import("#pikku").PikkuFunctionConfig<InfoInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuInfoTags: import("#pikku").PikkuFunctionConfig<InfoInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuInfoMiddleware: import("#pikku").PikkuFunctionConfig<InfoInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuInfoPermissions: import("#pikku").PikkuFunctionConfig<InfoInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuInfoFunctions: import("#pikku").PikkuFunctionConfig<InfoInput, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuInfoTags: import("#pikku").PikkuFunctionConfig<InfoInput, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuInfoMiddleware: import("#pikku").PikkuFunctionConfig<InfoInput, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuInfoPermissions: import("#pikku").PikkuFunctionConfig<InfoInput, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<InfoInput, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<InfoInput, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export {};

package/dist/src/functions/commands/login.d.ts

@@ -0,0 +1,37 @@
+interface LoginOptions {
+    url?: string;
+    clientId?: string;
+    scope?: string;
+    authPath?: string;
+    open?: boolean;
+}
+/**
+ * `pikku login` — authenticate the CLI against a pikku server using the
+ * better-auth device-authorization flow. Stores a session token at
+ * `~/.pikku/session.json`; generated CLI/websocket clients pick it up
+ * automatically.
+ */
+export declare const login: import("#pikku").PikkuFunctionConfig<LoginOptions, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<LoginOptions, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<LoginOptions, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+/**
+ * `pikku logout` — remove a stored session (the given `--url`, or the current
+ * default).
+ */
+export declare const logout: import("#pikku").PikkuFunctionConfig<{
+    url?: string;
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
+    url?: string;
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    url?: string;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+/**
+ * `pikku whoami` — show the current (or `--url`) stored session and whether it
+ * has expired.
+ */
+export declare const whoami: import("#pikku").PikkuFunctionConfig<{
+    url?: string;
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
+    url?: string;
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    url?: string;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export {};

package/dist/src/functions/commands/login.js

@@ -0,0 +1,85 @@
+import open from 'open';
+import { pikkuSessionlessFunc } from '#pikku';
+import { deviceLogin } from '../../utils/device-auth.js';
+import { saveSession, loadSession, clearSession, isSessionExpired, sessionFilePath, } from '../../utils/cli-session.js';
+const DEFAULT_URL = 'http://localhost:3000';
+/**
+ * `pikku login` — authenticate the CLI against a pikku server using the
+ * better-auth device-authorization flow. Stores a session token at
+ * `~/.pikku/session.json`; generated CLI/websocket clients pick it up
+ * automatically.
+ */
+export const login = pikkuSessionlessFunc({
+    func: async ({ logger }, { url, clientId, scope, authPath, open: openBrowser }) => {
+        const baseURL = (url ?? DEFAULT_URL).trim();
+        const session = await deviceLogin({
+            baseURL,
+            clientId,
+            scope,
+            authBasePath: authPath,
+            onPrompt: async ({ verificationUri, verificationUriComplete, userCode, expiresAtMs, }) => {
+                const target = verificationUriComplete ?? verificationUri;
+                logger.info('');
+                logger.info('  To finish signing in, open:');
+                logger.info(`    ${target}`);
+                logger.info('');
+                logger.info(`  And confirm this code:  ${userCode}`);
+                logger.info(`  (expires ${new Date(expiresAtMs).toLocaleTimeString()})`);
+                logger.info('');
+                logger.info('  Waiting for approval…');
+                // Default to opening the browser unless explicitly disabled.
+                if (openBrowser !== false) {
+                    try {
+                        await open(target);
+                    }
+                    catch {
+                        // Headless / no browser — the printed URL is the fallback.
+                    }
+                }
+            },
+        });
+        const path = await saveSession(session);
+        const who = session.user?.email ?? session.user?.id ?? 'authenticated';
+        logger.info(`✓ Logged in as ${who} on ${session.baseURL}`);
+        if (session.expiresAt) {
+            logger.info(`  Session expires ${new Date(session.expiresAt).toLocaleString()}`);
+        }
+        logger.info(`  Saved to ${path}`);
+    },
+});
+/**
+ * `pikku logout` — remove a stored session (the given `--url`, or the current
+ * default).
+ */
+export const logout = pikkuSessionlessFunc({
+    func: async ({ logger }, { url }) => {
+        const removed = await clearSession(url);
+        if (removed) {
+            logger.info(`✓ Logged out of ${removed}`);
+        }
+        else {
+            logger.info('No active session to log out of.');
+        }
+    },
+});
+/**
+ * `pikku whoami` — show the current (or `--url`) stored session and whether it
+ * has expired.
+ */
+export const whoami = pikkuSessionlessFunc({
+    func: async ({ logger }, { url }) => {
+        const session = await loadSession(url);
+        if (!session) {
+            logger.info('Not logged in. Run `pikku login` to authenticate.');
+            return;
+        }
+        const who = session.user?.email ?? session.user?.id ?? '(unknown user)';
+        logger.info(`Logged in as ${who}`);
+        logger.info(`  Server : ${session.baseURL}`);
+        if (session.expiresAt) {
+            const expired = isSessionExpired(session);
+            logger.info(`  Expires: ${new Date(session.expiresAt).toLocaleString()}${expired ? ' (EXPIRED — run `pikku login` again)' : ''}`);
+        }
+        logger.info(`  Stored : ${sessionFilePath()}`);
+    },
+});

package/dist/src/functions/commands/meta.d.ts

@@ -1,56 +1,56 @@
-export declare const pikkuMetaFunctionsList: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaFunctionsList: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export declare const pikkuMetaFunctionsGet: import("#pikku").PikkuFunctionConfig<{
     functionId: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     functionId: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     functionId: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaSchemasList: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaSchemasList: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export declare const pikkuMetaSchemasGet: import("#pikku").PikkuFunctionConfig<{
     schemaName: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     schemaName: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     schemaName: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWorkflowsList: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWorkflowsList: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export declare const pikkuMetaWorkflowsGet: import("#pikku").PikkuFunctionConfig<{
     workflowId: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     workflowId: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     workflowId: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaMiddlewareList: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaMiddlewareList: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export declare const pikkuMetaMiddlewareGet: import("#pikku").PikkuFunctionConfig<{
     middlewareId: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     middlewareId: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     middlewareId: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaPermissionsList: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaPermissionsList: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export declare const pikkuMetaPermissionsGet: import("#pikku").PikkuFunctionConfig<{
     permissionId: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     permissionId: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     permissionId: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWiresList: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWiresList: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 export declare const pikkuMetaWiresType: import("#pikku").PikkuFunctionConfig<{
     type: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     type: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     type: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWiresHttp: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWiresScheduler: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWiresQueue: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWiresChannel: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
-export declare const pikkuMetaWiresTrigger: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWiresHttp: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWiresScheduler: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWiresQueue: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWiresChannel: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaWiresTrigger: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 /**
  * Bulk context endpoint.
  *
@@ -63,7 +63,7 @@ export declare const pikkuMetaWiresTrigger: import("#pikku").PikkuFunctionConfig
  * Targeted `pikku meta * get` calls are still the right tool when the planner
  * wants schema details (input/output JSON schemas) for a specific entry.
  */
-export declare const pikkuMetaContext: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaContext: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;
 /**
  * Frontend-targeted metadata.
  *
@@ -79,4 +79,4 @@ export declare const pikkuMetaContext: import("#pikku").PikkuFunctionConfig<{},
  * non-exposed functions, http wires) is a backend concern and stays in
  * `pikku meta context`.
  */
-export declare const pikkuMetaClients: import("#pikku").PikkuFunctionConfig<{}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuMetaClients: import("#pikku").PikkuFunctionConfig<{}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/new-addon.d.ts

@@ -12,7 +12,7 @@ export declare const pikkuNewAddon: import("#pikku").PikkuFunctionConfig<{
     openapi?: string;
     mcp?: boolean;
     camelCase?: boolean;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     name: string;
     displayName?: string;
     description?: string;
@@ -26,7 +26,7 @@ export declare const pikkuNewAddon: import("#pikku").PikkuFunctionConfig<{
     openapi?: string;
     mcp?: boolean;
     camelCase?: boolean;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     name: string;
     displayName?: string;
     description?: string;
@@ -40,4 +40,4 @@ export declare const pikkuNewAddon: import("#pikku").PikkuFunctionConfig<{
     openapi?: string;
     mcp?: boolean;
     camelCase?: boolean;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/new-function.d.ts

@@ -1,10 +1,10 @@
 export declare const pikkuNewFunction: import("#pikku").PikkuFunctionConfig<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/new-middleware.d.ts

@@ -1,10 +1,10 @@
 export declare const pikkuNewMiddleware: import("#pikku").PikkuFunctionConfig<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/new-permission.d.ts

@@ -1,10 +1,10 @@
 export declare const pikkuNewPermission: import("#pikku").PikkuFunctionConfig<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/new-wiring.d.ts

@@ -1,10 +1,10 @@
 export declare const pikkuNewWiring: import("#pikku").PikkuFunctionConfig<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     name: string;
     type?: string;
-}, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/pikku-command-bootstrap.d.ts

@@ -1,4 +1,4 @@
 export type BootstrapInput = {
     allImports: string[];
 };
-export declare const pikkuBootstrap: import("#pikku").PikkuFunctionConfig<BootstrapInput, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<BootstrapInput, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<BootstrapInput, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuBootstrap: import("#pikku").PikkuFunctionConfig<BootstrapInput, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<BootstrapInput, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<BootstrapInput, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;

package/dist/src/functions/commands/pikku-command-summary.d.ts

@@ -1 +1 @@
-export declare const pikkuSummary: import("#pikku").PikkuFunctionConfig<void, void, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<void, void, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+export declare const pikkuSummary: import("#pikku").PikkuFunctionConfig<void, void, "session" | "rpc", import("#pikku").PikkuFunctionSessionless<void, void, "session" | "rpc", import("#pikku").Services> | import("#pikku").PikkuFunction<void, void, "session" | "rpc", import("#pikku").Services>, undefined, undefined>;