pico-engine 1.9.4 → 1.10.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 (186) hide show
  1. package/README.md +13 -5
  2. package/demos/bootstrap/README.md +12 -0
  3. package/demos/bootstrap/com.example.visitors.bootstrap.krl +101 -0
  4. package/demos/bootstrap/com.example.visitors.format.krl +25 -0
  5. package/demos/bootstrap/com.example.visitors.krl +228 -0
  6. package/demos/bootstrap/try-it.md +5 -0
  7. package/demos/child_tasks/README.md +12 -0
  8. package/demos/child_tasks/com.example.task_runner.bootstrap.krl +88 -0
  9. package/demos/child_tasks/com.example.task_runner.krl +139 -0
  10. package/demos/child_tasks/com.example.task_worker.krl +45 -0
  11. package/demos/child_tasks/try-it.md +5 -0
  12. package/demos/collection/README.md +13 -0
  13. package/demos/collection/com.example.collection.bootstrap.krl +148 -0
  14. package/demos/collection/com.example.collection.krl +95 -0
  15. package/demos/collection/com.example.collection.report.krl +93 -0
  16. package/demos/collection/com.example.collection.room.krl +101 -0
  17. package/demos/collection/try-it.md +6 -0
  18. package/demos/echo/README.md +11 -0
  19. package/demos/echo/com.example.echo.bootstrap.krl +84 -0
  20. package/demos/echo/com.example.echo.krl +73 -0
  21. package/demos/echo/try-it.md +5 -0
  22. package/demos/guard_rules/README.md +12 -0
  23. package/demos/guard_rules/com.example.archive.bootstrap.krl +98 -0
  24. package/demos/guard_rules/com.example.archive.krl +213 -0
  25. package/demos/guard_rules/com.example.archive_store.krl +36 -0
  26. package/demos/guard_rules/try-it.md +5 -0
  27. package/demos/json_query/README.md +11 -0
  28. package/demos/json_query/com.example.json_query.bootstrap.krl +84 -0
  29. package/demos/json_query/com.example.json_query.krl +162 -0
  30. package/demos/json_query/try-it.md +5 -0
  31. package/demos/kblog/README.md +14 -0
  32. package/demos/kblog/com.example.kblog.bootstrap.krl +135 -0
  33. package/demos/kblog/com.example.kblog.config.krl +50 -0
  34. package/demos/kblog/com.example.kblog.data.krl +75 -0
  35. package/demos/kblog/com.example.kblog.krl +184 -0
  36. package/demos/kblog/com.example.kblog.posting.krl +109 -0
  37. package/demos/kblog/try-it.md +6 -0
  38. package/demos/layered_rulesets/README.md +13 -0
  39. package/demos/layered_rulesets/com.example.invitations.bootstrap.krl +87 -0
  40. package/demos/layered_rulesets/com.example.invitations.krl +164 -0
  41. package/demos/layered_rulesets/com.example.invitations.short_links.krl +45 -0
  42. package/demos/layered_rulesets/com.example.invitations.welcome.krl +39 -0
  43. package/demos/layered_rulesets/try-it.md +5 -0
  44. package/demos/moving_picos/README.md +15 -0
  45. package/demos/moving_picos/io.picolabs.club_gear_demo.krl +650 -0
  46. package/demos/moving_picos/io.picolabs.ride_coordinator_demo.krl +331 -0
  47. package/demos/score_tracker/README.md +11 -0
  48. package/demos/score_tracker/com.example.score_tracker.bootstrap.krl +107 -0
  49. package/demos/score_tracker/com.example.score_tracker.krl +162 -0
  50. package/demos/score_tracker/try-it.md +5 -0
  51. package/demos/secrets/README.md +12 -0
  52. package/demos/secrets/com.example.hook_service.krl +120 -0
  53. package/demos/secrets/com.example.notifier.bootstrap.krl +130 -0
  54. package/demos/secrets/com.example.notifier.krl +138 -0
  55. package/demos/secrets/try-it.md +5 -0
  56. package/demos/try-it-order.json +1 -0
  57. package/demos/two_picos/README.md +12 -0
  58. package/demos/two_picos/com.example.two_picos.answerer.krl +125 -0
  59. package/demos/two_picos/com.example.two_picos.asker.krl +124 -0
  60. package/demos/two_picos/com.example.two_picos.bootstrap.krl +134 -0
  61. package/demos/two_picos/try-it.md +5 -0
  62. package/demos/xmlui/README.md +17 -0
  63. package/demos/xmlui/com.example.contacts.krl +132 -0
  64. package/demos/xmlui/com.example.fav_color.krl +39 -0
  65. package/demos/xmlui/com.example.guestbook.krl +61 -0
  66. package/demos/xmlui/com.example.hello.krl +19 -0
  67. package/demos/xmlui/com.example.temperature_sensors_view.krl +105 -0
  68. package/demos/xmlui/com.example.thermostat.bootstrap.krl +95 -0
  69. package/demos/xmlui/com.example.thermostat.krl +124 -0
  70. package/demos/xmlui/temperature_sensors.krl +56 -0
  71. package/demos/xmlui/try-it.md +5 -0
  72. package/dist/bundledKrl.js +97 -12
  73. package/dist/cli.js +7 -1
  74. package/dist/engineConfig.js +20 -1
  75. package/dist/identity/portableMove.js +5 -1
  76. package/dist/index.js +45 -12
  77. package/dist/internalAccess.js +110 -0
  78. package/dist/oauth/OAuthService.js +172 -10
  79. package/dist/oauth/acg.js +194 -24
  80. package/dist/oauth/cimd.js +381 -0
  81. package/dist/oauth/discovery.js +175 -0
  82. package/dist/runMcp.js +1 -1
  83. package/dist/server.js +210 -47
  84. package/dist/subtreeWrangler.js +8 -5
  85. package/dist/uiChannelPolicies.js +2 -0
  86. package/krl/io.picolabs.pds.krl +109 -21
  87. package/krl/io.picolabs.pico-engine-ui.krl +13 -7
  88. package/krl/io.picolabs.wrangler.krl +21 -9
  89. package/krl/io.picolabs.xmlui.krl +3 -2
  90. package/mcp/devResources.js +52 -0
  91. package/mcp/devTools.js +40 -9
  92. package/mcp/docs/CLAUDE.md +6 -4
  93. package/mcp/docs/cookbook/README.md +23 -0
  94. package/mcp/docs/cookbook/bootstrap/README.md +23 -0
  95. package/mcp/docs/cookbook/bootstrap/instructions.md +75 -0
  96. package/mcp/docs/cookbook/child_tasks/README.md +20 -0
  97. package/mcp/docs/cookbook/child_tasks/instructions.md +60 -0
  98. package/mcp/docs/cookbook/collection/README.md +21 -0
  99. package/mcp/docs/cookbook/collection/instructions.md +93 -0
  100. package/mcp/docs/cookbook/echo/README.md +19 -0
  101. package/mcp/docs/cookbook/echo/instructions.md +59 -0
  102. package/mcp/docs/cookbook/guard_rules/README.md +22 -0
  103. package/mcp/docs/cookbook/guard_rules/instructions.md +73 -0
  104. package/mcp/docs/cookbook/json_query/README.md +26 -0
  105. package/mcp/docs/cookbook/json_query/instructions.md +64 -0
  106. package/mcp/docs/cookbook/kblog/README.md +60 -0
  107. package/mcp/docs/cookbook/kblog/instructions.md +102 -0
  108. package/mcp/docs/cookbook/layered_rulesets/README.md +24 -0
  109. package/mcp/docs/cookbook/layered_rulesets/instructions.md +87 -0
  110. package/mcp/docs/cookbook/moving_picos/README.md +44 -0
  111. package/mcp/docs/cookbook/moving_picos/instructions.md +150 -0
  112. package/mcp/docs/cookbook/score_tracker/README.md +19 -0
  113. package/mcp/docs/cookbook/score_tracker/instructions.md +73 -0
  114. package/mcp/docs/cookbook/secrets/README.md +25 -0
  115. package/mcp/docs/cookbook/secrets/instructions.md +98 -0
  116. package/mcp/docs/cookbook/two_picos/README.md +20 -0
  117. package/mcp/docs/cookbook/two_picos/instructions.md +88 -0
  118. package/mcp/docs/cookbook/xmlui/README.md +23 -0
  119. package/mcp/docs/cookbook/xmlui/instructions.md +84 -0
  120. package/mcp/docs/developing/README.md +28 -0
  121. package/mcp/docs/developing/accepting-relationship-requests.md +65 -0
  122. package/mcp/docs/developing/arrays-and-maps.md +77 -0
  123. package/mcp/docs/developing/converting-time-formats.md +28 -0
  124. package/mcp/docs/developing/cookies-and-redirects.md +81 -0
  125. package/mcp/docs/developing/decoding-form-data.md +67 -0
  126. package/mcp/docs/developing/engine-log-files.md +34 -0
  127. package/mcp/docs/developing/event-loop.md +77 -0
  128. package/mcp/docs/developing/events-from-email.md +80 -0
  129. package/mcp/docs/developing/initializing-entity-variables.md +83 -0
  130. package/mcp/docs/developing/mcp-ai-tools.md +98 -0
  131. package/mcp/docs/developing/misconceptions.md +467 -0
  132. package/mcp/docs/developing/names-and-scope.md +44 -0
  133. package/mcp/docs/developing/postman.md +159 -0
  134. package/mcp/docs/developing/querying-another-pico.md +47 -0
  135. package/mcp/docs/developing/singleton-picos.md +36 -0
  136. package/mcp/docs/developing/tabular-data.md +67 -0
  137. package/mcp/docs/developing/tips.md +251 -0
  138. package/mcp/docs/developing/webhook-signatures.md +56 -0
  139. package/mcp/docs/developing/workflow.md +106 -0
  140. package/mcp/docs/exp/README.md +46 -0
  141. package/mcp/docs/exp/event.md +110 -0
  142. package/mcp/docs/exp/query.md +94 -0
  143. package/mcp/docs/lessons/README.md +59 -0
  144. package/mcp/docs/lessons/events-and-queries.md +247 -0
  145. package/mcp/docs/lessons/gossip.md +28 -0
  146. package/mcp/docs/lessons/modules-and-apis.md +270 -0
  147. package/mcp/docs/lessons/pico-based-systems.md +470 -0
  148. package/mcp/docs/lessons/pico-state.md +267 -0
  149. package/mcp/docs/lessons/pico-views.md +290 -0
  150. package/mcp/docs/lessons/quickstart.md +157 -0
  151. package/mcp/docs/lessons/relationships.md +530 -0
  152. package/mcp/docs/lessons/scatter-gather.md +362 -0
  153. package/mcp/docs/pico-engine.md +10 -5
  154. package/mcp/docs/pico-overview.md +3 -3
  155. package/mcp/docs/wrangler/README.md +47 -0
  156. package/mcp/docs/wrangler/channels.md +235 -0
  157. package/mcp/docs/wrangler/oauth.md +56 -0
  158. package/mcp/docs/wrangler/pds.md +423 -0
  159. package/mcp/docs/wrangler/portable-subtree.md +44 -0
  160. package/mcp/docs/wrangler/relationships.md +297 -0
  161. package/mcp/docs/wrangler/wrangler.md +253 -0
  162. package/mcp/docs/wrangler/xmlui.md +60 -0
  163. package/mcp/engineClient.js +57 -5
  164. package/mcp/mcpScopes.js +118 -0
  165. package/mcp/meshHttp.js +151 -45
  166. package/mcp/runStdio.js +2 -0
  167. package/mcp/subtreeTools.js +184 -0
  168. package/mcp/tryItTools.js +202 -0
  169. package/package.json +18 -9
  170. package/public/.DS_Store +0 -0
  171. package/public/pico-engine-ui.css +1 -1
  172. package/public/pico-engine-ui.js +26 -25
  173. package/src/bundledKrl.ts +118 -12
  174. package/src/cli.ts +8 -2
  175. package/src/engineConfig.ts +33 -2
  176. package/src/identity/portableMove.ts +6 -1
  177. package/src/index.ts +469 -422
  178. package/src/internalAccess.ts +127 -0
  179. package/src/oauth/OAuthService.ts +243 -11
  180. package/src/oauth/acg.ts +289 -25
  181. package/src/oauth/cimd.ts +508 -0
  182. package/src/oauth/discovery.ts +233 -0
  183. package/src/runMcp.ts +3 -1
  184. package/src/server.ts +266 -51
  185. package/src/subtreeWrangler.ts +17 -5
  186. package/src/uiChannelPolicies.ts +2 -0
package/src/bundledKrl.ts CHANGED
@@ -141,32 +141,138 @@ export function engineKrlRelativeFromUrl(url: string): string | null {
141
141
 
142
142
  if (parsed.protocol === "http:" || parsed.protocol === "https:") {
143
143
  const match = parsed.pathname.match(/^\/krl\/(.+\.krl)$/);
144
- if (match) {
145
- const relativePath = match[1].split("/").join(path.sep);
146
- const candidate = path.join(bundledKrlDir(), relativePath);
147
- if (fs.existsSync(candidate)) {
148
- return match[1];
149
- }
144
+ if (match && resolveEngineKrlFile(match[1])) {
145
+ return match[1];
150
146
  }
151
147
  }
152
148
 
153
149
  return null;
154
150
  }
155
151
 
156
- export function resolveEngineKrlFile(relativePath: string): string | null {
157
- const normalized = relativePath.split("/").join(path.sep);
158
- const candidate = path.resolve(bundledKrlDir(), normalized);
159
- const root = bundledKrlDir();
152
+ /**
153
+ * The demos/ directory: PICO_ENGINE_DEMOS_DIR when set (a copy someone edits
154
+ * and keeps across upgrades), else inside the package when installed from npm
155
+ * (copied at pack time), else the repository root in a checkout.
156
+ */
157
+ export function demosDir(): string | null {
158
+ const override = process.env.PICO_ENGINE_DEMOS_DIR;
159
+ const candidates = [
160
+ ...(override && override.trim() ? [path.resolve(override.trim())] : []),
161
+ path.resolve(__dirname, "..", "demos"),
162
+ path.resolve(__dirname, "..", "..", "..", "demos"),
163
+ ];
164
+ for (const dir of candidates) {
165
+ if (fs.existsSync(dir) && fs.statSync(dir).isDirectory()) return dir;
166
+ }
167
+ return null;
168
+ }
169
+
170
+ function fileWithin(root: string, relativePath: string): string | null {
171
+ const candidate = path.resolve(root, relativePath.split("/").join(path.sep));
160
172
  if (
161
173
  candidate.startsWith(root + path.sep) &&
162
- fs.existsSync(candidate) &&
163
- candidate.endsWith(".krl")
174
+ candidate.endsWith(".krl") &&
175
+ fs.existsSync(candidate)
164
176
  ) {
165
177
  return candidate;
166
178
  }
167
179
  return null;
168
180
  }
169
181
 
182
+ /** `relativePath` is under krl/, or under demos/ when it starts with `demos/`. */
183
+ export function resolveEngineKrlFile(relativePath: string): string | null {
184
+ if (relativePath.startsWith("demos/")) {
185
+ const root = demosDir();
186
+ return root ? fileWithin(root, relativePath.slice("demos/".length)) : null;
187
+ }
188
+ return fileWithin(bundledKrlDir(), relativePath);
189
+ }
190
+
191
+ export interface TryItFile {
192
+ rid: string;
193
+ file: string;
194
+ url: string;
195
+ /** Absolute path on the engine's machine, so people can edit it and flush. */
196
+ path: string;
197
+ }
198
+
199
+ export interface TryItDemo {
200
+ rid: string;
201
+ name?: string;
202
+ description?: string;
203
+ /** Folder under demos/, which is also the cookbook page's folder. */
204
+ folder: string;
205
+ url: string;
206
+ path: string;
207
+ docs: string;
208
+ /** demos/<folder>/try-it.md: what to look for and try once the demo runs. */
209
+ notes?: string;
210
+ /** Every .krl in the demo's folder; a running demo's installed rulesets are among them. */
211
+ files: TryItFile[];
212
+ }
213
+
214
+ function readNotes(root: string, folder: string): string | undefined {
215
+ try {
216
+ return fs.readFileSync(path.join(root, folder, "try-it.md"), "utf8");
217
+ } catch {
218
+ return undefined;
219
+ }
220
+ }
221
+
222
+ /** Folder names from demos/try-it-order.json (a JSON array), or none if it is missing or invalid. */
223
+ function tryItOrder(root: string): string[] {
224
+ try {
225
+ const order = JSON.parse(fs.readFileSync(path.join(root, "try-it-order.json"), "utf8"));
226
+ return Array.isArray(order) ? order.filter((f) => typeof f === "string") : [];
227
+ } catch {
228
+ return [];
229
+ }
230
+ }
231
+
232
+ /**
233
+ * Every demos/<folder>/<rid>.bootstrap.krl, for the developer UI's "Try It!" tab.
234
+ * Folders named in demos/try-it-order.json come first, in that order; the rest follow by path.
235
+ */
236
+ export function listTryItDemos(baseUrl: string): TryItDemo[] {
237
+ const root = demosDir();
238
+ if (!root) return [];
239
+ const files: string[] = [];
240
+ for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
241
+ if (!entry.isDirectory() || entry.name.startsWith(".")) continue;
242
+ walkKrlFiles(path.join(root, entry.name), root, files);
243
+ }
244
+ const base = baseUrl.replace(/\/$/, "");
245
+ const fileInfo = (rel: string): TryItFile => ({
246
+ rid: readKrlMeta(path.join(root, rel)).rid,
247
+ file: path.basename(rel),
248
+ url: `${base}/krl/demos/${rel}`,
249
+ path: path.join(root, rel),
250
+ });
251
+ const order = tryItOrder(root);
252
+ const rank = (rel: string) => {
253
+ const i = order.indexOf(rel.split("/")[0]);
254
+ return i < 0 ? order.length : i;
255
+ };
256
+ return files
257
+ .filter((rel) => rel.endsWith(".bootstrap.krl"))
258
+ .sort((a, b) => rank(a) - rank(b) || (a < b ? -1 : a > b ? 1 : 0))
259
+ .map((rel) => {
260
+ const meta = readKrlMeta(path.join(root, rel));
261
+ const folder = rel.split("/")[0];
262
+ return {
263
+ rid: meta.rid,
264
+ name: meta.name,
265
+ description: meta.description,
266
+ folder,
267
+ url: `${base}/krl/demos/${rel}`,
268
+ path: path.join(root, rel),
269
+ docs: `https://docs.picolabs.io/#/cookbook/${folder}/`,
270
+ notes: readNotes(root, folder),
271
+ files: files.filter((f) => f.split("/")[0] === folder).sort().map(fileInfo),
272
+ };
273
+ });
274
+ }
275
+
170
276
  export function resolveBundledKrlUrl(url: string): string {
171
277
  const relativePath = engineKrlRelativeFromUrl(url);
172
278
  if (!relativePath) {
package/src/cli.ts CHANGED
@@ -76,11 +76,13 @@ Environment (optional; Docker/CI when not set in config file):
76
76
  PICO_ENGINE_BASE_URL - Public URL (WebAuthn, did:webvh)
77
77
  PICO_ENGINE_RP_ID / PICO_ENGINE_ORIGIN - WebAuthn (or use webauthn block in config file)
78
78
  PICO_ENGINE_ALLOW_SELF_SIGNUP - "true"/"1" or "false"/"0"
79
- PICO_ENGINE_ALLOW_LOCALHOST_C - "0" disables localhost /c/* bypass (see config allowLocalhostChannelBypass)
79
+ PICO_ENGINE_ALLOW_LOCALHOST_C - "1"/"true" allows direct loopback /c/* without a passkey (default off; config allowLocalhostChannelBypass). Dev MCP uses $PICO_ENGINE_HOME/internal-token
80
80
  PICO_ENGINE_WILDCARD_SKY_REQUIRE_BEARER - "1" enables wildcard /sky/* bearer requirement
81
81
  PICO_ENGINE_LOG_FILE - Log path, or stdout/- / 0 for console-only
82
82
  PICO_ENGINE_LOG_MIRROR - "true"/"1" or "false"/"0" (mirror JSON lines to \$PICO_ENGINE_HOME/pico-engine.log when stdout-only; default on)
83
83
  PICO_ENGINE_LOG_RING - how many recent transactions per pico the Logging tab keeps in memory (default 200; cleared on restart)
84
+ PICO_ENGINE_SHOW_TRYIT_MENU - off, root_only (default), or all: where the Developer UI shows the Try It! tab (config: show_tryit_menu)
85
+ PICO_ENGINE_DEMOS_DIR - directory to serve as demos/ (/krl/demos/) instead of the shipped copy
84
86
  `);
85
87
  process.exit(0);
86
88
  }
@@ -123,7 +125,11 @@ startEngine(env)
123
125
  .then((engine) => {
124
126
  installGracefulShutdown(engine);
125
127
  })
126
- .catch((err) => {
128
+ .catch((err: NodeJS.ErrnoException & { port?: number }) => {
129
+ if (err && err.code === "EADDRINUSE") {
130
+ console.error(`Port ${err.port} is already in use.`);
131
+ process.exit(1);
132
+ }
127
133
  console.error("Failed to start engine.");
128
134
  console.error(err);
129
135
  process.exit(1);
@@ -26,7 +26,10 @@ export interface EngineSettings {
26
26
  rpName?: string;
27
27
  origin?: string;
28
28
  allowSelfSignup: boolean;
29
- /** When true, localhost may call /c/* without passkey (dev MCP, ctx HTTP loops). */
29
+ /**
30
+ * When true, a direct loopback socket may call `/c/*` without a passkey or
31
+ * the internal token. Default false. Proxy headers never count as local.
32
+ */
30
33
  allowLocalhostChannelBypass: boolean;
31
34
  wildcardSkyRequireBearer: boolean;
32
35
  logToStdout: boolean;
@@ -38,6 +41,8 @@ export interface EngineSettings {
38
41
  * Set false on EFS/Fargate to avoid mirror file churn (`PICO_ENGINE_LOG_MIRROR=0`).
39
42
  */
40
43
  logMirror: boolean;
44
+ /** Where the developer UI shows the Try It! tab: on no pico, the root pico only, or every pico. */
45
+ showTryItMenu: ShowTryItMenu;
41
46
  /** Max channel policy for root picos when none stored on the pico (1.8). */
42
47
  defaultRootPolicyCeiling?: PolicyCeiling;
43
48
  /** Deny rules applied on every ECI before per-channel policy (1.8). */
@@ -45,6 +50,20 @@ export interface EngineSettings {
45
50
  globalQueryDeny?: QueryPolicyRule[];
46
51
  }
47
52
 
53
+ export type ShowTryItMenu = "off" | "root_only" | "all";
54
+
55
+ const SHOW_TRY_IT_MENU_VALUES: ShowTryItMenu[] = ["off", "root_only", "all"];
56
+
57
+ function parseShowTryItMenu(val: unknown, source: string): ShowTryItMenu | undefined {
58
+ if (val === undefined) return undefined;
59
+ if (typeof val === "string" && (SHOW_TRY_IT_MENU_VALUES as string[]).includes(val)) {
60
+ return val as ShowTryItMenu;
61
+ }
62
+ throw new Error(
63
+ `${source} must be one of ${SHOW_TRY_IT_MENU_VALUES.join(", ")} (got ${JSON.stringify(val)})`,
64
+ );
65
+ }
66
+
48
67
  export interface EngineSettingsOverrides {
49
68
  home?: string;
50
69
  port?: number;
@@ -59,6 +78,7 @@ export interface EngineSettingsOverrides {
59
78
  logToStdout?: boolean;
60
79
  logFile?: string;
61
80
  logMirror?: boolean;
81
+ showTryItMenu?: ShowTryItMenu;
62
82
  defaultRootPolicyCeiling?: PolicyCeiling;
63
83
  globalEventDeny?: EventPolicyRule[];
64
84
  globalQueryDeny?: QueryPolicyRule[];
@@ -83,10 +103,11 @@ export function defaultEngineSettings(): EngineSettings {
83
103
  port: 3000,
84
104
  baseUrl: "http://localhost:3000",
85
105
  allowSelfSignup: false,
86
- allowLocalhostChannelBypass: true,
106
+ allowLocalhostChannelBypass: false,
87
107
  wildcardSkyRequireBearer: false,
88
108
  logToStdout: false,
89
109
  logMirror: true,
110
+ showTryItMenu: "root_only",
90
111
  };
91
112
  }
92
113
 
@@ -201,6 +222,8 @@ function parseConfigFile(raw: string): Partial<EngineSettings> {
201
222
  out.logFile = path.resolve(expandHome(o.logFile));
202
223
  }
203
224
  }
225
+ const showTryItMenu = parseShowTryItMenu(o.show_tryit_menu, "show_tryit_menu");
226
+ if (showTryItMenu) out.showTryItMenu = showTryItMenu;
204
227
  const rootCeiling = parsePolicyCeilingFromJson(
205
228
  o.defaultRootPolicyCeiling,
206
229
  "defaultRootPolicyCeiling",
@@ -292,6 +315,11 @@ export function settingsFromEnv(): Partial<EngineSettings> {
292
315
  if (logMirror !== undefined) {
293
316
  out.logMirror = logMirror;
294
317
  }
318
+ const showTryItMenu = parseShowTryItMenu(
319
+ process.env.PICO_ENGINE_SHOW_TRYIT_MENU || undefined,
320
+ "PICO_ENGINE_SHOW_TRYIT_MENU",
321
+ );
322
+ if (showTryItMenu) out.showTryItMenu = showTryItMenu;
295
323
 
296
324
  return out;
297
325
  }
@@ -343,6 +371,9 @@ export function resolveEngineSettings(
343
371
  if (programmatic.logMirror !== undefined) {
344
372
  fromProgrammatic.logMirror = programmatic.logMirror;
345
373
  }
374
+ if (programmatic.showTryItMenu !== undefined) {
375
+ fromProgrammatic.showTryItMenu = programmatic.showTryItMenu;
376
+ }
346
377
  if (programmatic.defaultRootPolicyCeiling !== undefined) {
347
378
  fromProgrammatic.defaultRootPolicyCeiling =
348
379
  programmatic.defaultRootPolicyCeiling;
@@ -165,7 +165,12 @@ export async function importPortableSubtree(
165
165
  parent,
166
166
  bootstrapName,
167
167
  deps.rsRegistry,
168
- createOpts
168
+ createOpts,
169
+ async (picoId, ctx) => {
170
+ if (deps.getBaseUrl()) {
171
+ await deps.identity.ensureWebvhDid(picoId, { isRoot: ctx.isRoot });
172
+ }
173
+ }
169
174
  );
170
175
  const importResult = await importIntoExistingChild(
171
176
  services,