@centralu/win32-x64 0.1.0-beta.9

package/Centralu/resources/host/app-template/server.mjs

@@ -0,0 +1,71 @@
+// {{APP_NAME}} — this app's MCP server. Centralu starts it (`node server.mjs`, stdio) when it is first
+// needed and restarts it after the builder's turn when this folder changed.
+// Edit this file and ui/index.html freely. Never edit runtime/ (generated by Centralu).
+// Read AGENTS.md for the rules.
+import { McpServer, serveStdio, z, centralu } from './runtime/centralu-app-runtime.mjs'
+
+const UI = 'ui://{{APP_ID}}/index.html'
+
+// State lives in the server, and is saved in the app's data folder (outside this folder, so it is
+// never committed). The screen only shows it. It survives restarts because it is read back here.
+const state = await centralu.readJson('state.json', { count: 0 })
+const save = () => centralu.writeJson('state.json', state)
+const current = () => ({ content: [{ type: 'text', text: `count = ${state.count}` }], structuredContent: { count: state.count } })
+
+serveStdio(() => {
+  const server = new McpServer({ name: '{{APP_ID}}', version: '0.1.0' }, { capabilities: { tools: {}, resources: {} } })
+
+  centralu.uiResource(server, 'main-screen', UI, new URL('./ui/index.html', import.meta.url))
+
+  // The home tool (centralu.app.json "home"): Centralu calls it to open the app's screen. It only reads,
+  // so it says readOnlyHint: true — the screen calls it on every refresh, and a read must not trigger one.
+  centralu.tool(
+    server,
+    'show',
+    {
+      title: 'Show the count',
+      description: 'Open the screen and return the current count.',
+      inputSchema: z.object({}),
+      annotations: { readOnlyHint: true },
+      _meta: { ui: { resourceUri: UI } },
+    },
+    async () => current(),
+  )
+
+  // Changes state, so it says readOnlyHint: false. Agents and the screen can both call it.
+  centralu.tool(
+    server,
+    'increment',
+    {
+      title: 'Increment',
+      description: 'Add to the count (default 1) and return the new count.',
+      inputSchema: z.object({ by: z.number().int().default(1).describe('How much to add') }),
+      annotations: { readOnlyHint: false },
+    },
+    async ({ by }) => {
+      state.count += by
+      await save()
+      return current()
+    },
+  )
+
+  // Only the screen may call this one (visibility: ['app']); agents never see it.
+  centralu.tool(
+    server,
+    'reset',
+    {
+      title: 'Reset',
+      description: 'Set the count back to 0.',
+      inputSchema: z.object({}),
+      annotations: { readOnlyHint: false, destructiveHint: true },
+      _meta: { ui: { visibility: ['app'] } },
+    },
+    async () => {
+      state.count = 0
+      await save()
+      return current()
+    },
+  )
+
+  return server
+})

package/Centralu/resources/host/app-template/ui/index.html

@@ -0,0 +1,74 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>{{APP_NAME}}</title>
+    <style>
+      body {
+        margin: 16px;
+        font: 14px var(--font-sans, system-ui, sans-serif);
+        color: var(--color-text-primary, #e8e8e8);
+        background: transparent;
+      }
+      .count { font-size: 32px; font-variant-numeric: tabular-nums; margin-bottom: 12px; }
+      button {
+        font: inherit;
+        color: inherit;
+        background: var(--color-background-tertiary, #2a2a2a);
+        border: 1px solid var(--color-border-primary, #3a3a3a);
+        border-radius: 6px;
+        padding: 4px 12px;
+        cursor: pointer;
+      }
+      .error { color: #e06c6c; margin-top: 8px; white-space: pre-wrap; }
+    </style>
+  </head>
+  <body>
+    <div class="count" id="count">…</div>
+    <button id="increment">+1</button>
+    <button id="reset">Reset</button>
+    <div class="error" id="error"></div>
+
+    <!-- Centralu replaces this tag with the MCP App bridge (runtime/mcp-app.js). Keep it. -->
+    <script src="centralu:mcp-app.js"></script>
+    <script>
+      // The screen holds no state of its own: it shows what the server says, and asks again when
+      // Centralu says the app's state changed (someone — the person or an agent — called a tool).
+      const app = new McpApp.App({ name: '{{APP_ID}}', version: '0.1.0' })
+      const $ = (id) => document.getElementById(id)
+
+      function show(result) {
+        $('error').textContent = result?.isError ? (result.content ?? []).map((c) => c.text ?? '').join('\n') : ''
+        const count = result?.structuredContent?.count
+        if (count !== undefined) $('count').textContent = String(count)
+      }
+      async function call(name, args = {}) {
+        try {
+          show(await app.callServerTool({ name, arguments: args }))
+        } catch (e) {
+          $('error').textContent = String(e?.message ?? e)
+        }
+      }
+      const reread = () => call('show')
+
+      // Match the host's theme (MCP Apps host context). The page's colors, and the backdrop a browser
+      // paints behind a frame whose color scheme differs from its host's, then agree with Centralu's.
+      const theme = (ctx) => {
+        if (ctx?.theme) document.documentElement.style.colorScheme = ctx.theme
+      }
+      app.onhostcontextchanged = theme
+
+      app.ontoolresult = (params) => show(params)
+      // Centralu's own notification (not part of the MCP Apps standard): the app's state changed.
+      app.fallbackNotificationHandler = async (n) => {
+        if (n.method === 'centralu/notifications/changed') await reread()
+      }
+      $('increment').onclick = () => call('increment', { by: 1 })
+      $('reset').onclick = () => call('reset')
+      app.connect().then(() => {
+        theme(app.getHostContext())
+        return reread()
+      })
+    </script>
+  </body>
+</html>

package/Centralu/resources/host/bundle-info.json

@@ -0,0 +1,8 @@
+{
+  "commit": "cf8a5ad",
+  "protocolVersion": 1,
+  "builtAt": "2026-10-04T17:50:36.523Z",
+  "runtime": "system-node",
+  "platform": "win32",
+  "arch": "x64"
+}