qlogicagent 2.24.9 → 2.24.11

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

@@ -1,5 +1,5 @@
 /**
- * Instruction Loader — CC claudemd.ts parity (adapted for qlogicagent).
+ * Repository instruction discovery and model-message projection.
  *
  * Discovers and loads project instruction files following CC's walkup model:
  *   1. Project instructions (INSTRUCTIONS.md, .qlogicagent/INSTRUCTIONS.md,
@@ -17,9 +17,12 @@
  *   - TEXT_FILE_EXTENSIONS whitelist
  *   - MAX_INCLUDE_DEPTH circular reference prevention
  *
- * Reference: claude-code src/utils/claudemd.ts
+ * Instruction files remain repository/user-owned content. They are projected as a
+ * user-role message immediately before the current direct user request; they must
+ * never be concatenated into the Host-owned system prompt.
  */
 import type { HookRegistry } from "../../contracts/hooks.js";
+import type { ChatMessage } from "../../agent/types.js";
 export type InstructionType = "User" | "Project" | "Local";
 export interface InstructionFileInfo {
     path: string;
@@ -30,10 +33,6 @@ export interface InstructionFileInfo {
     /** Glob patterns from frontmatter — file only applies when target path matches */
     globs?: string[];
 }
-export interface LiteralResponseRequirement {
-    marker: string;
-    placement: "prefix" | "suffix" | "include";
-}
 /**
  * Load all instruction files following CC's discovery order.
  *
@@ -48,15 +47,18 @@ export interface LiteralResponseRequirement {
  * @param hooks - Optional hook registry for instructions.loaded event
  */
 export declare function loadInstructions(cwd: string, hooks?: HookRegistry): Promise<InstructionFileInfo[]>;
+/** Build one lower-authority user message from the repository instruction files. */
+export declare function buildRepositoryInstructionMessage(files: InstructionFileInfo[]): string;
 /**
- * Build the instructions prompt string from loaded files.
- * CC parity: getClaudeMds()
+ * Insert repository context immediately before the current direct user request.
+ * The direct request remains the latest user message and therefore wins same-role
+ * conflicts. A fresh projection is built for each turn, so Host history is never
+ * mutated and the adapter does not create a second transcript store.
  */
-export declare function buildInstructionsPrompt(files: InstructionFileInfo[]): string;
-export declare function extractLiteralResponseRequirements(files: InstructionFileInfo[]): LiteralResponseRequirement[];
+export declare function insertRepositoryInstructionMessage(messages: ChatMessage[], repositoryInstructionMessage?: string): ChatMessage[];
 /**
  * Get conditional rules that match a target file path.
- * CC parity: getManagedAndUserConditionalRules() + getMemoryFilesForNestedDirectory()
+ * Return conditional rules applicable to a target path.
  */
 export declare function getConditionalRules(cwd: string, targetPath: string): Promise<InstructionFileInfo[]>;
 /**
@@ -65,5 +67,3 @@ export declare function getConditionalRules(cwd: string, targetPath: string): Pr
  * visible on the next turn without depending on a filesystem watcher.
  */
 export declare function getInstructions(cwd: string, hooks?: HookRegistry): Promise<InstructionFileInfo[]>;
-/** Clear the instruction cache. Called after file changes or compaction. */
-export declare function resetInstructionCache(): void;

package/dist/types/runtime/prompt/system-prompt-sections.d.ts

@@ -1,12 +1,13 @@
 /**
- * System Prompt Sections — CC systemPromptSections.ts parity.
+ * Host-owned system prompt sections.
  *
  * Provides a section-based system prompt assembly mechanism:
  *   - Memoized sections (computed once, cached until clear)
- *   - User-provided appendSystemPrompt / customSystemPrompt
+ *   - Host-provided appendSystemPrompt / customSystemPrompt
  *   - Clear on session reset / compact
  *
- * CC reference: src/constants/systemPromptSections.ts
+ * Repository files are deliberately excluded from this assembly. They are
+ * lower-authority user messages, not Host system policy.
  */
 type ComputeFn = () => string | null | Promise<string | null>;
 export interface SystemPromptSection {
@@ -30,11 +31,9 @@ export declare function clearSystemPromptSections(): void;
 export interface SystemPromptAssemblyOptions {
     /** Base system prompt (from Gateway config) */
     basePrompt?: string;
-    /** Prepended instruction block (from INSTRUCTIONS.md files) */
-    instructionBlock?: string;
-    /** User-provided custom system prompt (replaces base) */
+    /** Host-provided custom system prompt (replaces base) */
     customSystemPrompt?: string;
-    /** User-provided append text (appended after all sections) */
+    /** Host-provided append text (appended after all sections) */
     appendSystemPrompt?: string;
     /** Dynamic sections to resolve */
     sections?: SystemPromptSection[];
@@ -43,10 +42,9 @@ export interface SystemPromptAssemblyOptions {
  * Assemble the final system prompt from all sources.
  *
  * Order:
- *   1. Instruction block (INSTRUCTIONS.md files)
- *   2. Custom system prompt (replaces base) OR base prompt
- *   3. Resolved sections
- *   4. Append system prompt (user-provided suffix)
+ *   1. Custom system prompt (replaces base) OR base prompt
+ *   2. Resolved Host sections
+ *   3. Append system prompt (Host-provided suffix)
  */
 export declare function assembleSystemPrompt(opts: SystemPromptAssemblyOptions): Promise<string>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qlogicagent",
-	"version": "2.24.9",
+	"version": "2.24.11",
   "packageManager": "pnpm@10.23.0",
   "description": "XiaozhiClaw standard ACP Agent adapter",
   "type": "module",
@@ -24,6 +24,10 @@
     "./orchestration": {
       "types": "./dist/types/orchestration/index.d.ts",
       "default": "./dist/orchestration.js"
+    },
+    "./embedded": {
+      "types": "./dist/types/embedded/index.d.ts",
+      "default": "./dist/embedded.js"
     }
   },
   "files": [
@@ -42,6 +46,9 @@
       ],
       "orchestration": [
         "./dist/types/orchestration/index.d.ts"
+      ],
+      "embedded": [
+        "./dist/types/embedded/index.d.ts"
       ]
     }
   },
@@ -65,6 +72,7 @@
     "check:architecture-boundaries": "node scripts/check-architecture-boundaries.mjs",
     "check:provider-core-boundary": "node scripts/check-provider-core-boundary.mjs",
     "check:provider-core-release-sync": "node scripts/check-provider-core-release-sync.mjs",
+    "check:embedded-core": "npm run build && node scripts/check-embedded-core.mjs",
     "check:workspace-hygiene": "node scripts/check-workspace-hygiene.mjs",
     "check:workspace-hygiene:strict": "node scripts/check-workspace-hygiene.mjs --strict",
     "check:package-artifact": "npm run build && node scripts/check-package-artifact.mjs",
@@ -78,7 +86,7 @@
     "@agentclientprotocol/sdk": "^0.25.0",
     "@napi-rs/canvas": "0.1.100",
     "@xiaozhiclaw/module-sdk": "0.4.5",
-		"@xiaozhiclaw/provider-core": "0.1.41",
+		"@xiaozhiclaw/provider-core": "0.1.43",
     "ajv": "8.20.0",
     "better-sqlite3": "^12.10.0",
     "dotenv": "^17.3.1",

package/dist/types/orchestration/context/context-collapse.d.ts

@@ -1,58 +0,0 @@
-/**
- * Context Collapse — staged lightweight context reduction that runs
- * BEFORE autocompact and can drain on 413 BEFORE reactive compact.
- *
- * CC parity: services/contextCollapse/index.ts
- *
- * Architecture:
- * 1. applyCollapsesIfNeeded() — runs every iteration, projects the
- *    collapsed view and maybe commits more collapses (by summarizing
- *    old tool-result groups into compact summaries).
- * 2. recoverFromOverflow() — drain all staged collapses on a real
- *    API 413. If it can free enough context, the retry may succeed
- *    without reactive compact (which is heavier and destroys more
- *    context).
- *
- * Collapses are ordered "stages" — oldest first. Each stage replaces
- * a contiguous run of old messages with a single summary line.
- */
-export interface CollapseStage {
-    /** UUID of the stage (for dedup and ordering). */
-    id: string;
-    /** Index range [start, end) in the original message array. */
-    range: [number, number];
-    /** Summary text that replaces the range. */
-    summary: string;
-    /** Whether this stage has been committed (applied to messages). */
-    committed: boolean;
-}
-export interface CollapseStore {
-    stages: CollapseStage[];
-}
-export declare function createCollapseStore(): CollapseStore;
-/**
- * Evaluate whether new collapses should be staged.
- *
- * Heuristic: if the conversation has > thresholdMessages non-system messages,
- * group old tool-result runs into collapse stages.
- */
-export declare function applyCollapsesIfNeeded<T extends {
-    role: string;
-    content?: string | unknown;
-}>(messages: T[], store: CollapseStore, opts?: {
-    thresholdMessages?: number;
-}): {
-    messages: T[];
-    stagedCount: number;
-};
-/**
- * Drain all staged (uncommitted) collapses — called on 413 recovery.
- * Commits every pending stage and returns the collapsed messages.
- */
-export declare function recoverFromOverflow<T extends {
-    role: string;
-    content?: string | unknown;
-}>(messages: T[], store: CollapseStore): {
-    messages: T[];
-    committed: number;
-};