@centralu/darwin-arm64 0.1.0-beta.10 → 0.1.0-beta.12

package/Centralu.app/Contents/Resources/content/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.app/Contents/Resources/content/host/app-template/ui/index.html

@@ -0,0 +1,145 @@
+<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <!-- Until Centralu says which theme shows, follow the system's (Centralu's window follows it too). -->
+    <meta name="color-scheme" content="light dark" />
+    <title>{{APP_NAME}}</title>
+    <style>
+      /*
+       * Colours, type and shape come from Centralu's theme: it sends MCP Apps style variables
+       * (applied by the script below), so the screen follows the person's theme, light or dark,
+       * and their font, line height and text size.
+       *
+       * Keep the fallbacks in this one block: they are Centralu's dark defaults, for the moment
+       * before the theme arrives. Every rule below reads these names, never a colour or size of
+       * its own. Spacing (margins, padding, gaps) has no theme variable and stays literal.
+       */
+      :root {
+        --bg: var(--color-background-secondary, #1d1d1d);
+        --bg-hover: var(--color-background-tertiary, #353535);
+        --ink: var(--color-text-primary, #e9e9e9);
+        --danger: var(--color-text-danger, #ffa198);
+        --edge: var(--color-border-secondary, #353535);
+        --ring: var(--color-ring-primary, #909090);
+        --sans: var(--font-sans, -apple-system, BlinkMacSystemFont, 'Apple SD Gothic Neo', system-ui, sans-serif);
+        --text: var(--font-text-md-size, 13px);
+        --leading: var(--font-text-md-line-height, 1.65);
+        --display: var(--font-heading-2xl-size, 28px);
+        --leading-tight: var(--font-heading-2xl-line-height, 1.3);
+        --radius: var(--border-radius-md, 4px);
+        --border: var(--border-width-regular, 1px);
+        /* Centralu's scrollbar (the block at the end) */
+        --sb-size: var(--centralu-scrollbar-size, 10px);
+        --sb-inset: var(--centralu-scrollbar-inset, 3px);
+        --sb-radius: var(--centralu-scrollbar-radius, 999px);
+        --sb-track: var(--centralu-scrollbar-track, transparent);
+        --sb-thumb: var(--centralu-scrollbar-thumb, #292929);
+        --sb-thumb-hover: var(--centralu-scrollbar-thumb-hover, #353535);
+      }
+      body {
+        margin: 16px;
+        font-family: var(--sans);
+        font-size: var(--text);
+        line-height: var(--leading);
+        color: var(--ink);
+        background: transparent;
+      }
+      .count { font-size: var(--display); line-height: var(--leading-tight); font-variant-numeric: tabular-nums; margin-bottom: 12px; }
+      /*
+       * Narrow first (docs/apps.md 6.6): a view may be a grid panel 360px wide or the inline view
+       * under a tool card. Rows wrap instead of overflowing, nothing has a fixed width, and the
+       * layout only spreads out when there is room.
+       */
+      .actions { display: flex; flex-wrap: wrap; gap: 8px; }
+      button {
+        font: inherit;
+        color: inherit;
+        background: var(--bg);
+        border: var(--border) solid var(--edge);
+        border-radius: var(--radius);
+        padding: 4px 12px;
+        cursor: pointer;
+      }
+      button:hover { background: var(--bg-hover); }
+      :focus-visible { outline: var(--border) solid var(--ring); outline-offset: 1px; }
+      .error { color: var(--danger); margin-top: 8px; white-space: pre-wrap; overflow-wrap: anywhere; }
+      @media (max-width: 420px) {
+        body { margin: 12px; }
+      }
+
+      /*
+       * Centralu's scrollbar. Keep this block: it draws scrollbars the way Centralu does, from the
+       * theme's scrollbar variables.
+       */
+      ::-webkit-scrollbar { width: var(--sb-size); height: var(--sb-size); }
+      ::-webkit-scrollbar-track { background: var(--sb-track); }
+      ::-webkit-scrollbar-thumb {
+        background: var(--sb-thumb);
+        border: var(--sb-inset) solid transparent;
+        background-clip: content-box;
+        border-radius: var(--sb-radius);
+      }
+      ::-webkit-scrollbar-thumb:hover { background: var(--sb-thumb-hover); background-clip: content-box; }
+      /* Only where ::-webkit-scrollbar does not exist: elsewhere scrollbar-color would switch it off */
+      @supports not selector(::-webkit-scrollbar) {
+        * { scrollbar-color: var(--sb-thumb) var(--sb-track); scrollbar-width: thin; }
+      }
+    </style>
+  </head>
+  <body>
+    <div class="count" id="count">…</div>
+    <div class="actions">
+      <button id="increment">+1</button>
+      <button id="reset">Reset</button>
+    </div>
+    <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')
+
+      // Centralu's theme (the MCP Apps host context). Keep this: it applies the colour scheme, the
+      // standard style variables, and Centralu's own (the signal colour and the scrollbar). A change
+      // notification carries only what changed, so it reads the whole context the bridge keeps.
+      const applyTheme = () => {
+        const ctx = app.getHostContext() ?? {}
+        const root = document.documentElement
+        if (ctx.theme === 'light' || ctx.theme === 'dark') root.style.colorScheme = ctx.theme
+        const vars = { ...ctx.styles?.variables, ...ctx.centralu?.variables }
+        for (const [name, value] of Object.entries(vars)) if (typeof value === 'string' && value) root.style.setProperty(name, value)
+      }
+      app.onhostcontextchanged = applyTheme
+
+      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(() => {
+        applyTheme()
+        return reread()
+      })
+    </script>
+  </body>
+</html>

package/Centralu.app/Contents/Resources/content/host/bundle-info.json

@@ -0,0 +1,8 @@
+{
+  "commit": "6d18a3e",
+  "protocolVersion": 1,
+  "builtAt": "2026-10-08T05:46:15.346Z",
+  "runtime": "system-node",
+  "platform": "darwin",
+  "arch": "arm64"
+}