qlogicagent 0.5.3 → 0.6.0

package/dist/types/cli/tool-bootstrap.d.ts

@@ -1,6 +1,21 @@
-import { ToolRegistry } from "../skills/tool-registry.js";
+import type { PortableTool } from "../skills/portable-tool.js";
 import { type ExecProgress } from "../skills/tools/exec-tool.js";
 import type { AgentLogger } from "../agent/types.js";
+export interface MediaRelayConfig {
+    imageEndpoint?: string;
+    ttsEndpoint?: string;
+    videoEndpoint?: string;
+    videoEditEndpoint?: string;
+    videoMergeEndpoint?: string;
+    videoUpscaleEndpoint?: string;
+    musicEndpoint?: string;
+}
+/**
+ * Set the media relay config for multimedia tools.
+ * CC parity: tools use isEnabled() gates instead of conditional addTool().
+ * Call this before getAllBaseTools() or when config changes.
+ */
+export declare function setMediaConfig(config: MediaRelayConfig | undefined): void;
 export interface BootstrapConfig {
     workdir?: string;
     log?: AgentLogger;
@@ -8,12 +23,16 @@ export interface BootstrapConfig {
     onExecProgress?(progress: ExecProgress): void;
 }
 /**
- * Create and populate a ToolRegistry with all locally-executable tools.
+ * Create all locally-executable tools and install into centralized tool pool.
+ *
+ * CC parity: getAllBaseTools() returns flat array, installed via setToolPool().
+ * Tools execute IN-PROCESS (zero IPC).
  *
- * Tools registered here execute IN-PROCESS (zero IPC).
- * All tools are agent-local — no Gateway relay.
+ * @alias initToolDeps — kept for backward compat with existing call sites.
  */
-export declare function bootstrapToolRegistry(config?: BootstrapConfig): ToolRegistry;
+export declare function getAllBaseTools(config?: BootstrapConfig): PortableTool[];
+/** @deprecated Use getAllBaseTools() instead. */
+export declare const initToolDeps: typeof getAllBaseTools;
 /**
  * Update the working directory for all local tool deps.
  * Called when Gateway sends a new workdir via config.

package/dist/types/cli/transport.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Transport — abstract I/O layer for JSON-RPC message exchange.
+ *
+ * Decouples the agent protocol handler from the physical transport
+ * (stdin/stdout, WebSocket, Unix Domain Socket, etc.).
+ *
+ * Each transport reads incoming JSON-RPC messages and emits them
+ * to a registered handler; outgoing messages are sent via send().
+ */
+export interface Transport {
+    /** Register the message handler (called for each valid parsed message). */
+    onMessage(handler: (msg: unknown) => void): void;
+    /** Register the close handler (called when the transport closes). */
+    onClose(handler: () => void): void;
+    /** Send a JSON-RPC message (object will be serialized to JSON). */
+    send(msg: unknown): void;
+    /** Start listening for incoming messages. */
+    start(): void;
+    /** Close the transport gracefully. */
+    close(): void;
+}
+/**
+ * Line-delimited JSON over stdin/stdout.
+ * Each line on stdin is a JSON message; each send() writes one JSON line to stdout.
+ * All diagnostic logging goes to stderr.
+ */
+export declare class StdioTransport implements Transport {
+    private messageHandler;
+    private closeHandler;
+    private verbose;
+    constructor(opts?: {
+        verbose?: boolean;
+    });
+    onMessage(handler: (msg: unknown) => void): void;
+    onClose(handler: () => void): void;
+    send(msg: unknown): void;
+    start(): void;
+    close(): void;
+    private log;
+}

package/dist/types/contracts/index.d.ts

@@ -7,4 +7,3 @@
 export * from "./planner.js";
 export * from "./todo.js";
 export * from "./hooks.js";
-export * from "./skill-candidate.js";

package/dist/types/contracts/todo.d.ts

@@ -4,11 +4,20 @@ export interface TodoItem {
     id: number;
     title: string;
     status: TodoItemStatus;
+    /** Detailed task description (V2). */
+    description?: string;
+    /** Owner agent/subagent identifier for per-agent isolation (V2). */
+    owner?: string;
+    /** IDs of tasks that must complete before this one can start (V2). */
+    blockedBy?: number[];
+    /** IDs of tasks this one blocks from starting (V2). */
+    blocks?: number[];
 }
 export interface TodoListSummary {
     total: number;
     completed: number;
     inProgress: number;
     notStarted: number;
+    blocked: number;
 }
 export declare function summarizeTodoList(items: readonly TodoItem[]): TodoListSummary;

package/dist/types/index.d.ts

@@ -7,6 +7,9 @@ export { Agent } from "./agent/agent.js";
 export type { AgentLogger, ChatMessage, ToolDefinition, ToolInvoker, TurnConfig, TurnEvent, TurnRequest, HookRegistry, } from "./agent/types.js";
 export { parseCliArgs } from "./config/config.js";
 export type { AgentConfig } from "./config/config.js";
+export type { Transport } from "./cli/transport.js";
+export { StdioTransport } from "./cli/transport.js";
+export { StdioServer, type StdioServerConfig } from "./cli/stdio-server.js";
 export { ProviderRegistry, createLLMClient, autoDetectProvider, } from "./llm/index.js";
 export type { LLMTransport, LLMRequest, LLMChunk } from "./llm/index.js";
 export { createHookRegistry } from "./runtime/hooks/hook-registry.js";

package/dist/types/llm/model-catalog.d.ts

@@ -6,7 +6,7 @@
  *
  * Three-layer fallback:
  *   1. In-memory cache (process-level, TTL check against disk mtime)
- *   2. Disk cache (~/.openclaw/cache/model_catalog.json)
+ *   2. Disk cache (~/.qlogicagent/cache/model_catalog.json)
  *   3. Remote fetch (https://models.dev/api.json)
  *   4. Stale disk cache (if remote fails)
  *   5. Empty (caller falls back to builtin-providers.ts hardcoded)

package/dist/types/orchestration/index.d.ts

@@ -1,113 +1,15 @@
-export { buildAssistantToolCallMessage, buildToolResultMessage, type FunctionToolDefinition, } from "./tool-schema.js";
-export { classifyError, getRetryStrategy, type ErrorCategory, type RetryStrategy, } from "./error-classification.js";
-export { composeStrategies, composeAsyncStrategies, SlidingWindowStrategy, SummarizeOldStrategy, ToolResultTrimStrategy, HeadTailProtectedStrategy, IncrementalCompactStrategy, CacheAwareCompressionStrategy, CompressionMetricsCollector, ContextEngineRegistry, MicroCompactStrategy, postCompactFileRecovery, type PostCompactRecoveryConfig, buildStructuredSummaryPrompt, computeAdaptiveBudget, isAsyncCompressionStrategy, selectCompressionTier, DEFAULT_ADAPTIVE_BUDGET_CONFIG, type AdaptiveBudgetConfig, type AsyncCompressionStrategy, type CacheAwareCompressionConfig, type CompressibleMessage, type CompressionEvent, type CompressionMetrics, type CompressionMetricsSnapshot, type CompressionResult, type CompressionStrategy, type CompressionTier, type ContextEngine, type HeadTailProtectionConfig, type IncrementalCompactConfig, type SummarizeFn, } from "./context-compression.js";
-export { snipCompactIfNeeded, type SnipResult, } from "./context-compression.js";
-export { applyCollapsesIfNeeded as applyContextCollapsesIfNeeded, recoverFromOverflow as recoverContextCollapseFromOverflow, createCollapseStore, type CollapseStore, type CollapseStage, } from "./context-collapse.js";
+export { buildAssistantToolCallMessage, buildToolResultMessage, type FunctionToolDefinition, } from "./tool-loop/tool-schema.js";
+export { classifyError, getRetryStrategy, type ErrorCategory, type RetryStrategy, } from "./error-handling/error-classification.js";
+export { composeStrategies, composeAsyncStrategies, SlidingWindowStrategy, SummarizeOldStrategy, ToolResultTrimStrategy, HeadTailProtectedStrategy, IncrementalCompactStrategy, CacheAwareCompressionStrategy, CompressionMetricsCollector, ContextEngineRegistry, MicroCompactStrategy, postCompactFileRecovery, type PostCompactRecoveryConfig, buildStructuredSummaryPrompt, computeAdaptiveBudget, isAsyncCompressionStrategy, selectCompressionTier, DEFAULT_ADAPTIVE_BUDGET_CONFIG, type AdaptiveBudgetConfig, type AsyncCompressionStrategy, type CacheAwareCompressionConfig, type CompressibleMessage, type CompressionEvent, type CompressionMetrics, type CompressionMetricsSnapshot, type CompressionResult, type CompressionStrategy, type CompressionTier, type ContextEngine, type HeadTailProtectionConfig, type IncrementalCompactConfig, type SummarizeFn, } from "./context/context-compression.js";
+export { snipCompactIfNeeded, type SnipResult, } from "./context/context-compression.js";
+export { applyCollapsesIfNeeded as applyContextCollapsesIfNeeded, recoverFromOverflow as recoverContextCollapseFromOverflow, createCollapseStore, type CollapseStore, type CollapseStage, } from "./context/context-collapse.js";
 export { buildSkillInstruction, type SkillCreateInstruction, type SkillImproveInstruction, type SkillInstruction, type SkillTurnResult, } from "./skill-improvement.js";
-export { buildSkillCandidateEffectivenessSummary, buildSkillCandidateEvidencePayload, buildSkillCandidateImprovementEvidenceBundle, buildSkillCandidateLatestReview, createDefaultSkillImprovementPolicy, normalizeSkillImprovementPolicy, type SkillCandidateImprovementEvidenceBundleContract, type SkillImprovementPolicyContract, } from "./skill-candidate.js";
-export declare const SIDECHAIN_TYPE_VALUES: readonly ["research", "planner", "plan-repair", "code-repair", "media-prep"];
-export type SidechainType = typeof SIDECHAIN_TYPE_VALUES[number];
-export type SidechainBudgetTier = "low" | "medium" | "high";
-export type SidechainMergePolicy = "summary-only" | "append-messages" | "replace-context" | "manual";
-export type SidechainToolAccessMode = "full" | "read-only" | "none";
-export interface SidechainTypePolicy {
-    type: SidechainType;
-    label: string;
-    description: string;
-    mergePolicy: SidechainMergePolicy;
-    budgetTier: SidechainBudgetTier;
-    budgetWeight: number;
-    preferFullContext: boolean;
-    preserveConversationHistory: boolean;
-    toolAccessMode: SidechainToolAccessMode;
-}
-export type SidechainToolAccessDecision = "allowed" | "denied";
-export type SidechainToolAccessInheritance = "inherit" | "shrink";
-export type SidechainToolAccessReason = "default-allow" | "always-deny" | "leaf-deny";
-export interface SidechainToolAccessRule {
-    toolName: string;
-    decision: SidechainToolAccessDecision;
-    inheritance: SidechainToolAccessInheritance;
-    reason: SidechainToolAccessReason;
-}
-export interface SidechainToolAccessPolicy {
-    deniedTools: string[];
-    canSpawnChildren: boolean;
-    defaultDecision: "allowed";
-    defaultInheritance: "inherit";
-    tools: SidechainToolAccessRule[];
-}
-export declare const SIDECHAIN_TOOL_DENY_ALWAYS: readonly ["gateway", "agents_list", "whatsapp_login", "session_status", "cron", "memory_query", "sessions_send"];
-export declare const SIDECHAIN_TOOL_DENY_LEAF: readonly ["sessions_list", "sessions_history", "sessions_spawn"];
-/** Tools that perform write/mutation operations — denied in read-only sidechain types. */
-export declare const SIDECHAIN_TOOL_DENY_WRITE: readonly ["file_edit", "create_file", "replace_string_in_file", "multi_replace_string_in_file", "create_directory", "run_in_terminal", "run_command", "delete_file", "rename_file", "move_file", "git_commit", "git_push", "manage_todo_list"];
-export declare function resolveSidechainToolAccessPolicy(params?: {
-    depth?: number;
-    maxDepth?: number;
-    role?: "leaf" | "orchestrator";
-    toolNames?: Iterable<string>;
-}): SidechainToolAccessPolicy;
-/**
- * Resolve tool access policy for a specific sidechain type.
- * Combines depth-based deny lists with type-specific access mode:
- * - "full": only depth-based denials apply
- * - "read-only": depth-based + all write/mutation tools denied
- * - "none": all tools denied
- */
-export declare function resolveSidechainToolAccessByType(params: {
-    type: SidechainType;
-    depth?: number;
-    maxDepth?: number;
-    role?: "leaf" | "orchestrator";
-    toolNames?: Iterable<string>;
-}): SidechainToolAccessPolicy;
-export interface ToolCallAccessFilterResult<T> {
-    allowed: T[];
-    denied: Array<{
-        toolCall: T;
-        reason: string;
-    }>;
-}
-/**
- * Filter tool_calls against a resolved access policy.
- * Returns allowed calls and denied calls with reasons.
- * T must have at least { id: string; function: { name: string } }.
- */
-export declare function filterToolCallsByAccessPolicy<T extends {
-    id: string;
-    function: {
-        name: string;
-    };
-}>(toolCalls: T[], policy: SidechainToolAccessPolicy): ToolCallAccessFilterResult<T>;
-export declare function listSidechainTypePolicies(): SidechainTypePolicy[];
-export declare function resolveSidechainTypePolicy(type: SidechainType): SidechainTypePolicy;
-export declare function resolveRepairSidechainType(params?: {
-    toolNames?: Iterable<string>;
-    preferCodeRepair?: boolean;
-    trigger?: string;
-}): Extract<SidechainType, "plan-repair" | "code-repair">;
-export declare function resolveSidechainMergePolicyByType(type: SidechainType, overrides?: {
-    forceManualReview?: boolean;
-    preferFullContext?: boolean;
-    preserveConversationHistory?: boolean;
-}): SidechainMergePolicy;
-export declare function resolveSidechainMergePolicy(params?: {
-    preferFullContext?: boolean;
-    forceManualReview?: boolean;
-    preserveConversationHistory?: boolean;
-}): SidechainMergePolicy;
-export { applyToolChoicePolicy, type ApplyToolChoicePolicyInput, type ApplyToolChoicePolicyResult, } from "./tool-choice-policy.js";
-export { repairOpenAiChatConversation, type ConversationRepairOptions, type OpenAiChatMessageLike, type OpenAiToolCall, } from "./conversation-repair.js";
-export { advanceToolLoopState, recoverToolLoopStateFromChatConversation, recoverToolLoopStateFromResponsesItems, settleToolLoopState, type RepairToolLoopStateResult, type ToolLoopRepairAction, type ToolLoopState, } from "./tool-loop-state.js";
-export { MEMORY_OBSERVATION_HOOK_VALUES, MEMORY_OBSERVATION_SOURCE_VALUES, MEMORY_WRITE_ACCESS_VALUES, type MemoryObservationHook, type MemoryObservationSource, type MemoryWriteAccess, type MemoryProviderLifecycleInvocation, } from "./memory-provider.js";
-export { isForegroundSource, isTransientCapacityError, computeRetryBackoff, isPersistentRetryEnabled, FallbackTriggeredError, type PersistentRetryConfig, } from "./retry-loop.js";
-export { computeLifecycleTransitions, DEFAULT_CURATOR_SCHEDULE_POLICY, INITIAL_CURATOR_STATE, selectReviewCandidates, shouldRunCurator, type CuratorAutoTransitionResult, type CuratorGateInput, type CuratorGateResult, type CuratorLifecycleTransition, type CuratorSchedulePolicy, type CuratorSkillLifecycleState, type CuratorSkillRecord, type CuratorState, } from "./curator-scheduler.js";
-export { buildConsolidationPrompt, buildCuratorRunSummary, detectPrefixClusters, parseConsolidationOutput, reconcileConsolidationPlan, type ConsolidationAction, type ConsolidationPlan, type ConsolidationSkillSummary, type CuratorRunReport, type PruningAction, type ReconciledConsolidationPlan, type SkillPrefixCluster, } from "./skill-consolidation.js";
-export { bigramSimilarity, computeSimilarity, decideSimilarityAction, DEFAULT_SKILL_SIMILARITY_POLICY, findSimilarSkills, stepCountProximity, toolSetJaccard, type SimilarityDecision, type SimilarityScore, type SimilarSkillMatch, type SkillSimilarityPolicy, type SkillSimilarityProfile, } from "./skill-similarity.js";
-export { aggregateTeamResults, allocateTokenBudgets, buildAgentTaskPrompt, inferAggregationPolicy, inferExecutionMode, mapRoleToSidechainType, resolveAgentToolAccess, resolveExecutionOrder, resolveTeamPlan, shouldCancelTeam, TEAM_MAX_AGENTS, TEAM_MAX_DEPTH, validateTeamPlan, type AgentRole, type TeamAgentResult, type TeamAgentSpec, type TeamAggregationPolicy, type TeamExecutionMode, type TeamLifecycleState, type TeamPlan, type TeamResult, } from "./team-orchestration.js";
-export { canForkAtDepth, buildForkedMessages, buildForkPlaceholderResults, FORK_PLACEHOLDER_RESULT, FORK_SENTINEL_TAG, generateForkChildAgentId, isInForkChild, MAX_FORK_DEPTH, MAX_SIDECHAIN_DB_DEPTH, resolveForkChildTools, type ForkChildConfig, type ForkChildMessage, type ForkContext, type ForkResult, } from "./fork-subagent.js";
-export { getBuiltInAgent, getBuiltInAgents, isBuiltInAgent, resolveAgentToolSet, type AgentDefinition, } from "./agent-registry.js";
-export { createTaskState, filterToolsByRole, type IsolationMode, type PermissionRole, type TaskType, type TaskLifecycle, type TaskState, type TaskStateBase, type LocalBashTaskState, type LocalAgentTaskState, type RemoteAgentTaskState, type InProcessTeammateTaskState, type DreamTaskState, type DreamTurn, type DreamPhase, } from "./task-types.js";
-export { calculateTokenWarningState, createTurnLoopGuardState, resolveApiErrorRecovery, resolveOutputTokenEscalation, shouldAbortTurn, type ApiErrorRecovery, type TokenWarningState, type TurnLoopGuardConfig, type TurnLoopGuardState, } from "./turn-loop-guard.js";
-export { buildPostCompactRestorationMessage, createReactiveCompactState, shouldAttemptReactiveCompact, type ReactiveCompactConfig, type ReactiveCompactState, } from "./reactive-compact.js";
-export { aggregateTeamToolResults, mapTeamRequestToForkConfigs, resolveTeamExecutionPlan, type TeamAgentRequest, type TeamAggregatedResult, type TeamExecutionBatch, type TeamExecutionPlan, type TeamToolRequest, } from "./team-tool-loop-wiring.js";
+export { applyToolChoicePolicy, type ApplyToolChoicePolicyInput, type ApplyToolChoicePolicyResult, } from "./tool-loop/tool-choice-policy.js";
+export { repairOpenAiChatConversation, type ConversationRepairOptions, type OpenAiChatMessageLike, type OpenAiToolCall, } from "./tool-loop/conversation-repair.js";
+export { advanceToolLoopState, recoverToolLoopStateFromChatConversation, recoverToolLoopStateFromResponsesItems, settleToolLoopState, type RepairToolLoopStateResult, type ToolLoopRepairAction, type ToolLoopState, } from "./tool-loop/tool-loop-state.js";
+export { isForegroundSource, isTransientCapacityError, computeRetryBackoff, isPersistentRetryEnabled, FallbackTriggeredError, type PersistentRetryConfig, } from "./error-handling/retry-loop.js";
+export { canForkAtDepth, buildForkedMessages, buildForkPlaceholderResults, FORK_PLACEHOLDER_RESULT, FORK_SENTINEL_TAG, generateForkChildAgentId, isInForkChild, MAX_FORK_DEPTH, resolveForkChildTools, type ForkChildConfig, type ForkChildMessage, type ForkContext, type ForkResult, } from "./subagent/fork-subagent.js";
+export { getBuiltInAgent, getBuiltInAgents, isBuiltInAgent, resolveAgentToolSet, type AgentDefinition, } from "./subagent/agent-registry.js";
+export { createTaskState, filterToolsByRole, type IsolationMode, type PermissionRole, type TaskType, type TaskLifecycle, type TaskState, type TaskStateBase, type LocalBashTaskState, type LocalAgentTaskState, type RemoteAgentTaskState, type InProcessTeammateTaskState, type DreamTaskState, type DreamTurn, type DreamPhase, } from "./subagent/task-types.js";
+export { calculateTokenWarningState, createTurnLoopGuardState, resolveApiErrorRecovery, resolveOutputTokenEscalation, shouldAbortTurn, type ApiErrorRecovery, type TokenWarningState, type TurnLoopGuardConfig, type TurnLoopGuardState, } from "./context/turn-loop-guard.js";
+export { buildPostCompactRestorationMessage, createReactiveCompactState, shouldAttemptReactiveCompact, type ReactiveCompactConfig, type ReactiveCompactState, } from "./context/reactive-compact.js";

package/dist/types/orchestration/skill-improvement.d.ts

@@ -10,8 +10,8 @@ export interface SkillTurnResult {
     distinctToolCount: number;
     /** Was a multi-step orchestration (≥2 rounds) used? */
     multiStep: boolean;
-    /** Did the turn involve a sidechain? */
-    hasSidechain: boolean;
+    /** Did the turn involve a sub-agent fork? */
+    hasSubAgent: boolean;
     /** Optional user feedback signal (positive/negative/none) */
     feedback?: "positive" | "negative" | null;
     /** Skill name if an existing skill was used */

package/dist/types/orchestration/{fork-subagent.d.ts → subagent/fork-subagent.d.ts}

@@ -13,10 +13,8 @@ import type { AgentDefinition } from "./agent-registry.js";
 export declare const FORK_SENTINEL_TAG = "<fork-child-context>";
 /** Placeholder text used for all tool_results in shared prefix (ensures byte-identical prefix). */
 export declare const FORK_PLACEHOLDER_RESULT = "Fork started \u2014 processing in background";
-/** Maximum fork depth for in-memory agents (more permissive than DB sidechain). */
+/** Maximum fork depth for in-memory agents (CC: MAX_FORK_DEPTH). */
 export declare const MAX_FORK_DEPTH = 4;
-/** Maximum fork depth for DB-backed sidechains (more conservative). */
-export declare const MAX_SIDECHAIN_DB_DEPTH = 2;
 export interface ForkContext {
     /** Parent's full message history (becomes shared prefix for cache). */
     parentMessages: unknown[];
@@ -67,7 +65,7 @@ export declare function isInForkChild(messages: unknown[]): boolean;
 /**
  * Check if fork depth allows spawning another child.
  */
-export declare function canForkAtDepth(currentDepth: number, mode?: "in-memory" | "db-sidechain"): boolean;
+export declare function canForkAtDepth(currentDepth: number): boolean;
 /**
  * Build forked messages that ensure byte-identical prefix across all fork children.
  *

package/dist/types/runtime/execution/dream-agent.d.ts

@@ -10,7 +10,7 @@
  *
  * Reference: claude-code src/services/autoDream/
  */
-import type { DreamTaskState, DreamTurn } from "../../orchestration/task-types.js";
+import type { DreamTaskState, DreamTurn } from "../../orchestration/subagent/task-types.js";
 import type { ToolDefinition, ToolInvoker, AgentLogger, HookRegistry } from "../../agent/types.js";
 import type { LLMTransport } from "../../llm/transport.js";
 export interface DreamTriggerConfig {

package/dist/types/runtime/execution/forked-agent.d.ts

@@ -77,10 +77,8 @@ export interface ForkedAgentParams {
     skipTranscript?: boolean;
     /** Token budget for this sub-agent. 0 or undefined = no limit. */
     budgetTokens?: number;
-    /** Parent sidechain depth (propagated to child tool loop) */
+    /** Parent fork depth (propagated to child tool loop) */
     parentDepth?: number;
-    /** Sidechain type for tool access policy (default "code-repair" = full) */
-    sidechainType?: import("../../orchestration/index.js").SidechainType;
 }
 /**
  * Result of a forked agent run.

package/dist/types/runtime/hooks/context-compression.d.ts

@@ -6,7 +6,7 @@ import type { LLMTransport } from "../../llm/transport.js";
 export declare function estimateTokens(msg: CompressibleMessage): number;
 /** Estimate total tokens for a message array. */
 export declare function estimateTotalTokens(messages: CompressibleMessage[]): number;
-export declare function getCompressionMetrics(): import("../../orchestration/context-compression.js").CompressionMetricsSnapshot;
+export declare function getCompressionMetrics(): import("../../orchestration/index.js").CompressionMetricsSnapshot;
 export declare function getContextEngineRegistry(): ContextEngineRegistry;
 /**
  * Create a summarization callback using an injected LLM transport.

package/dist/types/runtime/infra/agent-paths.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent Paths — Centralized dot-directory name and path helpers.
+ *
+ * All filesystem paths under `~/.qlogicagent/` (user-level) or
+ * `<project>/.qlogicagent/` (project-level) must go through these
+ * helpers so the dot-dir name is defined in exactly one place.
+ */
+/** Dot-directory name used for both user-level and project-level storage. */
+export declare const AGENT_DOT_DIR = ".qlogicagent";
+/** `~/.qlogicagent/` */
+export declare function getUserAgentHome(): string;
+/** `~/.qlogicagent/sessions/` */
+export declare function getUserSessionsRoot(): string;
+/** `~/.qlogicagent/sessions/{sessionId}` */
+export declare function getUserSessionDir(sessionId: string): string;
+/** `~/.qlogicagent/.credentials.json` */
+export declare function getUserCredentialsPath(): string;
+/** `~/.qlogicagent/plugins/` */
+export declare function getUserPluginsDir(): string;
+/** `~/.qlogicagent/skills/` */
+export declare function getUserSkillsDir(): string;
+/** `~/.qlogicagent/settings.json` */
+export declare function getUserSettingsPath(): string;
+/** `~/.qlogicagent/cache/` */
+export declare function getUserCacheDir(): string;
+/** `~/.qlogicagent/debug-logs/` */
+export declare function getUserDebugLogsDir(): string;
+/** `~/.qlogicagent/checkpoints/` or `~/.qlogicagent/checkpoints/{sessionId}` */
+export declare function getUserCheckpointsDir(sessionId?: string): string;
+/** `~/.qlogicagent/plugin-cache/` */
+export declare function getUserPluginCacheDir(): string;
+/** `~/.qlogicagent/mcp.json` */
+export declare function getUserMcpConfigPath(): string;
+/** `~/.qlogicagent/marketplace.json` */
+export declare function getUserMarketplaceConfigPath(): string;
+/** `~/.qlogicagent/workflows/` */
+export declare function getUserWorkflowsDir(): string;
+/** `~/.qlogicagent/INSTRUCTIONS.md` */
+export declare function getUserInstructionsPath(): string;
+/** `~/.qlogicagent/rules/` */
+export declare function getUserRulesDir(): string;
+/** `<cwd>/.qlogicagent/` */
+export declare function getProjectAgentDir(cwd?: string): string;
+/** `<cwd>/.qlogicagent/workflows/` */
+export declare function getProjectWorkflowsDir(cwd?: string): string;
+/** `<cwd>/.qlogicagent/plugins/` */
+export declare function getProjectPluginsDir(cwd?: string): string;
+/** `<cwd>/.qlogicagent/skills/` */
+export declare function getProjectSkillsDir(cwd?: string): string;
+/** `<cwd>/.qlogicagent/settings.json` */
+export declare function getProjectSettingsPath(cwd?: string): string;
+/** `<cwd>/.qlogicagent/INSTRUCTIONS.md` */
+export declare function getProjectInstructionsPath(cwd?: string): string;
+/** `<cwd>/.qlogicagent/rules/` */
+export declare function getProjectRulesDir(cwd?: string): string;
+/** `<gitRoot>/.qlogicagent/hooks/` */
+export declare function getGitRootHooksDir(gitRoot: string): string;

package/dist/types/runtime/infra/checkpoint-backend.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Local Checkpoint Backend — git-based shadow repo implementation.
+ *
+ * Creates and manages checkpoint snapshots in `~/.qlogicagent/checkpoints/<sessionId>/`
+ * using a shadow git repository independent of the user's project .git.
+ */
+import type { CheckpointToolDeps } from "../../skills/tools/checkpoint-tool.js";
+export declare function createLocalCheckpointBackend(projectRoot: string, sessionId: string): CheckpointToolDeps;

package/dist/types/runtime/infra/disk-storage.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Disk Storage Manager — unified atomic file I/O for agent self-managed storage.
+ *
+ * Provides:
+ * - Atomic write (tmp + rename) with dir auto-creation
+ * - JSON read/write helpers
+ * - MemoryStore disk persistence (auto-save on mutation)
+ */
+/**
+ * Write data atomically: write to a temp file in the same directory,
+ * then rename over the target. This prevents partial/corrupted reads.
+ */
+export declare function atomicWriteFile(filePath: string, data: string | Buffer): Promise<void>;
+/**
+ * Read a JSON file. Returns `undefined` if the file does not exist.
+ */
+export declare function readJsonFile<T = unknown>(filePath: string): Promise<T | undefined>;
+/**
+ * Write a JSON file atomically.
+ */
+export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
+/** Path to user-level memory file: `~/.qlogicagent/memory.json` */
+export declare function getMemoryFilePath(): string;
+export interface PersistedMemory {
+    memory: string;
+    user: string;
+    /** ISO 8601 timestamp of last save. */
+    savedAt: string;
+}
+/** Load persisted memory from disk. Returns undefined if no file exists. */
+export declare function loadPersistedMemory(): Promise<PersistedMemory | undefined>;
+/** Save memory to disk atomically. */
+export declare function savePersistedMemory(data: {
+    memory: string;
+    user: string;
+}): Promise<void>;

package/dist/types/runtime/infra/file-watcher.d.ts

@@ -10,8 +10,8 @@
  * this is a lightweight change-awareness system.
  *
  * Watched paths:
- *   - .openclaw/settings.json → permission hot-reload
- *   - INSTRUCTIONS.md / .openclaw/INSTRUCTIONS.md → instruction re-load
+ *   - .qlogicagent/settings.json → permission hot-reload
+ *   - INSTRUCTIONS.md / .qlogicagent/INSTRUCTIONS.md → instruction re-load
  *   - configurable additional patterns
  *
  * Reference: claude-code file-watcher usage throughout lifecycle

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

@@ -1,6 +1,8 @@
+export { AGENT_DOT_DIR, getUserAgentHome, getUserSessionDir, getUserCredentialsPath, getUserPluginsDir, getUserSkillsDir, getUserSettingsPath, getUserCacheDir, getUserDebugLogsDir, getUserCheckpointsDir, getUserPluginCacheDir, getUserMcpConfigPath, getUserMarketplaceConfigPath, getUserWorkflowsDir, getUserInstructionsPath, getProjectAgentDir, getProjectWorkflowsDir, getProjectPluginsDir, getProjectSkillsDir, getProjectSettingsPath, getProjectInstructionsPath, getProjectRulesDir, getGitRootHooksDir, } from "./agent-paths.js";
 export { getBudgetContinuationMessage } from "./token-budget.js";
 export { type SecureStorage, saveApiKey, loadApiKey } from "./secure-storage.js";
 export { createFileWatcher, FileWatcher } from "./file-watcher.js";
 export { TaskStore } from "./task-runtime.js";
 export { createWorktreeBackend } from "./worktree-backend.js";
 export { registerCleanup, runCleanupFunctions } from "./cleanup-registry.js";
+export { atomicWriteFile, readJsonFile, writeJsonFile, loadPersistedMemory, savePersistedMemory, getMemoryFilePath, type PersistedMemory, } from "./disk-storage.js";

package/dist/types/runtime/infra/secure-storage.d.ts

@@ -7,7 +7,7 @@
  *   - macOS Keychain / Windows Credential Manager can be added as plugins
  *
  * Storage layout:
- *   ~/.openclaw/.credentials.json  — API keys, OAuth tokens
+ *   ~/.qlogicagent/.credentials.json  — API keys, OAuth tokens
  *
  * Reference: claude-code-haha/src/utils/secureStorage/
  */

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

@@ -9,7 +9,7 @@
  * Architecture note: CC uses React-style setAppState(prev => next). We use
  * a simple Map-based store since we're in a subprocess (no React).
  */
-import type { TaskState, TaskType, TaskLifecycle, PermissionRole, IsolationMode, LocalAgentTaskState, LocalBashTaskState } from "../../orchestration/task-types.js";
+import type { TaskState, TaskType, TaskLifecycle, PermissionRole, IsolationMode, LocalAgentTaskState, LocalBashTaskState } from "../../orchestration/subagent/task-types.js";
 import type { HookRegistry } from "../../contracts/hooks.js";
 /** Polling interval for running tasks (ms) */
 export declare const POLL_INTERVAL_MS = 1000;

package/dist/types/runtime/prompt/instruction-loader.d.ts

@@ -2,9 +2,9 @@
  * Instruction Loader — CC claudemd.ts parity (adapted for qlogicagent).
  *
  * Discovers and loads instruction files following CC's load order:
- *   1. User instructions (~/.openclaw/INSTRUCTIONS.md)
- *   2. Project instructions (INSTRUCTIONS.md, .openclaw/INSTRUCTIONS.md,
- *      .openclaw/rules/*.md — walkup from cwd to git root)
+ *   1. User instructions (~/.qlogicagent/INSTRUCTIONS.md)
+ *   2. Project instructions (INSTRUCTIONS.md, .qlogicagent/INSTRUCTIONS.md,
+ *      .qlogicagent/rules/*.md — walkup from cwd to git root)
  *   3. Local instructions (INSTRUCTIONS.local.md — private, not checked in)
  *
  * Features ported from CC:
@@ -33,11 +33,11 @@ export interface InstructionFileInfo {
  * Load all instruction files following CC's discovery order.
  *
  * Discovery order (priority: last loaded = highest):
- *   1. User: ~/.openclaw/INSTRUCTIONS.md, ~/.openclaw/rules/*.md
+ *   1. User: ~/.qlogicagent/INSTRUCTIONS.md, ~/.qlogicagent/rules/*.md
  *   2. Project: Walk from git root → cwd, each dir:
  *      - INSTRUCTIONS.md
- *      - .openclaw/INSTRUCTIONS.md
- *      - .openclaw/rules/*.md (unconditional)
+ *      - .qlogicagent/INSTRUCTIONS.md
+ *      - .qlogicagent/rules/*.md (unconditional)
  *   3. Local: INSTRUCTIONS.local.md (per dir, walkup)
  *
  * @param cwd - Starting directory for walkup discovery

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

@@ -44,7 +44,6 @@ export type ForkedAgentRunner = (params: {
     log: AgentLogger;
     hooks?: HookRegistry;
     forkLabel: string;
-    sidechainType?: "planner" | "research" | "plan-repair" | "code-repair" | "media-prep";
     maxTurns?: number;
     parentSignal?: AbortSignal;
     skipTranscript?: boolean;

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

@@ -7,7 +7,7 @@
  *   3. Session metadata (model, cwd, agent mode)
  *
  * Storage layout:
- *   ~/.openclaw/sessions/<session-id>/
+ *   ~/.qlogicagent/sessions/<session-id>/
  *     transcript.jsonl   — append-only message log
  *     state.json          — cost snapshot + metadata
  *

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

@@ -1,19 +1,17 @@
 export type { PortableTool, PortableToolResult, ToolContentBlock, } from "./portable-tool.js";
-export { ToolRegistry } from "./tool-registry.js";
-export { MEMORY_TOOL_NAME, MEMORY_TOOL_MAX_CONTENT_LENGTH, MEMORY_TOOL_ACTIONS, MEMORY_TOOL_SCHEMA, MEMORY_TOOL_DESCRIPTION, MEMORY_TOOL_LABEL, isMemoryContentSafe, executeMemoryTool, } from "./memory-tool.js";
-export type { MemoryToolAction, MemoryToolParams, MemoryToolResult, MemoryToolExecutorDeps, } from "./memory-tool.js";
-export { MemoryStore, MEMORY_ENTRY_DELIMITER, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_USER_CHAR_LIMIT, } from "./memory-store.js";
-export type { MemoryStoreTarget, MemoryStoreResult, MemoryStoreOptions, MemoryStoreSerialized, } from "./memory-store.js";
-export { createQMemoryAdapter } from "./qmemory-adapter.js";
-export type { QMemoryAdapterConfig, QMemoryHealthStatus, ExtractedMemoryItem } from "./qmemory-adapter.js";
-export { createMemoryExtractor } from "./memory-extractor.js";
-export type { ExtractedMemory, ProfileUpdate, ExtractionResult, ExtractionCompleteFn, MemoryExtractorOptions, } from "./memory-extractor.js";
+export { setToolPool, addTool, addTools, removeTool, findTool, hasTool, getToolNames, getToolCount, executeTool, getToolManifest, getTools, AGENT_DISALLOWED_TOOLS, CUSTOM_AGENT_DISALLOWED_TOOLS, filterToolsForAgent, } from "./tools.js";
+export { MEMORY_TOOL_NAME, MEMORY_TOOL_MAX_CONTENT_LENGTH, MEMORY_TOOL_ACTIONS, MEMORY_TOOL_SCHEMA, MEMORY_TOOL_DESCRIPTION, MEMORY_TOOL_LABEL, isMemoryContentSafe, executeMemoryTool, } from "./memory/memory-tool.js";
+export type { MemoryToolAction, MemoryToolParams, MemoryToolResult, MemoryToolExecutorDeps, MediaPreferencesSummary, } from "./memory/memory-tool.js";
+export { MemoryStore, MEMORY_ENTRY_DELIMITER, DEFAULT_MEMORY_CHAR_LIMIT, DEFAULT_USER_CHAR_LIMIT, } from "./memory/memory-store.js";
+export type { MemoryStoreTarget, MemoryStoreResult, MemoryStoreOptions, MemoryStoreSerialized, } from "./memory/memory-store.js";
+export { createQMemoryAdapter } from "./memory/qmemory-adapter.js";
+export type { QMemoryAdapterConfig, QMemoryHealthStatus, ExtractedMemoryItem } from "./memory/qmemory-adapter.js";
+export { createMemoryExtractor } from "./memory/memory-extractor.js";
+export type { ExtractedMemory, ProfileUpdate, ExtractionResult, ExtractionCompleteFn, MemoryExtractorOptions, } from "./memory/memory-extractor.js";
 export { THINK_TOOL_NAME, THINK_TOOL_SCHEMA, createThinkTool } from "./think-tool.js";
 export type { ThinkToolParams } from "./think-tool.js";
-export { TODO_TOOL_NAME, TODO_TOOL_SCHEMA, createTodoTool } from "./todo-tool.js";
-export type { TodoToolParams, TodoToolOptions } from "./todo-tool.js";
-export { MEMORY_QUERY_TOOL_NAME, MEMORY_QUERY_TOOL_SCHEMA, createMemoryQueryTool, } from "./memory-query-tool.js";
-export type { MemoryQueryToolParams, MemoryQueryToolDeps, MediaPreferencesSummary, } from "./memory-query-tool.js";
+export { TODO_TOOL_NAME, TODO_TOOL_SCHEMA, TODO_ACTIONS, createTodoTool } from "./todo-tool.js";
+export type { TodoToolParams, TodoToolOptions, TodoAction } from "./todo-tool.js";
 export { READ_TOOL_NAME, READ_TOOL_SCHEMA, createReadTool } from "./tools/read-tool.js";
 export type { ReadToolParams, ReadToolDeps, ReadResultType } from "./tools/read-tool.js";
 export { WRITE_TOOL_NAME, WRITE_TOOL_SCHEMA, createWriteTool } from "./tools/write-tool.js";
@@ -22,8 +20,6 @@ export { EDIT_TOOL_NAME, EDIT_TOOL_SCHEMA, createEditTool } from "./tools/edit-t
 export type { EditToolParams, EditToolDeps } from "./tools/edit-tool.js";
 export { APPLY_PATCH_TOOL_NAME, APPLY_PATCH_TOOL_SCHEMA, createApplyPatchTool } from "./tools/apply-patch-tool.js";
 export type { ApplyPatchToolParams, ApplyPatchToolDeps, ApplyPatchSummary } from "./tools/apply-patch-tool.js";
-export { PDF_TOOL_NAME, PDF_TOOL_SCHEMA, createPdfTool } from "./tools/pdf-tool.js";
-export type { PdfToolParams, PdfToolDeps } from "./tools/pdf-tool.js";
 export { EXEC_TOOL_NAME, EXEC_TOOL_SCHEMA, createExecTool, ASSISTANT_BLOCKING_BUDGET_MS } from "./tools/exec-tool.js";
 export type { ExecToolParams, ExecToolHost, ExecProgress, ExecToolOutput } from "./tools/exec-tool.js";
 export { isPowerShellToolEnabled, getDefaultShellType, generateCommandId, createBashProvider, createPowerShellProvider, encodePowerShellCommand, classifyCommand, commandHasAnyCd, SEARCH_COMMANDS, READ_COMMANDS, LIST_COMMANDS, SILENT_COMMANDS, SAFE_ENV_VARS, BARE_SHELL_PREFIXES, stripSafeWrappers, stripAllLeadingEnvVars, getSimpleCommandPrefix, getFirstWordPrefix, stripWrappersFromArgv, detectBlockedSleepPattern, TaskOutput, generateTaskId, getTaskOutputDir, setTaskOutputDir, getTaskOutputPath, MAX_TASK_OUTPUT_BYTES, wrapSpawn, createAbortedCommand, createFailedCommand, exec, getCwd, setCwd, initCwd, getOriginalCwd, setShellProvider, getShellProvider, } from "./tools/shell/index.js";
@@ -72,8 +68,6 @@ export { BROWSER_TOOL_NAME, BROWSER_TOOL_SCHEMA, createBrowserTool } from "./too
 export type { BrowserToolParams, BrowserToolDeps, BrowserAction, BrowserSnapshot, BrowserScreenshot } from "./tools/browser-tool.js";
 export { CRON_TOOL_NAME, CRON_TOOL_SCHEMA, MAX_CRON_JOBS, createCronTool } from "./tools/cron-tool.js";
 export type { CronToolParams, CronToolDeps, CronJob, CronResult, CronAction } from "./tools/cron-tool.js";
-export { MEMORY_SEARCH_TOOL_NAME, MEMORY_SEARCH_TOOL_SCHEMA, createMemorySearchTool } from "./tools/memory-tool.js";
-export type { MemorySearchToolParams, MemorySearchToolDeps, MemoryEntry, MemoryQueryOutput, MemorySource } from "./tools/memory-tool.js";
 export { CHECKPOINT_TOOL_NAME, CHECKPOINT_TOOL_SCHEMA, createCheckpointTool } from "./tools/checkpoint-tool.js";
 export type { CheckpointToolParams, CheckpointToolDeps, Checkpoint, CheckpointResult, CheckpointAction } from "./tools/checkpoint-tool.js";
 export { NOTIFY_TOOL_NAME, NOTIFY_TOOL_SCHEMA, createNotifyTool } from "./tools/notify-tool.js";
@@ -100,15 +94,15 @@ export { MONITOR_TOOL_NAME, MONITOR_TOOL_SCHEMA, createMonitorTool } from "./too
 export type { MonitorToolParams, MonitorToolDeps, MonitorSource, MonitorAction, MonitorCondition, MonitorInfo, MonitorResult, } from "./tools/monitor-tool.js";
 export { STRUCTURED_OUTPUT_TOOL_NAME, STRUCTURED_OUTPUT_TOOL_SCHEMA, STRUCTURED_OUTPUT_MAX_CHARS, createStructuredOutputTool, createConfiguredStructuredOutputTool, isStructuredOutputEnabled, } from "./tools/structured-output-tool.js";
 export type { StructuredOutputToolParams, StructuredOutputToolDeps, StructuredOutputResult, SchemaValidationError, ConfiguredToolResult, SchemaCompiler, } from "./tools/structured-output-tool.js";
-export { INSTRUCTIONS_LIST_TOOL_NAME, INSTRUCTIONS_LIST_SCHEMA, createInstructionsListTool, INSTRUCTIONS_READ_TOOL_NAME, INSTRUCTIONS_READ_SCHEMA, createInstructionsReadTool, INSTRUCTIONS_WRITE_TOOL_NAME, INSTRUCTIONS_WRITE_SCHEMA, createInstructionsWriteTool, INSTRUCTIONS_DELETE_TOOL_NAME, INSTRUCTIONS_DELETE_SCHEMA, createInstructionsDeleteTool, } from "./tools/instructions-tool.js";
-export type { InstructionFileInfo, InstructionFileContent, InstructionsToolDeps, InstructionsListParams, InstructionsReadParams, InstructionsWriteParams, InstructionsDeleteParams, } from "./tools/instructions-tool.js";
-export type { ParsedSkillFrontmatter, WorkspaceSkill, SkillInstallSpec, SkillMetadata, SkillInvocationPolicy, SkillEntry, SkillCommandDispatchSpec, SkillCommandSpec, SkillSnapshot, SkillScanSeverity, SkillScanFinding, SkillScanSummary, SkillScanOptions, SkillFsDeps, SkillPathDeps, SkillLoadLimits, SkillSearchPaths, SkillLoaderDeps, } from "./skill-types.js";
-export { parseFrontmatter, resolveSkillMetadata, resolveSkillInvocationPolicy, resolveSkillKey, } from "./skill-frontmatter.js";
-export { loadSkillEntries, filterSkillEntries, buildSkillSnapshot, } from "./skill-loader.js";
-export { scanSource, scanSkillDirectory, hasCriticalFindings, isScannable, } from "./skill-guard.js";
-export type { SkillGuardDeps } from "./skill-guard.js";
-export { installSkill, uninstallSkill, createEmptyLockfile, } from "./skill-source.js";
-export type { TrustLevel, ScanVerdict, SkillSourceDescriptor, SkillFetchResult, SkillFetchDeps, SkillStorageDeps, SkillLockEntry, SkillLockfile, SkillInstallResult, } from "./skill-source.js";
+export { INSTRUCTIONS_TOOL_NAME, INSTRUCTIONS_TOOL_SCHEMA, createInstructionsTool, } from "./tools/instructions-tool.js";
+export type { InstructionFileInfo, InstructionFileContent, InstructionsToolDeps, InstructionsAction, InstructionsToolParams, } from "./tools/instructions-tool.js";
+export type { ParsedSkillFrontmatter, WorkspaceSkill, SkillInstallSpec, SkillMetadata, SkillInvocationPolicy, SkillEntry, SkillCommandDispatchSpec, SkillCommandSpec, SkillSnapshot, SkillScanSeverity, SkillScanFinding, SkillScanSummary, SkillScanOptions, SkillFsDeps, SkillPathDeps, SkillLoadLimits, SkillSearchPaths, SkillLoaderDeps, } from "./skill-system/skill-types.js";
+export { parseFrontmatter, resolveSkillMetadata, resolveSkillInvocationPolicy, resolveSkillKey, } from "./skill-system/skill-frontmatter.js";
+export { loadSkillEntries, filterSkillEntries, buildSkillSnapshot, } from "./skill-system/skill-loader.js";
+export { scanSource, scanSkillDirectory, hasCriticalFindings, isScannable, } from "./skill-system/skill-guard.js";
+export type { SkillGuardDeps } from "./skill-system/skill-guard.js";
+export { installSkill, uninstallSkill, createEmptyLockfile, } from "./skill-system/skill-source.js";
+export type { TrustLevel, ScanVerdict, SkillSourceDescriptor, SkillFetchResult, SkillFetchDeps, SkillStorageDeps, SkillLockEntry, SkillLockfile, SkillInstallResult, } from "./skill-system/skill-source.js";
 export { SKILL_TOOL_NAME, SKILL_INVOKE_SCHEMA, createSkillTool } from "./tools/skill-invoke-tool.js";
 export type { SkillInvokeParams, SkillToolDeps } from "./tools/skill-invoke-tool.js";
 export { McpStdioClient } from "./mcp/mcp-stdio-client.js";