crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/ai/self-improvement/growth-areas.service.js

@@ -0,0 +1,135 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Keywords that indicate potential growth areas when found in learnings/failures.
+ */
+const GROWTH_KEYWORDS = {
+    'error handling': 'error handling patterns',
+    'async': 'async/await best practices',
+    'test': 'test coverage and quality',
+    'type': 'TypeScript type system',
+    'performance': 'performance optimization',
+    'security': 'security awareness',
+    'edge case': 'edge case handling',
+    'timeout': 'timeout and retry patterns',
+    'memory leak': 'memory management',
+    'race condition': 'concurrency handling',
+};
+/**
+ * Service for tracking agent growth areas over time.
+ *
+ * Each agent maintains a growth-areas.json file that records areas
+ * where the agent is actively improving. Growth areas can be manually
+ * added or auto-extracted from learnings and failures.
+ *
+ * Storage: ~/.crewly/agents/{sessionName}/growth-areas.json
+ */
+export class GrowthAreasService {
+    /**
+     * Get the file path for an agent's growth areas.
+     *
+     * @param sessionName - Agent session name
+     * @returns Absolute path to growth-areas.json
+     */
+    getFilePath(sessionName) {
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '/tmp';
+        return path.join(homeDir, '.crewly', 'agents', sessionName, 'growth-areas.json');
+    }
+    /**
+     * Read growth areas data from disk.
+     *
+     * @param sessionName - Agent session name
+     * @returns Growth areas data, or empty default if file doesn't exist
+     */
+    async getGrowthAreas(sessionName) {
+        try {
+            const filePath = this.getFilePath(sessionName);
+            const raw = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return { areas: [], lastReviewedAt: '' };
+        }
+    }
+    /**
+     * Add a new growth area for an agent.
+     *
+     * @param sessionName - Agent session name
+     * @param area - Description of the growth area
+     * @returns The created growth area
+     */
+    async addGrowthArea(sessionName, area) {
+        const data = await this.getGrowthAreas(sessionName);
+        // Don't add duplicates
+        const existing = data.areas.find((a) => a.area.toLowerCase() === area.toLowerCase());
+        if (existing) {
+            return existing;
+        }
+        const newArea = {
+            area,
+            identifiedAt: new Date().toISOString().split('T')[0],
+            progress: 'identified',
+            evidence: [],
+        };
+        data.areas.push(newArea);
+        data.lastReviewedAt = new Date().toISOString().split('T')[0];
+        await this.save(sessionName, data);
+        return newArea;
+    }
+    /**
+     * Update the progress of an existing growth area.
+     *
+     * @param sessionName - Agent session name
+     * @param area - Growth area description to update
+     * @param progress - New progress status
+     * @param evidence - Evidence supporting the progress update
+     * @returns Updated growth area or null if not found
+     */
+    async updateProgress(sessionName, area, progress, evidence) {
+        const data = await this.getGrowthAreas(sessionName);
+        const found = data.areas.find((a) => a.area.toLowerCase() === area.toLowerCase());
+        if (!found) {
+            return null;
+        }
+        found.progress = progress;
+        found.evidence.push(evidence);
+        data.lastReviewedAt = new Date().toISOString().split('T')[0];
+        await this.save(sessionName, data);
+        return found;
+    }
+    /**
+     * Auto-extract potential growth areas from a learning or failure text.
+     *
+     * @param sessionName - Agent session name
+     * @param text - Learning or failure text to analyze
+     * @returns Array of newly added growth areas (empty if no new areas found)
+     */
+    async extractFromText(sessionName, text) {
+        const lowerText = text.toLowerCase();
+        const added = [];
+        for (const [keyword, areaName] of Object.entries(GROWTH_KEYWORDS)) {
+            if (lowerText.includes(keyword)) {
+                const data = await this.getGrowthAreas(sessionName);
+                const exists = data.areas.some((a) => a.area.toLowerCase() === areaName.toLowerCase());
+                if (!exists) {
+                    const newArea = await this.addGrowthArea(sessionName, areaName);
+                    added.push(newArea);
+                }
+            }
+        }
+        return added;
+    }
+    /**
+     * Persist growth areas data to disk.
+     *
+     * @param sessionName - Agent session name
+     * @param data - Growth areas data to save
+     */
+    async save(sessionName, data) {
+        const filePath = this.getFilePath(sessionName);
+        const dir = path.dirname(filePath);
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=growth-areas.service.js.map

package/dist/cli/backend/src/services/ai/self-improvement/growth-areas.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"growth-areas.service.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/self-improvement/growth-areas.service.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/chat-v2/chat-v2.dispatcher.service.d.ts

@@ -0,0 +1,292 @@
+/**
+ * ChatV2DispatcherService — deliver user-origin chat messages to the
+ * bound agent session.
+ *
+ * Flow:
+ *   HTTP POST /api/chat/channels/:id/messages
+ *     → ChatV2Service.sendMessage (persist + dedupe)
+ *     → controller broadcasts WS message frame (user bubble)
+ *     → controller calls ChatV2Dispatcher.dispatchToAgent(channel, messageDTO)
+ *     → sendMessageToAgent(agent_session, "[CHAT:<id>] <content>\n<hint>")
+ *     → agent processes + calls `reply-chat` skill
+ *     → skill POSTs back to /api/chat/channels/:id/messages as the agent
+ *     → same controller path → WS message frame (agent bubble)
+ *
+ * This service is intentionally thin — a couple of dozen lines of glue
+ * around the AgentRegistrationService's `sendMessageToAgent` primitive.
+ * The dispatch prompt is extracted so tests can assert the format, which
+ * is the contract the `reply-chat` skill relies on.
+ *
+ * @module services/chat-v2/chat-v2.dispatcher.service
+ */
+import type { ChatChannelDTO, ChatMessageDTO } from './types.js';
+import type { ChatV2MentionResolver, MentionTarget } from './chat-v2.mention-resolver.js';
+/**
+ * Minimal surface the dispatcher needs from the agent-registration service.
+ * Typed explicitly so tests can pass a stub without pulling in the full
+ * AgentRegistrationService class.
+ */
+export interface AgentMessageSink {
+    sendMessageToAgent(sessionName: string, message: string): Promise<{
+        success: boolean;
+        error?: string;
+        message?: string;
+        queued?: boolean;
+    }>;
+}
+/** Result returned by `dispatchToAgent`. */
+export interface DispatchResult {
+    /** True when the runtime accepted the message (or queued it for delivery). */
+    dispatched: boolean;
+    /** Filled when `dispatched === false`. */
+    error?: string;
+}
+/** One per-recipient outcome produced by `dispatchMessage`. */
+export interface MentionDispatchOutcome {
+    /** The mention target the dispatcher attempted to deliver to. */
+    target: MentionTarget;
+    /** Underlying delivery result from `AgentMessageSink.sendMessageToAgent`. */
+    dispatched: boolean;
+    /** Error message, if delivery failed. */
+    error?: string;
+}
+/**
+ * Phase B-2 (2026-05-17) — one per-member outcome for huddle dispatch.
+ *
+ * Huddles don't go through `MentionResolver` — their roster is read
+ * directly from `chat_channel_members`. The outcome records whether
+ * the member was @-mentioned (which controls `responseMode` in the
+ * prompt) and whether the underlying sink call succeeded.
+ */
+export interface HuddleDispatchOutcome {
+    /** Member's agent session name. */
+    sessionName: string;
+    /**
+     * `'required'` when the member appeared in `message.mentions[]`
+     * (they MUST reply); `'optional'` otherwise (they MAY reply if it
+     * makes sense). Surfaced in the formatted prompt.
+     */
+    responseMode: 'required' | 'optional';
+    /** Whether the prompt was successfully queued for the member. */
+    dispatched: boolean;
+    /** Error message, if delivery failed. */
+    error?: string;
+}
+/**
+ * Aggregate result of `dispatchMessage`. Reports the chosen routing
+ * strategy and per-recipient outcomes so callers (and tests) can assert
+ * exactly what fan-out happened without re-running the resolver.
+ */
+export interface DispatchMessageResult {
+    /**
+     * - `'dm'`: legacy 1:1 path — used by `type='dm'` channels.
+     * - `'channel-mentions'`: Phase C BE.3 fan-out — used by `type='channel'`
+     *   channels with at least one resolved mention.
+     * - `'skip'`: nothing was dispatched (non-user message, no recipients,
+     *   archived/unbound channel, etc.). `reason` is filled.
+     */
+    strategy: 'dm' | 'channel-mentions' | 'huddle-broadcast' | 'skip';
+    /** True when at least one underlying delivery succeeded. */
+    dispatched: boolean;
+    /** Filled when `strategy === 'skip'`. */
+    reason?: string;
+    /** Populated for `strategy === 'dm'`. */
+    dmResult?: DispatchResult;
+    /**
+     * Populated for `strategy === 'channel-mentions'`. One entry per
+     * resolved target. Empty when no mentions resolved.
+     */
+    mentionOutcomes?: MentionDispatchOutcome[];
+    /**
+     * Phase B-2 — populated for `strategy === 'huddle-broadcast'`. One
+     * entry per huddle member. Mentioned members carry
+     * `responseMode: 'required'`; the rest are `'optional'`.
+     */
+    huddleOutcomes?: HuddleDispatchOutcome[];
+}
+/** Constructor options for {@link ChatV2DispatcherService}. */
+export interface ChatV2DispatcherOptions {
+    agentSink: AgentMessageSink;
+    /**
+     * Override the prompt formatter for tests / future customization. The
+     * default matches the `reply-chat` skill's parser exactly.
+     */
+    formatPrompt?: (args: FormatPromptArgs) => string;
+    /**
+     * Phase C BE.3 — resolver used when dispatching a `type='channel'`
+     * message to its mentioned recipients. When omitted, channel-typed
+     * messages skip dispatch entirely (preserves the BE.1+BE.2 contract
+     * for callers that haven't wired the resolver yet, e.g. legacy unit
+     * tests). The production composition root injects a resolver backed
+     * by `StorageService.getTeams()`.
+     */
+    mentionResolver?: ChatV2MentionResolver;
+    /**
+     * Phase B-2 (2026-05-17) — roster lookup used when dispatching a
+     * `type='huddle'` message to every member. Synchronous because the
+     * production implementation is a direct SQLite read against
+     * `chat_channel_members`. When omitted, huddle messages skip
+     * dispatch (mirrors how `mentionResolver` gates `'channel'` rows).
+     *
+     * Returns the list of `agentSession` ids for the huddle's members.
+     * Order doesn't matter — the dispatcher loops over the whole list.
+     */
+    huddleMembersFor?: (channelId: string) => readonly string[];
+    /**
+     * Activate-on-send hook. When a DM dispatch fails because the agent's
+     * session doesn't exist (inactive), the dispatcher calls this to start the
+     * agent, then retries delivery once. Returns true when the agent is now
+     * active. User-initiated, so it bypasses the orchestrator wake-gate by
+     * design. When omitted, inactive sends just queue (legacy behavior).
+     */
+    activateAgent?: (agentSession: string) => Promise<boolean>;
+}
+/** Inputs to the prompt formatter. */
+export interface FormatPromptArgs {
+    channelId: string;
+    channelName: string;
+    agentSession: string;
+    senderId: string;
+    content: string;
+    clientMessageId?: string;
+    /**
+     * Phase B-2 — in a huddle, every member receives the prompt but
+     * only the @-mentioned ones MUST reply. The default formatter
+     * appends a "你必须回复" (mandatory) or "你可以选择是否回复" (optional)
+     * tag so the agent's prompt-following heuristics can branch. Defaults
+     * to `'required'` for DMs and `'channel'` (single-mention) dispatches
+     * where every recipient was explicitly addressed.
+     */
+    responseMode?: 'required' | 'optional';
+    /**
+     * Slack team channels — the chat-v2 thread the reply must land in
+     * (root message id). When set, the hint tells the agent to pass
+     * `--thread <id>` so the outbound mirror can post into the same Slack
+     * thread.
+     */
+    threadId?: string;
+    /**
+     * Which skill the hint names. `'reply-chat'` (default, legacy) posts via
+     * the orchestrator-side chat endpoint; `'reply-channel'` writes straight
+     * into the chat-v2 channel as the agent and supports `--thread`. Slack
+     * team channels use `'reply-channel'`.
+     */
+    replyVia?: 'reply-chat' | 'reply-channel';
+}
+/**
+ * Per-call routing options for {@link ChatV2DispatcherService.dispatchMessage}.
+ * Forwarded verbatim into {@link FormatPromptArgs}.
+ */
+export interface DispatchMessageOptions {
+    /** See {@link FormatPromptArgs.threadId}. */
+    threadId?: string;
+    /** See {@link FormatPromptArgs.replyVia}. */
+    replyVia?: 'reply-chat' | 'reply-channel';
+}
+/**
+ * Default prompt formatter the agent sees when a user sends in their
+ * chat channel.
+ *
+ * Format is intentionally stable and tag-prefixed so the `reply-chat`
+ * skill (and future tooling) can reliably extract the channelId without
+ * regex ambiguity. The `回复:` hint line gives the agent a one-step
+ * instruction on how to reply.
+ */
+export declare function defaultFormatPrompt(args: FormatPromptArgs): string;
+/**
+ * Dispatches user-origin chat messages to the agent session bound to the
+ * channel. Invoked from the chat controller after `ChatV2Service.sendMessage`
+ * returns.
+ */
+export declare class ChatV2DispatcherService {
+    private readonly agentSink;
+    private readonly formatPrompt;
+    private readonly mentionResolver?;
+    private readonly huddleMembersFor?;
+    private readonly activateAgent?;
+    private readonly logger;
+    constructor(options: ChatV2DispatcherOptions);
+    /**
+     * Phase C BE.3 entry point — choose the routing strategy from
+     * `channel.type` and the message's mentions, then fan out.
+     *
+     * Routing rules (SEALED §2.1):
+     *   - `type='dm'` → existing 1:1 path via `dispatchToAgent`. Mentions
+     *     in DMs are advisory only (the channel already binds to one
+     *     agent); the dispatcher does not currently re-route them.
+     *   - `type='channel'` → resolve `message.mentions` via the injected
+     *     `mentionResolver`, then dispatch the formatted prompt to each
+     *     resolved sessionName. No mentions → no dispatch (the message
+     *     still persists; nobody is paged).
+     *   - Agent-origin messages always skip dispatch (no self-loopback).
+     *
+     * Always resolves; per-recipient errors are captured in
+     * {@link DispatchMessageResult.mentionOutcomes} and never thrown.
+     *
+     * @param channel - The channel DTO (provides `type`, name, agentSession).
+     * @param message - The persisted message DTO (provides senderType, mentions).
+     * @returns Aggregate result describing the strategy + outcomes.
+     */
+    dispatchMessage(channel: ChatChannelDTO, message: ChatMessageDTO, options?: DispatchMessageOptions): Promise<DispatchMessageResult>;
+    /**
+     * Phase B-2 — fan a user message out to every member of a huddle.
+     *
+     * Resolution path:
+     *   1. Look up the roster via the injected `huddleMembersFor`. No
+     *      resolver wired → return `strategy: 'skip'` (the message still
+     *      persists; nobody is paged).
+     *   2. Empty roster → same skip path. Should not happen since
+     *      `createHuddle` rejects empty membership, but defensive.
+     *   3. For each member, derive `responseMode` from whether their
+     *      session appears in `message.mentions[]`. Format the prompt
+     *      accordingly and call `sendMessageToAgent`.
+     *
+     * Always resolves; per-member errors are captured in
+     * {@link DispatchMessageResult.huddleOutcomes} and never thrown.
+     *
+     * @param channel - The huddle channel.
+     * @param message - The persisted user message.
+     * @returns Aggregate result with one outcome per member.
+     */
+    private dispatchHuddleBroadcast;
+    /**
+     * Dispatch a `type='channel'` message to its resolved mentions.
+     *
+     * Skips entirely when:
+     *   - No mention resolver is wired (return strategy=skip).
+     *   - `mentions` is empty (return strategy=skip).
+     *   - The resolver returns no targets (return strategy=channel-mentions
+     *     with empty `mentionOutcomes`; `dispatched=false`).
+     *
+     * @param channel - The team channel.
+     * @param message - The persisted user message.
+     * @returns Aggregate result with one outcome per resolved recipient.
+     */
+    private dispatchChannelMentions;
+    /**
+     * Push a newly-persisted user message to the agent.
+     *
+     * Dispatch is fire-and-forget at the API-response level (the HTTP 201 has
+     * already been serialized), but we still await the write so tests can
+     * observe the outcome and the logger can record failures.
+     *
+     * Messages where `senderType !== "user"` are a no-op — we never loop an
+     * agent's own reply back into its own PTY.
+     *
+     * @deprecated Issue #334 — `dispatchToAgent` is the legacy 1:1 entry
+     * point. New callers MUST go through `dispatchMessage`, which routes
+     * type='dm' messages here and adds the type='channel' (@mentions /
+     * @team) path. Direct callers of `dispatchToAgent` silently bypass
+     * the mention-resolution layer.
+     *
+     * Conversion: replace `dispatchToAgent(channel, message)` with
+     * `dispatchMessage(channel, message)` and read the `dmResult` field
+     * of the returned object. See chat-v2.dispatcher.service.ts:dispatchMessage
+     * for the contract.
+     *
+     * @param channel - Channel DTO (provides `agentSession` + display name)
+     * @param message - Persisted message DTO
+     */
+    dispatchToAgent(channel: ChatChannelDTO, message: ChatMessageDTO): Promise<DispatchResult>;
+}
+//# sourceMappingURL=chat-v2.dispatcher.service.d.ts.map

package/dist/cli/backend/src/services/chat-v2/chat-v2.dispatcher.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-v2.dispatcher.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/chat-v2/chat-v2.dispatcher.service.ts"],"names":[],"mappings":"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"}