@klok-integration/cli 0.7.309 → 0.7.317

package/THIRD-PARTY-NOTICES.md

@@ -437,6 +437,34 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 THE SOFTWARE.
 ```
 
+## cross-spawn@7.0.6
+
+Licence: MIT — https://github.com/moxystudio/node-cross-spawn
+
+```
+The MIT License (MIT)
+
+Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+```
+
 ## deepmerge@4.3.1
 
 Licence: MIT — https://github.com/TehShrike/deepmerge
@@ -557,6 +585,35 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
+## eventsource@3.0.7
+
+Licence: MIT — https://github.com/EventSource/eventsource#readme
+
+```
+The MIT License
+
+Copyright (c) EventSource GitHub organisation
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
 ## eventsource-parser@3.1.1
 
 Licence: MIT — https://github.com/rexxars/eventsource-parser#readme
@@ -838,6 +895,28 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
+## isexe@2.0.0
+
+Licence: ISC — https://github.com/isaacs/isexe#readme
+
+```
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```
+
 ## jose@6.2.12
 
 Licence: MIT — https://github.com/panva/jose
@@ -958,6 +1037,50 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
+## path-key@3.1.1
+
+Licence: MIT
+
+```
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## pkce-challenge@5.0.1
+
+Licence: MIT — https://github.com/crouchcd/pkce-challenge#readme
+
+```
+MIT License
+
+Copyright (c) 2019 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
 ## react@18.3.1
 
 Licence: MIT — https://reactjs.org/
@@ -1074,6 +1197,38 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## shebang-command@2.0.0
+
+Licence: MIT
+
+```
+MIT License
+
+Copyright (c) Kevin Mårtensson <kevinmartensson@gmail.com> (github.com/kevva)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
+## shebang-regex@3.0.0
+
+Licence: MIT
+
+```
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```
+
 ## signal-exit@3.0.7
 
 Licence: ISC — https://github.com/tapjs/signal-exit
@@ -1190,6 +1345,28 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
+## which@2.0.2
+
+Licence: ISC — git://github.com/isaacs/node-which.git
+
+```
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+```
+
 ## widest-line@5.0.0
 
 Licence: MIT

package/assets/agents/knowledge/glossary.md

@@ -9,9 +9,11 @@ it as the source does.
 | Klok | The integration platform the documented project runs on (iPaaS): Camel routes on Quarkus, an Apache Pulsar broker, datamodels, and the portal klok.dev |
 | ODL | Operative Data Layer: the platform's store for datamodel objects, keyed by the object's datamodel type and an id, per tenant; routes write, read and search it (backed by OpenSearch) |
 | Claim check | A large payload stored in the platform's object storage; the message carries only a reference to it (a `klokcc://` URI) instead of the bytes |
-| Broker, topic | Apache Pulsar. A topic is named `persistent://<tenant>[_<env>]/<domain>/<Model>[_<purpose>]` and carries CloudEvents whose data is a datamodel |
+| Broker | The platform's one central Apache Pulsar service, its storage included: the point every system talks to instead of to each other. Klok has no mesh of brokers or sidecars: say the broker |
+| Topic | A named, persisted, ordered log on the broker, `persistent://<tenant>[_<env>]/<domain>/<Model>[_<purpose>]`, owned by the publisher's tenant; it carries CloudEvents whose data is one datamodel. A topic is never called a queue |
+| Subscription | A reader's named cursor on a topic, named after its route id. Its type decides how the topic is read: `exclusive` or `failover` as a stream (one consumer, strict order), `shared` as a queue (competing consumers, each message goes to one of them and the order is given up), `key_shared` as a stream per key (order within a key, parallel across keys). Several subscriptions on one topic each get every message (publish/subscribe) |
 | CloudEvent | The standard envelope of every broker message: id, type, source, time, and the datamodel as data |
-| DLQ | Dead letter queue: `<topic>_DLQ`, where a message goes after its retries are exhausted |
+| DLQ | Dead letter topic `<topic>_DLQ`, where a message goes after its retries are exhausted; it is provisioned with its topic |
 | Tenant | An organisation on the platform, and its security boundary; every topic, ODL object and GitLab group belongs to one tenant |
 | Domain | A business area inside a tenant. `common` is shared by the tenant's domains, `public` is open to anyone |
 | Route, route id | One Camel route per Java class (except a `KlokRestApi`, one per operation, and a `KlokRuntimeInstanceRoute`, one per instance `<RouteId>#<instanceKey>`). Its id is `<TENANTSHORT><NNN><LEG><seq>_<Description>`, for example `KLK007T1_PublishKlokStandard`; the class name is the id |

package/assets/agents/knowledge/platform-rules.md

@@ -111,6 +111,11 @@ documentation or the dependency catalog can give you.
   When the content belongs to one reader, the publisher may choose that reader's tenant slug as the purpose
   (`persistent://konvoj/hr/PersonnelScheduleExportV1_degerfors`); that is the publisher's choice, not a condition
   for reading across tenants.
+* The topic stores, the subscription decides how it is read. A topic is always a persisted, ordered log; whether its
+  reader behaves like a stream or a queue is the subscription type (`<RouteId>.subscription.type`): `exclusive`
+  (the default) or `failover` read it as a stream in strict order, `shared` as a queue with competing consumers (the
+  order is given up), `key_shared` as a stream per message key. Every subscription on a topic gets every message, and
+  the framework dead letters to `<topic>_DLQ` whatever the type.
 * Request/reply: `ReqRes_<Request>_<Reply>[_<purpose>]_Request` and `_Response`. Dead letters: `<topic>_DLQ`.
 * One datamodel per topic. A breaking change is a new major version and therefore a new topic.
 * Topics are provisioned from Git; the broker never creates one by itself. A topic exists when its owning tenant's

package/assets/agents/knowledge/retired-patterns.txt

@@ -14,6 +14,11 @@
 (?i)class X on the (mesh|broker) # all four datamodel classes may go on the broker; transform at the edge is about readers
 (?i)class B \(Global\) # class B is "common", shared across the tenant's domains
 #
+# Klok has one central broker, not a mesh (2026-10-22): say the broker, a topic or a subscription.
+(?i)\b(the|an?|klok|event|events|integration|async|asynchronous|event-driven|message-based|service) mesh\b # Klok has one central broker, not a mesh: say the broker, a topic or a subscription
+(?i)\b(mesh(en|ens|et|ets)|meddelandemesh(en)?|klok-mesh(en|ens)?)\b # Klok har en central broker, ingen mesh: skriv brokern, en topic eller en subscription
+(?i)\bmesh[- ](theory|teori)\b # the chapter is event-driven integration; Klok has one central broker, not a mesh
+#
 # Route ids are <TENANTSHORT><NNN><LEG><seq>_<Description>, legs I P E A S T.
 \bS<(NNNN|ID|SolutionID|Solution|NNN)> # old S-prefixed integration ids; use <TENANTSHORT><NNN><LEG><seq>_<Description>
 \bS[0-9]{4}[IEP][0-9] # old S-prefixed route id such as S0001I1; use KLK002I1_... style ids

package/assets/agents/skills/klok-cli/reference.md

@@ -35,6 +35,7 @@ Examples:
   klok agent plan KLK001 --change-request change.md
   klok agent serve
   klok bead report fortnox-egress-1 --status done --message "Merged MR !12"
+  klok code                       # the bundled terminal agent: tools in src/klokcode/, MCP from klokcode.jsonc
   klok agents init                # KLOK-AGENTS.md, harness rows, platform and tenant skills, the session hook
   klok agents update              # fetch the platform and tenant catalogs, write what moved, prune by marker
   klok agents update --check      # exit 5 when a catalog is outdated or missing, write nothing
@@ -600,6 +601,98 @@ Examples:
   klok ci timings --project "klok/integration/*" --no-logs
 ```
 
+## klok code
+
+```
+klok code [options] [command]
+```
+
+A small coding agent in the terminal: reads a task, calls tools, answers
+
+| Option | Description |
+|---|---|
+| `-m, --model <model>` | Model name (default: klokcode.jsonc `model`, then klok config klokerModel) |
+| `--base-url <url>` | OpenAI compatible base URL, without /chat/completions (default: Kloker) |
+
+### klok code run
+
+```
+klok code run [options] <message...>
+```
+
+Send one message, print the answer and exit
+
+| Argument | Description |
+|---|---|
+| `<message...>` | required |
+
+### klok code mcp
+
+```
+klok code mcp [options] [command]
+```
+
+Manage the MCP servers of ~/.config/klokcode/klokcode.jsonc, or $XDG_CONFIG_HOME/klokcode/klokcode.jsonc when it is set
+
+#### klok code mcp add
+
+```
+klok code mcp add [options] [name] [command...]
+```
+
+Add an MCP server: a remote one with --url, or a local one with the command after --, e.g. `klok code mcp add shop --url http://localhost:4141/mcp` or `klok code mcp add files -- npx -y @modelcontextprotocol/server-filesystem .`. Asks for what is left out.
+
+| Argument | Description |
+|---|---|
+| `[name]` | optional |
+| `[command...]` | optional |
+
+| Option | Description |
+|---|---|
+| `--url <url>` | URL of a remote MCP server |
+| `--header <KEY=VALUE>` | HTTP header for a remote MCP server (repeatable) |
+| `--env <KEY=VALUE>` | Environment variable for a local MCP server (repeatable) |
+
+#### klok code mcp list
+
+```
+klok code mcp list [options]
+```
+
+Connect to every MCP server and list its tools
+
+#### klok code mcp remove
+
+```
+klok code mcp remove [options] <name>
+```
+
+Remove an MCP server from the global configuration
+
+| Argument | Description |
+|---|---|
+| `<name>` | required |
+
+### klok code demo
+
+```
+klok code demo [options] [command]
+```
+
+Demo services for workshops
+
+#### klok code demo shop
+
+```
+klok code demo shop [options]
+```
+
+Start the demo shop: an MCP server with orders and a local outbox, and a page showing both (Ctrl+C stops)
+
+| Option | Description |
+|---|---|
+| `--port <port>` | Port to listen on (default: `4141`) |
+
 ## klok datamodel
 
 ```