teletype-mcp-server 0.1.0 → 0.1.1

package/plugin/assets/landing.css

@@ -0,0 +1,442 @@
+@font-face {
+  font-family: Manrope;
+  src: url("/assets/fonts/manrope.woff2") format("woff2");
+  font-weight: 200 800;
+  font-style: normal;
+  font-display: swap;
+}
+
+:root {
+  color-scheme: light;
+  --surface: #fff;
+  --background: #f8f8f8;
+  --ink: #1c1c1c;
+  --muted: #555;
+  --line: #d8d8d8;
+  --blue: #006de5;
+  --blue-hover: #005fc9;
+  --blue-soft: #eef5ff;
+  --focus: #0079ff;
+  font-family: Manrope, sans-serif;
+  font-synthesis: none;
+  color: var(--ink);
+  background: var(--background);
+}
+
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  font-size: 16px;
+  line-height: 1.6;
+}
+::selection {
+  color: var(--ink);
+  background: #dcecff;
+}
+:focus-visible {
+  outline: 3px solid var(--focus);
+  outline-offset: 4px;
+}
+a,
+button,
+input {
+  -webkit-tap-highlight-color: transparent;
+}
+a {
+  color: var(--blue-hover);
+  text-underline-offset: 4px;
+}
+a:hover {
+  color: #004ca3;
+}
+button,
+input {
+  font: inherit;
+}
+button[hidden] {
+  display: none;
+}
+
+.page {
+  width: 100%;
+  max-width: 860px;
+  min-height: 100svh;
+  margin-inline: auto;
+  padding: 48px 24px;
+  display: flex;
+  flex-direction: column;
+}
+.page-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  margin-bottom: 24px;
+}
+.brand {
+  display: inline-flex;
+  align-items: center;
+  min-height: 44px;
+}
+.brand img {
+  display: block;
+  width: 184px;
+  height: 42px;
+}
+.languages {
+  display: flex;
+  gap: 2px;
+  padding: 3px;
+  border: 1px solid var(--line);
+  border-radius: 10px;
+}
+.languages[hidden] {
+  display: none;
+}
+.languages button {
+  display: inline-flex;
+  align-items: center;
+  min-height: 44px;
+  padding: 8px 10px;
+  border-radius: 6px;
+  border: 0;
+  background: transparent;
+  font-size: 13px;
+  color: var(--muted);
+  text-decoration: none;
+  cursor: pointer;
+}
+.languages button:hover {
+  color: var(--ink);
+  background: #eee;
+}
+.languages button[aria-pressed="true"] {
+  color: var(--blue-hover);
+  background: var(--surface);
+  font-weight: 700;
+  box-shadow: 0 1px 4px rgb(0 0 0 / 8%);
+}
+.landing {
+  padding: 48px;
+  background: var(--surface);
+  border-radius: 16px;
+  box-shadow: 0 12px 48px rgb(0 0 0 / 6%);
+}
+h1 {
+  margin: 0 0 16px;
+  font-size: clamp(32px, 5vw, 48px);
+  font-weight: 750;
+  line-height: 1.15;
+  letter-spacing: -0.035em;
+  text-wrap: balance;
+}
+.description {
+  max-width: 52ch;
+  margin: 0;
+  font-size: 19px;
+  line-height: 1.65;
+  text-wrap: pretty;
+}
+.connection {
+  margin-top: 32px;
+  max-width: 540px;
+}
+.connection label {
+  display: block;
+  margin-bottom: 8px;
+  color: var(--muted);
+  font-size: 13px;
+}
+.address {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px;
+  border: 1px solid var(--line);
+  border-radius: 10px;
+}
+.address input {
+  width: 100%;
+  min-width: 0;
+  min-height: 44px;
+  padding: 8px;
+  border: 0;
+  border-radius: 4px;
+  color: var(--ink);
+  background: transparent;
+  font-size: 16px;
+  caret-color: var(--blue);
+}
+.address button {
+  min-height: 44px;
+  padding: 8px 12px;
+  border: 0;
+  border-radius: 6px;
+  background: var(--blue-soft);
+  color: var(--blue-hover);
+  font-size: 13px;
+  font-weight: 700;
+  white-space: nowrap;
+  cursor: pointer;
+}
+.address button:hover {
+  background: #e0edff;
+}
+.address button:disabled {
+  cursor: wait;
+  opacity: 0.7;
+}
+.copy-icon,
+.copy-check {
+  display: none;
+}
+.address button[data-state="copied"] .copy-document {
+  display: none;
+}
+.address button[data-state="copied"] .copy-check {
+  display: block;
+}
+.actions {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 12px 24px;
+  margin-top: 24px;
+}
+.button {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 48px;
+  padding: 12px 22px;
+  border-radius: 8px;
+  color: #fff;
+  background: var(--blue);
+  font-size: 15px;
+  font-weight: 700;
+  text-decoration: none;
+}
+.button:hover {
+  color: #fff;
+  background: var(--blue-hover);
+}
+.button:active {
+  background: #0052b0;
+}
+.source {
+  display: inline-flex;
+  align-items: center;
+  min-height: 44px;
+  font-size: 15px;
+}
+footer {
+  margin-top: 16px;
+  display: flex;
+  justify-content: center;
+  flex-wrap: wrap;
+  gap: 4px 24px;
+  text-align: center;
+}
+footer a {
+  display: inline-flex;
+  align-items: center;
+  min-height: 44px;
+  font-size: 13px;
+}
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip-path: inset(50%);
+  white-space: nowrap;
+  border: 0;
+}
+
+h2 {
+  margin: 0 0 16px;
+  font-size: 25px;
+  font-weight: 750;
+  line-height: 1.35;
+  letter-spacing: -0.025em;
+  text-wrap: balance;
+}
+.examples {
+  margin-top: 44px;
+  padding-top: 36px;
+  border-top: 1px solid var(--line);
+}
+.examples dl {
+  margin: 0;
+}
+.example {
+  display: grid;
+  grid-template-columns: 180px minmax(0, 1fr);
+  gap: 24px;
+  padding-block: 16px;
+}
+.example + .example {
+  border-top: 1px solid #ededed;
+}
+.example dt {
+  font-size: 15px;
+  font-weight: 700;
+}
+.example dd {
+  margin: 0;
+  color: var(--muted);
+  font-size: 15px;
+  line-height: 1.7;
+}
+:lang(ru) q {
+  quotes: "«" "»";
+}
+:lang(en) q {
+  quotes: "“" "”";
+}
+.setup {
+  margin-top: 32px;
+}
+.setup p {
+  margin: 0;
+  color: var(--muted);
+  font-size: 15px;
+}
+.setup ol {
+  margin: 16px 0 0;
+  padding-left: 24px;
+  font-size: 15px;
+}
+.setup li {
+  padding-left: 6px;
+}
+.setup li + li {
+  margin-top: 12px;
+}
+.setup li::marker {
+  color: var(--blue-hover);
+  font-weight: 700;
+}
+.setup a {
+  display: inline-block;
+  vertical-align: top;
+  padding-block: 8px;
+  margin-block: -8px;
+}
+
+@media (max-width: 560px) {
+  .page {
+    justify-content: flex-start;
+    padding: 20px 20px max(28px, env(safe-area-inset-bottom));
+    background: var(--surface);
+  }
+  .page-header {
+    gap: 12px;
+    margin-bottom: 28px;
+  }
+  .brand img {
+    width: 144px;
+    height: auto;
+  }
+  .languages {
+    padding: 0;
+    border: 0;
+  }
+  .languages button {
+    padding-inline: 8px;
+    font-size: 12px;
+  }
+  .languages button[aria-pressed="true"] {
+    background: var(--blue-soft);
+    box-shadow: none;
+  }
+  .landing {
+    padding: 0;
+    border-radius: 0;
+    box-shadow: none;
+  }
+  h1 {
+    font-size: clamp(32px, 9vw, 40px);
+  }
+  .description {
+    font-size: 17px;
+  }
+  .address {
+    gap: 4px;
+    padding: 4px;
+  }
+  .address input {
+    flex: 1;
+  }
+  .address button {
+    display: inline-flex;
+    justify-content: center;
+    align-items: center;
+    flex: 0 0 44px;
+    padding: 0;
+  }
+  .address button[hidden] {
+    display: none;
+  }
+  .copy-icon {
+    display: block;
+  }
+  .copy-label {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip-path: inset(50%);
+    white-space: nowrap;
+  }
+  .actions {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) auto;
+    gap: 12px;
+    margin-top: 16px;
+  }
+  .button {
+    padding-inline: 16px;
+  }
+  .source {
+    justify-content: center;
+    min-height: 48px;
+    padding: 12px 18px;
+    border: 1px solid var(--line);
+    border-radius: 8px;
+    text-decoration: none;
+  }
+  h2 {
+    font-size: 23px;
+  }
+  .examples {
+    margin-top: 32px;
+    padding-top: 28px;
+  }
+  .example {
+    grid-template-columns: minmax(0, 1fr);
+    gap: 6px;
+    padding-block: 18px;
+  }
+  .example dt,
+  .example dd {
+    font-size: 16px;
+  }
+  .setup {
+    margin-top: 28px;
+    padding-top: 28px;
+    border-top: 1px solid var(--line);
+  }
+  footer {
+    justify-content: flex-start;
+    gap: 4px 20px;
+    margin-top: 24px;
+    text-align: left;
+  }
+}

package/plugin/assets/landing.js

@@ -0,0 +1,85 @@
+const button = document.getElementById("copy-url");
+const input = document.getElementById("mcp-url");
+const status = document.getElementById("copy-status");
+const label = button.querySelector(".copy-label");
+const translations = JSON.parse(document.querySelector(".page").dataset.translations);
+const languages = document.querySelectorAll(".languages [data-locale]");
+let reset;
+let feedback;
+
+function showFeedback(key) {
+  feedback = key;
+  status.textContent = key ? button.dataset[key] : "";
+}
+
+function setState(state) {
+  label.textContent = button.dataset[state];
+  button.title = button.dataset[state];
+  button.dataset.state = state;
+}
+
+button.hidden = false;
+button.addEventListener("click", async () => {
+  clearTimeout(reset);
+  showFeedback();
+  button.disabled = true;
+  setState("copying");
+  try {
+    await navigator.clipboard.writeText(input.value);
+    setState("copied");
+    showFeedback("copied");
+    reset = setTimeout(() => {
+      setState("copy");
+    }, 2000);
+  } catch {
+    input.focus();
+    input.select();
+    setState("copy");
+    showFeedback("fallback");
+  } finally {
+    button.disabled = false;
+  }
+});
+
+function changeLanguage(locale, announce = false) {
+  if (locale !== "ru" && locale !== "en") return;
+  const copy = translations[locale];
+  if (!copy) return;
+  document.documentElement.lang = locale;
+  document.querySelectorAll("[data-i18n]").forEach((element) => {
+    element.textContent = element.dataset.i18n.split(".").reduce((value, key) => value[key], copy);
+  });
+  document.querySelectorAll("[data-i18n-href]").forEach((element) => {
+    element.href = copy[element.dataset.i18nHref];
+  });
+  document.querySelector(".brand").setAttribute("aria-label", copy.website + copy.newTab);
+  document.querySelector(".actions").setAttribute("aria-label", copy.links);
+  document
+    .querySelectorAll('meta[name="description"], meta[property="og:description"]')
+    .forEach((element) => element.setAttribute("content", copy.description));
+  for (const key of ["copy", "copied", "copying", "copyFallback"]) {
+    button.dataset[key === "copyFallback" ? "fallback" : key] = copy[key];
+  }
+  setState(button.dataset.state || "copy");
+  showFeedback(feedback);
+  languages.forEach((link) => {
+    link.setAttribute("aria-pressed", String(link.dataset.locale === locale));
+  });
+  document.cookie = `teletype_oauth_locale=${locale}; Path=/; Max-Age=31536000; SameSite=Lax${location.protocol === "https:" ? "; Secure" : ""}`;
+  if (announce) document.getElementById("language-status").textContent = copy.languageChanged;
+}
+
+languages.forEach((link) => {
+  link.addEventListener("click", () => {
+    const locale = link.dataset.locale;
+    if (locale === document.documentElement.lang) return;
+    changeLanguage(locale, true);
+  });
+});
+
+document.querySelector(".languages").hidden = false;
+const url = new URL(location.href);
+if (url.searchParams.has("lang")) {
+  url.searchParams.delete("lang");
+  history.replaceState(history.state, "", url);
+}

package/plugin/assets/logo.svg

@@ -0,0 +1,16 @@
+<svg width="1533" height="350" viewBox="0 0 1533 350" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M622.762 218.064V101.3C622.762 95.0849 627.599 90 633.925 90C640.25 90 645.273 95.0849 645.273 101.3V218.064C645.273 224.467 640.25 229.364 633.925 229.364C627.785 229.364 622.762 224.467 622.762 218.064ZM464.232 217.876V118.061H432.605C426.651 118.061 422 113.165 422 107.326C422 101.488 426.651 96.5916 432.605 96.5916H519.115C524.882 96.5916 529.534 101.488 529.534 107.326C529.534 113.165 524.882 118.061 519.115 118.061H487.302V217.876C487.302 224.279 482.092 229.364 475.767 229.364C469.441 229.364 464.232 224.279 464.232 217.876ZM535.962 171.735H586.38C584.892 157.046 576.333 145.558 561.45 145.558C547.683 145.558 538.008 156.292 535.962 171.735ZM564.053 230.683C579.309 230.683 590.472 225.598 599.402 217.5C601.076 215.805 602.378 213.356 602.378 210.531C602.378 205.258 598.472 201.303 593.448 201.303C590.844 201.303 589.355 202.057 587.681 203.375C581.355 208.648 573.914 212.038 564.425 212.038C549.914 212.038 538.565 202.998 536.147 186.802H597.727C603.495 186.802 608.332 182.282 608.332 175.879C608.332 152.903 592.89 126.913 561.635 126.913C533.542 126.913 513.635 150.266 513.635 178.704V179.08C513.635 209.778 535.589 230.683 564.053 230.683ZM732.071 171.735H681.653C683.699 156.292 693.374 145.558 707.141 145.558C722.024 145.558 730.582 157.046 732.071 171.735ZM745.095 217.5C736.165 225.598 725.002 230.683 709.747 230.683C681.282 230.683 659.329 209.778 659.329 179.08V178.704C659.329 150.266 679.235 126.913 707.328 126.913C738.583 126.913 754.025 152.903 754.025 175.879C754.025 182.282 749.188 186.802 743.421 186.802H681.84C684.259 202.998 695.607 212.038 710.119 212.038C719.607 212.038 727.049 208.648 733.374 203.375C735.049 202.057 736.537 201.303 739.142 201.303C744.165 201.303 748.072 205.258 748.072 210.531C748.072 213.356 746.769 215.805 745.095 217.5ZM771.801 200.927C771.801 222.773 783.521 230.118 800.079 230.118C806.033 230.118 810.684 229.176 815.521 227.481C818.684 226.163 821.474 222.773 821.474 218.63C821.474 213.356 817.009 209.213 811.986 209.213C811.727 209.213 811.287 209.282 810.714 209.371L810.714 209.371C809.641 209.538 808.102 209.778 806.405 209.778C798.777 209.778 794.312 206.2 794.312 197.348V148.571H811.986C817.381 148.571 821.846 144.239 821.846 138.778C821.846 133.316 817.381 128.985 811.986 128.985H794.312V112.035C794.312 105.82 789.289 100.735 783.149 100.735C776.824 100.735 771.801 105.82 771.801 112.035V128.985H768.08C762.684 128.985 758.405 133.316 758.405 138.778C758.405 144.239 762.684 148.571 768.08 148.571H771.801V200.927ZM851.531 259.12C845.205 259.12 840.554 258.178 835.903 256.295C832.554 255.165 828.834 252.34 828.834 246.878C828.834 241.228 833.113 237.462 837.95 237.462C839.81 237.462 840.926 237.839 842.043 238.215C844.647 238.968 846.694 239.533 849.857 239.533C856.554 239.533 860.089 236.709 863.81 228.987L864.554 226.915L828.089 144.427C827.345 142.732 826.787 140.472 826.787 138.965C826.787 132.562 831.624 127.854 837.95 127.854C843.717 127.854 846.88 131.244 848.926 136.517L875.345 202.621L899.902 136.517C901.763 131.809 904.926 127.854 910.693 127.854C916.646 127.854 921.484 132.562 921.484 138.589C921.484 140.472 920.925 142.92 920.553 144.05L884.647 231.247C876.275 251.587 867.345 259.12 851.531 259.12ZM932.935 139.343V248.197C932.935 254.601 937.958 259.497 944.097 259.497C950.423 259.497 955.446 254.601 955.446 248.197V212.98C962.33 222.208 972.562 230.494 988.934 230.494C1012.19 230.494 1034.51 211.85 1034.51 178.892V178.515C1034.51 145.369 1012 126.913 988.934 126.913C972.934 126.913 962.702 135.2 955.446 145.558V139.343C955.446 132.94 950.423 127.855 944.097 127.855C937.772 127.855 932.935 132.94 932.935 139.343ZM983.539 210.719C998.981 210.719 1011.63 198.477 1011.63 178.891V178.514C1011.63 159.305 998.795 146.687 983.539 146.687C968.284 146.687 954.889 159.493 954.889 178.514V178.891C954.889 197.912 968.284 210.719 983.539 210.719ZM1115.17 171.735H1064.76C1066.8 156.292 1076.48 145.558 1090.24 145.558C1105.13 145.558 1113.69 157.046 1115.17 171.735ZM1128.2 217.5C1119.27 225.598 1108.11 230.683 1092.85 230.683C1064.38 230.683 1042.43 209.778 1042.43 179.08V178.704C1042.43 150.266 1062.34 126.913 1090.43 126.913C1121.69 126.913 1137.13 152.903 1137.13 175.879C1137.13 182.282 1132.29 186.802 1126.52 186.802H1064.94C1067.36 202.998 1078.71 212.038 1093.22 212.038C1102.71 212.038 1110.15 208.648 1116.48 203.375C1118.15 202.057 1119.64 201.303 1122.24 201.303C1127.27 201.303 1131.17 205.258 1131.17 210.531C1131.17 213.356 1129.87 215.805 1128.2 217.5ZM1172.44 225.872C1173.79 227.957 1176.24 229 1179.8 229H1182.74C1188.51 229 1192.31 226.24 1194.15 220.72L1201.33 200.664H1250.82L1258 220.72C1259.84 226.24 1263.64 229 1269.41 229H1272.9C1276.46 229 1278.91 227.957 1280.26 225.872C1281.74 223.787 1281.8 220.965 1280.45 217.408L1238.68 108.296C1236.84 102.899 1232.98 100.2 1227.09 100.2H1225.62C1219.73 100.2 1215.86 102.899 1214.02 108.296L1172.44 217.408C1171.09 220.965 1171.09 223.787 1172.44 225.872ZM1244.02 180.976H1208.32L1226.35 130.744L1244.02 180.976ZM1289 247.284V138.43C1289 132.027 1293.84 126.942 1300.16 126.942C1306.49 126.942 1311.51 132.027 1311.51 138.43V144.645C1318.77 134.287 1329 126 1345 126C1368.07 126 1390.58 144.456 1390.58 177.602V177.979C1390.58 210.937 1368.25 229.581 1345 229.581C1328.63 229.581 1318.39 221.295 1311.51 212.067V247.284C1311.51 253.687 1306.49 258.584 1300.16 258.584C1294.02 258.584 1289 253.687 1289 247.284ZM1398 138.43V247.284C1398 253.687 1403.02 258.584 1409.16 258.584C1415.49 258.584 1420.51 253.687 1420.51 247.284V212.067C1427.39 221.295 1437.63 229.581 1454 229.581C1477.25 229.581 1499.58 210.937 1499.58 177.979V177.602C1499.58 144.456 1477.07 126 1454 126C1438 126 1427.77 134.287 1420.51 144.645V138.43C1420.51 132.027 1415.49 126.942 1409.16 126.942C1402.84 126.942 1398 132.027 1398 138.43ZM1340.6 209.806C1356.05 209.806 1368.7 197.564 1368.7 177.978V177.601C1368.7 158.392 1355.86 145.774 1340.6 145.774C1325.35 145.774 1311.95 158.58 1311.95 177.601V177.978C1311.95 196.999 1325.35 209.806 1340.6 209.806ZM1477.7 177.978C1477.7 197.564 1465.05 209.806 1449.6 209.806C1434.35 209.806 1420.95 196.999 1420.95 177.978V177.601C1420.95 158.58 1434.35 145.774 1449.6 145.774C1464.86 145.774 1477.7 158.392 1477.7 177.601V177.978Z" fill="black"/>
+<g clip-path="url(#clip0_512_1393)">
+<path d="M365 175C365 96.0233 300.977 32 222 32C143.023 32 79 96.0233 79 175C79 253.977 143.023 318 222 318C300.977 318 365 253.977 365 175Z" fill="#0079FF"/>
+<path d="M222 84.4333C272.018 84.4333 312.567 124.941 312.567 174.911C312.567 224.882 272.019 265.39 222 265.39C212.97 265.39 204.252 264.064 196.022 261.606L165.185 279.867V245.369C144.603 228.783 131.433 203.386 131.433 174.912C131.433 124.942 171.981 84.4333 222 84.4333ZM265.842 189.524C263.047 188.668 260.105 190.344 259.281 193.165C254.474 209.838 239.146 221.483 222.001 221.483C204.855 221.483 189.515 209.837 184.714 193.165C183.896 190.344 180.99 188.669 178.148 189.524C175.335 190.356 173.729 193.334 174.546 196.167C180.654 217.372 200.177 232.2 222 232.2C243.824 232.2 263.335 217.372 269.455 196.167C270.272 193.334 268.654 190.356 265.842 189.524Z" fill="url(#paint0_linear_512_1393)"/>
+</g>
+<defs>
+<linearGradient id="paint0_linear_512_1393" x1="159.451" y1="117.327" x2="292.509" y2="223.659" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="#E8F3FF"/>
+</linearGradient>
+<clipPath id="clip0_512_1393">
+<rect width="286" height="286" fill="white" transform="translate(79 32)"/>
+</clipPath>
+</defs>
+</svg>

package/plugin/commands/client-summary.md

@@ -0,0 +1,14 @@
+---
+description: Summarize a Teletype client's profile, notes, and recent requests
+argument-hint: "<name | phone | email | client_id>"
+---
+
+Client summary for: $ARGUMENTS
+
+1. Call `lookup_client_profile` with that client.
+2. Create a short summary:
+   - Name and contact details
+   - Tags and custom fields (segment, order number)
+   - Operator notes
+   - History and status of recent requests
+   - Recommendations for further work with the client.

package/plugin/commands/draft-reply.md

@@ -0,0 +1,13 @@
+---
+description: Read a Teletype conversation and draft a reply for approval
+argument-hint: "<dialog_id> [instructions]"
+---
+
+Preparing a response to the Teletype conversation from: $ARGUMENTS
+
+1. Call `read_conversation_thread` for that dialog to read the recent messages.
+2. If needed, call `lookup_client_profile` for context.
+3. Draft a clear, empathetic reply in the language requested by the user or used by the client. Apply any extra instructions from the arguments.
+4. Show the draft to the user before calling `send_reply_to_client`. Sending requires `confirm: true` and the user's explicit approval.
+
+Follow the `teletype-support` skill rules for dry-run and delivery reporting.

package/plugin/commands/escalate-issue.md

@@ -0,0 +1,15 @@
+---
+description: Create a structured bug report or escalation from a Teletype conversation
+argument-hint: "<dialog_id> [component]"
+---
+
+Escalation from the Teletype conversation: $ARGUMENTS
+
+1. Call `read_conversation_thread` for that dialog.
+2. Write a bug report with:
+   - Component (from the arguments, or infer it and say so)
+   - The issue as reported by the client
+   - Reproduction steps, if known
+   - Expected and actual behavior
+   - Client environment, including browser, OS, screenshots, and links
+   - A link to the Teletype conversation.

package/plugin/commands/shift-handover.md

@@ -0,0 +1,10 @@
+---
+description: Prepare a support shift handover from Teletype data
+argument-hint: "[channel]"
+---
+
+Support shift report for the Teletype project.
+
+1. Call `get_project_status` with `aspect: "all"` for balance, operator availability, API status, and channel issues.
+2. Call `find_conversations` with `status: "unanswered"` and `limit: 20` for the queue. Focus on the channel from: $ARGUMENTS, if given.
+3. Prepare a shift handover covering project status, available operators, unanswered conversations with links, and risks for the next shift.

package/plugin/commands/triage-inbox.md

@@ -0,0 +1,13 @@
+---
+description: Triage unanswered Teletype conversations by urgency and suggest next actions
+argument-hint: "[channel] [limit]"
+---
+
+Triage the queue of unanswered Teletype requests.
+
+1. Call `find_conversations` with `status: "unanswered"`. Apply a channel or limit from: $ARGUMENTS. Default limit: 10.
+2. For each conversation, study the client's last message and the wait time.
+3. Classify urgency: 🔴 Critical (complaints, payment failures, VIP clients), 🟡 Standard questions (delivery, consultation), 🟢 Low priority (information requests).
+4. Show a short summary table with links to dialogs and recommended next actions. Draft nothing and send nothing yet.
+
+Follow the `teletype-support` skill rules for links, confirmation, and dry-run.

package/plugin/mcp.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "teletype": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "teletype-mcp-server@0.1.1", "--stdio"]
+    }
+  }
+}

package/plugin/plugin.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "teletype",
+  "version": "0.1.1",
+  "description": "Teletype support tools and workflows: triage the inbox, send replies safely, summarize clients, escalate issues, hand over shifts.",
+  "author": {
+    "name": "Teletype-App",
+    "url": "https://github.com/Teletype-App",
+    "email": "p@teletype.app"
+  },
+  "repository": "https://github.com/Teletype-App/teletype-mcp-server",
+  "license": "MIT",
+  "keywords": ["mcp", "teletype", "customer-support", "messaging", "omnichat"],
+  "homepage": "https://github.com/Teletype-App/teletype-mcp-server/tree/main/plugin"
+}

package/plugin/skills/teletype-support/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: teletype-support
-description: Support workflows for the Teletype MCP server: triage the unanswered inbox, draft and send replies safely, summarize clients, escalate issues, and prepare shift handovers. Use when the task mentions Teletype conversations, the support queue, operator work, or client follow-up.
+description: "Support workflows for the Teletype MCP server: triage the unanswered inbox, draft and send replies safely, summarize clients, escalate issues, and prepare shift handovers. Use when the task mentions Teletype conversations, the support queue, operator work, or client follow-up."
 ---
 
 # Teletype support workflows
@@ -9,6 +9,8 @@ Regulations for working with a Teletype support project through its MCP tools. E
 
 ## Before any work
 
+If Teletype tools are absent, read [connection instructions](references/installation.md) and help the user configure the MCP server. Installing this skill alone does not connect a project. Never request the project token in chat.
+
 1. If the tool list looks unexpected or a call fails with a policy error, call `get_capabilities` once. It reports the project identity, read-only mode, and active toolsets.
 2. Read tools (`find_conversations`, `find_messages`, `list_clients`, `lookup_client_profile`, `read_conversation_thread`, `read_client_history`, `list_workspace_metadata`, `get_project_status`) are safe to call whenever the task needs them. For old message text, continue `find_messages` through pages while `has_more` is true.
 3. Write tools require both `confirm: true` in the arguments and the user's explicit approval. "Send it" approves one specific message, not a batch.