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

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/commands.d.ts

@@ -6,6 +6,7 @@ interface StartOpts extends CliOverrides {
     name?: string;
     skipPreflight?: boolean;
     agent: AgentType;
+    dir?: string;
 }
 export declare function start(opts: StartOpts): Promise<void>;
 interface StatusOpts extends CliOverrides {

package/dist/cli/commands.js

@@ -54,7 +54,7 @@ const out = __importStar(require("./output"));
 const PACKAGE_ROOT = (0, path_1.resolve)(__dirname, '..', '..');
 async function start(opts) {
     const config = (0, config_1.getConfig)(opts);
-    const workDir = process.cwd();
+    const workDir = opts.dir || process.cwd();
     if (!opts.skipPreflight) {
         const result = await (0, preflight_1.runPreflight)({
             dir: workDir,
@@ -177,6 +177,7 @@ async function status(opts) {
                 branch: meta.gitBranch || '',
                 host: meta.hostname || '',
                 conductor: meta.isConductor || false,
+                agentType: meta.agentType || 'claude',
             });
         }
         catch {
@@ -209,8 +210,9 @@ async function status(opts) {
         });
         for (const s of members) {
             const role = s.conductor ? out.yellow(' (conductor)') : '';
+            const agent = s.agentType === 'copilot' ? out.dim(' [copilot]') : '';
             const name = out.bold(s.name);
-            out.log(`  ${name}${role}`);
+            out.log(`  ${name}${role}${agent}`);
             if (s.part)
                 out.log(`    ${out.dim(s.part)}`);
             const details = [s.workDir, s.branch, s.host].filter(Boolean).join('  ');

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/cli.js

@@ -132,6 +132,7 @@ async function main() {
                 name: args.name,
                 skipPreflight: args.skipPreflight,
                 agent: args.agent ?? 'claude',
+                dir: args.dir,
                 ...overrides,
             });
             break;
@@ -142,6 +143,7 @@ async function main() {
                 name: args.name,
                 skipPreflight: args.skipPreflight,
                 agent: args.agent ?? 'claude',
+                dir: args.dir,
                 ...overrides,
             });
             break;

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/dist/server.js

@@ -113,6 +113,7 @@ async function main() {
     const workflowId = isConductor
         ? (0, config_1.conductorWorkflowId)(config.ensemble)
         : `claude-session-${config.ensemble}-${playerId}`;
+    const isBridgeMode = process.env[config_1.ENV.BRIDGE_MODE] === '1';
     const sessionInput = {
         metadata: {
             playerId,
@@ -122,6 +123,7 @@ async function main() {
             gitRoot,
             gitBranch,
             isConductor,
+            agentType: isBridgeMode ? 'copilot' : 'claude',
         },
         autoSummary: `Session in ${path.basename(workDir)}`,
     };
@@ -177,14 +179,13 @@ async function main() {
     (0, set_part_1.registerSetPartTool)(mcpServer, handle);
     (0, set_name_1.registerSetNameTool)(mcpServer, client, config, handle, getPlayerId, setPlayerId);
     (0, listen_1.registerListenTool)(mcpServer, handle);
-    (0, recruit_1.registerRecruitTool)(mcpServer, client, config, getPlayerId);
+    (0, recruit_1.registerRecruitTool)(mcpServer, client, config, getPlayerId, isBridgeMode ? 'copilot' : 'claude');
     (0, report_1.registerReportTool)(mcpServer, client, config, getPlayerId);
     (0, terminate_1.registerTerminateTool)(mcpServer, client, config, getPlayerId);
     // Start message poller — push messages into Claude Code via channel notifications.
     // Skip when running under the Copilot bridge: the bridge has its own poller that
     // injects messages via sendAndWait. If both pollers run, this one wins the race and
     // sends messages via notifications/claude/channel — which Copilot doesn't understand.
-    const isBridgeMode = process.env[config_1.ENV.BRIDGE_MODE] === '1';
     const stopPoller = isBridgeMode
         ? () => { } // no-op — bridge handles message delivery
         : (0, channel_1.startMessagePoller)(handle, async (messages) => {

package/dist/tools/ensemble.js

@@ -67,6 +67,7 @@ function registerEnsembleTool(server, client, config, getPlayerId, ownWorkflowId
                         gitRoot: metadata.gitRoot,
                         gitBranch: metadata.gitBranch,
                         isConductor: metadata.isConductor,
+                        agentType: metadata.agentType || 'claude',
                         isYou: metadata.playerId === getPlayerId(),
                     });
                 }
@@ -90,6 +91,7 @@ function registerEnsembleTool(server, client, config, getPlayerId, ownWorkflowId
             const tags = [
                 p.isYou ? '(you)' : '',
                 p.isConductor ? '(conductor)' : '',
+                p.agentType === 'copilot' ? '[copilot]' : '',
             ].filter(Boolean).join(' ');
             return [
                 `**${p.playerId}** ${tags}`.trim(),

package/dist/tools/recruit.d.ts

@@ -1,4 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Client } from '@temporalio/client';
 import { Config } from '../config';
-export declare function registerRecruitTool(server: McpServer, client: Client, config: Config, getPlayerId: () => string): void;
+import { AgentType } from '../types';
+export declare function registerRecruitTool(server: McpServer, client: Client, config: Config, getPlayerId: () => string, ownAgentType?: AgentType): void;

package/dist/tools/recruit.js

@@ -10,16 +10,17 @@ const log = (...args) => console.error('[claude-tempo:recruit]', ...args);
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function registerRecruitTool(server, client, config, getPlayerId) {
-    (0, helpers_1.defineTool)(server, 'recruit', 'Start a new named session in a directory. Rejects if the name is already active. Supports Claude Code or Copilot CLI agents.', {
+function registerRecruitTool(server, client, config, getPlayerId, ownAgentType = 'claude') {
+    (0, helpers_1.defineTool)(server, 'recruit', `Start a new named session in a directory. Rejects if the name is already active. Supports Claude Code or Copilot CLI agents. Defaults to "${ownAgentType}" (same as this session).`, {
         workDir: zod_1.z.string().describe('The working directory for the new session'),
         name: zod_1.z.string().describe('Name for the new session'),
         initialMessage: zod_1.z.string().optional()
             .describe('Optional task or message for the new session (sent after it sets its name)'),
-        agent: zod_1.z.enum(['claude', 'copilot']).default('claude')
-            .describe('Which agent to use: "claude" (default) or "copilot" (GitHub Copilot CLI via SDK)'),
+        agent: zod_1.z.enum(['claude', 'copilot']).optional()
+            .describe(`Which agent to use (default: "${ownAgentType}", same as this session)`),
     }, async (args) => {
-        const { workDir, name, initialMessage, agent } = args;
+        const { workDir, name, initialMessage } = args;
+        const agent = args.agent || ownAgentType;
         // Validate name to prevent search attribute query injection
         if (!/^[a-zA-Z0-9_-]+$/.test(name)) {
             return {

package/dist/types.d.ts

@@ -7,6 +7,7 @@ export interface SessionMetadata {
     gitRoot?: string;
     gitBranch?: string;
     isConductor: boolean;
+    agentType?: AgentType;
 }
 export interface SessionInput {
     metadata: SessionMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-tempo",
-  "version": "0.3.0-beta.1",
+  "version": "0.3.0-beta.3",
   "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": [