dsh-plugin-t-expert 0.3.88 → 0.3.89

package/lib/teams/command.js

@@ -1,147 +0,0 @@
-import { createUserMessage } from '@deepseek-ai/dsh-llm';
-import { parseProfileInvocation, resolveProfileTaskPlanning } from "./profiles.js";
-export const T_TEAM_COMMAND = 't';
-const PROFILE_COMMAND_PREFIX = `${T_TEAM_COMMAND}-`;
-const GESTURE = /^\/t(?=$|[\t\n\r ])/u;
-/**
- * Convert a configured profile key into a stable, closed-namespace command
- * suffix. Only lowercase ASCII letters, digits and dashes are representable;
- * this deliberately prevents accidental command aliases for ambiguous profile
- * names such as `foo bar`, `foo_bar`, or non-ASCII keys.
- */
-export function profileCommandName(profileName) {
-    const normalized = profileName.trim().toLowerCase();
-    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(normalized))
-        return undefined;
-    return `${PROFILE_COMMAND_PREFIX}${normalized}`;
-}
-/** Resolve a profile command only when it maps uniquely to a live profile. */
-function profileForCommand(commandName, profiles) {
-    const matches = Object.keys(profiles).filter((profileName) => profileCommandName(profileName) === commandName);
-    return matches.length === 1 ? matches[0] : undefined;
-}
-/** Parse either the generic command or one generated profile alias. */
-function parseCommandText(text, profiles) {
-    const trimmed = text.trimStart();
-    if (GESTURE.test(trimmed))
-        return parseProfileInvocation(trimmed.slice(T_TEAM_COMMAND.length + 1).trim());
-    if (!trimmed.startsWith(`/${PROFILE_COMMAND_PREFIX}`))
-        return undefined;
-    const tokenEnd = trimmed.search(/[\t\n\r ]/u);
-    const commandName = trimmed.slice(1, tokenEnd === -1 ? undefined : tokenEnd);
-    const profile = profileForCommand(commandName, profiles);
-    if (profile === undefined)
-        return undefined;
-    return { profile, goal: (tokenEnd === -1 ? '' : trimmed.slice(tokenEnd)).trim() };
-}
-export function invokedTTeamInvocation(messages, getProfiles = () => ({})) {
-    for (let index = messages.length - 1; index >= 0; index -= 1) {
-        const message = messages[index];
-        if (message === undefined || message.source.kind !== 'user')
-            continue;
-        for (const block of message.content) {
-            if (block.type !== 'text')
-                continue;
-            const invocation = parseCommandText(block.text, getProfiles());
-            if (invocation !== undefined)
-                return invocation;
-        }
-    }
-    return undefined;
-}
-export function invokedTTeamGoal(messages) {
-    return invokedTTeamInvocation(messages)?.goal;
-}
-export function buildActivationDirective(goal, profile, taskPlanning = 'seed') {
-    const lines = [
-        'The user invoked a T Team slash command. Follow the T Team protocol already in your system instructions. Inspect existing team state with t_team_status when needed.',
-        'Respect the current team state. Continue an existing plan or team without recreating it. Only when no current team exists, call t_team_create with approval="required". Build the complete staged roster and DAG, then stop and ask the user to review the Web plan. Do not approve or start it in this same turn.',
-    ];
-    if (profile !== undefined) {
-        lines.push(`Use profile="${profile}" when creating a new team.`);
-        if (taskPlanning === 'captain') {
-            // 编制授权：profile 是「这类目标通常涉及哪些角色」，不是「这次必须全员上场」。
-            // 缺了这句，队长会把上面那句 "do not recreate members" 读成「roster 不可动」，转而给
-            // 边缘角色硬造任务；而下面那句原文（idle members can run in parallel）更是在明示
-            // 「给闲着的成员找活」—— 实测一份单文件 HTML 简历就是这样被派给 5 个人的。
-            lines.push('This profile supplies the roster and guardrails. After create, do not recreate members.', 'The roster is a staffing list, not a mandate to field everyone: drop any role whose distinct output this goal does not need (t_team_edit_plan remove_member while staged), and trim BEFORE creating tasks — once a task references a member, removing that member means fixing references first. When unsure, keep the role. Keep at least two members (a producer plus an independent verifier). State in the plan whom you kept, whom you trimmed, and why.', 'Derive the smallest useful task graph from the goal while the team is staged; do not ask the user whether to split, merge, serialize, or parallelize.', 'An idle member is not a reason to invent work: add a task only when the goal itself needs that output, and say why. When work genuinely is independent, make it a separate ready task so it can run in parallel instead of serializing it. Add dependencies only for genuine prerequisites and later synthesis.');
-        }
-        else {
-            lines.push('Do not recreate the same members or seed tasks manually.', 'You may still drop a role this goal does not need (t_team_edit_plan remove_member while the team is staged); state in the plan whom you kept, whom you trimmed, and why.');
-        }
-    }
-    lines.push(goal === '' ? 'The goal was not given — ask the user what the team should accomplish.' : `Goal: ${goal}`);
-    return lines.join('\n');
-}
-export function registerTTeamCommand(ctx, getProfiles = () => ({})) {
-    ctx.effect(() => {
-        const dispose = [];
-        dispose.push(ctx.commands.register({
-            name: T_TEAM_COMMAND,
-            description: 'run a goal with a multi-agent team (you become the captain)',
-            input: { hint: '[--profile <name>] <goal>' },
-            handler(invocation) {
-                let parsed;
-                try {
-                    parsed = parseProfileInvocation(invocation.rawInput.trim());
-                }
-                catch (error) {
-                    return { kind: 'error', text: String(error) };
-                }
-                if (parsed.profile !== undefined && !Object.keys(getProfiles()).some(key => key.trim() === parsed.profile))
-                    return { kind: 'error', text: `未知的 T专家 小队「${parsed.profile}」` };
-                if (parsed.profile === undefined && parsed.goal === '')
-                    return { kind: 'error', text: `Usage: /${T_TEAM_COMMAND} [--profile <name>] <goal>` };
-                invocation.agent.followup(createUserMessage({ content: [{ type: 'text', text: `/${T_TEAM_COMMAND}${invocation.rawInput}` }], source: { kind: 'user' } }));
-                return { kind: 'success', text: `T专家 小队已激活${parsed.profile === undefined ? '' : `（${parsed.profile}）`} —— 队长会先组装团队。` };
-            },
-        }));
-        for (const profileName of Object.keys(getProfiles())) {
-            const commandName = profileCommandName(profileName);
-            if (commandName === undefined)
-                continue;
-            dispose.push(ctx.commands.register({
-                name: commandName,
-                description: `run a goal with the T Team ${profileName} profile`,
-                input: { hint: '<goal>' },
-                handler(invocation) {
-                    const profile = profileForCommand(commandName, getProfiles());
-                    if (profile === undefined)
-                        return { kind: 'error', text: `T Team profile command "/${commandName}" is unavailable` };
-                    invocation.agent.followup(createUserMessage({ content: [{ type: 'text', text: `/${commandName}${invocation.rawInput}` }], source: { kind: 'user' } }));
-                    return { kind: 'success', text: `T专家 小队已激活（${profile}）—— 队长会先组装团队。` };
-                },
-            }));
-        }
-        return () => {
-            for (const unregister of dispose.reverse())
-                unregister();
-        };
-    }, 't-team: slash commands');
-}
-export function installTTeamGestureBoundary(ctx, getProfiles = () => ({})) {
-    ctx.on('agent/pre-step', async ({ messages, signal }, next) => {
-        const decision = await next();
-        if (decision.kind === 'reject')
-            return decision;
-        let invocation;
-        try {
-            invocation = invokedTTeamInvocation(messages, getProfiles);
-        }
-        catch (error) {
-            return { kind: 'enter', messages: [...decision.messages, createUserMessage({ content: [{ type: 'text', text: `T专家 小队解析失败：${String(error)}` }], source: { kind: 't-team-command' } })] };
-        }
-        if (invocation === undefined)
-            return decision;
-        signal.throwIfAborted();
-        const profiles = getProfiles();
-        const matched = invocation.profile === undefined
-            ? undefined
-            : Object.entries(profiles).find(([key]) => key.trim() === invocation.profile);
-        const known = invocation.profile === undefined || matched !== undefined;
-        const text = !known
-            ? `T专家 小队「${invocation.profile}」不存在。可用小队：${Object.keys(profiles).join('、') || '（无）'}。不要创建团队。`
-            : buildActivationDirective(invocation.goal, invocation.profile, resolveProfileTaskPlanning(matched?.[1]));
-        return { kind: 'enter', messages: [...decision.messages, createUserMessage({ content: [{ type: 'text', text }], source: { kind: 't-team-command', ...invocation.goal === '' ? {} : { goal: invocation.goal }, ...invocation.profile === undefined ? {} : { profile: invocation.profile } } })] };
-    });
-}

package/lib/teams/event-types.js

@@ -1,12 +0,0 @@
-/**
- * T Team session event types — pure types only, zero imports.
- *
- * This file intentionally imports nothing: both the host program (the
- * emitter in `events.ts`) and the browser program (the Conversation Node
- * definition) must be able to load these types and the `SessionEventMap`
- * declaration merge without pulling in host-side `Context` augmentations
- * (dsh-session's index declares `Context.sessions: SessionStore`, which
- * collides with the browser runtime's `ISessions` under the same name).
- * @module t-team/event-types
- */
-export {};

package/lib/teams/events.js

@@ -1,60 +0,0 @@
-/**
- * Durable T Team session events and their emitter.
- *
- * Every team-state mutation appends one event to the captain's Session, so
- * the web client's Conversation Node mechanism can fold the tree view from
- * the session log deterministically (same mechanism as `tool-workflow`'s
- * `tool-workflow/*` record events). Events append to the captain's session
- * even when a member agent performed the mutation, so the captain's
- * conversation stream stays the single authoritative monitor surface.
- *
- * Types and the `SessionEventMap` merge live in `event-types.ts` (zero
- * imports) so the browser program can load them without host augmentations.
- * @module t-team/events
- */
-import * as dshSession from '@deepseek-ai/dsh-session';
-/** Event types already reported as unsupported, to avoid repetitive logs. */
-const skippedEventTypes = new Set();
-/**
- * Append one T Team event to a Session, containing failures (a broken
- * durable record must never break team tool execution).
- * @param ctx - the plugin context (for logging).
- * @param session - the session to record into (the captain's, normally).
- * @param type - the event type.
- * @param data - the event payload.
- */
-export function appendTeamEvent(ctx, session, type, data) {
-    // Out-of-repo events are not in the harness's generated vocabulary today.
-    // Mutating that ReadonlySet would make readability depend on which plugins
-    // happen to be loaded. Until Session.append exposes the official
-    // `ignorable: true` writer surface, omit these informational records unless
-    // the running harness already recognizes them. Disk state remains the
-    // authoritative source for the activity panel.
-    const known = dshSession.KNOWN_SESSION_EVENT_TYPES;
-    if (known?.has(type) !== true) {
-        if (!skippedEventTypes.has(type)) {
-            skippedEventTypes.add(type);
-            ctx.logger.debug(`t-team: session event "${type}" omitted because this harness does not recognize it`);
-        }
-        return;
-    }
-    try {
-        session.append(type, data);
-    }
-    catch (error) {
-        ctx.logger.warn(`t-team: session record failed after ${type}: ${String(error)}`);
-    }
-}
-/**
- * Resolve the captain's live Session for event recording. The captain agent
- * may be offline (its team outlives the session), in which case the caller's
- * own session is used as the fallback record target.
- * @param ctx - the plugin context (injects `agents`).
- * @param captainSessionId - the captain's durable session id.
- * @param fallback - the calling agent's session, used when the captain is not live.
- * @returns the session to record into.
- */
-export function captainSessionOf(ctx, captainSessionId, fallback) {
-    const captain = ctx.agents.get(captainSessionId);
-    return captain?.session ?? fallback;
-}