@pikku/cli 0.12.48 → 0.12.50

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import './rpc/pikku-rpc-wirings-meta.internal.gen.js';
 import './http/pikku-http-wirings-meta.gen.js';

package/dist/.pikku/pikku-meta-service.gen.d.ts

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export declare class PikkuMetaService extends LocalMetaService {

package/dist/.pikku/pikku-meta-service.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { LocalMetaService } from '@pikku/core/services/local-meta';
 export class PikkuMetaService extends LocalMetaService {

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

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

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * Main type export hub - re-exports all wiring-specific types

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * Main type export hub - re-exports all wiring-specific types

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * Queue-specific type definitions for tree-shaking optimization

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * Queue-specific type definitions for tree-shaking optimization

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { pikkuState } from '@pikku/core/internal';
 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 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import '../../src/scaffold/rpc-remote.gen.js';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /* The files with an addQueueWorkers function call */
 import '../../src/scaffold/rpc-remote.gen.js';

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

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

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

@@ -109,15 +109,15 @@
     "pikkuCommandChannels": "pikkuCommandChannels",
     "pikkuCLIEntry": "pikkuCLIEntry",
     "pikkuCLI": "pikkuCLI",
+    "pikkuCredentials": "pikkuCredentials",
     "pikkuConsoleFunctions": "pikkuConsoleFunctions",
     "pikkuNodeTypes": "pikkuNodeTypes",
     "pikkuNodesMeta": "pikkuNodesMeta",
-    "pikkuCredentials": "pikkuCredentials",
+    "pikkuGateway": "pikkuGateway",
     "pikkuFunctionTypesSplit": "pikkuFunctionTypesSplit",
     "pikkuFunctionTypes": "pikkuFunctionTypes",
     "pikkuFunctions": "pikkuFunctions",
     "pikkuServices": "pikkuServices",
-    "pikkuGateway": "pikkuGateway",
     "pikkuHTTPMap": "pikkuHTTPMap",
     "pikkuCommandHTTP": "pikkuCommandHTTP",
     "pikkuHTTPTypes": "pikkuHTTPTypes",

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { addSchema } from '@pikku/core/schema';
 import * as PikkuSchemasOutput from './schemas/PikkuSchemasOutput.schema.json' with { type: 'json' };
@@ -202,14 +202,14 @@ import * as PikkuPublicAgentOutput from './schemas/PikkuPublicAgentOutput.schema
 addSchema('PikkuPublicAgentOutput', PikkuPublicAgentOutput);
 import * as PikkuCommandChannelsOutput from './schemas/PikkuCommandChannelsOutput.schema.json' with { type: 'json' };
 addSchema('PikkuCommandChannelsOutput', PikkuCommandChannelsOutput);
-import * as PikkuCLIEntryOutput from './schemas/PikkuCLIEntryOutput.schema.json' with { type: 'json' };
-addSchema('PikkuCLIEntryOutput', PikkuCLIEntryOutput);
-import * as PikkuCLIOutput from './schemas/PikkuCLIOutput.schema.json' with { type: 'json' };
-addSchema('PikkuCLIOutput', PikkuCLIOutput);
 import * as PikkuConsoleFunctionsOutput from './schemas/PikkuConsoleFunctionsOutput.schema.json' with { type: 'json' };
 addSchema('PikkuConsoleFunctionsOutput', PikkuConsoleFunctionsOutput);
 import * as PikkuNodesMetaOutput from './schemas/PikkuNodesMetaOutput.schema.json' with { type: 'json' };
 addSchema('PikkuNodesMetaOutput', PikkuNodesMetaOutput);
+import * as PikkuCLIEntryOutput from './schemas/PikkuCLIEntryOutput.schema.json' with { type: 'json' };
+addSchema('PikkuCLIEntryOutput', PikkuCLIEntryOutput);
+import * as PikkuCLIOutput from './schemas/PikkuCLIOutput.schema.json' with { type: 'json' };
+addSchema('PikkuCLIOutput', PikkuCLIOutput);
 import * as PikkuFunctionTypesSplitInput from './schemas/PikkuFunctionTypesSplitInput.schema.json' with { type: 'json' };
 addSchema('PikkuFunctionTypesSplitInput', PikkuFunctionTypesSplitInput);
 import * as PikkuFunctionTypesInput from './schemas/PikkuFunctionTypesInput.schema.json' with { type: 'json' };
@@ -236,12 +236,6 @@ import * as PikkuQueueOutput from './schemas/PikkuQueueOutput.schema.json' with
 addSchema('PikkuQueueOutput', PikkuQueueOutput);
 import * as PikkuEventsScaffoldOutput from './schemas/PikkuEventsScaffoldOutput.schema.json' with { type: 'json' };
 addSchema('PikkuEventsScaffoldOutput', PikkuEventsScaffoldOutput);
-import * as PikkuPublicRPCOutput from './schemas/PikkuPublicRPCOutput.schema.json' with { type: 'json' };
-addSchema('PikkuPublicRPCOutput', PikkuPublicRPCOutput);
-import * as PikkuRemoteRPCOutput from './schemas/PikkuRemoteRPCOutput.schema.json' with { type: 'json' };
-addSchema('PikkuRemoteRPCOutput', PikkuRemoteRPCOutput);
-import * as PikkuRPCOutput from './schemas/PikkuRPCOutput.schema.json' with { type: 'json' };
-addSchema('PikkuRPCOutput', PikkuRPCOutput);
 import * as PikkuSchedulerOutput from './schemas/PikkuSchedulerOutput.schema.json' with { type: 'json' };
 addSchema('PikkuSchedulerOutput', PikkuSchedulerOutput);
 import * as PikkuTriggerTypesInput from './schemas/PikkuTriggerTypesInput.schema.json' with { type: 'json' };
@@ -250,5 +244,11 @@ import * as PikkuTriggerOutput from './schemas/PikkuTriggerOutput.schema.json' w
 addSchema('PikkuTriggerOutput', PikkuTriggerOutput);
 import * as PikkuWorkflowRoutesOutput from './schemas/PikkuWorkflowRoutesOutput.schema.json' with { type: 'json' };
 addSchema('PikkuWorkflowRoutesOutput', PikkuWorkflowRoutesOutput);
+import * as PikkuPublicRPCOutput from './schemas/PikkuPublicRPCOutput.schema.json' with { type: 'json' };
+addSchema('PikkuPublicRPCOutput', PikkuPublicRPCOutput);
+import * as PikkuRemoteRPCOutput from './schemas/PikkuRemoteRPCOutput.schema.json' with { type: 'json' };
+addSchema('PikkuRemoteRPCOutput', PikkuRemoteRPCOutput);
+import * as PikkuRPCOutput from './schemas/PikkuRPCOutput.schema.json' with { type: 'json' };
+addSchema('PikkuRPCOutput', PikkuRPCOutput);
 import * as PikkuCLIConfig from './schemas/PikkuCLIConfig.schema.json' with { type: 'json' };
 addSchema('PikkuCLIConfig', PikkuCLIConfig);

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 export { wireSecret } 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 export { wireSecret } 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { TypedSecretService as CoreTypedSecretService } from '@pikku/core/services';
 const CREDENTIALS_META = {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 /**
  * 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 export { wireVariable } 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 export { wireVariable } 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 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.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { TypedVariablesService as CoreTypedVariablesService } from '@pikku/core/services';
 const VARIABLES_META = {};

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { template } from '@pikku/core/workflow';

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

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { WorkflowCancelledException } from '@pikku/core/workflow';
 import { template } from '@pikku/core/workflow';

package/dist/.pikku/workflow/pikku-workflow-wirings-meta.gen.js

@@ -1,5 +1,5 @@
 /**
- * This file was generated by @pikku/cli@0.12.48
+ * This file was generated by @pikku/cli@0.12.50
  */
 import { pikkuState } from '@pikku/core/internal';
 import allWorkflowMeta from './meta/allWorkflow.gen.json' with { type: 'json' };

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

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

package/dist/bin/pikku-bin.mjs

@@ -11,8 +11,8 @@ async function checkForUpdate() {
     })
     if (!res.ok) return
     const { version: latest } = await res.json()
-    if (latest !== '0.12.48') {
-      process.stderr.write(`\n  Update available  0.12.48 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
+    if (latest !== '0.12.50') {
+      process.stderr.write(`\n  Update available  0.12.50 → ${latest}\n  brew upgrade pikku  or  npm install -g @pikku/cli\n\n`)
     }
   } catch {}
 }

package/dist/src/deploy/server-entry.d.ts

@@ -12,5 +12,5 @@
  */
 import type { EntryGenerationContext } from './provider-adapter.js';
 export declare function generateServerEntrySource(ctx: EntryGenerationContext): string;
-export declare const SERVER_DOCKERFILE = "# Generated by @pikku/cli \u2014 do not edit\nFROM node:22-slim\n\nRUN apt-get update \\\n  && apt-get install -y --no-install-recommends tini ca-certificates \\\n  && rm -rf /var/lib/apt/lists/*\n\nRUN groupadd -r pikku && useradd -r -g pikku -u 1001 pikku\n\nWORKDIR /app\n\n# Pikku bundles user code + first-party deps inline; only externalised deps\n# (typically empty for pure-JS apps) are listed in package.json. We ship no\n# lockfile because the bundle has already pinned everything via the\n# extracted exact-dependencies \u2014 `npm install --omit=dev` resolves the\n# leftover externals (if any) at build time.\nCOPY --chown=pikku:pikku package.json ./\nRUN npm install --omit=dev --no-audit --no-fund\n\nCOPY --chown=pikku:pikku bundle.js ./\n\nUSER pikku\nENV NODE_ENV=production\nENV PORT=8080\nEXPOSE 8080\n\nENTRYPOINT [\"/usr/bin/tini\", \"--\"]\nCMD [\"node\", \"bundle.js\"]\n";
+export declare const SERVER_DOCKERFILE = "# Generated by @pikku/cli \u2014 do not edit\n# Full image (not -slim): carries the build toolchain so externalised deps with\n# native addons can compile from source at `npm install` time.\nFROM node:26\n\nRUN apt-get update \\\n  && apt-get install -y --no-install-recommends tini ca-certificates \\\n  && rm -rf /var/lib/apt/lists/*\n\nRUN groupadd -r pikku && useradd -r -g pikku -u 1001 pikku\n\nWORKDIR /app\n\n# Pikku bundles user code + first-party deps inline; only externalised deps\n# (typically empty for pure-JS apps) are listed in package.json. We ship no\n# lockfile because the bundle has already pinned everything via the\n# extracted exact-dependencies \u2014 `npm install --omit=dev` resolves the\n# leftover externals (if any) at build time.\nCOPY --chown=pikku:pikku package.json ./\nRUN npm install --omit=dev --no-audit --no-fund\n\nCOPY --chown=pikku:pikku bundle.js ./\n\nUSER pikku\nENV NODE_ENV=production\nENV PORT=8080\nEXPOSE 8080\n\nENTRYPOINT [\"/usr/bin/tini\", \"--\"]\nCMD [\"node\", \"bundle.js\"]\n";
 export declare const SERVER_DOCKERIGNORE = "node_modules\n.git\n*.log\nmetafile.json\nexact-dependencies.json\n";

package/dist/src/deploy/server-entry.js

@@ -45,7 +45,9 @@ export function generateServerEntrySource(ctx) {
     return lines.join('\n');
 }
 export const SERVER_DOCKERFILE = `# Generated by @pikku/cli — do not edit
-FROM node:22-slim
+# Full image (not -slim): carries the build toolchain so externalised deps with
+# native addons can compile from source at \`npm install\` time.
+FROM node:26
 
 RUN apt-get update \\
   && apt-get install -y --no-install-recommends tini ca-certificates \\

package/dist/src/fabric/functions/validate.function.js

@@ -180,8 +180,84 @@ export async function runValidate(startDir = process.cwd()) {
         if (!pikkuConfig.clientFiles) {
             info('pikku-config-no-client-files', 'pikku.config.json missing "clientFiles" — generated RPC client files and React Query hooks will not be written', pikkuConfigPath, lines('Add a `clientFiles` block to `pikku.config.json`.', 'Recommended values:', '"clientFiles": {', '  "rpcMapDeclarationFile": "packages/functions-sdk/src/pikku/rpc-map.gen.d.ts",', '  "reactQueryFile": "packages/functions-sdk/src/pikku/api.gen.ts"', '}', 'Those files should live in `packages/functions-sdk/src/pikku/` and are generated by Pikku.'));
         }
+        // Each scaffold key gates generation of a public surface the Fabric console
+        // calls. Missing one means those endpoints are never generated, so the
+        // console 404s even though the functions/agents/workflows are wired. The
+        // generated file paths auto-derive from the flag (see pikku-cli-config), so
+        // setting the flag is sufficient. console/rpc/agent/workflow gate HTTP/RPC
+        // endpoints the console hits directly → error; events gates the realtime
+        // channel (feature-dependent, no template ships it yet) → warn.
+        const REQUIRED_SCAFFOLD = [
+            {
+                key: 'console',
+                severity: 'error',
+                surface: 'app introspection (console:getFunctionsMeta and friends) — the sandbox builder shows no functions',
+                value: '"no-auth"',
+            },
+            {
+                key: 'rpc',
+                severity: 'error',
+                surface: 'the generic /rpc/:name endpoint',
+                value: 'true',
+            },
+            {
+                key: 'agent',
+                severity: 'error',
+                surface: 'the agent endpoints (/rpc/agent/:agentName) — the agent playground 404s',
+                value: '"no-auth"',
+            },
+            {
+                key: 'workflow',
+                severity: 'error',
+                surface: 'the workflow endpoints (/workflow/:workflowName/start) — triggering a workflow 404s',
+                value: '"no-auth"',
+            },
+            {
+                key: 'events',
+                severity: 'warn',
+                surface: 'the realtime events channel',
+                value: 'true',
+            },
+        ];
+        for (const s of REQUIRED_SCAFFOLD) {
+            if (pikkuConfig.scaffold?.[s.key])
+                continue;
+            const report = s.severity === 'error' ? e : w;
+            report(`pikku-config-no-scaffold-${s.key}`, `pikku.config.json scaffold is missing "${s.key}" — ${s.surface} is never generated, so the Fabric console 404s for it`, pikkuConfigPath, lines(`Add "${s.key}" to the scaffold block in pikku.config.json:`, '"scaffold": {', '  "pikkuDir": "packages/functions/src/scaffold",', `  "${s.key}": ${s.value}`, '}', 'Then re-run codegen (`pikku all`) and restart the dev server.'));
+        }
     }
     const dbEngine = pikkuConfig?.db?.engine ?? 'sqlite';
+    // ── .gitignore must ignore generated/runtime artifacts ─────────────────
+    // These are regenerated on every dev boot / scaffold / codegen. Committing
+    // them lets a stale copy shadow the freshly generated one — a committed
+    // __fabric_scaffold.vite.config.mjs or .pikku-runtime breaks the sandbox dev
+    // server — and pollutes diffs. Tolerate trailing/leading slashes.
+    {
+        const requiredIgnores = [
+            '.opencode',
+            '.pikku',
+            '.pikku-runtime',
+            '.reports',
+            '__fabric_scaffold.vite.config.mjs',
+        ];
+        const gitignorePath = join(root, '.gitignore');
+        const gitignoreText = await readTextSafe(gitignorePath);
+        const norm = (s) => s.replace(/^\//, '').replace(/\/$/, '');
+        const ignored = new Set((gitignoreText ?? '')
+            .split('\n')
+            .map((l) => norm(l.trim()))
+            .filter(Boolean));
+        const missing = requiredIgnores.filter((entry) => !ignored.has(norm(entry)));
+        // Generated files: accept a single `*.gen.*` glob or the explicit
+        // `*.gen.ts` + `*.gen.js` pair (the canonical scaffold uses the pair).
+        const genIgnored = ignored.has('*.gen.*') ||
+            (ignored.has('*.gen.ts') && ignored.has('*.gen.js'));
+        if (!genIgnored)
+            missing.push('*.gen.*');
+        if (missing.length > 0) {
+            w('gitignore-missing-generated', `.gitignore does not ignore Fabric generated/runtime artifacts: ${missing.join(', ')} — committing them lets a stale copy shadow the freshly generated one (e.g. a committed __fabric_scaffold.vite.config.mjs or .pikku-runtime breaks the sandbox dev server)`, gitignorePath, lines('Add these entries to .gitignore:', ...missing.map((entry) => `  ${entry}`), 'They are regenerated on every dev boot / scaffold / codegen and must never be committed.'));
+        }
+    }
     const rootPkgPath = join(root, 'package.json');
     const rootPkg = await readJsonSafe(rootPkgPath);
     if (!rootPkg) {
@@ -291,6 +367,32 @@ export async function runValidate(startDir = process.cwd()) {
             if (dbEngine !== 'postgres' && fnAllDeps['@pikku/kysely-postgres']) {
                 e('fn-pkg-postgres-dep', '@pikku/kysely-postgres is in packages/functions dependencies — Fabric uses SQLite/libSQL (Turso), not PostgreSQL', fnPkgPath, 'Remove @pikku/kysely-postgres and use @pikku/kysely-sqlite with LibsqlWebDialect instead');
             }
+            // CF worker runtime deps — must be in dependencies (not dev), every
+            // worker entry resolves them at deploy time.
+            if (!fnPkg.dependencies?.['@pikku/schema-cfworker']) {
+                e('missing-schema-cfworker', '@pikku/schema-cfworker is not in packages/functions dependencies — every Cloudflare worker entry requires it', fnPkgPath, 'Run `yarn add @pikku/schema-cfworker` in packages/functions — must be in dependencies, not devDependencies');
+            }
+            if (!fnPkg.dependencies?.['@pikku/kysely']) {
+                e('missing-pikku-kysely', '@pikku/kysely is not in packages/functions dependencies — every Cloudflare worker entry requires it (KyselySecretService)', fnPkgPath, 'Run `yarn add @pikku/kysely` in packages/functions — must be in dependencies, not devDependencies');
+            }
+        }
+        // Agent units require the AI SDK deps explicitly (not CI-injected). Gate on
+        // the generated agent meta so non-agent projects aren't flagged.
+        const agentMeta = await readJsonSafe(join(fnDir, '.pikku', 'agent', 'pikku-agent-wirings-meta.gen.json'));
+        if (agentMeta && Object.keys(agentMeta.agentsMeta ?? {}).length > 0) {
+            const fnPkgPath = join(fnDir, 'package.json');
+            if (!fnPkg?.dependencies?.['@pikku/ai-vercel']) {
+                e('missing-ai-vercel', 'Project declares agent units but @pikku/ai-vercel is not in packages/functions dependencies', fnPkgPath, 'Run `yarn add @pikku/ai-vercel` in packages/functions — must be in dependencies, not devDependencies');
+            }
+            if (!fnPkg?.dependencies?.['@ai-sdk/openai-compatible']) {
+                e('missing-ai-sdk-openai-compatible', 'Project declares agent units but @ai-sdk/openai-compatible is not in packages/functions dependencies', fnPkgPath, 'Run `yarn add @ai-sdk/openai-compatible` in packages/functions — must be in dependencies, not devDependencies');
+            }
+            // `ai` is a peer dep of @pikku/ai-vercel — not auto-installed. Without it
+            // `pikku dev` can't construct the agent runner and agents 503 with
+            // AIProviderNotConfiguredError.
+            if (!fnPkg?.dependencies?.['ai']) {
+                e('missing-ai-sdk-core', 'Project declares agent units but `ai` (the Vercel AI SDK) is not in packages/functions dependencies — it is a peer dependency of @pikku/ai-vercel and is not installed automatically', fnPkgPath, 'Run `yarn add ai` in packages/functions — must be in dependencies, not devDependencies');
+            }
         }
         // services.ts
         const servicesPath = join(fnDir, 'src', 'services.ts');

package/dist/src/fabric/lib/config.js

@@ -2,7 +2,7 @@ import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { existsSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
-const DEFAULT_API_URL = 'http://localhost:7103';
+const DEFAULT_API_URL = 'https://api.pikkufabric.com';
 const projectConfigName = 'pikkufabric.config.json';
 const authFilePath = join(homedir(), '.fabric', 'auth.json');
 export async function findProjectConfig(startDir = process.cwd()) {

package/dist/src/functions/commands/dev-ai-runner.d.ts

@@ -0,0 +1,19 @@
+import type { Logger, VariablesService } from '@pikku/core/services';
+import type { AIAgentRunnerService } from '@pikku/core/services';
+/**
+ * Build the AI agent runner for `pikku dev` from env.
+ *
+ * Deployed agent units get their runner wired by the bundler; the dev server
+ * has no equivalent, so agents 503 with AIProviderNotConfiguredError unless we
+ * construct one here. When an OpenAI-compatible base URL + key are present
+ * (fabric injects LITELLM_PROXY_URL/LITELLM_API_KEY; the standard OPENAI_*
+ * vars are also honored) we point a single openai-compatible provider at it and
+ * register it under every common provider prefix. Returns undefined when no AI
+ * env is configured (agents stay disabled, with the clear downstream error) or
+ * when the AI SDK packages aren't installed in the project.
+ */
+export declare function createDevAIAgentRunner({ logger, projectRoot, variables, }: {
+    logger: Logger;
+    projectRoot: string;
+    variables: VariablesService;
+}): Promise<AIAgentRunnerService | undefined>;

package/dist/src/functions/commands/dev-ai-runner.js

@@ -0,0 +1,70 @@
+import { createRequire } from 'module';
+import { join } from 'path';
+import { pathToFileURL } from 'url';
+// Provider prefixes a fabric/proxy baseURL fronts. Models are written as
+// `openai/gpt-4o-mini`, `openai/deepseek-v4-flash`, etc. — the runner splits on
+// the first `/`, so the prefix only selects the provider entry and the bare
+// model name is forwarded to the OpenAI-compatible proxy, which routes it.
+const PROXY_PROVIDER_NAMES = [
+    'openai',
+    'anthropic',
+    'google',
+    'gemini',
+    'deepseek',
+    'xai',
+    'litellm',
+];
+/**
+ * Build the AI agent runner for `pikku dev` from env.
+ *
+ * Deployed agent units get their runner wired by the bundler; the dev server
+ * has no equivalent, so agents 503 with AIProviderNotConfiguredError unless we
+ * construct one here. When an OpenAI-compatible base URL + key are present
+ * (fabric injects LITELLM_PROXY_URL/LITELLM_API_KEY; the standard OPENAI_*
+ * vars are also honored) we point a single openai-compatible provider at it and
+ * register it under every common provider prefix. Returns undefined when no AI
+ * env is configured (agents stay disabled, with the clear downstream error) or
+ * when the AI SDK packages aren't installed in the project.
+ */
+export async function createDevAIAgentRunner({ logger, projectRoot, variables, }) {
+    // Pair the URL with its matching key — coalescing each var independently could
+    // combine an OPENAI_BASE_URL with a LITELLM_API_KEY (or vice versa) and
+    // misroute or 401 every call. Take a complete OpenAI pair first, else LiteLLM.
+    const openAIBaseURL = await variables.get('OPENAI_BASE_URL');
+    const openAIApiKey = await variables.get('OPENAI_API_KEY');
+    const liteLLMBaseURL = await variables.get('LITELLM_PROXY_URL');
+    const liteLLMApiKey = await variables.get('LITELLM_API_KEY');
+    const [baseURL, apiKey] = openAIBaseURL && openAIApiKey
+        ? [openAIBaseURL, openAIApiKey]
+        : liteLLMBaseURL && liteLLMApiKey
+            ? [liteLLMBaseURL, liteLLMApiKey]
+            : [undefined, undefined];
+    if (!baseURL || !apiKey) {
+        logger.debug('pikku dev: no AI provider env (OPENAI_BASE_URL/OPENAI_API_KEY or LITELLM_PROXY_URL/LITELLM_API_KEY) — AI agents disabled');
+        return undefined;
+    }
+    // Resolve from the project's node_modules — the AI SDK packages are the
+    // project's deps, not the CLI's, so they share the project's `ai` version.
+    const require = createRequire(pathToFileURL(join(projectRoot, 'package.json')).href);
+    let VercelAIAgentRunner;
+    let createOpenAICompatible;
+    try {
+        ;
+        ({ VercelAIAgentRunner } = await import(pathToFileURL(require.resolve('@pikku/ai-vercel')).href));
+        ({ createOpenAICompatible } = await import(pathToFileURL(require.resolve('@ai-sdk/openai-compatible')).href));
+    }
+    catch (error) {
+        logger.warn(`pikku dev: AI provider env is set but the AI SDK packages could not be loaded (install @pikku/ai-vercel, @ai-sdk/openai-compatible, and ai) — AI agents disabled: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+    const buildProviders = (key) => {
+        const provider = createOpenAICompatible({
+            name: 'pikku-dev',
+            baseURL,
+            apiKey: key,
+        });
+        return Object.fromEntries(PROXY_PROVIDER_NAMES.map((name) => [name, provider]));
+    };
+    logger.info(`pikku dev: AI agent runner wired to ${baseURL}`);
+    return new VercelAIAgentRunner(buildProviders(apiKey), buildProviders);
+}

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

@@ -15,6 +15,7 @@ import { WebSocketServer } from 'ws';
 import { InMemorySchedulerService } from '@pikku/schedule';
 import { resolveDb, createKysely, parseDatabaseUrl, } from '../db/local-db.js';
 import { loadUserBootstrap, loadUserModule } from './load-user-project.js';
+import { createDevAIAgentRunner } from './dev-ai-runner.js';
 export const dev = pikkuSessionlessFunc({
     remote: true,
     func: async ({ logger, config, getInspectorState, variables }, { port, watch, hmr }, { rpc }) => {
@@ -153,8 +154,23 @@ export const dev = pikkuSessionlessFunc({
         // can read runs in dev without projects having to wire their own backing
         // store.
         const devLogger = new ConsoleLogger();
+        // Deployed agent units get their runner from the bundler; the dev server
+        // has no equivalent, so construct one from env or agents 503 with
+        // AIProviderNotConfiguredError. The template forwards injected services
+        // (`...existingServices`) so this reaches getSingletonServices().
+        // Only when the project declares agents — otherwise the runner's
+        // missing-SDK warning fires spuriously for projects with global AI env.
+        const hasAgents = Object.keys(inspectorState.agents.agentsMeta).length > 0;
+        const aiAgentRunner = hasAgents
+            ? await createDevAIAgentRunner({
+                logger,
+                projectRoot: config.rootDir,
+                variables,
+            })
+            : undefined;
         const inMemoryServices = {
             logger: devLogger,
+            ...(aiAgentRunner ? { aiAgentRunner } : {}),
             emailService: new LocalEmailService(),
             metaService: new LocalMetaService(pikkuDir),
             schedulerService,

package/dist/src/functions/commands/tests-coverage.js

@@ -165,6 +165,12 @@ export const pikkuTestsCoverage = pikkuSessionlessFunc({
                 '--require',
                 'tests/tests/support/**/*.ts',
                 'tests/tests/features/**/*.feature',
+                '--format',
+                'progress',
+                // Persist the HTML report so the console can parse scenarios back out
+                // of it (readAllMeta attaches them per function).
+                '--format',
+                'html:tests/tests/reports/cucumber-report.html',
             ], { cwd: functionsDir, stdio: 'inherit', env: spawnEnv });
             if (res.status !== 0) {
                 logger.error(`Test run failed (exit ${res.status})`);