qlogicagent 2.18.9 → 2.18.10

package/dist/types/orchestration/product-planner.d.ts

@@ -23,7 +23,6 @@
  *   - CrewAI: checkpoint serialization (mid-task state)
  *   - LangGraph: durable execution (persist after each node)
  */
-import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
 import type { DelegateBridge } from "./delegation-coordinator.js";
@@ -40,6 +39,7 @@ export interface PlanningSession {
     cwd: string;
     leaderAgentId: string;
     leaderMemberId?: string;
+    activeDelegationId?: string;
     phase: PlanningPhase;
     plan?: ProductPlan;
     /** Multi-turn conversation history during planning. */
@@ -105,12 +105,11 @@ export interface DagMutation {
     details?: Record<string, unknown>;
 }
 export declare class ProductPlanner {
-    private processManager;
     private acpDetector;
     private configStore;
     private callbacks;
     private sessions;
-    constructor(processManager: AgentProcessManager, acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: PlannerCallbacks);
+    constructor(acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: PlannerCallbacks);
     /**
      * Start an interactive planning session (Phase 1).
      * Spawns the leader agent and begins multi-turn dialogue.

package/dist/types/orchestration/run-state-host-authority.d.ts

@@ -0,0 +1,7 @@
+import type { HostRunStateClient } from "../transport/host-run-state-client.js";
+export interface HostRunStateAuthority {
+    client: HostRunStateClient;
+    sessionId: string;
+}
+export declare function configureHostRunStateAuthority(resolver: (() => HostRunStateAuthority | undefined) | null): void;
+export declare function requireHostRunStateAuthority(): HostRunStateAuthority;

package/dist/types/orchestration/solo-evaluator.d.ts

@@ -18,11 +18,11 @@
  *
  * Degradation: if K agents fail but ≥1 succeeds, session remains interactive.
  */
-import type { AgentProcessManager } from "../runtime/infra/agent-process.js";
 import type { AcpDetector } from "../runtime/infra/acp-detector.js";
 import type { AgentConfigStore } from "../runtime/infra/agent-config-store.js";
 import type { DelegateBridge } from "./delegation-coordinator.js";
 import type { SoloState, SoloAgentState, SoloEvaluation, SoloStatus, SoloStartParams, SoloSelectParams, SoloSpec } from "../protocol/wire/acp-agent-management.js";
+export declare function deriveSoloDelegateProjectId(registeredProjectRoot: string): string;
 export interface SoloCallbacks {
     log?: {
         info(msg: string): void;
@@ -75,11 +75,10 @@ export declare function buildEvaluationPrompt(originalTask: string, spec: SoloSp
     diff?: string;
 }>): string;
 export declare class SoloEvaluator {
-    private processManager;
     private configStore;
     private callbacks;
     private sessions;
-    constructor(processManager: AgentProcessManager, _acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: SoloCallbacks);
+    constructor(_acpDetector: AcpDetector, configStore: AgentConfigStore | null, callbacks?: SoloCallbacks);
     /** Persist current session data to disk (fire-and-forget). */
     private persistSession;
     /** Restore sessions from disk (call once at startup). */

package/dist/types/orchestration/solo-persistence.d.ts

@@ -1,8 +1,5 @@
 /**
- * Solo Persistence — read/write Solo Mode state to disk.
- *
- * State is stored at `<project>/.qlogicagent/solos/<soloId>/solo-state.json`.
- * Mirrors the product-persistence.ts pattern.
+ * Solo persistence facade over the Gateway-owned RunStateStore.
  */
 import type { PathService } from "../runtime/ports/index.js";
 import type { SoloState, SoloAgentState, SoloEvaluation, SoloSpec } from "../protocol/wire/acp-agent-management.js";
@@ -40,11 +37,11 @@ export interface PersistedSoloState {
 export interface SoloPersistenceOptions {
     pathService?: PathService;
 }
-/** Save solo state to disk. */
+/** Save the latest Solo snapshot through Gateway authority. */
 export declare function saveSoloState(state: PersistedSoloState, cwd?: string, options?: SoloPersistenceOptions): Promise<void>;
-/** Load solo state from disk. Returns undefined if not found. */
+/** Load the latest Solo snapshot from Gateway authority. */
 export declare function loadSoloState(soloId: string, cwd?: string, options?: SoloPersistenceOptions): Promise<PersistedSoloState | undefined>;
 /** List all solo session IDs with their persisted state. */
 export declare function listSoloSessions(cwd?: string, options?: SoloPersistenceOptions): Promise<PersistedSoloState[]>;
-/** Delete solo state from disk. */
+/** Delete a Solo run through Gateway authority. */
 export declare function deleteSoloState(soloId: string, cwd?: string, options?: SoloPersistenceOptions): Promise<boolean>;

package/dist/types/orchestration/testing/delegate-test-bridge.d.ts

@@ -1,4 +1,15 @@
-import type { AgentProcessManager } from "../../runtime/infra/agent-process.js";
 import type { DelegateBridge } from "../delegation-coordinator.js";
+interface LegacyTurnFixture {
+    sendTask(memberId: string, prompt: string, options?: {
+        timeout?: number;
+    }): Promise<unknown>;
+    getUsageTracker?(memberId: string): {
+        getUsage(): {
+            inputTokens: number;
+            outputTokens: number;
+        };
+    } | null;
+}
 /** Test-only adapter for migrating orchestration fixtures from the retired local spawn lane. */
-export declare function makeDelegateTestBridge(processManager: AgentProcessManager): DelegateBridge;
+export declare function makeDelegateTestBridge(processManager: LegacyTurnFixture): DelegateBridge;
+export {};

package/dist/types/orchestration/workflow/node-schema.d.ts

@@ -147,11 +147,12 @@ export interface ExecutorHost {
     waitWebhook?(req: WebhookWaitHostRequest): Promise<Record<string, unknown>>;
 }
 export interface AgentHostRequest {
-    agentId?: string;
+    agentId: string;
     prompt: string;
     input: DataItem[];
     signal?: AbortSignal;
 }
+export declare function requireWorkflowAgentId(value: unknown): string;
 export interface ModelHostRequest {
     prompt: string;
     modelHint?: string;

package/dist/types/orchestration/workflow/qla-executor-host.d.ts

@@ -14,7 +14,7 @@ import type { ExecutorHost, ToolHostRequest, MemoryHostRequest, SubworkflowHostR
 export interface QlaExecutorHostDeps {
     /** Run one agent turn (spawn external ACP agent + sendTask). Returns the agent's text output. */
     runAgent: (req: {
-        agentId?: string;
+        agentId: string;
         prompt: string;
         signal?: AbortSignal;
     }) => Promise<string>;

package/dist/types/orchestration/workflow/workflow-bundle.d.ts

@@ -10,7 +10,7 @@
  *    graph references, so an importer (or the Hub apply checklist) can verify bindings
  *    BEFORE activating instead of failing mid-run.
  */
-import type { WorkflowDef } from "./node-schema.js";
+import { type WorkflowDef } from "./node-schema.js";
 import type { TriggerDef } from "./workflow-trigger.js";
 import type { ConcurrencyPolicy, WorkflowRecord } from "./workflow-store.js";
 export declare const WORKFLOW_BUNDLE_SCHEMA_VERSION = 2;

package/dist/types/project-memory-host.d.ts

@@ -0,0 +1,3 @@
+/** Gateway-owned project-memory implementation. qlogicagent production code must consume the X7 proxy. */
+export { Memdir } from "./skills/memory/memdir.js";
+export type { MemdirFileInfo, MemdirResult } from "./skills/memory/memdir.js";

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

@@ -75,7 +75,7 @@ export interface AgentInstallSpec {
 }
 /**
  * Extended descriptor for external agents,
- * used internally by AgentProcessManager to spawn.
+ * used by the Gateway Supervisor when resolving an agent.
  */
 export interface ExternalAgentDescriptor {
     /** Backend ID. */

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

@@ -97,7 +97,7 @@ export interface AcpHostCapabilities {
 }
 /** Agent capabilities declared in the initialize response. */
 export interface AcpAgentCapabilities {
-    /** Standard (agent-process reads it; implemented in subproject 2). */
+    /** Standard ACP capability consumed by the Gateway Supervisor. */
     loadSession?: boolean;
     /** Standard (used when reading third-party agents like copilot). */
     promptCapabilities?: Record<string, unknown>;

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

@@ -220,7 +220,7 @@ export declare class AcpDetector {
      */
     private buildSelfDescriptor;
     /**
-     * Build an ExternalAgentDescriptor suitable for AgentProcessManager.spawn().
+     * Build an ExternalAgentDescriptor suitable for Gateway Supervisor resolution.
      * Returns null if the agent is not available.
      */
     buildExternalDescriptor(agentId: string): import("../../protocol/wire/acp-agent-management.js").ExternalAgentDescriptor | null;

package/dist/types/runtime/infra/background-tasks.d.ts

@@ -67,7 +67,7 @@ export interface TaskOutputSnapshot {
 }
 /**
  * Control surface for a task whose EXECUTION lives outside this manager — e.g. a
- * team-member subprocess owned by AgentProcessManager. The manager holds the task
+ * supervised team-member process. The Gateway holds the task
  * in the unified panel (list/output/cancel) and routes those three actions here;
  * lifecycle settlement is driven by the owner via settleExternalTask().
  */

package/dist/types/runtime/pet/pet-community-assets.d.ts

@@ -1,31 +1,21 @@
 import type { CommunityInstallResolution } from "../community/community-consent-client.js";
-import { type PetdexPetAssetSummary } from "./petdex-asset.js";
-export interface InstalledCommunityPet {
+export interface CommunityPetAdoptionProposal {
     kind: "pet";
-    status: "installed";
+    mode: "gateway-adoption";
     resourceId: string;
     version: string;
     checksum: string;
-    /** Petdex asset id now registered in profile.customPets. */
     assetId: string;
     name: string;
-    /** Materialized petdex summary (atlas imageUrl = spritesheet data URL) for instant UI hydration. */
-    asset: PetdexPetAssetSummary;
+    fileName: string;
+    /** Validated, provenance-normalized .petdex bytes. Only Gateway may adopt these bytes. */
+    packageBase64: string;
 }
 export interface InstallCommunityPetOptions {
     fetchFn?: typeof fetch;
     /** Replace an existing install in place (update flow). Petdex upsert is idempotent, so this is accepted for dispatcher parity. */
     allowReplace?: boolean;
-    /** Owner whose profile receives the pet; defaults to the active runtime owner. */
-    ownerUserId?: string;
 }
-/**
- * Materialize a community pet end to end: download the gzipped `.petdex` package,
- * verify size + whole-package sha256, gunzip + load + validate the petdex atlas, then
- * register it into `profile.customPets` with `source.kind="community"` — the exact same
- * registration upload/forge use. From that moment `pet.status` includes it and the desktop
- * pet can render the sprite. (Previously this wrote a stripped manifest that never reached
- * the profile, so installed community pets were invisible in the settings pet list.)
- */
-export declare function installCommunityPetResource(install: CommunityInstallResolution, options?: InstallCommunityPetOptions): Promise<InstalledCommunityPet>;
+/** Download, verify, validate, and normalize a community PET into an inert Gateway adoption proposal. */
+export declare function installCommunityPetResource(install: CommunityInstallResolution, options?: InstallCommunityPetOptions): Promise<CommunityPetAdoptionProposal>;
 export declare function assertPetInstall(install: CommunityInstallResolution): void;

package/dist/types/runtime/pet/petdex-vision-qa.d.ts

@@ -0,0 +1,12 @@
+export interface PetdexVisionVerdict {
+    ok: boolean;
+    reason: string;
+    qaSkipped?: boolean;
+}
+export interface PetdexVisionQaContext {
+    label: string;
+    target: string;
+}
+/** Lenient parse: only an explicit FAIL blocks ambiguous model output. */
+export declare function parsePetdexVisionVerdict(text: string): PetdexVisionVerdict;
+export declare function runPetdexVisionQa(call: () => Promise<string>, context: PetdexVisionQaContext, log?: (message: string) => void): Promise<PetdexVisionVerdict>;

package/dist/types/runtime/ports/memory-recall-source.d.ts

@@ -1,3 +1,13 @@
 export interface MemoryRecallSource {
     getRootPath(): string;
+    searchLocal(query: string): Promise<Array<{
+        file: string;
+        snippet: string;
+        score: number;
+    }>>;
+    readFile(name: string): Promise<{
+        ok: boolean;
+        content?: string;
+        message: string;
+    }>;
 }

package/dist/types/runtime/ports/project-memory-store.d.ts

@@ -12,7 +12,7 @@ export interface ProjectMemoryResult {
 }
 export interface ProjectMemoryStore {
     getRootPath(): string;
-    ensureInitialized(): void;
+    ensureInitialized(): void | Promise<void>;
     getIndexForPrompt(): string;
     getIndexRaw(): string;
     getIndexUsage(): {

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

@@ -1,13 +1,12 @@
 /**
  * Session persistence authority facade.
  *
- * When gateway advertises Session X7, durable reads/writes go through HostSessionClient. Without
- * that capability (gate-off/tests/standalone), the legacy local implementation remains the inert
- * compatibility path. A single call never writes both stores.
+ * Every durable read/write goes through HostSessionClient. Standalone/local persistence is not a
+ * supported runtime mode after the S3 state-inversion cut.
  */
 import type { ChatMessage } from "../../protocol/wire/index.js";
 import type { HostSessionClient } from "../../transport/host-session-client.js";
-import { type AppendMessageOutcome } from "./session-transcript-store.js";
+import type { AppendMessageOutcome } from "./session-transcript-store.js";
 import { getSessionMetadata, readSessionMetadata } from "./session-metadata-store.js";
 import type { MessageDisplayMetadata, PersistedSession, SessionMetadataPatch, SessionStateSaveMetadata, SessionUsageSnapshot, TokenUsage } from "./session-types.js";
 export declare function configureHostSessionPersistence(resolver: () => HostSessionClient | undefined): void;

package/dist/types/skills/memory/host-memory-provider.d.ts

@@ -1,7 +1,7 @@
 /**
  * HostMemoryProvider —— qlogicagent 大脑对 memories.db 的存取反转(Route B B3;X7 brain proxy)。
  *
- * 与 LocalMemoryProvider 同公开面的 **proxy 实现**:大脑逻辑(dream/distill/晋升/consolidation/召回 hook)
+ * Gateway Memory 权威公开面的 **proxy 实现**:大脑逻辑(dream/distill/晋升/consolidation/召回 hook)
  * 零改动,底下的存取经 `x/host.request`(HostRequestClient)打到 gateway 四权威 host 服务(memory 域),
  * store(memories.db)只有 gateway 进程打开。
  *
@@ -144,5 +144,5 @@ export declare class HostMemoryProvider implements MemoryRuntimeHookProvider, Me
     readAttachmentBytes(_id: string): never;
     setAttachmentText(_id: string, _text: string): never;
 }
-/** 工厂便捷函数(与 createLocalMemoryProvider 对称)。 */
+/** Host Memory proxy 工厂。 */
 export declare function createHostMemoryProvider(config: HostMemoryProviderConfig): HostMemoryProvider;

package/dist/types/skills/memory/memory-config-resolver.d.ts

@@ -0,0 +1,4 @@
+import { type MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
+export type { MemoryProviderFactoryConfig } from "./memory-embedding-config.js";
+/** Resolve embedding configuration without constructing or opening a local memories.db provider. */
+export declare function resolveMemoryConfigFromEnv(): MemoryProviderFactoryConfig;

package/dist/types/skills/memory/task-distillation.d.ts

@@ -11,7 +11,7 @@
  * 【B3 登记·刻意不动】本文件的 profile 级 JSON store 直写(task-distill-candidates.json /
  * promotion-proposals.json / procedure-usage.json,均 A 域)是 qla 写、gateway 读(gateway
  * MemoryProfileService 已持 promotion-proposals.json)的**文件级共享过渡态**——B3.1 只反转
- * memories.db 存取(LocalMemoryProvider→HostMemoryProvider),这批 JSON 随削藩批次归
+ * memories.db 存取已收口为 HostMemoryProvider proxy,这批 JSON 随削藩批次归
  * store-owner(spec §1 X7 裁决第 4 条)。单一事实源 docs/agent-supervision-authority-migration-spec.md。
  */
 /** 同模式判定的余弦下限。错聚有害(把不同任务蒸成一份配方),漏聚无害(下次再攒)。 */

package/dist/types/test-support/run-state-authority-setup.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/transport/host-pet-client.d.ts

@@ -0,0 +1,20 @@
+import type { HostRequestParams } from "../host-contract/index.js";
+import type { PetSoul } from "../runtime/pet/pet-types.js";
+interface PetRequester {
+    request(params: HostRequestParams): Promise<unknown>;
+}
+export interface HostPetAwardResult {
+    active: boolean;
+    soul?: PetSoul;
+    growth?: Record<string, unknown>;
+    events?: Array<Record<string, unknown>>;
+}
+export declare class HostPetClient {
+    private readonly requester;
+    constructor(requester: PetRequester);
+    isActive(sessionId: string): Promise<boolean>;
+    getSoul(sessionId: string): Promise<PetSoul | null>;
+    awardXp(event: string, sessionId: string): Promise<HostPetAwardResult>;
+    journeyCatchUp(sessionId: string): Promise<string[]>;
+}
+export {};

package/dist/types/transport/host-run-state-client.d.ts

@@ -0,0 +1,17 @@
+import type { HostRequestParams, RunEvent, RunState } from "../host-contract/index.js";
+export interface HostRunStateRequester {
+    request(params: HostRequestParams): Promise<unknown>;
+}
+export declare class HostRunStateClient {
+    private readonly requester;
+    constructor(requester: HostRunStateRequester);
+    open(runId: string, kind: "solo" | "product" | "goal", projectId: string, sessionId: string): Promise<string>;
+    recordEvent(runId: string, event: Omit<RunEvent, "member">, sessionId: string): Promise<void>;
+    checkpoint(runId: string, snapshot: unknown, sessionId: string, checkpointId?: string): Promise<void>;
+    get(runId: string, sessionId: string): Promise<RunState>;
+    list(projectId: string, sessionId: string, kind?: "solo" | "product" | "goal"): Promise<RunState[]>;
+    delete(runId: string, sessionId: string): Promise<boolean>;
+    getCheckpoint(runId: string, checkpointId: string, sessionId: string): Promise<unknown | undefined>;
+    listCheckpoints(runId: string, sessionId: string): Promise<string[]>;
+    restoreCheckpoint(runId: string, checkpointId: string, sessionId: string): Promise<unknown | undefined>;
+}