@pikku/skills 0.12.28 → 0.12.30

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @pikku/skills
 
+## 0.12.30
+
+### Patch Changes
+
+- 9c5aa96: dev/serve: always inject the local content service
+
+  `pikku dev` and `pikku serve` only built `LocalContent` when `pikku.config.json`
+  declared a `content` block, so a project without one type-checks, renders and
+  starts clean and then throws the first time anything uploads a file. Every field
+  already had a default, so the block was gating a service that needed no
+  configuration. It is now always constructed; the `content` block still overrides
+  the storage path, URL prefixes and size limit.
+
+  Also documents it in the `pikku-services` skill: these singletons arrive as
+  `existingServices` and are never named in `services.ts`, so their absence there
+  is not evidence they are off — which is what makes the `if (!content) throw`
+  guard the skill already forbids look justified.
+
+- 5e2a579: pikku-wiring: document how an MCP tool is actually reached
+
+  `references/mcp.md` ended with a standalone `PikkuMCPServer` bootstrap — a
+  `start.ts` that builds services, loads `mcp.gen.json` and calls `connectStdio()`.
+  Nothing in a `pikku dev` / `pikku serve` / deployed app does that: the runtime
+  mounts the MCP server itself at `/mcp` (`mcpPath` to move it) whenever
+  `mcp.gen.json` has at least one entry. An agent following the old section wrote a
+  server process nobody runs, and then could not tell the person who asked for the
+  tool where to point their assistant.
+
+  Replaces it with the reachable URL, the two things that read as breakage — the
+  mount is skipped while there is nothing to serve, and correct MCP wiring has no
+  `wires/mcp` directory and no `mcp` config block — and the instruction to hand over
+  the URL. Swaps the stdio-logger red flag for a `/mcp` 404 one.
+
+## 0.12.29
+
+### Patch Changes
+
+- 96b65ae: Document how an addon ships database tables: `pikku db export`, the artifact the
+  consumer resolves through the package name, and the silent failure when it is
+  neither exported nor packed.
+- c4ee98d: **pikku-build** gains `references/design.md`: the composition doctrine that no theme can supply. An app built to the letter of the skill still came out looking like nobody had decided anything — a form at the top of every list screen, sixty identical cards each carrying two filled buttons, an "urgent" group holding half the fridge, a scaffolded login page with a Google button the app had no credentials for, and the whole thing judged against a dev database full of `Ripe peaches d193e2aa` left behind by scenario runs. The new reference names the bar (six questions a screen has to answer), the composition rules that get it there, the screens agents forget — login, navigation, empty states — and the reset-and-restart that has to happen before any of it is judged. §8 now says out loud that half of it belongs at §6, because a design pass over eight finished milestones is a repaint.
+- f99547e: Two things an agent building a vision feature had to discover by reading source. **pikku-agent** now documents `attachments`: the `data`/`url` split, that a `url` is downloaded server-side (so a caller-supplied one is an SSRF surface the runner's host allowlist exists for), that the model id — not the provider prefix — decides whether an image is read at all, and that reading a picture into typed data is the tool-free case `output` was waiting for. **pikku-fabric** gains "Reaching a model": `pikku dev` builds the `agentRunner` from a matching `OPENAI_BASE_URL`/`OPENAI_API_KEY` or `LITELLM_PROXY_URL`/`LITELLM_API_KEY` pair and otherwise 503s every agent with `AIProviderNotConfiguredError`, and `pikku fabric llm key --env` is the one command that fills either pair in from the Fabric AI gateway.
+
 ## 0.12.28
 
 ### Patch Changes