@portel/photon 1.14.0 → 1.16.1

package/dist/photons/ui/builder-compass.photon.html

@@ -0,0 +1,380 @@
+<style>
+  :root {
+    --canvas: #f4eddf;
+    --ink: #201d18;
+    --muted: #6c665d;
+    --olive: #38452f;
+    --sage: #6f8d62;
+    --amber: #ba7c33;
+    --rust: #9d5a42;
+    --card: rgba(255, 251, 244, 0.92);
+    --line: rgba(68, 53, 36, 0.12);
+    --shadow: 0 18px 48px rgba(54, 38, 17, 0.1);
+    --radius-xl: 28px;
+    --radius-lg: 20px;
+    --radius-md: 16px;
+  }
+
+  body {
+    background:
+      radial-gradient(circle at top left, rgba(111, 141, 98, 0.14), transparent 24%),
+      radial-gradient(circle at top right, rgba(186, 124, 51, 0.12), transparent 20%),
+      linear-gradient(180deg, #f8f1e7 0%, var(--canvas) 44%, #ecdfcb 100%);
+    color: var(--ink);
+    font-family: 'Inter', system-ui, sans-serif;
+    padding: 24px;
+  }
+
+  .shell {
+    display: grid;
+    gap: 18px;
+  }
+
+  .hero,
+  .grid {
+    display: grid;
+    gap: 18px;
+  }
+
+  .hero {
+    grid-template-columns: minmax(0, 1.35fr) minmax(320px, 0.82fr);
+  }
+
+  .grid {
+    grid-template-columns: minmax(320px, 0.9fr) minmax(400px, 1.1fr) minmax(320px, 0.92fr);
+    align-items: start;
+  }
+
+  .column {
+    display: grid;
+    gap: 18px;
+  }
+
+  .panel {
+    background: linear-gradient(180deg, rgba(255, 252, 247, 0.94), rgba(249, 241, 229, 0.96));
+    border: 1px solid var(--line);
+    border-radius: var(--radius-xl);
+    box-shadow: var(--shadow);
+    padding: 22px;
+  }
+
+  .hero-main {
+    padding: 28px;
+  }
+
+  .eyebrow,
+  .pill {
+    display: inline-flex;
+    align-items: center;
+    gap: 8px;
+    border-radius: 999px;
+    font:
+      500 12px/1 ui-monospace,
+      SFMono-Regular,
+      Menlo,
+      monospace;
+    letter-spacing: 0.06em;
+    text-transform: uppercase;
+  }
+
+  .eyebrow {
+    color: var(--olive);
+    padding: 7px 12px;
+    border: 1px solid rgba(56, 69, 47, 0.14);
+    background: rgba(56, 69, 47, 0.08);
+  }
+
+  .hero-main h1 {
+    margin-top: 14px;
+    font-size: clamp(2.1rem, 5vw, 4rem);
+    line-height: 0.96;
+    font-weight: 800;
+    max-width: 11ch;
+  }
+
+  .lede,
+  .copy {
+    color: var(--muted);
+    line-height: 1.6;
+  }
+
+  .lede {
+    margin-top: 16px;
+    max-width: 64ch;
+    font-size: 1rem;
+  }
+
+  .metrics {
+    margin-top: 24px;
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: 12px;
+  }
+
+  .metric {
+    background: rgba(255, 255, 255, 0.58);
+    border: 1px solid rgba(68, 53, 36, 0.1);
+    border-radius: 18px;
+    padding: 16px;
+  }
+
+  .metric label {
+    display: block;
+    color: var(--muted);
+    font-size: 12px;
+    text-transform: uppercase;
+    letter-spacing: 0.08em;
+    margin-bottom: 8px;
+  }
+
+  .metric [data-method] {
+    min-height: 0;
+  }
+
+  .stack {
+    display: grid;
+    gap: 12px;
+  }
+
+  .toolbar {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 10px;
+  }
+
+  .toolbar button,
+  button[data-method] {
+    border-radius: 16px;
+    padding: 12px 16px;
+    font-weight: 600;
+  }
+
+  .primary {
+    background: linear-gradient(135deg, #38452f, #526647);
+    color: #f7f3ec;
+  }
+
+  .secondary {
+    background: rgba(255, 255, 255, 0.62);
+    color: var(--ink);
+    border: 1px solid rgba(68, 53, 36, 0.12);
+  }
+
+  .callout {
+    padding: 16px;
+    border-radius: 18px;
+    background: rgba(111, 141, 98, 0.08);
+    border: 1px solid rgba(111, 141, 98, 0.14);
+    color: var(--muted);
+  }
+
+  .warn {
+    background: rgba(157, 90, 66, 0.08);
+    border-color: rgba(157, 90, 66, 0.14);
+  }
+
+  .section-head {
+    display: flex;
+    justify-content: space-between;
+    gap: 12px;
+    align-items: flex-start;
+    margin-bottom: 14px;
+  }
+
+  .section-head h2 {
+    margin: 0;
+    font-size: 1.1rem;
+  }
+
+  .section-head p {
+    margin-top: 8px;
+    color: var(--muted);
+    line-height: 1.55;
+  }
+
+  .pill {
+    color: var(--amber);
+    padding: 6px 10px;
+    background: rgba(186, 124, 51, 0.1);
+    border: 1px solid rgba(186, 124, 51, 0.14);
+  }
+
+  .embed > [data-method] {
+    min-height: 120px;
+  }
+
+  .embed.compact > [data-method] {
+    min-height: 64px;
+  }
+
+  .report {
+    border-radius: 18px;
+    background: rgba(255, 255, 255, 0.56);
+    border: 1px solid rgba(68, 53, 36, 0.1);
+    padding: 16px;
+  }
+
+  .report [data-method] {
+    min-height: 180px;
+  }
+
+  @media (max-width: 1180px) {
+    .hero,
+    .grid {
+      grid-template-columns: 1fr;
+    }
+  }
+</style>
+
+<div class="shell">
+  <section class="hero">
+    <div class="panel hero-main">
+      <div class="eyebrow">Builder Compass / Photon</div>
+      <h1>Turn your builder profile into a money map.</h1>
+      <p class="lede">
+        Builder Compass stores your profile, classifies your AI-native builder archetype, and
+        researches how people like you are making money on the open web. TinyFish is used when you
+        explicitly rebuild, not every time you open the dashboard.
+      </p>
+
+      <div class="metrics">
+        <div class="metric">
+          <label>Fit overview</label>
+          <div data-method="fitOverview"></div>
+        </div>
+        <div class="metric">
+          <label>Money paths</label>
+          <div data-method="moneyPaths"></div>
+        </div>
+        <div class="metric">
+          <label>Builder report</label>
+          <div data-method="report"></div>
+        </div>
+      </div>
+    </div>
+
+    <aside class="panel stack">
+      <div>
+        <h2 style="margin: 0">How it works</h2>
+        <p class="copy" style="margin-top: 10px">
+          Save once, inspect anytime. When your profile changes, update the saved input and rebuild
+          the research deliberately.
+        </p>
+      </div>
+      <div class="callout">
+        Bring your own TinyFish API key if you want live market research and open-web evidence.
+        Without it, Builder Compass still gives a heuristic builder model.
+      </div>
+      <div class="toolbar">
+        <button class="primary" data-method="runCompass" data-target="#report-panel">
+          Run full compass
+        </button>
+        <button class="secondary" data-method="analyzeIdentity" data-target="#identity-panel">
+          Refresh identity
+        </button>
+        <button class="secondary" data-method="researchMarket" data-target="#market-panel">
+          Refresh market
+        </button>
+      </div>
+    </aside>
+  </section>
+
+  <section class="grid">
+    <div class="column">
+      <div class="panel">
+        <div class="section-head">
+          <div>
+            <h2>Profile intake</h2>
+            <p>
+              Minimal input. Persistent state. This form updates the stored profile and clears stale
+              research when your self-model changes.
+            </p>
+          </div>
+          <div class="pill">Persistent</div>
+        </div>
+        <div class="embed">
+          <div data-method="saveProfile"></div>
+        </div>
+      </div>
+
+      <div class="panel">
+        <div class="section-head">
+          <div>
+            <h2>Narrative report</h2>
+            <p>The reusable guide you can open later without paying the TinyFish cost again.</p>
+          </div>
+        </div>
+        <div class="report" id="report-panel">
+          <div data-method="report"></div>
+        </div>
+      </div>
+    </div>
+
+    <div class="column">
+      <div class="panel" id="identity-panel">
+        <div class="section-head">
+          <div>
+            <h2>Identity analysis</h2>
+            <p>
+              Builder archetype, strengths, work fit, and risks. Cached until you intentionally
+              rebuild.
+            </p>
+          </div>
+          <div class="pill">Profile model</div>
+        </div>
+        <div class="embed compact">
+          <div data-method="strengthMatrix"></div>
+        </div>
+      </div>
+
+      <div class="panel">
+        <div class="section-head">
+          <div>
+            <h2>Fit dials</h2>
+            <p>
+              Quick read on AI-native leverage, founder energy, execution reliability, and risk
+              load.
+            </p>
+          </div>
+        </div>
+        <div class="embed compact">
+          <div data-method="fitOverview"></div>
+        </div>
+      </div>
+    </div>
+
+    <div class="column">
+      <div class="panel" id="market-panel">
+        <div class="section-head">
+          <div>
+            <h2>Money paths</h2>
+            <p>Research-backed routes ranked by fit, speed to money, demand, and sustainability.</p>
+          </div>
+          <div class="pill">Market map</div>
+        </div>
+        <div class="embed compact">
+          <div data-method="moneyPaths"></div>
+        </div>
+      </div>
+
+      <div class="panel">
+        <div class="section-head">
+          <div>
+            <h2>Usage model</h2>
+            <p>Exactly the behavior we want for repeat use.</p>
+          </div>
+        </div>
+        <div class="callout">
+          Open the same profile any time to get the stored analysis back immediately.
+        </div>
+        <div class="callout" style="margin-top: 12px">
+          Update the profile only when you’ve actually changed, then rebuild identity and market
+          research.
+        </div>
+        <div class="callout warn" style="margin-top: 12px">
+          TinyFish is a rebuild engine here, not a page-refresh tax.
+        </div>
+      </div>
+    </div>
+  </section>
+</div>

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -18,7 +18,7 @@ import { generateExecutionId } from '@portel/photon-core';
 import { createSDKMCPClientFactory } from '@portel/photon-core';
 import { PHOTON_VERSION } from './version.js';
 import { createLogger } from './shared/logger.js';
-import { getErrorMessage } from './shared/error-handler.js';
+import { getErrorMessage, formatToolError } from './shared/error-handler.js';
 import { validateOrThrow, assertString, notEmpty, inRange, oneOf, hasExtension, } from './shared/validation.js';
 import { generatePlaygroundHTML } from './auto-ui/playground-html.js';
 import { subscribeChannel, pingDaemon, publishToChannel } from './daemon/client.js';
@@ -1016,6 +1016,15 @@ export class PhotonServer {
         });
         const isStateful = result && typeof result === 'object' && result._stateful === true;
         const actualResult = isStateful ? result.result : result;
+        // _meta format transformation: if the result was transformed by _meta.format,
+        // return the pre-formatted text with its MIME type directly
+        if (actualResult && typeof actualResult === 'object' && actualResult._metaFormatted === true) {
+            const content = { type: 'text', text: actualResult.text };
+            if (actualResult.mimeType) {
+                content.annotations = { mimeType: actualResult.mimeType };
+            }
+            return { content: [content], isError: false };
+        }
         // Build content with optional annotations
         const content = {
             type: 'text',
@@ -1116,7 +1125,10 @@ export class PhotonServer {
                     description: ui.linkedTool
                         ? `UI template for ${ui.linkedTool} tool`
                         : `UI template: ${ui.id}`,
-                    mimeType: ui.mimeType || this.getUIMimeType(),
+                    // Always use MCP Apps mime type for UI resources — photon-core's
+                    // getMimeTypeFromPath returns plain text/html which causes Claude
+                    // Desktop to skip rendering the app UI
+                    mimeType: this.getUIMimeType(),
                 });
             }
             for (const prompt of this.mcp.assets.prompts) {
@@ -1177,7 +1189,10 @@ export class PhotonServer {
         if (!this.mcp) {
             throw new Error('MCP not loaded');
         }
-        const { uri } = request.params;
+        const { uri: rawUri } = request.params;
+        const uri = typeof rawUri === 'string'
+            ? rawUri.replace(/^ui:\/\/\/([^/]+)\/(.+)$/, 'ui://$1/$2')
+            : rawUri;
         const uiMatch = uri.match(/^ui:\/\/([^/]+)\/(.+)$/);
         if (uiMatch) {
             const [, uiPhotonName, assetId] = uiMatch;
@@ -1483,66 +1498,17 @@ export class PhotonServer {
      * Provides structured, actionable error messages
      */
     formatError(error, toolName, args) {
-        // Determine error type
-        let errorType = 'runtime_error';
-        let errorMessage = getErrorMessage(error) || String(error);
-        let suggestion = '';
-        // Photon authors can attach userMessage and hint to errors for friendly display:
-        //   throw Object.assign(new Error('internal'), { userMessage: 'friendly msg', hint: 'try this' })
-        const userMessage = error && typeof error === 'object' && 'userMessage' in error ? String(error.userMessage) : '';
-        const userHint = error && typeof error === 'object' && 'hint' in error ? String(error.hint) : '';
-        // Use userMessage as the display message if provided
-        if (userMessage) {
-            errorMessage = userMessage;
-        }
-        // Use author-provided hint over auto-generated suggestion
-        if (userHint) {
-            suggestion = userHint;
-        }
-        else if (errorMessage.includes('not a function') || errorMessage.includes('undefined')) {
-            // Categorize common errors and provide suggestions
-            errorType = 'implementation_error';
-            suggestion =
-                'The tool implementation may have an issue. Check that all methods are properly defined.';
-        }
-        else if (errorMessage.includes('required') || errorMessage.includes('validation')) {
-            errorType = 'validation_error';
-            suggestion = 'Check the parameters provided match the tool schema requirements.';
-        }
-        else if (errorMessage.includes('timeout') || errorMessage.includes('ETIMEDOUT')) {
-            errorType = 'timeout_error';
-            suggestion = 'The operation took too long. Try again or check external service availability.';
-        }
-        else if (errorMessage.includes('ECONNREFUSED') || errorMessage.includes('network')) {
-            errorType = 'network_error';
-            suggestion =
-                'Cannot connect to external service. Check network connection and service availability.';
-        }
-        else if (errorMessage.includes('permission') || errorMessage.includes('EACCES')) {
-            errorType = 'permission_error';
-            suggestion = 'Permission denied. Check file/resource access permissions.';
-        }
-        else if (errorMessage.includes('not found') || errorMessage.includes('ENOENT')) {
-            errorType = 'not_found_error';
-            suggestion = 'Resource not found. Check that the file or resource exists.';
-        }
-        // Build structured error message for AI
-        let structuredMessage = `❌ Tool Error: ${toolName}\n\n`;
-        structuredMessage += `Error Type: ${errorType}\n`;
-        structuredMessage += `Message: ${errorMessage}\n`;
-        if (suggestion) {
-            structuredMessage += `\nSuggestion: ${suggestion}\n`;
-        }
-        // Include parameters for debugging (in dev mode)
+        const { text, errorType: _errorType } = formatToolError(toolName, error);
+        // Add dev-mode extras
+        let devExtras = '';
         if (this.options.devMode && Object.keys(args || {}).length > 0) {
-            structuredMessage += `\nParameters provided:\n${JSON.stringify(args, null, 2)}\n`;
+            devExtras += `\nParameters provided:\n${JSON.stringify(args, null, 2)}\n`;
         }
-        // Include stack trace in dev mode
         if (this.options.devMode && error.stack) {
-            structuredMessage += `\nStack trace:\n${error.stack}\n`;
+            devExtras += `\nStack trace:\n${error.stack}\n`;
         }
         // Log to stderr for debugging
-        this.log('error', `[Photon Error] ${toolName}: ${errorMessage}`);
+        this.log('error', `[Photon Error] ${toolName}: ${getErrorMessage(error)}`);
         if (this.options.devMode && error.stack) {
             this.log('debug', error.stack);
         }
@@ -1550,7 +1516,7 @@ export class PhotonServer {
             content: [
                 {
                     type: 'text',
-                    text: structuredMessage,
+                    text: text + devExtras,
                 },
             ],
             isError: true,
@@ -2597,6 +2563,14 @@ export class PhotonServer {
             }
             content = await fs.readFile(ui.resolvedPath, 'utf-8');
         }
+        // Wrap .photon.html fragments in a full HTML document.
+        // These files contain only <style>, markup, and <script> — no <!doctype> or <html>.
+        // Beam wraps them automatically, but MCP clients (Claude Desktop) need a complete document.
+        const isFragment = !content.trimStart().toLowerCase().startsWith('<!doctype') &&
+            !content.trimStart().toLowerCase().startsWith('<html');
+        if (isFragment) {
+            content = `<!doctype html>\n<html lang="en">\n<head>\n<meta charset="UTF-8">\n<meta name="viewport" content="width=device-width, initial-scale=1.0">\n</head>\n<body>\n${content}\n</body>\n</html>`;
+        }
         // Inject MCP Apps bridge script for Claude Desktop compatibility
         const bridgeScript = this.generateMcpAppsBridge();
         content = content.replace('<head>', `<head>\n${bridgeScript}`);