claude-tempo 0.3.0-beta.1 → 0.3.0-beta.2

package/README.md

@@ -4,31 +4,7 @@ Multi-session [Claude Code](https://claude.ai/code) coordination via [Temporal](
 
 Multiple Claude Code sessions discover each other, exchange messages in real time, and coordinate work — across machines, not just localhost.
 
-```
-  You (CLI / Discord / Telegram / Claude Code)
-    │
-    ▼
-┌─────────────────────────────────────────────┐
-│              Temporal Server                 │
-│                                             │
-│  ┌───────────┐                              │
-│  │ Conductor │──cue──┬──────┬──────┐        │
-│  └───────────┘       │      │      │        │
-│                      ▼      ▼      ▼        │
-│                   ┌────┐ ┌────┐ ┌────┐      │
-│                   │ A  │ │ B  │ │ C  │      │
-│                   └──┬─┘ └──┬─┘ └──┬─┘      │
-│                      │      │      │        │
-└──────────────────────┼──────┼──────┼────────┘
-                       │      │      │
-              ┌────────┘      │      └────────┐
-              ▼               ▼               ▼
-         ┌─────────┐    ┌─────────┐    ┌─────────┐
-         │ Host 1  │    │ Host 1  │    │ Host 2  │
-         │ Claude  │    │ Claude  │    │ Claude  │
-         │ Session │    │ Session │    │ Session │
-         └─────────┘    └─────────┘    └─────────┘
-```
+Each Claude Code session registers as a **player** in Temporal. Players discover each other with `ensemble`, exchange messages with `cue`, and coordinate work — across machines, not just localhost. An optional **conductor** orchestrates the group and connects to external interfaces like Discord, Telegram, or a dashboard.
 
 ## Installation
 

package/dist/cli/config-command.js

@@ -42,6 +42,7 @@ const config_1 = require("../config");
 const connection_1 = require("../connection");
 const config_2 = require("../config");
 const out = __importStar(require("./output"));
+const SECRET_KEYS = new Set(['temporalApiKey']);
 /** Read a line from stdin with a prompt and optional default value. */
 function ask(prompt, defaultVal, mask = false) {
     return new Promise((resolve) => {
@@ -178,21 +179,24 @@ function configSet(key, value) {
 /** Show current config: `claude-tempo config show` */
 function configShow() {
     out.heading('claude-tempo config');
-    const config = (0, config_1.loadConfigFile)();
-    const resolved = (0, config_2.getConfig)();
-    const rows = [
-        ['temporalAddress', resolved.temporalAddress, config.temporalAddress || ''],
-        ['temporalNamespace', resolved.temporalNamespace, config.temporalNamespace || ''],
-        ['temporalApiKey', resolved.temporalApiKey ? '****' : '(not set)', config.temporalApiKey ? '****' : ''],
-        ['temporalTlsCertPath', resolved.temporalTlsCertPath || '(not set)', config.temporalTlsCertPath || ''],
-        ['temporalTlsKeyPath', resolved.temporalTlsKeyPath || '(not set)', config.temporalTlsKeyPath || ''],
+    const { config, sources } = (0, config_1.getConfigWithSources)();
+    const keys = [
+        { key: 'temporalAddress', configKey: 'temporalAddress' },
+        { key: 'temporalNamespace', configKey: 'temporalNamespace' },
+        { key: 'temporalApiKey', configKey: 'temporalApiKey' },
+        { key: 'temporalTlsCertPath', configKey: 'temporalTlsCertPath' },
+        { key: 'temporalTlsKeyPath', configKey: 'temporalTlsKeyPath' },
     ];
     out.log(`  Config file: ${out.dim(config_1.CONFIG_FILE_PATH)}`);
     console.log();
-    out.log(`  ${'Key'.padEnd(22)} ${'Resolved'.padEnd(35)} ${out.dim('Config file')}`);
-    out.log(`  ${'─'.repeat(22)} ${'─'.repeat(35)} ${'─'.repeat(20)}`);
-    for (const [key, resolved, file] of rows) {
-        out.log(`  ${key.padEnd(22)} ${resolved.padEnd(35)} ${out.dim(file || '-')}`);
+    out.log(`  ${'Key'.padEnd(22)} ${'Value'.padEnd(30)} ${out.dim('Source')}`);
+    out.log(`  ${'─'.repeat(22)} ${'─'.repeat(30)} ${'─'.repeat(15)}`);
+    for (const { key, configKey } of keys) {
+        const value = config[configKey];
+        const source = sources[configKey];
+        const isSecret = SECRET_KEYS.has(key);
+        const display = !value ? '(not set)' : isSecret ? '****' : value;
+        out.log(`  ${key.padEnd(22)} ${display.padEnd(30)} ${out.dim(source)}`);
     }
     console.log();
 }

package/dist/config.d.ts

@@ -70,6 +70,16 @@ export interface CliOverrides {
  *   CLI flag > env var > claude-tempo config file > temporal CLI config > defaults
  */
 export declare function getConfig(overrides?: CliOverrides): Config;
+export type ConfigSource = 'flag' | 'env' | 'config' | 'temporal-cli' | 'default' | 'none';
+export interface ConfigWithSources {
+    config: Config;
+    sources: Record<string, ConfigSource>;
+}
+/**
+ * Like getConfig(), but also returns which source each value came from.
+ * Used by `claude-tempo config show` to help users debug.
+ */
+export declare function getConfigWithSources(overrides?: CliOverrides): ConfigWithSources;
 /** Build a workflow ID for a player session: claude-session-{ensemble}-{playerId} */
 export declare function sessionWorkflowId(ensemble: string, playerId: string): string;
 /** Build a workflow ID for a conductor: claude-session-{ensemble}-conductor */

package/dist/config.js

@@ -6,6 +6,7 @@ exports.saveConfigFile = saveConfigFile;
 exports.loadTemporalCliConfig = loadTemporalCliConfig;
 exports.parseTemporalYaml = parseTemporalYaml;
 exports.getConfig = getConfig;
+exports.getConfigWithSources = getConfigWithSources;
 exports.sessionWorkflowId = sessionWorkflowId;
 exports.conductorWorkflowId = conductorWorkflowId;
 const fs_1 = require("fs");
@@ -182,6 +183,50 @@ function getConfig(overrides = {}) {
         ensemble: process.env[exports.ENV.ENSEMBLE] ?? 'default',
     };
 }
+/**
+ * Like getConfig(), but also returns which source each value came from.
+ * Used by `claude-tempo config show` to help users debug.
+ */
+function getConfigWithSources(overrides = {}) {
+    const temporalCli = loadTemporalCliConfig();
+    const configFile = loadConfigFile();
+    function resolveWithSource(key, cliVal, envKey, fileVal, temporalCliVal, defaultVal) {
+        if (cliVal)
+            return { value: cliVal, source: 'flag' };
+        if (process.env[envKey])
+            return { value: process.env[envKey], source: 'env' };
+        if (fileVal)
+            return { value: fileVal, source: 'config' };
+        if (temporalCliVal)
+            return { value: temporalCliVal, source: 'temporal-cli' };
+        if (defaultVal)
+            return { value: defaultVal, source: 'default' };
+        return { value: undefined, source: 'none' };
+    }
+    const address = resolveWithSource('temporalAddress', overrides.temporalAddress, exports.ENV.TEMPORAL_ADDRESS, configFile.temporalAddress, temporalCli.temporalAddress, 'localhost:7233');
+    const namespace = resolveWithSource('temporalNamespace', overrides.temporalNamespace, exports.ENV.TEMPORAL_NAMESPACE, configFile.temporalNamespace, temporalCli.temporalNamespace, 'default');
+    const apiKey = resolveWithSource('temporalApiKey', overrides.temporalApiKey, exports.ENV.TEMPORAL_API_KEY, configFile.temporalApiKey, temporalCli.temporalApiKey);
+    const tlsCert = resolveWithSource('temporalTlsCertPath', overrides.temporalTlsCertPath, exports.ENV.TEMPORAL_TLS_CERT_PATH, configFile.temporalTlsCertPath, temporalCli.temporalTlsCertPath);
+    const tlsKey = resolveWithSource('temporalTlsKeyPath', overrides.temporalTlsKeyPath, exports.ENV.TEMPORAL_TLS_KEY_PATH, configFile.temporalTlsKeyPath, temporalCli.temporalTlsKeyPath);
+    return {
+        config: {
+            temporalAddress: address.value,
+            temporalNamespace: namespace.value,
+            temporalApiKey: apiKey.value,
+            temporalTlsCertPath: tlsCert.value,
+            temporalTlsKeyPath: tlsKey.value,
+            taskQueue: process.env[exports.ENV.TASK_QUEUE] ?? 'claude-tempo',
+            ensemble: process.env[exports.ENV.ENSEMBLE] ?? 'default',
+        },
+        sources: {
+            temporalAddress: address.source,
+            temporalNamespace: namespace.source,
+            temporalApiKey: apiKey.source,
+            temporalTlsCertPath: tlsCert.source,
+            temporalTlsKeyPath: tlsKey.source,
+        },
+    };
+}
 /** Build a workflow ID for a player session: claude-session-{ensemble}-{playerId} */
 function sessionWorkflowId(ensemble, playerId) {
     return `claude-session-${ensemble}-${playerId}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-tempo",
-  "version": "0.3.0-beta.1",
+  "version": "0.3.0-beta.2",
   "description": "MCP server for multi-session Claude Code coordination via Temporal",
   "repository": {
     "type": "git",
@@ -26,6 +26,10 @@
       "types": "./dist/workflows/signals.d.ts",
       "default": "./dist/workflows/signals.js"
     },
+    "./connection": {
+      "types": "./dist/connection.d.ts",
+      "default": "./dist/connection.js"
+    },
     "./workflow-bundle": "./workflow-bundle.js",
     "./package.json": "./package.json"
   },
@@ -60,7 +64,8 @@
       "types": ["dist/types.d.ts"],
       "config": ["dist/config.d.ts"],
       "spawn": ["dist/spawn.d.ts"],
-      "signals": ["dist/workflows/signals.d.ts"]
+      "signals": ["dist/workflows/signals.d.ts"],
+      "connection": ["dist/connection.d.ts"]
     }
   },
   "files": [