mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-03-05 16:13:08 +08:00
feat: Enhance team messaging system with new operations and data handling
- Added support for new message type 'state_update' in TeamMessageType. - Updated TeamMessageFeed component to handle both legacy and new reference formats. - Modified CLI options to clarify usage and added new commands for broadcasting messages and retrieving role states. - Implemented new command 'get_state' to read role state from meta.json. - Enhanced team message logging to auto-generate summaries and handle structured data. - Improved backward compatibility by enriching team metadata from legacy files. - Refactored message handling functions to streamline operations and improve clarity.
This commit is contained in:
catlog22
@@ -358,15 +358,15 @@ export function run(argv: string[]): void {
|
||||
program
|
||||
.command('team [subcommand] [args...]')
|
||||
.description('Team message bus for Agent Team communication')
|
||||
.option('--team <name>', 'Team name')
|
||||
.option('--team <name>', 'Session ID (e.g., TLS-my-project-2026-02-27)')
|
||||
.option('--from <role>', 'Sender role name')
|
||||
.option('--to <role>', 'Recipient role name')
|
||||
.option('--to <role>', 'Recipient role name (default: coordinator)')
|
||||
.option('--type <type>', 'Message type')
|
||||
.option('--summary <text>', 'One-line summary')
|
||||
.option('--ref <path>', 'File path reference')
|
||||
.option('--summary <text>', 'One-line summary (auto-generated if omitted)')
|
||||
.option('--data <json>', 'JSON structured data')
|
||||
.option('--id <id>', 'Message ID (for read)')
|
||||
.option('--id <id>', 'Message ID (for read/delete)')
|
||||
.option('--last <n>', 'Last N messages (for list)')
|
||||
.option('--role <role>', 'Role name (for get_state)')
|
||||
.option('--json', 'Output as JSON')
|
||||
.action((subcommand, args, options) => teamCommand(subcommand, args, options));
|
||||
|
||||
|
||||
@@ -3,12 +3,14 @@
|
||||
* Delegates to team-msg.ts handler for JSONL-based persistent messaging
|
||||
*
|
||||
* Commands:
|
||||
* ccw team log --team <session-id> --from <role> --to <role> --type <type> --summary "..."
|
||||
* ccw team read --team <session-id> --id <MSG-NNN>
|
||||
* ccw team list --team <session-id> [--from <role>] [--to <role>] [--type <type>] [--last <n>]
|
||||
* ccw team status --team <session-id>
|
||||
* ccw team delete --team <session-id> --id <MSG-NNN>
|
||||
* ccw team clear --team <session-id>
|
||||
* ccw team log --team <session-id> --from <role> [--to <role>] [--type <type>] [--summary "..."]
|
||||
* ccw team broadcast --team <session-id> --from <role> [--type <type>] [--summary "..."]
|
||||
* ccw team get_state --team <session-id> [--role <role>]
|
||||
* ccw team read --team <session-id> --id <MSG-NNN>
|
||||
* ccw team list --team <session-id> [--from <role>] [--to <role>] [--type <type>] [--last <n>]
|
||||
* ccw team status --team <session-id>
|
||||
* ccw team delete --team <session-id> --id <MSG-NNN>
|
||||
* ccw team clear --team <session-id>
|
||||
*/
|
||||
|
||||
import chalk from 'chalk';
|
||||
@@ -24,6 +26,7 @@ interface TeamOptions {
|
||||
data?: string;
|
||||
id?: string;
|
||||
last?: string;
|
||||
role?: string;
|
||||
json?: boolean;
|
||||
}
|
||||
|
||||
@@ -55,6 +58,7 @@ export async function teamCommand(
|
||||
if (options.ref) params.ref = options.ref;
|
||||
if (options.id) params.id = options.id;
|
||||
if (options.last) params.last = parseInt(options.last, 10);
|
||||
if (options.role) params.role = options.role;
|
||||
|
||||
// Parse --data as JSON
|
||||
if (options.data) {
|
||||
@@ -82,17 +86,19 @@ export async function teamCommand(
|
||||
|
||||
// Formatted output by operation
|
||||
switch (subcommand) {
|
||||
case 'log': {
|
||||
case 'log':
|
||||
case 'broadcast': {
|
||||
const r = result.result as { id: string; message: string };
|
||||
console.log(chalk.green(`✓ ${r.message}`));
|
||||
break;
|
||||
}
|
||||
case 'read': {
|
||||
const msg = result.result as { id: string; ts: string; from: string; to: string; type: string; summary: string; ref?: string; data?: unknown };
|
||||
const msg = result.result as { id: string; ts: string; from: string; to: string; type: string; summary: string; ref?: string; data?: Record<string, unknown> };
|
||||
console.log(chalk.bold(`${msg.id} [${msg.ts}]`));
|
||||
console.log(` ${chalk.cyan(msg.from)} → ${chalk.yellow(msg.to)} (${msg.type})`);
|
||||
console.log(` ${msg.summary}`);
|
||||
if (msg.ref) console.log(chalk.gray(` ref: ${msg.ref}`));
|
||||
const refPath = msg.ref || (msg.data?.ref as string | undefined);
|
||||
if (refPath) console.log(chalk.gray(` ref: ${refPath}`));
|
||||
if (msg.data) console.log(chalk.gray(` data: ${JSON.stringify(msg.data)}`));
|
||||
break;
|
||||
}
|
||||
@@ -122,6 +128,18 @@ export async function teamCommand(
|
||||
console.log(chalk.green(`✓ ${r.message}`));
|
||||
break;
|
||||
}
|
||||
case 'get_state': {
|
||||
const r = result.result as { role?: string; state?: unknown; role_state?: unknown; message?: string };
|
||||
if (r.message) {
|
||||
console.log(chalk.yellow(r.message));
|
||||
} else if (r.role) {
|
||||
console.log(chalk.bold(`Role: ${r.role}`));
|
||||
console.log(JSON.stringify(r.state, null, 2));
|
||||
} else {
|
||||
console.log(JSON.stringify(r.role_state, null, 2));
|
||||
}
|
||||
break;
|
||||
}
|
||||
default:
|
||||
console.error(chalk.red(`Unknown subcommand: ${subcommand}`));
|
||||
printHelp();
|
||||
@@ -137,7 +155,9 @@ function printHelp(): void {
|
||||
console.log(chalk.bold.cyan('\n CCW Team Message Bus\n'));
|
||||
console.log(' CLI interface for team message logging and retrieval.\n');
|
||||
console.log(' Subcommands:');
|
||||
console.log(chalk.gray(' log Log a team message'));
|
||||
console.log(chalk.gray(' log Log a team message (to defaults to "coordinator", summary auto-generated)'));
|
||||
console.log(chalk.gray(' broadcast Broadcast message to all team members (to="all")'));
|
||||
console.log(chalk.gray(' get_state Read role state from meta.json'));
|
||||
console.log(chalk.gray(' read Read a specific message by ID'));
|
||||
console.log(chalk.gray(' list List recent messages with filters'));
|
||||
console.log(chalk.gray(' status Show team member activity summary'));
|
||||
@@ -147,13 +167,15 @@ function printHelp(): void {
|
||||
console.log(' Required:');
|
||||
console.log(chalk.gray(' --team <session-id> Session ID (e.g., TLS-my-project-2026-02-27), NOT team name'));
|
||||
console.log();
|
||||
console.log(' Log Options:');
|
||||
console.log(chalk.gray(' --from <role> Sender role name'));
|
||||
console.log(chalk.gray(' --to <role> Recipient role name'));
|
||||
console.log(chalk.gray(' --type <type> Message type (plan_ready, impl_complete, etc.)'));
|
||||
console.log(chalk.gray(' --summary <text> One-line summary'));
|
||||
console.log(chalk.gray(' --ref <path> File path reference'));
|
||||
console.log(chalk.gray(' --data <json> JSON structured data'));
|
||||
console.log(' Log/Broadcast Options:');
|
||||
console.log(chalk.gray(' --from <role> Sender role name (required)'));
|
||||
console.log(chalk.gray(' --to <role> Recipient role (default: "coordinator")'));
|
||||
console.log(chalk.gray(' --type <type> Message type (state_update, plan_ready, shutdown, etc.)'));
|
||||
console.log(chalk.gray(' --summary <text> One-line summary (auto-generated if omitted)'));
|
||||
console.log(chalk.gray(' --data <json> JSON structured data. Use data.ref for file paths'));
|
||||
console.log();
|
||||
console.log(' Get State Options:');
|
||||
console.log(chalk.gray(' --role <role> Role name to query (omit for all roles)'));
|
||||
console.log();
|
||||
console.log(' Read/Delete Options:');
|
||||
console.log(chalk.gray(' --id <MSG-NNN> Message ID'));
|
||||
@@ -168,12 +190,11 @@ function printHelp(): void {
|
||||
console.log(chalk.gray(' --json Output as JSON'));
|
||||
console.log();
|
||||
console.log(' Examples:');
|
||||
console.log(chalk.gray(' ccw team log --team TLS-my-project-2026-02-27 --from executor --to coordinator --type impl_complete --summary "Task done"'));
|
||||
console.log(chalk.gray(' ccw team list --team TLS-my-project-2026-02-27 --last 5'));
|
||||
console.log(chalk.gray(' ccw team read --team TLS-my-project-2026-02-27 --id MSG-003'));
|
||||
console.log(chalk.gray(' ccw team status --team TLS-my-project-2026-02-27'));
|
||||
console.log(chalk.gray(' ccw team delete --team TLS-my-project-2026-02-27 --id MSG-003'));
|
||||
console.log(chalk.gray(' ccw team clear --team TLS-my-project-2026-02-27'));
|
||||
console.log(chalk.gray(' ccw team log --team TLS-my-project-2026-02-27 --from planner --to coordinator --type plan_ready --summary "Plan ready" --json'));
|
||||
console.log(chalk.gray(' ccw team log --team TLS-xxx --from executor --type state_update --data \'{"status":"done"}\''));
|
||||
console.log(chalk.gray(' ccw team broadcast --team TLS-xxx --from coordinator --type shutdown'));
|
||||
console.log(chalk.gray(' ccw team get_state --team TLS-xxx --role executor'));
|
||||
console.log(chalk.gray(' ccw team list --team TLS-xxx --last 5'));
|
||||
console.log(chalk.gray(' ccw team read --team TLS-xxx --id MSG-003'));
|
||||
console.log(chalk.gray(' ccw team status --team TLS-xxx'));
|
||||
console.log();
|
||||
}
|
||||
|
||||
@@ -432,13 +432,14 @@ export async function handleTeamRoutes(ctx: RouteContext): Promise<boolean> {
|
||||
const sessionDir = getSessionDir(artifactsTeamName, root);
|
||||
|
||||
if (!existsSync(sessionDir)) {
|
||||
// Check if it's a legacy team with session_id
|
||||
// Check if it's a legacy team with session_id in meta
|
||||
const meta = getEffectiveTeamMeta(artifactsTeamName);
|
||||
if (meta.session_id) {
|
||||
const legacySessionId = (meta as Record<string, unknown>).session_id as string | undefined;
|
||||
if (legacySessionId) {
|
||||
// Legacy team with session_id - redirect to session directory
|
||||
const legacySessionDir = getSessionDir(meta.session_id, root);
|
||||
const legacySessionDir = getSessionDir(legacySessionId, root);
|
||||
if (existsSync(legacySessionDir)) {
|
||||
serveArtifacts(legacySessionDir, meta.session_id, meta, artifactPath, res);
|
||||
serveArtifacts(legacySessionDir, legacySessionId, meta, artifactPath, res);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,12 +2,14 @@
|
||||
* Team Message Bus - JSONL-based persistent message log for Agent Teams
|
||||
*
|
||||
* Operations:
|
||||
* - log: Append a message, returns auto-incremented ID
|
||||
* - read: Read message(s) by ID
|
||||
* - list: List recent messages with optional filters (from/to/type/last N)
|
||||
* - status: Summarize team member activity from message history
|
||||
* - delete: Delete a specific message by ID
|
||||
* - clear: Clear all messages for a team
|
||||
* - log: Append a message (to defaults to "coordinator", summary auto-generated if omitted)
|
||||
* - read: Read message(s) by ID
|
||||
* - list: List recent messages with optional filters (from/to/type/last N)
|
||||
* - status: Summarize team member activity from message history
|
||||
* - delete: Delete a specific message by ID
|
||||
* - clear: Clear all messages for a team
|
||||
* - broadcast: Log a message with to="all"
|
||||
* - get_state: Read role state from meta.json
|
||||
*/
|
||||
|
||||
import { z } from 'zod';
|
||||
@@ -23,8 +25,16 @@ export interface TeamMeta {
|
||||
created_at: string;
|
||||
updated_at: string;
|
||||
archived_at?: string;
|
||||
|
||||
// Pipeline configuration (previously in team-session.json)
|
||||
pipeline_mode?: string;
|
||||
session_id?: string; // Links to .workflow/.team/{session-id}/ artifacts directory
|
||||
pipeline_stages?: string[];
|
||||
team_name?: string;
|
||||
task_description?: string;
|
||||
roles?: string[];
|
||||
|
||||
// Role state snapshot (previously in shared-memory.json)
|
||||
role_state?: Record<string, Record<string, unknown>>;
|
||||
}
|
||||
|
||||
export function getMetaPath(team: string): string {
|
||||
@@ -61,13 +71,32 @@ export function inferTeamStatus(team: string): TeamMeta['status'] {
|
||||
}
|
||||
|
||||
/**
|
||||
* Get effective team meta: reads meta.json or infers from messages.
|
||||
* Get effective team meta: reads meta.json, with fallback to shared-memory.json
|
||||
* and team-session.json for backward compatibility with older sessions.
|
||||
*/
|
||||
export function getEffectiveTeamMeta(team: string): TeamMeta {
|
||||
const meta = readTeamMeta(team);
|
||||
if (meta) return meta;
|
||||
if (meta) {
|
||||
// Enrich from legacy files if role_state/pipeline_mode missing
|
||||
if (!meta.role_state || !meta.pipeline_mode) {
|
||||
const legacyData = readLegacyFiles(team);
|
||||
if (!meta.pipeline_mode && legacyData.pipeline_mode) {
|
||||
meta.pipeline_mode = legacyData.pipeline_mode;
|
||||
}
|
||||
if (!meta.role_state && legacyData.role_state) {
|
||||
meta.role_state = legacyData.role_state;
|
||||
}
|
||||
if (!meta.pipeline_stages && legacyData.pipeline_stages) {
|
||||
meta.pipeline_stages = legacyData.pipeline_stages;
|
||||
}
|
||||
if (!meta.team_name && legacyData.team_name) {
|
||||
meta.team_name = legacyData.team_name;
|
||||
}
|
||||
}
|
||||
return meta;
|
||||
}
|
||||
|
||||
// Infer from messages and directory stat
|
||||
// No meta.json — build from legacy files + inferred status
|
||||
const status = inferTeamStatus(team);
|
||||
const dir = getLogDir(team);
|
||||
let created_at = new Date().toISOString();
|
||||
@@ -80,7 +109,57 @@ export function getEffectiveTeamMeta(team: string): TeamMeta {
|
||||
const lastMsg = messages[messages.length - 1];
|
||||
const updated_at = lastMsg?.ts || created_at;
|
||||
|
||||
return { status, created_at, updated_at };
|
||||
const legacyData = readLegacyFiles(team);
|
||||
|
||||
return {
|
||||
status,
|
||||
created_at,
|
||||
updated_at,
|
||||
...legacyData,
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* Read legacy files (shared-memory.json, team-session.json) for backward compatibility.
|
||||
*/
|
||||
function readLegacyFiles(team: string): Partial<TeamMeta> {
|
||||
const root = getProjectRoot();
|
||||
const sessionDir = join(root, '.workflow', '.team', team);
|
||||
const result: Partial<TeamMeta> = {};
|
||||
|
||||
// Try shared-memory.json (role state + pipeline_mode)
|
||||
const sharedMemPath = join(sessionDir, 'shared-memory.json');
|
||||
if (existsSync(sharedMemPath)) {
|
||||
try {
|
||||
const sharedMem = JSON.parse(readFileSync(sharedMemPath, 'utf-8'));
|
||||
if (sharedMem.pipeline_mode) result.pipeline_mode = sharedMem.pipeline_mode;
|
||||
if (sharedMem.pipeline_stages) result.pipeline_stages = sharedMem.pipeline_stages;
|
||||
// Extract role state: any key that looks like a role namespace
|
||||
const roleState: Record<string, Record<string, unknown>> = {};
|
||||
for (const [key, value] of Object.entries(sharedMem)) {
|
||||
if (typeof value === 'object' && value !== null && !Array.isArray(value)
|
||||
&& !['pipeline_mode', 'pipeline_stages'].includes(key)) {
|
||||
roleState[key] = value as Record<string, unknown>;
|
||||
}
|
||||
}
|
||||
if (Object.keys(roleState).length > 0) result.role_state = roleState;
|
||||
} catch { /* ignore parse errors */ }
|
||||
}
|
||||
|
||||
// Try team-session.json (pipeline config)
|
||||
const sessionPath = join(sessionDir, 'team-session.json');
|
||||
if (existsSync(sessionPath)) {
|
||||
try {
|
||||
const session = JSON.parse(readFileSync(sessionPath, 'utf-8'));
|
||||
if (!result.pipeline_mode && session.pipeline_mode) result.pipeline_mode = session.pipeline_mode;
|
||||
if (!result.pipeline_stages && session.pipeline_stages) result.pipeline_stages = session.pipeline_stages;
|
||||
if (session.team_name) result.team_name = session.team_name;
|
||||
if (session.task_description) result.task_description = session.task_description;
|
||||
if (session.roles) result.roles = session.roles;
|
||||
} catch { /* ignore parse errors */ }
|
||||
}
|
||||
|
||||
return result;
|
||||
}
|
||||
|
||||
// --- Types ---
|
||||
@@ -92,7 +171,6 @@ export interface TeamMessage {
|
||||
to: string;
|
||||
type: string;
|
||||
summary: string;
|
||||
ref?: string;
|
||||
data?: Record<string, unknown>;
|
||||
}
|
||||
|
||||
@@ -106,29 +184,40 @@ export interface StatusEntry {
|
||||
// --- Zod Schema ---
|
||||
|
||||
const ParamsSchema = z.object({
|
||||
operation: z.enum(['log', 'read', 'list', 'status', 'delete', 'clear']).describe('Operation to perform'),
|
||||
team: z.string().describe('Session ID (new: .workflow/.team/{session-id}/.msg/) or team name (legacy: .workflow/.team-msg/{team}/)'),
|
||||
operation: z.enum(['log', 'read', 'list', 'status', 'delete', 'clear', 'broadcast', 'get_state']).describe('Operation to perform'),
|
||||
|
||||
// log params
|
||||
from: z.string().optional().describe('[log/list] Sender role name'),
|
||||
to: z.string().optional().describe('[log/list] Recipient role name'),
|
||||
type: z.string().optional().describe('[log/list] Message type (plan_ready, impl_complete, test_result, etc.)'),
|
||||
summary: z.string().optional().describe('[log] One-line human-readable summary'),
|
||||
ref: z.string().optional().describe('[log] File path reference for large content'),
|
||||
data: z.record(z.string(), z.unknown()).optional().describe('[log] Optional structured data'),
|
||||
// Accept both 'team' (legacy) and 'team_session_id' (preferred)
|
||||
team: z.string().optional().describe('[deprecated] Use team_session_id instead'),
|
||||
team_session_id: z.string().optional().describe('Session ID that determines message storage path (e.g., TLS-my-project-2026-02-27)'),
|
||||
|
||||
// read params
|
||||
id: z.string().optional().describe('[read] Message ID to read (e.g. MSG-003)'),
|
||||
// log/broadcast params
|
||||
from: z.string().optional().describe('[log/broadcast/list] Sender role name'),
|
||||
to: z.string().optional().describe('[log/list] Recipient role (defaults to "coordinator")'),
|
||||
type: z.string().optional().describe('[log/broadcast/list] Message type (state_update, plan_ready, shutdown, etc.)'),
|
||||
summary: z.string().optional().describe('[log/broadcast] One-line summary (auto-generated from type+from if omitted)'),
|
||||
data: z.record(z.string(), z.unknown()).optional().describe('[log/broadcast] Structured data payload. Use data.ref for file paths. When type="state_update", auto-synced to meta.json'),
|
||||
|
||||
// read/delete params
|
||||
id: z.string().optional().describe('[read/delete] Message ID (e.g. MSG-003)'),
|
||||
|
||||
// list params
|
||||
last: z.number().min(1).max(100).optional().describe('[list] Return last N messages (default: 20)'),
|
||||
|
||||
// session_id for artifact discovery
|
||||
session_id: z.string().optional().describe('[log] Session ID for artifact discovery (links team to .workflow/.team/{session-id}/)'),
|
||||
// get_state params
|
||||
role: z.string().optional().describe('[get_state] Role name to query. Omit to get all role states'),
|
||||
|
||||
// Legacy backward compat (accepted but ignored — team_session_id replaces this)
|
||||
ref: z.string().optional().describe('[deprecated] Use data.ref instead'),
|
||||
session_id: z.string().optional().describe('[deprecated] Use team_session_id instead'),
|
||||
});
|
||||
|
||||
type Params = z.infer<typeof ParamsSchema>;
|
||||
|
||||
/** Resolve team session ID from params, supporting legacy 'team' and new 'team_session_id' */
|
||||
function resolveTeamId(params: Params): string | null {
|
||||
return params.team_session_id || params.team || params.session_id || null;
|
||||
}
|
||||
|
||||
// --- Tool Schema ---
|
||||
|
||||
export const schema: ToolSchema = {
|
||||
@@ -142,39 +231,44 @@ Directory Structure (LEGACY):
|
||||
.workflow/.team-msg/{team-name}/messages.jsonl
|
||||
|
||||
Operations:
|
||||
team_msg(operation="log", team="TLS-my-team-2026-02-15", from="planner", to="coordinator", type="plan_ready", summary="Plan ready: 3 tasks", ref=".workflow/.team-plan/my-team/plan.json")
|
||||
team_msg(operation="log", team="TLS-my-team-2026-02-15", from="coordinator", to="implementer", type="task_unblocked", summary="Task ready")
|
||||
team_msg(operation="read", team="TLS-my-team-2026-02-15", id="MSG-003")
|
||||
team_msg(operation="list", team="TLS-my-team-2026-02-15")
|
||||
team_msg(operation="list", team="TLS-my-team-2026-02-15", from="tester", last=5)
|
||||
team_msg(operation="status", team="TLS-my-team-2026-02-15")
|
||||
team_msg(operation="delete", team="TLS-my-team-2026-02-15", id="MSG-003")
|
||||
team_msg(operation="clear", team="TLS-my-team-2026-02-15")
|
||||
team_msg(operation="log", team_session_id="TLS-xxx", from="planner", type="plan_ready", data={ref: "plan.json"})
|
||||
team_msg(operation="log", team_session_id="TLS-xxx", from="coordinator", type="state_update", data={pipeline_mode: "full"})
|
||||
team_msg(operation="broadcast", team_session_id="TLS-xxx", from="coordinator", type="shutdown")
|
||||
team_msg(operation="get_state", team_session_id="TLS-xxx", role="researcher")
|
||||
team_msg(operation="read", team_session_id="TLS-xxx", id="MSG-003")
|
||||
team_msg(operation="list", team_session_id="TLS-xxx", from="tester", last=5)
|
||||
team_msg(operation="status", team_session_id="TLS-xxx")
|
||||
team_msg(operation="delete", team_session_id="TLS-xxx", id="MSG-003")
|
||||
team_msg(operation="clear", team_session_id="TLS-xxx")
|
||||
|
||||
Message types: plan_ready, plan_approved, plan_revision, task_unblocked, impl_complete, impl_progress, test_result, review_result, fix_required, error, shutdown`,
|
||||
Defaults: to="coordinator", summary=auto-generated if omitted, type="message"
|
||||
Message types: plan_ready, plan_approved, plan_revision, task_unblocked, impl_complete, impl_progress, test_result, review_result, fix_required, error, shutdown, state_update`,
|
||||
inputSchema: {
|
||||
type: 'object',
|
||||
properties: {
|
||||
operation: {
|
||||
type: 'string',
|
||||
enum: ['log', 'read', 'list', 'status', 'delete', 'clear'],
|
||||
description: 'Operation: log | read | list | status | delete | clear',
|
||||
enum: ['log', 'read', 'list', 'status', 'delete', 'clear', 'broadcast', 'get_state'],
|
||||
description: 'Operation: log | read | list | status | delete | clear | broadcast | get_state',
|
||||
},
|
||||
team: {
|
||||
team_session_id: {
|
||||
type: 'string',
|
||||
description: 'Session ID (e.g., TLS-my-project-2026-02-27). Maps to .workflow/.team/{session-id}/.msg/. Use session ID, NOT team name.',
|
||||
description: 'Session ID (e.g., TLS-my-project-2026-02-27). Maps to .workflow/.team/{session-id}/.msg/',
|
||||
},
|
||||
from: { type: 'string', description: '[log/list] Sender role' },
|
||||
to: { type: 'string', description: '[log/list] Recipient role' },
|
||||
type: { type: 'string', description: '[log/list] Message type' },
|
||||
summary: { type: 'string', description: '[log] One-line summary' },
|
||||
ref: { type: 'string', description: '[log] File path for large content' },
|
||||
data: { type: 'object', description: '[log] Optional structured data' },
|
||||
id: { type: 'string', description: '[read] Message ID (e.g. MSG-003)' },
|
||||
from: { type: 'string', description: '[log/broadcast/list] Sender role' },
|
||||
to: { type: 'string', description: '[log/list] Recipient role (defaults to "coordinator")' },
|
||||
type: { type: 'string', description: '[log/broadcast/list] Message type' },
|
||||
summary: { type: 'string', description: '[log/broadcast] One-line summary (auto-generated if omitted)' },
|
||||
data: { type: 'object', description: '[log/broadcast] Structured data. Use data.ref for file paths. When type="state_update", auto-synced to meta.json' },
|
||||
id: { type: 'string', description: '[read/delete] Message ID (e.g. MSG-003)' },
|
||||
last: { type: 'number', description: '[list] Last N messages (default 20)', minimum: 1, maximum: 100 },
|
||||
session_id: { type: 'string', description: '[log] Session ID for artifact discovery' },
|
||||
role: { type: 'string', description: '[get_state] Role name to query. Omit for all roles' },
|
||||
// Legacy params (backward compat)
|
||||
team: { type: 'string', description: '[deprecated] Use team_session_id' },
|
||||
ref: { type: 'string', description: '[deprecated] Use data.ref instead' },
|
||||
session_id: { type: 'string', description: '[deprecated] Use team_session_id' },
|
||||
},
|
||||
required: ['operation', 'team'],
|
||||
required: ['operation'],
|
||||
},
|
||||
};
|
||||
|
||||
@@ -202,12 +296,12 @@ export function getLogDirWithFallback(sessionId: string): string {
|
||||
return join(root, '.workflow', '.team-msg', sessionId);
|
||||
}
|
||||
|
||||
function getLogPath(team: string): string {
|
||||
return join(getLogDir(team), 'messages.jsonl');
|
||||
function getLogPath(teamId: string): string {
|
||||
return join(getLogDir(teamId), 'messages.jsonl');
|
||||
}
|
||||
|
||||
function ensureLogFile(team: string): string {
|
||||
const logPath = getLogPath(team);
|
||||
function ensureLogFile(teamId: string): string {
|
||||
const logPath = getLogPath(teamId);
|
||||
const dir = dirname(logPath);
|
||||
if (!existsSync(dir)) {
|
||||
mkdirSync(dir, { recursive: true });
|
||||
@@ -218,8 +312,8 @@ function ensureLogFile(team: string): string {
|
||||
return logPath;
|
||||
}
|
||||
|
||||
export function readAllMessages(team: string): TeamMessage[] {
|
||||
const logPath = getLogPath(team);
|
||||
export function readAllMessages(teamId: string): TeamMessage[] {
|
||||
const logPath = getLogPath(teamId);
|
||||
if (!existsSync(logPath)) return [];
|
||||
|
||||
const content = readFileSync(logPath, 'utf-8').trim();
|
||||
@@ -248,54 +342,81 @@ function nowISO(): string {
|
||||
|
||||
// --- Operations ---
|
||||
|
||||
function opLog(params: Params): ToolResult {
|
||||
function opLog(params: Params, teamId: string): ToolResult {
|
||||
if (!params.from) return { success: false, error: 'log requires "from"' };
|
||||
if (!params.to) return { success: false, error: 'log requires "to"' };
|
||||
if (!params.summary) return { success: false, error: 'log requires "summary"' };
|
||||
|
||||
const logPath = ensureLogFile(params.team);
|
||||
const messages = readAllMessages(params.team);
|
||||
// Default to "coordinator" if to is not specified
|
||||
const to = params.to || 'coordinator';
|
||||
|
||||
// Backward compat: merge legacy ref into data.ref
|
||||
if (params.ref) {
|
||||
if (!params.data) params.data = {};
|
||||
if (!params.data.ref) params.data.ref = params.ref;
|
||||
}
|
||||
|
||||
// Auto-generate summary if not provided
|
||||
const summary = params.summary || `[${params.from}] ${params.type || 'message'} → ${to}`;
|
||||
|
||||
const logPath = ensureLogFile(teamId);
|
||||
const messages = readAllMessages(teamId);
|
||||
const id = getNextId(messages);
|
||||
|
||||
const msg: TeamMessage = {
|
||||
id,
|
||||
ts: nowISO(),
|
||||
from: params.from,
|
||||
to: params.to,
|
||||
to,
|
||||
type: params.type || 'message',
|
||||
summary: params.summary,
|
||||
summary,
|
||||
};
|
||||
if (params.ref) msg.ref = params.ref;
|
||||
if (params.data) msg.data = params.data;
|
||||
|
||||
appendFileSync(logPath, JSON.stringify(msg) + '\n', 'utf-8');
|
||||
|
||||
// Update meta with session_id if provided
|
||||
if (params.session_id) {
|
||||
const meta = getEffectiveTeamMeta(params.team);
|
||||
meta.session_id = params.session_id;
|
||||
// Auto-sync state_update to meta.json
|
||||
if (params.type === 'state_update' && params.data) {
|
||||
const meta = getEffectiveTeamMeta(teamId);
|
||||
|
||||
// Role state: store under role_state namespace
|
||||
if (params.from) {
|
||||
if (!meta.role_state) meta.role_state = {};
|
||||
meta.role_state[params.from] = {
|
||||
...meta.role_state[params.from],
|
||||
...params.data,
|
||||
_updated_at: nowISO(),
|
||||
};
|
||||
}
|
||||
|
||||
// Promote top-level keys directly to meta
|
||||
const topLevelKeys = ['pipeline_mode', 'pipeline_stages', 'team_name', 'task_description', 'roles'] as const;
|
||||
for (const key of topLevelKeys) {
|
||||
if (params.data[key] !== undefined) {
|
||||
(meta as any)[key] = params.data[key];
|
||||
}
|
||||
}
|
||||
|
||||
meta.updated_at = nowISO();
|
||||
writeTeamMeta(params.team, meta);
|
||||
writeTeamMeta(teamId, meta);
|
||||
}
|
||||
|
||||
return { success: true, result: { id, message: `Logged ${id}: [${msg.from} → ${msg.to}] ${msg.summary}` } };
|
||||
}
|
||||
|
||||
function opRead(params: Params): ToolResult {
|
||||
function opRead(params: Params, teamId: string): ToolResult {
|
||||
if (!params.id) return { success: false, error: 'read requires "id"' };
|
||||
|
||||
const messages = readAllMessages(params.team);
|
||||
const messages = readAllMessages(teamId);
|
||||
const msg = messages.find(m => m.id === params.id);
|
||||
|
||||
if (!msg) {
|
||||
return { success: false, error: `Message ${params.id} not found in team "${params.team}"` };
|
||||
return { success: false, error: `Message ${params.id} not found in team "${teamId}"` };
|
||||
}
|
||||
|
||||
return { success: true, result: msg };
|
||||
}
|
||||
|
||||
function opList(params: Params): ToolResult {
|
||||
let messages = readAllMessages(params.team);
|
||||
function opList(params: Params, teamId: string): ToolResult {
|
||||
let messages = readAllMessages(teamId);
|
||||
|
||||
// Apply filters
|
||||
if (params.from) messages = messages.filter(m => m.from === params.from);
|
||||
@@ -319,8 +440,8 @@ function opList(params: Params): ToolResult {
|
||||
};
|
||||
}
|
||||
|
||||
function opStatus(params: Params): ToolResult {
|
||||
const messages = readAllMessages(params.team);
|
||||
function opStatus(params: Params, teamId: string): ToolResult {
|
||||
const messages = readAllMessages(teamId);
|
||||
|
||||
if (messages.length === 0) {
|
||||
return { success: true, result: { members: [], summary: 'No messages recorded yet.' } };
|
||||
@@ -357,35 +478,57 @@ function opStatus(params: Params): ToolResult {
|
||||
};
|
||||
}
|
||||
|
||||
function opDelete(params: Params): ToolResult {
|
||||
function opDelete(params: Params, teamId: string): ToolResult {
|
||||
if (!params.id) return { success: false, error: 'delete requires "id"' };
|
||||
|
||||
const messages = readAllMessages(params.team);
|
||||
const messages = readAllMessages(teamId);
|
||||
const idx = messages.findIndex(m => m.id === params.id);
|
||||
|
||||
if (idx === -1) {
|
||||
return { success: false, error: `Message ${params.id} not found in team "${params.team}"` };
|
||||
return { success: false, error: `Message ${params.id} not found in team "${teamId}"` };
|
||||
}
|
||||
|
||||
const removed = messages.splice(idx, 1)[0];
|
||||
const logPath = ensureLogFile(params.team);
|
||||
const logPath = ensureLogFile(teamId);
|
||||
writeFileSync(logPath, messages.map(m => JSON.stringify(m)).join('\n') + (messages.length > 0 ? '\n' : ''), 'utf-8');
|
||||
|
||||
return { success: true, result: { deleted: removed.id, message: `Deleted ${removed.id}: [${removed.from} → ${removed.to}] ${removed.summary}` } };
|
||||
}
|
||||
|
||||
function opClear(params: Params): ToolResult {
|
||||
const logPath = getLogPath(params.team);
|
||||
const dir = getLogDir(params.team);
|
||||
function opBroadcast(params: Params, teamId: string): ToolResult {
|
||||
if (!params.from) return { success: false, error: 'broadcast requires "from"' };
|
||||
|
||||
if (!existsSync(logPath)) {
|
||||
return { success: true, result: { message: `Team "${params.team}" has no messages to clear.` } };
|
||||
// Delegate to opLog with to="all"
|
||||
return opLog({ ...params, operation: 'log', to: 'all' }, teamId);
|
||||
}
|
||||
|
||||
function opGetState(params: Params, teamId: string): ToolResult {
|
||||
const meta = getEffectiveTeamMeta(teamId);
|
||||
const roleState = meta.role_state || {};
|
||||
|
||||
if (params.role) {
|
||||
const state = roleState[params.role];
|
||||
if (!state) {
|
||||
return { success: true, result: { role: params.role, state: null, message: `No state found for role "${params.role}"` } };
|
||||
}
|
||||
return { success: true, result: { role: params.role, state } };
|
||||
}
|
||||
|
||||
const count = readAllMessages(params.team).length;
|
||||
return { success: true, result: { role_state: roleState } };
|
||||
}
|
||||
|
||||
function opClear(params: Params, teamId: string): ToolResult {
|
||||
const logPath = getLogPath(teamId);
|
||||
const dir = getLogDir(teamId);
|
||||
|
||||
if (!existsSync(logPath)) {
|
||||
return { success: true, result: { message: `Team "${teamId}" has no messages to clear.` } };
|
||||
}
|
||||
|
||||
const count = readAllMessages(teamId).length;
|
||||
rmSync(dir, { recursive: true, force: true });
|
||||
|
||||
return { success: true, result: { cleared: count, message: `Cleared ${count} messages for team "${params.team}".` } };
|
||||
return { success: true, result: { cleared: count, message: `Cleared ${count} messages for team "${teamId}".` } };
|
||||
}
|
||||
|
||||
// --- Handler ---
|
||||
@@ -398,13 +541,21 @@ export async function handler(params: Record<string, unknown>): Promise<ToolResu
|
||||
|
||||
const p = parsed.data;
|
||||
|
||||
// Resolve team ID from team_session_id / team / session_id (backward compat)
|
||||
const teamId = resolveTeamId(p);
|
||||
if (!teamId) {
|
||||
return { success: false, error: 'Missing required parameter: team_session_id (or legacy "team")' };
|
||||
}
|
||||
|
||||
switch (p.operation) {
|
||||
case 'log': return opLog(p);
|
||||
case 'read': return opRead(p);
|
||||
case 'list': return opList(p);
|
||||
case 'status': return opStatus(p);
|
||||
case 'delete': return opDelete(p);
|
||||
case 'clear': return opClear(p);
|
||||
case 'log': return opLog(p, teamId);
|
||||
case 'read': return opRead(p, teamId);
|
||||
case 'list': return opList(p, teamId);
|
||||
case 'status': return opStatus(p, teamId);
|
||||
case 'delete': return opDelete(p, teamId);
|
||||
case 'clear': return opClear(p, teamId);
|
||||
case 'broadcast': return opBroadcast(p, teamId);
|
||||
case 'get_state': return opGetState(p, teamId);
|
||||
default:
|
||||
return { success: false, error: `Unknown operation: ${p.operation}` };
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user