qlogicagent 2.3.0 → 2.4.0

package/dist/types/protocol/wire/web-capability.d.ts

@@ -0,0 +1,51 @@
+export declare const WEB_CAPABILITY_ID_VALUES: readonly ["web_search", "web_fetch", "deep_research", "browser_execution"];
+export type WebCapabilityId = (typeof WEB_CAPABILITY_ID_VALUES)[number];
+export declare const WEB_CAPABILITY_FAMILY_VALUES: readonly ["web-intelligence", "browser-execution"];
+export type WebCapabilityFamily = (typeof WEB_CAPABILITY_FAMILY_VALUES)[number];
+export declare const WEB_TASK_MODE_VALUES: readonly ["discovery", "read-url", "multi-source-research", "interactive-browser"];
+export type WebTaskMode = (typeof WEB_TASK_MODE_VALUES)[number];
+export declare const WEB_EXECUTION_MODE_VALUES: readonly ["stateless", "render-backend", "interactive-session"];
+export type WebExecutionMode = (typeof WEB_EXECUTION_MODE_VALUES)[number];
+export declare const WEB_STATEFULNESS_VALUES: readonly ["stateless", "stateless-single-step", "stateful-session-required"];
+export type WebStatefulness = (typeof WEB_STATEFULNESS_VALUES)[number];
+export declare const WEB_APPROVAL_DEFAULT_VALUES: readonly ["required", "conditional", "none"];
+export type WebApprovalDefault = (typeof WEB_APPROVAL_DEFAULT_VALUES)[number];
+export declare const WEB_POLICY_RISK_CLASS_VALUES: readonly ["browser-read", "browser-authenticated-read", "browser-state-changing"];
+export type WebPolicyRiskClass = (typeof WEB_POLICY_RISK_CLASS_VALUES)[number];
+export declare const WEB_ACTION_SCOPE_VALUES: readonly ["read-page", "read-authenticated-page", "fill-form", "submit-form", "download-file", "reuse-session"];
+export type WebActionScope = (typeof WEB_ACTION_SCOPE_VALUES)[number];
+export declare const WEB_DEGRADATION_TARGET_VALUES: readonly ["web_search", "web_fetch", "deep_research", "blocked"];
+export type WebDegradationTarget = (typeof WEB_DEGRADATION_TARGET_VALUES)[number];
+export declare const WEB_ESCALATION_REASON_VALUES: readonly ["requires-interaction", "requires-login-state", "requires-rendered-dom", "requires-persistent-session", "requires-state-changing-action"];
+export type WebEscalationReason = (typeof WEB_ESCALATION_REASON_VALUES)[number];
+export declare const WEB_RETRY_POLICY_VALUES: readonly ["none", "same-capability-once", "degrade-only"];
+export type WebRetryPolicy = (typeof WEB_RETRY_POLICY_VALUES)[number];
+export interface WebCapabilityDescriptorContract {
+    capabilityId?: WebCapabilityId;
+    capabilityFamily?: WebCapabilityFamily;
+    taskMode?: WebTaskMode;
+    executionMode?: WebExecutionMode;
+    statefulness?: WebStatefulness;
+    approvalDefault?: WebApprovalDefault;
+    policyRiskClass?: WebPolicyRiskClass;
+    requiresRuntimeBackend?: boolean;
+    requiresHostBridge?: boolean;
+    supportsRenderBackend?: boolean;
+    supportsLoginState?: boolean;
+    supportsPersistentProfile?: boolean;
+    supportsSharedSessionReuse?: boolean;
+    supportsTransactionality?: "read-only" | "state-changing";
+    allowedActionScopes?: WebActionScope[];
+    degradationTarget?: WebDegradationTarget;
+    upgradeTargets?: WebCapabilityId[];
+    fallbackChain?: Array<"render-backend">;
+    escalationReasons?: WebEscalationReason[];
+    auditRequired?: boolean;
+    requiresUserVisibleStep?: boolean;
+    retryPolicy?: WebRetryPolicy;
+    repairAfterDenied?: boolean;
+    repairAfterUnavailable?: boolean;
+    displayRiskLabel?: string;
+    displayBlockedLabel?: string;
+    displayFallbackLabel?: string;
+}

package/dist/types/runtime/hooks/memory-hooks.d.ts

@@ -1,5 +1,5 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
-import type { MemoryProvider } from "qlogicagent-runtime-contracts";
+import type { MemoryProvider } from "../../protocol/wire/index.js";
 import type { Memdir } from "../../skills/memory/memdir.js";
 export declare const MEMORY_PREFETCH_CONFIG: {
     readonly MAX_SESSION_BYTES: number;
@@ -43,7 +43,7 @@ export declare function createMemoryPrefetchState(): MemoryPrefetchState;
  * Returns a cleanup function to unregister.
  */
 export declare function registerMemoryHooks(hooks: HookRegistry, deps: MemoryHooksDeps, 
-/** Shared state — pass the same object across hook re-registrations in a session. */
+/** Shared state 鈥?pass the same object across hook re-registrations in a session. */
 prefetchState?: MemoryPrefetchState): () => void;
 export interface MemdirRecallHookDeps {
     /** MEMDIR instance (lazy: may be null at registration time). */

package/dist/types/runtime/infra/acp-types.d.ts

@@ -4,16 +4,8 @@
  * These types define the contract for discovering, registering, and managing
  * external ACP-compatible agent CLIs alongside qlogicagent's internal agents.
  */
-/**
- * Two-level agent taxonomy:
- *   - sub-agent: internal qlogicagent instance, budget/tool restricted
- *   - teammate:  external ACP CLI agent, full capability
- */
-export type AgentCategory = "sub-agent" | "teammate";
-/** Communication protocol with the agent. */
-export type AgentProtocol = "internal" | "acp";
-/** Agent availability status. */
-export type AgentStatus = "available" | "unavailable" | "handshake_failed" | "not_installed";
+import type { AgentCapabilities, CustomAgentDef, AgentConfig, ProductTaskStatus, ProductInstanceDef, ProductTaskDef } from "../../protocol/wire/index.js";
+export type { AgentCategory, AgentProtocol, AgentStatus, AgentCapabilities, AgentDescriptor, CustomAgentDef, AgentConfig, SoloState, SoloAgentState, SoloAgentResult, SoloStatus, ProductPhase, ProductTaskStatus, ProductInstanceDef, ProductTaskDef, ProductStatus, ProductSummary, } from "../../protocol/wire/index.js";
 /** Pre-defined configuration for a known ACP backend. */
 export interface AcpBackendConfig {
     /** Backend ID, e.g. "claude" | "codex" | "goose". */
@@ -39,45 +31,6 @@ export interface AcpBackendConfig {
     /** Environment variable name for the base URL. */
     baseUrlEnvVar?: string;
 }
-/** Capabilities discovered during ACP handshake. */
-export interface AgentCapabilities {
-    /** Whether the agent supports MCP server injection via session/new. */
-    supportsMcp: boolean;
-    /** Whether the agent supports session/resume. */
-    supportsResume: boolean;
-    /** Whether the agent sends usage_update notifications. */
-    supportsUsageUpdate: boolean;
-    /** Native skill directories, if any. */
-    skillsDirs?: string[];
-}
-/**
- * Descriptor for a discovered or registered agent.
- * Returned by `agents.scan` and `agents.list` RPCs.
- */
-export interface AgentDescriptor {
-    /** Backend ID, e.g. "claude", "codex", "qlogicagent". */
-    id: string;
-    /** Display name. */
-    name: string;
-    /** sub-agent (internal) or teammate (external). */
-    category: AgentCategory;
-    /** Communication protocol. */
-    protocol: AgentProtocol;
-    /** Current availability. */
-    status: AgentStatus;
-    /** Resolved CLI binary path (teammates only). */
-    cliPath?: string;
-    /** CLI version string (teammates only). */
-    version?: string;
-    /** Capabilities (populated after handshake). */
-    capabilities?: AgentCapabilities;
-    /** Whether auth is required. */
-    authRequired: boolean;
-    /** Whether user has configured this agent (apiKey / baseUrl). */
-    hasConfig: boolean;
-    /** Whether this agent supports LLM base URL redirection. */
-    supportsBaseUrlOverride: boolean;
-}
 /**
  * Extended descriptor for external agents,
  * used internally by AgentProcessManager to spawn.
@@ -94,36 +47,6 @@ export interface ExternalAgentDescriptor {
     /** Communication protocol. */
     protocol: "acp";
 }
-/** User-provided custom agent definition for agents.config RPC. */
-export interface CustomAgentDef {
-    /** Unique ID (user-chosen). */
-    id: string;
-    /** Display name. */
-    name: string;
-    /** CLI command or absolute path. */
-    cliCommand: string;
-    /** ACP mode launch arguments. */
-    acpArgs: string[];
-    /** Additional environment variables. */
-    env?: Record<string, string>;
-    /** Whether auth is required. */
-    authRequired?: boolean;
-    /** Native skill directories. */
-    skillsDirs?: string[];
-    /** Whether base URL override is supported. */
-    supportsBaseUrlOverride?: boolean;
-}
-/** Persisted per-agent configuration. */
-export interface AgentConfig {
-    apiKey?: string;
-    baseUrl?: string;
-    model?: string;
-    env?: Record<string, string>;
-    customArgs?: string[];
-    customCliPath?: string;
-    /** Model ID translation: qlogicModelId → externalModelId. */
-    modelIdMap?: Record<string, string>;
-}
 /** Root config store schema (persisted to JSON). */
 export interface AgentConfigStoreData {
     /** Global gateway proxy URL. */
@@ -226,31 +149,10 @@ export interface AgentsRemoveConfigParams {
 export interface AgentsSetGatewayParams {
     url: string;
 }
-export type SoloState = "running" | "evaluating" | "completed" | "cancelled" | "failed";
-export type SoloAgentState = "pending" | "running" | "completed" | "failed";
-export interface SoloAgentResult {
-    id: string;
-    state: SoloAgentState;
-    progress?: string;
-    resultText?: string;
-    diff?: string;
-    usage?: {
-        inputTokens: number;
-        outputTokens: number;
-    };
-    error?: string;
-    worktreePath?: string;
-}
 export interface SoloEvaluation {
     winnerId: string;
     reasoning: string;
 }
-export interface SoloStatus {
-    soloId: string;
-    state: SoloState;
-    agents: SoloAgentResult[];
-    evaluation?: SoloEvaluation;
-}
 /** solo.start RPC params. */
 export interface SoloStartParams {
     task: string;
@@ -266,9 +168,7 @@ export interface SoloSelectParams {
     soloId: string;
     winnerId: string;
 }
-export type ProductPhase = "active" | "paused" | "completed" | "failed";
 export type ProductInstanceState = "idle" | "running" | "completed" | "failed" | "paused";
-export type ProductTaskStatus = "pending" | "running" | "completed" | "failed" | "paused";
 /** Product budget configuration & runtime counters. */
 export interface ProductBudget {
     maxTotalTokens?: number;
@@ -276,19 +176,6 @@ export interface ProductBudget {
     usedTokens: number;
     elapsed: number;
 }
-/** Instance definition within a product. */
-export interface ProductInstanceDef {
-    name: string;
-    role: string;
-    agentId: string;
-}
-/** Task definition within a product DAG. */
-export interface ProductTaskDef {
-    taskId: string;
-    assignee: string;
-    prompt: string;
-    dependsOn?: string[];
-}
 /** product.create RPC params. */
 export interface ProductCreateParams {
     name: string;
@@ -326,27 +213,6 @@ export interface ProductTaskState {
     startedAt?: string;
     completedAt?: string;
 }
-/** Full product status (product.status response). */
-export interface ProductStatus {
-    productId: string;
-    name: string;
-    phase: ProductPhase;
-    instances: ProductInstanceStatus[];
-    tasks: ProductTaskState[];
-    budget: ProductBudget;
-    lastCheckpointAt: string;
-}
-/** Summary for product.list response. */
-export interface ProductSummary {
-    productId: string;
-    name: string;
-    phase: ProductPhase;
-    instanceCount: number;
-    taskCount: number;
-    completedTasks: number;
-    createdAt: string;
-    lastCheckpointAt: string;
-}
 /** agents.getGateway response. */
 export interface AgentsGetGatewayResult {
     url?: string;
@@ -402,9 +268,4 @@ export interface SoloDeleteParams {
 export interface ProductDeleteParams {
     productId: string;
 }
-/** Agent source attribution, attached to turn events when delegated. */
-export interface AgentSource {
-    id: string;
-    name: string;
-    role: "main" | "teammate";
-}
+export type { AgentSource } from "../../protocol/wire/index.js";

package/dist/types/runtime/infra/token-budget.d.ts

@@ -1,11 +1,11 @@
 /**
- * Sub-agent Token Budget Enforcer — CC-aligned budget limits.
+ * Sub-agent Token Budget Enforcer 鈥?CC-aligned budget limits.
  *
  * Prevents sub-agents from consuming infinite tokens by:
  *   1. Per-task token budget (from TaskStateBase.tokenBudget)
  *   2. Session-level aggregate budget (all tasks combined)
  *   3. Budget continuation messages (CC tokenBudget.ts pattern)
- *   4. Graceful degradation (warn → force-stop, never hard-crash)
+ *   4. Graceful degradation (warn 鈫?force-stop, never hard-crash)
  *
  * CC reference: utils/tokenBudget.ts, main.tsx --max-budget-usd / --task-budget
  *
@@ -13,7 +13,7 @@
  * CC has no explicit per-sub-agent budget; they rely on session-level maxBudgetUsd.
  * We add per-task enforcement to prevent a single sub-agent from exhausting the budget.
  */
-import type { TokenUsage } from "../../agent/types.js";
+import type { WireTokenUsage as TokenUsage } from "../../protocol/wire/index.js";
 export interface BudgetConfig {
     /** Per-task token budget (prompt + completion). 0 = unlimited. */
     taskBudgetTokens: number;

package/dist/types/runtime/session/index.d.ts

@@ -1,2 +1,2 @@
 export { SessionState, type SessionUsageSnapshot, type SessionCostSnapshot } from "./session-state.js";
-export { appendMessage, saveSessionState, loadSessionForResume, listSessions, deleteSession, pruneOldSessions, shouldGenerateTaskSummary, maybeGenerateTaskSummary, type SessionMetadata, type PersistedSession, type SessionListEntry, type TaskSummaryDeps, } from "./session-persistence.js";
+export { appendMessage, saveSessionState, updateSessionMetadata, loadSessionForResume, listSessions, deleteSession, pruneOldSessions, shouldGenerateTaskSummary, maybeGenerateTaskSummary, type SessionMetadata, type PersistedSession, type SessionListEntry, type TaskSummaryDeps, } from "./session-persistence.js";

package/dist/types/runtime/session/session-memory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SessionMemory 鈥?In-memory session message store with JSONL persistence.
+ *
+ * CC alignment: messages live in memory during the session lifetime.
+ * JSONL is the sole persistent source of truth (for crash recovery).
+ * Gateway never owns message data 鈥?Agent is the single authority.
+ *
+ * Design:
+ *   - Map<sessionId, ChatMessage[]> holds active session messages
+ *   - On first access, lazy-loads from transcript.jsonl
+ *   - appendMessage() writes to memory AND appends to JSONL atomically
+ *   - getMessages() returns from memory (no disk I/O on hot path)
+ */
+import type { ChatMessage } from "../../protocol/wire/index.js";
+export declare class SessionMemory {
+    private sessions;
+    private projectRoot;
+    constructor(projectRoot?: string);
+    setProjectRoot(projectRoot: string): void;
+    /**
+     * Get messages for a session. Lazy-loads from JSONL on first access.
+     */
+    getMessages(sessionId: string): ChatMessage[];
+    /**
+     * Append a message to session memory and persist to JSONL.
+     */
+    appendMessage(sessionId: string, message: ChatMessage, turnId?: string): void;
+    /**
+     * Check if a session is loaded in memory.
+     */
+    hasSession(sessionId: string): boolean;
+    /**
+     * Initialize an empty session (for newly created sessions).
+     */
+    initSession(sessionId: string): void;
+    /**
+     * Drop a session from memory (e.g., on session.ended).
+     * Does NOT delete JSONL 鈥?data persists for future resume.
+     */
+    evictSession(sessionId: string): void;
+    /**
+     * Get the count of messages in a session.
+     */
+    getMessageCount(sessionId: string): number;
+    private loadFromDisk;
+}

package/dist/types/runtime/session/session-persistence.d.ts

@@ -1,5 +1,5 @@
 /**
- * Session Persistence — CC sessionRestore.ts + conversationRecovery.ts parity.
+ * Session Persistence 鈥?CC sessionRestore.ts + conversationRecovery.ts parity.
  *
  * Enables conversation resume by persisting:
  *   1. Message transcript (JSONL-based, append-only)
@@ -9,18 +9,18 @@
  * Storage layout:
  *   <project>/.qlogicagent/sessions/<session-id>/   (when projectRoot provided)
  *   ~/.qlogicagent/sessions/<session-id>/            (fallback)
- *     transcript.jsonl   — append-only message log
- *     state.json          — cost snapshot + metadata
+ *     transcript.jsonl   鈥?append-only message log
+ *     state.json          鈥?cost snapshot + metadata
  *
  * Resume flow (CC processResumedConversation parity):
- *   1. loadSessionForResume(sessionId) → messages + cost
+ *   1. loadSessionForResume(sessionId) 鈫?messages + cost
  *   2. Restore cost state into SessionState
  *   3. Feed messages as initial context to agent
  *
  * Reference: claude-code src/utils/sessionRestore.ts
  *            claude-code src/utils/conversationRecovery.ts
  */
-import type { ChatMessage } from "../../agent/types.js";
+import type { ChatMessage } from "../../protocol/wire/index.js";
 import type { SessionCostSnapshot } from "./session-state.js";
 export interface SessionMetadata {
     sessionId: string;
@@ -36,6 +36,22 @@ export interface SessionMetadata {
     taskSummary?: string;
     /** Timestamp of last task summary generation */
     taskSummaryGeneratedAt?: number;
+    /** ISO timestamp 鈥?session pinned in UI */
+    pinnedAt?: string;
+    /** ISO timestamp 鈥?session archived (soft-deleted) */
+    archivedAt?: string;
+    /** Project ID this session belongs to */
+    projectId?: string;
+    /** Session type: personal or group */
+    type?: "personal" | "group";
+    /** Owner user ID */
+    ownerId?: string;
+    /** Group key for group sessions */
+    groupKey?: string;
+    /** Group display name */
+    groupName?: string;
+    /** Group platform (wechat, dingtalk, etc.) */
+    groupPlatform?: string;
 }
 export interface PersistedSession {
     metadata: SessionMetadata;
@@ -48,6 +64,11 @@ export interface SessionListEntry {
     lastActiveAt: number;
     messageCount: number;
     model?: string;
+    pinnedAt?: string;
+    archivedAt?: string;
+    projectId?: string;
+    type?: "personal" | "group";
+    createdAt?: number;
 }
 /**
  * Append a message to the session transcript.
@@ -61,13 +82,18 @@ export declare function appendMessage(sessionId: string, message: ChatMessage, p
  */
 export declare function saveSessionState(sessionId: string, costSnapshot: SessionCostSnapshot, metadata: Partial<SessionMetadata>, projectRoot?: string): Promise<void>;
 /**
- * Load a persisted session for resume — CC loadConversationForResume parity.
+ * Update specific metadata fields of a session without touching cost data.
+ * Used by session CRUD RPC (rename, pin, archive, move-to-project).
+ */
+export declare function updateSessionMetadata(sessionId: string, patch: Partial<SessionMetadata>, projectRoot?: string): Promise<SessionMetadata | null>;
+/**
+ * Load a persisted session for resume 鈥?CC loadConversationForResume parity.
  *
  * Returns null if the session doesn't exist or is corrupted.
  */
 export declare function loadSessionForResume(sessionId: string, projectRoot?: string): Promise<PersistedSession | null>;
 /**
- * List available sessions for resume — CC ResumeConversation picker.
+ * List available sessions for resume 鈥?CC ResumeConversation picker.
  * Returns most-recent-first, up to `limit` entries.
  */
 export declare function listSessions(limit?: number, projectRoot?: string): Promise<SessionListEntry[]>;
@@ -92,6 +118,6 @@ export interface TaskSummaryDeps {
 export declare function shouldGenerateTaskSummary(metadata: SessionMetadata): boolean;
 /**
  * Generate and persist a task summary for a long session.
- * Fire-and-forget — errors are swallowed.
+ * Fire-and-forget 鈥?errors are swallowed.
  */
 export declare function maybeGenerateTaskSummary(sessionId: string, metadata: SessionMetadata, recentMessages: ChatMessage[], deps: TaskSummaryDeps, projectRoot?: string): Promise<string | null>;

package/dist/types/runtime/session/session-state.d.ts

@@ -1,5 +1,5 @@
 /**
- * Session State — CC session state parity.
+ * Session State 鈥?CC session state parity.
  *
  * Unified state container for a single agent session:
  *   - Token usage / cost accumulation across turns
@@ -13,8 +13,8 @@
  *
  * Reference: claude-code src/bootstrap/state.ts, src/cost-tracker.ts
  */
-import type { TokenUsage } from "../../agent/types.js";
-/** Per-model usage accumulation — CC modelUsage parity */
+import type { WireTokenUsage as TokenUsage } from "../../protocol/wire/index.js";
+/** Per-model usage accumulation 鈥?CC modelUsage parity */
 export interface ModelUsage {
     inputTokens: number;
     outputTokens: number;
@@ -59,7 +59,7 @@ export declare class SessionState {
     /** Get all model usages as a plain object */
     getAllModelUsage(): Record<string, ModelUsage>;
     /**
-     * Add usage from an API response — CC addToTotalSessionCost() parity.
+     * Add usage from an API response 鈥?CC addToTotalSessionCost() parity.
      * Tracks token counts only; pricing is handled by Hub/Admin.
      *
      * @param usage - Token counts from the API response

package/dist/types/skills/memory/memory-tool.d.ts

@@ -1,4 +1,4 @@
-import type { MemoryProvider, MemorySearchResult } from "qlogicagent-runtime-contracts";
+import type { MemoryProvider, MemorySearchResult } from "../../protocol/wire/index.js";
 import type { Memdir } from "./memdir.js";
 export declare const MEMORY_TOOL_NAME: "memory";
 export declare const MEMORY_TOOL_LABEL = "Memory";

package/dist/types/skills/memory/qmemory-adapter.d.ts

@@ -1,4 +1,4 @@
-import type { MemoryIngestOptions, MemoryProvider } from "qlogicagent-runtime-contracts";
+import type { MemoryIngestOptions, MemoryProvider } from "../../protocol/wire/index.js";
 /** A pre-extracted memory item ready to be stored (no LLM needed). */
 export interface ExtractedMemoryItem {
     text: string;

package/dist/types/skills/permissions/hook-runner.d.ts

@@ -1,5 +1,5 @@
 import type { HookRegistry } from "../../contracts/hooks.js";
-import type { ToolDefinition } from "../../agent/types.js";
+import type { ToolDefinition } from "../../protocol/wire/index.js";
 import { PermissionRuleEngine } from "./rule-engine.js";
 import type { PermissionUpdate, ApprovalRequest, ApprovalResponse } from "./types.js";
 import { type ClassifierLLMCall } from "./permission-classifier.js";
@@ -47,11 +47,11 @@ export declare class PermissionChecker {
     private readonly permissionRole;
     private readonly pendingApprovals;
     private unregisterHook;
-    /** Tool meta cache — populated from ToolDefinition[] at agent creation */
+    /** Tool meta cache 鈥?populated from ToolDefinition[] at agent creation */
     private toolMetaCache;
-    /** Classifier result cache — avoids redundant LLM calls (CC permissionCache parity) */
+    /** Classifier result cache 鈥?avoids redundant LLM calls (CC permissionCache parity) */
     private classifierCache;
-    /** Denial tracking state — CC denialTracking.ts parity */
+    /** Denial tracking state 鈥?CC denialTracking.ts parity */
     private denialTracking;
     constructor(deps: PermissionCheckerDeps);
     /**

package/dist/types/skills/permissions/permission-classifier.d.ts

@@ -1,4 +1,4 @@
-import type { ChatMessage } from "../../agent/types.js";
+import type { ChatMessage } from "../../protocol/wire/index.js";
 export interface ClassifierResult {
     shouldBlock: boolean;
     reason: string;
@@ -6,7 +6,7 @@ export interface ClassifierResult {
     durationMs: number;
 }
 /**
- * LLM call interface — injected by the host so the classifier
+ * LLM call interface 鈥?injected by the host so the classifier
  * doesn't depend on a specific LLM client.
  */
 export interface ClassifierLLMCall {

package/dist/types/skills/tools/project-switch-tool.d.ts

@@ -0,0 +1,24 @@
+import type { PortableTool } from "../portable-tool.js";
+export declare const PROJECT_SWITCH_TOOL_NAME: "project_switch";
+export interface ProjectSwitchToolParams {
+    projectName: string;
+}
+export interface ProjectSwitchToolDeps {
+    listProjects: () => Array<{
+        id: string;
+        name: string;
+        workspaceDir: string;
+    }>;
+    switchProject: (projectId: string) => {
+        id: string;
+        name: string;
+        workspaceDir: string;
+    } | null;
+    /** Called after a successful switch so the host can update cwd/notifications. */
+    onSwitched?: (project: {
+        id: string;
+        name: string;
+        workspaceDir: string;
+    }) => void;
+}
+export declare function createProjectSwitchTool(deps: ProjectSwitchToolDeps): PortableTool<ProjectSwitchToolParams>;

package/dist/types/skills/tools.d.ts

@@ -1,5 +1,5 @@
 /**
- * Tool Registry — CC-aligned getAllBaseTools() pattern.
+ * Tool Registry 鈥?CC-aligned getAllBaseTools() pattern.
  *
  * CC reference: claude-code-haha/src/tools.ts
  *
@@ -12,7 +12,7 @@
  * The registration pattern is aligned: pure function returns array.
  */
 import type { PortableTool } from "./portable-tool.js";
-import type { ToolDefinition } from "../agent/types.js";
+import type { ToolDefinition } from "../protocol/wire/index.js";
 import { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent } from "../agent/tool-access.js";
 export { AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent };
 /**
@@ -52,14 +52,14 @@ export declare function getToolCount(): number;
  */
 export declare function executeTool(name: string, toolCallId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<import("./portable-tool.js").PortableToolResult>;
 /**
- * CC: getTools() — return all enabled tools.
+ * CC: getTools() 鈥?return all enabled tools.
  * Filters the pool by isEnabled() gate; disabled tools are invisible to callers.
  * CC reference: claude-code-haha/src/tools.ts getTools()
  */
 export declare function getTools(): PortableTool[];
 /**
  * Activate a deferred tool so it appears in subsequent LLM manifests.
- * CC parity: tool_search select: → activateTool → tool included in manifest.
+ * CC parity: tool_search select: 鈫?activateTool 鈫?tool included in manifest.
  * Returns true if the tool exists, is enabled, and was activated.
  */
 export declare function activateTool(name: string): boolean;
@@ -73,7 +73,7 @@ export declare function isToolActivated(name: string): boolean;
 export declare function clearActivatedTools(): void;
 /**
  * Generate ToolDefinition[] manifest for LLM tool_use.
- * Filters by isEnabled() — disabled tools never reach the model.
+ * Filters by isEnabled() 鈥?disabled tools never reach the model.
  * Deferred tools are excluded UNLESS they have been activated via tool_search.
  * CC: getTools() + manifest generation combined.
  */

package/dist/types/transport/acp-event-emitter.d.ts

@@ -1,5 +1,5 @@
 /**
- * ACP Event Emitter — translates internal qlogicagent notifications to ACP
+ * ACP Event Emitter 鈥?translates internal qlogicagent notifications to ACP
  * session/update notifications.
  *
  * Maps the 47+ internal notification methods (turn.delta, turn.tool_call, etc.)