npm - ui-chan-mcp - Versions diffs - 0.5.0 - Mend

ui-chan-mcp 0.5.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 (151) hide show

package/.claude-plugin/marketplace.json +13 -0
package/.claude-plugin/plugin.json +6 -0
package/.env.example +13 -0
package/LICENSE +36 -0
package/README.md +214 -0
package/agents/mode.md +47 -0
package/agents/talk.md +23 -0
package/bin/ui-chan-mcp.mjs +11 -0
package/bin/ui-chan-node +35 -0
package/bin/ui-chan.mjs +350 -0
package/context/AFFINITY.md +94 -0
package/context/SOUL.md +79 -0
package/context/VOCABULARY.md +108 -0
package/cue.schema.json +109 -0
package/cues/default.json +21 -0
package/cues/emo_anger.json +14 -0
package/cues/emo_anger_hi.json +19 -0
package/cues/emo_anger_lo.json +16 -0
package/cues/emo_antic.json +18 -0
package/cues/emo_antic_hi.json +16 -0
package/cues/emo_antic_lo.json +6 -0
package/cues/emo_disgust.json +19 -0
package/cues/emo_disgust_hi.json +20 -0
package/cues/emo_disgust_lo.json +6 -0
package/cues/emo_fear.json +19 -0
package/cues/emo_fear_hi.json +19 -0
package/cues/emo_fear_lo.json +19 -0
package/cues/emo_joy.json +17 -0
package/cues/emo_joy_hi.json +15 -0
package/cues/emo_joy_lo.json +13 -0
package/cues/emo_sad.json +15 -0
package/cues/emo_sad_hi.json +18 -0
package/cues/emo_sad_lo.json +14 -0
package/cues/emo_surprise.json +15 -0
package/cues/emo_surprise_hi.json +14 -0
package/cues/emo_surprise_lo.json +11 -0
package/cues/emo_trust.json +16 -0
package/cues/emo_trust_hi.json +20 -0
package/cues/emo_trust_lo.json +6 -0
package/cues/idling_doze_1.json +9 -0
package/cues/idling_doze_2.json +9 -0
package/cues/idling_doze_3.json +9 -0
package/cues/idling_giggle_1.json +9 -0
package/cues/idling_giggle_2.json +9 -0
package/cues/idling_lookaround_1.json +10 -0
package/cues/idling_lookaround_2.json +10 -0
package/cues/idling_lookaround_3.json +10 -0
package/cues/idling_ponder.json +9 -0
package/cues/idling_sigh_1.json +11 -0
package/cues/idling_sigh_2.json +11 -0
package/cues/idling_yawn_1.json +9 -0
package/cues/idling_yawn_2.json +12 -0
package/cues/idling_yawn_3.json +12 -0
package/cues/mix_anger_antic.json +16 -0
package/cues/mix_antic_joy.json +16 -0
package/cues/mix_disgust_anger.json +17 -0
package/cues/mix_fear_surprise.json +18 -0
package/cues/mix_joy_trust.json +19 -0
package/cues/mix_joy_trust_hi.json +18 -0
package/cues/mix_sad_disgust.json +12 -0
package/cues/mix_surprise_sad.json +21 -0
package/cues/mix_surprise_sad_hi.json +14 -0
package/cues/mix_trust_fear.json +18 -0
package/cues/pose_arms_crossed.json +9 -0
package/cues/pose_banzai.json +17 -0
package/cues/pose_smug_arms.json +11 -0
package/cues/pose_smug_hips.json +11 -0
package/cues/pose_think.json +8 -0
package/cues/pose_umbrella.json +9 -0
package/cues/self_guilt.json +20 -0
package/cues/self_pride.json +10 -0
package/cues/self_shame.json +19 -0
package/cues/self_shy.json +16 -0
package/cues/self_shy_hi.json +17 -0
package/cues/sys_address.json +9 -0
package/cues/sys_awkward.json +18 -0
package/cues/sys_beam.json +18 -0
package/cues/sys_blank.json +11 -0
package/cues/sys_care.json +18 -0
package/cues/sys_confused.json +12 -0
package/cues/sys_dazed.json +10 -0
package/cues/sys_dread.json +21 -0
package/cues/sys_fluster.json +20 -0
package/cues/sys_intro.json +15 -0
package/cues/sys_laugh.json +20 -0
package/cues/sys_neutral.json +5 -0
package/cues/sys_present.json +9 -0
package/cues/sys_rain.json +15 -0
package/cues/sys_refuse.json +18 -0
package/cues/sys_relief.json +15 -0
package/cues/sys_sleepy.json +8 -0
package/cues/sys_smirk.json +10 -0
package/cues/sys_stream.json +15 -0
package/cues/sys_success.json +15 -0
package/cues/sys_think.json +9 -0
package/dist/app/assets.js +54 -0
package/dist/app/cues.js +130 -0
package/dist/app/editor-main.js +199 -0
package/dist/app/editor-preload.js +17 -0
package/dist/app/main.js +527 -0
package/dist/app/persona.js +136 -0
package/dist/app/preload.js +14 -0
package/dist/app/state.js +850 -0
package/dist/app/tts.js +257 -0
package/dist/mcp-server.js +408 -0
package/dist/renderer/bundle.js +17983 -0
package/dist/renderer/editor.html +150 -0
package/dist/renderer/editor.js +17917 -0
package/dist/renderer/index.html +425 -0
package/dist/shared/paths.js +169 -0
package/dist/shared/set-cue-schema.js +66 -0
package/dist/shared/types.js +14 -0
package/docs/CLIENTS.md +110 -0
package/docs/CUE_AUTHORING.md +76 -0
package/docs/DEVELOPMENT.md +129 -0
package/docs/PERSONA.md +61 -0
package/docs/PSD_LAYERS.md +123 -0
package/docs/README.md +43 -0
package/docs/SETUP.html +684 -0
package/docs/STYLE.md +107 -0
package/docs/TOOLS.md +33 -0
package/docs/TROUBLESHOOTING.md +122 -0
package/docs/TTS.md +61 -0
package/docs/design/CUE_CATALOG.md +259 -0
package/docs/images/faces.png +0 -0
package/docs/images/panel.png +0 -0
package/hooks/fire-event.js +14 -0
package/hooks/hooks.json +77 -0
package/hooks/lib/mascot.js +76 -0
package/hooks/notify.js +15 -0
package/hooks/reaction.js +46 -0
package/hooks/session-start.js +80 -0
package/package.json +96 -0
package/persona/ui-chan.md +111 -0
package/plugins/hermes/ui-chan/__init__.py +98 -0
package/plugins/hermes/ui-chan/plugin.yaml +7 -0
package/plugins/opencode/ui-chan.mjs +105 -0
package/skills/beam/SKILL.md +37 -0
package/skills/eli14/SKILL.md +139 -0
package/skills/eli14/references/base.html +495 -0
package/skills/mode/SKILL.md +67 -0
package/skills/talk/SKILL.md +27 -0
package/tools/setup/check-package.mjs +47 -0
package/tools/setup/clients.mjs +399 -0
package/tools/setup/doctor.mjs +105 -0
package/tools/setup/home.mjs +126 -0
package/tools/setup/prompt.mjs +134 -0
package/tools/setup/update-check.mjs +8 -0
package/tools/setup/update.mjs +350 -0
package/tools/stop-app.mjs +22 -0
package/ui-chan.config.json +973 -0

package/dist/renderer/index.html ADDED Viewed

@@ -0,0 +1,425 @@
+<!doctype html>
+<html lang="ja">
+<head>
+  <meta charset="utf-8" />
+  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; style-src 'self' 'unsafe-inline'; media-src blob:" />
+  <title>ui-chan</title>
+  <style>
+    html, body {
+      margin: 0;
+      padding: 0;
+      width: 100%;
+      height: 100%;
+      overflow: hidden;
+      background: transparent;
+      font-family: 'Hiragino Maru Gothic ProN', 'Hiragino Sans', sans-serif;
+      user-select: none;
+    }
+    #stage {
+      position: relative;
+      width: 100%;
+      height: 100%;
+      display: flex;
+      flex-direction: column;
+    }
+    #bubble-area {
+      flex: 0 0 auto;
+      min-height: 120px;
+      display: flex;
+      align-items: flex-end;
+      justify-content: center;
+      padding: 8px 10px 0;
+      box-sizing: border-box;
+      /* キャラクターの頭上（PSDの傘用余白ぶん）まで吹き出しを下げる */
+      transform: translateY(46px);
+      z-index: 1;
+      position: relative;
+    }
+    #bubble {
+      position: relative;
+      max-width: 100%;
+      /* 背景は髪の実ピクセル色 rgb(243,235,233)〜rgb(224,209,212)（淡い銀グレー）、
+         枠・矢印・影はリボン/靴下の実ピクセル色 rgb(78,91,181) = #4e5bb5 */
+      background: linear-gradient(180deg, rgba(250, 245, 243, 0.97), rgba(228, 216, 219, 0.97));
+      border: 2px solid #4e5bb5;
+      border-radius: 16px;
+      padding: 10px 14px;
+      font-size: 14px;
+      line-height: 1.5;
+      color: #2e2a35;
+      box-shadow: 0 3px 10px rgba(78, 91, 181, 0.28);
+      opacity: 0;
+      transform: translateY(6px);
+      transition: opacity 0.18s ease, transform 0.18s ease;
+      word-break: break-word;
+      /* 文ごとの改行（bubbleText）と、明示的な \n を効かせる */
+      white-space: pre-wrap;
+    }
+    #bubble.visible {
+      opacity: 1;
+      transform: translateY(0);
+    }
+    #bubble::after {
+      content: '';
+      position: absolute;
+      bottom: -9px;
+      left: 50%;
+      margin-left: -7px;
+      border-width: 9px 7px 0;
+      border-style: solid;
+      border-color: #4e5bb5 transparent transparent;
+    }
+    #canvas-wrap {
+      flex: 1 1 auto;
+      position: relative;
+      /* No -webkit-app-region: drag — it swallows the mouse events the fidget
+         needs (and triggers macOS double-click-to-reposition). Window dragging
+         is done manually in renderer.ts (grab her body to move her). */
+    }
+    #canvas {
+      position: absolute;
+      inset: 0;
+      width: 100%;
+      height: 100%;
+    }
+    #placeholder {
+      display: none;
+      position: absolute;
+      inset: 12px;
+      background: rgba(30, 34, 52, 0.92);
+      border: 2px dashed #7a8ac0;
+      border-radius: 16px;
+      color: #e8ecff;
+      padding: 20px;
+      font-size: 13px;
+      line-height: 1.8;
+    }
+    #placeholder h1 {
+      font-size: 16px;
+      margin: 0 0 12px;
+    }
+    #placeholder code {
+      background: rgba(255, 255, 255, 0.12);
+      border-radius: 4px;
+      padding: 1px 5px;
+      font-family: monospace;
+    }
+    /* ---- 接続パネル -------------------------------------------------
+       世界観を壊さないための約束：平常時はリボン色の小さなつまみだけ。
+       クリックで開き、複数セッションを検知したときだけ自分から開いて、
+       用が済んだら畳まる。立ち絵と吹き出しには一切干渉しない。 */
+    #panel {
+      position: absolute;
+      top: 6px;
+      right: 6px;
+      z-index: 5;
+      display: flex;
+      flex-direction: column;
+      align-items: flex-end;
+      font-size: 12px;
+      color: #2e2a35;
+    }
+    #panel-tab {
+      -webkit-app-region: no-drag;
+      appearance: none;
+      border: none;
+      cursor: pointer;
+      width: 26px;
+      height: 14px;
+      padding: 0;
+      border-radius: 7px;
+      background: rgba(78, 91, 181, 0.28);
+      box-shadow: 0 1px 3px rgba(78, 91, 181, 0.25);
+      opacity: 0.35;
+      transition: opacity 0.2s ease, background 0.2s ease, width 0.2s ease;
+      color: #fff;
+      font: inherit;
+      font-size: 10px;
+      line-height: 14px;
+      text-align: center;
+    }
+    #panel:hover #panel-tab,
+    #panel.open #panel-tab {
+      opacity: 1;
+      background: rgba(78, 91, 181, 0.92);
+    }
+    /* Collapsed with 0–1 sessions: a hamburger, drawn in CSS so it stays crisp
+       and needs no font. With 2+ sessions the count replaces it. */
+    #panel-tab::before {
+      content: '';
+      display: block;
+      width: 12px;
+      height: 8px;
+      margin: 0 auto;
+      border-top: 1.5px solid currentColor;
+      border-bottom: 1.5px solid currentColor;
+      box-sizing: border-box;
+      background:
+        linear-gradient(currentColor, currentColor) center / 12px 1.5px no-repeat;
+    }
+    #panel.crowded #panel-tab::before {
+      display: none;
+    }
+    #panel.crowded #panel-tab {
+      width: 30px;
+    }
+    #panel-body {
+      margin-top: 6px;
+      /* Narrow on purpose: open, it must not sit on top of her face. */
+      width: 176px;
+      background: linear-gradient(180deg, rgba(250, 245, 243, 0.98), rgba(232, 223, 226, 0.98));
+      border: 1.5px solid #4e5bb5;
+      border-radius: 12px;
+      box-shadow: 0 4px 14px rgba(78, 91, 181, 0.3);
+      padding: 8px;
+      box-sizing: border-box;
+      opacity: 0;
+      transform: translateY(-6px) scale(0.98);
+      transform-origin: top right;
+      pointer-events: none;
+      transition: opacity 0.18s ease, transform 0.18s ease;
+    }
+    #panel.open #panel-body {
+      opacity: 1;
+      transform: translateY(0) scale(1);
+      pointer-events: auto;
+    }
+    .panel-row {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      padding: 4px 4px;
+      border-radius: 7px;
+    }
+    .panel-row.active {
+      background: rgba(78, 91, 181, 0.14);
+    }
+    .panel-dot {
+      width: 7px;
+      height: 7px;
+      border-radius: 50%;
+      background: rgba(78, 91, 181, 0.28);
+      flex: 0 0 auto;
+    }
+    .panel-row.active .panel-dot {
+      background: #4e5bb5;
+      box-shadow: 0 0 0 3px rgba(78, 91, 181, 0.18);
+    }
+    .panel-text {
+      display: flex;
+      flex-direction: column;
+      line-height: 1.3;
+      overflow: hidden;
+    }
+    .panel-text b {
+      font-weight: 600;
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+    .panel-text small {
+      color: #6b6577;
+      font-size: 10.5px;
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+    .panel-empty {
+      color: #6b6577;
+      padding: 4px;
+      text-align: center;
+    }
+    .panel-face {
+      display: block;
+      white-space: nowrap;
+      margin-top: 2px;
+      letter-spacing: 0.02em;
+    }
+    /* 操作はアイコン1行。文字を置かないぶん最も「アプリのUI」に見えにくく、
+       高さも1行で固定なので、接続が増えて縦に伸びる見え方を邪魔しない。
+       意味はすべて title（ツールチップ）で補う。 */
+    /* 好感度スライダー。歯車で開くまで存在しない（普段のパネルは「誰がいるか」
+       だけを答える場所で、設定はそのついでに触れればいい）。 */
+    #panel-affinity {
+      margin-top: 6px;
+      border-top: 1px solid rgba(78, 91, 181, 0.2);
+      padding: 6px 4px 2px;
+    }
+    #panel-affinity[hidden] {
+      display: none;
+    }
+    .aff-head {
+      display: flex;
+      align-items: baseline;
+      gap: 6px;
+      color: #6b6577;
+      font-size: 11px;
+    }
+    .aff-head b {
+      color: #2e2a35;
+      font-size: 13px;
+      margin-left: auto;
+    }
+    .aff-head small {
+      font-size: 10.5px;
+      color: #4e5bb5;
+    }
+    #aff-range {
+      width: 100%;
+      margin: 4px 0 0;
+      accent-color: #4e5bb5;
+    }
+    #panel-actions {
+      display: flex;
+      align-items: center;
+      gap: 2px;
+      margin-top: 6px;
+      border-top: 1px solid rgba(78, 91, 181, 0.2);
+      padding-top: 6px;
+    }
+    #panel-actions button {
+      appearance: none;
+      cursor: pointer;
+      background: transparent;
+      border: none;
+      border-radius: 8px;
+      padding: 4px;
+      line-height: 0;
+      color: #4a4560;
+    }
+    #panel-actions button:hover {
+      background: rgba(78, 91, 181, 0.14);
+      color: #4e5bb5;
+    }
+    #panel-actions svg {
+      width: 17px;
+      height: 17px;
+      fill: none;
+      stroke: currentColor;
+      stroke-width: 1.6;
+      stroke-linecap: round;
+      stroke-linejoin: round;
+    }
+    /* ミュート中は「音が消えている」形（波→斜線）に変わり、色でも分かる。 */
+    #panel-actions .i-slash {
+      display: none;
+    }
+    #panel-actions .i-fill {
+      fill: currentColor;
+      stroke: none;
+    }
+    #panel-actions button.on {
+      color: #4e5bb5;
+      background: rgba(78, 91, 181, 0.16);
+    }
+    #panel-gear.on svg path {
+      fill: currentColor;
+    }
+    #panel-actions button.on .i-wave {
+      display: none;
+    }
+    #panel-actions button.on .i-slash {
+      display: inline;
+    }
+    /* 更新の入口は「あるときだけ」出す。常設すると平常時の情報がひとつ増える。 */
+    #panel-update[hidden] {
+      display: none;
+    }
+    #panel-update {
+      color: #4e5bb5;
+      margin-left: auto;
+    }
+    #panel-update + button[data-action='quit'] {
+      margin-left: 4px;
+    }
+    /* 終了だけは押し間違えると困るので、右端に離して置く。 */
+    #panel-actions button[data-action='quit'] {
+      margin-left: auto;
+      color: #8a8497;
+    }
+    #panel-actions button[data-action='quit']:hover {
+      color: #b4515e;
+      background: rgba(180, 81, 94, 0.12);
+    }
+  </style>
+</head>
+<body>
+  <div id="stage">
+    <div id="panel">
+      <button id="panel-tab" type="button" title="接続中のセッション"><span id="panel-count"></span></button>
+      <div id="panel-body">
+        <div id="panel-list"></div>
+        <div id="panel-affinity" hidden>
+          <div class="aff-head"><span>好感度</span><b id="aff-value">–</b><small id="aff-band"></small></div>
+          <input id="aff-range" type="range" min="0" max="100" step="1" value="0" />
+        </div>
+        <div id="panel-actions">
+          <button type="button" data-action="mute" title="しずかに（声だけ止める）" aria-label="しずかに">
+            <svg viewBox="0 0 20 20" aria-hidden="true">
+              <path d="M4 8h3l4-3.5v11L7 12H4z" />
+              <path class="i-wave" d="M13.5 7.2a3.6 3.6 0 0 1 0 5.6" />
+              <path class="i-slash" d="M13.2 7.4l4.4 5.2M17.6 7.4l-4.4 5.2" />
+            </svg>
+          </button>
+          <button type="button" data-action="clear" title="ひといき（いま喋っていることを止めて Idling に戻す）" aria-label="ひといき">
+            <svg viewBox="0 0 20 20" aria-hidden="true">
+              <!-- 丸に斜線（禁止・停止）。■ は ▶/⏸ と並んでいないと停止に
+                   見えず、単独ではただの四角になるため。 -->
+              <circle cx="10" cy="10" r="6.4" />
+              <path d="M5.5 14.5L14.5 5.5" />
+            </svg>
+          </button>
+          <button type="button" id="panel-gear" title="好感度" aria-label="好感度">
+            <svg viewBox="0 0 20 20" aria-hidden="true">
+              <!-- ハート。ここに入っているのは好感度だけなので、「設定」を名乗る
+                   歯車より、中身をそのまま指すほうが正直（設定が増えたら歯車に
+                   戻す）。 -->
+              <path d="M10 16.2S3.4 12.3 3.4 7.9a3.5 3.5 0 0 1 6.6-1.6 3.5 3.5 0 0 1 6.6 1.6c0 4.4-6.6 8.3-6.6 8.3z" />
+            </svg>
+          </button>
+          <button type="button" data-action="restart" title="リセット（定位置に戻して起動しなおす）" aria-label="リセット">
+            <svg viewBox="0 0 20 20" aria-hidden="true">
+              <!-- 家＝定位置。再起動はウィンドウを作り直すので位置も既定に戻る
+                   （createWindow がワークエリアから毎回座標を計算する）。 -->
+              <path d="M3.4 9.3L10 3.6l6.6 5.7" />
+              <path d="M5.2 8.4v7.4h9.6V8.4" />
+              <path d="M8.4 15.8v-4.1h3.2v4.1" />
+            </svg>
+          </button>
+          <button type="button" data-action="update" id="panel-update" title="更新があります（取得して入れ替える）" aria-label="更新" hidden>
+            <svg viewBox="0 0 20 20" aria-hidden="true">
+              <!-- 下向き矢印＋受け皿。更新があるときだけ現れる6つ目。 -->
+              <path d="M10 3.4v8.4" />
+              <path d="M6.6 8.6L10 12l3.4-3.4" />
+              <path d="M4.2 14.2v1.4a1 1 0 0 0 1 1h9.6a1 1 0 0 0 1-1v-1.4" />
+            </svg>
+          </button>
+          <button type="button" data-action="quit" title="おやすみ（終了。次に呼ばれても起きない）" aria-label="おやすみ">
+            <svg viewBox="0 0 20 20" aria-hidden="true">
+              <path d="M10 3.2v6.4" />
+              <path d="M6.2 5.6a6 6 0 1 0 7.6 0" />
+            </svg>
+          </button>
+        </div>
+      </div>
+    </div>
+    <div id="bubble-area"><div id="bubble"></div></div>
+    <div id="canvas-wrap">
+      <canvas id="canvas"></canvas>
+      <div id="placeholder">
+        <h1>ui-chan: 素材が見つかりません</h1>
+        <p>
+          立ち絵のPSDファイルを <code id="assets-dir">ui_sozai/</code> ディレクトリに
+          配置して、アプリを再起動してください。
+        </p>
+        <p>
+          PSDTool形式（<code>!</code>=必須レイヤー、<code>*</code>=ラジオ切替）の
+          PSDに対応しています。レイヤー名と表情のマッピングは
+          <code>ui-chan.config.json</code> で設定できます。
+        </p>
+      </div>
+    </div>
+  </div>
+  <script src="bundle.js"></script>
+</body>
+</html>

package/dist/shared/paths.js ADDED Viewed

@@ -0,0 +1,169 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installKind = installKind;
+exports.uiChanHome = uiChanHome;
+exports.loadEnvFiles = loadEnvFiles;
+exports.deepMerge = deepMerge;
+exports.resolvePaths = resolvePaths;
+// Where ui-chan's files live — the one module that answers "package or user?".
+//
+// Everything ships twice: the package carries defaults (config, cues, persona,
+// context) and the user may carry overrides in a **home directory**
+// (`UI_CHAN_HOME`, default `~/.ui-chan`). The package half is read-only and
+// replaced wholesale on every update; the home half is never touched by an
+// update. That split is what makes `npm update` / a fresh install safe — before
+// it, a user's PSD, `.env` and hand-authored cues sat inside the install
+// directory and died with it (see the plugin-cache incident in the README).
+//
+// Resolution is per-resource, not all-or-nothing:
+//   config   home/config.json deep-merged **over** the packaged defaults, so a
+//            user file with three keys keeps inheriting everything added later.
+//   cues     both dirs load, home wins on same name — add a cue without
+//            copying the catalog.
+//   context  same (filename-keyed).
+//   persona  home file if present, else packaged.
+//   assets   home first, then packaged (PSD is licensed, so usually home-only).
+//   .env     home first, then package (env vars still win over both).
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+function installKind(pkgRoot) {
+    if (fs.existsSync(path.join(pkgRoot, '.git')))
+        return 'git';
+    // npm puts packages in `<prefix>/lib/node_modules/<name>` (global) or
+    // `<project>/node_modules/<name>` (local). Both end in node_modules/<name>,
+    // which a clone never does.
+    const parent = path.basename(path.dirname(pkgRoot));
+    if (parent === 'node_modules' ||
+        path.basename(path.dirname(path.dirname(pkgRoot))) === 'node_modules') {
+        return pkgRoot.includes(`${path.sep}lib${path.sep}node_modules${path.sep}`) ||
+            !fs.existsSync(path.join(pkgRoot, '..', '..', 'package.json'))
+            ? 'npm-global'
+            : 'npm-local';
+    }
+    return 'copy';
+}
+function uiChanHome() {
+    return process.env.UI_CHAN_HOME ?? path.join(os.homedir(), '.ui-chan');
+}
+/** `.env` files, lowest precedence first. Loaded, never overwriting real env
+ *  vars — `loadEnvFile` leaves already-set variables alone. */
+function loadEnvFiles(pkgRoot) {
+    const loaded = [];
+    for (const file of [path.join(pkgRoot, '.env'), path.join(uiChanHome(), '.env')]) {
+        try {
+            process.loadEnvFile(file);
+            loaded.push(file);
+        }
+        catch {
+            /* absent or unreadable — credentials can still come from the environment */
+        }
+    }
+    return loaded;
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** Deep merge for config only: objects merge key-wise, arrays and scalars are
+ *  replaced outright (a user's `idlingCues` list means "this list", not "append
+ *  to the packaged one"). */
+function deepMerge(base, override) {
+    if (!isPlainObject(base) || !isPlainObject(override))
+        return (override ?? base);
+    const out = { ...base };
+    for (const [k, v] of Object.entries(override)) {
+        out[k] = k in out ? deepMerge(out[k], v) : v;
+    }
+    return out;
+}
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function existingDirs(dirs) {
+    return dirs.filter((d) => fs.existsSync(d));
+}
+/**
+ * Resolve every path ui-chan reads, given the package root.
+ * `pkgRoot` is `dist/..` for the MCP server and `dist/../..` for the Electron
+ * app — both callers pass their own, this module never guesses.
+ */
+function resolvePaths(pkgRoot) {
+    const home = uiChanHome();
+    const homeExists = fs.existsSync(home);
+    const kind = installKind(pkgRoot);
+    const packaged = (readJson(path.join(pkgRoot, 'ui-chan.config.json')) ?? {});
+    const configFile = path.join(home, 'config.json');
+    const override = homeExists ? readJson(configFile) : null;
+    const config = override ? deepMerge(packaged, override) : packaged;
+    const cueDirs = existingDirs([
+        path.join(pkgRoot, config.cuesDir ?? 'cues'),
+        path.join(home, 'cues'),
+    ]);
+    const homePersona = path.join(home, 'persona', 'ui-chan.md');
+    return {
+        pkgRoot,
+        kind,
+        home,
+        homeExists,
+        config,
+        configFile,
+        cueDirs,
+        // Last existing dir wins: with a home dir set up, edits land in the user's
+        // data; in a bare git clone (no home), they land in the repo where the
+        // author expects them.
+        // Where a saved cue goes. In a clone that's the repo (the author is editing
+        // the catalog itself); anywhere else the package dir belongs to npm or to
+        // whoever unpacked it and will be replaced wholesale on the next update, so
+        // the user's cue has to live in their home dir even if it doesn't exist yet.
+        cueWriteDir: kind === 'git'
+            ? (cueDirs[cueDirs.length - 1] ?? path.join(pkgRoot, config.cuesDir ?? 'cues'))
+            : path.join(home, 'cues'),
+        cueSchemaFile: path.join(pkgRoot, 'cue.schema.json'),
+        assetsDirs: existingDirs([
+            path.join(home, config.assetsDir ?? 'assets'),
+            path.join(pkgRoot, config.assetsDir ?? 'assets'),
+        ]),
+        personaFile: fs.existsSync(homePersona)
+            ? homePersona
+            : path.join(pkgRoot, config.personaFile ?? 'persona/ui-chan.md'),
+        contextDirs: existingDirs([path.join(pkgRoot, 'context'), path.join(home, 'context')]),
+    };
+}

package/dist/shared/set-cue-schema.js ADDED Viewed

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCueArgsSchema = exports.setCueShape = void 0;
+const zod_1 = require("zod");
+/** Single source of truth for set_cue's argument shape. `mcp-server.ts` uses
+ *  `setCueShape` directly as the MCP tool's inputSchema (a zod raw shape);
+ *  `main.ts` parses the WS bridge payload with `setCueArgsSchema`; `state.ts`
+ *  uses the inferred `SetCueArgs` type. Adding or renaming a knob is a
+ *  one-file change instead of three hand-synced ones.
+ *
+ *  Kept out of `shared/types.ts` on purpose: that module is also imported
+ *  (type-only) by the browser-bundled renderer, and this file pulls in the
+ *  zod runtime, which the renderer has no use for. */
+exports.setCueShape = {
+    cue: zod_1.z.string().describe('Cue name (unknown names fall back to "default")'),
+    text: zod_1.z
+        .string()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe('Optional line to speak in the bubble. Omit for a silent Cue change.'),
+    reading: zod_1.z
+        .string()
+        .max(1000)
+        .optional()
+        .describe('Hiragana reading of the WHOLE line — drives lip sync, and is what the TTS engine actually ' +
+        'speaks whenever text contains Latin letters or digits. Leave NO Latin letters, digits or ' +
+        'symbols in it: write how a Japanese speaker actually says the line, judging each term from ' +
+        'your own knowledge rather than transliterating its spelling (k8s → くーばねてぃす, ' +
+        'bash → ばっしゅ, NPO → えぬぴーおー, 3回 → さんかい). Anything left in Latin is read out ' +
+        'letter-by-letter in English. Provide whenever text is given.'),
+    duration_ms: zod_1.z
+        .number()
+        .int()
+        .min(500)
+        .max(60_000)
+        .optional()
+        .describe('With text: how long to display the bubble, ms (default derived from text length). ' +
+        'Without text: how long to hold this Cue before easing back to default, ms ' +
+        '(default: holds until the next set_cue).'),
+    pitch: zod_1.z
+        .number()
+        .min(-600)
+        .max(600)
+        .optional()
+        .describe('Ad-lib pitch shift for this line only, in cents (-600..600, default 0)'),
+    speed: zod_1.z
+        .number()
+        .min(0.2)
+        .max(5)
+        .optional()
+        .describe('Ad-lib speech speed for this line only (0.2..5, default 1)'),
+    volume: zod_1.z
+        .number()
+        .min(-8)
+        .max(8)
+        .optional()
+        .describe('Ad-lib volume for this line only, in dB (-8..8, default 0)'),
+    intonation: zod_1.z
+        .number()
+        .min(0)
+        .max(2)
+        .optional()
+        .describe('Ad-lib intonation strength for this line only (0..2, default 1)'),
+};
+exports.setCueArgsSchema = zod_1.z.object(exports.setCueShape);

package/dist/shared/types.js ADDED Viewed

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_AFFINITY_STEPS = exports.AFFINITY_MAGNITUDES = exports.DEFAULT_CUE_NAME = void 0;
+/** Not a config field — a fixed naming convention. The Cue named "default"
+ *  is composed underneath every other Cue as the shared base look: same
+ *  file format, same directory, no special-casing. */
+exports.DEFAULT_CUE_NAME = 'default';
+exports.AFFINITY_MAGNITUDES = ['low', 'middle', 'high'];
+/** Built-in base magnitudes if config.affinity.steps is absent. */
+exports.DEFAULT_AFFINITY_STEPS = {
+    low: 3,
+    middle: 6,
+    high: 12,
+};