@ran-sh/dsh-crew 0.3.0

package/src/hub-client.mjs

@@ -0,0 +1,132 @@
+// Client for the in-host workers-hub jobs API. When a DSH web instance with the
+// dsh-crew bundle is running, jobs run inside it (sessions visible in the
+// Web UI); otherwise the MCP server falls back to standalone runtimes.
+
+import { readGlobalConfig } from './install/install.mjs';
+import { evaluateHubHandshake, HUB_COMPATIBILITY_CODES } from './runtime-identity.mjs';
+import { buildReadinessMatrix } from './readiness-matrix.mjs';
+import { isBoundedMachineCode } from './structured-error-code.mjs';
+
+const BASE = (process.env.DSH_CREW_HUB ?? readGlobalConfig().hub_url).replace(/\/$/, '');
+const API = `${BASE}/_dsh/dsh-crew`;
+
+export const HUB_REQUEST_FAILED = 'HUB_REQUEST_FAILED';
+
+const EMPTY_STATUS = Object.freeze({
+  reachable: false,
+  compatible: false,
+  service: null,
+  runtime_version: null,
+  protocol_version: null,
+  capabilities: [],
+  missing_capabilities: [],
+  code: HUB_COMPATIBILITY_CODES.UNREACHABLE,
+});
+
+let lastProbe = { at: 0, status: EMPTY_STATUS };
+
+function withReadiness(status) {
+  return {
+    ...status,
+    readiness_matrix: buildReadinessMatrix({ hubCompatibility: status }),
+  };
+}
+
+function cacheStatus(status) {
+  const observed = withReadiness(status);
+  lastProbe = { at: Date.now(), status: observed };
+  return observed;
+}
+
+async function fetchJson(path) {
+  const res = await fetch(`${API}${path}`, { signal: AbortSignal.timeout(800) });
+  let body;
+  try { body = await res.json(); } catch { body = null; }
+  return { res, body };
+}
+
+/**
+ * Probe reachability and compatibility as separate contracts.
+ *
+ * /ping is intentionally legacy-compatible and proves only that a dsh-crew Hub
+ * is alive. /runtime is the v0.3 compatibility handshake. A legacy Hub that
+ * lacks /runtime is therefore reachable-but-incompatible instead of looking
+ * offline or being silently treated as current.
+ */
+export async function hubStatus({ force = false } = {}) {
+  if (!force && Date.now() - lastProbe.at < 10_000) return lastProbe.status;
+  try {
+    const ping = await fetchJson('/ping');
+    if (!ping.res.ok) {
+      return cacheStatus({
+        ...EMPTY_STATUS,
+        reachable: true,
+        code: HUB_COMPATIBILITY_CODES.HTTP_ERROR,
+        http_status: ping.res.status,
+        endpoint: 'ping',
+      });
+    }
+    if (ping.body?.service !== 'dsh-crew-hub') {
+      return cacheStatus(evaluateHubHandshake(ping.body));
+    }
+
+    const runtime = await fetchJson('/runtime');
+    if (runtime.res.status === 404) {
+      return cacheStatus({
+        ...EMPTY_STATUS,
+        reachable: true,
+        service: 'dsh-crew-hub',
+        code: HUB_COMPATIBILITY_CODES.PROTOCOL_MISSING,
+        endpoint: 'runtime',
+      });
+    }
+    if (!runtime.res.ok) {
+      return cacheStatus({
+        ...EMPTY_STATUS,
+        reachable: true,
+        service: 'dsh-crew-hub',
+        code: HUB_COMPATIBILITY_CODES.HTTP_ERROR,
+        http_status: runtime.res.status,
+        endpoint: 'runtime',
+      });
+    }
+    return cacheStatus(evaluateHubHandshake(runtime.body));
+  } catch {
+    return cacheStatus(EMPTY_STATUS);
+  }
+}
+
+export async function hubAvailable() {
+  return (await hubStatus()).compatible;
+}
+
+function structuredCode(body) {
+  if (isBoundedMachineCode(body?.code)) return body.code;
+  if (isBoundedMachineCode(body?.policyCode)) return body.policyCode;
+  return null;
+}
+
+/** Build a bounded Hub request error without copying arbitrary response fields. */
+export function hubRequestError(body, status) {
+  const err = new Error(body?.error ?? `hub request failed (${status})`);
+  err.code = structuredCode(body) ?? HUB_REQUEST_FAILED;
+  return err;
+}
+
+async function call(path, init) {
+  const res = await fetch(`${API}${path}`, init);
+  const body = await res.json();
+  if (!res.ok || body.ok === false) throw hubRequestError(body, res.status);
+  return body;
+}
+
+export const hub = {
+  spawn: (spec) => call('/jobs', {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(spec),
+  }).then((b) => b.job),
+  list: () => call('/jobs').then((b) => b.jobs),
+  get: (id, waitSeconds = 0) => call(`/jobs/${id}?wait=${waitSeconds}`).then((b) => b.job),
+  cancel: (id) => call(`/jobs/${id}/cancel`, { method: 'POST' }).then((b) => b.job),
+};

package/src/hub-compatibility.mjs

@@ -0,0 +1,49 @@
+// Pure execution-mode decision for the Hub compatibility contract.
+// Transport probing lives in hub-client.mjs; this module only decides whether
+// a session may use Hub, intentionally fall back, or must fail closed.
+
+import { HUB_COMPATIBILITY_CODES } from './runtime-identity.mjs';
+
+export function hubCompatibilityMessage(status = {}) {
+  const code = status.code ?? 'HUB_INCOMPATIBLE';
+  if (!status.reachable) return `DSH workers hub is not reachable (${code}).`;
+  const detail = status.missing_capabilities?.length
+    ? `; missing capabilities: ${status.missing_capabilities.join(', ')}`
+    : '';
+  return `DSH workers hub is reachable but incompatible (${code}${detail}). Update/restart the Hub plugin before using Hub execution.`;
+}
+
+export function resolveHubExecutionMode(requestedMode = 'auto', status = {}) {
+  if (requestedMode === 'standalone') {
+    return { ok: true, mode: 'standalone', reason: 'explicit-standalone' };
+  }
+
+  if (status.compatible === true) {
+    return { ok: true, mode: 'hub', reason: 'compatible-hub' };
+  }
+
+  if (status.reachable === true) {
+    return {
+      ok: false,
+      code: status.code ?? 'HUB_INCOMPATIBLE',
+      error: hubCompatibilityMessage(status),
+      hub: status,
+    };
+  }
+
+  if (requestedMode === 'hub') {
+    return {
+      ok: false,
+      code: status.code ?? HUB_COMPATIBILITY_CODES.UNREACHABLE,
+      error: 'Session mode is "hub" but the DSH workers hub is not reachable.',
+      hub: status,
+    };
+  }
+
+  return {
+    ok: true,
+    mode: 'standalone',
+    reason: 'hub-unreachable-fallback',
+    hub: status,
+  };
+}

package/src/i18n.mjs

@@ -0,0 +1,19 @@
+// Server-side locale for strings that reach the user: connectivity-test
+// reports, model-list labels, error messages and the vision transcription.
+//
+// The panel owns the authoritative locale (DSH's setting may be absent, in
+// which case the browser decides), so it passes `lang` with every request and
+// the hub calls setLang(). The host's durable setting seeds the initial value
+// for paths with no request behind them, such as the pasted-image pre-step.
+
+let LANG = 'en';
+
+export function setLang(lang) {
+  if (lang === 'zh' || lang === 'en') LANG = lang;
+  return LANG;
+}
+
+export function getLang() { return LANG; }
+
+/** Pick the string for the active locale. Both branches are cheap literals. */
+export function tr(zh, en) { return LANG === 'zh' ? zh : en; }

package/src/install/cli.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// Usage: node src/install/cli.mjs <claude|codex|all|hud|uninstall-claude|uninstall-codex|uninstall-all> [--statusline] [--project]
+
+import { installClaudeCode, installCodex, uninstallClaudeCode, uninstallCodex, installHudSegment } from './install.mjs';
+
+const cmd = process.argv[2];
+const flags = new Set(process.argv.slice(3));
+const opts = { statusline: flags.has('--statusline'), scope: flags.has('--project') ? 'project' : 'user' };
+
+const run = {
+  claude: () => [installClaudeCode(opts)],
+  codex: () => [installCodex(opts)],
+  all: () => [installClaudeCode(opts), installHudSegment(opts), installCodex(opts)],
+  'uninstall-claude': () => [uninstallClaudeCode(opts)],
+  'uninstall-codex': () => [uninstallCodex(opts)],
+  'uninstall-all': () => [uninstallClaudeCode(opts), uninstallCodex(opts)],
+  hud: () => [installHudSegment(opts)],
+}[cmd];
+
+if (!run) {
+  console.error('usage: cli.mjs <claude|codex|all|hud|uninstall-claude|uninstall-codex|uninstall-all> [--statusline] [--project]');
+  process.exit(1);
+}
+for (const p of run()) {
+  const r = await p;
+  for (const a of r.actions) console.log('•', a);
+}
+console.log('done.');