@instruktlabs/kiln 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/.codex-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +12 -0
  4. package/dist/agent-run.mjs +220 -150
  5. package/dist/build.json +22 -22
  6. package/dist/cli.mjs +225 -150
  7. package/dist/mcp-engine.mjs +398 -144
  8. package/dist/mcp-server.mjs +1 -1
  9. package/docs/sdk.md +23 -0
  10. package/docs/tools-operations.md +1529 -0
  11. package/lib/discovery/index.d.ts +1 -1
  12. package/lib/discovery/index.js +2 -2
  13. package/lib/discovery/service.d.ts +3 -1
  14. package/lib/discovery/service.js +4 -2
  15. package/lib/engine-identity.d.ts +1 -1
  16. package/lib/engine-identity.js +1 -1
  17. package/lib/mcp-core.d.ts +2 -1
  18. package/lib/mcp-core.js +1 -0
  19. package/lib/mcp-engine.d.ts +2 -0
  20. package/lib/mcp-engine.js +8 -3
  21. package/lib/tools/discovery.d.ts +1 -1
  22. package/lib/tools/discovery.js +11 -9
  23. package/lib/tools/materials.d.ts +1 -1
  24. package/lib/tools/materials.js +44 -14
  25. package/lib/tools/operation-contract.d.ts +8 -0
  26. package/lib/tools/operation-contract.js +37 -0
  27. package/lib/tools/operations.d.ts +3 -0
  28. package/lib/tools/operations.js +154 -0
  29. package/lib/tools/registry.d.ts +6 -2
  30. package/lib/tools/registry.js +71 -23
  31. package/package.json +2 -1
  32. package/plugin.json +1 -1
  33. package/plugins/kiln-engine/.claude-plugin/plugin.json +1 -1
  34. package/plugins/kiln-engine/README.md +3 -3
  35. package/plugins/kiln-engine/package-provenance.json +6 -6
  36. package/plugins/kiln-engine/plugin.json +1 -1
  37. package/plugins/kiln-engine/runtime.json +1 -1
  38. package/src/discovery/index.ts +2 -0
  39. package/src/discovery/service.ts +3 -1
  40. package/src/engine-identity.ts +1 -1
  41. package/src/mcp-core.ts +3 -0
  42. package/src/mcp-engine.ts +11 -1
  43. package/src/tools/discovery.ts +20 -10
  44. package/src/tools/materials.ts +59 -15
  45. package/src/tools/operation-contract.ts +51 -0
  46. package/src/tools/operations.ts +177 -0
  47. package/src/tools/registry.ts +100 -20
@@ -2085,7 +2085,7 @@ import { readFile } from "node:fs/promises";
2085
2085
  var KILN_ASSET_WIDGET_URI = "ui://kiln/asset-v5.html";
2086
2086
 
2087
2087
  // src/engine-identity.ts
2088
- var ENGINE_VERSION = "1.1.0";
2088
+ var ENGINE_VERSION = "1.2.0";
2089
2089
  var ENGINE_INSTALL_URL = new URL("../", import.meta.url).href;
2090
2090
 
2091
2091
  // src/requirements-json.ts
package/docs/sdk.md CHANGED
@@ -136,6 +136,29 @@ the stability of the helpers it uses. Exact details retain the same structured
136
136
  `stability` field. Implicit modeling remains available without a new opt-in switch;
137
137
  the community exporter retains its explicit selection.
138
138
 
139
+ ## Named operation presentation
140
+
141
+ In package version 1.2.0 and later, embeddings can select
142
+ `createKilnMcpServer(context, { toolPresentation: 'operations' })`, or obtain the
143
+ same definitions through `createKilnOperationToolRegistry(context)` from `tools`.
144
+ The default MCP and native interfaces retain their existing grouped tools.
145
+
146
+ With asset and material storage, and without project/review or renderer-control
147
+ callbacks, the named presentation exposes 21 tools. Asset browsing becomes
148
+ `kiln_assets_search` with an optional collection; material browsing becomes
149
+ `kiln_material_search` with `scope: 'all' | 'presets' | 'saved'`. Material creation
150
+ uses `kiln_material_create` with a required `definition` discriminated by
151
+ `kind: 'preset' | 'procedural'`. Saving, importing, retrieval and source restoration
152
+ remain explicit operations. Renderer controls appear only when their callbacks
153
+ exist. Connected `tools/list` remains authoritative.
154
+
155
+ Action requirements and field constraints come from the shared engine registry.
156
+ Generation rejects unclassified action/field additions and missing required
157
+ fields. Hosts select supported operations and add their actual execution and
158
+ persistence policy; do not copy domain schemas or assume a local read hint
159
+ describes a quota-admitted cloud job. This API change does not publish a package
160
+ or deploy a hosted service. Actual client acceptance is still required.
161
+
139
162
  ## Maintainer qualification
140
163
 
141
164
  `node scripts/build-runtime.mjs all` builds both executable bundles and the ESM SDK.