qlogicagent 2.23.14 → 2.24.2

package/dist/types/protocol/wire/acp-agent-management.d.ts

@@ -1,533 +0,0 @@
-/**
- * ACP (Agent-Client Protocol) type definitions for third-party agent management.
- *
- * These types define the contract for discovering, registering, and managing
- * external ACP-compatible agent CLIs alongside qlogicagent's internal agents.
- */
-import type { ProductTaskStatus, ProductInstanceDef, ProductTaskDef } from "./agent-methods.js";
-export type { SoloState, SoloAgentState, SoloAgentResult, SoloStatus, ProductPhase, ProductTaskStatus, ProductInstanceDef, ProductTaskDef, ProductStatus, ProductSummary, } from "./agent-methods.js";
-/** ACP initialize result (from agent's response). */
-export interface AcpInitializeResult {
-    protocolVersion: number;
-    /** Standard ACP agentCapabilities (official SDK field). */
-    agentCapabilities: {
-        loadSession?: boolean;
-        mcpCapabilities?: {
-            http?: boolean;
-            sse?: boolean;
-            stdio?: boolean;
-        };
-        promptCapabilities?: {
-            audio?: boolean;
-            embeddedContext?: boolean;
-            image?: boolean;
-        };
-        sessionCapabilities?: Record<string, unknown>;
-        [key: string]: unknown;
-    };
-    /** Standard ACP agentInfo (official SDK field). */
-    agentInfo?: {
-        name: string;
-        version?: string;
-    };
-    authMethods?: Array<{
-        type: string;
-        [key: string]: unknown;
-    }>;
-}
-/** ACP session/new result (official: { sessionId, configOptions?, models?, modes? }). */
-export interface AcpSessionResult {
-    sessionId: string;
-}
-/** Standard ACP stopReason. */
-export type AcpStopReason = "end_turn" | "max_tokens" | "max_turn_requests" | "refusal" | "cancelled";
-/** ACP prompt response (official: { stopReason, usage?, userMessageId? }). */
-export interface AcpPromptResponse {
-    stopReason: AcpStopReason;
-    usage?: AcpPromptResponseUsage;
-    userMessageId?: string;
-    /** Aggregated text from session/update notifications (populated by adapter). */
-    text?: string;
-}
-/** ACP per-turn usage stats (aligned with SDK zUsage). */
-export interface AcpPromptResponseUsage {
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-    cachedReadTokens?: number;
-    cachedWriteTokens?: number;
-    thoughtTokens?: number;
-}
-/** ACP usage_update notification payload (session-level). */
-export interface AcpUsageUpdatePayload {
-    used?: number;
-    size?: number;
-    cost?: number;
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-}
-/** MCP server config to inject into ACP session/new. */
-export interface McpServerEnvEntry {
-    name: string;
-    value: string;
-}
-export interface McpServerConfig {
-    name: string;
-    command: string;
-    args: string[];
-    env?: McpServerEnvEntry[];
-}
-export interface SoloEvaluation {
-    winnerId: string;
-    reasoning: string;
-    /** True once the user adopted the winner's worktree changes into the workspace (solo.select).
-     *  Absent on the auto-judge recommendation — the UI keeps the adopt action visible until then. */
-    adopted?: boolean;
-    /** displayId of the agent that acted as judge — a competitor judging its own race is a
-     *  trust caveat the user must see, not a hidden implementation detail. */
-    judgedBy?: string;
-    /** True when the judge did NOT compete (preferred): an independent ready agent scored the race. */
-    judgeExternal?: boolean;
-    /** True when the verdict is a fallback (judge turn failed / unparseable response) rather than a
-     *  real comparison — the UI must flag it for manual review instead of presenting it as a ruling. */
-    degraded?: boolean;
-}
-/** Lightweight Spec (design D3): goal + constraints + acceptance, fits one screen. */
-export interface SoloSpec {
-    goal: string;
-    constraints: string[];
-    /** 3-5 checkable acceptance criteria — the evaluate scoring rubric. */
-    acceptance: string[];
-    /** Original raw task, kept for reference. */
-    rawTask: string;
-    /** Clarification Q&A trail (optional). */
-    clarifications?: {
-        question: string;
-        answer: string;
-    }[];
-}
-/** x/solo.specChat RPC params (R3 多轮对话式 spec)。history 含到本轮为止的完整对话(末条为用户最新消息)。 */
-export interface SoloSpecChatParams {
-    rawTask: string;
-    history: {
-        role: "user" | "assistant";
-        content: string;
-    }[];
-    projectId?: string;
-    /** 上一轮形成的规格草稿——回传给主持人做增量更新,防止第二轮起整份重写。 */
-    draft?: SoloSpec;
-}
-/** x/solo.specChat RPC result. */
-export interface SoloSpecChatResult {
-    reply?: string;
-    spec?: SoloSpec;
-    error?: string;
-}
-/** x/solo.specJudge RPC params/result(启动软门防呆:judge 最终 spec 质量)。 */
-export interface SoloSpecJudgeParams {
-    spec: SoloSpec;
-}
-export interface SoloSpecJudgeResult {
-    ok: boolean;
-    issues: string[];
-    /** True when ok=true came from a SKIPPED judgement (no LLM / judge call failed) — an unjudged
-     *  soft-gate pass, not a real "spec reviewed OK". Fail-open stays, but honestly labeled. */
-    judgeSkipped?: boolean;
-}
-export interface WorkflowChatContextCheckpoint {
-    protocolVersion: 1;
-    producer: "qlogicagent";
-    payload: {
-        messages: {
-            role: "user" | "assistant";
-            content: string;
-        }[];
-        /** Revisable conversation evidence. Deliberately has no ready/complete/pass gate. */
-        intentContract?: WorkflowIntentContract;
-    };
-}
-export interface WorkflowIntentContract {
-    revision: number;
-    observations: Array<{
-        id: string;
-        sequence: number;
-        text: string;
-    }>;
-    facts: Array<{
-        id: string;
-        statement: string;
-        confidence: "explicit" | "inferred";
-        sourceObservationIds: string[];
-        status: "active" | "superseded";
-    }>;
-    openQuestions: Array<{
-        id: string;
-        question: string;
-        sourceObservationIds: string[];
-        status: "open" | "resolved";
-    }>;
-    diagnostics: string[];
-}
-export interface WorkflowChatContextTurn {
-    sequence: number;
-    role: "user" | "assistant";
-    content: string;
-}
-/** x/workflow.chat RPC params(M4 自动化页对话式搭图/改图)。
- * Runtime Host 传入 durable checkpoint + checkpoint 之后的新消息。`history` 仅保留给显式
- * ephemeral 局部编辑，不再是持久化会话权威。 */
-export interface WorkflowChatParams {
-    context?: {
-        checkpoint: WorkflowChatContextCheckpoint | null;
-        newTurns: WorkflowChatContextTurn[];
-    };
-    /** Answered UI clarification ids. Resolves revisable evidence only; never marks the workflow complete. */
-    resolvedClarificationIds?: string[];
-    history?: {
-        role: "user" | "assistant";
-        content: string;
-    }[];
-    /** Registered project whose capability catalog and workflow draft are being edited. */
-    projectId: string;
-    /** Workflow currently edited. The Host injects this into connector tools. */
-    workflowId?: string;
-    /** Exact Runtime Host capability snapshot for this proposal round. */
-    capabilities: Array<{
-        category: string;
-        kind: string;
-        id: string;
-        label: string;
-        [key: string]: unknown;
-    }>;
-    currentWorkflow?: string;
-    /** Host-built bounded prompt context; full currentWorkflow stays compiler-only. */
-    editContext?: Record<string, unknown>;
-    /** D19 框选局部修改:框选的节点 id;非空 → agent 产 scoped proposal，由 Gateway Host 应用。 */
-    scope?: string[];
-}
-/** x/workflow.chat RPC result:one deterministic proposal compiled from bounded Agent operations.
- * Runtime Host is the only mutation owner; UI never receives or reapplies raw graph patches. */
-export interface WorkflowChatResult {
-    reply?: string;
-    proposal?: {
-        patch: unknown[];
-    };
-    error?: string;
-    /** propose 全被校验拒(无任何提案落地)时的显式失败:前端展示真实错误 + 重试出路,不许当正常回复。 */
-    rejected?: {
-        attempts: number;
-        errors: string[];
-    };
-    /** Agent-authored structured interaction. Transport only: not a save, finish, or proposal gate. */
-    clarify?: Array<{
-        intentQuestionId?: string;
-        id?: string;
-        purpose?: string;
-        nodeId?: string;
-        field?: string;
-        header: string;
-        question: string;
-        options?: Array<{
-            label: string;
-            description?: string;
-        }>;
-        multiSelect?: boolean;
-    }>;
-    /** qlogicagent-owned compact model context. Runtime stores this opaque payload separately from
-     *  the complete visible transcript and assigns the durable transcript boundary on commit. */
-    contextCheckpoint?: WorkflowChatContextCheckpoint;
-    semanticAcceptance?: Record<string, unknown>;
-    intentContract?: WorkflowIntentContract;
-    capabilitySelection?: string[];
-    /** Host-owned secure input request produced by a connector tool. */
-    pendingConnectorInput?: Record<string, unknown>;
-    /** Layered connector validation evidence; informative and never a uniform completion gate. */
-    connectorValidation?: Record<string, unknown>;
-}
-/** solo.start RPC params. */
-export interface SoloStartParams {
-    task: string;
-    agents: string[];
-    cwd: string;
-    /** Project ID that owns this solo session. Used for session storage routing. */
-    projectId: string;
-    /** Optional shared config injected into all agents (memory seed, rules, etc). */
-    sharedConfig?: {
-        /** Initial memory entries to seed into each agent's context. */
-        memory?: string[];
-        /** Rules/instructions to inject as system prompt prefix. */
-        rules?: string[];
-        /** Model override for all agents. */
-        model?: string;
-    };
-    /** Spec from the Spec phase; when present, injected into enrichedTask + persisted + used as evaluate rubric. */
-    spec?: SoloSpec;
-}
-/** Solo control RPC params. Status projection is Host-native and not an agent method. */
-export interface SoloIdParams {
-    soloId: string;
-}
-/** solo.select RPC params. */
-export interface SoloSelectParams {
-    soloId: string;
-    winnerId: string;
-}
-/** solo.message RPC params — send follow-up to individual agent. */
-export interface SoloMessageParams {
-    soloId: string;
-    agentId: string;
-    content: string;
-    /** For duplicate agentIds, specify which instance (0-based index). */
-    agentIndex?: number;
-}
-/** solo.evaluate RPC params — user-triggered evaluation with chosen evaluator. */
-export interface SoloEvaluateParams {
-    soloId: string;
-    /** Which agent in the solo session should perform the evaluation comparison. */
-    evaluatorAgentId: string;
-    /** For duplicate agentIds, specify which instance (0-based index). */
-    evaluatorIndex?: number;
-}
-export type ProductInstanceState = "idle" | "running" | "completed" | "failed" | "paused";
-/** Product budget configuration & runtime counters. */
-export interface ProductBudget {
-    maxTotalTokens?: number;
-    maxDuration?: number;
-    usedTokens: number;
-    inputTokens?: number;
-    outputTokens?: number;
-    elapsed: number;
-}
-/** product.create RPC params. */
-export interface ProductCreateParams {
-    /** Optional existing product ID, used when a confirmed planning session transitions into execution. */
-    productId?: string;
-    name: string;
-    cwd: string;
-    /** Project ID that owns this product session. Used for session storage routing. */
-    projectId: string;
-    instances: ProductInstanceDef[];
-    tasks: ProductTaskDef[];
-    budget?: {
-        maxTotalTokens?: number;
-        maxDuration?: number;
-    };
-    /**
-     * Durable per-turn policy inherited from a parent Goal. Product keeps member-specific model
-     * selection: modelId/reasoningEffort apply only to the native qlogicagent member, while Host
-     * permissions and active skills remain available to every supervised member.
-     */
-    turnContext?: {
-        modelId?: string;
-        reasoningEffort?: string;
-        permissions?: unknown;
-        activeSkills?: string[];
-        /** Native qlogicagent-only projection of the parent Goal for Agent-local compaction. */
-        goalContextEnvelope?: import("./chat-types.js").ContextEnvelope;
-    };
-}
-/**
- * product.plan RPC params — starts an interactive planning session.
- * The leader agent decomposes the goal into modules and proposes a DAG.
- */
-export interface ProductPlanParams {
-    /** High-level project goal (e.g. "build a multiplayer MMO game"). */
-    goal: string;
-    /** Working directory for the project. */
-    cwd: string;
-    /** Gateway project registry identity that owns the planning and execution run. */
-    projectId: string;
-    /** Gateway canonical session that owns the durable Product run. */
-    canonicalSessionId: string;
-    /** Which agent acts as the team leader (must be ACP-compatible). */
-    leaderAgentId: string;
-    /** Optional: project name. Leader can suggest one if omitted. */
-    name?: string;
-    /** Optional: budget constraints communicated to leader during planning. */
-    budget?: {
-        maxTotalTokens?: number;
-        maxDuration?: number;
-    };
-    /**
-     * Optional user-supplied allow-list of agent ids the selected leader may assign tasks to —
-     * during planning AND during execution-phase reassignment. The user picks WHICH agents participate;
-     * the leader still auto-plans + assigns, but only within this set.
-     *
-     * Semantics are PRESENCE-based (see buildAgentRoster) — an explicit `[]` differs from omitted:
-     *  - omitted / undefined → ALL ready agents.
-     *  - `[]` (explicit empty array) → ONLY `leaderAgentId`: the user deselected every worker.
-     *  - non-empty → the assignable roster = ready catalog entries whose id ∈ allowedAgents, PLUS the
-     *    selected leader. Product may use that leader as a single-agent executor; Goal keeps the selected
-     *    leader control-only whenever another ready worker exists.
-     */
-    allowedAgents?: string[];
-}
-/** The structured plan produced by the leader agent. */
-export interface ProductPlan {
-    /** Product/project name. */
-    name: string;
-    /** Modules the project is decomposed into. */
-    modules: Array<{
-        name: string;
-        description: string;
-        /** Suggested agent for this module (leader's recommendation). */
-        suggestedAgentId?: string;
-    }>;
-    /** Proposed team members (leader may suggest agents for each module). */
-    instances: ProductInstanceDef[];
-    /** Proposed task DAG. */
-    tasks: ProductTaskDef[];
-    /** Leader's explanation of the decomposition strategy. */
-    reasoning: string;
-}
-/**
- * product.confirm RPC params — user confirms (optionally modified) plan.
- * This starts the actual DAG execution with the leader managing progress.
- */
-export interface ProductConfirmParams {
-    /** The planning session product ID (returned by product.plan). */
-    productId: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-    /** Final instances (user may have reassigned agents). */
-    instances: ProductInstanceDef[];
-    /** Final task DAG (user may have modified). */
-    tasks: ProductTaskDef[];
-    /** Budget for execution phase. */
-    budget?: {
-        maxTotalTokens?: number;
-        maxDuration?: number;
-    };
-}
-/**
- * product.message RPC params — user sends a message to the leader during any phase.
- * Supports: multi-turn planning dialogue, and user intervention during execution.
- */
-export interface ProductMessageParams {
-    productId: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-    /** User's message content. */
-    content: string;
-}
-/** Exact user-authored edit to a running Product DAG. One RPC carries one atomic mutation. */
-export interface ProductDagMutationParams {
-    productId: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-    mutation: {
-        type: "add_dependency" | "remove_dependency";
-        taskId: string;
-        details: {
-            from: string;
-            to: string;
-        };
-    };
-}
-/** Product lifecycle RPC params. Status projection is Host-native and not an agent method. */
-export interface ProductIdParams {
-    productId: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-}
-/**
- * product.replay RPC params — re-run from an arbitrary completed/failed task forward.
- * Resets the task + its descendants to pending and reuses upstream (ancestor) outputs as context.
- */
-export interface ProductReplayParams {
-    productId: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-    taskId: string;
-}
-/** x/goal.start RPC params — launch a long-horizon goal run (instant, returns goalRunId). */
-export interface GoalStartParams {
-    goal: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-    agentPool: string[];
-    leaderAgentId: string;
-    budget?: {
-        maxTotalTokens?: number;
-        maxDurationMs?: number;
-    };
-    modelId?: string;
-    reasoningEffort?: string;
-    permissionPolicy?: unknown;
-    activeSkills?: string[];
-}
-/** x/goal.pause / x/goal.stop RPC params. Gateway derives the leader from the immutable session owner. */
-export interface GoalIdParams {
-    goalRunId: string;
-    projectId: string;
-    canonicalSessionId: string;
-    cwd: string;
-    leaderAgentId: string;
-}
-/** x/goal.resume RPC params — optionally update the goal on resume. */
-export interface GoalResumeParams extends GoalIdParams {
-    newGoal?: string;
-    additionalBudget?: {
-        maxTotalTokens?: number;
-        maxDurationMs?: number;
-    };
-}
-/** x/goal.updateGoal RPC params. */
-export interface GoalUpdateGoalParams extends GoalIdParams {
-    newGoal: string;
-}
-/** x/goal.message RPC params — queue a steering message for the next phase boundary. */
-export interface GoalMessageParams extends GoalIdParams {
-    text: string;
-    kind?: "instruction_once" | "constraint_add" | "constraint_remove" | "answer_to_blocker" | "priority_change";
-}
-/** Runtime instance state. */
-export interface ProductInstanceStatus {
-    instanceId: string;
-    name: string;
-    agentId: string;
-    state: ProductInstanceState;
-    worktreePath?: string;
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-}
-/** Runtime task state. */
-export interface ProductTaskState {
-    taskId: string;
-    assignee: string;
-    status: ProductTaskStatus;
-    result?: string;
-    error?: string;
-    startedAt?: string;
-    completedAt?: string;
-    /** Per-task token usage, surfaced for cost attribution in the task detail view. */
-    inputTokens?: number;
-    outputTokens?: number;
-    /** Relative paths of files the task produced. */
-    changedFiles?: string[];
-}
-/** solo.delete / solo.cancel cleanup RPC params. */
-export interface SoloDeleteParams {
-    soloId: string;
-}
-/** product.delete cleanup RPC params. */
-export interface ProductDeleteParams extends ProductIdParams {
-}
-export type { AgentSource } from "./notification-payloads.js";
-/** One row of the team roster shown to the leader during planning (soft capability hints only). */
-export interface AgentRosterEntry {
-    id: string;
-    name: string;
-    model?: string;
-    strengths: string;
-    isLeader: boolean;
-}

package/dist/types/protocol/wire/agent-events.d.ts

@@ -1 +0,0 @@
-export { AGENT_TEAM_WS_EVENT_NAMES, AGENT_WS_EVENT_NAMES, ALL_AGENT_WS_EVENT_NAMES, type AgentTeamWsEventName, type AgentWsEventName, type AllAgentWsEventName, } from "../agent-contract.js";